# HaluCatch / 捕幻 — 常见问题

---

## 基础

**Q: HaluCatch 需要联网吗？**

不需要。全程离线运行，仅扫描本地文件夹中的 SKILL.md 和 .py 文件，不会发起任何网络请求。如果执行卡住，大概率是 AI 对话环境超时或目标路径文件过多导致扫描耗时。

---

**Q: HaluCatch 怎么用？**

对 AI 说「请用 HaluCatch 审查 /path/to/skill」即可。AI 自动扫描、评估、生成三份报告到 `reports/` 目录。3 步上手：

1. 跑一次审查 → 看标准版报告了解问题
2. 打开 `-行动版.md` → 从列表第一条开始逐项修复
3. 修复后重新跑 → 对比分数是否改善

---

**Q: 我的 Skill 没有 .py 文件，能用吗？**

可以。HaluCatch 会自动分类为「纯方法论型」并跳过地基/代码检查，只评估方法论结构和护栏完整度。

---

## 报告

**Q: 审查结果说「护栏薄弱」，怎么修？**

看同目录下的 `HaluCatch-report-日期-行动版.md`，它逐条列出了修复方案和验证检查点。按清单逐项改即可，改完后重新审查验证。

---

**Q: 为什么工具库型 Skill 的护栏分数看起来比分析型低？**

护栏检查按类型分层——工具库型只查 5 项核心项（跳过数据来源/时效性/置信度），分析型查全 8 项。分母不同，分数不可直接比较。

---

**Q: 报告里看到的版本号是什么意思？**

报告日期是生成当天，版本号跟随 HaluCatch 自身版本。同一个 Skill 在不同版本 HaluCatch 下的评分可能不同——因为检测规则在持续改进。

---

**Q: 能一次审查多个 Skill 吗？**

当前版本暂不支持批量模式。你可以逐个运行。批量功能已在 roadmap 中。

---

## 技术

**Q: 为什么有些 Skill 被分类为「代码工程型」而有些是「纯方法论型」？**

含 .py 文件、或 SKILL.md 中嵌入了 `\`\`\`python` 代码块、或引用了 pandas 等数据处理库的 Skill → 代码工程型（启用全四维评估）。其余 → 纯方法论型（只查方法论+护栏）。

---

**Q: 出现文件编码错误怎么办？**

HaluCatch 会尝试以 UTF-8 读取所有文件。如果遇到非 UTF-8 编码（如 GBK），会用 `backslashreplace` 保留原始字节的转义形式，避免静默丢数据。

---

**Q: 代码风险检查有哪些规则？**

当前 7 条通用规则：异常处理（裸 except: pass）、浮点比较（== 0.0）、除零风险（return 中无保护除法）、硬编码阈值（固定 skiprows）、路径拼接（字符串拼路径）、静默覆盖（open 写模式无警告）、超时缺失（requests 无 timeout）。

---

**Q: 行动版报告里的「Phase 4 闭环」是什么意思？**

审查完成后，HaluCatch 会询问是否按方案修复。选择「执行修复」→ 将方案发给 AI 实施 → 修复后重新审查验证。选择「我有更好建议」→ 描述你的想法 → 重新生成方案。选「不执行」→ 结束。完整的「发现→修复→验证」链路。