返回目錄

dsh-model-pro

精選清單收錄維護狀態: 活躍

wqy8593521/dsh-model-pro

Model Pro:面向 llm-pi-ai 提供商的模型生命週期管理外掛。

前往 GitHub
$ dsh plugin add dsh-model-pro

安裝

dsh 沒有統一的安裝指令 —— 把該外掛 README 中的設定行加入你的 profile / patch 設定,然後重啟即可。

查看安裝教學

8

星數

1

Fork

TypeScript

語言

MIT

授權條款

2026-08-18

建立於

2026-11-04

最近推送

README

dsh-model-pro · 模型 Pro

npm version License: MIT

面向 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

在 GitHub 閱讀完整 README →

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。