WEIFENG2333/phistory

Phistory – 编码代理 CLI 的提示历史追踪器

功能

• 安装流行的 AI 编码助手命令行工具（Claude Code、Codex、DeepSeek Harness 等）。
• 使用一组预定义的“快照”运行每个工具，并捕获携带系统提示的确切 HTTP 请求，而不会将其发送给模型提供商（使用辅助工具 claude-tap）。
• 将捕获的提示、跟踪日志和元数据存储在版本化的目录结构中。
• 静态网站（phistory.cc）并排可视化提示，突出显示版本之间的变化——新工具、权限检查、模型默认值、用户确认规则等。
• 支持提示差异的中文翻译，并提供脚本来回填历史版本、翻译捕获的文本以及重建网站。

重要性

• 系统提示是编码代理隐藏的“大脑”；它们决定了模型的行为方式、可以调用哪些工具以及适用哪些安全策略。
• 通过归档每个提示版本，Phistory 让研究人员、审计人员和开发人员能够准确查看代理的演变过程，引用稳定的快照，并发现回归或策略变化。
• 每小时的 GitHub Actions 工作流自动保持归档最新。

使用方法

1. 探索 – 访问托管查看器 https://phistory.cc 以比较跨代理和版本的提示。
2. 本地运行 – 使用 uv sync --all-groups 安装锁定的 Python 环境。
3. 捕获新版本：uv run phistory capture --latest --agents <list>。
4. 回填旧版本：uv run phistory backfill <agent> --from <ver> --to latest。
5. 翻译捕获的提示（需要外部凭据）：uv run phistory translate --all-captured。
6. 使用 uv run phistory render-index 和 uv run phistory build-site 重新生成索引和静态站点。

支持的代理（截至 2026 年 10 月）包括 Claude Code、Codex CLI、DeepSeek Harness、Antigravity CLI、Grok Build、MiniMax Code、Kimi Code、MiMo Code、OpenClaw、Hermes Agent、Kimi CLI、opencode、Pi 和 Oh My Pi。

当前覆盖范围 – README 列出了每个代理的最新捕获版本、跟踪的发布数量以及存储的总快照数（例如，Claude Code 2.1.296，758 个快照）。

技术栈 – 使用 uv 管理的 Python 项目，使用自定义 claude-tap 工具拦截提示，将数据存储为 markdown、JSONL 和 JSON，并构建用于浏览的静态站点。

---

所有细节均直接取自仓库的 README。