Pinrail 发布桌面端代理审查工具:实现代码变更的异步人工审批流

原标题:Show HN: Pinrail – A desktop inbox where coding agents wait for your review
68AI 研判分

Pinrail 推出了一款专为编码智能体设计的桌面收件箱应用,旨在解决在聊天界面中审查代码变更的低效问题。该工具允许 Claude Code、Codex 等任意支持命令执行的智能体将待审批操作推送至独立视图,用户可在此进行结构化审查并反馈决策,从而建立更清晰的人机协作工作流。

报道正文

本文目录5 个章节

官网 · 下载 · 文档 · 插件

Pinrail 是一款桌面应用,你的编码代理(coding agents)会在执行操作前向你请示。 你可以在专为该场景设计的视图中审查代理提出的方案,代理将根据你的决定继续执行后续任务。

Pinrail 打开代码审查界面:显示代理在 diff 上的发现,其中一项已接受并附带备注给代理,另一项已拒绝并说明理由,侧边栏中还有其他待处理的审查请求

Pinrail 兼容任何能够运行命令的代理,例如 Claude Code、Codex、Cursor 或 OpenCode。它支持 macOS 和 Linux,Windows 支持即将推出。Pinrail 目前处于早期开发阶段,因此可能会遇到一些粗糙之处,且版本之间可能会有变动。

为什么需要 Pinrail

代理擅长执行工作,但某些步骤需要人工介入:以你的名义发布的评论、发给客户的邮件、对生产环境的更改。在聊天窗口中批准这些步骤意味着要阅读一大段文字并手动输入回复。Pinrail 为这些关键时刻提供了专门的审查体验:

  • 由代理决定何时询问。 其指令中明确指出了需要你介入的步骤,因此它仅在这些步骤处发起询问,而在其他地方则自动执行。
  • 每个审查都有为其内容量身定制的视图。 代码审查会展示带有代理发现的 diff;一组生成的图像会以图片形式展示,你可以直接在需要修改的部分绘制选框。
  • 你的决策是结构化的。 代理将收到你接受的内容、拒绝的内容以及你的备注,格式可以是可供其执行的 Markdown,也可以是供脚本使用的 JSON。
  • 所有数据都保留在你的本地机器上。 该应用仅在回环地址(loopback)上提供 API 服务,并将你的审查记录和决策保存在本地。

工作原理

流程图

当代理到达需要你介入的步骤时,它会通过 pinrail 命令提交一个审查请求:包括用于展示该审查的插件、标题以及一个 JSON 载荷。

BASH
pinrail submit code-review --title "Retry failed webhook deliveries" \
  --data findings.json --wait

Pinrail 会通知你,审查请求将按项目分组等待在你的收件箱中处理。

收件箱界面:来自多个代理和项目的审查请求,每项都显示了其具体请求内容

你打开它,并在插件视图中做出决定。在本页面顶部的代码审查中,你可以接受或拒绝智能体提出的每一项发现,并给智能体写一条备注。

当你提交审查结果时,命令会打印你的决定并退出,随后智能体继续执行:

TEXT
r_01K5R2 · decided · Retry failed webhook deliveries
code-review · decided by maya at 2026-09-23 10:14

- **#1 accepted** `src/deliver.ts:42` — The worker sleeps for up to 31 seconds per delivery (major)
  > Agreed. Re-enqueue with runAt = now + backoff(attempt)
- **#4 rejected** `src/log.ts:18` — The give-up log should say why (nit)
  > Fine as it is; the log already has the delivery id.

Undecided: #2, #3, #5

命令的退出码表明审查结束的方式:已决定、带停止指令被丢弃、撤回或过期。当你要求修改时,智能体会提交新一轮审查,应用会在旁边显示你之前的裁决。

入门指南

  1. 从下载页面或最新版本安装应用。在 macOS 上,该应用已经过签名和公证。
  2. 遵循首次启动时打开的设置向导。它会安装 pinrail 命令,将 Pinrail 的技能添加到计算机上检测到的智能体中,并安装推荐的插件。
  3. 用你自己的话向智能体提问:
TEXT
   Ask me through Pinrail which TODOs in this repository to tackle first.

或者询问它在你的项目中哪些地方适合使用 Pinrail:

TEXT
   Look at this project and suggest where you should ask me through Pinrail before you act.

你的第一次审查会引导你完成这一过程,而指导智能体则展示了如何让智能体在你选择的步骤中每次都向你发起询问。

插件

每种类型的审查都是一个插件:包括智能体发送的数据负载、你返回的决定以及你进行决策的视图。应用自带五个核心插件:

插件评审界面
code-review显示代码差异(diff),包含 Agent 提出的评审意见,每条意见可被接受、拒绝或编辑。
list按标题分组的项目列表,每项均可接受或拒绝并附带备注。
feedback一次性回答的问题集:包括选项、是/否判断以及自由文本输入。
markdown文档视图(如计划或规格说明书),支持逐节阅读和评论。
image生成的图像供选择,支持在需要修改的部分绘制框选标记或图钉标注。
<table> <tr> <td><img src=".github/assets/image.png" alt="The image plugin: candidate illustrations, with a box drawn on the part to change"></td> <td><img src=".github/assets/feedback.png" alt="The feedback plugin: questions with choices, yes or no, and a comment"></td> </tr> </table>

forgeplane/pinrail-plugins 中的示例插件展示了插件的其他功能潜力。它们涵盖 HTML 页面、电子邮件、日历、Logo、配色方案、3D 模型、动画、音频、视频、设计画布、前后对比以及交易记录等场景。每个插件均以 zip 格式发布,可在应用的 Settings › Plugins(设置 > 插件)中安装。

The sample plugins in forgeplane/pinrail-plugins, each showing a review

编写插件

一个插件由清单文件(manifest)、两个 JSON Schema 和一个 HTML 视图组成,无需构建步骤。使用 pinrail plugins new <name> 即可创建新插件。插件 SDK pinrail-sdk 允许你在不启动应用的情况下,直接在浏览器中运行视图并使用 Playwright 进行测试。视图也可以使用 React、Vue、Svelte 或其他任何框架来构建。详见 Writing a plugin。

(注:更多技术实现细节与完整 API 文档请查阅原项目 README)