dsh-connect-modelscope-token-plan 0.6.5 → 0.7.0

package/CHANGELOG.md

@@ -26,6 +26,47 @@
 > **发版时**：顶部开 `## [X.Y.Z] — YYYY-MM-DD`，完整流程见
 > [RELEASING.md](RELEASING.md) §3（本文开头这段是**写作者规范**，那是**发布操作流程**）。
 
+## [0.7.0] — 2026-10-26
+
+**出图开关当场生效，不用再重启 DSH**
+
+- 翻开「出图工具」开关，工具立刻可用；关掉立刻从工具列表消失。此前面板只提示「下次
+  启动 DSH 才挂载」——挂上之后摘不掉，于是关掉开关工具仍会被调起。
+- 卸载或热重载插件时工具随之下线，不在宿主的工具注册表里留下一个已失效却仍占名字的
+  僵尸条目（旧行为下同名重挂会被宿主拒绝）。
+- 旧版 Host 若不返回注销句柄，开关仍能挂上但摘不掉：面板直说「本机 Host 不支持卸载」，
+  不再假装已经关掉。
+
+**面板：「下次启动」的提示只剩失败场景**
+
+- 这条提示改成瞬时读数：只在开关已开、几秒内还没挂上、且还查不出原因时出现；查得出
+  原因的（缺 tools 服务 / 模块加载失败 / 注册被拒 / 不可摘）直接把原因写在卡上。
+
+> 「宿主没有 unregister」这个断言当年是怎么写进注释、又怎么被推翻的（含 peer 契约
+> 取证与判据）：[docs/archive/2026-10-26-0.7.0-process.md](docs/archive/2026-10-26-0.7.0-process.md)
+
+## [0.6.6] — 2026-10-23
+
+**对话框胶囊可以点开，还多了「· N 新模型」**
+
+- 胶囊此前只是读数、点它没反应；现在点开是一张小卡：官方余额、今日本地调用、数据
+  时间与口径说明都在里面，向上弹不遮草稿，Esc 或点外面收起。
+- 目录里出现本机第一次见到的模型时，胶囊末尾多一段 `· 2 新模型`，面板里列出名字。
+  **口径是本机首见，不是网关新增**——目录不返回「何时上架」，只能记「我何时第一次
+  看到它」。只报最近 7 天内首见的；首次运行只播种、不宣布，不会把整个目录报成新。
+
+**诊断：多认一个状态文件**
+
+- `npm run doctor` 现在也盘点 `roster-seen.json`（每个 profile 记了多少模型、其中几个
+  是最近 7 天内首见）。文件损坏或版本不认识时与其他状态文件同款报出，不再只是「少了
+  那句标记」而没有痕迹。
+
+**模型窗口：两个新上架模型不再停在 128k 兜底**
+
+- DeepSeek-V4.1-Flash-1017（视觉）与 Step-5-Preview 上架时不在内置窗口策展表里，
+  面板只能显示 128k 兜底，而它们在 models.dev 各厂 host 下的共识是 1M。现在按上游
+  共识显示 1M。
+
 ## [0.6.5] — 2026-10-21
 
 **出图：被拒的图片地址不再原样回显**

package/README.md

@@ -1,4 +1,22 @@
-# dsh-connect-modelscope-token-plan
+<h1 align="center">dsh-connect-modelscope-token-plan</h1>
+
+<p align="center"><b>把魔搭社区（ModelScope）API-Inference 免费额度的面板接进 DSH，并可选把魔搭模型注册成 LLM provider。</b></p>
+
+<p align="center">
+  <a href="#安装">安装</a> ·
+  <a href="#面板长什么样">工作原理</a> ·
+  <a href="CHANGELOG.md">更新日志</a> ·
+  <a href="https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan/issues">问题反馈</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/dsh-connect-modelscope-token-plan"><img src="https://img.shields.io/npm/v/dsh-connect-modelscope-token-plan?style=flat-square&label=npm&color=cb3837" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/dsh-connect-modelscope-token-plan"><img src="https://img.shields.io/npm/d18m/dsh-connect-modelscope-token-plan?style=flat-square&label=downloads&color=cb3837" alt="npm downloads"></a>
+  <a href="https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/eghrhegpe/dsh-connect-modelscope-token-plan/ci.yml?branch=main&style=flat-square&label=tests" alt="test status"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/eghrhegpe/dsh-connect-modelscope-token-plan?style=flat-square" alt="MIT license"></a>
+  <a href="https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan/stargazers"><img src="https://img.shields.io/github/stars/eghrhegpe/dsh-connect-modelscope-token-plan?style=flat-square" alt="GitHub stars"></a>
+  <a href="https://dshfind.com/plugins/eghrhegpe/dsh-connect-modelscope-token-plan"><img src="https://dshfind.com/api/badge/eghrhegpe/dsh-connect-modelscope-token-plan" alt="dshfind plugin"></a>
+</p>
 
 把魔搭社区（modelscope.cn）**API-Inference 免费额度**的面板接进 DeepSeek Harness 的 **Plugins 页**（插件卡内联，三个 tab：额度 / 模型 / 接入），并可选把魔搭模型注册成 **DSH 的 LLM provider**（id `modelscope-token-plan`，OpenAI 兼容）——注册后魔搭模型进 DSH 模型选择器，可直接对话调用；还能开**出图工具**做文生图 / 图生图。
 
