DeepSeek Harness — 内置插件完整能力分类整理

分析对象：packages/ 下全部 @deepseek-ai/dsh-* 插件。 统计口径：直接扫描每个包的 package.json（name / description 字段）+ 分组级 README.md，逐包核对，无遗漏。结论：共 50 个能力分组、226 个插件包。核心理念：everything is a plugin。整个 harness 建立在 vendored Cordis 之上，每个能力都以插件形式通过 ctx.effect() / ctx.on() / ctx.waterfall() 贡献。架构范式：能力分离（capability seam）——同一能力族通常拆成「服务定义（Service Definition）/ 具体提供方（Provider）/ 消费方/工具（Consumer）」三层，互不耦合、可独立替换。

0. 总览：50 个分组 / 226 个包

#	能力域	主要分组	插件数
1	核心控制	`core`	8
2	大模型（LLM）	`llm`	5
3	执行与进程	`shell` `subprocess` `terminal` `code-runtime` `sandbox` `e2b`	24
4	文件系统与附件	`fs` `attachment` `spill`	12
5	代码智能（LSP）	`lsp`	3
6	网络检索	`web`	6
7	技能（Skill）	`skill`	4
8	多智能体协作	`subagent` `experimental`	13
9	任务编排与记忆辅助	`workflow` `goal` `schedule` `todo` `plan` `jobs`	14
10	会话与上下文检索	`session` `session-query` `compaction`	21
11	人机协作面	`interaction` `feedback` `context`	13
12	安全护栏与扩展钩子	`guard` `hooks`	5
13	配置 / 凭证 / 存储 / 工作区 / 身份	`settings` `credentials` `storage` `workspace` `identity`	10
14	GUI 主机与浏览器端	`host` `client` `api` `typert`	54
15	自动化与跨进程协议	`acp` `sdk`	4
16	运行时自修改与互操作	`extensions` `mcp`	5
17	启动 / 组合 / 预设	`boot` `bundle` `preset`	7
18	工具库与测试支持	`util` `test-support` `examples`	16
19	运行时诊断	`runtime-diagnostics`	1
	合计	50 组	226

1. 核心控制（`core/`，8）

会话日志、系统提示装配、工具注册表、Agent 契约与默认循环——harness 默认控制流的稳定表面。

插件	能力	ctx key
`scope`	作用域上下文注册原语（scope 标签、scope 过滤的事件派发）	—（库）
`session`	事件溯源（event-sourced）会话存储	`ctx.sessions`
`system-prompt`	系统提示词与工具 schema 装配注册表	`ctx.systemPrompt`
`tools`	工具注册表与执行管道	`ctx.tools`
`agent`	Agent 接口、注册表、发起者作用域、事件词汇	`ctx.agents`
`agent-default-model`	Agent 入口共享的默认模型选择（会话未单独选择时生效）	`ctx.agentDefaultModel`
`agent-loop`	具体的 Agent 驱动循环实现（可被替换）	`ctx.agentLoop`
`agent-tool-presentation`	Agent 平面呈现选择器：将某 Agent 的工具组合为 Code Mode / native / both	—

2. 大模型能力（`llm/`，5）

LLM 服务接缝 + 流式词汇 + 多提供方适配器。所有包均为 product 级。

插件	能力	ctx key
`llm`	提供方中立的 LLM 服务接口（抽象服务、内容块词汇、流式分块组装器）	`ctx.llm`
`token-meter`	可重放的 token 计量服务	`ctx.tokenMeter`
`llm-retry`	提供方路由的 LLM 请求重试策略	—
`llm-deepseek`	DeepSeek chat-completions 适配器	—
`llm-pi-ai`	pi-ai 支撑的 DeepSeek 适配器（llm-deepseek 的设计验证孪生实现）	—

3. 执行与进程（shell / subprocess / terminal / code-runtime / sandbox / e2b）

3.1 Shell（`shell/`，10）

插件	能力	ctx key / 工具
`shell`	抽象 bash 执行器接缝（Service Provider 与 Consumer 共享）	`ctx.shell`
`bash-local`	经 `subprocess` 执行本地 bash	注册 `ctx.shell`
`bash-sandbox`	消费沙箱的执行器（每命令经 `ctx.sandbox` 围栏，回报拒绝/执行结果事实）	注册 `ctx.shell`
`pwsh-local`	本地 PowerShell 执行器	注册 `ctx.shell`
`pwsh-sandbox`	沙箱化 PowerShell 执行器	注册 `ctx.shell`
`shell-env`	工具无关的受管 `DSH_*` 环境变量注册表	`ctx.shellEnv`
`tool-bash`	模型可调用 bash 工具（可选通用后台任务 + 沙箱升级支持）	`bash`
`tool-bash-persistent`	模型可调用 owner 作用域持久 Bash 工具（由 Harness PTY 服务支撑）	`bash`（持久形态）
`tool-pwsh`	模型可调用 pwsh 工具	`pwsh`
`tool-pwsh-persistent`	模型可调用 owner 作用域持久 PowerShell 工具	`pwsh`（持久形态）

