DeepSeek Harness 橙皮书：从开机到拆开,组件皆为插件的可拆装 Agent 脚手架

这份 10 月橙皮书（v261020）是第二轮完整重测，对应 0.2.1‑rc.2 新版本。产品已经新增桌面客户端，底层机制、插件生命周期、权限审批逻辑、计费峰谷规则都发生不小改动；旧文档里不少现象已经失效。

报告开篇就抛出一个很有意思的对照实验：8 月旧版本，Agent 现场生成的工具插件，软件一重启就直接消失；更新到 10 月新版本之后，可以输出完整插件包，经过人工审批之后可以永久保存。通过这个实验，引出 Harness 的核心定位：它不只是一个编码 Agent 应用，更是一套全部组件皆为插件的可拆装 Agent 脚手架。大模型只是其中一个零件，主循环、沙箱、日志、工具能力全都可以替换、关闭、重新组装。

全书分成四大块内容。

第一部分「进门」

面向普通使用者，讲从零开机的完整流程：桌面端、npx 命令两种启动方式，工作区沙箱三档权限设计，四种模式（标准 / PTC / 极简 / 创造模式）人话解读，以及从 Claude Code 迁移 skill、MCP 资产的兼容情况，把迁移时容易静默失效的坑点一一点明。

第二部分「主线实操」聚焦真实使用成本与任务执行

作者扒开会话原始日志，算出每轮任务真实 token 开销，拆解那笔容易被忽略的开机入场成本：每次会话启动，光工具说明书、技能目录就要消耗大量 token，真正用户提问占比反而很小。同时拆解长任务、子代理、定时任务的运行逻辑，对比 PTC 模式的收益与代价，破除 “PTC 一定更省 token” 的流行误区。

第三部分「地基」是全书硬核重点，讲底层架构

分清 Skill、MCP、插件三者的边界，用通俗类比讲清楚：Skill 是菜谱，MCP 是对外对接协议，插件才是改造 Harness 本体的零件。同时揭露插件冲突、静默加载失败这类 “不报错但功能失效” 的隐蔽 bug。书中还收录官方仓库四份真实线上事故复盘，即便单元测试 100% 全绿，上线依旧会崩溃，教会读者不要迷信测试覆盖率，要看真实运行轨迹日志。

第四部分做冷静的风险研判

客观点明产品尚处在预览阶段的现实约束,接口会破坏性变更、插件生态尚不成熟、部分文档滞后于代码、会话日志默认上传等现实取舍。