@@ -25,7 +43,7 @@
 
 ![「模型」tab：接入为DSH 模型与模型清单](assets/tab-model-list.png)
 
-- 同一 tab 下方有**「出图工具」**卡：开启后支持文生图、图生图与多图编辑。它与「接入为 DSH 模型」是两条独立开关，开关值立即保存、**工具的挂载发生在下次 Host 启动**。出图是异步的：一次没出好会返回 `status: pending` 与 `jobId`，带上它再调一次即可续查（不必重出）。协议细节见 [docs/SPIKE-image-gen.md](docs/SPIKE-image-gen.md)（2026-10-10 实测，v0.2 起已实现）。
+- 同一 tab 下方有**「出图工具」**卡：开启后支持文生图、图生图与多图编辑。它与「接入为 DSH 模型」是两条独立开关，开关保存后**当场**挂/卸工具（不用重启）。出图是异步的：一次没出好会返回 `status: pending` 与 `jobId`，带上它再调一次即可续查（不必重出）。协议细节见 [docs/SPIKE-image-gen.md](docs/SPIKE-image-gen.md)（2026-10-10 实测，v0.2 起已实现）。
 - 卡片底部有**「上下文窗口覆盖」**选择器（不覆盖 / 128K / 256K / 512K / 1M）：魔搭目录不返回窗口字段，插件按「目录声明 → 你选的档位 → 内置策展表（models.dev 交叉真值）→ 128K 兜底」四级兜底；覆盖压过策展表。档位来源与「为什么不给输出上限内置策展表」见 [docs/PROVIDER-M4.md](docs/PROVIDER-M4.md)。
 
 **「接入」tab**——粘贴一枚 `ms-…` 访问令牌即完成凭据配置（令牌永不入日志、永不进插件目录）。没有令牌时面板会提示你到这里来填。
@@ -46,6 +64,8 @@
 - **只在当前选中的 provider 是 `modelscope-token-plan` 时出现**，切到别的 provider 整块消失、不发任何请求。
 - **没有百分比、没有黄色档**：魔粒是存量、官方没有发布上限或低额阈值，造进度条 / 阈值都是给沒人公布过的分母配数。三档只有绿（正）/ 红（官方确为 0）/ 灰（读不到）。
 - **读不到 ≠ 0**：读不到时该段渲染「—」，0 只在官方真的给 0 时出现并走告警色；读失败保留上次数值并标「上次数据」。
+- **点开是详情面板**：胶囊可点，向上弹一张小卡——官方余额、今日本地调用、数据时间与口径说明都在里面，不遮草稿。
+- **「· N 新模型」**（v0.6.6 起）：目录里出现本机**第一次见到**的模型时，胶囊末尾多一段 `· 2 新模型`，详情面板里列出名字。**口径是本机首见，不是网关新增**——魔搭目录不返回「何时上架」，只能记「我什么时候第一次看到它」，两者混称就是编数据。只报最近 7 天内首见的，且只记目录 id；促销 / 活动变化不在射程内（那些是页面上的实时信息，不是目录事实）。首次运行只播种、不宣布：装上这个版本后的第一轮刷新不会把整个目录报成「新」。
 
 ## 安装
 
@@ -60,7 +80,7 @@
 
 3. 打开 DSH 的 **Plugins 页**，找到本插件的插件卡（面板是页内联卡片，**不在侧边栏**）。
 
-> 装到 npm 的那一份**不含 `docs/`**（`package.json` 的 `files` 白名单只带 `lib/` / `client.js` / `assets/` / `README.md` / `CHANGELOG.md` / `LICENSE` 等），下文指向 `docs/*` 的链接在已安装副本上打不开，请到 GitHub 仓库看。
+> **分发面**：npm 包只含 `package.json#files` 那 11 项（`lib/`、`client.js`、`icon.svg`、`locale/`、`assets/`、`cordis.patch.yml`、`README.md`、`CHANGELOG.md`、`LICENSE`、`THIRD_PARTY_NOTICES.md`、`screenshots.json`）。`docs/`、`AGENTS.md`、`RELEASING.md`、`tools/`、`test/` **不在包里**——下文指向它们的链接（以及「文档」一节的两个开发者入口）在 registry 页面上会 404，请到 GitHub 仓库看；截图因 `assets/` 在包内，相对路径在两边都能显示。
 
 ## 免费额度怎么算（2026-10 快照，以官方为准）
 
