问题：AI Agent 写完代码怎么审？用 R3 像 GitHub PR 一样逐行给反馈
AI 编码 Agent 写代码很快，但人的审阅速度跟不上。更尴尬的是，当 Agent 在一个长会话里输出几段代码，你只能通过复制粘贴来回它对线——”第三段那个函数命名改一下””第七行的类型是不是错了？”，Agent 看完又重写一遍，你再看又发现新问题……这种「聊天框审代码」的模式效率极低。
R3 就是一个填补这个空白的本地代码审阅工具。它不依赖任何特定 Agent，你只要在 Agent 的工作指令里加几句配置，就能让 Claude Code、Codex、Cursor 等编码 Agent 配合一个本地的 Web 审阅面板工作——就像在团队里开 PR 评审一样，但只需要你一个人（加 Agent）参与。
审阅流程：Agent 发起 → 你评论 → Agent 回应 → 你确认
打开项目终端，让 Agent 执行 npx @hyperlogue/r3@latest create，它就会在本地启动一个 Web 服务器（默认端口 8791），生成一个审阅会话并返回一个 URL。你在浏览器打开它，看到的是 Agent 提交的 diff 或文件内容。
然后 Agent 执行 r3 watch ，进入阻塞等待状态。你在网页上选中任意一行代码或一段文字，写下反馈。点击 Submit 后，Agent 的终端会立即打印出这条反馈，然后 Agent 根据反馈修改代码，再通过 r3 reply 逐一回应。你确认满意后，点击 Approve，整个审阅周期结束。
这套流程比聊天框审阅的根本优势在于：反馈被锚定到具体的代码行，而不是淹没在对话历史里。每条评论都有独立的 ID，Agent 可以对每一条单独回应，你也能看到哪些被处理了、哪些还没动。
两种审阅模式：文件审阅和 Diff 审阅
R3 支持两种形式的审阅：
- 文件审阅（Files Review）：实时查看一组文件——适合审阅 Agent 还在写的设计文档或正在修改的源码。R3 会监听文件变化，自动重新渲染。你的评论会跟随代码移动（基于引用的锚定而非行号）。
- Diff 审阅（Diff Review）：对某个快照做一次性的差异审阅——适合审阅一次 Commit、一个分支差异、或当前工作区的变更。上传后不可变，后续修改会作为新的轮次。
两种模式覆盖了大部分实用的审阅场景：起草阶段看文件、提交前看变更、跨分支看方案。
快速上手：零配置启动
最快捷的体验方式是让 Agent 直接使用 R3。把你项目根目录的 CLAUDE.md 或 AGENTS.md 里加上一句：
This project uses r3 for review. Run it with: `npx @hyperlogue/r3@latest` `r3 guide` will show how to use it.
然后对 Agent 说：「把我工作区的变更提交审阅」，Agent 就会执行 npx @hyperlogue/r3@latest create …，自动启动 Web 服务器并返回审阅链接。
如果想全局安装，避免每次用 npx：
npm install -g @hyperlogue/r3
此后直接在任何项目目录运行 r3 create 即可。
R3 的设计理念是一切自动化：第一次调用时懒启动 Web 服务器，数据存放在 $XDG_STATE_HOME/r3/r3.sqlite 中，项目注册表自动识别不同仓库和工作树。CLI 通过 $XDG_RUNTIME_DIR/r3/daemon.json 与服务端通信，零配置即可使用。
远程访问：安全地在开发机上使用
如果你的开发环境在远程服务器上，R3 同样适用。它默认只绑定 loopback（127.0.0.1），你需要通过 SSH 端口转发、Tailscale Serve 或 Cloudflare Tunnel 来访问 Web UI：
ssh -L 8791:localhost:8791 devbox export R3_PUBLIC_URL=https://myhost.tailnet.ts.net r3 restart tailscale serve --bg 8791
一旦 R3 检测到被暴露到非 loopback 地址（通过 R3_PUBLIC_URL 或 R3_ALLOWED_HOSTS 设置），它会自动开启登录门控（Login Gate）。你需要先在主机上生成一个令牌：
r3 auth create-token --label laptop
在浏览器中粘贴这个令牌，R3 会颁发一个 HttpOnly Session Cookie 给会话，后续访问就不需要再输入了。令牌本身是可作废的——r3 auth revoke-token 会立即终止该令牌的所有会话。
适用场景总结
R3 的价值在于把「AI 编码 Agent 的产出审阅」从一个线性聊天问题，变成了一个有结构的异步评审流程。它解决的核心痛点是：
- 聊天框审阅的局限：反馈淹没在多轮对话中，缺少按行锚定、按条回复、状态跟踪
- 人机协作的反馈环路：Agent 执行后需要人的确认才能继续，R3 提供了这个确认面板
- 远程开发支持：SSH 隧道 + 登录门控，安全地在云开发机上运行
项目许可证为 MIT（许可宽松），可通过 npm 安装，适用于 macOS 和 Linux。不需要注册账号、不需要 API Key、不需要联网——完全本地运行。对于在日常生活中使用 Claude Code、Codex、Cursor 等编码 Agent 的开发者，R3 是一个极低侵入性的审阅流程补充。
相关链接：