@diffohq/diffo

中文文档
0.23.0发布于 2026/11/09Apache-2.0ES Module构建来源已验证近 30 天下载 2432

本地的 AI 时代的活代码审查 —— 读一下代理写的东西,然后直接反馈, 或者在你身后审查一个 GitHub 拖拉请求

中文使用文档
文档目录10 节
  1. 快开始
  2. 跟线上的人谈谈
  3. 分层读取
  4. 审查拉动请求
  5. 合适的话
  6. 如何运作
  7. 文档
  8. 打开核心
  9. 捐款
  10. 许可证和商标
Diffo: the human way to review agent-written code

叫你的经纪人来审查一下 你得到零钱 层按顺序排列 读取,以及 每条评论的另一端的代理: 它在线上回答并修正 你读的时候。 把它交给一个拉取请求, 它读在你旁边,并发送你的 向 GitHub 检讨.

快开始 • 妇女 谈话 • 妇女 层 • 妇女 调取请求 • 妇女 文档 • 妇女 捐款

CI npm License Docs

The Diffo loop. In the agent's terminal you type /diffo and the review opens beside it. You ask a question on line 14, and it flies to the agent; the agent fixes the code and answers, and the answer and the fix fly back, landing in the thread and in the diff you are reading.

整个循环: 类型 /diffo回答和修补 回到你正在读的diff.


快开始

要求数 节点 · 24 财务报告和审定财务报表 gi粘贴到 Claude 代码、 Cursor、 Codex 或 您已经使用的代理 :

Run `npx skills add DiffoHQ/diffo --skill diffo -g` and open the diffo review

这是整个安装。 从此以后,任何会话中都有一个命令:

运行和代理审查
/diffo刚刚写的,在事情发生之前
/diffo main自从你分道扬镳以来的一切 main
/diffo <PR link>a GitHub 拖取请求, 在自己的工作树上查看; 您的检讨完成后返回 GitHub

每一次,代理打开审查并交给你URL. 都运行在你身上 机器,不需要先犯或先推 牵引请求需要 GitHub 缩写 签入。 否则你唯一留下的 机器是两起匿名小事件 每一次评论, 全部列入清单 关闭 diffo telemetry off。 。 。 .

新来的? 你的第一次回顾,结束到结束 大约五分钟.

跟线上的人谈谈

我们用LLM写代码. 我们单独审查一下.

写作变成了一个对话:你和模型在同一窗口,交易背景直到 事情是对的。 从没有审查过 密码落地了,谈话结束,你走 一个人读四百行 在一个为世界而建的观赏器里 已经走了.

迪福通过评论保持对话开放. 判决还是你的 你刚刚 别一个人看书了.

  • 随时问. 在线条中写代码答案的代理商 当形状需要时用图表。 标记线程 a 问题 并解释它 (单位:千美元) 变动 它会编辑,所以一个问题永远不会变成一个没有要求的重构.
  • 在你读的书里修地道. Diff 在光标下更新,以及 a 哼,你已经读到说 从你读起就变了,所以第二次通行证停留 诚实.
  • 是地图 不是判决. 在一个多文件或微妙的更改中,代理打开审查 并给出一个关于变化作用的评论。 从来没有预先审查: 没有判决, 没什么好说的 这种判断是它不能做的.

分层读取

Diff按字母顺序到达,这几乎从来不是读取的顺序. 问,和 代理员额 层: 更改为命令步骤,每个步骤都有标题、摘要及其 文档。 你一次读一个层次, 按照代理解释的顺序; ] 步骤 下一个 任何特工在张贴后接触的东西 从你审查以来 层, 所以计划之外没有什么能隐藏的.

Layers in Diffo. The header chip reads agent · suggests layers and the reviewer accepts. The request crosses to the agent's terminal, which outlines the 13-file change as four ordered steps and posts them with diffo layers. Four layers land in the rail; the first layer's card draws its diagram, its files are read and ticked, and ] steps to the second and third layers.

十三个文件,字母顺序,成为四个步骤,按顺序阅读.

审查拉动请求

当拉起请求降落  桌子,给你的经纪人链接。 检查公关 在自己的工作树上, 所以你的退房 从来没有触摸过, 打开它一样 检讨:描述和GitHub线程随同来,代理读取旁边 你作为一个副驾驶 它没有写代码。 每条评论都有两个分页. 关于 PR 的评论 给作者,作为你完成的一次评论. 询问代理 留在你的机器上: 代理可以进行测试 并用证据回答, 它从来没有张贴到 GitHub.

A pull request in Diffo: you hand the PR link to your agent and it is checked out in a worktree of its own; a Private question on line 13 crosses to your agent, which runs the tests and answers in the thread; a PR comment waits as a draft until Submit review, and then the review crosses to GitHub, while the private thread stays on your machine.