@@ -96,16 +116,10 @@ npm run doctor:json     # 机器读：JSON（可进你的巡检 / 工单脚本
 
 ## 文档
 
-- [docs/SPIKE.md](docs/SPIKE.md) — 上游到底有没有额度信号（实测记录 + 结论）
-- [docs/SPIKE-image-gen.md](docs/SPIKE-image-gen.md) — 出图协议实测（2026-10-10；v0.2 起已实现）
-- [docs/PROVIDER-M4.md](docs/PROVIDER-M4.md) — provider 接入实现契约（设计裁定都在这里）
-- [docs/IMPLEMENTATION.md](docs/IMPLEMENTATION.md) — 这版怎么做出来的、踩过什么坑
-- [docs/REFERENCES.md](docs/REFERENCES.md)、[docs/REFERENCE-modelsdev.md](docs/REFERENCE-modelsdev.md) — 上游端点全景 / 第三方方案对比
-- [docs/ROADMAP.md](docs/ROADMAP.md) — v1 要做什么、做到哪了
-- [docs/archive/](docs/archive/) — 已冻结的逐版修复档案
+**文档地图只有一份：[`AGENTS.md` §去哪查](https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan/blob/master/AGENTS.md)**（每份文档一行「何时查」）。这里不再列第二遍——两处索引必然分叉，而分叉之后没人知道哪份是对的。
 
-AI 协作会话请先读 [AGENTS.md](AGENTS.md)（验证入口、红线与文档地图）；开发者校验工具（变异测试 / 覆盖率）见 [tools/dev/README.md](tools/dev/README.md)；发布流程见 [RELEASING.md](RELEASING.md)。
+开发者校验工具（变异测试 / 覆盖率）见 [`tools/dev/README.md`](https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan/blob/master/tools/dev/README.md)，发布流程见 [`RELEASING.md`](https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan/blob/master/RELEASING.md)。配置字段的人读清单见 [docs/CONFIG.md](docs/CONFIG.md)（`drawEnabled` 这类「只有 YAML 注释」的键都在那里）。
 
 ## 许可证
 
-MIT License，全文见 [LICENSE](LICENSE)。
+MIT License，全文见 [LICENSE](LICENSE)；第三方内容（`docs/modelscope.cn-openapi/` 的魔搭 OpenAPI 转储等）见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,32 @@
+# 第三方致谢与合规（Third-Party Notices）
+
+本插件的源码与文档均为本仓库原创，按根目录 [LICENSE](./LICENSE)（MIT）授权。下列是**唯一的**
+第三方内容：
+
+## 1. `docs/modelscope.cn-openapi/` —— 魔搭站点 OpenAPI 规格转储
+
+| 项 | 内容 |
+|---|---|
+| 出处 | 魔搭社区站点 `https://modelscope.cn/openapi/v1`（机读规格），2026-10-10 单提交入库（`6b9f1c0`），此后未更新 |
+| 内容 | `modelscope.cn-openapi.md`（可读全文）与 `modelscope.cn-openapi.json.gz`（原始规格）；目录内的 `README.md` 由本仓编写，说明转储口径 |
+| 用途 | **契约参照**：核对面板外链/接口字段时查，不是数据源，也不参与任何请求 |
+| 代码是否消费 | **否**——`test/docs.test.mjs` 的 `isVendoredSpec` 按目录前缀把整个目录排除在文档断言之外 |
+| 权利 | 文档内容版权归魔搭社区 / 阿里巴巴所有，此处按「引用与核对」用途收录，未做商业再分发 |
+| 是否随 npm 包发布 | **否**。`package.json#files` 不含 `docs/` |
+
+## 2. 与本插件通信的上游服务
+
+- **魔搭 API-Inference**（`api-inference.modelscope.cn`）与站点（`modelscope.cn`）：插件以使用者
+  自己的访问令牌调用其模型目录、对话接口与官方余额接口。这些**不是**本仓库的代码，也不随包分发；
+  使用须遵守魔搭的服务条款。
+- **DSH（DeepSeek Harness）**：宿主运行时提供 `webServer` / `settings` / `llm` / `credentials`
+  等 peer 服务，由宿主安装，不随本包分发。
+
+## 3. 开发期工具链
+
+构建与测试使用的开源包（如 `tsdown`、`typescript`、`react` 作为 peer）按其各自许可证使用，
+**不复制其源码进本仓库**；依赖清单见 `package.json`，锁文件入库。
+
+## 4. 与厂商的关系
+
+本项目为个人集成作品，与魔搭社区、阿里巴巴、DeepSeek 均无关联，未获其背书。

package/client.js

@@ -223,7 +223,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			"draw.busy": "切换中…",
 			"draw.mounted": "已注册：{tool}",
 			"draw.notMounted": "未注册——打开上方开关即可开启。",
