SuperAPI AI 工具集

mimic-troubleshooter

编程与开发

查看项目

更新于 10-15 21:42

技能介绍

用途:该技能用于诊断并修复 MIMIC 扩展项目中的常见问题,适用于用户反馈“卡顿/延迟”、构建或打包失败、扩展功能(如侧边栏、shell hook)不出现或不工作,以及需要检查项目环境(node_modules、out 目录)完整性时。

主要能力与用法:

  1. 快速诊断:运行 ./.agent/skills/mimic-troubleshooter/scripts/diagnose.sh 检查常见故障迹象。
  2. 构建失败:症状为 npm run compile 失败或 vsce package 报错;可查看 IDE 问题面板或手动运行 npm run compile 查看 TS 错误。常见原因包括重复变量声明(如 outputChannel)、缺少导入、接口不匹配。
  3. 卡顿/性能问题:检查 ActivityWatcher 是否向 ~/.mimic/events.jsonl 大量刷日志,可运行 tail -f ~/.mimic/events.jsonl 观察是否刷屏;并查看 VS Code 的 Extension Host 日志是否存在死循环或频繁报错。
  4. Shell Hook 不工作:症状为命令未被记录;检查 ~/.zshrc 中是否 source .../mimic-zsh.sh,确认设置中 mimic.enableRealtimePerception 为 true,并手动运行 source ~/.zshrc。

参考:COMMON_ERRORS.md 收录了已知错误模式与解决方案。

限制:资料未提供该技能的安装方式、收费信息、支持平台及其他未提及功能,暂未提供。