dsh-model-pro
キュレーションリスト掲載メンテナンス: 活発wqy8593521/dsh-model-pro
llm-pi-ai プロバイダーのライフサイクル管理を行う DSH プラグイン Model Pro。
$ dsh plugin add dsh-model-pro8
スター
1
フォーク
TypeScript
言語
MIT
ライセンス
2026-08-18
作成日
2026-11-04
最終プッシュ
README
dsh-model-pro · 模型 Pro
面向 DeepSeek Harness (DSH) 的动态 Cordis 插件,在设置页新增一个「模型 Pro」入口,为 llm-pi-ai 提供商提供全生命周期管理 UI:新建 / 编辑 / 删除、启用 / 禁用、拉取远端模型、连通性测试、智能路由、组合提供商、观测与探活——并在卸载时保证模型数据零丢失。
中文文档 · 界面内置中英双语(跟随 DSH 语言设置自动切换)。
✨ 功能特性(Features)
提供商管理
- 提供商 CRUD — 新建(引导式 3 步向导)、编辑、删除,卡片式列表带状态色条(绿=启用 / 琥珀=禁用)。新建时会校验
route是否与已安装的内置提供商重名并明确拒绝——否则同名档案会在llm-pi-ai里逐项覆盖内置端点,而原生模型页看起来一切正常,用户无从察觉。 - 启用 / 禁用 — 一键切换。被禁用的提供商会移出
llm-pi-ai.providers(因此从模型选择器中消失),完整档案寄存在本插件自有分区,配置一字不丢。 - 字段编辑 — 逐项编辑
baseURL、api协议、apiKeyEnv、displayName(概览页附「就绪检查」清单)。编辑器为宽屏版式(最大 1200px):头部与四个标签合成一张吸顶卡片,长route名自动折行;进入编辑器或切换标签会把设置页滚动复位,「返回列表」时恢复原来的列表位置;「模型」页的当前模型表格跟随整页滚动(无内部小滚动条),远端发现列表保持紧凑独立滚动。 - 自定义请求头 — 按提供商增删改 HTTP 请求头(
authorization/api-key由适配器自动填充,无需手填)。
密钥与凭据
- 加密存储 — 在 GUI 中直接粘贴 API Key,以 AES-256-GCM 加密写入配置(配置文件只存密文),同时写入 DSH 凭据服务供请求时解析。
- 按需解密查看 — 默认掩码显示,点「显示已存」可解密查看;加密主密钥存于凭据服务且永不重新生成,卸载重装后旧密文仍可解密。
模型
- 远端模型发现 — 一键
GET /models拉取,支持全选 / 取消全选 / 反选。 - 批量写入模型 — 将选中模型「替换」或「合并」进提供商的显式模型列表。
- 本地转发名映射 — 为某个模型设置「转发名」,选它时实际向 provider 发送映射后的模型名。
- 模型配置:行内只有一个入口,字段全部展开到下方 — 当前模型表 4 列(勾选 / ID / 显示名 / 模型配置),行内不渲染任何控件,只有一个「配置」按钮;点开后在该行下方逐字段排开:
输入能力(徽标 + 来源说明 + 3 选下拉)、转发名、思考等级(摘要 + 「编辑档位」)。这样无论某个模型的档位名(off · minimal · low · medium · high · xhigh · max)多长、"来源未确认"这类说明多长,都不会把表格撑宽 —— 一个字段一行、label 固定窄列、控件自适应并可换行,表格永不出现横向滚动条。展开面板本身也会二次折叠:档位编辑器只在点「编辑档位」后才出现,每档一格(勾选 + 档名 + 自适应 wire 输入),换行而不是加宽。一次只展开一行。 - 大列表按页渲染 — 一个提供商可能有几百个模型,整表一次性渲染会让「进入模型编辑」明显卡顿。现在默认只渲染前 40 行,其余由「显示更多(还有 n 个)」按需加载;用搜索缩小范围时窗口自动回到第一页。同一次改造也让 Host 侧从「每个模型读一次设置」变成整份列表读一次(0.2 上每次设置读取都是一次全文档投影),这是入页延迟的真正来源。
- 隐藏 / 显示模型 — 把暂时不用的模型从对话的模型选择器里收起来,而不是从配置里删掉:条目(含手填的推理档位
reasoningEfforts、兼容设置compat、转发名与手填上下文 / 输出上限)连同它的能力来源记录一起完整寄存在插件自有分区,「显示」时按原位置原样放回,来源不会被误判成手工锁定。与「删除选中」的区别只有数据去向:隐藏可逆,删除不可逆。三条护栏:不能隐藏最后一个可见模型(llm-pi-ai要求每条 route 至少有一个模型条目)、被智能路由引用的模型要先解除引用、当前默认模型要先切换走。解释与确认只出现一次:第一次隐藏会说明「隐藏 ≠ 删除」并请确认,此后静默执行(偏好存在插件自有分区,跟着配置走);当没有任何隐藏条目时,整块隐藏区不再占位。
连通性测试
- 真实连通性测试 —「测试」页对选定模型发起一次极小的真实推理,走完整凭据 / 请求头 / 协议链路,返回延迟、停止原因与回复内容,用来在依赖之前确认模型确实可用。
智能路由与组合
- 智能路由 — 命名路由(如
auto)聚合多个 provider 的模型,支持 5 种策略:priority(顺序优先+回退)/weighted(按权重随机)/round-robin(平滑加权轮询)/min-latency(历史低延迟优先)/sticky(会话粘滞)。可设每目标权重、启用开关、healthAware、会话粘滞、maxFallbacks、单目标超时。在模型选择器里选「router / 路由名」即用。 - 无感切换(真实回退) — 首选目标不可达时自动换下一个目标:回退判定基于「首个内容块是否真正产出」,连接拒绝、HTTP 错误、空响应、超时(
timeoutMs)都会在任何内容到达对话之前完成切换,对话无感知、不中断;调用方主动中止永不重试。回退成功的请求在观测台标记为fallback。 - 组合提供商 — 把多个 provider 的模型合并成一个虚拟 provider,支持并集 / 交集两种模式(模型选择器中显示为
composite / 组合名::模型);交集非常适合同款模型多上游互备。
观测与健康
- 探活(Probe) — 对每个目标(
provider + model)发起真实最小请求,标记 up / down / probing 与连续失败次数;健康感知分发会自动跳过 down 的目标(可按路由关闭)。 - 观测台 — 会话内请求日志(路由 → 目标、状态、思考档位、延迟、token)与聚合统计(按路由 / 按目标:调用次数、成功率、平均延迟、token 合计),以统计卡与表格呈现。
- 思考档位留痕 — 路由对外声明的是所有目标档位的并集,所以选
max时若实际服务的目标只支持到high,请求会成功但自动降档。观测台日志的「思考档位」列会标出max → high(目标完全不支持时标max → 未下发),对话徽章上同步显示max→high,避免「选了高档位却拿到低档位答案」无从察觉。 - 对话提供商徽章(可开关) — 开启后,每个回合完成时会在其下方显示智能路由 / 组合实际选中并服务该回合的目标(
provider/model),发生自动切换时标注「已无感切换」;在「智能路由 → 观测台」用「对话下方显示实际提供商」开关控制,偏好持久化保存。
卸载安全(零数据丢失)
- 卸载不丢数据 — 当本插件被卸载或禁用时,会自动把自有分区里寄存的每个提供商原样还原回
providers,避免模型配置滞留在只有本插件认识的存储中。详见下文工作原理。
📸 截图(Screenshots)
截图文件放在
docs/screenshots/目录下。首次使用请自行截图后替换以下占位图。
| 页面 | 说明 |
|---|---|
![]() |
仪表盘:全部 / 已启用 / 已禁用分段(带计数)、引导式 3 步新建向导、状态色条卡片 |
![]() |
编辑器:概览(字段 + 就绪检查)/ 请求头 / 模型 / 测试 四个标签页;头部+标签为吸顶卡片,模型表格跟随整页滚动 |
![]() |
模型发现:拉取远端模型,支持全选 / 反选与批量写入 |
![]() |
连通性测试:对单个模型跑真实推理,显示延迟与回复 |
![]() |
智能路由:路由台 / 组合提供商 / 观测台 / 探活 四个子页 |
📦 安装教程(Installation)
DSH 的插件管理命令会转发给
pnpm,并要求用--profile <name>指定目标 Profile(Web GUI 通常是web)。
方式一:从 npm 安装(推荐,预构建、无需构建脚本)
dsh plugin --profile web add npm:dsh-model-pro
务必带
npm:前缀。 registry 上的包已预置dist/,安装时不会触发构建脚本。 若省略前缀写成add dsh-model-pro,pnpm 可能把它解析为 git 源,进而执行prepare构建脚本,被 pnpm 10 的安全策略拦截并报ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED。
方式二:从 GitHub 源安装(需允许构建脚本)
git 源不含预构建的 dist/,安装时靠 prepare 现场构建。pnpm 10 默认禁止 git 依赖
执行构建脚本,因此需先在 ~/.dsh/profiles/web/pnpm-workspace.yaml 的 allowBuilds
下加入 dsh-model-pro: true,再执行:
dsh plugin --profile web add wqy8593521/dsh-model-pro
安装后重新打开(或刷新)DSH Web GUI,左侧「设置」中即出现「模型 Pro」入口。
方式三:从源码构建
git clone https://github.com/wqy8593521/dsh-model-pro.git
cd dsh-model-pro
npm install
npm run build # 输出 dist/host.js + dist/client.js
npm test # 运行冒烟测试(可选)
方式四:本地开发联调(软链安装,不发版)
在插件仓库根目录一键把本工作区软链进 Profile(等价于 dsh plugin --profile web add link:<本目录>,不拷贝、不触发 prepare 构建脚本,不受 pnpm 10 allowBuilds 限制):
npm run install:local # 构建 + 软链安装到 ~/.dsh/profiles/web
npm run install:local -- --profile dev # 指定其他 Profile
npm run install:local -- --no-build # dist 已是最新时跳过构建
之后的迭代循环:改代码 → npm run build → 重启 dsh / 刷新 Web GUI。回退 registry 版本:
dsh plugin --profile web remove dsh-model-pro && dsh plugin --profile web add npm:dsh-model-pro
本插件以静态 bundle 形态分发(Host 半为 ESM
apply导出,Client 半为window.__ModuleLoader__.load工厂),必须通过dsh plugin add安装; 它不提供旧版动态插件(cordis_define/cordis_run)的加载形态。
🗑️ 卸载教程(Uninstall)
dsh plugin --profile web remove dsh-model-pro
連携・共有 の他のプラグイン
dsh-notification
by omdsh-dev
DeepSeek Harness ターン完了のデスクトップ通知。結果別制御とキーワード include/exclude
dsh-lark-bot
by plutokeating
dsh-lark-bot:Feishu/Lark 桥接。流式カード、ワークスペース、並行タスク、多役 Agent、跨セッション通知、安全网
dsh-session-notification
by dingyi222666
セッション完了など4種の状態変化をブラウザ通知とカスタム通知音で知らせる dsh プラグイン
dsh-chatgpt-web
by wlv-zedd
標準のChatGPT WebをDeepSeek Harnessへ直接接続するChatGPT Freeブリッジです。