-			"draw.restartHint": "开关立即保存；工具要到下次启动 DSH 才挂载（挂载后无法撤销）。",
+			"draw.restartHint": "开关立即生效；工具正在挂载，若几秒后仍未挂上，上方会给出原因。",
 			"draw.currentNone": "当前目录里没有可出图的模型——出图会失败（先确认访问令牌已配置、目录已拉到）。",
 			"draw.currentSrc.declaredTextToImage": "平台声明为文生图",
 			"draw.currentSrc.knownTextToImage": "已知可纯文生图",
@@ -245,6 +245,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			"draw.absent.noTools": "开关已开，但本机没有 tools 服务，工具没挂上（Host 侧限制，不是配置问题）。",
 			"draw.absent.peerLoad": "开关已开，但 tools 模块加载失败，出图工具缺席（Host 问题，非配置）。",
 			"draw.absent.registry": "开关已开，但工具注册被 Host 拒绝，出图工具缺席（Host 问题，非配置）。",
+			"draw.absent.notRemovable": "工具已注册，但本机 Host 不返回注销句柄——关掉开关也摘不掉它（旧 Host 限制）。",
 			"draw.absent.unknown": "开关已开，但出图工具未挂载，原因未知。",
 			"draw.preferredGone": "已保存的默认模型 {model} 已不在当前目录（下架或改名）——出图会用它失败，请在下面重选。",
 			"trend.none": "还没有本地调用记录。",
@@ -286,7 +287,16 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			"composer.pillTitle": "魔搭额度：官方魔粒余额 + 今日本地调用次数",
 			"composer.balanceUnit": "魔粒",
 			"composer.localCalls": "今日本地 {calls} 次",
-			"composer.stale": "上次数据"
+			"composer.stale": "上次数据",
+			"composer.panelTitle": "魔搭额度详情",
+			"composer.panelBalance": "官方魔粒余额",
+			"composer.panelCalls": "今日本地调用",
+			"composer.panelNote": "余额来自官方接口，调用次数由本机按本地日统计——两者口径不同，不互相换算。",
+			"composer.newModels": "新模型",
+			"composer.newModelsRow": "本机首次见到的模型",
+			"composer.newModelsTitle": "本机首次见到的模型：",
+			"composer.newModelsSep": "、",
+			"composer.newModelsNote": "「新」指本机首次记到它，与上游何时上架无关。只列最近 7 天内首见的。"
 		};
 		en = {
 			"panel.refresh": "Refresh",
@@ -377,7 +387,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			"draw.busy": "Switching…",
 			"draw.mounted": "Registered: {tool}",
 			"draw.notMounted": "Not registered — turn the switch above on.",
-			"draw.restartHint": "The switch saves at once; the tool mounts the next time DSH starts (a mount cannot be undone).",
+			"draw.restartHint": "The switch takes effect immediately; the tool is still mounting. If it stays unmounted, the reason appears above.",
 			"draw.currentNone": "No image model in the catalogue right now — drawing will fail (check the access token and that the catalogue has loaded).",
 			"draw.currentSrc.declaredTextToImage": "platform-declared text-to-image",
 			"draw.currentSrc.knownTextToImage": "known to accept text-to-image",
@@ -399,6 +409,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			"draw.absent.noTools": "The switch is on, but this Host has no tools service, so the tool is not mounted (a Host limitation, not a config problem).",
 			"draw.absent.peerLoad": "The switch is on, but the tools module failed to load; the draw tool is absent (a Host fault, not config).",
 			"draw.absent.registry": "The switch is on, but the Host refused the tool registration; the draw tool is absent (a Host fault, not config).",
+			"draw.absent.notRemovable": "The tool is registered, but this Host returns no disposer — turning the switch off cannot unmount it (an older Host limitation).",
 			"draw.absent.unknown": "The switch is on, but the draw tool is not mounted; the reason is unknown.",
 			"draw.preferredGone": "The saved default model {model} is no longer in the catalogue (delisted or renamed) — drawing with it will fail. Pick another one below.",
 			"trend.none": "No local call records yet.",
@@ -440,7 +451,16 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			"composer.pillTitle": "ModelScope quota: official Magicube balance + today's local call count",
 			"composer.balanceUnit": "Magicubes",
 			"composer.localCalls": "local today {calls}",
-			"composer.stale": "stale data"
+			"composer.stale": "stale data",
+			"composer.panelTitle": "ModelScope quota details",
+			"composer.panelBalance": "Official Magicube balance",
+			"composer.panelCalls": "Calls today (local)",
+			"composer.panelNote": "The balance comes from the official endpoint; the call count is tallied on this device by local day — different sources, so they are not converted into each other.",
+			"composer.newModels": "new",
+			"composer.newModelsRow": "First seen on this device",
+			"composer.newModelsTitle": "First seen on this device: ",
+			"composer.newModelsSep": ", ",
+			"composer.newModelsNote": "\"New\" means first recorded on this device, not newly listed by the gateway. Only models first seen within the last 7 days are listed."
 		};
 	}));
 
