正文不必完全一致，但最好有相对固定的章节骨架，便于定位。一个通用骨架可以包含： 章节 作用 概览 主题定位、用途、当前状态、一句话摘要 背景与边界 业务背景、覆盖范围、不覆盖范围、相邻 wiki 边界 核心概念 名词定义、易混概念、关键对象 业务流程 主链路、例外路径、fallback 易混点对照 常见误解与正确口径 核心指标 指标定义、统计口径、指标窗口 架构与模块 业务主题到代码入口的映射 信号建设 日志、监控、事件、告警等排查信号 FAQ 与排查 高频问题、判断路径、抓手 证据与待确认 来源、证据等级、待确认项、风险 这里有几个实践约定值得保留。
md 业务路由索引 这个领域有哪些主题，主题之间是什么关系，哪些 wiki 处于什么状态 xxx.
.可覆盖大多数，但部分终结点不能用通配符（如 adminmanagement），需要单独颁发。
error('断开连接时出错:', error) } } } export const avatarService = new AvatarService() 关键配置项说明： enableDebugger: false：生产环境关闭调试模式，避免控制台输出过多 SDK 内部日志gatewayServer：魔珐星云网关方案器地址，支持自定义资料源，是参数流架构的核心入口onDownloadProgress：初始化进度回调，100% 时表示资源加载完成，连接就绪onVoiceStateChange：语音状态回调，当数字人说话结束时触发，用于流式播报的段落控制getPromiseState：检查连接 Promise 的状态，避免在已 resolve 的情况下重复 reject 4.
interceptors.response.use( (res) => { const { code, data, message } = res.
作者在提醒你：东西也许能跑，但别拿它扛重要的事。一个两万 Star、半年没发版、评论区全是「现在还能用吗」的项目，实际用起来的成本可能很高。