主题
排查问题
排查问题用于处理“推不上去”“登录失败”“远端变化看不到差异”“修改丢了”“数据不对”“页面没反应”“调度没跑”这类阻塞交付的问题。排查前先保护现场，确认服务器、项目、本地变化和 Git 状态。
什么时候进入
遇到以下问题时，先阅读本目录：
- 推送、拉取、同步或登录被阻塞。
- 本地变化、远端变化、Git 状态或同步基线看起来不一致。
- 修改疑似丢失、被覆盖，或远端变化显示不出实际内容差异。
- 元数据文件在浏览器预览或设计器中报错，需要先用 CLI 校验本地内容。
- 页面、数据、权限或调度异常，需要先保护现场再定位问题。
任务入口
| 问题 | 先读 | 适用情况 |
|---|---|---|
| 冲突处理 | 冲突处理 | 本地和服务器都修改了同一个资源，推送或拉取前需要判断保留哪一侧。 |
| 自动登录失败 | 自动登录失败 | 每次打开工作区都需要重新认证，或服务器不再接受已保存的授权状态。 |
| 远端变化没有内容差异 | 远端变化没有内容差异 | SuccApp 显示远端变化，但文件正文看起来没有可见差异。 |
| 找回丢失修改 | 找回丢失修改 | 本地修改疑似被覆盖、被重置或找不到，需要先停止继续同步操作。 |
| 元数据合法性校验 | 元数据合法性校验 | AI 修改 .dash、.spg、.tbl 等元数据文件后，需要在推送或浏览器预览前检查本地内容是否能通过服务器编译。 |
