目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
依赖链 · 下游（依赖该插件的节点）：
同一拓扑层（Layer 2，层次遍历层序）：
插件信息
| 包名 | @deepseek-ai/dsh-hmr |
|---|---|
| 分组 | G04 · 启动与插件管理 |
| 拓扑层 | Layer 2（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/boot/hmr |
① 实现逻辑
HMR 服务以 Chokidar 监听模块根，把文件变更经 debounce 后串行投入 `runExclusive` 队列处理 (src/index.ts:139-153, 260-305)。它对变更做 externals/accepted/declined 分类与依赖图闭包分析 (src/index.ts:66-77, 351-404)，据此清 ESM loadCache 与 CJS require.cache 并重导入插件、重建 fiber，失败时回滚缓存与旧插件 (src/index.ts:471-575)。同一队列也承载 profile 配置文件监视 (`watchConfig` 委托 watch-config.ts，处理尚不存在的路径) (src/index.ts:160-176)，完成后发 `hmr/reload` 事件 (src/index.ts:578)。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- ctx.hmr (串行化的模块与配置热重载服务：runExclusive/watchConfig/getLinked/getOuterStack)
- hmr/change 与 hmr/reload 事件，供其它插件感知文件变更与重载批次
③ 依赖（depends_on · 上游前驱）
cordis-plugin-includeE1+E2
识别 include 配置树并触发其增量刷新，区分配置文件与模块变更
src/index.ts:6 + src/index.ts:288-298 include.refresh()
cordis-plugin-loaderE1+E2
经 loader.internal 访问 Node ModuleLoader(loadCache)并重建插件 fiber
src/index.ts:5 + src/index.ts:86-87 @Inject('loader')
cordis-plugin-timerE1+E2
提供 ctx.debounce，把同一批文件变更合并成一次重载事务
src/index.ts:13 + src/index.ts:87 @Inject('timer') + src/index.ts:268 ctx.debounce
④ 被依赖（dependents · 下游消费者）
dsh-config-editor
配置写入与 HMR 模块/配置重载串行化，避免编辑过程与热重载竞态
src/index.ts:9 (type merge) + src/index.ts:140-141 ctx.get('hmr').runExclusive
dsh-plugin-manager
配置写入与热重载串行化，并在无 HMR 时降级为 restart-required
src/index.ts:20 (type merge) + src/index.ts:757-759 ctx.get('hmr').runExclusive