@@ -998,7 +1018,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 				fontSize: 12,
 				fontWeight: 600,
 				lineHeight: "18px",
-				cursor: "default",
+				cursor: "pointer",
 				flexShrink: 0,
 				whiteSpace: "nowrap"
 			},
@@ -1017,7 +1037,69 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			pillTierOk: "#22c55e",
 			pillTierExhausted: "#ef4444",
 			pillTierUnknown: "#9ca3af",
-			pillTierExhaustedText: { color: "var(--dsw-alias-state-error-primary)" }
+			pillTierExhaustedText: { color: "var(--dsw-alias-state-error-primary)" },
+			pillNewTag: {
+				color: "var(--dsw-alias-label-secondary)",
+				flexShrink: 0
+			},
+			pillPopoverAnchor: {
+				position: "relative",
+				display: "inline-flex"
+			},
+			pillPopover: {
+				position: "absolute",
+				bottom: "100%",
+				right: 0,
+				zIndex: 100,
+				border: "1px solid var(--dsw-alias-border-l1)",
+				borderRadius: 10,
+				background: "var(--dsw-alias-bg-layer-1)",
+				boxShadow: "0 6px 24px rgba(0, 0, 0, 0.18)",
+				width: "min(320px, calc(100vw - 32px))",
+				padding: "10px 12px",
+				marginBottom: 8,
+				textAlign: "left",
+				color: "var(--dsw-alias-label-primary)",
+				fontSize: 12,
+				lineHeight: "18px",
+				fontFamily: "inherit",
+				boxSizing: "border-box"
+			},
+			pillPopoverHead: {
+				display: "flex",
+				alignItems: "center",
+				gap: 6,
+				flexWrap: "wrap",
+				marginBottom: 8
+			},
+			pillPopoverTitle: {
+				fontSize: 12,
+				fontWeight: 600,
+				color: "var(--dsw-alias-label-primary)"
+			},
+			pillPopoverStale: {
+				color: "var(--dsw-alias-label-tertiary)",
+				fontStyle: "italic"
+			},
+			pillPopoverRow: { padding: "6px 0" },
+			pillPopoverRowLine: {
+				display: "flex",
+				alignItems: "baseline",
+				gap: 8
+			},
+			pillPopoverLabel: {
+				fontSize: 12,
+				color: "var(--dsw-alias-label-secondary)"
+			},
+			pillPopoverFigure: {
+				marginLeft: "auto",
+				fontVariantNumeric: "tabular-nums",
+				color: "var(--dsw-alias-label-primary)"
+			},
+			pillPopoverNote: {
+				marginTop: 8,
+				color: "var(--dsw-alias-label-tertiary)"
+			}
 		};
 	}));
 
@@ -1193,6 +1275,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			allowed: p.allowed === "none" ? "none" : p.allowed === "list" ? "list" : "all",
 			enabledIds: ids,
 			contextWindow: typeof p.contextWindow === "number" && Number.isFinite(p.contextWindow) && p.contextWindow > 0 ? p.contextWindow : null,
+			newModelIds: Array.isArray(p.newModelIds) ? p.newModelIds.map((id) => String(id ?? "")).filter((id) => id !== "") : [],
 			roster
 		};
 	}
