YC投资开源Whiteboard：用画布和语义diff帮你读懂AI代码
内容提要
2026年，四人团队开源了Whiteboard，通过画布、语义化差异查看器和决策日志帮助理解AI生成的代码。它可接入Claude Code等智能体，点击图表跳转源码，语义差异仅显示关键变更。文章指出AI写码速度过快，人类理解力成为瓶颈，导致“认知债务”。但该工具无法编辑代码，体积达736MB，且存在真相源过期问题。
延伸解读
认知债务：比技术债务更隐蔽的团队风险
文章引用Thoughtworks技术雷达提出的“代码库认知债务”，指出它与技术债务的本质区别：技术债务是代码写得烂，认知债务是代码可能写得挺好，但开发者不理解其设计意图和耦合关系。AI让代码变更速度暴涨，尤其多人多智能体协作时，团队容易跟丢设计意图。这种债务无法用工具量化，却会慢慢腐蚀团队的决策能力，因为理解代码是为了在下一轮迭代中还能当有创造力的贡献者。
语义化差异查看器：从行级对比到结构级理解
Whiteboard用Rust编写了基于AST的语义化差异查看器，底层用tree-sitter解析代码结构，而非逐行文字对比。默认行为包括：新增大函数摘要为伪代码、单元测试和文档变更折叠隐藏、长注释折叠。这些规则可通过WASM插件系统自定义。对于AI一次改几百行的情况，行级差异只会造成信息过载，而结构级对比能过滤噪声，只展示与审查相关的关键变更，帮助开发者快速抓住逻辑变化。
定位争议：是IDE还是画布？
Whiteboard自称“集成开发环境”，却无法编辑代码文件，引发Hacker News上激烈讨论。有评论者认为它更像“挂着MCP协议界面的代码阅读器”。创始团队承认用词有问题，内部在重新想名字，并解释称大多数人用VS Code就是审查代码，所以用这个词更容易理解。Sid将Whiteboard定位为“画布”，与现有工具并行：你在Claude Code或Codex里写代码，AI同时把结果画在白板上，不抢现有工作流。
现实局限：体积、平台与真相源过期
Whiteboard在macOS上安装包达736MB，因为基于Code OSS构建，打包了整个VS Code，其中Rust语义差异组件占138MB。团队承认这是“抢跑阶段的产物”，未来会重写为原生应用。目前仅支持macOS和Linux，Windows版本未定。更棘手的是“N+1真相源”问题：白板会话可能像设计文档一样过期，若让AI定期更新图表，可能产出无人能懂的废话；若不更新，白板就成了与当前代码脱节的考古标本。团队承认这是未来托管版本要解决的核心痛点，但尚无时间表。
Q&A
Whiteboard 是什么？它主要解决什么问题？
Whiteboard 是一个面向软件开发设计的开源画布应用，旨在让人与 AI 智能体在同一工作空间中协作进行软件架构设计。它主要解决 AI 写代码速度超过人类阅读速度后，软件工程瓶颈从“生成”转移到“理解”的问题，帮助开发者看懂 AI 生成的代码。
Whiteboard 通过哪些机制帮助理解 AI 生成的代码？
Whiteboard 通过三层机制帮助理解：一是画布，智能体实时绘制时序图、实体关系图等，点击图表元素可跳转到对应源码；二是语义化差异查看器，基于 AST 过滤噪声，只展示关键变更，大函数摘要为伪代码，测试和文档变更折叠；三是决策日志，让智能体查询和关联执行轨迹，可视化其自主决策过程。
什么是“代码库认知债务”？它和技术债务有什么区别？
认知债务指系统实现与开发者对系统的理解之间出现的裂缝，AI 加速代码变更后尤其严重。它与技术债务不同：技术债务是代码写得烂导致后续修改困难；认知债务是代码可能写得很好，但开发者不知道它为什么长这样，这种债存在于开发者头脑中，影响理解能力和持续开发效率。
Whiteboard 目前有哪些已知的局限或争议？
已知局限包括：无法编辑代码文件，被质疑不配称为 IDE；安装包体积达 736MB（macOS），因为基于 Code OSS 构建；存在 N+1 真相源问题，白板可能像设计文档一样过期；目前仅支持 macOS 和 Linux，Windows 版本未发布；托管版本的计划（轨迹存储、多人审查）尚无时间表和定价。
Whiteboard 的语义化差异查看器是如何工作的？
它用 Rust 编写，底层用 tree-sitter 解析代码的抽象语法树，进行结构层面的对比而非文字逐行对比。默认行为包括：新添加的大函数自动摘要为伪代码，单元测试和大段文档变更折叠隐藏，长注释折叠。这些规则可通过基于 WebAssembly 的插件系统自定义。
Whiteboard 团队对“先审计划再审代码”的传统流程有什么不同看法？
创始人 Sid 认为先审计划再审代码的流程本身有问题，因为关键权衡往往只有在实现之后才会浮现。他提出“写代码这个动作本身就是让规格变得更完善的一种便宜手段”，即让 AI 先写一版代码，再反过来看代码暴露了哪些设计取舍，比对着纯文字计划空想更靠谱。
