Appearance
常见问题
FAQ
常见问题
这里整理接入组件库和文档维护时最常见的问题。遇到业务组件异常时，优先检查环境、登录态、接口权限和事件协议。
安装 @mbjia/* 包失败
检查 .npmrc：
ini
@mbjia:registry=http://verdaccio.atvideo.cc
registry=https://registry.npmmirror.com/检查 hosts：
txt
47.103.41.64 verdaccio.atvideo.cc业务组件无法正常请求
检查：
- 是否已登录。
- Cookie 中是否有 token。
@mbjia/site-env判断的环境是否正确。- 本地代理是否把
/api转发到正确后端。
上传不可用
检查：
- 浏览器是否支持
SharedWorker。 - 生产环境是否配置
sharedWorkerPath。 - OSS token 接口是否正常。
- 文件类型和大小是否通过校验。
引入 components 后主题变化
@mbjia/components 的入口会执行 AntD 全局主题配置，将主色设置为 #171436。
文档里找不到某个字段
优先检查：
- 组件源码是否真的导出了该字段。
- 字段是否来自透传的 AntD Props。
- 是否在
api/data-structures或api/services中集中说明。
如果源码中存在但文档没有，应补充对应组件页和索引页。
流程预览不显示
当前文档不依赖 Mermaid，流程图使用本地 HTML/CSS 的 flow-preview。新增流程时不要再写 mermaid 代码块，优先复用现有流程预览样式。