故障排查
故障排查
先找失败层级，再调整对应设置。不要以删除整个用户目录作为通用修复。
| 症状 | 先检查 | 对应处理 |
|---|---|---|
| 找不到 slothtool | node/npm 版本、npm list -g --depth=0、npm prefix -g、PATH | 确认当前 Node 的全局安装位置 |
| 管理器有帮助，插件不存在 | slothtool list | 根包与插件分别安装；源码目录不等于已安装 |
| Release 查询或下载失败 | slothtool config proxy show、失败阶段 | 检查网络源，区分 GitHub 与 npm |
| 图片资产不匹配 | 系统、CPU、支持目标 | 用正确平台资产，不能靠改名转换 |
| 离线包缺依赖 | package/ 布局、官方包名、node_modules 或 npm 缓存 | 在源机器运行成功后重新 bundle |
| TUI 无法启动 | 是否 TTY、窗口尺寸 | 改用显式任务参数，或扩大交互终端 |
| 配置 JSON 报错 | 报错文件及当前数据路径 | 备份后修正该文件，不清空所有 data |
任务能启动但结果不对
- loc 缺文件或行数不同：检查扩展名、目录规则和 warnings；它统计换行拆分片段，且不读取 gitignore。
- 图片把选项当文件：所有选项移到输入路径前，使用绝对路径。结果跳过时查看是否未变小、目标存在或格式不支持。
- ZIP 少文件：依次检查内置过滤、沿途 gitignore、长期模式和本次 exclude。详见项目打包。
- gstore 冲突：按冲突处理核对双方变化；网络和授权错误不使用覆盖策略解决。
- 部署包不兼容：检查并更新独立 Deployment 包，不只更新 UI；取消或失败后核对实际运行状态。
- Skill installed 但宿主未识别：检查链接、环境变量和当前宿主加载规则；MCP 可用性另做只读查询。
报告问题时提供根/插件版本、系统架构、脱敏命令、失败阶段和必要日志。不要附 Token、Key、代理密码或完整用户目录。