miniapp-devtools-recovery

小程序 DevTools 恢复

概述

当 DevTools 污染了仓库或开始编译错误的内容时，使用此技能。保持清理最小化，并在删除残留之前先恢复已跟踪的文件。

快速开始

1. 阅读 references/devtools-recovery-checklist.md。
2. 检查 git status、仓库根目录、project.config.json、project.private.config.json 和 app.json。
3. 判断问题是导入根目录错误、模板残留、过期的编译条件，还是 TypeScript 识别漂移。
4. 先恢复已跟踪的文件，然后只删除生成的残留。
5. 明确告诉用户应导入哪个目录以及使用哪种编译模式。

核心规则

• 将仓库根目录和小程序代码根目录视为相互独立的事项。
• 在删除生成的杂乱内容之前，优先从版本控制中恢复已跟踪的文件。
• 将 project.private.config.json 仅保留在本地；不要依赖它作为共享项目的真实来源。
• 移除生成的模板页面或辅助文件，除非应用明确依赖它们。
• 如果 DevTools 抱怨缺少 .js 文件，而仓库使用 .ts 编写，请在将应用改写为 JavaScript 之前先验证 TypeScript 识别。
• 如果 DevTools 尝试从不属于 app.json 中列出的页面启动，首先怀疑是过期的自定义编译条件。

输出格式

回答时，保持结果简短且可操作：

1. DevTools 更改了什么
2. 仓库中应保留什么
3. 删除或恢复什么
4. 用户必须在 DevTools 中更改什么

资源

• references/devtools-recovery-checklist.md：清理规则以及错误到原因的映射
• references/example-prompts.md：可复用的触发示例和评估说明