Plugin-Everything Architecture（一切皆插件）

Definition

“一切皆插件”（plugin-everything） 是 DeepSeek Harness 的架构主张：没有特权核心。模型适配器、工具注册表、会话日志、甚至 agent loop 本身都是插件，全部可从配置替换。你扩展 dsh 的方式 = 在别的插件旁边挂一个插件。

底层框架是 Cordis（vendored）。

服务占用稳定 ctx.<key>（ctx.tools、ctx.llm、ctx.sessions）。插件通过 key 找服务，不 import 具体实现 —— 运行时组合而非编译时耦合。

插件 inject: ['shell'] 声明所需服务，等服务存在后再加载。加载顺序由服务依赖表达，而非手动 boot 排布。

每个贡献（prompt 分段、工具 schema、适配器、监听器、provider）都通过 ctx.effect() / ctx.on() 安装；注册返回 disposer。插件卸载时一切可预测回滚 —— 没有”卸载残留”。

几乎所有可扩展 sum type 遵循一个模式：interface 按 discriminant tag 建 map（ThingMap），union 用 keyof 派生。插件通过 declare module 声明合并添加变体 —— 无需改拥有包：

// 插件扩展，不改 dsh-session 源码
declare module '@deepseek-ai/dsh-session' {
  interface SessionEventMap {
    'compaction/summary': { /* ... */ }
  }
}

6 个 canonical maps：ContentBlockMap、MessageSourceMap、FinishReasonMap、TurnTriggerMap、TurnEndReasonMap、SessionEventMap。

emit（观察）/ waterfall（中间件链，需 next()）/ parallel（并行）/ serial（按序）—— 见 cordis。

Profile：命名组合（Harness home 内），列出 bundle + 用户 cordis.patch.yml；web / headless 是模板
Bundle：Cordis config rows + 其代码的分发格式（dsh.profile 列 bundle，dsh.bundle 指向 patch 文件）
Patch 层序：profile bundles（按列序）→ profile patch → home-level patch → --patch overlay。patch 按 row id 替换整个 config 或插入新 row
dsh-base = 每个 profile 第一层（模型适配器、工具、持久化、sandbox/approval 政策、settings/credentials/telemetry）
验证：dsh --profile web --dump-config 打印实际启动的插件树；每行都可被你的 patch 替换

Scope（作用域）：per-agent 注册原语（createScope/scopeOf/scopeTarget），session/agent 的注册是 agent-local，disposal 时回滚
Agent Preset（ctx.agentPresets）：per-session agent 组合，从 preset cordis.yml 在 agent scope 下挂载
- 子 agent 通过 composeFrom 继承父的组合（bind 非 mount —— 拿到父的同一 generation，保证与父历史一致）
- isolate realm：preset 挂载的服务对 host 不可见（agent 私有服务）
- recompose 可在 agent 无产出时换 preset（有产出则禁止 —— 已记录的工具调用新组合做不了）

raw/articles/deepseek-harness-2026.md（docs/architecture.md、docs/cordis-primer.md、AGENTS.md）