Whiteboard Vibe 项目

项目简介

Whiteboard 是一款开源桌面应用，让人类工程师和 AI 编程助手在同一个可视化画布上共同进行软件架构设计。它直接插入你已有的 AI 编程工具（如 Claude Code、Codex 等），为 AI agent 提供一套绘图 SDK，让 AI 在画布上绘制架构图、时序图、ER 图来描述其工作结果，从而弥合了纯文本 diff 与人类理解之间的鸿沟。

核心功能

• AI 画布协作：AI agent 可在 Whiteboard 画布上绘制架构图、API 契约图、时序图和 ER 图等可视化产物，无需人工转译
• 语义级 Diff 查看器：自研 Rust 编写的 AST 感知 Diff 工具，自动过滤无关变更（测试文件、文档变更），大函数以伪代码摘要展示
• WASM 插件系统：所有可视化展示均可点击跳转到底层代码，支持 VSCode 风格的快捷键和 LSP 导航
• Agent Trace 可视化：追踪 AI agent 的自主决策路径，呈现需求 → 实现 → 自主决策的完整链路
• 本地化运行：所有数据保留在本地 checkout，支持自托管，MIT 许可证，不上传代码或提示词
• 支持多模型：经测试在 GPT-6 Sol 和 Claude Opus 5.5 上效果最佳

技术实现

Whiteboard 的核心技术栈建立在 Electron + Code OSS（VSCode 开源分支）之上，针对 AI 编程场景做了大量定制。

绘图引擎：AI agent 通过 SDK 与 Whiteboard 通信，SDK 采用类似 Figma/Excalidraw 的矢量绘图接口，AI 可在画布上动态创建、标注和链接图元。每个图元（如一个 API 节点、一段代码引用）均可绑定到具体文件路径和代码行号。

语义 Diff 解析器：传统行级 Diff 对 AI 生成代码（往往大量重写）过于嘈杂。Whiteboard 用 Rust 重写了 AST 解析层，在语法树层面比较新旧代码，只展示语义相关的变更。单元测试和文档变更默认折叠，开发者可自定义规则。

Agent Trace 链路：AI 在完成任务时会留下大量隐式决策（选择哪个 API、接受哪种实现方案）。Whiteboard 提供了让 agent 查询并关联自身 trace 的工具，将 AI 的思考过程以可视化链路图呈现，人类可审查 AI 在哪些环节做了自主决策。

隐私设计：所有操作针对本地 Git checkout，不存在云端传输。遥测数据（可选）不包含代码内容、Whiteboard 文本、提示词或模型输出。

快速上手

1. 访问 install.dev.fast 下载并安装 Whiteboard，打开应用
2. 在欢迎界面选择连接 Claude Code、Codex 或其他已配置的 AI 编程助手
3. 向 AI 发送指令，例如：“请 review 当前分支相比 main 的变更，用 Whiteboard 展示”
4. AI 在画布上生成架构图、diff 摘要和 trace 链路，点击任意图元跳转到底层代码

适用人群

• 软件架构师：需要快速理解 AI 生成的代码结构和设计决策
• AI 编程工具用户（Claude Code / Codex 用户）：需要比纯文本更直观的代码审查体验
• 技术 lead：需要监督 AI agent 在大型项目中的自主决策范围
• 开源贡献者：对 AI 辅助编程的边界和透明度有要求的开发者

官方信息

• GitHub：https://github.com/devdotfast/whiteboard
• 下载：https://install.dev.fast
• 许可证：MIT
• Discord：https://discord.gg/wYvd2cpMQg