目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游(该插件依赖的前驱):
cordis-plugin-includecordis-plugin-loaderdsh-hmrdsh-host-plugin-inventorydsh-sandbox-policydsh-toolsdsh-user-approval
依赖链 · 下游(依赖该插件的节点):
同一拓扑层(Layer 7,层次遍历层序):
dsh-acpdsh-api-session-controllerdsh-experimental-browser-use-stagehand-nativedsh-experimental-computer-use-cua-driver-mcpdsh-experimental-computer-use-cua-driver-nativedsh-hooks-claude-codedsh-plugin-managerdsh-subagent-acpdsh-subagent-claude-codedsh-subagent-codexdsh-subagent-dsh-sdkdsh-subagent-fork-in-processdsh-subagent-spawn-in-processdsh-tool-subagentdsh-tool-subagent-controldsh-workflow-ptc
插件信息
| 包名 | @deepseek-ai/dsh-plugin-manager |
|---|---|
| 分组 | G04 · 启动与插件管理 |
| 拓扑层 | Layer 7(层次遍历:被依赖方先于依赖方) |
| 源码路径 | packages/boot/plugin-manager |
① 实现逻辑
`PluginManager extends TypertRemoteService` 以 `@Remote` 方法向前端暴露当前 profile 的插件/包管理 (src/index.ts:176-178)。它把 profile patch 与 manifest 组合成可寻址行,判定 protected/unaddressable/management-required 只读原因 (src/index.ts:256-272),并以 `withFileLock`+`writeFileAtomic` 串行化 set/install/remove,失败或取消时回滚 `package.json`/`pnpm-lock.yaml` (src/index.ts:767-791, 697-713)。安装走 `runProfilePnpm` 并逐 registry 重试、做 GitHub 连通性预检与产物 bundle 校验 (src/index.ts:461-567);`tools.ts` 另注册 `plugin_manager` 工具,经沙箱提权审批后调用同一服务 (src/tools.ts:18-91)。
内部结构动态 DAG(深色主题:橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件)
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供(provides)
- ctx.pluginManager (当前 profile 的插件/包管理服务:listPlugins/listBundles/inspect/installBundle/removeBundle/setPluginEnabled/setBundleEnabled)
- plugin_manager 工具 (Agent 侧管理入口,含沙箱提权与审批)
- 版本豁免管理 (listVersionExemptions/setVersionExemption)
- plugin-manager/install-log、plugin-manager/install-state、plugin-manager/changed 事件
③ 依赖(depends_on · 上游前驱)
cordis-plugin-loaderE1+E2
读取活动 Loader 行以判定可寻址性与 bundle 贡献是否在用
src/index.ts:9 + src/index.ts:177 static inject 'loader'
dsh-hmrE2
配置写入与热重载串行化,并在无 HMR 时降级为 restart-required
src/index.ts:20 (type merge) + src/index.ts:757-759 ctx.get('hmr').runExclusive
dsh-sandbox-policyE2
解析会话沙箱模式,决定管理操作是否需要 danger-full-access 提权
src/tools.ts:5 + src/tools.ts:13 inject + src/tools.ts:38 ctx.sandboxPolicy.resolve
dsh-toolsE1+E2
注册面向模型的 plugin_manager 工具
src/tools.ts:9 + src/tools.ts:13 inject 'tools' + src/tools.ts:19 ctx.tools.register
④ 被依赖(dependents · 下游消费者)
dsh-api-remotes
装配插件管理命名空间与事件
src/client/index.ts:13 import remote + src/remote-events.ts:12 import types
dsh-client-ui-plugin-manager
插件管理 Remote 与 registry 协议类型
src/client/index.ts:22 import types + src/client/manager-store.ts:28 import '/registry'