Vouch

这个 Agent 能做什么，适合哪些场景？

Vouch 是一个以 Git 仓库为载体的知识库，专门解决多个 AI Agent 或团队成员同时写入同一份知识时的信任问题。它通过 MCP 工具（kb.*）、JSONL 工具服务和 vouch CLI 暴露接口：Agent 只能提交“提案”，通过 vouch review 人工审批后才会变成 .vouch/ 目录下的 YAML claim 与 Markdown 页面。每条 claim 必须引用经过内容哈希的源材料，未引用即校验失败；所有变更写入只追加的审计日志，记录谁提议、谁批准、引用何处、何时发生。vouch compile 可调用你配置的 LLM 命令（如 claude -p --model sonnet）把已批准的 claim 编译成交叉引用的主题页面，草稿中的 [claim: …] 与 [[wikilink]] 会机械校验后才进入审核队列。它提供 Docker 镜像、pipx 安装的 vouch-kb 包、浏览器控制台以及 Claude Code 的 hooks 集成。

Vouch 从你项目中的 .vouch/ 目录读取已批准的 claim、页面与源材料。它通过 MCP 工具 kb.search、kb.read_page、kb.context、kb.propose_* 以及 vouch serve --transport jsonl 接收 Agent 写入提案，提案暂存于 proposed/ 且被 gitignore。Agent 会话期间，PostToolUse/SessionEnd 等 hook 会把工具调用收集到临时缓冲区，并在会话结束时机械汇总成一个待审的 session-summary 页面。vouch review 逐条展示待审提案，vouch approve / reject 完成审批；审批者默认必须与提议者不同。已批准的 claim 必须引用经过内容哈希的源材料，否则视为校验错误。vouch compile 调用配置的 llm_cmd 生成带 [claim: …] 引用的主题页面，引用校验失败的草稿会被丢弃，通过的草稿同样进入审核队列。vouch recall 在 SessionStart 时输出已批准知识与页面标题的摘要，受 recall.max_chars 限制并在截断时给出提示。所有变更记入只追加的审计日志，最终以普通文件形式随 git clone 传播。

1. 同时使用多个 Claude Code 会话或多个 Agent 处理同一仓库，需要共享且可审计的项目记忆
2. 团队成员希望在代码评审之外，也评审 Agent 写入的项目知识
3. 把长期项目上下文沉淀成可交叉引用、带出处的 wiki 页面，而不是散落的笔记
4. 需要回答“这条结论是谁在什么证据下确认的”时，查阅审计日志
5. 在 Docker demo 或 vouch console 中先在浏览器里体验提案—审核—统计流程

如何安装或部署这个 Agent？

推荐先用 Docker 体验完整界面：

docker run --rm -p 127.0.0.1:5173:5173 -v vouch-demo-data:/data ghcr.io/plind-junior/vouch-demo
# 打开 http://localhost:5173

无需 Docker、只用 Python 的完整界面：

pipx install 'vouch-kb[web]'
vouch serve --transport http --port 8731 &
vouch console

CLI 与 Claude Code 集成的常用安装方式（POSIX sh，无需 sudo）：

curl -fsSL https://raw.githubusercontent.com/vouchdev/vouch/main/install.sh | sh

或直接通过 pipx：

pipx install vouch-kb

仅使用 MCP 服务或 CLI 时可使用镜像：

docker run -i --rm -v "$PWD:/data" ghcr.io/vouchdev/vouch:latest
docker run --rm -v "$PWD:/data" ghcr.io/vouchdev/vouch:latest status

本地开发：

git clone https://github.com/vouchdev/vouch
cd vouch
python3 -m venv .venv && source .venv/bin/activate
pip install -e '.[dev,web]'
vouch --version
make check

如何使用这个 Agent？

在你的项目中初始化知识库并接入 Claude Code：

cd /path/to/your/project
vouch install-mcp claude-code

需要为所有项目统一安装时：

vouch install-mcp claude-code --global

配置 compile 所需的 LLM 命令，写入 .vouch/config.yaml：

compile:
  llm_cmd: "claude -p --model sonnet"

正常使用 Claude Code 工作，会话会自动捕获；下次会话会提示有待审内容：

🔔 1 auto-captured session summary(ies) awaiting review — run `vouch review`.

审批并编译 wiki：

vouch review
vouch compile
vouch review

也可以只用 CLI 操作：

vouch pending
vouch show <id>
vouch approve <id>
vouch reject <id> --reason "..."

把知识随代码提交：

git add .vouch/ && git commit -m "kb: approve session summary"

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

[![FARS 评测](https://followagents.com/badge/vouch.svg?lang=zh)](https://followagents.com/zh/agents/vouch)

<a href="https://followagents.com/zh/agents/vouch"><img src="https://followagents.com/badge/vouch.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v1.5.0 2026-07-20
   发布说明摘录

   Added - vouch install-mcp claude-code --global — install once for the whole machine. writes user-level hooks, /vouch-* commands, and a fenced CLAUDE.md snippet under ~/.claude/, and registers vouch as a *user-scope* MCP server (top-level mcpServers in ~/.claude.json), so every claude session in every folder gets capture + per-prompt recall into that folder's own project .vouch/ — the data stays per project; run vouch init once per project. a folder without a KB never captures anywhere: its session opens with a one-line "run …

   在 GitHub 查看 ↗
2. v1.4.0 2026-07-17
   发布说明摘录

   Added - vouch install-mcp <host> now bootstraps the KB when no .vouch/ is discoverable at or above the target, making install a one-command setup. previously it exited 0 with "0 failed" in a fresh project while every installed hook silently no-oped forever (|| true) and the mcp server exited 2 — with nothing ever telling the user to run vouch init. opt out with --no-init (a loud stderr warning then names the remedy); an ancestor KB is reported ("Using existing KB at …"), never shadowed by a second one; unknown hosts still fail …

   在 GitHub 查看 ↗
3. v1.3.0 2026-07-13
   发布说明摘录

   Added - vouch console: serve the vendored React web console straight from the installed package — a same-origin /proxy bridge (loopback-guarded) to vouch serve --transport http backends, reimplementing the vite dev-proxy in python. the built SPA is bundled into the wheel as vouch/web/console (conditionally, via a hatch build hook), so pip install 'vouch-kb[web]' then vouch console needs no node and no repo clone. - kb.activity read method (+ vouch activity CLI mirror): audit-log activity buckets for dashboards — per-day counts with proposal/decision …

   在 GitHub 查看 ↗

常见问题