Whiteboard logo

Whiteboard

打开

开源桌面画布:让编码 Agent 把流程图、语义 diff 和决策日志画在代码旁边,你终于能看清 Agent 到底改了什么、为什么这么改。

分享:
查看替代方案

Whiteboard

Whiteboard 是 /dev/fast 开发的开源桌面应用,2026-09-24 在 Hacker News 发布时提出的前提很直接:现在没人靠看 diff 来理解一次改动了。从你的 prompt 到那次 commit 之间,Agent 做了上百个决定,而逐行 diff 一个都留不下。Whiteboard 给 Agent 一块画布。

它接入你已经在用的编码 Agent(README 快速开始里点名 Claude Code 与 Codex),并给 Agent 一套 SDK,让它在工作时把东西画进应用内的画布。你会看到请求链路的时序图、表结构变更的实体关系图,以及从画布上任意一个框跳回对应代码行的链接。

核心功能

  • Agent 自己画图。 README 把 Whiteboard 定位成人和 Agent 一起设计软件的共用工作区。流程、实体、trace 都由 Agent 画出来;你觉得哪里不对,直接指着它让它重画。
  • 语义 diff 视图。 用 Rust 实现、基于 AST 的 diff:折叠测试与文档这类噪音,把新增大函数摘要成伪代码,并且可以通过 WASM 插件系统扩展。你看到的是真正带行为的改动。
  • 决策日志。 Agent 可以查询并把自己的 trace 链到画布上,你当时提的需求、Agent 自行做出的取舍、最终落地的代码,全在同一处。
  • 跳代码 + LSP。 点画布上的节点能跳到对应代码;因为底层 vendor 了 Code OSS,VS Code 快捷键和语言服务开箱可用。
  • 跑在本地仓库上。 匿名遥测不含 prompt、模型输出和 diff,也可以整体关闭。

适用场景

  • 审阅一条庞大的 Agent 分支:diff 有几千行时,真正该问的是「它决定了什么」,而不是「它敲了什么」。
  • 接口与表结构变更:看端点与表关系图,比读补丁文件快得多。
  • 接手 Agent 生成的代码:画布加决策日志,比从 commit 里反推意图短得多。
  • 架构讨论:先把 prompt 交给 Agent,让它在共用画布上把方案画出来,再决定要不要写代码。

定价

Whiteboard 免费且采用 MIT 许可,无需账号,直接跑本地 checkout,支持 macOS 与 Fedora Linux。官方表示团队版托管产品在计划中,并且始终会保持可自托管。写作时的当前版本是 2026-09-24 发布的 v0.1.2。

快速开始

  1. 从 install.dev.fast 下载应用,Fedora 版本在 install.dev.fast/linux。
  2. 打开 Whiteboard,在欢迎页接入 Claude Code、Codex 或其他编码 Agent。
  3. 让 Agent 对比当前分支与 main 并把结果开到 Whiteboard 里,然后别看 diff,看画布。

README 提到用 GPT-6 Sol、Claude Opus 5.5 这类模型时画出来的东西质量更好,这是经验之谈,不是硬性要求。源码与一分钟演示都在 GitHub。

限制与风险

  • 不能在 Whiteboard 里改文件。 它是审阅与推演界面,不是编辑器,README 明确写了这一点。请把它当成放在编辑器旁边的观察窗。
  • 只支持单仓库审阅。 在一次审阅里跨多个仓库浏览文件目前支持得不好。
  • 分享不是实时的。 分享出去的是快照,之后的改动对方看不到,得重新分享一次。
  • 项目还很年轻。 仓库创建于 2026-08-18,发布节奏很快且尚未到 1.0;因为 vendor 了 Code OSS,安装包也偏大,并需要定期跟进上游合并。

常见问题

支持哪些 Agent?

README 快速开始点名 Claude Code 与 Codex;只要 Agent 能用上 SDK,就能往画布上画。

我的代码会被上传吗?

Whiteboard 跑在本地 checkout 上。遥测是匿名的、仓库里有完整文档,且不包含代码、diff、prompt 或模型输出。

它是 VS Code 的 fork 吗?

它把 Code OSS vendor 进来当编辑器外壳,因此有 LSP 和熟悉的快捷键,再把画布、语义 diff 和决策日志叠在上面。

能替代我的 diff 工具吗?

不完全能。它替代的是「靠 diff 反推意图」这段工作;逐行修改仍然需要普通编辑器。

替代方案

  • Claude Code:这个循环里的 Agent 端,只需要终端工作流就用它。
  • Codex CLI:OpenAI 的终端 Agent,同样是 Whiteboard 的接入来源。
  • Cursor:AI 编辑器,更偏「改」的那一半。
  • magpie:在 Whiteboard 里工作时,用它把本地各个 Agent 指到任意模型。

使用技巧

  1. 把「画图」和「给 diff」写在同一个请求里,让画布和代码一起到位。
  2. 第一遍用语义 diff 的默认折叠,需要看测试时再调 WASM 插件选项。
  3. 在画布上直接高亮你不满意的部分,把选区交回给 Agent,比用文字描述准确得多。

总结

Whiteboard 针对的是 Agent 开发里工具链跟进最慢的那一段:从 prompt 到合并之间的黑箱,也正是意图最容易丢失的地方。如果你的代码审阅已经变成滚动机器写出来的 diff,那么一块能让 Agent 自己解释清楚的开源画布值得装一次。

评论

还没有评论。成为第一个评论的人!