3.2 子进程（`subprocess/`，2）

插件	能力	ctx key
`subprocess`	子进程接缝：托管进程组、有界 spill 支撑的输出、升级 kill，统一在一抽象服务后	`ctx.subprocess`
`subprocess-local`	本地子进程实现	注册 `ctx.subprocess`

3.3 持久终端（`terminal/`，3）— PTY 伪终端

插件	能力	ctx key / 工具
`terminal`	持久 PTY 会话接缝：owner 作用域 id、后端注册表、交互式发送/读取/信号/等待清理	`ctx.terminals`
`terminal-bash`	基于 `ctx.subprocess` 终端原语的持久 shell PTY 后端	注册 `ctx.terminals`
`tool-terminal`	6 个模型工具 + 通用后台任务集成（owner 隔离）	`terminal_open/close/read/send/list/signal`

3.4 代码执行（`code-runtime/`，3）

插件	能力	ctx key / 工具
`code-runtime`	抽象代码执行接缝：执行模型编写的程序、捕获 stdout/返回	`ctx.codeRuntime`
`code-runtime-worker-thread`	Worker-thread 后端（隔离于宿主事件循环，非安全边界）	注册 `ctx.codeRuntime`
`code-runtime-python`	CPython 子进程实现（独立于 worker-thread 的真实 Python 运行时后端）	注册 `ctx.codeRuntime`
→ 消费方	工具注册表 Code Mode Consumer（`tools: { mode: code }`）	`run_code`

3.5 进程沙箱（`sandbox/`，4）

插件	能力	ctx key
`sandbox`	进程沙箱接缝 + 同世界隔离词汇 + `SandboxProvider` 契约	`ctx.sandbox`
`sandbox-local`	本地平台隔离后端（bwrap / npm 分发的 landlock-run / macOS Seatbelt / Windows 受限令牌），功能探测、fail-closed	注册 `ctx.sandbox`
`sandbox-windows-acl`	Windows ACL 写限制沙箱后端（受限令牌 spawn + 能力 SID 写白名单）	注册 `ctx.sandbox`
`sandbox-policy`	每调用沙箱策略解析器 + 当前模型上下文（部署回退 + 每会话模式与工作区根），被各强制能力族共享	`ctx.sandboxPolicy`

3.6 远程执行世界（`e2b/`，3，POC）

插件	能力	ctx key
`e2b`	共享 E2B 沙箱生命周期（创建/销毁、准备工/运行时目录、共享 SDK 句柄）	`ctx.e2b`
`fs-e2b`	在 E2B Filesystem API 上实现 FS 接缝	`ctx.fs`
`subprocess-e2b`	在 E2B Commands/PTY 上实现子进程接缝	`ctx.subprocess`

4. 文件系统与附件（fs / attachment / spill）

4.1 文件系统（`fs/`，7）

插件	能力	ctx key / 工具
`fs`	服务定义：规范路径/文件 URI/包含关系、文本 IO、原子变更原语，拥有 `fs/*` 策略事件	`ctx.fs`
`fs-local`	本地文件系统实现	注册 `ctx.fs`
`fs-sandbox`	沙箱执行 FS：按调用模式 + 工作区根策略围栏写/编辑（只读拒改、workspace-write 限制到工作区+临时根），读放行	注册 `ctx.fs`
`fs-observation-policy`	文件上下文策略：observed-state + read-before-edit + 版本守卫（仅经 `fs/*` 事件门参与）	—
`tool-fs`	模型工具 `read` `write` `edit`（读窗口化、派发 `fs/*`）	注册 `ctx.tools`
`tool-fs-search`	`glob` `grep` 发现工具（打包 `@vscode/ripgrep` 经 `ctx.subprocess` 启动）	注册 `ctx.tools`
`tool-str-replace-editor`	`str_replace_editor`：查看/创建/字面替换/行插入	注册 `ctx.tools`

4.2 附件（`attachment/`，2）

插件	能力	ctx key
`attachment`	不可变附件存储接缝：引用、图片限制、存储服务；字节仅在用户提交或适配器提交模型输出时入库	`ctx.attachments`
`attachment-local`	`DSH_HOME` 下的内容寻址私有存储	注册 `ctx.attachments`

4.3 工具输出溢出（`spill/`，3）— 超限输出落盘

