Whiteboard 这个开源 IDE 想解决 Agent 写代码带来的认知债问题

最近在看 YC W26 的项目时，看到一个叫 Whiteboard 的开源桌面应用，感觉它切中了一个挺扎心的痛点：当 Agent 写的代码越来越多，人类开发者往往会陷入一种“认知债”里——你看着 PR 被合并，却根本不知道 Agent 到底在底层做了哪些逻辑决策。

这套工具的核心逻辑不是取代 IDE，而是通过一个“画布（Canvas）”把架构设计和实际代码缝合在一起。它基于 CodeOSS 开发，这意味着你直接上手就能获得 VSCode 那套熟悉的 LSP 支持和快捷键。

我研究了一下它的几个核心功能点，对想要把 Agent 引入开发流的人来说，这几点很有意思：

如何把架构图和代码逻辑真正关联起来

以前用一些纯 HTML 的可视化工具，图是图，代码是代码，两者是断层的。Whiteboard 做了一层映射：当你点击时序图（Sequence Diagram）、实体关系图（ERD）或者 Agent 执行轨迹（Trace）里的某段引用时，可以直接跳转到对应的底层代码。

这种设计是为了应对“实现后的权衡（Trade-offs）”问题。很多时候 Agent 第一遍跑出来的逻辑看似通顺，但等你点进代码看细节时，才会发现架构设计上有坑。通过这种可视化跳转，开发者能更快地在“设计蓝图”和“实现细节”之间反复横跳。

怎么高效审查 Agent 产生的海量代码变更

Agent 跑起来很快，但产生的 Diff 往往非常臃肿。Whiteboard 用 Rust 写了一个基于 AST（抽象语法树）的语义化 Diff 查看器，它不是那种简单的行对比，而是能理解代码结构的。

它默认配置了一些比较聪明的过滤逻辑：

• 自动摘要： 如果 Agent 新增了一个非常大的函数，它不会让你一行行看，而是直接用伪代码（Pseudocode）给你总结出逻辑。
• 自动折叠： 像单元测试的变动或者大段文档的修改，默认会被折叠或隐藏，让你只关注核心业务逻辑的改动。
• 插件扩展： 这套逻辑是通过 WASM 插件系统实现的，你可以根据自己的习惯去定制哪些变动需要被“摘要化”。

解决 Agent 决策过程黑盒的问题

这是我最看好的一点。很多时候 Agent 会自主做出一些决策，如果不记录下来，过几天回头看代码根本不知道当时为什么这么写。

Whiteboard 给 Agent 提供了一个 SDK，让 Agent 可以把自己的执行轨迹（Traces）关联到画布上。你可以通过“决策日志（Decision Log）”去追溯：你设定的需求，Agent 是通过哪几步具体操作实现的？它在中间环节又做了哪些自主决策？这种透明度对于管理 Agentic Coding 的产出非常关键。

实际的使用场景和落地成本

目前看，这个项目主要在 Salesforce 和 Modal 这种公司被当作架构评审工具。它的用法大致分为两类：

• Agent 原型评审： 让 Agent 先出一个原型，同时自动生成一个对应的 Whiteboard 会话（Session），人类介入去迭代设计，而不是直接去改代码。
• 结合 Greptile 进行深度评审： 比如先用 Greptile 这种工具跑自动化的代码审查，如果发现某些变动涉及核心架构，再升级到 Whiteboard 会话，让真人介入判断。

开发者该如何上手

Whiteboard 目前是以 MIT 协议开源的桌面应用，你可以直接去 GitHub 上看它的实现。

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

对于个人开发者来说，它是完全可以自托管（Self-hostable）的。虽然官方未来会推出针对企业的托管 Web 版（包含轨迹存储和多人协作功能），但目前的开源版本已经足够用来构建一套“人机协作”的开发环境了。

如果你觉得现在的 Agent 编程太“失控”，或者觉得看 Agent 的 PR 像在读天书，这个项目值得去 Clone 下来跑跑看。