Whiteboard 用画布连接架构与代码，化解 Agent 编程认知债

在 YC W26 项目中，来了个叫 Whiteboard 的开源桌面应用，针对的是个麻烦事：随着 Agent 生成的代码越来越多，开发者们逐渐积累起「认知债」——PR 已经合并了，可到底是怎么回事、Agent 在底层是怎么决策的，没人说得清。

这不是什么 IDE 替代品，而是个工具，通过画布把架构设计和实际代码连起来。基于 CodeOSS，它里面有类似 VSCode 的 LSP 支持和快捷键，上手时感觉还挺熟悉的。

它的几项核心能力，刚好卡准了 Agent 编程里几个实际难题。例如，架构图和代码逻辑之间怎么真正关联起来。用纯 HTML 可视化工具时，图和代码往往是分离的，但 Whiteboard 建立了一层映射：点击时序图、实体关系图或 Agent 执行轨迹里的某段引用，就会跳到对应的底层代码。

这种设计解决的是「实现后的权衡」问题。Agent 第一次生成的逻辑看起来顺理成章，可一进代码细节，就能发现架构设计里藏着的问题。通过这种可视化跳转，开发者可以在「设计蓝图」和「实现细节」之间来回核对。

再比方，怎么审查 Agent 产生的海量代码变更。Agent 执行得快，生成的 Diff 也可能臃肿。Whiteboard 使用 Rust 实现了一个基于 AST 的语义化 Diff 查看器。它不光比较每一行，还关注代码结构。

它预置了过滤逻辑：

• 自动摘要： Agent 新增一个很大的函数，系统不会要开发者逐行看，而是用伪代码概括函数逻辑。
• 自动折叠： 单元测试或文档变动，默认折叠或隐藏，让开发者把注意力放核心业务逻辑上。
• 插件扩展： 这些能力由 WASM 插件系统承载，可以定制化哪些变动需要被「摘要化」。

还能改善 Agent 决策过程的黑盒问题。Agent 经常自主决策，如果不记录下来，过几天再看代码，往往还原不了当时为什么这么写。

Whiteboard 给 Agent 了个 SDK，用于将执行轨迹关联到画布。开发者可以通过「决策日志」追溯需求、具体步骤，以及中间产生的自主决策。对于管理 Agentic Coding 的产出来说，这种透明度很关键。

目前，这个项目主要在 Salesforce 和 Modal 等公司用作架构评审工具，有两种方式：

• 白板会话： 先让 Agent 生成原型，同时创建对应的 Whiteboard 会话，再由人类介入迭代设计，而不是直接改代码。
• 结合 Greptile 进行深度评审： 先用 Greptile 执行自动化代码审查；如果发现某个变动涉及核心架构，再转到 Whiteboard 会话，由真人判断。

开发者怎么上手？这是一个采用 MIT 协议开源的桌面应用，直接在 GitHub 上能看源代码。

• 仓库地址： https://github.com/devdotfast/whiteboard
• 授权协议： MIT License
• 技术栈： 基于 CodeOSS，用 Rust 实现 AST Diff，还提供 WASM 插件系统。

个人开发者可以完全自己托管。官方计划推出面向企业的托管 Web 版，有轨迹存储和多人协作；当前开源版本已经能用来构建「人机协作」的开发环境。

如果 Agent 编程容易变得「失控」，或者 Agent 的 PR 看起来像天书，可以把这个项目 Clone 下来试试。