目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
cordis-plugin-includecordis-plugin-loaderdsh-agentdsh-invariantsdsh-scopedsh-sessiondsh-session-projectiondsh-settingsdsh-system-promptdsh-tools
依赖链 · 下游（依赖该插件的节点）：
dsh-agent-presetdsh-api-remotesdsh-api-session-controllerdsh-client-ui-agent-presetdsh-client-ui-settings-plugin-inventorydsh-host-plugin-inventorydsh-plugin-package-inventory-deepseekdsh-subagent
同一拓扑层（Layer 5，层次遍历层序）：
dsh-agent-default-modeldsh-agent-instructionsdsh-agent-loopdsh-agent-preset-registrydsh-agent-tool-presentationdsh-api-account-controllerdsh-api-settings-controllerdsh-api-terminal-controllerdsh-api-workspace-filesdsh-bash-sandboxdsh-client-file-uploaddsh-compaction-image-offloaddsh-compaction-tool-result-prunerdsh-cordis-host-runnerdsh-experimental-browser-use-chrome-devtools-mcpdsh-experimental-browser-use-playwright-mcpdsh-experimental-tool-agent-teamdsh-file-reference-localdsh-fs-sandboxdsh-fs-sshdsh-goaldsh-hooks-codexdsh-jobs-localdsh-llm-retrydsh-mcp-resourcesdsh-message-feedbackdsh-permission-presetsdsh-ptc-runtime-nodedsh-pwsh-sandboxdsh-repeat-tool-reminderdsh-sdk-jsonrpc-serverdsh-session-checkpoint-policydsh-session-referencedsh-session-title-all-prompts-llmdsh-session-title-first-prompt-llmdsh-spill-policydsh-terminaldsh-time-contextdsh-tmux-contextdsh-tool-bashdsh-tool-call-timeout-policydsh-tool-fsdsh-tool-fs-searchdsh-tool-jobsdsh-tool-lspdsh-tool-presentdsh-tool-pwshdsh-tool-session-querydsh-tool-skilldsh-tool-str-replace-editordsh-tool-tododsh-tool-webdsh-tool-workspace-dependenciesdsh-user-questionsdsh-web-search-deepseek
插件信息
| 包名 | @deepseek-ai/dsh-agent-preset-registry |
|---|---|
| 分组 | G27 · Agent 预设 |
| 拓扑层 | Layer 5（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/preset/agent-preset-registry |
| 来源层 | L2 web-app bundle（base 之上装配） |
① 实现逻辑
AgentPresetRegistry 为 TypertRemoteService，构造时注册 agentPreset 投影并监听 session/event 转发 agent-preset/selected（src/index.ts:63-71、src/session.ts:35-44）。register() 立即激活定义，activate() 在独立 scope 内用 mountPreset 挂载 Loader 子树，失败则记录 broken 并 dispose scope（src/index.ts:80-118、src/mount.ts:258-272）。mount()/bind() 以 bindScopeParent 把 Agent scope 绑到保留的 standing revision，用引用计数 collect 回收，composeFrom 让子 Agent 继承父的精确版次（src/index.ts:208-284）。auditRows 与 leakedServices 审计行可用性与根域服务泄漏（src/mount.ts:86-212）；invariant.ts 在 internal/service 与 system-prompt/assemble 复核隔离与绑定（src/invariant.ts:33-59）。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- ctx.agentPresets (Agent 预设注册表：激活/绑定/选择与 composition 读取，src/index.ts:51-365)
- sessionProjections `agentPreset` 投影（会话实际运行的预设定，src/index.ts:66、src/session.ts:35-44）
- Remote 方法 list/read/select（客户端花名册读取与选择，src/index.ts:170-206、:318-334）
③ 依赖（depends_on · 上游前驱）
cordis-plugin-loaderE1+E2
挂载、审计并定位预设的 Loader entry 树
src/index.ts:52 inject 'loader' + src/composition-inventory.ts:3 EntryTree/isJsExpr + src/mount.ts:3 EntryTree + src/index.ts:137 this.owner.loader.await()
dsh-agentE1
绑定并读取活动 Agent 的预设版次
src/index.ts:8 type import Agent + src/index.ts:325 agent.ctx、src/index.ts:326 agent.session
dsh-invariantsE1+E2
注册预设隔离与 Agent 绑定不变式
src/invariant.ts:7 type InvariantInstaller + src/invariant.ts:68 ctx.invariants.register
dsh-scopeE1
建立 Agent scope 与 preset standing scope 的父子绑定关系
src/index.ts:5 bindScopeParent/createScope/scopeOf + src/mount.ts:6 scopeOf/scopeParentOf
dsh-sessionE1
把预设选择写入会话日志
src/types.ts:2 type SessionId + src/index.ts:326 agent.session.append('agent-preset/selected')
dsh-session-projectionE1+E2
注册 agentPreset 投影并读取 turnBoundary 判定空会话
src/index.ts:66 ctx.sessionProjections.register + src/session.ts:17 type ProjectionDefinition + src/index.ts:321 stateOf
dsh-settingsE2
关闭 settings 自动持久化以自管 selectedDefault
src/index.ts:10 type import + src/index.ts:67 ctx.inject(['settings'], ...) settings.configure({ auto: false })
dsh-system-promptE1+E2
在模型组装水线校验 Agent 已加入某预设
src/invariant.ts:10 type import + src/invariant.ts:48 ctx.on('system-prompt/assemble')
dsh-toolsE1+E2
预设重绑后通知工具目录变更
src/index.ts:11 type import + src/index.ts:308 this.owner.emit('tools/change')
④ 被依赖（dependents · 下游消费者）
dsh-agent-preset
把本行声明的预设定义提交给注册表激活
src/index.ts:5-6 type import PresetDefinition + src/index.ts:13 static inject 'agentPresets' + src/index.ts:28 ctx.agentPresets.register
dsh-api-remotes
装配 agent preset registry 命名空间
src/client/index.ts:4 import remote + src/client/index.ts:75 import types
dsh-api-session-controller
解析并挂载 Agent 预设
src/agent.ts:10 import + src/agent.ts:385 ctx.get('agentPresets')
dsh-client-ui-agent-preset
消费 preset 组合类型与 display 文案
src/client/AgentPresetLabel.tsx:17 import @deepseek-ai/dsh-agent-preset-registry/types + src/client/locales.ts:114-115
dsh-client-ui-settings-plugin-inventory
复用共享的预设显示名折叠逻辑
src/client/index.ts:12 import { presetDisplayText }
dsh-host-plugin-inventory
读取 agent preset 组合清单并投影其行
package.json:51 peerDep + src/index.ts:6 type import; src/index.ts:97 ctx.get('agentPresets')、:100 compositionInventory
dsh-plugin-package-inventory-deepseek
查询 agent 的 standing preset 挂载树以纳入预设内活跃插件包
src/index.ts:19 import type {} + src/index.ts:169 dynamic import standingMountFor + src/index.ts:164 ctx.get('agentPresets')
dsh-subagent
让子代理加入父的 preset 组合
src/child-agent.ts:29 (type import) + src/child-agent.ts:205 (ctx.get('agentPresets')?.composeFrom)