@@ -1207,8 +1290,8 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 	/**
 	* 把 wire/路由返回的出图块归一成 `DrawStatus`；不合法一律降级。
 	*
-	* 与 `providerOf` 同一套防御性归一（旧 Host 可能缺字段）。`absentReason` 只认三个
-	* 已知码——上游若新增第四个，归一到 `null` 而不是把它透传成渲染不出的值；面板的
+	* 与 `providerOf` 同一套防御性归一（旧 Host 可能缺字段）。`absentReason` 只认四个
+	* 已知码——上游若新增第五个，归一到 `null` 而不是把它透传成渲染不出的值；面板的
 	* 「缺席」措辞有兜底键，但**状态本身**宁可显示「未知」也不假装认识它。
 	* @param {unknown} raw - 原始块。
 	* @returns {DrawStatus} 归一后的状态。
@@ -1218,7 +1301,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 		const d = raw;
 		const candidates = Array.isArray(d.candidateIds) ? d.candidateIds.map((id) => String(id ?? "")).filter((id) => id !== "") : [];
 		const reason = d.absentReason;
-		const absentReason = reason === "no-tools-service" || reason === "peer-load-failed" || reason === "registry-refused" ? reason : null;
+		const absentReason = reason === "no-tools-service" || reason === "peer-load-failed" || reason === "registry-refused" || reason === "not-removable" ? reason : null;
 		const rawCandidates = Array.isArray(d.candidates) ? d.candidates.map((entry) => {
 			const row = entry ?? {};
 			return {
@@ -1286,6 +1369,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			allowed: "all",
 			enabledIds: [],
 			contextWindow: null,
+			newModelIds: [],
 			roster: []
 		});
 		DEGRADED_DRAW = Object.freeze({
@@ -2128,15 +2212,15 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 	/**
 	* 出图工具卡：开关、候选模型、挂载状态。
 	*
-	* **与 ProviderCard 的关键差异，也是这张卡存在的主要理由**：provider 开关翻转会
-	* 立即重注册，而出图工具的开关翻转**要等下次 Host 启动**——peer 的 tools registry
-	* 没有 unregister（完整论述见 src/host/draw-register.ts 文件头注）。所以这张卡必须
-	* 把这件事说出来（`draw.restartHint`），否则用户
-	* 翻开关后看不到任何变化，会以为坏了。
+	* **与 ProviderCard 的关键差异**：provider 开关翻转是「重建 provider 对」，出图工具
+	* 的开关翻转是「注册/注销一个 agent 工具」——两者都在**本次 Host 生命周期内**生效
+	* （peer 的 `tools.register` 返回 disposer，完整论述见 src/host/draw-register.ts 文件
+	* 头注）。保存后路由会等挂载收敛完再回快照，所以这张卡通常直接显示「已注册」；
+	* `draw.restartHint` 只在瞬时未挂上（或挂载失败）时出现，不再宣称「要等下次启动」。
 	*
-	* 缺席原因是**分开渲染**的：`no-tools-service` 是「这个 Host 没提供该服务」（正常），
-	* 另两种是 Host 缺陷。三种都给出各自的一句话，因为「开关开着但工具不在」如果没有
-	* 解释，用户没有任何办法自己诊断。
+	* 缺席/不可摘原因是**分开渲染**的：`no-tools-service` 是「这个 Host 没提供该服务」
+	* （正常），`not-removable` 是「能用但关不掉」，另两种是 Host 缺陷。每种都给出各自
+	* 的一句话，因为「开关开着但工具不在」如果没有解释，用户没有任何办法自己诊断。
 	* @param {object} props - 渲染参数。
 	* @returns {unknown} 卡片节点。
 	*/
@@ -2191,7 +2275,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			},
 			role: "status"
 		}, tt("draw.notMounted"));
-		const restartHint = enabled && status.mountPending === true ? h("div", { style: {
+		const restartHint = enabled && status.mountPending === true && status.absentReason === null ? h("div", { style: {
 			...S.formNote,
 			color: "var(--dsw-alias-state-warn-primary)"
 		} }, tt("draw.restartHint")) : null;
@@ -2349,7 +2433,8 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 		DRAW_ABSENT_KEY = {
 			"no-tools-service": "draw.absent.noTools",
 			"peer-load-failed": "draw.absent.peerLoad",
-			"registry-refused": "draw.absent.registry"
+			"registry-refused": "draw.absent.registry",
+			"not-removable": "draw.absent.notRemovable"
 		};
 	}));
 