插件	能力	ctx key
`spill`	溢出存储接缝：保存超大工具文本并返回检索定位符	`ctx.spillStore`
`spill-local`	会话作用域本地文件存储（私有）	注册 `ctx.spillStore`
`spill-policy`	工具结果溢出策略：以有界预览 + 落盘路径替换内联超大纯文本（监听 `ctx.tools`，无服务 API）	—

5. 代码智能（`lsp/`，3）

插件	能力	ctx key / 工具
`lsp`	服务定义：按品牌 id + 扩展名映射注册提供方、每查询选择、词汇、`LspError`	`ctx.lsp`
`lsp-stdio`	通用多服务 stdio 后端（JSON-RPC、每查询瞬时打开文档）	注册 `ctx.lsp`
`tool-lsp`	模型工具 `lsp`：单一只读工具，仅 4 个语义操作 `goToDefinition` `findReferences` `goToImplementation` `hover`（UTF-16 坐标，无通用 JSON-RPC 逃逸口）	注册 `ctx.tools`

6. 网络检索（`web/`，6）

插件	能力	ctx key / 工具
`web`	提供方注册、选择、共享错误（`WebError` 分类）	`ctx.web`
`web-search-exa`	经 Exa 搜索	注册 `ctx.web`
`web-search-perplexity`	经 Perplexity 搜索	注册 `ctx.web`
`web-search-deepseek`	DeepSeek 原生搜索（经 Anthropic 兼容 API）	注册 `ctx.web`
`web-fetch-http`	匿名抓取公开 HTTP/HTTPS 资源	注册 `ctx.web`
`tool-web`	模型工具 `web_search` `web_fetch`	注册 `ctx.tools`

7. 技能（`skill/`，4）

插件	能力	ctx key / 工具
`skill`	技能提供方注册与查找	`ctx.skills`
`skill-badge`	内置 dsh badge 技能提供方	注册 `ctx.skills`
`skill-filesystem`	从本地文件系统发现技能	注册 `ctx.skills`
`tool-skill`	模型工具 `skill`：发布技能目录 + 加载器	注册 `ctx.tools`

8. 多智能体协作（`subagent/` 11 + `experimental/` 2）

8.1 子智能体（`subagent/`，11）

插件	能力	ctx key
`subagent`	抽象子智能体接缝：命名提供方注册表，用于委派给子 Agent	`ctx.subagents`
`subagent-in-process-driver`	共享的进程内运行驱动（被 spawn / fork 后端复用，驱动 `ctx.agents` 上的子 Agent）	—
`subagent-spawn-in-process`	进程内 spawn 后端：运行全新子 Agent	注册 `ctx.subagents`
`subagent-fork-in-process`	进程内 fork 后端：以父 Agent 日志前缀为种子运行子 Agent	注册 `ctx.subagents`
`subagent-acp`	进程外 ACP 子 Agent 后端：经 Agent Client Protocol 在 spawn 的子进程中驱动子 Agent	注册 `ctx.subagents`
`subagent-codex`	一次性 Codex 子 Agent 提供方（官方 app-server 协议）	注册 `ctx.subagents`
`subagent-claude-code`	一次性 Claude Code 子 Agent 提供方（官方 Agent SDK）	注册 `ctx.subagents`
`subagent-dsh-sdk`	进程外 SDK 子 Agent 后端：经 stdio JSON-RPC 用 TypeScript SDK 客户端驱动子 Harness 运行时	注册 `ctx.subagents`
`tool-subagent`	模型委派工具（spawn_teammate 等）	注册 `ctx.tools`
`tool-subagent-control`	全局命名工具 `send_message` `interrupt_agent` `list_agents`（基于子 Agent 续接）	注册 `ctx.tools`
`tool-subagent-report`	子→父报告通道（子作用域注册）	子作用域注册

8.2 实验性 Agent Teams（`experimental/`，2，未发布）

插件	能力	ctx key / 工具
`agent-team`	隐式根 Agent Teams 名册、持久化对等邮箱、共享任务 DAG	`ctx.agentTeams`
`tool-agent-team`	作用域化模型工具：`spawn_teammate` `team_task_create/get/list/update`（基于 `ctx.agentTeams`）	注册 `ctx.tools`

9. 任务编排与记忆辅助（workflow / goal / schedule / todo / plan / jobs）

9.1 动态工作流（`workflow/`，4）

插件	能力	ctx key / 工具
`workflow`	工作流能力接缝：`ctx.workflowEngine` 服务、运行词汇、`workflow/*` 事件	`ctx.workflowEngine`
`workflow-worker-thread`	Worker-thread 引擎：在宿主事件循环外执行模型编写编排脚本，将 `agent()` 调用桥接回 `ctx.subagents`	注册 `ctx.workflowEngine`
`tool-workflow`	模型工具 `workflow`：在 `ctx.workflowEngine` 上运行 JS 编排脚本	注册 `ctx.tools`
`tool-ralph`	模型工具 `ralph`：基于 workflow + subagent 接缝的「全新 Agent」Ralph loop	注册 `ctx.tools`

