前言¶
DSH 生态强调“一切皆插件”。在实际使用 DeepSeek Harness Web profile 时，第三方插件通常会通过 dsh plugin 安装到某个 profile。插件装好后，如果只是想临时开启或关闭它，手动维护 cordis.patch.yml 并不方便。
下面介绍 HamSamMike/dsh-mod-manager。它是一个面向 DeepSeek Harness Web profile 的第三方插件管理器，用于在设置页集中启用或禁用已安装的插件。
这是什么¶
dsh-mod-manager 是一个第三方插件管理器。它的核心职责是发现、启用与禁用第三方插件，不会替你安装或卸载其它插件。
它面向 DeepSeek Harness Web profile，在 Harness 设置页中集中显示已安装插件的状态，并支持通过页面开关插件。修改后通常通过 Harness patch watcher 热更新，通常无需重启 dsh web。
项目许可证为 MIT。
核心功能¶
dsh-mod-manager 提供以下已核实的能力：
- 在 Harness 设置页集中显示第三方插件状态。
- 自动发现通过
dsh plugin --profile … add …安装到 profile 的第三方 bundle。 - 一键启用或禁用插件，无需卸载插件包。
- 修改后通过 Harness patch watcher 热更新，通常无需重启
dsh web。 - 自动排除 Harness 核心 bundle 和管理器自身。
- 保留
config.mods，用于自定义名称或补充无法自动关联的插件行。 - 保留
cordis.patch.yml中与受管插件无关的用户配置。 - 兼容空文件、纯注释文件和
[]空补丁数组。
安装与启用¶
先确认环境：
- 目标环境是 DeepSeek Harness Web profile。
- Node.js 版本为
^22.19.0或>=24.0.0。 peerDependencies包含@deepseek-ai/cordis ^4.0.1与react ^18.2.0。- 需要管理的第三方插件已经安装到同一个 profile。
从 GitHub 安装：
dsh plugin --profile web add github:HamSamMike/dsh-mod-manager
安装完成后重启一次 Harness：
dsh web
也可以检查插件是否已经进入最终组合配置：
dsh --profile web --dump-config
典型用法¶
以一个第三方插件 dsh-pet 为例，先把它安装到同一个 profile：
dsh plugin --profile web add dsh-pet
新安装 bundle 后需要重启一次 dsh web，它才会进入 Loader，之后便会自动出现在管理器中。
打开 http://localhost:3080，进入 设置 → 模组管理，点击目标插件右侧的 开启 或 关闭。
经过上面的步骤，页面切换会通过 Harness patch watcher 热更新，通常无需再次重启 dsh web。
自动发现与配置¶
管理器会自动发现通过 dsh plugin --profile … add … 安装到 profile 的第三方 bundle。
它会自动排除 Harness 核心 bundle 和管理器自身，同时保留 cordis.patch.yml 中与受管插件无关的用户配置。
如果插件无法被自动关联，或者需要自定义名称，可以保留 config.mods。config.mods 用于自定义名称，或补充无法自动关联的插件行。
切换接口只接受当前自动发现或 config.mods 明确登记的 Loader 行 ID。
也可以在目标 profile 自己的 cordis.patch.yml 中覆盖管理器配置，而不修改本仓库。
重启边界¶
修改管理器自身配置或安装新的 bundle 后，需要重启一次 dsh web。之后通过页面启用或禁用插件时，不需要重启。
新安装 bundle 后需要重启一次 dsh web 才会进入 Loader；之后便会自动出现在管理器中。
安全边界¶
- 只读写目标 profile 的
cordis.patch.yml。 - 自动发现范围只来自目标 profile 明确登记的
dsh.profile.bundles，不会扫描任意node_modules。 - 不扫描插件目录，不修改插件源码，也不删除已安装的插件包。
- 兼容空文件、纯注释文件和
[]空补丁数组。
适用场景与注意¶
适合已经在 DeepSeek Harness Web profile 中使用第三方插件、希望减少手动编辑 cordis.patch.yml 的开发者。
由于插件以当前 dsh 进程权限运行，安装前应先检查源码与许可证。项目许可证为 MIT。
链接¶
GitHub：https://github.com/HamSamMike/dsh-mod-manager
目录页（来自项目线索）：https://www.skillhub.cn/plugins/HamSamMike/dsh-mod-manager
社区目录为独立站点，并非官方应用商店。