@@ -3013,15 +3098,109 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 		return parts.filter((part) => part !== null).join(" · ");
 	}
 	/**
+	* 「本机首次见到的模型」清单：`snapshot.provider.newModelIds` 的净味版。
+	*
+	* 三道过滤都是承重的：
+	*   - 非数组（老 Host / 降级快照）→ 空清单，不抛；
+	*   - 非字符串 / 空串 → 丢掉，否则面板会画出一个空名字的「新模型」；
+	*   - 去重 → Host 侧已经去过重，但客户端不能依赖对端，重复项会让「3 个新模型」
+	*     变成 4 行同名。
+	*/
+	function newModelsOf(snapshot) {
+		const raw = snapshot?.provider?.newModelIds;
+		if (!Array.isArray(raw)) return [];
+		const seen = /* @__PURE__ */ new Set();
+		const ids = [];
+		for (const value of raw) {
+			if (typeof value !== "string") continue;
+			const id = value.trim();
+			if (id === "" || seen.has(id)) continue;
+			seen.add(id);
+			ids.push(id);
+		}
+		return ids;
+	}
+	/**
+	* 点面板外面或按 Escape 关面板。
+	*
+	* 三处细节各有理由：
+	*   - `pointerdown` 而不是 `click`：`click` 触发时按钮自己的 onClick 已经跑过，
+	*     一个把触发器算作「里面」的 click 监听会先关再被 toggle 打开，面板永远关不掉；
+	*   - 包含判定读**锚节点**而不是面板：点触发器本身是一次 toggle，把它算作「里面」
+	*     才不会和 toggle 抢；
+	*   - 鸭子类型判 `nodeType` 而不是 `instanceof Node`：本模块在 jsdom 里也跑，
+	*     而 jsdom 只把 `document` 镜像进 Node realm，`Node` 构造函数在那儿不存在。
+	*
+	* `open === false` 时不挂监听（没有面板要关，挂上就是白跑）。
+	*/
+	function useDismissOn(open, close, anchorRef) {
+		useEffect(() => {
+			if (!open) return;
+			if (typeof document === "undefined" || !("addEventListener" in document)) return;
+			const nodeLike = (value) => typeof value === "object" && value !== null && typeof value.nodeType === "number";
+			const anchorLike = anchorRef.current;
+			const insideAnchor = (target) => nodeLike(target) && typeof anchorLike?.contains === "function" && anchorLike.contains(target);
+			const onPointerDown = (event) => {
+				if (insideAnchor(event.target)) return;
+				close();
+			};
+			const onKeyDown = (event) => {
+				if (event.key !== "Escape") return;
+				close();
+			};
+			document.addEventListener("pointerdown", onPointerDown, true);
+			document.addEventListener("keydown", onKeyDown);
+			return () => {
+				document.removeEventListener("pointerdown", onPointerDown, true);
+				document.removeEventListener("keydown", onKeyDown);
+			};
+		}, [
+			open,
+			close,
+			anchorRef
+		]);
+	}
+	/**
+	* 展开面板：把胶囊正文那两段摊成两行，再补胶囊装不下的东西（口径注脚、
+	* 读取时间、新模型清单）。
+	*
+	* 面板是触发器的**兄弟**而不是子节点：`<button>` 里塞 `<div role="dialog">`
+	* 是非法嵌套（按钮的内容模型是 phrasing content，交互内容更糟）。锚壳用
+	* `<span>` 同理。
+	*/
+	function QuotaPopover(props) {
+		const { tt, title, stale, available, usedToday, balance, newModels } = props;
+		const fetchedAt = balance?.fetchedAt;
+		const failure = balance?.error;
+		return h("div", {
+			className: "dsh-modelscope-composer-pill-popover",
+			id: POPOVER_ID,
+			role: "dialog",
+			"aria-label": title,
+			style: S.pillPopover
+		}, h("div", { style: S.pillPopoverHead }, h("span", { style: S.pillPopoverTitle }, tt("composer.panelTitle")), stale ? h("span", { style: S.pillPopoverStale }, tt("composer.stale")) : null), h("div", { style: S.pillPopoverRow }, h("div", { style: S.pillPopoverRowLine }, h("span", { style: S.pillPopoverLabel }, tt("composer.panelBalance")), h("span", { style: S.pillPopoverFigure }, balanceText(available, tt)))), h("div", { style: S.pillPopoverRow }, h("div", { style: S.pillPopoverRowLine }, h("span", { style: S.pillPopoverLabel }, tt("composer.panelCalls")), h("span", { style: S.pillPopoverFigure }, usedToday === null ? "—" : format(tt("composer.localCalls"), { calls: count(usedToday) })))), newModels.length === 0 ? null : h("div", { style: S.pillPopoverRow }, h("div", { style: S.pillPopoverRowLine }, h("span", { style: S.pillPopoverLabel }, tt("composer.newModelsRow")), h("span", { style: S.pillPopoverFigure }, newModels.join(tt("composer.newModelsSep"))))), failure !== void 0 && typeof failure === "string" && failure !== "" ? h("div", { style: S.pillPopoverNote }, format(tt("balance.unavailable"), { error: failure })) : null, fetchedAt !== void 0 && typeof fetchedAt === "string" && fetchedAt !== "" ? h("div", { style: S.pillPopoverNote }, format(tt("balance.fetched"), { time: isoTime(fetchedAt) })) : null, h("div", { style: S.pillPopoverNote }, tt("composer.panelNote")), newModels.length === 0 ? null : h("div", { style: S.pillPopoverNote }, tt("composer.newModelsNote")));
+	}
+	/**
 	* 内层：只在会话选中本插件的模型时挂载。轮询 hook 在这里，被挂/摘即起停——
 	* 非归属 provider 的会话不发任何请求。
+	*
+	* 展开状态也住在这里（而不是外层门控）：外层每帧都要调 `useProjection` 才能
+	* 决定挂谁，把 `useState` 加到外层会让「非归属 → 归属」这个切换改变 hook 顺序
+	* （外层先 return null 再挂内层，Rules of Hooks 会炸）。内层被挂/摘时它自己的
+	* hook 序是完整的，所以 open 放这里安全。
 	*/
 	function ModelscopePill(props) {
 		const { tt } = props;
 		const { data, error, loadedOnce, updatedAt } = useSnapshotPolling();
+		const [open, setOpen] = useState(false);
+		const anchorRef = useRef(null);
+		const close = useCallback(() => setOpen(false), []);
+		const toggle = useCallback(() => setOpen((current) => !current), []);
+		useDismissOn(open, close, anchorRef);
 		const balance = data?.balance ?? null;
 		const available = availableOf(balance);
 		const usedToday = usedTodayOf(data);
+		const newModels = newModelsOf(data);
 		const cadenceMs = statedCadenceMs(data?.pollSeconds, DEFAULT_CADENCE_MS);
 		const stale = staleOf({
 			error,
@@ -3038,11 +3217,15 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			usedToday,
 			stale
 		});
-		return h("button", {
+		const trigger = h("button", {
 			type: "button",
 			className: "dsh-modelscope-composer-pill",
 			title,
 			"aria-label": title,
+			"aria-expanded": open,
+			"aria-haspopup": "dialog",
+			"aria-controls": open ? POPOVER_ID : void 0,
+			onClick: toggle,
 			style: S.pillTrigger
 		}, h("span", {
 			className: "dsh-modelscope-composer-pill-dot",
@@ -3060,7 +3243,24 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 		}, pending ? "…" : readingText(available, usedToday, tt)), stale ? h("span", {
 			className: "dsh-modelscope-composer-pill-stale",
 			style: S.pillStale
-		}, ` · ${tt("composer.stale")}`) : null);
+		}, ` · ${tt("composer.stale")}`) : null, newModels.length === 0 ? null : h("span", {
+			className: "dsh-modelscope-composer-pill-new",
+			style: S.pillNewTag,
+			title: `${tt("composer.newModelsTitle")}${newModels.slice(0, 3).join(tt("composer.newModelsSep"))}${newModels.length > 3 ? "…" : ""}`
+		}, ` · ${newModels.length} ${tt("composer.newModels")}`));
+		return h("span", {
+			className: "dsh-modelscope-composer-pill-anchor",
+			style: S.pillPopoverAnchor,
+			ref: anchorRef
+		}, trigger, open ? h(QuotaPopover, {
+			tt,
+			title,
+			stale,
+			available,
+			usedToday,
+			balance,
+			newModels
+		}) : null);
 	}
 	/**
 	* 外层门控：固定一处调 `useProjection`，再决定内层挂谁。非归属 provider 返回
@@ -3071,7 +3271,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 		if (selectedProviderOf(selection) !== "modelscope-token-plan") return null;
 		return h(ModelscopePill, { tt: props.tt });
 	}
-	var MODELSCOPE_PROVIDER, DEFAULT_CADENCE_MS, STALE_CADENCES, TIER_INK;
+	var MODELSCOPE_PROVIDER, DEFAULT_CADENCE_MS, STALE_CADENCES, TIER_INK, POPOVER_ID;
 	var init_composer_usage_pill = __esmMin((() => {
 		init_runtime();
 		init_styles();
@@ -3085,6 +3285,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			exhausted: S.pillTierExhausted,
 			unknown: S.pillTierUnknown
 		};
+		POPOVER_ID = "dsh-modelscope-composer-pill-popover";
 	}));
 
 //#endregion
@@ -3208,7 +3409,8 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 					balanceText,
 					callsText,
 					readingText,
-					staleOf
+					staleOf,
+					newModelsOf
 				}),
 				components: Object.freeze({
 					BalanceCard,

package/cordis.patch.yml

@@ -102,10 +102,9 @@
         #   · 出图**不扣**魔粒（chat 才扣，1 次 = 1 魔粒），所以面板刻意**不显示**
         #     出图计数——那会变成拿 chat 的口径给生图记账。
         #
-        # 生效时机：开关值立即保存，但**工具的挂载发生在下次 Host 启动**——
-        # peer 的 tools registry 没有 unregister，工具一旦注册就摘不下来（机制与
-        # 后果的完整论述见 src/host/draw-register.ts 文件头注）。
-        # 面板会就这一点给出提示（draw.restartHint）。
+        # 生效时机：开关值保存后**当场**挂/卸工具——peer 的 tools.register 返回 disposer
+        # （注销句柄），关掉就把工具摘掉，不用重启（机制与后果的完整论述见
+        # src/host/draw-register.ts 文件头注）。旧 Host 不返回句柄时才降级为 not-removable。
         drawEnabled: false
         # 出图默认模型（空 = 自动取目录里第一个出图模型）。
         # 注意只有目录内**平台声明**出图能力的模型才进候选：实测目录 35 条里

package/lib/host-config.js

@@ -1141,7 +1141,7 @@ const inject = ["webServer"];
 * 产物反而引入第二份真源；这里用常量、由 test/config.test.mjs 钉住与
 * package.json 一致。
 */
-const PLUGIN_VERSION = "0.6.5";
+const PLUGIN_VERSION = "0.7.0";
 /**
 * 默认值。刻意不含额度常数——理由见本文件头。
 * 面板头条是官方魔粒余额，次数口径的推算已在面板收敛时删除，这里若留着