跳到文档正文
oh-my-design
故障排查

恢复

出现问题时,先确认下一步

先运行 doctor。它会按工具检查技能、智能体角色、参考目录和项目启用状态,不会因为发现一个文件就判定安装正常。

先运行一次诊断

CI 使用 JSON 输出;面向用户的报告可以直接粘贴给 AI 编程助手。degraded 状态会返回非零退出码。

npx oh-my-design-cli@latest doctor
npx oh-my-design-cli@latest doctor --json

安装后看不到技能

重启 AI 编程助手,再运行 doctor。

doctor 报告目录缺失

选择正确的目标工具,重新运行最新版安装器。

AI 编程助手说没有设计上下文

请求建立项目设计系统,并在写入 DESIGN.md 前确认方案。

想保留的行为也被改写

只回退相关改动,明确受保护行为并用 omd:remember 记录修正。

参考中出现无依据的字体或组件

只移除未解决字段或空组,不用系统字体或通用组件冒充品牌事实。