前言¶
在 DeepSeek Harness（DSH）里管理多个自定义模型 API 时，常见做法是按供应商各配一套密钥，或在同一路由下手工切换凭据。供应商一多、同一端点下又有多把密钥时，设置页和会话里的模型菜单容易变平、难找，也不便区分「同一模型 ID、不同密钥」该用哪一份配置。
下面介绍社区插件 dsh-model-groups（维护者 betsunninda9-lgtm，分类：模型推理）。它在 DSH 0.2.2-rc.1 网页端提供「供应商 → 密钥配置 → 模型」的分层选择与多密钥配置，并包含经校验的宿主兼容补丁，不改变你已有的供应商、密钥与会话数据本身。
这是什么¶
dsh-model-groups 是面向 DSH 网页界面的模型选择器插件：同一供应商共用 Provider ID、API 地址和协议；各份「密钥配置」分别设置名称、密钥与模型列表。选择模型时按你手动点选的那份配置使用对应密钥，不自动轮换密钥，也不自动切到其他配置。
- 仓库：GitHub — betsunninda9-lgtm/dsh-model-groups
- 目录页：SkillHub 插件页
- 许可证：MIT（含改编自 DeepSeek Harness 的代码，保留原版权声明）
- 当前 npm 正式版：0.3.4（
engines.dsh要求 0.2.2-rc.1；Node.js ≥ 22）
在 dsh-go 场景下，能力体现在对应网页上，不替换 App 内原生模型菜单。
核心功能¶
资料中可核对的能力如下。
- 分层浏览与选择：按「供应商 → 密钥配置 → 模型」展开；支持原地折叠、侧边面板、名称搜索、全部展开与收起；会记住各级折叠状态，搜索时临时展开匹配项。
- 多密钥与相同模型 ID：不同密钥配置可使用相同模型 ID；会话里选中某配置下的模型时，使用那份配置的密钥。
- 手动选配置：不自动轮换密钥，不自动合并供应商或迁移旧会话选择；已有单密钥配置与旧会话选择会保留。
- 宿主补丁：加载时检查并备份原文件，自动应用五项补丁；版本或文件内容不受支持时停止应用、不强制覆盖；不修改现有供应商、密钥或会话配置。
- 设置侧多密钥：在 设置 → 模型 中可为自定义 API 开启 多密钥配置（依赖补丁生效后的网页界面）。
关闭多密钥会保留已保存的配置与凭据；删除配置不会同时删除凭据。有未保存的密钥输入时，需先保存或清空才能确认关闭。
安装与启用¶
插件在目标设备的 DSH 环境中安装。web 为 dsh-go 本机常用 profile，其他环境请换成实际 profile。安装包见 npm 与 GitHub v0.3.4 发布页。
在 DSH 环境中执行（命令来自仓库 README）：
dsh plugin --profile web add dsh-model-groups@0.3.4 --registry=https://registry.npmjs.org/
经过上面的步骤后：
- 等待插件加载并出现「补丁已自动安装」类提示。
- 保存草稿，重启原 DSH 引擎并刷新网页（无需先停引擎，也无需在外部终端手工打补丁）。
- 若本次启动才刚应用补丁，可能需再重启一次以载入新模块；补丁已在磁盘就绪时，后续加载不会重复写入。
插件以当前 DSH 进程权限运行；安装前应自行查看源码与 MIT 许可证，并确认 DSH 安装目录可写、目标程序文件版本与哈希在支持范围内。
没有出现 多密钥配置 开关时，先确认已在自动补丁后重启引擎并刷新网页。仍异常时，可在已安装插件目录执行（将 /opt/dsh 换成实际 DSH 根目录）：
node scripts/doctor.mjs --dsh-root /opt/dsh --json
五项相关文件应为 patched。该命令只读检查程序文件，不读取密钥。
典型用法¶
- 打开 设置 → 模型，新增或编辑自定义模型 API。
- 填写供应商公共的 Provider ID、API 地址和协议。
- 开启 多密钥配置，为每份配置填写名称、密钥和模型列表，点击「应用」。
- 在会话模型菜单中展开供应商和配置，选择需要的模型。
菜单结构示意（来自 README）：
示例供应商 A
配置 A
示例模型
配置 B
示例模型
示例供应商 B
示例模型
开启多密钥后，在模型菜单里手动选新配置即可；插件不会自动把已有供应商合并或改写旧会话里的选择。
适用场景与注意¶
适合：同一供应商下有多把 API 密钥、希望按「配置名」区分用量或环境；需要在网页模型菜单里快速折叠/搜索大量供应商与模型；已固定使用 DSH 0.2.2-rc.1 网页端（或兼容该插件声明的宿主版本）。
注意：
- DSH 大版本升级前请核对插件兼容范围；不支持的新文件会被拒绝，需等待适配，不能强制套用旧补丁。
- 卸载插件 不会 自动还原宿主补丁或删除凭据。完整还原前需将会话切回普通单密钥模型，关闭多密钥并清理原版不支持的
multiKey、keyEntries等字段（保留仍要用的凭据），再在保留的插件包目录执行还原脚本（详见 README「卸载与还原」）。 - 窄屏侧边面板会按可用宽度调整；三级并列时较长名称可能被截断。
- 社区目录（如 SkillHub）与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，本文事实以 GitHub README 与 npm 包元数据为准。
更新时使用对应发布版本的安装命令 reinstall，再按加载日志重启引擎并刷新网页；兼容补丁未变化时不会重复应用。
结尾¶
dsh-model-groups 把网页端的模型选择做成可折叠的三级结构，并把多密钥留在「手动选配置」的粒度上，适合多供应商、多密钥并行维护的场景。安装与行为以官方 README 为准。
