@dsh-plugins/dsh-llm-hub 1.7.0 → 1.9.0

package/CHANGELOG.md

@@ -2,6 +2,53 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## [1.9.0] - 2026-10-10
+
+### 🚀 下线智能路由配置界面，替换为只读用量/模型展示 Chip，修复可用模型统计 Bug
+
+- **下线智能路由配置界面与切换浮层**：
+  - 移除设置页左侧独立的「路由」配置分区（原 `RoutingCard` / `RoutingSection`，包含分组编辑、主力与兜底模型设定、排序与自动保存）；
+  - 移除输入框左侧原本可点击切换「公司 / 个人」分组和智能开关的 `SmartRouteChip` 浮层菜单；
+  - 替换为只读状态信息位 **`ProviderUsageChip`**，展示当前供应商 · 模型 · 可用数 · 配额 · 用量，点击仅查看只读详情，模型切换统一回归上方主模型下拉。
+- **修复 Hero 看板可用模型数显示为破折号的 Bug 并去重**：
+  - 后端在全量探测状态快照 `baseVerdicts` 中补齐已配可用 provider 的 `modelIds` 与 `modelCount`；
+  - 前端顶部 Hero KPI 卡片在聚合可用模型数时，对所有健康可用供应商下的同名模型做跨供应商 `Set` 去重，解决重复计数并正确渲染真实模型数。
+- **功能与稳定性增强**：
+  - 智能提取实际有余额的币种（避免因 USD:0 导致多币种账户显示为 0）；
+  - DeepSeek 单 Key 模式下提供轮转引导，多 Key 模式下展示实时余额与脱敏状态 chips；
+  - 补回丢失的外部子代理注入调用，恢复本地 Harness（Codex / Claude / Antigravity）自动探测与注册。
+
+## [1.8.0] - 2026-09-29
+
+### 🔧 适配 DSH 0.1.7 的 settings 架构（升级到 0.1.7 后配置读不到的那版）
+
+**症状**：升到 DSH 0.1.7 后，路由组「凭空消失」—— chip 不渲染，设置页路由卡是空的，
+写接口一律拒绝。数据其实好好躺在配置里，只是没人读。
+
+**根因**：0.1.7 把 settings 架构整个换掉了。`settings.register(ns, schema)` 和
+`settings.get(ns)` 双双消失（0.1.5 的 `dsh-settings` 里有 20 处 `register` 引用，
+0.1.7 是 0 处）。老代码里 `settings.register(...)` 抛 `TypeError` 被 catch 吞掉，
+`hubRegistered` 恒为 false，于是整个 `dsh-llm-hub` 段的读写全部短路。
+
+**改造**
+- 导出 `Config`，配置改由 `apply(ctx, config)` 注入（0.1.7 的官方姿势，
+  `@deepseek-ai/dsh-llm-pi-ai` 的 providers 段同款）
+- 读自己的段走 `config.routing.get()`；读**别人**的段（`llm-pi-ai` / `llm-deepseek`）
+  走 `settings.describe()` —— 0.1.7 里那是唯一的跨插件读法
+- 拆掉 `hubRegistered` 守卫（该概念已不存在）
+- 三个字段全部标 `.volatile()`：`settings.update()` 拒绝「没有 volatile 字段的条目」
+  （原话：`Plugin entry "dsh-llm-hub" has no volatile fields`），而 volatile 的语义
+  正是本插件要的 —— 路由组/预警/别名都是每次请求惰性重读的，切一次路由不该重跑 apply
+- `@deepseek-ai/schemastery` 加为 **devDependency**（静态 import 需要它才能加载；
+  运行时依赖仍是零 —— 它由 DSH 宿主提供）
+
+**配置迁移**：0.1.7 启动时把全局 `settings.yaml` 迁进 profile 的 `cordis.patch.yml`
+并把原文件改名为 `settings.yaml.imported`。本插件的段需要一条 `dsh-llm-hub` entry；
+未迁移时该段读为空，也就是上面那个症状。
+
+**验证**：157 个单测 + 门禁全过；真机确认路由组、设置页路由卡、跨插件读（balance 能
+解析出真实 key）、写路径（`routing/select` 200）全部恢复。
+
 ## [1.7.0] - 2026-09-29
 
 ### 🧭 路由设置卡：始终折叠，展开才编辑

package/README.en.md

@@ -30,10 +30,14 @@ On DSH's Models page, the official adapters leave half the job undone. This plug
 > Only Node.js is required — **no global dsh install**; upstream's official entry is `npx @deepseek-ai/dsh`. If dsh is installed globally, use `dsh` instead.
 
 ```sh
-npx @deepseek-ai/dsh plugin --profile web add @dsh-plugins/dsh-llm-hub
+npx @deepseek-ai/dsh plugin --profile <your-profile> add @dsh-plugins/dsh-llm-hub
 ```
 
