DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

xfjsssq /

xfjsssq/dsh-model-hub

Verified

DeepSeek Harness 模型中心插件 — 双栏模型选择器(左提供商 / 右模型)+ 悬浮能力卡,可直接在面板里添加提供商、刷新获取模型、删除模型;零构建、零 npm 依赖。

★ 1 Stars0 Forks1 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@a7490cd3

dsh-model-hub

把 DeepSeek Harness 聊天界面的模型选择器从「一长串扁平列表」换成 双栏模型中心:

  • 左栏 = 提供商(可拖拽排序、可置顶,顺序持久化;只显示有模型的,未配置的收进折叠区)
  • 右栏 = 模型列表(打开时显示所选提供商的模型;输入查询后跨全部提供商搜索,结果按提供商分组)
  • 鼠标悬停模型行 → 浮出能力卡,可当场改:上下文档位(128K / 256K / 1M)、输出档位(128K / 256K)、视觉开关、思考档位
  • 所有改动真实写入模型配置并在运行时校验生效;点选模型 = 真正切换会话模型(与内置 /model 共用同一份会话目录)

适配版本:DSH 桌面版 0.2.1-rc.2 及 2026-10-29 构建(index-BXV-oxvX.js)(2026-11-04 实测,见下方「验证」)。

安装

方式一:官方 CLI / GUI(推荐)

# 本地目录(开发)
dsh plugin --profile desktop add "<本目录绝对路径>"

# 从 GitHub(分发)
dsh plugin --profile desktop add github:<账号>/dsh-model-hub
dsh plugin --profile desktop add github:xfjsssq/dsh-model-hub

dsh 不在 PATH 时用安装目录里的 CLI,或直接走 GUI:

& "<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add <spec>
# GUI:侧边栏「插件」→ 添加插件 → 粘贴包名 / Git 地址 / 压缩包 / 本地绝对路径

方式二:可审计脚本(本仓库 tools/)

pwsh -File tools\install.ps1 -DryRun   # 先看将要改什么(只预览,不写)
pwsh -File tools\install.ps1           # 安装:备份 → 改两处 → pnpm install → 回读校验
pwsh -File tools\uninstall.ps1         # 卸载(-DisableOnly 只关不卸)

脚本自带越界拒绝:JSON diff 只允许落在 dependencies.<包名> 与 dsh.profile.bundles,其它键变了就拒绝写;卸载后 cordis.patch.yml 与 package.json 逐字节复原(沙箱往返 27/27 已验证)。

装完之后怎么生效(重要)

