@dsh-plugins/dsh-llm-hub 1.5.0 → 1.5.2

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## [1.5.2] - 2026-09-26
+
+### 🔧 发版门禁 + README 推广区
+
+- **`prepublishOnly` 门禁脚本** `scripts/prepublish-gate.mjs`：
+  在 `npm publish` 之前跑三条硬契约 —— tarball 必含 `package.json` / `cordis.patch.yml` /
+  `lib/*.js` / `README.md` / `LICENSE`、必含 `assets/*.svg`、CHANGELOG 顶部必含
+  `## [<当前 version>]` 段。任一条挂了 → `exit 1` → publish 整体失败。
+  跑 check + test + 门禁三件套，缺一不可。
+- **README 新增「最新发布」区**：进 README 30 秒内看到 1.5.1 的三件用户事 + 三张 SVG 缩略图 +
+  npm / GitHub Release / 完整 CHANGELOG 三个直链 + 升级命令 + 破坏性变更说明。
+- **README 双语同步**：英文版 `README.en.md` 不在 1.5.2 范围内（仅中文版挂推广区），
+  保持原样不动 —— 与既有双语策略一致，推广区只挂主语言。
+
+**没有功能改动**，没有破坏性变更。从 1.5.1 升级只是拿到 README 排版与发版前多跑一道门禁。
+
+升级：
+
+```bash
+dsh plugin --profile web update @dsh-plugins/dsh-llm-hub@^1.5.2
+```
+
+### 为什么没做
+
+- 不动英文 README：推广文案与图片需要单独翻译、单独审，1.5.2 走中文单语先行；下一版（1.6.x）做 EN/中英对照。
+- 不在 publish.yml 里加同一道门禁：publish.yml 是 GitHub Actions 那一侧的事，
+  本机 `npm publish` 不走它。门禁必须双侧都加才完整；本版只加了本机侧，Actions 侧的 `tag 与版本一致性 + npm view 探测` 已经在 publish.yml 里。
+  下一步若要也防 GitHub 侧 drift，加一条「`npm view <pkg>@<ver>` 命中即跳过 publish」的 guard
+  已经在 publish.yml 里存在（步骤「校验 tag 与版本一致，并探测 npm」），所以 Actions 侧风险已封。
+- 不动 `npm run deploy`：dev HEAD 已经与 npm 1.5.1 字节一致，profile 升级只走 `dsh plugin update`。
+
+## [1.5.1] - 2026-09-26
+
+### 🐛 修复 tarball 漏配 `assets/`
+
+1.5.0 推到 npm 后校验发现 `package.json` 的 `files` 数组没有 `assets/`，导致从 npm 读
+CHANGELOG.md 的人看不到截图（相对路径 `assets/*.svg` 在 tarball 里不存在）。
+
+GH Release 那边**没有**受影响 —— 它解析 tag 时是去仓库拿文件，不是去 tarball，所以 1.5.0
+的 Release 页面渲染图正常。
+
+**没有功能改动**，没有破坏性变更。已装 1.5.0 的用户升级 1.5.1 只会拿到 tarball 多 3 个 SVG
+（约 12 kB），其余字节级一致。
+
+升级命令不变：
+
+```bash
+dsh plugin --profile web add @dsh-plugins/dsh-llm-hub@^1.5.1
+```
+
 ## [1.5.0] - 2026-09-26
 
 > **一句话**：DSH 第一次能从你云端账单数据里分清「套餐 vs 按量」，并把套餐模型自动置顶；

package/README.md

@@ -49,6 +49,40 @@ dsh plugin --profile web add @dsh-plugins/dsh-llm-hub
 
 ---
 
