框架与成品：一场关于智能体 harness 的星图测绘

星图测绘的乐趣，在于让两颗亮度悬殊的恒星在同一张图上显影——亮度从来不是距离的唯一量纲。

一、两条开源路线

deepseek-harness（dsh）与 ZCode，同为 2026 年 8-9 月相继开源的中国 AI 实验室出品的 agent harness，却走出两条截然不同的路。dsh 是 DeepSeek 的”开发者预览版”：2026-08-13 开仓，MIT 协议，TypeScript 约 51.5MB，60+ 个 packages，24.5 万 star、2.9 万 fork、42 位贡献者——创建约七周，很可能是有史以来最快的星标爆发。ZCode 是 Z.ai 的编程智能体工作台：2026-09-20 开仓，Apache-2.0，TypeScript 约 34.6MB，14 个 packages，v3.14.3 正式版，7.5k star——而它的 GitHub 仓库实质是发布镜像（2 位贡献者、单一 release、PR 仅限协作者），真实开发在内部进行，看社区数据会严重低估其工程体量。

二、架构哲学：组合树对分层治理

差异的最大处是哲学。dsh 的运行时是一棵启动时按 profile 组装的插件树：dsh-base 提供模型适配器、工具注册表、持久化、沙箱与审批、凭据、遥测，随后依次叠加 bundle、profile patch、home patch、--patch 覆盖层；底层是 DeepSeek 自家的 Cordis 框架，插件向共享上下文贡献服务、类型化事件与可逆副作用。它的口号近乎宣言——“模型适配器、工具注册表、会话日志、Agent 循环本身都是插件，不存在特权的核心。” 会话日志是 append-only 的 SessionEvent，上下文由 deriveMessages() 重建；模型层是 ctx.llm 接缝，换 provider 即换整个产品。它甚至允许 Agent 在对话中为自己造插件（官网演示过对话生成番茄时钟悬浮插件），并实验性加入 Claude Code Mods 兼容层。

ZCode 走的是相反的路：规范优先的分层 monorepo——14 个包各司其职，.architecture-baseline.json 基线、architecture-policy.yaml、pnpm architecture:check --changed、单一状态所有者原则、桌面端经 stdio + zcode-protocol 与 Agent 进程通信、CommandInbox 串行准入，区分实时链路与可恢复链路。这是”用工程纪律保证大团队协作”的路线，与 dsh 的”用组合性消灭核心”恰成对偶。

三、安全观与生态位

安全取向上，dsh 防的是”Agent 做危险的事”（独立 guard/sandbox/credentials/identity 包，Web UI 主动征求同意，SAFETY.md 放在最显眼处）；ZCode 防的是”服务被未授权访问”（token 鉴权、远程配对与心跳、日志脱敏、CDN 资源 sha256 校验）。生态位上，一句话可以定格：dsh 的插件是架构概念，ZCode 的插件是分发渠道——前者打 dsh-plugin topic 获得曝光，后者有完整的官方市场（内置种子 + sha256 校验的 CDN 按需下载 + 个人来源，生命周期覆盖安装到卸载，精选名单由官方 CDN 远程控制）。

四、结论

测绘的最终判词冷静而公正：dsh 是插件化 Agent 框架（开发者预览），ZCode 是编程智能体成品（成熟产品），两者并非同一成熟度的竞品，更多是”框架”与”成品”的对比。前者的杀手锏是 everything-is-a-plugin 与 Cordis 组合树，适合想自建或魔改 Agent 运行时的开发者，代价是破坏性变更与预览期不稳定；后者的杀手锏是三端一致的产品体验、插件市场、远程开发与架构治理，适合开箱即用的用户与团队。用 dsh 的社区数据衡量 ZCode，或用 ZCode 的产品完成度苛求 dsh，都是拿错了尺子。

真实坐标

• dsh：DeepSeek，2026-08-13 开仓，MIT，TS 约 51.5MB，60+ packages，24.5 万 star/2.9 万 fork/42 贡献者，v0.2.1-alpha.1，Requests 参数仅 temperature/maxTokens/stop，llm-retry 独立包负责重试；官方适配线 dsh-llm-deepseek + dsh-llm-pi-ai；测试/基准狂魔（6 套 vitest 配置 + benchmarks/snapshots + jscpd）
• ZCode：Z.ai，2026-09-20 开仓，Apache-2.0，TS 约 34.6MB，14 packages（含 formal-proof、zcode-cua），v3.14.3（2026-09-24），7.5k star/2284 fork，2 位公开贡献者（发布镜像）；provider 可配置面（ZCODE_BUILTIN_PROVIDER_CONFIG_FILE + 远端 default.json + model-option-map）
• 哲学对偶：Cordis 组合树（一切皆插件、无特权核心）对 分层 monorepo（架构基线 + spec 先行 + 依赖边界检查）
• 安全对偶：dsh 防 Agent 作恶（guard/sandbox + SAFETY.md）对 ZCode 防服务被未授权访问（token/配对/脱敏/sha256）
• 生态对偶：插件＝架构概念（topic 曝光 + 对话造插件 + Claude Code Mods 兼容）对 插件＝分发渠道（官方市场 + CDN zip + 完整生命周期）
• 判词：框架与成品，非同一成熟度竞品；星标数不是工程体量的唯一量纲