Keysmith Lens，三条命令跑起来

一个 Python 包，没有第三方依赖。先用示例数据看一遍，再录你自己的 Agent。

不用注册，也不用登录。所有东西都在本机：录制的请求存在你指定的目录，生成的是一个 HTML 文件。

GitHub 看看产品导览

PYTHON 3.9+ / MACOS · LINUX · WINDOWS / MIT

选择方式

git clonegit clone https://github.com/Jia-Ethan/keysmith-lens.git 下载 ZIP需要 Python 3.9+

pip暂不提供

其他全部版本源码

装好之后有什么

record

在本机起一个转发代理。把 Agent 的 API 地址指向它，每次模型请求都会存成一个 JSON 文件，响应照常流回 Agent。

build

读一个或多个运行目录，按内容比对规则文件，生成一个独立的 HTML 文件。

示例数据

examples/make_demo.py 生成五个虚构的运行：规则晚到、压缩后消失、从未送达、跨 Agent 对照、全部正常。

第一步 / 先看示例

git clone https://github.com/Jia-Ethan/keysmith-lens.git
cd keysmith-lens
python3 examples/make_demo.py examples/demo
PYTHONPATH=. python3 -m keysmith_lens build examples/demo -o out/lens.html
open out/lens.html

第二步 / 录自己的 Agent

# 终端 1：起本机代理，--rule 指定要检查的规则文件
PYTHONPATH=. python3 -m keysmith_lens record runs/first \
  --upstream https://api.anthropic.com --rule ./AGENTS.md

# 终端 2：把 Agent 的 API 地址指向代理，照常使用，结束后回终端 1 按 Ctrl-C
ANTHROPIC_BASE_URL=http://127.0.0.1:8787 claude

第三步 / 生成并打开

PYTHONPATH=. python3 -m keysmith_lens build runs -o out/lens.html
open out/lens.html   # 含请求原文，只在本机打开；要分享先脱敏

复制给智能体安装

请先阅读 https://github.com/Jia-Ethan/keysmith-lens 的 README，再在本机克隆仓库。用 python3 examples/make_demo.py examples/demo 生成示例数据，用 PYTHONPATH=. python3 -m keysmith_lens build examples/demo -o out/lens.html 生成页面并告诉我路径。不要安装任何第三方依赖；如需录制，只在 127.0.0.1 上运行 record，不要把 API key 写进任何文件。

Lens 只在本机监听 127.0.0.1，不会把请求发到除了你指定的 upstream 以外的任何地方。