dsh-connect-modelscope-token-plan 0.6.4 → 0.6.6

package/CHANGELOG.md

@@ -26,6 +26,47 @@
 > **发版时**：顶部开 `## [X.Y.Z] — YYYY-MM-DD`，完整流程见
 > [RELEASING.md](RELEASING.md) §3（本文开头这段是**写作者规范**，那是**发布操作流程**）。
 
+## [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
+
+**出图：被拒的图片地址不再原样回显**
+
+- 输入的图片地址校验不过时，此前原样回显你给的地址——它可能带着签名串或令牌，
+  于是凭据进日志也进面板。现在先脱敏再截断：诊断信息（协议、主机、路径）留着，
+  凭据那部分显示为 [REDACTED]。
+
+**面板：计数写盘失败不再悄悄冻住**
+
+- 本地计数的写入失败此前被吞掉，面板继续显示上一次成功写下的数字——数字看着在涨，
+  其实早就冻住，且没有半点痕迹。现在写入失败会记一条异常送进面板（并留一条日志），
+  只有真正落盘的写入才算数。
+
+**工程：依赖范围放宽**
+
+- 插件声明的 AI 运行时依赖范围从 `^0.85.1` 放宽到 `>=0.85.0 <2.0.0`，与当前宿主
+  随附的版本对齐，装上时不再被标成「超出上界」。
+
 ## [0.6.4] — 2026-10-19
 
 **出图：上游边缘抖动不再杀死任务**

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 模型选择器，可直接对话调用；还能开**出图工具**做文生图 / 图生图。
 
@@ -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

@@ -286,7 +286,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",
@@ -440,7 +449,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 +1016,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 +1035,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 +1273,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
 		};
 	}
@@ -1286,6 +1367,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			allowed: "all",
 			enabledIds: [],
 			contextWindow: null,
+			newModelIds: [],
 			roster: []
 		});
 		DEGRADED_DRAW = Object.freeze({
@@ -2130,7 +2212,8 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 	*
 	* **与 ProviderCard 的关键差异，也是这张卡存在的主要理由**：provider 开关翻转会
 	* 立即重注册，而出图工具的开关翻转**要等下次 Host 启动**——peer 的 tools registry
-	* 没有 unregister。所以这张卡必须把这件事说出来（`draw.restartHint`），否则用户
+	* 没有 unregister（完整论述见 src/host/draw-register.ts 文件头注）。所以这张卡必须
+	* 把这件事说出来（`draw.restartHint`），否则用户
 	* 翻开关后看不到任何变化，会以为坏了。
 	*
 	* 缺席原因是**分开渲染**的：`no-tools-service` 是「这个 Host 没提供该服务」（正常），
@@ -3012,15 +3095,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,
@@ -3037,11 +3214,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",
@@ -3059,7 +3240,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 返回
@@ -3070,7 +3268,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();
@@ -3084,6 +3282,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			exhausted: S.pillTierExhausted,
 			unknown: S.pillTierUnknown
 		};
+		POPOVER_ID = "dsh-modelscope-composer-pill-popover";
 	}));
 
 //#endregion
@@ -3207,7 +3406,8 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 					balanceText,
 					callsText,
 					readingText,