两个目的地:a 私营 问题交给你的经纪人 永远不要离开你的机器 公关评论 等待作为草稿,并在提交时前往 GitHub .

合适的话

迪福不是AI评论员. 它没有分级你的diff 或留下生成的niticks: 你 读取,代理在那里 回答,解释,和修复.

迪福AI 审查器机器人纯拉动请求审查
谁读的代码你们一个模型你们
谁回答你的问题代理,在线,现在没人作者,当他们得到它
何时当代理商写作时,或者当公关着陆时你推车后你推车后
出来的东西diff 中的修正, 或 GitHub 上的检讨评论意见清单关于 GitHub 的回顾

如何运作

Diffo's architecture: your agent writes the code and opens the review; a local Diffo server watches the changeset and serves it to your browser; your comments and Finish review return to the agent through diffo poll, and its answers and fixes land back in the review live.

一个过程在你的机器上,注定要回回回:没有帐号,没有云,也没有模型 API. 它报道的一件事是 匿名使用数据, (中文(简体) ), 每个评论中有两个事件, 从来没有代码或路径, 关闭一个命令。 迪福产下没有毒剂 你已经说过要通过 diffo CLI,这样 您的评语会出现在相关时段 。 查看器本身是一个真正的 diff 查看器,统一和分割,键盘第一,与 GitHub的公约. CLI,旗帜, 和罩下的一切 都在文件.

文档

你的第一次回顾整个循环结束,大约五分钟
开始安装, 在每个代理设备被接通的地方
审阅循环阅读、评论和代理人收到的物品
层特工的读取计划: 命令步骤,一次一个
审查拉动请求工作树上的GitHub公关 你的经纪人在你旁边 你对GitHub的评论
如何运作组件和服务器生命周期
代理人方面代理协议:每个命令,每个有效载荷
建筑Diff 管道、 交付队列、 SQLite 状态
国 际 财务报告和审定财务报表 键盘快捷键参考文献
财务问题简短的答案

打开核心

这个寄存器中的所有东西都是核心,核心保留了Apache-2.0:本地审查 代理循环,牵引请求审查,CLI,代理技能. 脱机,一个 审校,永远免费 已经计划了东道团队的级别, 并且不需要 付费墙背后的现有核心特征 : 任何在你的机器上运行的 审校是核心.

捐款

Diffo为前1.0:这个repo每天随它审查,边缘仍然在移动. pnpm check 开着五道门 CI跑道 一个硬规则: skills/diffo/SKILL.md 实值 生成 从 src/skill.ts; 编辑源并运行 pnpm build:skill。 。 。 . 捐款额 剩下的,还有.. 行为守则, (中文(简体) ), 页:1 变化,则 洛杉矶 一个机器人询问第一次贡献者 签名,一个回复.

发现安全隐患了吗? 请不要公开讨论 这个 安全政策 说何处寄出及所入范围.

Contributors

许可证和商标

Diffo 是打开源 Apache 许可证 2.0整个,今天。 A 类 迪福企业许可证 已存在但目前覆盖 没有文件 全部它被写下来 所以开放的核心边界 在需要它之前就解决了 承诺Apache-2.0在发布版本中不会在以后移动.

这个 迪福 名称和标志是Diffo的商标: 许可证覆盖代码,而不是名称.欢迎叉子 以你自己的名义.

版本与发布记录

@diffohq/diffo 共发布 32 个版本,首次发布于 2026/08/25;过去 12 个月发布了 32 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.23.0latest2026/11/093 天前
0.22.02026/11/085 天前
0.21.02026/11/076 天前
0.20.02026/11/039 天前
0.19.02026/11/0310 天前
0.18.22026/10/2915 天前

关于 @diffohq/diffo 的常见问题

@diffohq/diffo 是什么?

本地的 AI 时代的活代码审查 —— 读一下代理写的东西,然后直接反馈, 或者在你身后审查一个 GitHub 拖拉请求

如何安装 @diffohq/diffo?

在项目目录运行 npm install @diffohq/diffo,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 diffo,可以用 npx diffo 直接运行。

@diffohq/diffo 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/diffohq__diffo 是否存在。

@diffohq/diffo 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@diffohq/diffo 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@diffohq/diffo 可以商用吗?

@diffohq/diffo 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@diffohq/diffo 的下载量有多少?

根据 npm 官方下载统计,@diffohq/diffo 在 2026/10/12 – 2026/11/10 这 30 天内被下载 2,432 次,日均约 81 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@diffohq/diffo 还在维护吗?

最新版本 0.23.0 发布于 2026/11/09(3 天前);至今共发布 32 个版本,其中过去 12 个月发布了 32 个;首次发布于 2026/08/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。