9.2 目标（`goal/`，4）

插件	能力	工具
`goal`	事件溯源的同会话目标状态与生命周期服务	`ctx.goals`
`goal-round-driver`	竞态围栏的同会话目标回合驱动	—
`tool-goal`	模型工具 `create_goal` `get_goal` `update_goal`（带执行期权限校验）	注册 `ctx.tools`
`command-goal`	人类侧目标命令	—

9.3 会话内提醒（`schedule/`，1）

插件	能力	工具
`schedule`	Agent 作用域、持久化的 after / at / fixed-rate 提醒，存于会话事件日志	`schedule_create/delete/list`

9.4 待办（`todo/`，1）

插件	能力	工具
`tool-todo`	模型工具 `todo_write`（会话级待办列表，单一 Agent 会话拥有，无可替换提供方）	注册 `ctx.tools`

9.5 计划模式（`plan/`，1）

插件	能力	ctx key
`plan-mode`	按 Agent 记录的模式：部署引导、直接斜杠命令、用户审阅的退出（非通用模式注册表）	`ctx.planMode`

9.6 后台任务（`jobs/`，3）

插件	能力	ctx key / 工具
`jobs`	后台任务注册表与生命周期契约（共享 id、owner 隔离、轮询、取消、完成监听）	`ctx.jobs`
`jobs-local`	进程内任务注册表实现	注册 `ctx.jobs`
`tool-jobs`	模型工具 `job_kill` `job_list` `job_output`（观察/取消/等待/完成通知）	注册 `ctx.tools`

10. 会话与上下文检索（session / session-query / compaction）

10.1 会话持久化（`session/`，13）

插件	能力	ctx key
`session-persistence`	抽象持久化接缝 + 写协调	`ctx.sessionPersistence`
`session-checkpoint-policy`	语义化持久检查点（在模型请求前与工具副作用前落盘）	—
`session-persistence-jsonl`	JSONL 文件持久化后端	注册 `ctx.sessionPersistence`
`session-persistence-sqlite`	可选 SQLite 后端（物理 chunk 行打包）	注册 `ctx.sessionPersistence`
`session-projection`	投影接缝：可合并扩展的投影类型表、提供方契约、`ctx.sessionProjections` 注册表（提供日志派生的每会话当前值）	`ctx.sessionProjections`
`session-projection-cache`	持久化投影缓存（节流写回 + 冷读阶梯：缓存行 + 持久化尾部重放）	`ctx.sessionProjectionCache`
`session-stats`	全日志对话计数与墙钟时间投影	注册 `ctx.sessionProjections`
`session-title`	日志支撑的会话标题服务 + 提供方注册表	`ctx.sessionTitle`
`session-title-llm`	共享的 LLM 标题生成策略（被下述提供方共用）	—
`session-title-first-prompt-llm`	从首条人类消息生成标题	注册 `ctx.sessionTitle`
`session-title-all-prompts-llm`	从全部人类消息生成标题	注册 `ctx.sessionTitle`
`session-telemetry`	会话遥测后端接缝：事件捕获、投影、脱敏、交递给上报后端	`ctx.sessionTelemetry`
`session-telemetry-otel`	经 OpenTelemetry JS SDK 日志管线交递（`FULL`/`FEEDBACK_ONLY`/`DISABLED`）	—

10.2 会话检索（`session-query/`，4）

插件	能力	ctx key / 工具
`session-query`	可信读取、关系查询、搜索操作契约	`ctx.sessionQuery`
`session-query-sqlite`	具体后端（SQLite FTS5 全文检索）	`ctx.sessionQuery`
`session-log-export`	Web 会话日志导出命令 + 共享下载对话框	`ctx.sessionLogDownload`
`tool-session-query`	模型工具 `session_event_read` `session_event_search` `session_event_trace` `session_search` `session_trace`（工作区授权）	注册 `ctx.tools`

10.3 压缩（`compaction/`，4）

插件	能力	ctx key
`compaction`	压缩接缝 + 事件词汇	`ctx.compaction`
`compaction-basic`	token 计量驱动的压缩策略 + LLM 摘要后端	注册 `ctx.compaction`
`compaction-tool-result-pruner`	重放安全的无模型工具结果剪枝（头部/中部/尾部）	`ctx.toolResultPruner`
`command-compact`	人类侧显式压缩斜杠命令	注册 `ctx.commands`

11. 人机协作面（interaction / feedback / context）

11.1 交互（`interaction/`，5）

