Whiteboard 是一款开源桌面应用程序,旨在构建人类与 AI 代理(Agents)协同工作的软件架构空间。该工具无缝集成 Claude Code、Codex 等编码代理,并提供 SDK 允许代理在应用内画布绘制图表,以可视化方式呈现工作成果。

快速上手与工作流

用户下载并打开 Whiteboard 后,可在欢迎界面连接 Claude Code、Codex 或其他编码代理。典型使用场景包括:要求代理对比当前分支与最新 main 分支的差异,并将审查结果直接在 Whiteboard 中打开。

实测显示,Whiteboard 与 GPT-6 Luna 和 Claude Opus 5.5 等模型配合效果最佳,这些模型在智能水平、成本与速度之间取得了良好平衡。为确保系统提示词默认包含最佳实践,开发团队建议参考以下提示词模板:

  • 针对 API 变更:“这一系列提交旨在实现 [API] 以完成 [目标]。请展示提议的 API 设计、使用示例及动机(若上下文可得),随后深入探讨实现细节。”
  • 针对遥测数据变更:“解释最新 PostHog PR 中的遥测变更,说明追踪指标、仪表盘构建方式及对卡顿、错误、崩溃的处理逻辑,并使用 Whiteboard 进行分析。”

若对生成内容不满意,用户可将其复制至剪贴板,交由代理在 Whiteboard 上重新绘制。

核心功能亮点

从图表到代码的双向关联

传统 HTML 工具难以将规范或图表有效连接至代码,导致权衡取舍往往在实施后才被发现。Whiteboard 支持点击序列图、实体关系图或代理轨迹中的可视化元素,直接跳转至底层代码。浏览代码时,用户可享受 VSCode 原生的快捷键支持和语言服务器协议(LSP)支持。

基于 AST 的语义差异查看器

为解决原始差异视图噪音过大的问题,Whiteboard 使用 Rust 编写了感知抽象语法树(AST)的语义差异查看器。该工具默认将新增的大型函数总结为伪代码,并折叠或隐藏单元测试和文档变更,让用户聚焦核心代码改动。所有行为均可通过基于 WASM 的插件系统进行自定义。

代理决策日志可视化

针对代理自主决策难以追溯的问题,Whiteboard 允许代理查询并在画布上链接自身的轨迹记录。这有助于开发者可视化需求设定、理解实现路径,并复盘代理自主做出的决策及其影响。

技术架构与隐私

Whiteboard 采用 MIT 许可证,完全在本地代码库副本上运行。团队计划推出托管产品,但所有内容将始终保持可自托管特性。

在隐私保护方面,匿名遥测数据不包含代码、差异内容、文本、提示词或模型输出。用户可随时关闭遥测功能,或查阅完整的遥测参考文档。

关于底层编辑器,Whiteboard 引入并打包(vendored)了 Code OSS。相较于维护补丁分支,此举是因为编码代理难以处理补丁,且标准 VS Code 中约 45% 的代码库为 Copilot 相关功能,属于非必要负载。团队会定期监控上游 Code OSS,并在安全或功能补丁推出时进行合并。

已知局限性

  • 目前不支持在 Whiteboard 中直接编辑文件。
  • 单次审查中跨多个仓库工作和浏览文件的支持尚不完善。
  • 分享审查结果后,后续更新不会自动同步,需重新分享。

欢迎开发者通过 Discord 社区、CONTRIBUTING.md 及 SECURITY.md 参与贡献或报告漏洞。