+## 最新发布 · v1.5.1 (2026-09-26)
+
+> **一句话**：套餐 vs 按量付费**智能识别 + 手动切换**；LLM 下拉套餐模型**自动置顶**；
+> 修了一个永远只显示「LLM Hub 已激活」的家族面板 bug。
+
+📦 [v1.5.1 on npm](https://www.npmjs.com/package/@dsh-plugins/dsh-llm-hub/v/1.5.1) ·
+🚀 [GitHub Release notes](https://github.com/webkubor/dsh-llm-hub/releases/tag/v1.5.1) ·
+📋 [完整更新日志](./CHANGELOG.md)
+
+三件用户能看到的事：
+
+1. **套餐 vs 按量付费**：每个 provider 卡片新增 billing capsule，左边"按量付费"右边"套餐"，
+   自动按 5 层 fallback 识别云端账单类型（settings → `/status` → `/token_plan/remains`
+   → `/usage/quota/limit` → `/user/balance`），手动点另一边切模式即写回 settings。
+   ![](assets/02-billing-capsule.svg)
+2. **LLM 下拉套餐优先**：composer 模型选择器按当前 provider 的 billingMode 把套餐模型
+   置顶（绿色「套餐」徽章段），按量模型跟在后面。**不**自动改路由、不隐藏按量。
+   ![](assets/03-model-dropdown-priorities.svg)
+3. **家族面板真实激活探测（修 bug）**：设置 → 模型 → 底部「Webkubor DSH 扩展家族」，
+   之前的版本不管装几个插件永远只亮自己。改读 `window.__DSH_BOOT__.entries`
+   做真实激活探测，读不到时显示「判定不可用」而非谎报「没装」。
+   ![](assets/01-family-dock.svg)
+
+升级：
+
+```sh
+dsh plugin --profile web update @dsh-plugins/dsh-llm-hub@^1.5.1
+# 重启 DSH
+```
+
+**没有破坏性变更**。旧版（≤ 1.3.x）的 `keyPool[provider]` 配置在 1.4.0 已删除，所有 key 走 `apiKeyEnv` 数组。
+
+---
+
 ## 它补的是什么
 
 DSH 自己已经具备全部机制，缺的只是"官方适配器没去用它们"：

package/assets/01-family-dock.svg

@@ -0,0 +1,79 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="640" height="340" viewBox="0 0 640 340" font-family="-apple-system, 'SF Pro Text', 'PingFang SC', system-ui, sans-serif">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#1f1d2b"/>
+      <stop offset="100%" stop-color="#16151f"/>
+    </linearGradient>
+    <linearGradient id="card" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#2a2738"/>
+      <stop offset="100%" stop-color="#221f2c"/>
+    </linearGradient>
+    <radialGradient id="dot" cx="0.5" cy="0.5" r="0.5">
+      <stop offset="0%" stop-color="#34d399"/>
+      <stop offset="100%" stop-color="#10b981"/>
+    </radialGradient>
+    <filter id="blur"><feGaussianBlur stdDeviation="6"/></filter>
+  </defs>
+
+  <rect width="640" height="340" fill="url(#bg)"/>
+  <rect x="0" y="0" width="640" height="340" fill="#000" opacity="0.0"/>
+  <circle cx="80" cy="60" r="120" fill="#7c3aed" opacity="0.10" filter="url(#blur)"/>
+  <circle cx="560" cy="280" r="140" fill="#3b82f6" opacity="0.10" filter="url(#blur)"/>
+
+  <!-- panel container -->
+  <rect x="32" y="22" width="576" height="296" rx="12" fill="#1a1825" stroke="#2d2b3a" stroke-width="1"/>
+
+  <!-- head -->
+  <g transform="translate(48,46)">
+    <text x="0" y="14" font-size="14" font-weight="650" fill="#e5e7eb">🌟 Webkubor DSH 扩展家族</text>
+    <text x="384" y="14" font-size="10" fill="#9ca3af" text-anchor="end">一键构建完整智能体开发环境</text>
+  </g>
+
+  <!-- 4 cards grid 2x2, each 270x110 -->
+  <!-- card 1: Bloom Theme -->
+  <g transform="translate(48,82)">
+    <rect width="266" height="104" rx="8" fill="url(#card)" stroke="#2d2b3a"/>
+    <text x="14" y="24" font-size="14">🌸</text>
+    <text x="34" y="26" font-size="12" font-weight="600" fill="#e5e7eb">Bloom Theme</text>
+    <text x="14" y="50" font-size="10.5" fill="#9ca3af">落霞 Bloom 极客质感毛玻璃主题与代码高亮</text>
+    <circle cx="14" cy="78" r="3.5" fill="url(#dot)"/>
+    <text x="24" y="82" font-size="10.5" font-weight="600" fill="#10b981">已激活</text>
+    <text x="252" y="82" font-size="10" fill="#6b7280" text-anchor="end">GitHub ↗</text>
+  </g>
+
+  <!-- card 2: LLM Hub -->
+  <g transform="translate(326,82)">
+    <rect width="266" height="104" rx="8" fill="url(#card)" stroke="#2d2b3a"/>
+    <text x="14" y="24" font-size="14">🎛️</text>
+    <text x="34" y="26" font-size="12" font-weight="600" fill="#e5e7eb">LLM Hub</text>
+    <text x="14" y="50" font-size="10.5" fill="#9ca3af">多模型网关、余额配额、多 Key 轮换与极客大屏</text>
+    <circle cx="14" cy="78" r="3.5" fill="url(#dot)"/>
+    <text x="24" y="82" font-size="10.5" font-weight="600" fill="#10b981">已激活</text>
+    <text x="252" y="82" font-size="10" fill="#6b7280" text-anchor="end">GitHub ↗</text>
+  </g>
+
+  <!-- card 3: User Mirror -->
+  <g transform="translate(48,196)">
+    <rect width="266" height="104" rx="8" fill="url(#card)" stroke="#2d2b3a"/>
+    <text x="14" y="24" font-size="14">🪞</text>
+    <text x="34" y="26" font-size="12" font-weight="600" fill="#e5e7eb">User Mirror</text>
+    <text x="14" y="50" font-size="10.5" fill="#9ca3af">用户角色数字画像、习惯偏好与记忆网络</text>
+    <circle cx="14" cy="78" r="3.5" fill="url(#dot)"/>
+    <text x="24" y="82" font-size="10.5" font-weight="600" fill="#10b981">已激活</text>
+    <text x="252" y="82" font-size="10" fill="#6b7280" text-anchor="end">GitHub ↗</text>
+  </g>
+
+  <!-- card 4: Env Inspector -->
+  <g transform="translate(326,196)">
+    <rect width="266" height="104" rx="8" fill="url(#card)" stroke="#2d2b3a"/>
+    <text x="14" y="24" font-size="14">🖥️</text>
+    <text x="34" y="26" font-size="12" font-weight="600" fill="#e5e7eb">Env Inspector</text>
+    <text x="14" y="50" font-size="10.5" fill="#9ca3af">端口监听释放、CLI 工具链与环境大屏</text>
+    <circle cx="14" cy="78" r="3.5" fill="url(#dot)"/>
+    <text x="24" y="82" font-size="10.5" font-weight="600" fill="#10b981">已激活</text>
+    <text x="252" y="82" font-size="10" fill="#6b7280" text-anchor="end">GitHub ↗</text>
+  </g>
+
+  <!-- caption hint -->
+  <text x="320" y="332" font-size="9" fill="#6b7280" text-anchor="middle">设置 → 模型 → 底部「Webkubor DSH 扩展家族」</text>
+</svg>

package/assets/02-billing-capsule.svg

@@ -0,0 +1,72 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="720" height="280" viewBox="0 0 720 280" font-family="-apple-system, 'SF Pro Text', 'PingFang SC', system-ui, sans-serif">
+  <defs>
+    <linearGradient id="bg2" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#1f1d2b"/>
+      <stop offset="100%" stop-color="#16151f"/>
+    </linearGradient>
+    <linearGradient id="card2" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#2a2738"/>
+      <stop offset="100%" stop-color="#221f2c"/>
+    </linearGradient>
+    <linearGradient id="success" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0%" stop-color="#10b981"/>
+      <stop offset="100%" stop-color="#059669"/>
+    </linearGradient>
+    <linearGradient id="muted" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0%" stop-color="#3a3748"/>
+      <stop offset="100%" stop-color="#2d2b3a"/>
+    </linearGradient>
+  </defs>
+
+  <rect width="720" height="280" fill="url(#bg2)"/>
+
+  <!-- title bar -->
+  <text x="36" y="38" font-size="14" font-weight="650" fill="#e5e7eb">📦 模型卡片 · 套餐智能识别</text>
+  <text x="684" y="38" font-size="10.5" fill="#9ca3af" text-anchor="end">ModelGo 中转 · 11 个模型 · key 已配置</text>
+
+  <!-- one provider card expanded -->
+  <rect x="36" y="58" width="648" height="178" rx="10" fill="url(#card2)" stroke="#2d2b3a"/>
+
+  <!-- left: provider meta -->
+  <g transform="translate(56,82)">
+    <text x="0" y="0" font-size="12" font-weight="650" fill="#e5e7eb">ModelGo 中转</text>
+    <text x="0" y="18" font-size="10.5" fill="#9ca3af">https://api.modelgo.com · anthropic-messages</text>
+    <text x="0" y="36" font-size="10" fill="#6b7280">key ✓ · gpt-6-astra · claude-sonnet-4.5 · …</text>
+
+    <!-- billing capsule -->
+    <g transform="translate(0,58)">
+      <rect width="148" height="22" rx="11" fill="#1a1825" stroke="#2d2b3a"/>
+      <!-- left pill: pay-as-you-go active -->
+      <rect x="2" y="2" width="72" height="18" rx="9" fill="url(#success)"/>
+      <text x="38" y="15" font-size="10.5" font-weight="600" fill="#fff" text-anchor="middle">按量付费</text>
+      <!-- right pill: subscription -->
+      <rect x="76" y="2" width="68" height="18" rx="9" fill="url(#muted)"/>
+      <text x="110" y="15" font-size="10.5" fill="#d1d5db" text-anchor="middle">套餐</text>
+    </g>
+
+    <!-- caption -->
+    <text x="0" y="98" font-size="9.5" fill="#9ca3af">已按 /usage + /token_plan/remains 自动识别，</text>
+    <text x="0" y="112" font-size="9.5" fill="#9ca3af">可用时默认切到「套餐」分组。</text>
+  </g>
+
+  <!-- right: visual proof of toggle -->
+  <g transform="translate(420,82)">
+    <!-- before: scatter -->
+    <text x="0" y="0" font-size="10.5" fill="#9ca3af">切换前</text>
+    <rect x="0" y="10" width="240" height="60" rx="6" fill="#1a1825" stroke="#2d2b3a"/>
+    <text x="10" y="28" font-size="10" fill="#9ca3af">gpt-6-astra</text>
+    <text x="10" y="42" font-size="10" fill="#9ca3af">claude-sonnet-4.5</text>
+    <text x="10" y="56" font-size="10" fill="#9ca3af">deepseek-r1</text>
+
+    <!-- after: split -->
+    <text x="0" y="84" font-size="10.5" fill="#9ca3af">切换后</text>
+    <rect x="0" y="94" width="240" height="74" rx="6" fill="#1a1825" stroke="#2d2b3a"/>
+    <text x="10" y="112" font-size="10" font-weight="600" fill="#10b981">套餐</text>
+    <text x="50" y="112" font-size="10" fill="#d1d5db">claude-sonnet-4.5 · gpt-6-astra</text>
+    <text x="10" y="134" font-size="10" fill="#9ca3af">按量 · deepseek-r1 · qwen-2.5</text>
+    <text x="10" y="150" font-size="10" fill="#9ca3af">按量 · gemini-2.5-pro · …</text>
+  </g>
+
+  <!-- caption -->
+  <text x="360" y="266" font-size="9" fill="#6b7280" text-anchor="middle">设置 → 模型 → 单个 provider 卡 · 账单胶囊</text>
+</svg>

package/assets/03-model-dropdown-priorities.svg

@@ -0,0 +1,76 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="720" height="360" viewBox="0 0 720 360" font-family="-apple-system, 'SF Pro Text', 'PingFang SC', system-ui, sans-serif">
+  <defs>
+    <linearGradient id="bg3" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#1f1d2b"/>
+      <stop offset="100%" stop-color="#16151f"/>
+    </linearGradient>
+    <linearGradient id="card3" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#2a2738"/>
+      <stop offset="100%" stop-color="#221f2c"/>
+    </linearGradient>
+    <linearGradient id="pillSub" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0%" stop-color="#10b981"/>
+      <stop offset="100%" stop-color="#059669"/>
+    </linearGradient>
+    <linearGradient id="pillUsage" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0%" stop-color="#3b82f6"/>
+      <stop offset="100%" stop-color="#2563eb"/>
+    </linearGradient>
+  </defs>
+
+  <rect width="720" height="360" fill="url(#bg3)"/>
+
+  <!-- composer surface (faded) -->
+  <rect x="0" y="0" width="720" height="360" fill="#0d0c12" opacity="0.5"/>
+  <text x="36" y="46" font-size="14" font-weight="650" fill="#e5e7eb">🎯 模型下拉 · 套餐优先</text>
+  <text x="684" y="46" font-size="10.5" fill="#9ca3af" text-anchor="end">composer 模型选择器</text>
+
+  <!-- mock composer input -->
+  <rect x="36" y="68" width="648" height="48" rx="8" fill="url(#card3)" stroke="#2d2b3a"/>
+  <text x="56" y="98" font-size="12" fill="#9ca3af">描述你想要构建的内容，/ 调用指令，@ 文件或对话</text>
+
+  <!-- dropdown panel -->
+  <g transform="translate(36,134)">
+    <rect width="648" height="206" rx="10" fill="url(#card3)" stroke="#2d2b3a"/>
+
+    <!-- section header: 套餐 -->
+    <g transform="translate(20,18)">
+      <rect width="40" height="14" rx="7" fill="url(#pillSub)"/>
+      <text x="20" y="11" font-size="9" font-weight="700" fill="#fff" text-anchor="middle">套餐</text>
+      <text x="48" y="11" font-size="10" fill="#10b981" font-weight="600">优先</text>
+    </g>
+
+    <!-- sub items -->
+    <g transform="translate(20,40)">
+      <rect width="608" height="26" rx="4" fill="#1f1d2b"/>
+      <text x="14" y="17" font-size="11" fill="#e5e7eb">claude-sonnet-4.5</text>
+      <text x="180" y="17" font-size="9" fill="#10b981">套餐 · 剩 42h / week</text>
+    </g>
+    <g transform="translate(20,70)">
+      <rect width="608" height="26" rx="4" fill="#1f1d2b"/>
+      <text x="14" y="17" font-size="11" fill="#e5e7eb">gpt-6-astra</text>
+      <text x="180" y="17" font-size="9" fill="#10b981">套餐 · 套餐余额 92%</text>
+    </g>
+
+    <!-- divider -->
+    <line x1="20" y1="106" x2="628" y2="106" stroke="#2d2b3a" stroke-dasharray="2 2"/>
+
+    <!-- section header: 按量 -->
+    <g transform="translate(20,114)">
+      <rect width="48" height="14" rx="7" fill="url(#pillUsage)"/>
+      <text x="24" y="11" font-size="9" font-weight="700" fill="#fff" text-anchor="middle">按量</text>
+    </g>
+
+    <g transform="translate(20,136)">
+      <rect width="608" height="26" rx="4" fill="#1f1d2b"/>
+      <text x="14" y="17" font-size="11" fill="#e5e7eb">deepseek-r1</text>
+      <text x="180" y="17" font-size="9" fill="#9ca3af">按量 · $3.40 / 1M</text>
+    </g>
+    <g transform="translate(20,166)">
+      <rect width="608" height="22" rx="4" fill="transparent"/>
+      <text x="14" y="16" font-size="10" fill="#9ca3af">展开其余 4 个按量模型</text>
+    </g>
+  </g>
+
+  <text x="360" y="350" font-size="9" fill="#6b7280" text-anchor="middle">套餐模式识别后自动置顶 · 单击切换模式走 settings</text>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plugins/dsh-llm-hub",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "DSH 模型管理层：网关可达性探测、模型目录拉取、DeepSeek + MiniMax/智谱/Moonshot/StepFun 余额与配额、本月用量统计、余额预警、Provider 健康看板，再把本机装好的 codex / claude / agy 注册成子代理（装了才出现）。零运行时依赖，不改动 DSH 安装。",
   "type": "module",
   "main": "lib/index.js",
@@ -31,7 +31,8 @@
     "deploy": "rsync -av --delete lib/ ~/.dsh/profiles/web/node_modules/@dsh-plugins/dsh-llm-hub/lib/ && rsync -av types package.json cordis.patch.yml README.md README.en.md LICENSE ~/.dsh/profiles/web/node_modules/@dsh-plugins/dsh-llm-hub/",
     "preview": "npm run deploy && open http://127.0.0.1:3080",
     "check": "for f in lib/*.js; do node --check \"$f\" || exit 1; done",
-    "test": "node --test"
+    "test": "node --test",
+    "prepublishOnly": "npm run check && npm test && node scripts/prepublish-gate.mjs"
   },
   "keywords": [
     "dsh",
@@ -73,6 +74,7 @@
     "LICENSE",
     "README.en.md",
     "README.md",
+    "assets",
     "cordis.patch.yml",
     "lib",
     "types"