ila
ffa81901cf
Online sync and strict structure checks pass. Full governance tests identify two documentation gaps; follow-up will add lightweight exemptions and verified Windows shell guidance.
1.3 KiB
1.3 KiB
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Troubleshooting wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Troubleshooting wiki_revision: c202a8adb9b720981761e07f52fb7c0033d6d7d2 synchronized_at: 2026-09-10T06:27:43Z
故障排查
排查顺序
| 现象 | 判断与处理 | 成功条件 |
|---|---|---|
| 没有产品启动入口 | 当前仅文档阶段，先完成 M0 和工程创建 | 有真实构建/运行命令后更新验证页 |
| MCP 看不到 LexGo | 当前 MCP 指向其他站点；以用户确认的 git.ilapage.cn 为准 | API 能读取 OPC/lexgo |
| 新 Wiki 列表 404 | 先确认仓库存在且 has_wiki=true；未初始化时创建 Home 并回读 | Home 有正文和 revision |
| sync 拒绝脏镜像 | 检查并保存合法本地修改，不覆盖现有改动 | 提交/妥善保存后重试 |
| check 缺少标题或映射 | 补齐真实主题和显式映射 | check --strict 通过 |
| 数据库方案冲突 | 用户已确定 MySQL 8，历史 PostgreSQL 建议被覆盖 | 档案和新方案一致 |
必须停止的情况
目标仓库身份不清时停止远端写入；页面无法回读、无 revision 或同步失败时停止产品编码。数据越权、破坏性操作超出授权时停止相关操作。独立文档整理可以继续。