插件	能力	ctx key / 工具
`commands`	插件拥有的命令注册表（供 UI 使用）	`ctx.commands`
`user-approval`	一次性审批决策协调（fail-closed 默认）	`ctx.approval`
`permission-presets`	面向用户的权限预设呈现与持久化（一个产品级 Permissions 选择，捆绑沙箱模式与审批策略旋钮）	`ctx.permissionPresets`
`user-questions`	提供方中立的人机问答接缝	`ctx.userQuestions`
`tool-ask-user`	模型工具 `ask_user_question`（基于 `ctx.userQuestions`）	注册 `ctx.tools`

11.2 反馈（`feedback/`，2）

插件	能力
`command-feedback`	仅入日志的会话反馈生产者 + 人类 `/feedback` 斜杠命令（不入模型上下文）
`message-feedback`	绑定生命周期的逐条消息评分/备注侧车（存于 storage-domain，不触发遥测交递）

11.3 请求上下文（`context/`，6，向模型注入可见上下文，不定义工具）

插件	能力	ctx key
`session-reference`	跨会话快照引用 + 持久化不可信模型上下文	`ctx.sessionReferenceResolver`
`file-reference`	文件引用发现接缝 + `@file` 语法	`ctx.fileReferences`
`file-reference-local`	本地文件系统文件引用提供方（有界模糊索引）	—
`time-context`	可选持久化每步上下文（当前时间 + 已用时间）	—
`tmux-context`	可选持久化每步上下文（当前 Agent 的 tmux 面板/窗口位置）	—
`agent-instructions`	工作区指令上下文加载器（AGENTS.md / CLAUDE.md；默认 spine 含，可经 bundle 禁用）	—

12. 安全护栏与扩展钩子（guard / hooks）

插件	能力	ctx key
`guard/repeat-tool-reminder`	重复工具调用告警提示（经 `tools/post-execute` 的 `additionalContexts` 注入）	监听工具/agent 事件
`guard/timeout-policy`	工具调用超时策略：`tools/execute` 包装，为每次调用武装截止时间，赢则返回 `TOOL_TIMEOUT`	注册 `tools/execute` 监听
`hooks/hook-protocol`	共享 Claude Code / Codex hook 线协议：匹配引擎、stdin/退出码/stdout 编解码、多 hook 合并、`hook/*` 会话事件	库
`hooks/hooks-claude-code`	Claude Code hook 桥（翻译外部 hooks.json / settings hook 配置到 harness 拦截扩展点）	插件
`hooks/hooks-codex`	Codex hook 桥	插件

13. 配置 / 凭证 / 存储 / 工作区 / 身份

插件	能力	ctx key
`settings`	命名空间注册、分层解析、提交	`ctx.settings`
`settings-file`	文件支撑的设置提供方（settings.yaml），并观察外部编辑	注册 `ctx.settings`
`credentials`	凭证引用接缝（配置携带引用而非密值，提供方拥有值）	`ctx.credentials`
`credentials-local`	文件支撑的凭证提供方（`$DSH_HOME/.env` + 实时进程环境）	注册 `ctx.credentials`
`storage`	存储枢纽：命名后端注册表 + 挂载的数据表单设施	`ctx.storage`
`storage-json`	JSON 文件 KV 存储后端	注册 `json` 后端
`storage-sqlite`	SQLite 存储后端（kv facet）	注册 `sqlite` 后端
`storage-domain`	领域数据表单：schema 校验、事件发射的 KV 领域（覆盖存储后端）	`ctx.storageDomain`
`workspace`	工作区实体注册表：带校验会话归属的持久化工作区记录（领域数据表单上）	`ctx.workspaceRegistry`
`identity/anonymous-user-id`	共享匿名用户身份（遥测/反馈/DeepSeek 请求关联，不代表认证账户）	—

14. GUI 主机与浏览器端（host / client / api / typert）

14.1 主机端（`host/`，8）

插件	能力	ctx key
`apiproxy`	API 网关：`ApiProxy` 契约（api/）、fetch 载体对（fetch/）、提供 `ctx.apiProxy` 的主机侧网关插件	`ctx.apiProxy`
`webserver`	路由注册插件：HTTP 与 upgrade 路由、index 变换 tap、静态 dist 回退（不含 harness 概念）	`ctx.webServer`
`frontend-static`	Web 壳的 SPA dist 服务：拥有 webserver 回退位，注入 index-tap、拒绝目录穿越、SPA index 回退	消费 `ctx.webServer`
`directory-picker`	抽象工作区目录选择接缝	`ctx.directoryPicker`
`directory-picker-native`	原生 OS 选择器后端	注册 `ctx.directoryPicker`
`directory-picker-browse`	应用内浏览后端（列/建原语）	注册 `ctx.directoryPicker`
`directory-picker-auto`	自适应选择器：启动时解析主机情境，挂载 native 或 browse 后端	挂载后端
`plugin-inventory`	当前 Cordis Loader 插件状态的只读 Remote 投影	Remote `pluginInventory/list`

