热插拔插件管家 ARFCON/dsh-hotplug-hub

面向 AI 编程协作者：开始任何工作前，请先阅读本目录的 AI_AGENTS.md，并遵循其中的同步/检查/上报流程。

🇬🇧 English · 🇨🇳 简体中文

Dseam World — DSH-Hotplug-Hub

DSH-Hotplug-Hub 是 Dseam World 的插件管理器。Dseam World 是一款 Windows 桌面应用（WebView2 + C# WinForms），用来管理 DSH 插件、技能和 MCP 服务器，并带全局记忆。它与 DSH Desktop 并行工作，不碰 DSH Desktop 的安装目录，所有东西都装进官方统一配置档 ~/.dsh/profiles/web。

关于

这是 DeepSeek Harness (dsh) 的热插拔包管理器。它引入了 hotpack 的概念——一个带版本、可移植的插件包，能导入、启用、停用或移除，全程不改动宿主。底层机制与 dsh-hub 相同：typert Remote API + 网页 + 原子化写入配置档 + link 组装。

当前版本

| 发布版 | v1.0.4 |
| Releases 页面 | <https://github.com/ARFCON/dsh-hotplug-hub/releases/tag/v1.0.4> |
| Windows 安装包 | DSH-Hotplug-Hub-win-x64-setup-v1.0.4.exe |
| Windows 便携版 | DSH-Hotplug-Hub-win-x64-portable-v1.0.4.zip |
| Linux 安装包 | DSH-Hotplug-Hub-linux-x64-setup-v1.0.4.sh |
| Linux 便携版 | DSH-Hotplug-Hub-linux-x64-portable-v1.0.4.tar.gz |
| macOS 安装包 | DSH-Hotplug-Hub-macos-x64-setup-v1.0.4.command |
| macOS 便携版 | DSH-Hotplug-Hub-macos-x64-portable-v1.0.4.zip |

主要功能

- 插件管理 —— 安装 / 禁用 / 卸载插件和插件包。
- 技能管理 —— 扫描固定源目录（默认 %APPDATA%\reasonix\skills，可用 DSH_SKILL_SOURCE_DIR 覆盖），找出所有 SKILL.md 文件，一键安装 / 禁用。底层由 dseam-skillmcp 命令行驱动。
- MCP 管理 —— 添加 / 移除 / 禁用 STDIO 和 streamable-http MCP 服务器，统一写入 dseam-skillmcp 管理器模块。
- 全局记忆 —— 借助内置记忆功能，按项目查看 / 编辑 / 删除条目。AI 需要关键信息（偏好 / 规则 / 约束 / 备注 / 记忆 / 项目目标）时，会触发记忆提示词，绝不让 AI 自行编辑或删除记忆。
- 内置技能/MCP 管理器 —— dseam-skillmcp（源自 dsh-skill-mcp-panel，MIT），随安装包 / EXE 一起分发，自动装进配置档，无需单独下载。
- 版本一致性 —— dseam-skillmcp 和 dsh-hub 内嵌在安装程序 / 便携版应用里，每次发版随版本一起原子更新，不用反复下载。
- 托盘常驻 —— 关闭窗口即缩到系统托盘，后台进程继续运行；双击图标重新打开已有窗口。
- 自检与自愈 —— 启动时自动检查 Node / pnpm / 配置档 / 插件 / 配置，需要时自动安装或修复环境。

5 个标签页

| 标签页 | 说明 |
| 插件管理 | 导入 hotpack JSON（粘贴或选文件）、预览、下载、启用 / 停用 / 移除，显示商店状态。 |
| 插件市场 | 按 topic 标签接入真实 GitHub 市场，一键安装条目。 |
| AI 装配器 | 对话式装配（切换人设 + 自然语言），由真实 LLM 驱动（DeepSeek / OpenCode / OpenRouter / Sensetime / Moonshot / Zhipu / MiniMax，兼容 OpenAI 的端点）；校验 hotpack manifest + README，一键写出 hotpack JSON。 |
| 全局记忆 | 显示 ~/.dsh/memory 全局记忆目录路径和条目数量。 |
| 自检 | 调用 check() 远程服务；显示 Node/pnpm 版本、配置档状态、补丁状态、插件冲突、包 / 商店状态。 |