-					staleOf
+					staleOf,
+					newModelsOf
 				}),
 				components: Object.freeze({
 					BalanceCard,

package/cordis.patch.yml

@@ -62,8 +62,8 @@
         # 适配器出去，每一次调用与每一条 429/错误事件都由 src/host/usage-observer.ts
         # 在流的出口记进同一个 usage-store。口径是**本客户端**：桌面端与 Web 端是
         # 两个 profile，各记各的账、互不可见（`npm run doctor` 并排列出各 profile），
-        # 别把它当跨端总量。直连魔搭的其它客户端同样不计入（本插件看不见它们），
-        # 消耗总量以官方魔粒余额为准。
+        # 口径的历史与裁定见 docs/PROVIDER-M4.md；别把它当跨端总量。直连魔搭的
+        # 其它客户端同样不计入（本插件看不见它们），消耗总量以官方魔粒余额为准。
         #
         # 偏差方向是**按流计次**：重试不在流内部发生，而是流被消费完后由
         # agent/request-error 瀑布决定重发，因而每次重试各记一次（按「魔搭按
@@ -103,7 +103,8 @@
         #     出图计数——那会变成拿 chat 的口径给生图记账。
         #
         # 生效时机：开关值立即保存，但**工具的挂载发生在下次 Host 启动**——
-        # peer 的 tools registry 没有 unregister，工具一旦注册就摘不下来。
+        # peer 的 tools registry 没有 unregister，工具一旦注册就摘不下来（机制与
+        # 后果的完整论述见 src/host/draw-register.ts 文件头注）。
         # 面板会就这一点给出提示（draw.restartHint）。
         drawEnabled: false
         # 出图默认模型（空 = 自动取目录里第一个出图模型）。

package/lib/host-config.js

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

package/lib/index.js

@@ -985,6 +985,15 @@ function createFileUsageStore({ name, profile = null, retentionDays = 90, maxEve
 	const file = join(dir, "usage.json");
 	/** 最近一次解析异常（损坏即忽略的痕迹），快照转 shapeWarnings。 */
 	let anomaly = null;
+	/**
+	* 最近一次**写**失败的痕迹。
+	*
+	* 与 {@link anomaly} 分开记，因为两者的寿命不同：解析异常是**读**出来的，下一次
+	* 读就会覆盖它（读到好的就恢复）；写失败是**写**出来的，只有一次成功的写才能
+	* 抹掉它——读得动旧值不代表上一次写落了盘（读回来的永远是上一次**成功**写下去
+	* 的那一份）。
+	*/
+	let writeAnomaly = null;
 	/** 只读闸：磁盘版本比本构建新时置位——读照常、写拒绝，绝不 clobber。 */
 	let readOnly = false;
 	/** 最近一次确认过的内存态；读路径拿它，写路径以它为基线。 */
@@ -1046,10 +1055,29 @@ function createFileUsageStore({ name, profile = null, retentionDays = 90, maxEve
 		return parsed.payload;
 	};
 	const cache = createStateReadCache(readThrough, { now: () => Date.now() });
-	/** 把内存态写盘（原子），失败不抛——计数是尽力而为的观测，不是事务。 */
+	/**
+	* 把内存态写盘（原子），失败不抛——计数是尽力而为的观测，不是事务。
+	*
+	* 但「不抛」不等于「不说」。这一句注释原先与实现相反：writeStateFile 失败会**抛**
+	* （state-store.ts 的 writeStateFile 在 catch 里重抛），抛给谁？本仓的用法是
+	* index.ts 那句 `.catch(() => {})`（理由见那里：观测失败不是对话失败）——于是
+	* 一次写失败被彻底咽掉：面板继续显示上一次成功落盘的数字，计数看起来是活的，
+	* 其实早就冻住了，而**没有任何人知道**（没有日志，没有 shapeWarning）。
+	*
+	* 所以失败要留两处痕迹：日志（给操作者）与 {@link writeAnomaly}（进快照的
+	* shapeWarnings，给面板）。吞掉的是失败，不是失败的原因。
+	*/
 	const persist = async (payload) => {
-		await ensureStateDir(dir);
-		await writeStateFile(file, JSON.stringify(payload), { temporary: temporaryOf(dir, "usage.json") });
+		try {
+			await ensureStateDir(dir);
+			await writeStateFile(file, JSON.stringify(payload), { temporary: temporaryOf(dir, "usage.json") });
+		} catch (error) {
+			const note = `usage-state: write failed (${redactSecrets(errMsg(error))})`;
+			writeAnomaly = note;
+			logger?.warn?.(`${name}: ${note} — the local counters are not reaching disk; the panel still shows the last values that did`);
+			return;
+		}
+		writeAnomaly = null;
 		cache.remember(payload);
 	};
 	/**
@@ -1266,9 +1294,14 @@ function createFileUsageStore({ name, profile = null, retentionDays = 90, maxEve
 			if (payload === null) return await pathExists(file) ? null : [];
 			return [...payload.events ?? []];
 		},
-		/** 最近一次解析异常（无异常为 null）——快照转 shapeWarnings。 */
+		/**
+		* 最近一次异常（无异常为 null）——快照转 shapeWarnings。
+		*
+		* 写失败的痕迹优先于读侧的解析异常：它更近、也更严重（解析异常说「这份文件
+		* 读不懂」，写失败说「我们刚写的东西没落盘」）。
+		*/
 		anomaly() {
-			return anomaly;
+			return writeAnomaly ?? anomaly;
 		}
 	};
 }
@@ -1507,8 +1540,8 @@ function createCoalescedFetch(options = {}) {
 * 最大值：个别网关把窗口抄大（如 openrouter 抄 1M）不代表魔搭侧真开那么宽。
 *
 * 维护纪律：
-* 1. 只收**当前魔搭目录里真实存在**的 id（2026-10-16 实拉 `/v1/models` 全集
-*    37 个中筛出 19 个）；目录下架的条目应随手删除，表不是历史档案。
+* 1. 只收**当前魔搭目录里真实存在**的 id（2026-10-23 实拉 `/v1/models` 全集
+*    37 个中筛出 21 个）；目录下架的条目应随手删除，表不是历史档案。
 * 2. 每条注明来源 host 与核对日期；有多个数据源时写主流值并留离群说明。
 * 3. 覆盖优先级由 `curatedWindowOf` 的调用方（inference-client 打标）保证：
 *    目录声明过窗口的条目不进打标，策展表永不推翻平台声明。
@@ -1522,14 +1555,14 @@ function createCoalescedFetch(options = {}) {
 * 而使用者无从判断一个值是三个月前还是三年前核的。快照侧据此在表过期时给一条
 * shapeWarning（见 {@link curatedCatalogStale}）。
 */
-const CURATED_AS_OF = "2026-10-16";
+const CURATED_AS_OF = "2026-10-23";
 /**
 * 策展表距上次核对已经过去多少天；日期解析不了返回 `null`。
 * @param {Date} [now] - 时钟源（测试注入）。
 * @returns {number|null} 天数（向下取整），或 null。
 */
 function curatedCatalogAgeDays(now = /* @__PURE__ */ new Date()) {
-	const asOf = Date.parse("2026-10-16T00:00:00Z");
+	const asOf = Date.parse("2026-10-23T00:00:00Z");
 	if (Number.isNaN(asOf)) return null;
 	const delta = now.getTime() - asOf;
 	return delta < 0 ? 0 : Math.floor(delta / 864e5);
@@ -1553,6 +1586,7 @@ const CURATED_CONTEXT_WINDOWS = {
 	"deepseek-ai/DeepSeek-V4-Pro": 1048576,
 	"deepseek-ai/DeepSeek-V4-Pro-0813": 1048576,
 	"deepseek-ai/DeepSeek-V4.1-Flash": 1048576,
+	"deepseek-ai/DeepSeek-V4.1-Flash-1017": 1048576,
 	"meituan-longcat/LongCat-Flash-Lite": 256e3,
 	"MiniMax/MiniMax-M1-80k": 1e6,
 	"MiniMax/MiniMax-M3": 1048576,
@@ -1566,6 +1600,7 @@ const CURATED_CONTEXT_WINDOWS = {
 	"Qwen/Qwen3.8-Flash-Next": 262144,
 	"stepfun-ai/Step-3.5-Flash": 262144,
 	"stepfun-ai/Step-3.7-Flash": 262144,
+	"stepfun-ai/Step-5-Preview": 1e6,
 	"ZhipuAI/GLM-4.7-Flash": 2e5,
 	"ZhipuAI/GLM-5.2": 1e6
 };
@@ -1993,7 +2028,7 @@ function createInferenceClient({ settings, tokenStore, deps = {}, logger }) {
 * collapses here, so the three call sites that produce it stay in step instead
 * of each spelling out the same three `null`s.
 */
-const EMPTY_PAYLOAD$2 = {
+const EMPTY_PAYLOAD$3 = {
 	enabled: null,
 	enabledIds: null,
 	contextWindow: null,
@@ -2222,7 +2257,7 @@ function createFileProviderStore(options = {}) {
 	* `null` branch collapses here, in one place, rather than at every caller.
 	* @returns {Promise<ProviderPayload>} the payload; the empty payload when nothing is stored.
 	*/
-	const readPayload = async () => await read() ?? EMPTY_PAYLOAD$2;
+	const readPayload = async () => await read() ?? EMPTY_PAYLOAD$3;
 	/**
 	* Read one payload, then hand it to {@link writePayload} — the read-modify-
 	* write that keeps the switch and the list from clobbering each other.
@@ -2446,7 +2481,7 @@ function createFileProviderStore(options = {}) {
 const DRAW_STORE_VERSION = 1;
 /** 本 build 读得懂的版本集合（升级时把新号加进来，旧号保持可读）。 */
 const KNOWN_DRAW_VERSIONS = Object.freeze([1]);
-const EMPTY_PAYLOAD$1 = {
+const EMPTY_PAYLOAD$2 = {
 	enabled: null,
 	modelId: null,
 	version: null
@@ -2545,7 +2580,7 @@ function createFileDrawStore(options = {}) {
 	* 读当前 payload。
 	* @returns {Promise<DrawPayload>}
 	*/
-	const readPayload = async () => await cache.read() ?? EMPTY_PAYLOAD$1;
+	const readPayload = async () => await cache.read() ?? EMPTY_PAYLOAD$2;
 	/**
 	* 读-改-写一份补丁，**整段排队**。
 	*
@@ -2803,7 +2838,7 @@ function switchSource(panel) {
 const USAGE_PREFS_VERSION = 1;
 /** 本 build 读得懂的版本集合（升级时把新号加进来，旧号保持可读）。 */
 const KNOWN_USAGE_PREFS_VERSIONS = Object.freeze([1]);
-const EMPTY_PAYLOAD = {
+const EMPTY_PAYLOAD$1 = {
 	windowDays: null,
 	version: null
 };
@@ -2922,7 +2957,7 @@ function createFileUsagePrefsStore(options = {}) {
 	* 读当前 payload。
 	* @returns {Promise<UsagePrefsPayload>}
 	*/
-	const readPayload = async () => await cache.read() ?? EMPTY_PAYLOAD;
+	const readPayload = async () => await cache.read() ?? EMPTY_PAYLOAD$1;
 	/**
 	* 读-改-写，**整段排队**。
 	*
@@ -2981,6 +3016,258 @@ function createFileUsagePrefsStore(options = {}) {
 	};
 }
 
+//#endregion
+//#region src/host/roster-seen-store.ts
+/**
+* 「本机第一次见到这个模型是什么时候」——胶囊那句「· N 新模型」的唯一事实源。
+*
+* ## 它回答什么，不回答什么
+*
+* 只记**首见时间戳**：每个 id 第一次出现在本机拉到的目录里的那一刻。由此派生的
+* 那句话必须说成「本机首次见到的模型」，**不能**说成「网关新增」——上游的
+* `/v1/models` 不提供「上架时间」，本插件没有任何字段能证实某个模型是这周才上
+* 的。能证实的只有「本机从哪天开始看见它」，那就只说这一句。
+*
+* 也**不**记录活动/促销变化（限免、错峰、签到）：那些是实时读数，面板的余额块与
+* 胶囊 popover 已经直接画上游给的现值，再造一本「促销 diff 账」就是同一事实两本
+* 账，两本迟早说两套话（ADR-017 的口径）。
+*
+* ## 一次调用同时 diff 与落盘
+*
+* {@link RosterSeenStore.note} 不能拆成「先 diff 缓存、稍后再写」：那样两个并发
+* 的收敛轮可能都基于同一份旧 map 判断，后写的那次会把先写的那批模型再宣布一遍。
+* 读、算、写在一个调用里完成。
+*
+* ## 首次写入是**播种**，不是宣布
+*
+* 升级到带本文件的构建时，磁盘上没有历史——此时**知道**目录里有这些模型，但
+* **不知道**其中哪些是新的。把整个目录宣布成「刚上架」正是本文件要避免的谎，
+* 所以播种那一轮把每个 id 都盖成「已过期」的戳（`now - 窗口`），`newIds` 返回
+* 空。这个自愈是刻意的：某个 id 要先离开目录再回来，才配得到一个真实的首见戳。
+*
+* ## 200 个 id 以上是**形状漂移**，不是「保留最新 200」
+*
+* 按「保留最新」淘汰一个仍在目录里的 id，会让它下一轮看起来像没见过 → 重新盖戳
+* → 再被宣布一次；而被淘汰的集合每轮轮换，于是「新模型」计数会**震荡并变大**
+* （实测 250 个 id 对 200 上限：50 → 100 → …）。会自己发明新模型的历史文件比
+* 没有历史文件更糟，所以超限一律读作形状漂移：**不写、不宣布**，旧 map 原样
+* 保留，标记在异常期间消失，目录回到合理规模后自愈。
+*
+* ## 分段与 legacy
+*
+* 落点与 provider / draw / usage-prefs 同一套分段规则：
+* `$DSH_HOME/state/<profile>/<plugin>/roster-seen.json`（无 profile 时落共享目录）。
+* **不搬**：本文件晚于 profile 分段引入，共享目录里不存在它的旧布局可继承——
+* 与 usage-prefs-store 的「legacy 继承」相反，这里没有 legacy 缝，也不该长出一条。
+*
+* 完整性三件套与其余 store 同源（全部上收在 `state-store.ts`，本文件只做调用方，
+* 论述见 `draw-store.ts` 头注）：写串行化（{@link createStateWriteQueue}）、写守卫
+* （{@link guardStateWrite}，ADR-006）、读侧说明（{@link stateVersionNote}）。
+*
+* doctor 覆盖：{@link describeRosterSeenPayload} 给只读速览，`doctor.ts` 据此把
+* roster-seen.json 的「损坏 / 未知版本」报进症状表。
+*
+* @module dsh-connect-modelscope-token-plan/roster-seen-store
+*/
+/** 本 store 落盘 payload 的版本。 */
+const ROSTER_SEEN_VERSION = 1;
+/** 本 build 读得懂的版本集合（升级时把新号加进来，旧号保持可读）。 */
+const KNOWN_ROSTER_SEEN_VERSIONS = Object.freeze([1]);
+/**
+* 「新」的时效窗口：首见戳落在这个窗口内就算新。
+*
+* 7 天是有意的尺度——它要盖住「用户几天没开面板、回来时发现多了两个模型」这个
+* 真实场景，又不能长到让一次批量上架在半个月后还挂着标记。窗口在这里是**常量**
+* 而不是配置：一个能被调成 365 天的「新模型」标记等于没有语义。
+*/
+const ROSTER_SEEN_NEW_WINDOW_MS = 6048e5;
+/**
+* 目录规模上限。超过即视为形状漂移（不是淘汰队列，理由见模块头注）。
+*
+* 取值与姊妹插件的同类实现一致：真实目录在数百个模型以内，200 给「这一侧目录
+* 突然返回了整站列表」这类事故留出足够间距。
+*/
+const ROSTER_SEEN_MAX_IDS = 200;
+const EMPTY_PAYLOAD = {
+	seen: {},
+	version: null
+};
+/**
+* 本 build 读不读得懂这个版本。
+*
+* 与其余 store 的 `isKnown*Version` 同形：**白名单**判据，不与
+* {@link ROSTER_SEEN_VERSION} 比较——升级后旧号仍要可读。读侧、报告侧问的都是
+* 这一个函数。
+* @param {unknown} version - 盘上读到的值（可能根本不是数字）。
+* @returns {boolean}
+*/
+function isKnownRosterSeenVersion(version) {
+	return typeof version === "number" && KNOWN_ROSTER_SEEN_VERSIONS.includes(version);
+}
+/**
+* 归一一张首见表：只留「id 是非空字符串、戳是有限正数」的项。
+*
+* 丢掉而不是修补坏项是有意的：一个戳为 0 或负数的项会让 `now - stamp` 变成
+* 几十年，那个 id 于是永远算「新」；宁可让它下次出现时重新盖一个真实戳。
+* @param {unknown} raw - 盘上读到的 `seen` 值。
+* @returns {RosterSeen} 归一后的表（可能是空对象）。
+*/
+function normalizeRosterSeen(raw) {
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return {};
+	const out = {};
+	for (const [id, stamp] of Object.entries(raw)) {
+		if (id === "") continue;
+		if (typeof stamp !== "number" || !Number.isFinite(stamp) || stamp <= 0) continue;
+		out[id] = stamp;
+	}
+	return out;
+}
+/** 本 store 的目录（与 provider / draw / usage-prefs 同一套分段规则）。 */
+function rosterSeenDir(profile, dir) {
+	if (typeof dir === "string" && dir !== "") return dir;
+	return profile ? profileStateDir(name, profile) : stateDir(name);
+}
+/**
+* 从一张首见表里挑出「还算新」的 id，按首见时间升序（最老的在前）。
+*
+* 升序是有意的：调用方只展示前几个名字（胶囊 tooltip / popover 的预算），先看到
+* 的应该是**最早**变成新的那几个——它们离过期最近，也是读者最可能已经见过、
+* 需要被告知「其实才刚出现」的那批。
+* @param {RosterSeen} seen - 归一后的首见表。
+* @param {number} nowMs - 当前时刻。
+* @returns {string[]} 窗口内的 id 列表。
+*/
+function freshIdsOf(seen, nowMs) {
+	return Object.entries(seen).filter(([, first]) => nowMs - first < ROSTER_SEEN_NEW_WINDOW_MS).sort((left, right) => left[1] - right[1]).map(([id]) => id);
+}
+/**
+* 文件支撑的首见表。
+* @param {StoreOptions} [options] - `{ dir, profile, ttlMs, logger }`。
+* @returns {object} store 句柄。
+*/
+function createFileRosterSeenStore(options = {}) {
+	const { dir, profile = null, ttlMs = STATE_READ_TTL_MS, logger } = options;
+	const stateDir = rosterSeenDir(profile, dir);
+	const filePath = join(stateDir, "roster-seen.json");
+	/**
+	* 写一份 payload 并落盘。
+	*
+	* ADR-006 写守卫（{@link guardStateWrite}）先问盘：版本不认或文件读不出 →
+	* 返回拒绝理由（已 degrade 记录），不落笔。
+	* @param {object} body - 要持久化的 JSON 体。
+	* @returns {Promise<string|null>} 拒绝原因，或 `null` = 已写入。
+	*/
+	const writePayload = async (body) => {
+		const refusal = await guardStateWrite(filePath, KNOWN_ROSTER_SEEN_VERSIONS, {
+			label: "roster-seen-state",
+			logger
+		});
+		if (refusal !== null) return refusal;
+		await ensureStateDir(stateDir);
+		await writeStateFile(filePath, JSON.stringify(body, null, 2), { temporary: temporaryOf(stateDir, "roster-seen.json") });
+		return null;
+	};
+	/** 写串行化：读-改-写必须排队（详见{@link createStateWriteQueue}）。 */
+	const writeQueue = createStateWriteQueue();
+	/**
+	* 解析一份路径上的 payload；认不出的版本读作「空表」但**记住**版本号——读侧
+	* 宽容、versionNote 负责把宽容说出口（写侧守卫已挡住覆盖，两半合起来才是
+	* ADR-006）。
+	*/
+	const parseAt = async (path) => {
+		const source = obj(await readStateJson(path));
+		const version = typeof source.version === "number" ? source.version : null;
+		if (!isKnownRosterSeenVersion(version)) return {
+			seen: {},
+			version
+		};
+		return {
+			seen: normalizeRosterSeen(source.seen),
+			version
+		};
+	};
+	const cache = createStateReadCache(() => parseAt(filePath), { ttlMs });
+	/** 读当前 payload。 */
+	const readPayload = async () => await cache.read() ?? EMPTY_PAYLOAD;
+	return {
+		/**
+		* 记下这一轮的完整目录，并回答「其中哪些还在新窗口内」。
+		*
+		* 一次调用同时 diff 与落盘（理由见模块头注）。首轮写入是**播种**：把每个 id
+		* 盖成已过期的戳、返回空 `newIds`。
+		* @param {readonly string[]} ids - 上游这一轮列出的**完整**目录 id。
+		* @param {number} [nowMs] - 时钟（测试注入）。
+		* @returns {Promise<{newIds: string[]}>} 窗口内的 id，升序；播种那轮为空。
+		*/
+		async note(ids, nowMs = Date.now()) {
+			const list = Array.isArray(ids) ? ids.filter((id) => typeof id === "string" && id !== "") : [];
+			const unique = [...new Set(list)];
+			if (unique.length === 0) return { newIds: [] };
+			const now = Number.isFinite(nowMs) ? nowMs : Date.now();
+			return writeQueue.enqueue(async () => {
+				const current = await parseAt(filePath);
+				if (current.version !== null && !isKnownRosterSeenVersion(current.version)) return { newIds: [] };
+				const previous = current.seen;
+				const seeded = current.version === null;
+				const next = {};
+				for (const id of unique) {
+					const first = previous[id];
+					next[id] = typeof first === "number" && first > 0 ? Math.min(first, now) : seeded ? now - ROSTER_SEEN_NEW_WINDOW_MS : now;
+				}
+				if (Object.keys(next).length > 200) return { newIds: [] };
+				if (seeded || Object.keys(previous).length !== Object.keys(next).length || Object.keys(next).some((id) => previous[id] !== next[id])) {
+					const refusal = await writePayload({
+						version: 1,
+						seen: next,
+						updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+					});
+					if (refusal !== null) throw new Error(refusal);
+					cache.remember({
+						seen: next,
+						version: 1
+					});
+				}
+				return { newIds: seeded ? [] : freshIdsOf(next, now) };
+			});
+		},
+		/**
+		* 只读：此刻还算「新」的 id（升序）。
+		*
+		* **不写盘**：快照与 provider 路由都是读路径，写只发生在收敛器的 `note`。
+		* 读路径若顺手补戳，一次面板轮询就能把「谁是新模型」这件事改写掉。
+		* @param {number} [nowMs] - 时钟（测试注入）。
+		* @returns {Promise<string[]>}
+		*/
+		async fresh(nowMs = Date.now()) {
+			return freshIdsOf((await readPayload()).seen, Number.isFinite(nowMs) ? nowMs : Date.now());
+		},
+		/** 这张表有没有写过（区分「播种」与「真的没有新模型」）。 */
+		async isSet() {
+			return (await readPayload()).version !== null;
+		},
+		/**
+		* 盘上带着本构建读不懂的版本时的一句说明，否则 `null`。
+		*
+		* 读侧宽容（未知版本读作空表）的另一半：快照聚合把它转进 `shapeWarnings`，
+		* doctor 报同一份文件。没有它，「首见表被忽略」在面板上就是「没有新模型」。
+		* @returns {Promise<string|null>}
+		*/
+		async versionNote() {
+			const version = (await readPayload()).version;
+			if (version === null || isKnownRosterSeenVersion(version)) return null;
+			return stateVersionNote({
+				label: "roster-seen-state",
+				file: filePath,
+				version,
+				known: KNOWN_ROSTER_SEEN_VERSIONS,
+				consequence: "the first-sighting history is being answered as empty, so the pill shows no new-model marker."
+			});
+		},
+		/** 落盘路径（诊断与测试用）。 */
+		filePath
+	};
+}
+
 //#endregion
 //#region src/host/draw.ts
 /**
@@ -3780,7 +4067,10 @@ function defineDrawTool({ defineTool, fetchImpl, resolveApiKey, getEntries, sett
 			const images = [];
 			for (const raw of rawImages) {
 				const normalized = normalizeImageUrlInput(raw);
-				if (normalized === null) throw new Error(`imageUrl 不可用：${raw.slice(0, 80)} —— 只接受公网 http(s) 链接或 data:image/...;base64 内联数据（本地文件上游取不到，请先上传）`);
+				if (normalized === null) {
+					const safe = redactSecrets(raw).slice(0, 80);
+					throw new Error(`imageUrl 不可用：${safe} —— 只接受公网 http(s) 链接或 data:image/...;base64 内联数据（本地文件上游取不到，请先上传）`);
+				}
 				images.push(normalized);
 			}
 			try {
@@ -4884,7 +5174,7 @@ function syncSignaturesAfterPublish(state) {
 * @returns {{reconcile: () => Promise<void>; health: () => {{ lastError: unknown }} }}
 */
 function createProviderReconciler(deps) {
-	const { settings, providerStore, inference, publisher, usageEvents, logger } = deps;
+	const { settings, providerStore, inference, publisher, usageEvents, logger, rosterSeenStore } = deps;
 	/**
 	* 把一次 store 读取收成「值或 null」——**同步抛与异步拒收都降级**。
 	*
@@ -4967,6 +5257,11 @@ function createProviderReconciler(deps) {
 			return;
 		}
 		const entries = Array.isArray(catalog?.entries) ? catalog.entries : [];
+		if (rosterSeenStore !== void 0) try {
+			await rosterSeenStore.note(entries.map((entry) => String(entry?.id ?? "")));
+		} catch (error) {
+			logger?.warn?.(`${name}: roster first-sighting write failed (${redactSecrets(errMsg(error))}) — the new-model marker may miss this pass`);
+		}
 		const enabledIds = resolveEnabledIds(after.enabledIds, publisher.state.enabledIds);
 		const unavailable = await readUnavailable();
 		try {
@@ -5080,7 +5375,7 @@ async function soft(promise) {
 }
 /** 聚合快照 body。wiring 子集见 routes/snapshot.ts 的 Pick。 */
 async function buildSnapshotBody(wiring) {
-	const { settings, tokenStore, usageStore, inference, providerStore, drawStore, usagePrefsStore, publisher } = wiring;
+	const { settings, tokenStore, usageStore, inference, providerStore, drawStore, usagePrefsStore, rosterSeenStore, publisher } = wiring;
 	const panelWindow = await usagePrefsStore.windowDays().catch(() => null);
 	const windowDays = resolveWindowDays(panelWindow, settings.trendDays, settings.retentionDays);
 	const [tokenState, daily, perModel, trend, events, providerNote] = await Promise.all([
@@ -5113,6 +5408,8 @@ async function buildSnapshotBody(wiring) {
 	if (drawNote.ok && drawNote.value !== null) shapeWarnings.push(drawNote.value);
 	const windowNote = await soft((async () => usagePrefsStore.versionNote())());
 	if (windowNote.ok && windowNote.value !== null) shapeWarnings.push(windowNote.value);
+	const rosterNote = await soft((async () => rosterSeenStore.versionNote())());
+	if (rosterNote.ok && rosterNote.value !== null) shapeWarnings.push(rosterNote.value);
 	if (curatedCatalogStale()) {
 		const age = curatedCatalogAgeDays();
 		shapeWarnings.push(`context-catalog: curated windows were last verified on ${CURATED_AS_OF}` + (age === null ? "" : ` (${age} days ago)`) + " — re-check them against the current catalogue");
@@ -5128,6 +5425,7 @@ async function buildSnapshotBody(wiring) {
 		const enabledCount = enabledCountOf(allowedList, roster.map((row) => row.id));
 		const contextWindow = await providerStore.contextWindow().catch(() => null);
 		const catalogNote = models.ok ? null : `模型目录读不到：${models.error}`;
+		const newModelIds = await rosterSeenStore.fresh().catch(() => []);
 		return {
 			enabled,
 			source,
@@ -5139,6 +5437,7 @@ async function buildSnapshotBody(wiring) {
 			allowed: allowedList.mode,
 			enabledIds,
 			contextWindow,
+			newModelIds,
 			roster
 		};
 	})());
@@ -5374,7 +5673,8 @@ function withOrigin(handler, allowedHosts) {
 */
 /**
 * 注册快照路由。wiring 子集：settings / configError / tokenStore /
-* usageStore / inference / providerStore / publisher / logger。
+* usageStore / inference / providerStore / drawStore / usagePrefsStore /
+* rosterSeenStore / publisher / logger。
 * @returns {Function} off() 注销回调。
 */
 function registerSnapshotRoute(ctx, wiring) {
@@ -5663,7 +5963,7 @@ async function readEnabledIds(store, published) {
 * @returns {Function} 依次调用三个 `off()` 的注销回调。
 */
 function registerProviderRoute(ctx, wiring) {
-	const { settings, providerStore, publisher, reconcile, inference, logger } = wiring;
+	const { settings, providerStore, publisher, reconcile, inference, rosterSeenStore, logger } = wiring;
 	/**
 	* 组装一份 §9 响应形状。GET 与成功后的 POST 共用，所以两个方向不可能对「当前
 	* 状态是什么」说两套话。
@@ -5691,6 +5991,7 @@ function registerProviderRoute(ctx, wiring) {
 		const roster = rosterWithAvailability(entries, publisher.state.unavailableIds ?? [], settings.maxTokensOverrides);
 		const allowedList = parseAllowedList(enabledIds);
 		const modelCount = roster.length;
+		const newModelIds = rosterSeenStore === void 0 ? [] : await optional(rosterSeenStore.fresh(), []);
 		return {
 			ok: true,
 			enabled: resolveSwitchEnabled(panelSwitch, settings.registerProvider),
@@ -5703,6 +6004,7 @@ function registerProviderRoute(ctx, wiring) {
 			allowed: allowedList.mode,
 			enabledIds,
 			contextWindow,
+			newModelIds,
 			roster,
 			...catalogError !== null ? { catalogError } : {},
 			...extra
@@ -5848,7 +6150,8 @@ function registerProviderRoute(ctx, wiring) {
 *
 * 一处**与 provider 路由不同**的地方必须说清：provider 开关翻转会**立即**重注册
 * （publish 是活的重建），而出图工具的开关翻转**要等下次 Host 启动**——peer 的
-* tools registry 没有 unregister，工具一旦注册就摘不下来。所以本路由保存成功后
+* tools registry 没有 unregister，工具一旦注册就摘不下来（完整论述见
+* draw-register.ts 文件头注）。所以本路由保存成功后
 * 不改挂载状态，只在响应里给出 `mountPending`，让面板能说清这件事，而不是让用户
 * 以为开关坏了。
 *
@@ -6235,6 +6538,10 @@ function apply(ctx, config = {}, deps = {}) {
 		profile,
 		logger: ctx.logger
 	});
+	const rosterSeenStore = createFileRosterSeenStore({
+		profile,
+		logger: ctx.logger
+	});
 	const publisher = createProviderPublisher({
 		settings,
 		panelSwitch: () => providerStore.enabled(),
@@ -6257,6 +6564,7 @@ function apply(ctx, config = {}, deps = {}) {
 		inference,
 		publisher,
 		usageEvents: () => usageStore.events(),
+		rosterSeenStore,
 		logger: ctx.logger
 	});
 	const wiring = {
@@ -6269,6 +6577,7 @@ function apply(ctx, config = {}, deps = {}) {
 		drawStore,
 		drawJobs,
 		usagePrefsStore,
+		rosterSeenStore,
 		publisher,
 		reconcile,
 		logger: ctx.logger

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-connect-modelscope-token-plan",
   "displayName": "DSH Connect ModelScope Token Plan",
   "icon": "./icon.svg",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "homepage": "https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan",
   "bugs": {
     "url": "https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan/issues"
@@ -35,6 +35,7 @@
     "README.md",
     "CHANGELOG.md",
     "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
     "screenshots.json"
   ],
   "scripts": {
@@ -45,6 +46,11 @@
     "test:mutate": "node tools/dev/mutate.mjs tools/dev/mutate-spec.json",
     "doctor": "node tools/doctor.mjs",
     "doctor:json": "node tools/doctor.mjs --json",
+    "host-range:update": "node tools/update-host-range.mjs",
+    "host-range:check": "node tools/update-host-range.mjs --check",
+    "market-rules:update": "node tools/check-market-rules.mjs",
+    "market-rules:check": "node tools/check-market-rules.mjs --check",
+    "context-catalog:check": "node tools/check-context-catalog.mjs",
     "build": "tsdown -c tsdown.config.mjs",
     "prepack": "npm run build"
   },
@@ -74,22 +80,48 @@
     "@deepseek-ai/dsh-settings": ">=0.1.5 <0.3",
     "@deepseek-ai/dsh-tools": ">=0.1.5 <0.3",
     "@deepseek-ai/schemastery": "^3.18.2",
-    "@earendil-works/pi-ai": "^0.85.1"
+    "@earendil-works/pi-ai": ">=0.85.0 <2.0.0"
   },
   "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": { "optional": true },
-    "@deepseek-ai/dsh-client-locale": { "optional": true },
-    "@deepseek-ai/dsh-client-ui-layout": { "optional": true },
-    "@deepseek-ai/dsh-client-ui-renderer": { "optional": true },
-    "@deepseek-ai/dsh-credentials": { "optional": true },
-    "@deepseek-ai/dsh-home-paths": { "optional": true },
-    "@deepseek-ai/dsh-host-webserver": { "optional": true },
-    "@deepseek-ai/dsh-llm": { "optional": true },
-    "@deepseek-ai/dsh-llm-pi-ai": { "optional": true },
-    "@deepseek-ai/dsh-settings": { "optional": true },
-    "@deepseek-ai/dsh-tools": { "optional": true },
-    "@deepseek-ai/schemastery": { "optional": true },
-    "@earendil-works/pi-ai": { "optional": true }
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-layout": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-renderer": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-credentials": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-home-paths": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-host-webserver": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm-pi-ai": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    },
+    "@earendil-works/pi-ai": {
+      "optional": true
+    }
   },
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -101,6 +133,7 @@
   "license": "MIT",
   "devDependencies": {
     "@types/node": "^22.19.0",
+    "js-yaml": "^5.3.0",
     "jscpd": "^5.4.0",
     "jsdom": "^30.1.3",
     "react": "18.3.1",