前言 · Harness 拆解 · 豆包工作教程综合站

两条路线在 CH-11 汇合。

这本书讲什么

2026 年 8 月，字节跳动把豆包桌面客户端更名为"豆包工作"，在输入框左下角加了一个模式切换按钮。普通模式下它是聊天机器人，工作任务模式下它变成一个能操作电脑的 Agent——执行命令、读写文件、调用 MCP 服务器、操作浏览器、编排多个子 Agent、定时运行任务。

这本书拆解豆包工作的 Harness 设计。Harness 是把大模型固定在可执行环境中的支撑结构——运行环境、引导机制、能力扩展、反馈安全、编排迭代。我们用 ZJBB-003 拆解 WorkBuddy 时建立的五层框架，逐层分析豆包工作 2.25.18 版本的架构决策、实现机制和设计哲学。

豆包含 Harness 有七个关键事实：

它是"Chromium 壳 + 原生 Helper"的混合架构，不是 Electron。1MB 启动器拉起 977MB Chromium，6 个原生 Helper 处理命令执行、MCP 通信、沙箱和审计。
系统提示词运行时注入，本地不可见、不可改。身份和记忆都是服务端产品功能，不是本地文件。
103 个预装 Skill 遵循 Anthropic AgentSkills 规范，模型根据 frontmatter 自主拾取。在线技能商店提供 200+ 技能和连接器。
MCP 客户端用 Rust 编写（rmcp 3.0.0），支持 STDIO/HTTP+SSE/Streamable HTTP 三种传输和完整 OAuth 2.0，通过 FFI 与 Chromium 桥接。
macOS Seatbelt 内核级沙箱 + 审计 SDK + 虚拟钥匙串 + 父进程签名验证，构成 8 层纵深防御。
MainAgent/OrganizeAgent/SubAgent 三层编排是内置能力，hint 不跨层透传，文件系统是 Agent 间数据总线。
豆包工作是字节 Agent 全栈（AgentKit + DeerFlow + Coze + 豆包工作）的桌面终端，共享七组件 Harness 模型。

Agent 开发者和架构师：重点读 CH-02（运行环境）、CH-05（MCP）、CH-06（沙箱与安全）、CH-07（多 Agent）、CH-09（体系定位）。这五章工程密度最高。

AI 落地顾问、培训师和企业决策者：重点读 CH-01（导论）、CH-03（引导层）、CH-04（Skill 生态）、CH-08（任务模式）、CH-10（WorkBuddy 对照）、CH-11（启示与局限）。这六章帮助判断产品定位和适用场景。

两条路线在 CH-11 汇合。

本书的章节按"从外到内、从静态到动态"的顺序组织：CH-02 看外壳（进程和文件），CH-03 看启动（提示词和身份），CH-04/05 看扩展（Skill 和 MCP），CH-06 看安全（沙箱和审计），CH-07/08 看运行（编排和迭代），CH-09/10/11 看定位和启示。

每章开头有本章要回答的核心问题，结尾有架构判断。「推断」标记的结论表示基于间接证据的推理，不是直接观测到的事实。如果你时间有限，可以只读每章最后的"架构判断"部分，五分钟掌握全书核心观点。

技术框（代码块、表格、二进制符号）提供支撑细节，非技术读者可以跳过而不影响主线理解。

证据来自四条路线：

本地源码观测：对 DoubaoWork.app 进行文件结构分析、Info.plist/manifest.json 解析、Helper 二进制 strings 观测、103 个 Skill frontmatter 全量提取。未反编译。
运行时实测：在当前版本中实际使用工具调用、Skill 加载、多 Agent 编排、定时任务等功能。系统提示词原文受安全约束不引用，只描述模块结构。
官方文档：BytePlus AgentKit Harness 文档、豆包官方 FAQ 和下载页。
社区分析：CSDN/掘金技术文章、GitHub doubao-mcp-bridge、DeerFlow 2.0 开源评测。

关键结论以「官方」「源码」「实测」「社区」「推断」标记证据来源。推断 Claim 列出前提和反证搜索结果。

豆包工作是快速迭代产品，后续版本可能改变书中描述的机制。建议对照 CH-02 的版本检查方法确认变化。

大鹏主编｜智见 AI 出品

本书的方法论继承自 ZJBB-003《WorkBuddy Harness 设计拆解》。感谢 WorkBuddy 团队做出了一个引擎盖透明的 Agent，让五层框架第一次得到验证。

CHAPTER 01 · ZJBB-004