deepseekplugins

DeepSeek Harness 插件

dsh-hot-reload-sipengxi

Hot-reload installed out-of-tree DSH plugins without restarting the host: /reload <package> evicts the module cache and remounts the loader entry (out-of-tree plugin)（英文原文）

插件开发工具
跳到安装方式

来源信息

GitHub 仓库
SipengXie2024/dsh-hot-reload
最近更新
2026年8月15日
分类
插件开发工具
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/SipengXie2024/dsh-hot-reload
插件名：dsh-hot-reload-sipengxi
作者：SipengXie2024

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-hot-reload

Hot-reload installed out-of-tree plugins for dsh (DeepSeek Harness) — no host restart, no lost sessions.

不重启 DSH host、不丢会话，把已安装的第三方插件从磁盘重新装载。

用法

  • 对话框：/reload dsh-session-topics（无参数列出可 reload 的包）
  • HTTP：GET /hot-reload?name=dsh-session-topics（无参返回 usage + 候选列表）

典型工作流

改插件代码 → bump version + npm pack + dsh plugin --profile web add <tgz> → /reload <包名>

开发期更快的环路（跳过 pack/add）：直接改 $DSH_HOME/profiles/web/node_modules/<包名>/ 里的文件后 /reload。 必须先删后写（unlink 再写新文件）：pnpm 的文件是全局 store 的硬链接（实证两链接），原地覆盖会污染 store。

client 半边（浏览器那半）不归本插件管也不需要管：船载 client-hmr 对 bundle 文件做 500ms stat 轮询，内容一变自动推送。

原理（一句话）

按 /node_modules/<包名>/ 前缀清空 Node 内部 ESM loadCache（Map.prototype.delete 直调，应对 Node 24 槽语义）与 require.cache，然后对该包的每个 loader entry 做 _dispose()（disposer 逆序自动回收）+ refresh()（重新 import → 新代码 → fiber 挂回原 entry，配置树不脱钩）。清缓存后先预检 import，构建坏了就中止、旧插件继续跑。

边界

  • 拒绝 reload @deepseek-ai/* 共享框架包（类身份风险：RPC 类、调度 Symbol 跨副本断裂）与自身。升级这些 = 重启。
  • 目标插件的副作用必须全部经 ctx.effect/ctx.on/ctx.provide 注册（裸 webServer.register 会在 reload 时泄漏路由）。
  • disabled 的行保持不启（refresh() 语义）。
  • 两类插件均已实测：单文件纯 ESM 插件（dsh-session-topics，改代码 → reload → 生效 → 可回滚），以及多文件构建产物 + client 半边 + 持久状态的插件（dsh-memory-hermes，reload 后设置页面板 RPC 与 storage sidecar 均存活）。
  • reload 后模块级内存缓存（WeakMap 等）清零重建，属预期的缓存失效。

安装

npm pack
dsh plugin --profile web add dsh-hot-reload-<version>.tgz

对已在运行的实例：往 $DSH_HOME/profiles/web/cordis.patch.yml 追加下面几行即热挂载（实证三实例零重启装载；与重启后 bundle 层自带的同 id 行幂等收敛）：

- insert:
    - id: hot-reload
      name: dsh-hot-reload
返回搜索打开 GitHub 仓库

更多相关插件

查看分类