Whiteboard：人机共绘的软件设计画布

项目简介

Whiteboard 是一款开源桌面应用，为人与 AI Agent 提供一个共同的软件架构工作区。它接入你已经在用的编码 Agent（例如 Claude Code、Codex 等），并通过 SDK 让 Agent 在应用内的画布上绘制图表，用来说明它的工作内容。

项目采用 MIT 许可证，基于本地代码检出运行，界面源自 Code OSS。官方还提供了 1 分钟演示视频：https://www.youtube.com/watch?v=ChPn3ftULWE

主要功能

• 从图直达代码：点击时序图、实体关系图，或 Agent 轨迹中的引用，即可跳转到对应的底层代码；浏览代码时可直接使用 VS Code 的快捷键与 LSP 支持。
• 语义化 Diff 查看器：用 Rust 编写的 AST 感知 diff 工具，只展示与你相关的改动。默认会把大段新增函数概括为伪代码，折叠或隐藏单测与文档改动，并可通过基于 WASM 的插件系统自定义。
• 决策日志：Agent 可查询并关联自己在 Whiteboard 上的轨迹，帮助你查看需求、理解实现方式，以及 Agent 自主做出的决定。
• Plan mode（v0.4.0）：可以创建、直接编辑尚未关联代码的计划白板；进入实现阶段后，Agent 会把审阅白板作为子级嵌套在计划白板下方，按栈顺序组织每个 PR。
• Markdown 式编辑：在侧边栏点击「+」直接新建白板，像编辑 Markdown 文件一样就地编辑，支持标题、表格、任务勾选框、行内数学公式等语法。
• 新布局：可折叠侧边栏包含 Whiteboard、Diff、Threads 三个标签，页面栏带面包屑，一次展示一个白板。

安装与使用

1. 从 https://dev.fast/install 下载 Whiteboard 并打开。macOS 也可以使用 Homebrew：

brew install --cask devdotfast/tap/whiteboard

2. 在欢迎界面连接 Claude Code、Codex 或其他编码 Agent。
3. 让 Agent 将当前分支与最新的 main 对比审阅，并在 Whiteboard 中打开结果。

官方建议配合 GPT-6 Sol、Claude Opus 5.5 等模型使用。示例提示词（针对一次 API 变更）：

hey, this stack of commits is set up so i can get an [api] to do [objective]

i'd like to see:

• proposed api
• examples
• motivations for this (if available to you in context/in the repo)

and then we can dive into implementation + explaining how things worked.

如果对画出的结果不满意，可以把不喜欢的内容高亮复制给 Agent，让它重新绘制。

注意事项

• 目前还不能在 Whiteboard 中编辑文件。
• 单次审阅中跨多个仓库浏览文件的支持还不完善。
• 通过分享按钮可以把审阅内容分享到其他机器，但分享之后的更新不会同步给他人，需要重新分享。
• 子白板不能再有下级子白板；暂不支持直接编辑图表，需要让 Agent 修改。
• 匿名遥测不包含你的代码、diff、Whiteboard 文本、提示词或模型输出，可随时关闭。

本作品整理自 GitHub 开源项目 devdotfast/whiteboard，原作者 @devdotfast，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。