帮助
快速解答
- Keysmith Lens 是做什么的？
回放 AI 编程 Agent 的运行记录：每一步发给模型的请求里，你写的 AGENTS.md、CLAUDE.md、系统提示有没有送到、放在哪一层、什么时候没了。
- 和 Keysmith Switch 是什么关系？
都是 Keysmith 系列。Switch 负责管理和部署提示词；Lens 负责检查它们有没有真正送到模型。两个可以单独使用。
- 收费吗？
不收费，按 MIT 许可证开源，没有账号。
- 需要装什么？
只要 Python 3.9 或更高版本，没有第三方依赖。见快速上手。
- 支持哪些 Agent？
能自定义 API 地址的都可以。已经验证过的有 Claude Code、Codex、OpenCode、Pi 和 OpenHands，见各 Agent 的录制方式。
录制
- 录制会保存我的 API key 吗？
不会。录制只保存请求的方法、路径和正文，请求头一律不写盘。见数据与隐私。
- 录制会拖慢 Agent 吗？
请求经过本机多转发一次，响应边收边转，流式输出不受影响。
- Agent 用账号登录，没有 API key，能录吗？
要看这个 Agent 在账号登录时是否允许自定义 API 地址。很多 Agent 只在使用 API key 时才走自定义地址。
- Agent 跑在 Docker 里怎么办？
代理只监听
127.0.0.1。让容器和代理共用网络（例如docker run --network host），或者把代理也放进容器。- 我已经有自己抓的请求了，能直接用吗？
可以。整理成
captures/NNN-*.json，每个文件里放path和body_parsed两个字段即可，格式见 GitHub 上的docs/capture-format.md。
看结果
- 规则显示「部分送达」是什么意思？
规则文件里有一些行在请求里找到了，另一些没有。常见原因是 Agent 改写、截断了规则，或者把它拆到了不同位置。点开那次请求的原文核对。
- 为什么有一列是淡色的？
那是旁支请求，例如生成会话标题。它不带工具定义，不参与「晚到」「消失」的判断。
- 为什么我的规则文件没出现在表里？
可能文件名不在默认列表里，或者每一行都太短（少于 20 个字符）。录制时用
--rule指定这个文件。- 生成的 HTML 可以发给别人吗？
它包含请求原文，可能有文件内容、路径或私人信息。分享前先对运行目录脱敏，再重新生成。