14.2 远程 API（`api/`，2）

插件	能力	ctx key
`remotes`	主机 Agent/Session 查找策略 + 客户端 Remote 贡献装配	配置 `ctx.typert`、消费 `ctx.remote`
`gateway`	主机 Typert 派发器 + 客户端 Remote 端点	`ctx.typertGateway` / `ctx.remote`

14.3 Typert 运行时反射（`typert/`，4）

插件	能力	ctx key
`registry`	运行时包反射与 schema 存储	`ctx.typert`
`loader`	发现 Loader 条目并注册生成的主机产物	消费 `ctx.loader`/`ctx.typert`
`generator`	从源类型生成运行时产物（构建期库）	—
`protocol`	编译器无关的 Remote 元数据 + Typert 提供方协议	—

14.4 浏览器端（`client/`，40）

壳层启动、主机 RPC 通信、共享 UI 服务、特性插件。

基础设施（6）

插件	能力
`web`	Web 启动内核：静态模块表、Cordis loader、无框架启动页、UI-renderer 交接
`connection`	线消费层：HTTP-up/WebSocket-down 客户端、ConnectionController 双流重连、fixture api
`runtime`	客户端核心服务：SlotRegistry、SessionRuntime（作用域树 + 对象层）
`modules`	客户端模块系统（双面体）：node 半组合 `__DSH_BOOT__` 入口图；browser 半是 vendored Loader 消费的惰性 CJS 模块表
`locale`	区域插件：主机支撑的 zh/en 偏好、浏览器派生回退、区域快照、类型化命名空间字典
`hmr`	仅开发的脚本加载客户端入口热重载驱动（SSE 重建帧 → 失效/预取 → fiber 交换）

槽 / 渲染 / 主题（5）

插件	能力
`ui-slots`	槽注册表纯核心：SlotMap 声明合并、单一注册组合 API、四共享 props 类型、store-seat 类型、renderer 安装接缝
`ui-renderer`	浏览器 UI 渲染器：React 槽绑定、`ctx.uiRenderer`、组装的应用根
`ui-layout`	壳插件：三栏 AppFrame + 拖拽手柄、`ctx.layout` 查看态服务（导航 + 面板）
`ui-theme`	主题插件：预插件调色板的主机引导；无 DOM 的 light/dark/system `ThemeRuntime`；`--dsw-*` token 样式与外观设置行
`ui-primitives`	纯 React 原子组件：控件、图标、markdown、JSON 检视器（零 cordis）

领域特性插件（29）

插件	能力
`ui-sidebar`	侧边栏：会话多级树、搜索、分组、状态点
`ui-conversation`	会话域：骨架、有序聊天流、带主机 busy-Enter 偏好的 composer、详情宿主
`ui-input-trigger`	输入触发管线：`/` 与 `@` 检测、候选菜单、pick 路由到已注册源
`ui-commands`	客户端命令面：全局目录缓存、`/` 源、三种命令 UI 种类、popupSelect 注册表
`ui-tool`	客户端工具调用树渲染器 + 每工具 keyed 呈现槽
`ui-trajectory`	轨迹事件账本 + 交互式时序概览（纯消费插件，注册进会话 ViewMap，无服务）
`ui-message-feedback`	助手消息动作条上的逐条反馈控件（基于 messageFeedback Host Remote）
`ui-user-questions`	Web `ask_user_question` 特性：主机工具挂载 + composer 接管式问题 UI
`ui-plan`	计划模式 composer 控制：plan 投影上的 conversation.input.plan 座位 + `/plan` 命令通道
`ui-goal`	会话目标面：停靠在 composer 上方的 GoalBar（读自目标会话投影）
`ui-jobs`	会话头部的后台任务列表：从 session/jobs 帧镜像的实时注册表状态
`ui-workflow-run`	持久化工作流运行 Conversation Node + 嵌套成员披露
`ui-deliverables`	产出文件轮尾 + 可点击的最终回复文件引用
`ui-attachment`	会话输入与消息图片槽的动态附件呈现插件
`ui-reference`	统一 Web `@file` 与 `@session` 引用源
`ui-skill`	Web 技能引用 + 专用技能工具行
`ui-subagent`	子 Agent 会话目录、续接路由 UI、`@` 引用源
`ui-agent-preset`	Agent-preset 面：后续会话默认、本会话座位、组合编辑器
`ui-model-selection`	模型选择：`/model` popupSelect（基于 session.models / session.selectModel）
`ui-permission-presets`	权限面：General 设置中的新会话默认 + 当前会话 `/permission` popup
`ui-workspace`	工作区选择器：注册进侧边栏的 WorkspacePicker + 空态工作区槽
`ui-directory-picker-browse`	应用内目录浏览面：渲染主机列/建原语的 workspace directory-flow 拥有者
`ui-directory-picker-native`	原生目录选择器面：驱动主机 OS 选择器的无渲染 workspace directory-flow 占用者
`ui-settings`	设置域基础插件：设置命名空间 scope 服务 + 规范设置槽类型契约
`ui-settings-general`	设置无属主副本 + 产品引导插件：General 节、壳触发/头部 chrome 内容、设置字典、版本化欢迎通知
`ui-settings-models`	Models 设置 + 共享产品引导对话框（基于现有设置与凭证连接）
`ui-settings-plugin-inventory`	Web Plugins 设置中的只读 Cordis Loader 清单 tab
`ui-settings-plugins`	Plugins 设置节：特性拥有的 tab + 可配置主机平面插件卡
`ui-brand-official`	Web 客户端侧边栏与会话 Hero 槽的官方 DeepSeek Harness 品牌占位

