Whiteboard 是一个开源桌面应用，人类和智能体可以在同一个工作区中共同设计软件架构。

Whiteboard 可以接入你已经在使用的工具——例如 Claude Code、Codex 等——并为你的智能体提供一个 SDK，让它在应用内画布上绘制内容来描述自己的工作。

An agent draws a flow diagram on a Whiteboard next to the code it describes

这里有一个 1 分钟演示视频，进一步说明：https://www.youtube.com/watch?v=ChPn3ftULWE

快速开始

  1. 下载 Whiteboard然后打开应用。
  2. 在欢迎界面连接 Claude Code、Codex 或其他编程智能体。
  3. 让你的智能体将你当前的分支与最新的 main 进行对比审查，并在 Whiteboard 中打开结果。

使用指引

根据我们的经验，Whiteboard 最适合搭配 GPT-6 Luna 和 Claude Opus 5.5 这类模型，因为它们在智能、成本和速度之间取得了良好平衡。

以下是一些示例提示词，展示如何有效使用 Whiteboard。我们正在努力确保正确的选择默认内置到系统提示词中——这也是这个系统开源的部分原因！——但在此期间：

针对一次新的 API 变更

嘿，这堆提交已经准备好了，让我可以拿到一个 [api] 来实现 [目标]

我想看到：

  • 提议的 api
  • 示例
  • 这样做的动机（如果你的上下文/仓库中有的话）

然后我们可以深入实现 + 解释它是如何运作的。

针对一次添加遥测的变更：

你能给我解释一下最新那个 posthog pr 里的遥测变更吗https://github.com/devdotfast/whiteboard/commit/4837e107946e27ebad50c282eb0f2585210d2a35——我们在追踪什么，我们如何据此构建好的仪表盘或产品漏斗？对于挂起、错误、崩溃等情况我们该怎么做……用 whiteboard

如果你看到任何不喜欢的地方，在剪贴板中把它高亮出来，交给你的智能体，它就可以在 Whiteboard 上重新绘制以满足你的需求！

为什么会有这个项目？

通向代码的图表

纯 HTML 工具无法提供便捷的方式来将规格或图表与代码关联起来；这一点尤其棘手，因为权衡往往只有在第一次实现之后才会被发现。在 Whiteboard 中，当你点击序列图、实体关系图或智能体 trace 中的引用等可视化内容时，你可以直接跳转到底层代码。在浏览代码时，你可以开箱即用地获得 VSCode 的快捷键绑定和 LSP 支持。

语义 diff 查看器

原始 diff 视图可能非常嘈杂，因此我们用 Rust 编写了一个语义化、AST 感知的 diff 查看器，让你只能查看与你相关的代码变更。我们设置了一些合理的默认值：大型新增函数会被总结为伪代码，单元测试和文档变更等内容会被折叠 / 隐藏。这一切都可以通过基于 WASM 的插件系统进行自定义。

决策日志

我们发现很难推断我们的智能体自主做出了哪些决策，以及这些决策如何影响变更。因此我们为智能体构建了工具，让它们可以在 Whiteboard 上查询并链接自己的 trace，这样你就可以可视化你设定的需求、理解它们是如何被实现的，并了解智能体自主做出了哪些决策。

开源，运行在你的机器上

Whiteboard 采用 MIT 许可证，并针对你的本地检出运行。面向团队的托管产品已在规划中，一切将始终可以自托管。

已知限制

  • 你目前无法在 Whiteboard 中编辑文件。如果你发现自己想要这样做，请提交 issue！

  • 在一次审查中跨多个仓库工作和浏览文件的支持还不够完善。

  • 虽然你可以通过分享按钮在不同机器之间分享审查，但审查分享后所做的更新不会对其他人显示。你需要重新分享该审查。

贡献

欢迎贡献和反馈。

阅读CONTRIBUTING.md了解设置和 pull request 工作流，并遵循行为准则。按照SECURITY.md中所述报告漏洞。有问题？在Discord上提问。

隐私

Whiteboard 针对本地检出运行。匿名遥测不包含你的代码、diff、Whiteboard 文本、提示词或模型输出。阅读隐私概览，查看完整的遥测参考，或随时关闭遥测。

许可证

Whiteboard 基于MIT License提供。内置的 Code - OSS 分支保留 Microsoft 的 MIT 许可证及第三方声明；参见apps/review-desktop/LICENSE和apps/review-desktop/UPSTREAM。

关于内置 Code OSS

既然大家都在使用专用的智能体 TUI 和桌面应用，我们现在只用文本编辑器逐行审查 diff，所以我们想，何不做一个专门用于审查代码的文本编辑器呢。既然如此，不妨以市面上最成功的开源编辑器作为起点。

我们内置 Code OSS，而不像其他分支那样维护补丁，因为编码智能体很难处理补丁，而且原版 VS Code 中有很多我们不需要的东西（比如，如今约 45% 的代码库都是 Copilot 😬）。

我们定期监控上游 Code OSS，并在安全/功能补丁出现时合并进来。

影响来源