安装

方式 1 —— 安装程序（推荐）

1. 从 Releases 页面下载 DSH-Hotplug-Hub-win-x64-setup-v1.0.4.exe。
2. 双击，选择安装位置（默认 %LOCALAPPDATA%\Programs\DseamWorld）。
3. 安装程序自动创建桌面 / 开始菜单快捷方式，装完自动启动。

静默安装：

DSH-Hotplug-Hub-win-x64-setup-v1.0.4.exe --silent
DSH-Hotplug-Hub-win-x64-setup-v1.0.4.exe --silent --dir "D:\MyApps\DseamWorld"

方式 2 —— 便携版

- Windows：解压 DSH-Hotplug-Hub-win-x64-portable-v1.0.4.zip，双击 DSH-Hotplug-Hub.exe（WebView2 运行时 DLL 已放在同一目录）。
- Linux：tar -xzf DSH-Hotplug-Hub-linux-x64-portable-v1.0.4.tar.gz，然后运行 ./dsh-hotplug-hub。
- macOS：解压 DSH-Hotplug-Hub-macos-x64-portable-v1.0.4.zip，双击 Start-DSH-Hotplug-Hub.command。

方式 3 —— 从源码安装

需要 Node.js 18+（推荐 LTS）、pnpm 和 dsh 命令行。

./install.sh # auto-detect desktop / web / headless profile
./install.sh web # target a specific profile

hotpack 格式

{
"hotpack": "1.0",
"id": "pack.research",
"name": "Research hotpack",
"version": "1.0.0",
"description": "Literature + mind-map + note sync",
"tags": ["research", "study"],
"plugins": [
{ "id": "literature", "name": "@dsh-community/dsh-tool-literature", "version": "1.2.3", "source": { "type": "npm" } },
{ "id": "mine", "name": "my-plugin", "source": { "type": "path", "path": "~/dev/my-plugin" } },
{ "id": "team", "name": "team-tool", "source": { "type": "github", "repo": "owner/team-tool", "ref": "v1.0.0" } }
]
}

支持的来源：
- npm — 必须指定确切版本；用 pnpm add --save-exact 装进配置档，共用 pnpm 全局存储。
- path — 直接链接本地目录（与 graph-memory 相同）；支持展开 ~ 和 $DSH_HOME。
- github — zip → ~/.dsh/hotplug-store/<name>@<ref> → 链接；优先走官方 codeload，其次 ghfast.top / gh-proxy / ghproxy 镜像。

目录结构

dsh-hotplug-hub-test/ # repo root
├── packages/shared-core/ # shared core: contracts / types / shared logic
├── release/ # build EXE, installer, WebView2 DLLs, embedded C# contracts
├── scripts/ # team scripts: sync / check / test / install
├── launcher/ # Node CLI: assemble / check / launch / heal / status
├── dsh-hotplug-hub/ # hotplug-hub plugin + dsh-pack-hub
├── vendor/dseam-skillmcp/ # Skill/MCP manager source (MIT)
├── installer/ # historical installer factories
├── uninstaller/ # uninstaller factories
├── assembly/ # assembly packs (hotpack 1.0, dshpack single-entry)
├── sandbox/ # temporary profile sandboxes
├── 开发文档/ # team docs & conventions ├── README.md # this file └── LICENSE # MIT License

开发

Before editing — sync the repo pwsh -File scripts/sync-repo.ps1

Before committing — full checks pwsh -File scripts/check-before-upload.ps1

After each change — record to global memory pwsh -File scripts/remember-doc.ps1 -DocPath README.md

团队约定见 AI_AGENTS.md 和 开发文档/团队/。

