DSH-Plugin-Manager

DSH Manager

> 车同轨，书同文。DSH 的多版本、插件、Profile 与整合包，从此归于一统。

>

> 无需本地拥有任何环境,也无需手动安装DSH,开箱即用

面向 DSH 的桌面管理工具（Tauri 2 + React 19 + TypeScript）。在图形界面中完成 DSH 多版本下载管理、Profile 管理(整合包管理)、插件安装与管理、整合包（.dspack）导出 / 导入 / 市场、多实例独立启动，无需手敲命令行。

解决什么问题

1. 安装或者升级一个插件导致DSH启动错误或者异常？——> 本软件支持直接通过图形化插件管理关闭或者降级插件让DSH正常启动

2. 升级DSH后所有插件失效?——>本软件支持同时共存多个DSH版本，在保留你所有插件功能的同时可以复制已有的profile来为你适配新版DSH提供容错

3. 不想一个一个插件自己安装尝试？——>本软件支持整合包功能，内置整合包市场，一键导入市场中的整合包

4. 自己手动安装管理插件麻烦?——>本软件支持插件管理，内置插件市场，支持管理每个profile中的插件

5. 不想开命令行，还想同时跑好几个 DSH / Profile？——> 图形化启动 / 停止 / 重启，任意 DSH 版本 × 任意 Profile 多实例并行，端口自动分配互不冲突

***

界面布局

| 区域 | 内容 |

| -- | ---------------------------------------------------- |

| 左栏 | DSH 环境（每个 = 一个 DSH 程序本体，可多版本共存） |

| 中栏 | Profiles（合并默认 ~/.dsh/profiles + 扫描目录，不绑定任何 DSH 版本，可以管理整合包） |

| 右栏 | 当前 Profile 的插件列表与操作、运行控制（启动 / 停止 / 重启 / 打开界面） |

功能特性

插件管理

• 在线安装：内置插件市场（参考 dsh-market/dsh-market）、NPM 搜索安装、GitHub 安装、自定义源安装

• 本地安装：选择文件夹（含 package.json）或 .tgz 压缩包，按 file: 协议复制安装到指定 Profile

• 插件列表：卸载 / 更新（检查 npm 新版本）/ 启用停用（拉杆开关，写 cordis.patch.yml）

• 版本豁免：插件与当前 dsh runtime 的 peerDependencies 不兼容时，可显式授权豁免安装

Profile 管理（整合包管理）

• 新建 / 删除 Profile

• 导入 / 导出为 zip 压缩包（可排除 node_modules；重名自动改名）

• 整合包（.dspack）导入导出：遵循 [DSH-PackForge](https://github.com/DSH-PackForge/DSH-PackForge) 规范（manifest v5 / 容器 v3）——

导出自动排除 node_modules / 运行数据 / 凭据，导入自动重建依赖（pnpm install 流式日志），重名自动改名

• 整合包市场：在线浏览 [dsh-pack-market](https://github.com/DSH-PackForge/dsh-pack-market) 索引，下载并校验 SHA-256 + size 后导入

• 右键备注：给 Profile 添加备注与「适配版本」提示（下拉选择左栏 DSH 版本，仅作提示、无任何约束）

• 扫描目录：把本地任意 profiles 目录（如 DSH Desktop 的 .dsh-packs）加入列表

DSH 环境管理

• 下载多版本 DSH 到指定目录，电脑可同时拥有多个版本

• 扫描本体：从已安装目录（全局 npm / DSH Desktop 内置 / 本地项目）自动探测 dsh.cmd / bin.js 并读取版本

• 镜像源设置：自定义 npm registry（默认 registry.npmmirror.com），解决大陆网络下载失败

多实例运行

• 任意 DSH 版本 × 任意 Profile 可自由组合，各自独立进程

• 端口自动分配（从 3080 起避开已占用），互不冲突

• 每个实例独立 启动 / 停止 / 重启；进程退出自动清理、重启按钮自动还原

• 「打开界面」实时从运行日志提取带 token 的认证地址，一步到位进入 DSH Web UI

体验细节

• 环境与 Profile 列表拖拽排序（重启保留）

• 记住上次选择的 DSH 环境与 Profile

• 左栏 / 中栏标题右侧 ? 按钮提供板块使用说明

• 全程无命令行黑框（所有后台命令均以无窗口方式执行）

***

整合包（Modpack）—— 重点功能

像 Minecraft 整合包一样，把 DSH AI 智能体配置一键导出、分享、安装。遵循开源规范 [DSH-PackForge](https://github.com/DSH-PackForge/DSH-PackForge)（.dspack 容器 v3 + manifest v5），可与生态内其他启动器互通。

总体功能

| 能力 | 说明 |

| --- | --- |

| 导出 | 把当前 Profile 打成 .dspack：插件组合、依赖、补丁、适配 DSH 版本；自动排除 node_modules / 运行数据 / 凭据 |

| 导入 | 本地 .dspack 或在线市场下载；校验容器与 SHA-256 后落盘，自动重建依赖 |

| 市场 | 浏览 [dsh-pack-market](https://github.com/DSH-PackForge/dsh-pack-market) 索引，按需下载安装 |

| 备注 | 导入时自动写入「适配 DSH 版本」到 Profile 右键备注，便于识别 |

一个 .dspack = 一个 Profile 的配置快照（或整个 DSH_HOME）：

• profile 形态：单个 Profile（可额外携带全局 skill / preset）
• dshhome 形态：多 Profile + 全局 preset / skill / 指令

不含 node_modules、运行数据、凭据、嵌套压缩包 —— 体积小、可安全分享。

---