场景 需要做什么
宿主侧 API(/model-hub/api/*) 安装即生效,不需要重启(实测:路由 404 → 200,正在运行的宿主直接激活)
客户端 UI(composer 上的模型位) 刷新页面一次(桌面端 Ctrl+R)—— 页面的启动清单在加载时生成,刷新才会带上新插件
插件自身的宿主代码更新(升级版本后) 需要重启 DSH(没有 HMR 时,Node 模块不会热重载);客户端半边刷新页面即可

关掉插件而不用卸载:把 dsh-model-hub/cordis.patch.yml 里的 enabled 改成 false —— 宿主 API 停用、客户端条目不再注册,内置模型选择器原样恢复(无 CSS/DOM 残留)。

更新日志

v0.2.1(2026-11-07)

  • 修掉「重启后模型中心莫名消失」:元凶是别的插件(实测 ds-bot 0.2.0)也把 conversation.input.model 注册在 -100,渲染一个空组件,把模型位「藏起来」。此前本插件的幂等保护把它误判成"自己重复求值",于是静默让位 → 界面消失且没有任何提示。
  • 现在的解析规则:① 已有自己的条目(options.__dshModelHub)→ 本页重复求值,静默让位;② -100 被别人占 → 自动降到最近的空位(-101…-140)并在左下角给一行淡提示,/health 记 slot-register-shifted(带 from / to / occupant);③ 无冲突 → 照旧用 -100 遮蔽内置。
  • 新增 clientState.stage 取值 slot-register-shifted(良性),README 的判读表已收录。

v0.2.0(2026-11-04)

  • 「获取模型」改为合并语义:已有模型不会被一次"获取"覆盖清掉,只有手点模型行的叉号才会移除;已在列表的候选默认勾选且置灰、标「已在列表」;确定后提示「新增 N,保留 M」。
  • 提供商可直接编辑:悬停左栏提供商行,正左侧浮出编辑面板,可改名称 / 显示 ID(支持改名)/ API 协议 / Base URL / Key 环境变量名;改名会联动更新排序、置顶与能力覆盖记录。
  • 置顶更醒目:置顶行独立底色 + 常驻加粗竖条 + 图钉常驻。
  • 修复重复注册:同一页面里插件被求值两次时不再报错(先前会弹出诊断红框),现静默让位并在 /health 里记 slot-register-skipped。
  • 档位标签 1000K → 1M(只改显示,写入值不变:131072 / 262144 / 1000000)。
  • 获取模型页与面板背景改为不透明,密集列表更易读。
  • 在面板内直接管理提供商与模型:添加提供商(全屏表单)、获取可用模型、勾选落盘、单模型删除。
  • 能力卡补齐设置页同款字段:输入类型(文本 / 图片)、推理等级(关 / 低 / 中 / 高)、异常值警示。
  • 选择器改为贴输入栏的浮层(去掉全屏遮罩),能力卡缩小并在鼠标停稳后钉住。
  • issue #1 修复:失败可见(标题 + 可关闭红框)+ /health 自检口 + 去掉对内置模型选择器的隐性依赖。

v0.1.0(2026-10-23)

  • 双栏模型中心(左提供商 / 右模型)、悬浮能力卡、跨提供商搜索。

使用

操作 结果
点击 composer 上的模型位 打开模型中心
左栏点击 / ← → 切换提供商
搜索框输入 跨全部提供商按模型名/ID 模糊匹配,结果按提供商分组;清空后回到所选提供商
↑ ↓ + Enter 键盘选模型(焦点留在搜索框)
悬停模型行 120ms 浮出能力卡
能力卡点档位 / 开关 写入模型配置 → 回读运行时确认 → 立即生效;对不上会显示 NOT_EFFECTIVE 并回滚
能力卡点思考档位 提交会话级 reasoningEffort;若不是当前模型,一次点击同时切换该模型并应用档位(卡片有提示)
左栏拖拽 / 右键或行尾图钉 调整提供商顺序 / 置顶,立即持久化

数据与文件

  • 偏好:~/.dsh/model-hub/prefs.json(提供商顺序、置顶、能力覆盖记录)
  • 模型能力真正落在:profile 的 cordis.patch.yml → llm-pi-ai.providers.<提供商>.models[](与设置页「模型」同一处)

架构

dsh-model-hub/
  index.js                 宿主侧 cordis 插件入口(inject: webServer / llm)
  lib/host/                catalog / settings-bridge / apply / selftest / prefs / routes
  client.js                浏览器侧 bundle(classic script,零构建,仅用 react/react-dom)
  cordis.patch.yml         组合声明(enabled 开关)
  docs/design-spec.md      审美与交互规格(含 v1.1 修订)
  test/host.test.mjs       零依赖桩宿主测试

宿主侧 HTTP API(同源 JSON;写接口要求 Content-Type: application/json):

方法 路径 用途
GET /model-hub/api/health 诊断(hasLlm / hasSettings / 端口)
GET /model-hub/api/catalog 提供商 + 模型 + 元数据(上下文/输出/视觉/思考档位/是否有凭证)
GET/POST /model-hub/api/prefs 提供商顺序、置顶
POST /model-hub/api/model 写能力 {provider, model, patch:{contextWindow?, maxTokens?, vision?}} → 返回 effective / verify / prepared
POST /model-hub/api/selftest 改前/改后对比(含 prepareCall 物化结果与可选还原),用于验证「真生效」

验证(2026-11-04,独立 teammate 用隔离实例 + 真宿主 + 真浏览器实测)

发布构建:client.js 199629 bytes / 3884 行 / sha256 27fa088bf78185015f3e19c7f0688f6d533240c76e4403bdaee4fad5c1b30780 七轮独立验证是在功能等价的上一版构建上跑的;最后两处视觉微调之后另核了 node --check、node --test(105/105)与沙盘探针(能力卡 200×247 不透明、面板「显示 ID」/「API 协议」定位、控制台 0 错误),未再重跑整轮。原始报告与截图属开发期产物,不随仓库发布。

  • 不需要重启即激活:真宿主 /model-hub/api/* 由 404 → 200;profile 只多出 dependencies 一项与 bundles 末尾一项,cordis.patch.yml sha256 未变。
  • 改动真进请求:POST /model 后 prepareCall 物化结果随之改变(maxTokens 128000→65536、contextWindow 1000000→131072、inputModalities ['text','image']→['text']),且一次真实对话请求的 body 里确实带了新值(本机 mock 上游收到 max_completion_tokens=65536,零上游费用)。
  • 可还原:selftest 临时改写后 cordis.patch.yml 逐字节复原(sha256 前后相同)。
    • 例外:sha256 逐字节比对只适用于「补丁仅修改已有字段」。若补丁 unset 了已有键(reasoningEfforts: null,或去掉 image 导致 imagePixelBudget/imageMaxBytes 被删),还原时该键只能重新追加到对象末尾,键序变化会让 sha256 变化,但配置语义等价 —— 此时请改用解析后深比较(键集合 + 值)。
  • 界面:真实 GUI 里打开弹窗、provider 切换、搜索、悬停能力卡、改档位写穿、选中模型并发送成功;P0(客户端组件挂载即崩)经 A/B 归因 → 修复 → 同一套探针复验通过。
  • 降级保证:客户端注册/渲染失败时,内置模型选择器自动接管(实测确认没有白屏)。

测试

cd dsh-model-hub
node --check index.js
node --test        # 105 项:catalog / 写入 / NOT_EFFECTIVE / prepareCall 一致性 / selftest 还原 / 路由 / prefs / inputModalities / reasoningEfforts / provider edit·rename / 合并语义 / 重复注册幂等

已知限制

  • /model 斜杠命令的弹窗仍是内置 UI(新 UI 只接管 composer 上的模型位)。
  • 思考档位是会话级选择(DSH 的 ModelSelection.reasoningEffort),不是模型配置字段;模型未公布档位时不显示该行。
  • 给「上游其实不支持视觉」的模型强制打开视觉,会在请求时由上游报错 —— 卡片有一行警告,风险自负。
  • 提供商排序/置顶存在 prefs.json;能力值不在插件侧缓存,每次打开弹窗重新拉取。
  • 升级插件版本后,宿主侧代码需要重启 DSH 才更新。
  • 不支持 pi-ai 的 reasoningEfforts: false(该取值表示「该模型不推理」):传入会得到 INVALID_REASONING_EFFECTS。要表达这个语义请传 null 删除该字段。这与设置页行为一致(设置页同样把 false 视为未声明)。

安装后验证清单(Windows 桌面版实测,逐步对照)

按顺序做;每步都写清"应该看到什么"。哪一步不对,先用下面的自检口定位,再报障。

# 做什么 应该看到什么
1 dsh plugin --profile desktop add <包名 / Git 地址 / 本地路径>(或 GUI:侧边栏「插件」→ 添加插件) 命令成功;profile 的 package.json 出现 dependencies.dsh-model-hub,dsh.profile.bundles 末尾多一项
2 重启 DSH 桌面端(第一次安装尤其需要:宿主侧插件要重新装载组合) 浏览器打开 http://127.0.0.1:<GUI 端口>/model-hub/api/health → 200,且 hasLlm:true、hasSettings:true
3 硬刷新页面(Ctrl+Shift+R,普通刷新可能命中缓存) 输入框右下角的模型位变成带图标的按钮;点它打开双栏面板(左提供商 / 右模型)
4 悬停任意模型行 约 120ms 后浮出 200px 的能力卡(上下文 / 输出 / 输入类型 / 推理等级)

为什么第一次安装通常要重启:桌面端没有 HMR,插件升级后 lib/host/* 不会热重载。客户端那半只需刷新页面,宿主那半需要重启 —— 这两件事看起来一样,但不一样。

自检口:界面不出来时怎么一句话说清

不需要打开 DevTools。 插件会把浏览器侧的进展上报给宿主,直接在浏览器里打开:

http://127.0.0.1:<GUI 端口>/model-hub/api/health

关注四个字段:pluginVersion(磁盘上的版本)、clientVersion(浏览器里实际跑的那一版)、clientState(浏览器侧跑到哪一步)、clientStateAgeMs。

clientState.stage 含义 / 下一步
空(null) 客户端根本没加载(或浏览器里是早于本机制的旧版本)—— 检查是否硬刷新过、包里 client.js 是否被下发
bundle-loaded 加载了,但 apply 没跑(卡在服务等待)
waiting-services 卡住了 → 看 clientState.missing 里缺哪个服务
slot-register-failed / apply-failed / build-failed 抛错了 → 看 clientState.error;页面上也会有可关闭的红框与标题提示
slot-register-skipped 同一页面里这份 bundle 被求值了两次,已有一份在跑 → 良性,不用处理
slot-register-shifted -100 被别的插件占了(例如 ds-bot 也抢 conversation.input.model),已自动改用 -101…-140 → 功能正常,clientState 里带 from / to / occupant
apply-ok / slot-registered 客户端侧是健康的 → 问题不在这里

另外两条:clientVersion 为 null 但 stage 有值 → 浏览器跑的是更早的构建;clientVersion ≠ pluginVersion → 浏览器与磁盘不是同一版(该刷新或该重启)。

失败时页面上还会直接显示:document.title 带 [模型中心 <阶段>],左下角一个可关闭的红框(阶段 + 构建标签 + 错误摘要 + 前 4 行栈)。成功时不显示任何东西。

License

MIT

—/ 5

No ratings yet

Verified DSH bundle

Commit a7490cd36772

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout