reviewzy

人在回路 mcp 审查，面向用户可见文本：代理提交，人类批准，后续会话应用

批量审查并重写 CLI、TUI、Web UI 和网站中的用户可见文案；文案创作仍由人类完成

reviewzy 是一个自托管的仪表盘和 mcp 服务器，用于人在回路的文案审查。编码代理会提交它想要写入或重写的精确字符串。人类在仪表盘上撰写或批准每个条目。后续的代理会话获取已批准的词语并在原处应用。没有 i18n 键，没有内容层：每个条目都指向字符串原本所在的位置。

提交一个条目：

{
  "project": "my-app",
  "entries": [
    {
      "repo": "https://github.com/me/my-app",
      "file": "src/cli/main.ts",
      "anchor_text": "error: something went wrong",
      "agent_draft": "error: could not reach the reviewzy daemon",
      "file_content": "#!/usr/bin/env bun\nconsole.error(\"error: something went wrong\")\n",
      "constraints": { "max_len": 48, "tone": "plain, lowercase" }
    }
  ],
  "filed_by": "help-text-audit"
}

该调用以 draft 状态返回该条目，并附上该批次的仪表盘链接：

{
  "batch_id": "01M060XY9GNK6ANVENN4Y4MK7N",
  "results": [
    { "id": "01M060XY9GNK6ANVENN4Y4MK7P", "status": "draft", "deduped": false, "updated": false }
  ],
  "dashboard_url": "http://127.0.0.1:3123/?project=my-app"
}

为什么

• 提交 + 片段锚点，无 i18n 键： 回写是在原处进行的有针对性的替换

• 人类撰写，代理应用： 状态机由服务器强制；只有仪表盘能达到 approved 或 rejected

• 每个项目的风格指南作为 mcp 资源： 与全局指南合并，嵌入在 fetch_approved 中

• 仅追加的修订历史： 每次保存都可撤销；历史在归档后仍然保留

• ntfy 和 webhook 通知，归档保留： 每个提交批次发送一次通知；已应用的条目在 ARCHIVE_AFTER_DAYS 后归档

Related MCP server: approval-gate

工作方式

安装

bunx reviewzy@latest

要求 bun >= 1.3（存储使用 bun:sqlite，仅支持 bun；没有 npx 形式）。该垫片在首次使用时会在每台机器上生成一个共享守护进程。

从代码检出安装：

bun install
bun run daemon

作为 Claude Code 插件

该仓库本身就是一个插件：它会注册 MCP 服务器，并添加 /reviewzy 斜杠命令以及 reviewzy 技能。

/plugin marketplace add uwuclxdy/reviewzy
/plugin install reviewzy@reviewzy

与 npm 形式具有相同的 bun 要求。

用法

curl http://127.0.0.1:3123/health

{"name":"reviewzy","version":"0.1.0","pid":4172598,"nonce":"881f0e93-8dde-4c75-b559-d2e3d3b223f0","startedAt":"2026-08-16T19:31:28.640Z"}

打开 http://127.0.0.1:3123/ 访问仪表盘。

配置

将 .env.example 复制为 .env 并编辑。每个键都是可选的；错误的值会导致启动失败。

某个凭据未设置时，该接口将仅限回环访问，并给出启动警告。

集成

将 mcp 客户端指向 reviewzy 即可开始提交：

{
  "mcpServers": {
    "reviewzy": {
      "command": "bunx",
      "args": ["reviewzy@latest"]
    }
  }
}

该端点使用无状态的 2026-07-28 mcp 修订版。

对比

阻塞式人在回路 mcp 家族每次调用都会弹出对话框：没有队列，没有持久化，没有仪表盘。

常见问题

如何在 AI 生成的文本进入我的代码之前批准它？ 代理将字符串作为草稿提交，你在仪表盘上撰写或批准，然后代理应用。

AI 代理能否在没有 i18n 键的情况下重写我的 CLI 帮助文本？ 可以。条目锚定在当前确切的字符串上；回写是一种有针对性的替换。

如何批量重写代码库中所有面向用户的文案？ 按项目提交批次，在仪表盘上按项目或批次分组，通过前后 diff 批量批准，然后让后续的代理会话获取并应用。

如何更新我的代理读取的风格指南？ 在仪表盘的 /style-guide 处编辑它。保存的编辑最多 60 秒内到达代理。

开发

bun run check  # tsc --noEmit && bun test

许可证

AGPL-3.0。自托管保持自托管；封装它的 saas 必须发布其更改。