-Add `@dsh-plugins/dsh-llm-hub` to `dsh.profile.bundles` in `~/.dsh/profiles/web/package.json`, then restart DSH (stop it and rerun `npx @deepseek-ai/dsh web`).
+> **Desktop app users**: the official Electron app owns the `desktop` profile exclusively — the CLI
+> refuses plugin operations on it (`profile "desktop" is managed exclusively by the Electron application`).
+> Install and update from the plugin manager inside the app; the CLI form above is for self-managed profiles.
+
+Add `@dsh-plugins/dsh-llm-hub` to `dsh.profile.bundles` in `~/.dsh/profiles/<your-profile>/package.json`, then restart the DSH desktop app (quit and reopen it).
 Open **Settings → Models** — a new row appears under the provider cards.
 
 <sub>A boot-graph change requires a restart; hot reload won't pick it up. `cordis.patch.yml` is inserted automatically by the bundle mechanism.</sub>

package/README.md

@@ -48,11 +48,10 @@ DSH 的模型页上，官方适配器有一半事情没做。这个插件把它
 > 前提：装好 Node.js 即可，**无需全局安装 dsh** —— 官方入口就是 `npx @deepseek-ai/dsh`。已全局安装的可把它换成 `dsh`。
 
 ```sh
-npx @deepseek-ai/dsh plugin --profile web add @dsh-plugins/dsh-llm-hub
+npx @deepseek-ai/dsh plugin --profile <你的 profile> add @dsh-plugins/dsh-llm-hub
 ```
 
-再把 `@dsh-plugins/dsh-llm-hub` 加进 `~/.dsh/profiles/web/package.json` 的 `dsh.profile.bundles` 数组，
-然后重启 DSH（结束当前进程后重新运行 `npx @deepseek-ai/dsh web`）。打开**设置 → 模型**，provider 卡片下方会多出一行。
+再把 `@dsh-plugins/dsh-llm-hub` 加进该 profile 的 `package.json` 的 `dsh.profile.bundles` 数组，然后重启 DSH。打开**设置 → 模型**，provider 卡片下方会多出一行。
 
 <sub>boot graph 变了必须重启，热载不生效；`cordis.patch.yml` 由 bundle 机制自动 insert。</sub>
 
@@ -84,7 +83,7 @@ npx @deepseek-ai/dsh plugin --profile web add @dsh-plugins/dsh-llm-hub
 升级：
 
 ```sh
-npx @deepseek-ai/dsh plugin --profile web update @dsh-plugins/dsh-llm-hub@^1.5.1
+npx @deepseek-ai/dsh plugin --profile <你的 profile> update @dsh-plugins/dsh-llm-hub@^1.5.1
 # 重启 DSH
 ```
 
@@ -499,12 +498,18 @@ publish。Release 的存在性单独探测，所以「npm 发成功但 Release
   <a href="https://github.com/webkubor/dsh-env-inspector">🖥️ 电脑环境</a>
 </p>
 
-一行装齐（只需 Node.js），装完重启 DSH 即可：
+一行装齐（只需 Node.js），装完重启 DSH 即可。**把 `PROFILE` 换成你自己的 profile 名**：
 
 ```bash
-npx -y @deepseek-ai/dsh plugin --profile web add dsh-bloom-theme @dsh-plugins/dsh-llm-hub @dsh-plugins/dsh-user-mirror @dsh-plugins/dsh-env-inspector && node -e 'const f=(process.env.DSH_HOME||require("os").homedir()+"/.dsh")+"/profiles/web/package.json",p=require(f),b=p.dsh.profile.bundles;for(const n of Object.keys(p.dependencies))if(/^(dsh-bloom-theme|@dsh-plugins\/)/.test(n)&&!b.includes(n))b.push(n);require("fs").writeFileSync(f,JSON.stringify(p,null,2)+"\n")'
+PROFILE=<你的 profile>
+npx -y @deepseek-ai/dsh plugin --profile "$PROFILE" add dsh-bloom-theme @dsh-plugins/dsh-llm-hub @dsh-plugins/dsh-user-mirror @dsh-plugins/dsh-env-inspector && PROFILE="$PROFILE" node -e 'const f=(process.env.DSH_HOME||require("os").homedir()+"/.dsh")+"/profiles/"+process.env.PROFILE+"/package.json",p=require(f),b=p.dsh.profile.bundles;for(const n of Object.keys(p.dependencies))if(/^(dsh-bloom-theme|@dsh-plugins\/)/.test(n)&&!b.includes(n))b.push(n);require("fs").writeFileSync(f,JSON.stringify(p,null,2)+"\n")'
 ```
 
+> **桌面端用户**：官方 Electron 端独占 `desktop` profile，命令行对它做插件操作会被拒
+> （`profile "desktop" is managed exclusively by the Electron application`）——
+> 请在应用内的**插件管理**里安装与升级。下面的 CLI 写法只适用于自建 profile。
+
+
 ---
 
 ## License