🩺 GeneralUpdate 故障排查
综合性诊断系统 — 覆盖 50+ 已知问题,均可追溯到 GitHub/Gitee Issue 或代码审计发现。
📋 用户症状提取
### 必填信息
- 症状描述: ______
- 错误信息/堆栈: ______
- GeneralUpdate 版本: ______
- 平台: ______(Windows / Linux / macOS)
- .NET 版本: ______
- 更新策略: ______(标准 / OSS / 静默 / 差分 / 跨版本 / 推送)
- 最近是否改过配置: ______(是/否,改了啥)
### 可选信息
- 事件监听中是否有异常(ExceptionEventArgs): ______
- 是否有日志(Logs/generalupdate-trace-*.log): ______
- 问题是否可复现: ______(是/否,频率)
- 首次出现时间点: ______
工作流程
1. 症状收集
├── 用户描述的症状是什么?
├── 错误信息/堆栈是什么?
├── GeneralUpdate 版本号?
├── 平台(Windows/Linux/macOS)?
└── 更新策略(标准/OSS/静默)?
2. 症状匹配
├── 优先:python3 scripts/search.py "<症状>" --domain issue
│ └── 匹配到 → 给出根因 + 修复 + 代码
└── 未匹配 → 降级到 reference.md 全文搜索
3. 提供修复
├── 具体的代码修改、配置调整、版本升级建议
└── 预防措施(如何避免再发生)
4. 验证
└── 确认修复后问题解决
症状搜索(推荐)
优先使用 BM25 搜索引擎精确匹配已知问题,而不是在 reference.md 中手动查找:
# 自然语言搜索已知问题
python3 .claude/skills/generalupdate-troubleshoot/scripts/search.py "升级后应用启动不了" --domain issue
python3 .claude/skills/generalupdate-troubleshoot/scripts/search.py "方法找不到 MethodNotFound" --domain issue
python3 .claude/skills/generalupdate-troubleshoot/scripts/search.py "中文乱码 garbled" --domain issue
# 搜索策略相关问题
python3 .claude/skills/generalupdate-troubleshoot/scripts/search.py "OSS 权限问题" --domain strategy