用途
该技能用于修复微信小程序仓库在开发者工具(DevTools)使用过程中出现的常见污染问题。当 DevTools 导入了错误的根目录、留下了模板残留文件、保留了过期的编译条件,或出现 TypeScript 识别漂移时,可使用本技能进行恢复。
主要能力
- 识别问题类型:错误导入根目录、模板残留、过期编译条件、TypeScript 识别漂移。
- 检查关键文件:git status、仓库根目录、project.config.json、project.private.config.json、app.json。
- 恢复已跟踪文件:优先从版本控制恢复被修改或删除的已跟踪文件。
- 清理生成残留:仅删除由 DevTools 生成的模板页面或辅助文件,除非应用明确依赖它们。
- 处理 TypeScript 识别问题:当仓库使用 .ts 编写而 DevTools 报缺少 .js 文件时,先验证 TypeScript 识别,而不是将应用重写为 JavaScript。
- 处理过期编译条件:当 DevTools 尝试从 app.json 中未列出的页面启动时,优先怀疑过期的自定义编译条件。
使用方式
- 阅读 references/devtools-recovery-checklist.md。
- 检查 git status、仓库根目录、project.config.json、project.private.config.json 和 app.json。
- 判断问题属于错误导入根目录、模板残留、过期编译条件还是 TypeScript 识别漂移。
- 先恢复已跟踪文件,再仅删除生成的残留物。
- 明确告知用户应导入哪个目录以及使用哪种编译模式。
核心规则
- 将仓库根目录与小程序代码根目录视为两个独立关注点。
- 在删除生成的杂乱文件之前,优先从版本控制恢复已跟踪文件。
- project.private.config.json 仅保留在本地,不要依赖它作为共享项目事实。
- 除非应用明确依赖,否则移除生成的模板页面或辅助文件。
- 如果 DevTools 报缺少 .js 文件而仓库使用 .ts 编写,先验证 TypeScript 识别,再考虑重写为 JavaScript。
- 如果 DevTools 尝试从 app.json 中未列出的页面启动,优先怀疑过期的自定义编译条件。
输出格式
回答时保持简短且可操作,包含:
- DevTools 改变了什么
- 仓库中应保留什么
- 应删除或恢复什么
- 用户必须在 DevTools 中更改什么
适用场景
- 微信小程序仓库被 DevTools 污染。
- DevTools 开始编译错误的内容。
- 导入根目录错误导致项目结构混乱。
- 模板残留文件影响项目运行。
- 编译条件过期导致启动页面错误。
- TypeScript 项目被 DevTools 误判为缺少 JavaScript 文件。
限制
- 该技能专注于恢复和清理,不涉及小程序功能开发。
- 需要用户具备基本的 Git 操作能力。
- 具体清理步骤依赖 references/devtools-recovery-checklist.md 中的规则。
- 未提供关于收费、价格、平台支持范围或效果保证的信息。