企业官网建设流程全解析

上一篇建立了痛点：模型交付 token，Agent 需要行为；这层壳每家都在写，但每家都把它焊死在自己产品里，于是没人能换、没人能审、没人能公平评测。

这一篇给出定义、划清边界、并把它放进生态里比较。读完你应该能判断：这东西跟我有没有关系。

缩写对照表

一、一句话定义

DeepSeek Harness（dsh）是一个开源的 Agent 运行外壳：它把"让模型在真实环境里持续工作"所需要的每一个部件——模型适配器、工具注册表、会话日志、审批与沙箱、乃至驱动循环本身——都实现成一个可以从配置里换掉的插件，运行在一个只负责挂载与依赖解析的微内核（Cordis）之上。

逐段拆：

官方仓库首页只有一句话概括：

“It uses an architecture whereeverything is a plugin, and is powered by Cordis.”

而docs/architecture.md把这句话说得更狠：

“Every part of the product is a plugin, includingthe model adapter, the tool registry, the session log, and the agent loop itself, so every part is replaceable from configuration.There is no privileged core to patch.”

二、两句设计信条，各换来什么

DSH 官网把设计原则压成两句：“Everything is a plugin. Every run is traceable.”

这不是两句并列的口号，而是两条各有代价、各有回报的工程决策。

信条一：Everything is a plugin（一切皆插件）

换来的：任何部件都能替换、并存、卸载。想让命令跑在远程沙箱？换一个 provider 行。想试一个新的循环策略？写一个新的 driver 挂上去。想给某类会话一套完全不同的工具？写一个 preset。

代价：配置成为一等公民。你必须理解插件树是怎么叠出来的，才能理解"我这个环境里到底跑着什么"。这也是为什么第 5 篇会说dsh --dump-config是这个项目最该先跑的命令。

信条二：Every run is traceable（每次运行都可追溯）

官方的说法是：

“Everything the model sees is recorded in anappend-only session log: system prompts, reasoning, tool calls and results, subagent scheduling, and every context injection.”
（模型看见的一切都记录在一条只追加的会话日志里：系统提示、推理过程、工具调用与结果、子代理调度，以及每一次上下文注入。）

换来的：重放、复盘、评测、fork（从历史某点分叉出一条新会话）、崩溃恢复——全部是同一个机制的自然结果。

代价：一条硬约束——模型可见即已记录（model-visible means logged）。任何东西想进入模型请求，必须先成为一条日志事件；仓库里甚至有一条运行时不变量在断言这件事。这条约束会反过来塑造每一个想给模型加信息的插件的写法（见第 6 篇）。

三、它不是什么

边界比定义更能防止误用。DSH不是下面这些东西：

还有一条特别容易误解的：它不是"DeepSeek 模型专用"。适配器是接缝，仓库里同时存在直连 DeepSeek 的适配器和一个库支撑的通用适配器（llm-pi-ai），并且 Web UI 的 Settings → Models 里可以配置自定义 OpenAI 兼容端点。

四、生态位置

同层邻居怎么比：

五、四个 preset：同一个壳的四种脸

DSH 出厂带四套agent preset（会话级的插件组合，第 5 篇细讲）。它们最能说明"一切皆插件"意味着什么——四个 preset 就是四份 YAML，跑在同一个循环上：

minimal这个 preset 是第 01 篇"第三堵墙"的直接答案：它的人格段落只有一句You are a helpful software engineer assistant.，并且标了complete: true（独占整个系统提示）、includeRuntimeContext: false（连运行时上下文都不注入）。变量被按死了，剩下的差异就是模型本身。

code模式则值得单独说一句：PTC = Programmatic Tool Calling（程序化工具调用）。常规模式下模型每调一个工具就要一次往返；PTC 模式下模型写一段程序，把"读三个文件、筛一遍、改其中两个"写成一段 TypeScript，由run_code一次执行完。官方注释里写得很直白：“a sequence that would be five round trips becomes one”（本来五次往返，变成一次）。

六、怎么判断"跟我有没有关系"

⚓ 回到示例

有了定义，可以给运行示例定位了：

“读一下 package.json，给 README 补一个 Quick Start 小节，然后跑一次pnpm lint确认没问题。”

这句话跑在webprofile（启动层组合）+standardpreset（会话层组合）上。它至少会碰到四个可替换的接缝：模型（DeepSeek 适配器）、文件（ctx.fs）、命令（ctx.shell+ctx.sandbox）、审批（ctx.approval）。

四个都换掉，示例仍然能跑——这就是"一切皆插件"在这个例子上的具体含义。第 11 篇会把这四个接缝逐个拆开。

上一篇← 01 · 为什么需要 harness
下一篇→ 03 · 概念地图：八个概念、八个角色、一个运行示例
回到→ 系列索引