ARFCON/dsh-hotplug-hub

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

🇬🇧 English · 🇨🇳 简体中文

Dseam World — DSH-Hotplug-Hub

DSH-Hotplug-Hub 是 Dseam World 的插件管理器——一个 Windows 桌面应用程序（WebView2 + C# WinForms），用于管理 DSH 插件、Skills 和 MCP 服务器，并带有全局记忆功能。它与 DSH Desktop 协同工作，不触碰 DSH Desktop 的安装目录，而是将所有内容安装到位于 ~/.dsh/profiles/web 的统一官方配置文件中。

关于

一个面向 DeepSeek Harness (dsh) 的热插拔包管理器。它引入了 hotpack 的概念——一种带版本、可移植的插件包，可以在不修改宿主的情况下导入、激活、停用或移除。它构建于与 dsh-hub 相同的机制之上：typert Remote API + 网页 + 原子化配置文件写入 + link 组装。

当前版本

| | |
|---|---|
| 发布版本 | 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 |

主要功能

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

5 个标签页

| 标签页 | 描述 |
|---|---|
| 插件管理 | 导入 hotpack JSON（粘贴或选择文件）、预览、下载、激活 / 停用 / 移除，显示商店状态。 |
| 插件市场 | 基于主题标签的真实 GitHub 市场；一键安装条目。 |
| AI 组装器 | 由真实 LLM（DeepSeek / OpenCode / OpenRouter / Sensetime / Moonshot / Zhipu / MiniMax，兼容 OpenAI 的端点）驱动的对话式组装（角色切换 + 自然语言）；验证 hotpack 清单 + 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 CLI。

./install.sh          # 自动检测桌面 / Web / 无头配置文件
./install.sh web      # 指定特定配置文件

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 安装到 profile，共享 pnpm 全局存储。
- path — 直接链接本地目录（与 graph-memory 相同）；支持 ~ 和 $DSH_HOME 展开。
- github — zip → ~/.dsh/hotplug-store/@ → 链接；优先使用官方 codeload，然后是 ghfast.top / gh-proxy / ghproxy 镜像。

目录结构

dsh-hotplug-hub-test/              # 仓库根目录
├── packages/shared-core/          # 共享核心：契约 / 类型 / 共享逻辑
├── release/                       # 构建 EXE、安装程序、WebView2 DLL、内嵌 C# 契约
├── scripts/                       # 团队脚本：同步 / 检查 / 测试 / 安装
├── launcher/                      # Node CLI：组装 / 检查 / 启动 / 修复 / 状态
├── 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 许可证

开发

编辑前 — 同步仓库
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

许可证

MIT

Dseam 世界（DSH-Hotplug-Hub）

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

关于（About）

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

当前版本

| | |
|---|---|
| 正式版 | 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 |

主要功能

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

五大页面标签

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

./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 装入 profile，共享 pnpm 全局 store。
- path——本地目录直接 link（同 graph-memory 模式）；支持 ~ 与 $DSH_HOME 展开。
- github——zip → ~/.dsh/hotplug-store/@ → 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