更新日志

完整变更历史：开发文档/开发历史.md

协议

MIT

Dseam 世界（DSH-Hotplug-Hub）

DSH-Hotplug-Hub 是 Dseam 世界 的插件管理器——一款 Windows 桌面应用（WebView2 + C# WinForms），用来管理 DSH 的插件、技能与 MCP 服务器，并提供全局记忆。它与 DSH Desktop 并存运行，不改动 DSH Desktop 安装目录，而是把所有内容统一安装到官方配置档 ~/.dsh/profiles/web，随 DSH 自行加载。

关于（About）

面向 DeepSeek Harness（dsh） 的热插拔包管理器。核心概念是 hotpack——一个带版本、可移植的插件集合，可以导入、激活、停用、移除，全程不动宿主。与 dsh-hub 共用同一套机制：typert Remote API + 网页 + 配置档原子写入 + link 装配。

当前版本

| 正式版 | v1.0.4 |
| 发布页 | <https://github.com/ARFCON/dsh-hotplug-hub/releases/tag/v1.0.4> |
| Windows 安装版 | DSH-Hotplug-Hub-win-x64-setup-v1.0.4.exe |
| Windows 便携版 | DSH-Hotplug-Hub-win-x64-portable-v1.0.4.zip |
| Linux 安装版 | DSH-Hotplug-Hub-linux-x64-setup-v1.0.4.sh |
| Linux 便携版 | DSH-Hotplug-Hub-linux-x64-portable-v1.0.4.tar.gz |
| macOS 安装版 | DSH-Hotplug-Hub-macos-x64-setup-v1.0.4.command |
| macOS 便携版 | DSH-Hotplug-Hub-macos-x64-portable-v1.0.4.zip |

主要功能

- 插件管理——安装 / 停用 / 卸载插件与插件集合。
- 技能管理——扫描固定源目录（默认 %APPDATA%\reasonix\skills，可用 DSH_SKILL_SOURCE_DIR 覆盖）下的所有 SKILL.md，一键安装 / 停用；由 dseam-skillmcp 命令行支撑。
- MCP 管理——支持 STDIO 与 streamable-http 两类 MCP 服务器的添加 / 删除 / 停用，统一写入 dseam-skillmcp 管理模块。
- 全局记忆——通过内置记忆功能按项目查看 / 编辑 / 删除条目；当 AI 需要关键信息（偏好 / 规则 / 约束 / 备注 / 记忆 / 项目目标）时触发记忆提示，且不允许 AI 自行修改 / 删除记忆。
- 内置技能 / MCP 管理器——dseam-skillmcp（源自 dsh-skill-mcp-panel，MIT License），随安装包 / EXE 内置，自动装入配置档，无需单独下载。
- 版本一致——dseam-skillmcp、dsh-hub 已内嵌进安装包 / 便携包，每次发版同步更新，无需重复下载。
- 托盘常驻——关闭后最小化到系统托盘，后台进程继续运行；重复打开只唤起已有窗口。
- 自检自愈——启动时自动自检（Node / pnpm / 配置档 / 插件 / 配置），自动安装或修复运行环境。

五大页面标签

| 标签 | 说明 |
| 插件管理 | 导入 hotpack JSON（粘贴或选文件），预览 / 下载，激活 / 停用 / 移除，展示 store 状态。 |
| 插件市场 | 按 topic 标签抓取真实 GitHub 市场，一键安装条目。 |
| AI 装配员 | 对话式装配（人设切换 + 自然语言），由真实 LLM 驱动（DeepSeek / OpenCode / OpenRouter / 商汤 / Moonshot / 智谱 / MiniMax，OpenAI 兼容端点）；校验 hotpack manifest + README，一键产出 hotpack JSON。 |
| 全局记忆 | 展示 ~/.dsh/memory 全局记忆目录路径与 store 条目数。 |
| 自检诊断 | 运行 check() 远程服务，展示 Node/pnpm 版本、配置档状态、补丁状态、插件冲突、pack/store 状态。 |

