SuperAPI AI 工具集

miniapp-devtools-recovery

编程与开发

查看项目

更新于 10-16 03:28

技能介绍

用途

该技能用于修复微信小程序仓库在开发者工具(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 中未列出的页面启动时,优先怀疑过期的自定义编译条件。

使用方式

  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 编写,先验证 TypeScript 识别,再考虑重写为 JavaScript。
  • 如果 DevTools 尝试从 app.json 中未列出的页面启动,优先怀疑过期的自定义编译条件。

输出格式

回答时保持简短且可操作,包含:

  • DevTools 改变了什么
  • 仓库中应保留什么
  • 应删除或恢复什么
  • 用户必须在 DevTools 中更改什么

适用场景

  • 微信小程序仓库被 DevTools 污染。
  • DevTools 开始编译错误的内容。
  • 导入根目录错误导致项目结构混乱。
  • 模板残留文件影响项目运行。
  • 编译条件过期导致启动页面错误。
  • TypeScript 项目被 DevTools 误判为缺少 JavaScript 文件。

限制

  • 该技能专注于恢复和清理,不涉及小程序功能开发。
  • 需要用户具备基本的 Git 操作能力。
  • 具体清理步骤依赖 references/devtools-recovery-checklist.md 中的规则。
  • 未提供关于收费、价格、平台支持范围或效果保证的信息。