devdotfast/whiteboard

如果你经常把长任务交给编程 Agent，又常常搞不清它到底做了什么决定，这个项目值得花半小时试一下。把它当成审阅和解释的界面，而不是替代编辑器的工具。

解决什么问题

当 Agent 完成一串提交后，你拿到的通常是一大堆 diff 加一段文字总结。你真正想先知道的是这次改动的形状：API 长什么样、数据模型怎么变、调用顺序是什么，然后才去看具体代码行。今天这意味让 Agent 在文件里写一段 Mermaid 图、复制到别处，再回仓库里找每个框对应的代码。Whiteboard 让 Agent 直接画在应用内画布上，点序列图节点或引用的轨迹步骤就能跳到对应源码，解释和实现放在同一个地方。

有什么不同

它的核心机制是一套 SDK 与插件接口，让已连接的编程 Agent（如 Claude Code、Codex 或其他 Agent）把可视化内容写进共享工作区。点击序列图、实体关系图或轨迹片段会打开相关源码，内嵌的编辑器是打包进来的 Code OSS 构建，因此自带 VSCode 快捷键和 LSP 导航能力。旁边还有一个用 Rust 写的 AST 感知 diff 查看器：默认把新增大函数概括成伪代码，折叠测试和文档改动，并可通过 WASM 插件调整行为。Agent 还能查询并关联自己的轨迹，用来还原哪些决定是自主做出的、原因是什么。

主要代价是它会是编辑器和 Agent 终端之外的第三个窗口。画布内容取决于 Agent 是否主动调用 SDK，所以提示词习惯仍然重要；README 给出了示例提示词，并说明合适的默认行为还在往系统提示词里打磨。编辑器采用打包 Code OSS 而非维护补丁的方式，意味着上游合并由项目自己承担；README 称会定期合入安全与功能补丁，但这是需要观察的维护承诺，不是保证。

谁值得试

适合：审阅 Agent 生成分支、主要需要先理解架构层面的开发者，比如 API 形状、表结构、遥测新增、请求流程，再去逐行看代码。有评论者认为现有规划模式很难与 Agent 就架构做可视化反复迭代，这正好对应这类需求 2001zhaozhao 的评论。不适合：想在同一窗口里改代码的人，或需要一次审阅跨多个仓库改动的人。README 明确列出暂不支持编辑文件、跨仓库浏览支持不好，前者会把你推回另一个编辑器，后者限制了相邻多仓工作流。1 分钟演示视频是判断输出风格是否合你口味最快的方式。

使用条件与边界

这是一个 macOS、Windows、Linux 桌面应用，通过下载页或 Homebrew cask 安装，没有描述浏览器版本。你需要一个能驱动 SDK 的已连接编程 Agent，以及本地代码检出，因为 Whiteboard 运行在本机代码上而不是托管副本。匿名遥测据称不含代码、diff、提示词和模型输出，并可随时关闭。

三个已记录的边界在实际使用中影响较大：Whiteboard 里不能编辑文件；分享审阅是快照，之后的更新不会出现在接收方那里，需要重新分享；一次审阅中浏览多个仓库的文件支持不佳。还要为维护留出预期：编辑器是打包的上游分支而非补丁集，能否跟上上游取决于维护者合并的节奏。

HotRepo 点评

2026-10-25 该项目出现在 HotRepo TypeScript 月榜第 10 名，当月 +2,476 stars，项目当时 67 天；HotRepo 只记录到这一天，无法据此判断热度能否持续。Show HN 帖在 2026-09-24 获得 424 分和 143 条评论，这只能说明讨论量，不构成共识。决定投入前，先确认 Agent 连接与插件文档覆盖你实际使用的 Agent——画布的价值取决于背后的 SDK 集成。