安装

方式一：安装包（推荐）

1. 在 Release 页面下载 DSH-Hotplug-Hub-win-x64-setup-v1.0.4.exe。
2. 双击运行，选择安装位置（默认 %LOCALAPPDATA%\Programs\DseamWorld）。
3. 安装包自动创建桌面 / 开始菜单快捷方式，完成后直接启动。

静默安装：

DSH-Hotplug-Hub-win-x64-setup-v1.0.4.exe --silent
DSH-Hotplug-Hub-win-x64-setup-v1.0.4.exe --silent --dir "D:\MyApps\DseamWorld"

方式二：便携版

- Windows：解压 DSH-Hotplug-Hub-win-x64-portable-v1.0.4.zip，双击 DSH-Hotplug-Hub.exe（WebView2 运行时 DLL 已内置同目录）。
- Linux：tar -xzf DSH-Hotplug-Hub-linux-x64-portable-v1.0.4.tar.gz，运行 ./dsh-hotplug-hub。
- macOS：解压 DSH-Hotplug-Hub-macos-x64-portable-v1.0.4.zip，双击 Start-DSH-Hotplug-Hub.command。

方式三：源码安装

前置依赖：Node.js 18+（推荐 LTS）、pnpm、dsh 命令行。

./install.sh # 自动探测 desktop / web / headless profile ./install.sh web # 指定 profile

hotpack 格式

{
"hotpack": "1.0",
"id": "pack.research",
"name": "科研热插拔包", "version": "1.0.0", "description": "文献 + 思维导图 + 笔记同步",
"tags": ["科研", "学习"],
"plugins": [
{ "id": "literature", "name": "@dsh-community/dsh-tool-literature", "version": "1.2.3", "source": { "type": "npm" } },
{ "id": "mine", "name": "my-plugin", "source": { "type": "path", "path": "~/dev/my-plugin" } },
{ "id": "team", "name": "team-tool", "source": { "type": "github", "repo": "owner/team-tool", "ref": "v1.0.0" } }
]
}

支持的源类型：

- npm——要求精确版本；pnpm add --save-exact 装入配置档，共享 pnpm 全局 store。
- path——本地目录直接 link（同 graph-memory 模式）；支持 ~ 与 $DSH_HOME 展开。
- github——zip → ~/.dsh/hotplug-store/<name>@<ref> → link；优先官方 codeload，失败回退 ghfast.top / gh-proxy / ghproxy 镜像。

目录结构

dsh-hotplug-hub-test/ # 仓库根目录 ├── packages/shared-core/ # 共享内核：契约 / 类型 / 共享逻辑 ├── release/ # 构建 EXE、安装包、WebView2 DLL、内嵌 C# 契约 ├── scripts/ # 团队脚本：同步 / 检查 / 测试 / 安装 ├── launcher/ # Node CLI：assemble / check / launch / heal / status ├── dsh-hotplug-hub/ # hotplug-hub 插件 + dsh-pack-hub 原始页 ├── vendor/dseam-skillmcp/ # Skill/MCP 管理器源码（MIT） ├── installer/ # 历史安装包工厂 ├── uninstaller/ # 卸载器工厂 ├── assembly/ # 装配包（hotpack 1.0、dshpack 单一入口代码） ├── sandbox/ # 临时 profile 沙箱 ├── 开发文档/ # 团队文档与规范 ├── README.md # 项目说明 └── LICENSE # MIT License

开发

修改前先同步仓库 pwsh -File scripts/sync-repo.ps1

提交前完整检查 pwsh -File scripts/check-before-upload.ps1

每次改动后记录到全局记忆 pwsh -File scripts/remember-doc.ps1 -DocPath README.md

团队规范见 AI_AGENTS.md 与 开发文档/团队/。

版本历史

完整变更记录：开发文档/开发历史.md

License

MIT