为什么Whiteboard要vendoring Code OSS一个AI时代的VS Code分叉设计决策【免费下载链接】whiteboardopen-source canvas for thoughtful software design项目地址: https://gitcode.com/gh_mirrors/whiteboard36/whiteboardWhiteboard 是一个开源的 AI 软件设计画布让人类与 Claude Code、Codex 等编码代理在同一工作区里共同设计、审查代码。它的桌面端没有从零写编辑器而是把 VS Code 的开源内核Code OSS 整体 vendor 进仓库形成了一个面向 AI 时代的 VS Code 分叉。本文将从动机、做法到上游同步策略拆解这个设计决策。决策速览维度Whiteboard 的选择基线Code OSSVS Code 开源内核分叉方式整仓 vendor而非补丁维护差异管理全部登记在 UPSTREAM可枚举可审计许可证MIT保留上游 MIT 许可与第三方声明一、背景AI 时代编辑器变成了审查台 当 AI 代理承担大部分写代码工作后人类打开文本编辑器的主要目的变成了逐行审查 AI 提交的 diff。Whiteboard 团队在 README.md 里把这一点说得很直白既然现在大家都有了专门的 agent 工具和桌面应用文本编辑器只剩审查这一核心职责might as well start off with the most successful open source editor out there as a baseline——用目前最成功的开源编辑器当基线。画布里的时序图、流程图、agent trace 引用都可以点击跳转到底层代码跳过去之后你得到的是 VS Code 原生的快捷键与 LSP 支持见 README.md 的 Why does this exist? 一节二、核心问题为什么整仓 vendor而不是打补丁绝大多数 VS Code 分叉采用上游 补丁集的维护方式。Whiteboard 反其道而行给出的理由有两条README.md 的 On vendoring Code OSS 一节编码代理处理补丁很难AI 在一堆 diff 补丁 跨文件上下文上工作时错误率更高把完整源码平铺在仓库里人和 agent 都能直接读、直接改。上游大量代码与审查场景无关团队估计目前 VS Code 代码库里约45% 与 Copilot 相关——一个专注代码审查的桌面端根本用不到它们。一句话总结vendor 整仓让代码树保持平的对 AI 友好也更容易删干净。三、这份 VS Code 分叉具体做了什么所有与上游的差异都必须登记在 UPSTREAM 中可以按三类来看3.1 锁定上游基线分叉固定在上游提交8a7abeba并打上序列化 tagcode-oss-upstream-8a7abebaUPSTREAM。刷新上游时只需对比tag 处的干净上游与当前代码树。3.2 大刀阔斧做减法类别内容vendor 时直接排除.github/、上游 CI 配置、extensions/copilot/约占 45% 代码库等裁剪 18 个内置扩展emmet、grunt、gulp、notebook 渲染、github-authentication 等审查场景用不到的扩展删除整个 Agents 窗口605 个上游文件——分叉从不打开该窗口却曾在每个打包构建里编译并分发它3.3 把 Review 的代码收进一个目录Whiteboard 自己的工作区代码统一放在 code-oss/src/vs/review/与上游代码物理隔离首次启动还会自动从本机的 VS Code 安装导入键位与用户设置见 apps/review-desktop/README.md 的 VS Code settings and keybindings 一节。扩展生态同样策展化固定扩展目录、没有 Marketplace每个 VSIX 的精确版本、目标平台、大小与 SHA-256 哈希都记录在 curated-extensions.manifest.mjs 中安装前逐一把关。四、如何持续跟上上游 VS Codevendoring 不等于一次性拷贝后躺平。团队的做法是定期监控上游、按 commit 精确 backport在 UPSTREAM 的 backport 清单里可以看到 Electron 42.10.0 升级、安全加固以及 2026 年 9 月 Microsoft 发布的十条安全通告中挑选应用的 4 个 CVE 修复——甚至逐条说明了为什么这条不适用 / 为什么这条决定不修每次上游刷新后tag..HEAD的差异必须完全可枚举每一个文件差异都要对应清单里的一条记录Serialize the fork 一节。这种纪律让分叉漂移始终处于可审计状态。五、许可证与隐私分叉也要守规矩Whiteboard 采用 MIT 协议vendored 的 Code OSS 保留微软 MIT 许可与第三方声明见 apps/review-desktop/LICENSE 与 UPSTREAM。应用只针对本地 checkout 运行匿名遥测不含代码、diff、提示词或模型输出详见 docs/privacy.md 与 docs/telemetry.md。六、三步本地跑起来 git clone https://gitcode.com/gh_mirrors/whiteboard36/whiteboard cd whiteboard pnpm install pnpm dev需要提前安装 Node.js 24 与 pnpm 11CONTRIBUTING.md 的 Setup 一节开发构建可以与已安装的 Whiteboard 并存。完整的构建、打包与发布流程见 apps/review-desktop/README.md。小结AI 时代分叉开源项目的四条启示选最强基线审查代码这件事Code OSS 是当之无愧的最佳起点对 AI 友好的代码组织整仓 vendor 优于补丁堆叠agent 可以直接读改源码差异可枚举每一份有意分歧都登记在案上游刷新永远可控做减法删掉约 45% 用不到的 Copilot 相关代码产品更轻、攻击面更小。延伸阅读产品理念与 vendoring 决策README.md桌面端构建与发布apps/review-desktop/README.mdAI 代理插件源码packages/agent-plugins/贡献指南CONTRIBUTING.md【免费下载链接】whiteboardopen-source canvas for thoughtful software design项目地址: https://gitcode.com/gh_mirrors/whiteboard36/whiteboard创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考