15. 自动化与跨进程协议（acp / sdk）

插件	能力
`acp`	仅自动化的 Agent Client Protocol 服务器（经 JSON-RPC stdio 驱动 Harness agents，互操作传输，非人机交互层）
`sdk/protocol`	SDK 运行时线协议：换行分隔的 JSON-RPC stdio 传输，运行时服务器与 SDK 客户端间的命名请求/结果/通知类型
`sdk/client`	TypeScript 客户端 SDK（经 stdio JSON-RPC 驱动 Harness 运行时子进程）：高层 `DeepSeekHarness` turns API + 低层 `HarnessClient`
`sdk/server`	进程外 SDK 客户端的 stdio JSON-RPC 服务器插件

16. 运行时自修改与互操作（extensions / mcp）

插件	能力	ctx key / 工具
`extensions/tool-cordis`	自引用的 cordis 工具集：检视实时运行时、挂载/销毁模型编写的插件	`cordis_inspect_list/query/self` `cordis_define/run/stop/undefine`
`extensions/cordis-host-runner`	动态包定义注册表 + 主机半沙箱生命周期 + 调用处理表（模型挂载的双半包）	`ctx.dynamicCordisRunner`
`extensions/cordis-client-runner`	双半动态包浏览器半：事件订阅、闭包求值、守卫外观、loader 条目	浏览器 `ctx.dynamicCordisRunner`
`extensions/ui-cordis`	Cordis 动态插件定义卡：带 run/stop 开关的 keyed `cordis_define` 工具行	注册 slot
`mcp/mcp-client`	MCP 客户端桥：连接 MCP 服务器并将其工具注册到 `ctx.tools`	—

17. 启动 / 组合 / 预设（boot / bundle / preset）

插件	能力	ctx key
`boot/app-boot`	共享启动胶水：`.env` 加载、fail-loud Loader 守卫、快照感知配置解析、Loader 启动序列（库）	—
`boot/cmdline`	从 dsh 启动器到注入 `cmdlineArgs` 的应用插件的不可变命令行交接	`cmdlineArgs` `appExit`
`bundle/base`	共享 dsh 核心 profile bundle：每个 profile 首先应用的 patch 层，在空 profile 根上插入基础插件行	—
`bundle/web-app`	dsh 浏览器表面 bundle：dsh-base 上的 web patch 层 + 运行时胶水插件（前端 dist 服务、web 表面提示、bash 运行时变量、URL 行）	挂载 rows
`bundle/headless`	dsh 一次性 bundle：基于 base 的直接核心 Agent/Session 运行器（无 Host/Web 层）	挂载 `headless-runner`
`preset/agent-presets`	按预设 cordis.yml 文件的每会话 Agent 组合	`ctx.agentPresets`
`preset/persona`	将 Agent persona 作为可组合行（预设可改身份而非仅改工具）	—

18. 工具库与测试支持（util / test-support / examples）

18.1 零依赖工具库（`util/`，7）

插件	能力
`brand`	仅类型 `Branded<B>` 名义化类型原语
`home-paths`	共享文件系统路径助手（解析 Harness 数据根与共享路径）
`timeout`	零依赖超时/截止原语：`clampTimeout` `deadline` `timeoutOf` `TimeoutReason`（仅计时与分类，不终止）
`output-retention`	零依赖有界保留原语：`ItemRetainer`/`TextRetainer` + 中性提示助手
`atomic-write`	零依赖原子文件替换：独占创建随机后缀临时文件 + 携带调用方权限的 rename（`writeFileAtomic`）
`native-command`	零依赖无 shell `execFile` 运行器（主机原生 OS 集成：utf8 stdio 捕获、abort 传播、Windows 隐藏）
`launch-environment`	不可变启动环境：记录每个值由哪一层提供

