白板(Whiteboard)是一款开源桌面应用程序,人类与代理可在共同工作区内一起设计软件架构。它可接入用户已经在使用的工具,例如克劳德代码(Claude Code)、代码库(Codex)等,并为代理提供SDK在应用内画布上绘图以描述其工作过程。另有一个1分钟演示视频对此进一步说明。
正文
Whiteboard 是一款开源桌面应用,人类与智能体可在同一工作区共同设计软件架构。
Whiteboard 接入你已在用的工具(如 Claude Code、Codex 等),并为智能体提供 SDK,使其能在应用内画布上绘图以描述工作。

另有 1 分钟演示视频:https://www.youtube.com/watch?v=ChPn3ftULWE
快速开始
- 下载 Whiteboard(https://install.dev.fast/)并打开应用。
- 在欢迎界面连接 Claude Code、Codex 或其他编程智能体。
- 让智能体对照最新的 main 分支审查当前分支,并在 Whiteboard 中打开结果。
使用指引
在我们的体验中,Whiteboard 搭配 GPT-6 Sol 和 Claude Opus 5.5 等模型效果最佳,因其在智能、成本与速度间取得了平衡。
以下是几个有效使用 Whiteboard 的提示示例。我们正努力将合理选项默认内置到系统提示中(这也是该系统开源的原因之一),但目前可参考:
针对新的 API 变更
嘿,这堆提交是为了让 [api] 实现 [目标] 而设的。 我想看到: * 提议的 API * 示例 * 此事的动机(若上下文或仓库中有) 之后我们再深入实现并解释其运作方式。
针对添加遥测的变更
能否解释最新 posthog PR(https://github.com/devdotfast/whiteboard/commit/4837e107946e27ebad50c282eb0f2585210d2a35)中的遥测变更——我们在追踪什么,如何据此构建良好仪表盘或产品漏斗?对于卡死、错误、崩溃等如何处理……请用 whiteboard。
如果你看到不喜欢的任何内容,将其复制到剪贴板交给智能体,它便能在 Whiteboard 上重绘以满足需求。
为何存在
指向代码的图表
纯 HTML 工具难以轻松将规格或图表关联到代码;这尤其棘手,因为权衡往往在实现初稿后才显现。在 Whiteboard 中,点击序列图、实体关系图或智能体轨迹引语等可视化内容,即可直接跳至底层代码。浏览代码时,开箱即得 VSCode 的键位绑定与 LSP 支持。
语义化差异查看器
原始差异视图噪声很大,因此我们用 Rust 编写了感知 AST 的语义化差异查看器,仅显示相关的代码变更。我们设了合理默认:大型新增函数汇总为伪代码,单元测试与文档变更则折叠/隐藏。这些都可通过基于 WASM 的插件系统自定义。
决策日志
我们难以理清智能体自主做了哪些决策及其对变更的影响。因此构建了工具让智能体在 Whiteboard 上查询并关联自身轨迹,从而可视化你设定的需求、理解实现方式,以及智能体自主做出的决策。
开源,运行于本机
Whiteboard 采用 MIT 许可,运行于你的本地检出。团队托管版在计划中,但一切将始终可自托管。
已知限制
- 目前无法在 Whiteboard 中编辑文件。若你确实需要,请提交 issue。
- 单次审查中跨多个仓库工作和浏览文件支持不佳。
- 虽可通过分享按钮跨设备共享审查,但共享后更新的内容他人不可见,需重新共享。
贡献
欢迎贡献与反馈。阅读 CONTRIBUTING.md 了解配置与 PR 流程,遵守行为准则;漏洞按 SECURITY.md 报告;疑问可到 Discord 提问。
隐私
Whiteboard 运行于本地检出。匿名遥测不包含你的代码、差异、白板文本、提示词或模型输出。可阅读隐私概览、查看完整遥测参考,或随时关闭遥测。
许可
Whiteboard 基于 MIT 许可发布。其内置的 Code - OSS 分支保留微软 MIT 许可与第三方声明;见 apps/review-desktop/LICENSE 与 apps/review-desktop/UPSTREAM。
关于内置 Code OSS
如今大家使用专用智能体 TUI 和桌面应用,文本编辑器仅用于逐行审查差异,所以我们想为何不做一个专为代码审查的编辑器。既然如此,不如以最成功的开源编辑器为基线。
我们不像其他分支那样维护补丁,而是直接内置 Code OSS,因为智能体难处理补丁,且原版 VS Code 许多内容(如今约 45% 代码库是 Copilot 😬)并不需要。
我们定期监控上游 Code OSS,及时合并安全/功能补丁。
影响来源
- https://www.geoffreylitt.com/2026/07/02/understanding-is-the-new-bottleneck — 对现代软件工程制约的精彩概览。
- https://maggieappleton.com/2025-08-vibe-legacy-code/ 与 https://blog.val.town/vibe-code — 出色描述了 AI 生成代码如何融入 2025 年前的软件工程概念。
- Karpathy 谈智能体:
- 论 LLM 智能体:https://x.com/karpathy/status/1979644538185752935
- 论智能体作为“初级工程师怪才”:https://x.com/karpathy/status/1915581920022585597
评论
社区对该可视化架构工具态度分化,支持者肯定其以图表替代编码代理计划模式、辅助高层架构设计的实用方向,反对者则排斥 AI 生成落地页并强调人类思考不可替代;同时多人批评其仅支持 macOS 且体积庞大,并对“IDE”命名提出质疑。
认为该工具改进了架构设计工作流
- 认为工具抓住了当前与代理协作时常在架构层工作、需比计划模式更直观且可迭代的痛点,界面干净,对习惯 UML 图表的人有帮助,也有用户表示系统设计重要且认知债务飙升,同时不少用户表达期待试用情绪(较多人)。 > 很高兴看到这类产品,UML 风格图表仍是我设计架构时工作流的一部分(@shaundano)
质疑“IDE”命名且认为其只是单一功能
- 指出工具不能编辑文件,称其为 IDE 易引发误解;且相比自定义 Mermaid 文件加代理,它更像单一功能而非完整产品,计划里直接写代码可能不如审批后再写质量高(较多人)。 > 选择“IDE”这个词可能因那个“无法编辑文件”的小细节给你带来麻烦,不如叫头脑风暴工具(@bbor)
反感 AI 生成落地页并强调人类思考必要性
- 少数用户拒绝氛围编程式落地页,认为应减少 AI 增加人类思考,AI 记笔记是社会祸害。 > 我们需要更少的 AI 和更多的人类思考,思考过程及伴随复杂度提升的困难本是特性而非缺陷(@writtenone)
批评仅支持 macOS 且体积达七百余兆
- 多人指出仅支持 macOS 应在页面更醒目提示,且七百多兆的体积令人震惊(较多人)。 > 你们需要把“仅支持 macOS”放在更显眼的地方,这极大地冒犯了我(@bbor)
赞赏手写动画与伪代码语义对比等创新
- 少数人高度评价伪代码语义差异对比的绝妙想法,以及手写笔动画和流式图表生成技术的前瞻性,预测一年内会随处可见(少数人)。
有价值的补充
- Ballerina 编程语言本身静态提供语言与 UML 互转能力,且无需大语言模型,可作为本工具的对照参考。
- 模型名称“GPT-6 Luna 和 Claude Opus 5.5”疑似笔误,其等效版本可能应为 Astra。
- 部分开发者坚持需要终端和分屏面板,表示不会放弃这些传统开发环境要素。