18.2 测试支持（`test-support/`，6，非产品 API）

插件	能力
`acp-snapshot`	ACP 测试套件：共享子进程启动器、快照场景 harness、预期输出规范化器、套件工厂
`agent-loop-testkit`	共享前置挂载（供测试具体 agent loop 用）
`client-runtime`	jsdom 槽测试运行时：真实 Cordis Context + SlotRegistry + UI 渲染器 + 测试拥有的 session/workspace 替身
`llm-mock-server`	可脚本化的 OpenAI 兼容 HTTP/SSE 故障服务器（LLM 恢复测试）
`llm-replay`	重放 LLM 插件：用录制会话 JSONL 重建的模型块短路 `llm/stream`（无 key 快照测试）
`loader-smoke`	共享子进程 + 直接 Agent harness（无 key 真实 Loader 示例冒烟测试）

18.3 示例组合（`examples/`，3，demo/参考，非产品 API）

插件	能力
`agent-spine-demo`	默认无执行器/无 UI 的 agent spine（含回退会话标题、提供方路由重试、可选持久化目标）
`acp-demo`	ACP 自动化服务器应用：agent spine + JSONL 持久化 + ACP 传输 + JSON-RPC stdio bin
`jsonrpc-demo`	启动外部 Cordis 配置用于 stdio JSON-RPC SDK 运行时的 bin

19. 运行时诊断（`runtime-diagnostics/`，1）

插件	能力	ctx key
`invariants`	包拥有的 Harness 运行时不变量注册表服务（开发期运行时契约断言，与 `test-support/invariants` 测试工具互补，但属 product 级注册表）	`ctx.invariants`

附 A：面向模型暴露的全部工具名速查

bash · pwsh · read · write · edit · str_replace_editor · glob · grep · web_search · web_fetch · lsp · skill · todo_write · ask_user_question · terminal_open/close/read/send/list/signal · job_kill/list/output · schedule_create/delete/list · create_goal/get_goal/update_goal · spawn_teammate · list_agents · send_message · wait_agent · interrupt_agent · team_task_create/get/list/update · workflow · ralph · run_code · cordis_inspect_list/query/self/define/run/stop/undefine · session_event_read/search/trace · session_search/trace · exit_plan_mode（plan 模式运行时注入） · 以及命令类 compact /feedback /export /goal /plan /permission /model 等。

附 B：设计要点

每个模型工具均由独立「消费方」插件经 ctx.tools.register(defineTool(...)) 注册；同一能力族的工具 schema / 呈现 / 执行归一处所有，提供方（如 bash-local vs bash-sandbox、fs-local vs fs-e2b、code-runtime-worker-thread vs code-runtime-python）可在不改动工具契约的前提下替换。
两个非标准注册：run_code 是注册表构造的保留传输；exit_plan_mode 仅在 plan 模式运行时注入（非激活时仍注册以保证工具目录稳定）。
同名多实现：spawn_teammate 等在 subagent 与 experimental/tool-agent-team 中同名不同语义。
client 端 40 个插件几乎不定义模型工具，只负责浏览器侧呈现（React 槽绑定、主机 RPC、UI 服务）；其能力通过 slot 类型契约与主机 Remote 暴露，而非 ctx.tools。

DeepSeek Harness — 内置插件完整能力分类整理

0. 总览：50 个分组 / 226 个包

1. 核心控制（core/，8）

2. 大模型能力（llm/，5）

3. 执行与进程（shell / subprocess / terminal / code-runtime / sandbox / e2b）

3.1 Shell（shell/，10）

3.2 子进程（subprocess/，2）

3.3 持久终端（terminal/，3）— PTY 伪终端

3.4 代码执行（code-runtime/，3）

3.5 进程沙箱（sandbox/，4）

3.6 远程执行世界（e2b/，3，POC）

4. 文件系统与附件（fs / attachment / spill）

4.1 文件系统（fs/，7）

4.2 附件（attachment/，2）

4.3 工具输出溢出（spill/，3）— 超限输出落盘

5. 代码智能（lsp/，3）

6. 网络检索（web/，6）

7. 技能（skill/，4）

8. 多智能体协作（subagent/ 11 + experimental/ 2）

8.1 子智能体（subagent/，11）

8.2 实验性 Agent Teams（experimental/，2，未发布）

9. 任务编排与记忆辅助（workflow / goal / schedule / todo / plan / jobs）

9.1 动态工作流（workflow/，4）

9.2 目标（goal/，4）

9.3 会话内提醒（schedule/，1）

9.4 待办（todo/，1）

9.5 计划模式（plan/，1）

9.6 后台任务（jobs/，3）