dsh-connect-modelscope-token-plan 0.6.2 → 0.6.3

package/CHANGELOG.md

@@ -26,6 +26,52 @@
 > **发版时**：顶部开 `## [X.Y.Z] — YYYY-MM-DD`，完整流程见
 > [RELEASING.md](RELEASING.md) §3（本文开头这段是**写作者规范**，那是**发布操作流程**）。
 
+## [0.6.3] — 2026-10-19
+
+**插件卡头部收敛：「魔搭模型接入」不再在同一屏出现两次**
+
+- 卡内那个与外壳标题同名的大标题删掉了。插件名只由外壳在插件区正上方打印（取自
+  `locale/<lang>.json` 的 `meta.title`），卡内复述它会让同一个字符串在一屏出现两次、
+  中间隔着外壳给所有插件的 32px 固定间隔，读起来像一个断成两半的表头。
+- 原先独占一行、左半边空着的「更新于 / 刷新」并入 tab 行右侧；tab 条下方那条分隔线
+  改由整行承担，激活 tab 的 2px 下划线正好压在线上。刷新按钮与「更新于」留在
+  `role="tablist"` 之外——读屏不会再把它们当成 tab 念。
+- 卡内自带的 16/56 纵向内边距一并归零：它们叠加在外壳已给的 32px 段间距与 48px
+  页底之上，使描述到 tab 之间空了 48px、页尾空了 104px。横向留白本来就由外壳负责，
+  卡内一直是 0，本次不动。
+
+**出图工具：失败文案不再替上游编原因，「停止」立即生效**
+
+- 出图报 401/403 时不再一律附注「账号未完成邮箱验证/实名」：只有上游 body 点名了邮箱或
+  实名（含英文 `email verification`）才照说，否则只说「令牌无效或无权访问该模型」。同一个
+  401 也覆盖令牌过期，把实测遇到过一次的形态写成固定附注，等于替上游编造原因。
+- 轮询遇到非 2xx 不再报「任务停在 RUNNING（非终态），已超过截止时间」：上一轮的读数
+  只是上下文，本轮没读到就是没读到，HTTP 状态码与上游 body 照实带出。
+- 等待中被撤下（插件卸载 / 热重挂）立即以 `pending` 收场并交回 `jobId`，不再等满等待
+  预算；停止也能中止**在途的轮询请求**，不再只是中断本地 sleep。
+- 出图作业表改由装配处统一创建与销毁：卸载后不再残留作业记录，`jobId` 续查读的也
+  始终是同一张表。`jobId` 只在本次挂载内有效，pending 提示现在把这点写明（重启 DSH
+  或重挂插件后要重新提交）。一次出图调用的硬超时不再可能比 `drawTimeoutMs` 上限多出 10 秒。
+- 上游任务 FAILED 且响应体里**真写了**原因时照实报出（此前一律说「未给出失败原因」，
+  把 `sensitive content detected` 这类 body 一起吞掉），且失败响应体一律附上——这是
+  全函数唯一不附 body 的分支。
+
+**面板与胶囊：读不到的时候不再假装知道**
+
+- 面板读失败时错误行照常显示，不再要求「上一轮的数据还在」；数据还在时另起一句
+  「下面是上次读到的数据」。此前首屏成功过、Host 随后挂掉时，界面是「上一轮的数字
+  + 完好的状态簇 + 一句沉默」：故障窗口越长，越像一份可信的实时读数——胶囊在同一
+  情形下是挂「上次数据」标的，同一种「读不到」两种待遇。
+- 模型目录读不到时 provider 卡现在说明原因。此前是「已注册 · 0 个模型」加一片空白：
+  0 个模型是真的，而「为什么是 0」没人说，旧 roster 其实还在服务。
+- 对话框胶囊只在**本帧真有读数**时才标「上次数据」。连续读失败时两个读数是「—」，
+  此前仍给「—」挂这个标签——它在描述一份屏幕上并不存在的数据。
+- 粘贴带前后空白的令牌不再存成一个发不出去的 `Authorization` 头（此前校验时忽略空白、
+  落库时保留原值，面板还显示「已保存」）。
+
+> **实施过程（病灶取证、判据、为何不抵消外壳间距）在
+> [docs/archive/2026-10-19-0.6.3-process.md](docs/archive/2026-10-19-0.6.3-process.md)**。
+
 ## [0.6.2] — 2026-10-18
 
 **插件命名与卡片文案以「模型接入」为主题重排**

package/client.js

@@ -29,7 +29,6 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			"events",
 			"trend",
 			"models",
-			"provider",
 			"shapeWarnings",
 			"quotaError"
 		]);
@@ -136,11 +135,11 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 	var zh, en;
 	var init_i18n = __esmMin((() => {
 		zh = {
-			"panel.title": "魔搭模型接入",
 			"panel.refresh": "刷新",
 			"panel.updated": "更新于 {time}",
 			"panel.loading": "加载中…",
 			"panel.error": "读取失败：{error}",
+			"panel.staleData": "（下面是上次读到的数据）",
 			"panel.configError": "插件配置有误：{error}",
 			"panel.networkError": "无法连接本机 Host，通常是临时故障，下一轮自动刷新即可恢复。",
 			"panel.timeout": "请求超时，下一轮自动刷新即可恢复。",
@@ -288,11 +287,11 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			"composer.stale": "上次数据"
 		};
 		en = {
-			"panel.title": "ModelScope Model Access",
 			"panel.refresh": "Refresh",
 			"panel.updated": "Updated {time}",
 			"panel.loading": "Loading…",
 			"panel.error": "Read failed: {error}",
+			"panel.staleData": "(showing the last data read successfully)",
 			"panel.configError": "Plugin misconfiguration: {error}",
 			"panel.networkError": "Cannot reach the local Host — usually transient, the next auto-refresh will recover.",
 			"panel.timeout": "Request timed out; the next auto-refresh will recover.",
@@ -573,31 +572,24 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 				fontSize: 14,
 				lineHeight: "22px"
 			},
-			headerBar: {
-				flex: "none",
-				background: "var(--dsw-alias-bg-base)",
-				position: "relative",
-				zIndex: 1
-			},
-			header: {
-				display: "flex",
-				alignItems: "center",
-				gap: 12,
-				padding: "16px 0 12px"
-			},
 			scroll: {
 				flex: 1,
 				minHeight: 0,
 				overflowY: "auto",
 				overflowX: "hidden"
 			},
-			content: { padding: "6px 0 56px" },
-			tabBar: {
+			content: { padding: 0 },
+			tabRow: {
 				display: "flex",
-				gap: 4,
+				alignItems: "stretch",
+				gap: 12,
 				borderBottom: "1px solid var(--dsw-alias-border-l1)",
 				marginBottom: 4
 			},
+			tabBar: {
+				display: "flex",
+				gap: 4
+			},
 			tab: {
 				appearance: "none",
 				background: "none",
@@ -607,19 +599,15 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 				fontSize: 13,
 				color: "var(--dsw-alias-label-secondary)",
 				cursor: "pointer",
-				outlineOffset: -2
+				outlineOffset: -2,
+				display: "flex",
+				alignItems: "center"
 			},
 			tabActive: {
 				color: "var(--dsw-alias-label-primary)",
 				fontWeight: 600,
 				borderBottom: `2px solid ${BRAND}`
 			},
-			title: {
-				margin: 0,
-				fontSize: 20,
-				fontWeight: 600,
-				lineHeight: "28px"
-			},
 			updated: {
 				color: "var(--dsw-alias-label-secondary)",
 				fontSize: 12
@@ -630,7 +618,8 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 				alignItems: "center",
 				gap: 12,
 				flexWrap: "wrap",
-				justifyContent: "flex-end"
+				justifyContent: "flex-end",
+				alignSelf: "center"
 			},
 			button: BUTTON,
 			sectionTitle: {
@@ -2852,15 +2841,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 		return h("div", {
 			style: S.page,
 			"data-dsh-plugin": PANEL_ID
-		}, h("div", { style: S.headerBar }, h("div", { style: S.header }, h("h1", { style: S.title }, tt("panel.title")), h("span", { style: S.spacer }), h("span", { style: S.cluster }, data !== null ? h("span", { style: S.updated }, format(tt("panel.updated"), { time: isoTime(new Date(updatedAt).toISOString()) })) : null, failure !== null && data !== null ? h("span", {
-			style: S.error,
-			role: "status",
-			title: failure.message
-		}, format(tt("panel.error"), { error: failure.message })) : null, h("button", {
-			type: "button",
-			style: S.button,
-			onClick: () => void load()
-		}, tt("panel.refresh"))))), h("div", { style: S.scroll }, h("div", { style: S.content }, h("div", null, h("div", {
+		}, h("div", { style: S.scroll }, h("div", { style: S.content }, h("div", null, h("div", { style: S.tabRow }, h("div", {
 			style: S.tabBar,
 			role: "tablist"
 		}, h("button", {
@@ -2890,7 +2871,15 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 				...activeTab === "access" ? S.tabActive : {}
 			},
 			onClick: () => setActiveTab("access")
-		}, tt("tab.access"))), data !== null && shapeWarnings.length > 0 ? h("div", {
+		}, tt("tab.access"))), h("span", { style: S.spacer }), h("span", { style: S.cluster }, data !== null ? h("span", { style: S.updated }, format(tt("panel.updated"), { time: isoTime(new Date(updatedAt).toISOString()) })) : null, failure !== null ? h("span", {
+			style: S.error,
+			role: "status",
+			title: failure.message
+		}, format(tt("panel.error"), { error: failure.message })) : null, failure !== null && data !== null ? h("span", { style: S.updated }, tt("panel.staleData")) : null, h("button", {
+			type: "button",
+			style: S.button,
+			onClick: () => void load()
+		}, tt("panel.refresh")))), data !== null && shapeWarnings.length > 0 ? h("div", {
 			style: S.formError,
 			role: "status"
 		}, format(tt("panel.shapeDrift"), { detail: shapeWarnings.join("; ") })) : null, activeTab === "quota" ? quotaBody() : activeTab === "models" ? modelsBody() : accessBody()))));
@@ -2978,10 +2967,17 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 	* ——失败退避或页面被挂起都会这样。取 3 个声明周期而不是 1 个：一次偶发失败就会
 	* 拉长间隔，卡在 1 个周期上会让每一次抖动都把读数打成陈旧的。
 	*
-	* `updatedAt === 0` 表示**从没读到过**，那不是「陈旧」而是「还没有」——调用方据此
-	* 决定不标；本函数只在有读数的前提下判断，故返回 false。
+	* **`hasReading` 是承重输入**：`updatedAt > 0` 只说明**曾经**读到过，不说明屏幕上
+	* 此刻有数字——读失败时轮询 hook 会 `setData(null)` 却保留 `updatedAt`
+	* （`use-snapshot-polling.ts`），只看 updatedAt 就会在两个读数都是「—」时挂上
+	* 「上次数据」，描述一份不在屏幕上的数据（2026-10-19 锐评实测）。调用方必须把
+	* 「本帧有没有读数」传进来。
+	*
+	* `hasReading === false` 表示**从没读到过 / 这一帧没有读数**，那不是「陈旧」而是
+	* 「还没有」——调用方据此不标；本函数据此返回 false。
 	*/
 	function staleOf(input) {
+		if (!input.hasReading) return false;
 		if (input.error !== null && input.error !== void 0) return input.updatedAt > 0;
 		return input.updatedAt > 0 && input.now - input.updatedAt > input.cadenceMs * STALE_CADENCES;
 	}
@@ -3015,6 +3011,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 		const cadenceMs = statedCadenceMs(data?.pollSeconds, DEFAULT_CADENCE_MS);
 		const stale = staleOf({
 			error,
+			hasReading: data !== null,
 			updatedAt,
 			now: Date.now(),
 			cadenceMs

package/lib/host-config.js

@@ -1,13 +1,13 @@
 //#region src/host/util.ts
-/** 读一个有限的正数，否则回退值。 */
-function num(value, fallback) {
+/** 读一个有限的正数，否则回退值（调用方一律传 number 回退，返回值不再 any）。 */
+function num(value, fallback = 0) {
 	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : fallback;
 }
-/** 读一个非空字符串，否则回退值。 */
-function str(value, fallback) {
+/** 读一个非空字符串，否则回退值（调用方一律传 string 回退，返回值收窄为 string）。 */
+function str(value, fallback = "") {
 	return typeof value === "string" && value.trim() !== "" ? value.trim() : fallback;
 }
-/** 读一个普通对象，否则 `{}`。 */
+/** 读一个普通对象，否则 `{}`（返回值给具体形状：点号访问合法、赋值不再绕过检查）。 */
 function obj(value) {
 	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
@@ -16,7 +16,7 @@ function errMsg(value) {
 	return value instanceof Error ? value.message : String(value);
 }
 /** 原样读字符串（凭据专用：trim 是用户看不见的改动）。 */
-function verbatim(value, fallback) {
+function verbatim(value, fallback = "") {
 	return typeof value === "string" ? value : fallback;
 }
 /**
@@ -291,7 +291,20 @@ async function* reclassifyStream(source) {
 * 「点隐藏反而全放出来」。
 */
 const HIDE_ALL_MODELS = "__hide_all__";
-/** 钉死清单：任何新增顶层字段都必须先过 test/wire.test.mjs。 */
+/**
+* 钉死清单：任何新增顶层字段都必须先过 test/wire.test.mjs。
+*
+* **可选块不得进这份清单**——这不是排版洁癖，是 53c9902 的修复曾经被它架空的
+* 事故的结论：`provider` 改成可选（Host 软失败时省略）之后仍留在这里，于是客户端
+* 把「Host 按契约省略」当成契约破裂，先把 `DEGRADED_PROVIDER` 补进 body，再据此
+* 判定「块在」，**兜底 `GET /provider` 一次都没跑**，还给用户挂一条假的漂移警告。
+* `draw` 先可选、也先移出清单，所以它没有这个问题——两个块走同一条纪律，清单里
+* 就必须同样缺席。
+*
+* 判据：`Snapshot` 接口里带 `?` 的顶层字段，这里**必须**没有。
+* test/wire.test.mjs 机械解析该接口做三向交叉：必给字段集合 === 本清单、可选
+* 字段 ∩ 清单 = ∅、可选字段集合 === 可选块名字清单——清单腐化或漏登记都判红。
+*/
 const SNAPSHOT_REQUIRED_KEYS = Object.freeze([
 	"ok",
 	"name",
@@ -305,7 +318,6 @@ const SNAPSHOT_REQUIRED_KEYS = Object.freeze([
 	"events",
 	"trend",
 	"models",
-	"provider",
 	"shapeWarnings",
 	"quotaError"
 ]);
@@ -1129,7 +1141,7 @@ const inject = ["webServer"];
 * 产物反而引入第二份真源；这里用常量、由 test/config.test.mjs 钉住与
 * package.json 一致。
 */
-const PLUGIN_VERSION = "0.6.2";
+const PLUGIN_VERSION = "0.6.3";
 /**
 * 默认值。刻意不含额度常数——理由见本文件头。
 * 面板头条是官方魔粒余额，次数口径的推算已在面板收敛时删除，这里若留着
@@ -1441,4 +1453,4 @@ function isAdmitted(request, allowedHosts) {
 }
 
 //#endregion
-export { errMsg as C, redactSecrets as D, pluginError as E, str as O, degrade as S, optional as T, parseAllowedList as _, resolveSettings as a, looksLikeRateLimit as b, LLM_PROVIDER_ID as c, imageGenModelIds as d, isVisionModel as f, enabledCountOf as g, rosterWithAvailability as h, name as i, verbatim as k, buildDescriptors as l, resolveDrawModelChoice as m, inject as n, LLM_API_KEY_NAME as o, normalizeEntry as p, isAdmitted as r, LLM_DISPLAY_NAME as s, PLUGIN_VERSION as t, drawCandidates as u, CODE as v, obj as w, reclassifyStream as x, hasHardQuotaWordingIn as y };
+export { verbatim as A, degrade as C, pluginError as D, optional as E, redactSecrets as O, reclassifyStream as S, obj as T, enabledCountOf as _, name as a, hasHardQuotaWordingIn as b, LLM_DISPLAY_NAME as c, drawCandidates as d, imageGenModelIds as f, rosterWithAvailability as g, resolveDrawModelChoice as h, isAdmitted as i, str as k, LLM_PROVIDER_ID as l, normalizeEntry as m, PLUGIN_VERSION as n, resolveSettings as o, isVisionModel as p, inject as r, LLM_API_KEY_NAME as s, DRAW_TIMEOUT_MAX_MS as t, buildDescriptors as u, parseAllowedList as v, errMsg as w, looksLikeRateLimit as x, CODE as y };

package/lib/index.js

@@ -1,4 +1,4 @@
-import { C as errMsg, D as redactSecrets, E as pluginError, O as str, S as degrade, T as optional, _ as parseAllowedList, a as resolveSettings, b as looksLikeRateLimit, c as LLM_PROVIDER_ID, d as imageGenModelIds, f as isVisionModel, g as enabledCountOf, h as rosterWithAvailability, i as name, k as verbatim, m as resolveDrawModelChoice, n as inject, p as normalizeEntry, r as isAdmitted, s as LLM_DISPLAY_NAME, t as PLUGIN_VERSION, u as drawCandidates, w as obj, y as hasHardQuotaWordingIn } from "./host-config.js";
+import { A as verbatim, C as degrade, D as pluginError, E as optional, O as redactSecrets, T as obj, _ as enabledCountOf, a as name, b as hasHardQuotaWordingIn, c as LLM_DISPLAY_NAME, d as drawCandidates, f as imageGenModelIds, g as rosterWithAvailability, h as resolveDrawModelChoice, i as isAdmitted, k as str, l as LLM_PROVIDER_ID, m as normalizeEntry, n as PLUGIN_VERSION, o as resolveSettings, p as isVisionModel, r as inject, t as DRAW_TIMEOUT_MAX_MS, v as parseAllowedList, w as errMsg, x as looksLikeRateLimit } from "./host-config.js";
 import { basename, join } from "node:path";
 import { mkdir, open, readFile, rename, stat, unlink, writeFile } from "node:fs/promises";
 import { randomUUID } from "node:crypto";
@@ -130,7 +130,13 @@ function createTokenStore({ credentials = null, env = process.env } = {}) {
 	};
 	return {
 		/**
-		* 把面板输入的令牌存成引用；原样存（不 trim），空白值视为没输入。
+		* 把面板输入的令牌存成引用；**两端空白先 trim**，空白值视为没输入。
+		*
+		* **为什么 trim 而不是原样存**：校验用的是 `value.trim()`，落库却曾是原值——
+		* 校验与落库必须是**同一个值**，否则「通过校验的值」与「发出去的值」不是一个东西。
+		* 实测（2026-10-19）：`save("  ms-3f2a…  ")` 会把带着前后空格的串存进凭据服务，
+		* 而它拼出的请求头是 `Bearer   ms-…  `——用户粘进一个空格就换来一个语焉不详的
+		* 401，面板却显示「已保存」。只 trim 两端，令牌中间的形状（分段连字符）不动。
 		*
 		* **形状校验**：只接受 `ms-` + 至少 16 位十六进制（可含连字符分段）。这不是
 		* 洁癖——`redactSecrets` 的脱敏闸是**正则**，只能遮它认识的形状；一个
@@ -143,9 +149,9 @@ function createTokenStore({ credentials = null, env = process.env } = {}) {
 		* 真机请求换来一个语焉不详的 401。
 		*/
 		async save(token) {
-			const value = verbatim(token, "");
-			if (typeof value !== "string" || value.trim() === "") throw new Error("a ModelScope token is required");
-			if (!isPlausibleToken(value.trim())) throw new Error("that does not look like a ModelScope access token (expected ms- followed by at least 16 hex digits); if you are sure the token is correct, this plugin's shape check may be out of date");
+			const value = verbatim(token, "").trim();
+			if (value === "") throw new Error("a ModelScope token is required");
+			if (!isPlausibleToken(value)) throw new Error("that does not look like a ModelScope access token (expected ms- followed by at least 16 hex digits); if you are sure the token is correct, this plugin's shape check may be out of date");
 			const service = resolveService();
 			if (service !== null && typeof service.set === "function") {
 				await service.set(TOKEN_REF, value);
@@ -424,17 +430,6 @@ function temporaryOf(dir, base, now = Date.now) {
 	return join(dir, `${base}.${process.pid}.${now()}.${randomUUID()}.tmp`);
 }
 /**
-* Write one state file atomically: a 0600 temporary file, then a rename.
-*
-* The payload string is written with a trailing newline, exactly as every
-* store wrote before this module existed. Failures PROPAGATE — the callers
-* decide whether a read-only Home breaks their flow.
-* @param {string} file - the final file path.
-* @param {string} payload - the serialized body (JSON text).
-* @param {{temporary: string}} options - the temp path to write first.
-* @returns {Promise<void>}
-*/
-/**
 * 写一个状态文件：一个 0600 临时文件，然后 rename。
 *
 * 载荷串以换行结尾，与本模块存在前每个 store 的写法一致。失败**向上传播** ——
@@ -1905,7 +1900,10 @@ function createInferenceClient({ settings, tokenStore, deps = {}, logger }) {
 				const extra = retryAfterMs !== null && retryAfterMs !== void 0 ? { retryAfterMs } : {};
 				throw pluginError(triage === "quota" ? CODE.QUOTA_EXCEEDED : CODE.RATE_LIMITED, redactSecrets(message === "" ? "modelscope returned 429 (probe on " + modelId + ")" : message), extra);
 			}
-			if (response.status >= 500) throw pluginError(CODE.UPSTREAM_ERROR, "modelscope returned HTTP " + String(response.status) + " (validity probe)");
+			if (response.status >= 500) {
+				discardBody(response);
+				throw pluginError(CODE.UPSTREAM_ERROR, "modelscope returned HTTP " + String(response.status) + " (validity probe)");
+			}
 			response.body?.cancel();
 			return {
 				ok: true,
@@ -2615,6 +2613,62 @@ function createFileDrawStore(options = {}) {
 	};
 }
 
+//#endregion
+//#region src/host/draw-jobs.ts
+/**
+* 建一张出图作业表。
+* @param {DrawJobsOptions} [options] - 容量上限。
+* @returns {DrawJobs} 作业表。
+*/
+function createDrawJobs(options = {}) {
+	const maxJobs = Math.max(1, Math.floor(options.maxJobs ?? 64));
+	/** @type {Map<string, DrawJob>} 插入顺序即淘汰顺序（Map 保序）。 */
+	const jobs = /* @__PURE__ */ new Map();
+	const evictIfNeeded = () => {
+		while (jobs.size > maxJobs) {
+			const oldest = jobs.keys().next();
+			if (oldest.done === true) return;
+			jobs.delete(oldest.value);
+		}
+	};
+	return {
+		create({ taskId, model, prompt, now }) {
+			const jobId = taskId;
+			const job = {
+				jobId,
+				taskId,
+				model,
+				prompt,
+				submittedAt: typeof now === "number" && Number.isFinite(now) ? now : Date.now(),
+				polls: 0
+			};
+			const previous = jobs.get(jobId);
+			if (previous !== void 0) job.polls = previous.polls;
+			jobs.set(jobId, job);
+			evictIfNeeded();
+			return { ...job };
+		},
+		get(jobId) {
+			const found = jobs.get(jobId);
+			return found === void 0 ? null : { ...found };
+		},
+		notePolls(jobId, polls) {
+			const found = jobs.get(jobId);
+			if (found === void 0) return;
+			found.polls += Math.max(0, Math.floor(polls));
+		},
+		drop(jobId) {
+			jobs.delete(jobId);
+		},
+		dispose() {
+			jobs.clear();
+		},
+		size() {
+			return jobs.size;
+		}
+	};
+}
+
 //#endregion
 //#region src/host/switch-precedence.ts
 /**
@@ -2917,9 +2971,11 @@ function createFileUsagePrefsStore(options = {}) {
 *    缺这个头的实现会在第一次轮询就误判失败并放弃一张已经能出的图。
 * 2. **提交响应的 `task_status` 不可信**：实测每次提交都回 `SUCCEED`，包括最终确实
 *    `FAILED` 的那次。所以提交只认 `task_id`，**成功与否只看轮询终态**。
-* 3. **`FAILED` 没有可分诊的形状**：`errors.code` 实测为 `0`、`errors.message` 为
-*    空串，没有顶层 `message`。任何「从错误里读出原因」的承诺都是编造——本模块的
-*    `describeDrawFailure` 因此**明确承认原因不可知**，只报可确定的形态差异。
+* 3. **`FAILED` 常常没有可分诊的形状**：实测样本 `errors.code` 为 `0`、
+*    `errors.message` 为空串、没有顶层 `message`。所以不能承诺「一定读得出原因」——
+*    本模块的 `describeDrawFailure` 只报**这个 body 里确实写着**的东西：读得到
+*    `errors.message` 就报它，读不到就明说原因不可知（2026-10-19 修补：旧写法把
+*    「实测样本为空」当成了「永远为空」，非空原因会被一并报成「未给出原因」）。
 *
 * 关于两个小工具（`str` / `redactSecrets`）：它们曾以**本地私有副本**的形式活在
 * 本文件里，理由是「避免为 3 行代码引 util 的依赖面」。那条理由不成立——util.ts
@@ -3120,13 +3176,31 @@ function normalizeImageUrlInput(value) {
 	return null;
 }
 /**
+* 从上游 body 里取第一句**可引用的原因**：`errors.message`，退回顶层 `message`。
+*
+* 取的是**未截断**的原文——`describeDrawFailure` 的 tail 会截到 300 字符，截断后的
+* JSON 解析不出来。解析不出来（非 JSON / 字段为空 / 字段不是字符串）一律返回 `""`：
+* 这里**不猜**，没有原因就说没有原因。
+*/
+function upstreamMessageOf(raw) {
+	if (raw === "") return "";
+	try {
+		const parsed = JSON.parse(raw);
+		for (const candidate of [parsed?.errors?.message, parsed?.message]) if (typeof candidate === "string" && candidate.trim() !== "") return candidate.trim();
+	} catch {}
+	return "";
+}
+/**
 * 把一次失败转成 agent 与面板都能读的一句话。
 *
-* **关于魔搭 `FAILED` 的诚实边界**：实测唯一的失败样本是
-* `{"errors":{"code":0,"message":""}, "task_status":"FAILED"}`——**原因不可知**。
-* 所以这里只报「可确定的形态事实」（HTTP 码 / 轮询未出终态 / 明确的原因文本），
-* **不从空错误里编造原因**，并在原因确实拿不到时明说「上游未给出原因」。这是本仓库
-* README「诚实声明」的要求。
+* **关于魔搭 `FAILED` 的诚实边界**：实测见过的失败样本是
+* `{"errors":{"code":0,"message":""}, "task_status":"FAILED"}`——那一份**原因不可知**。
+* 但样本量是 1，不是恒定形态：上游也可能给出非空的 `errors.message`
+* （2026-10-19 锐评实测 `sensitive content detected`、
+* `image_url is required for model MusePublic/Qwen-Image-Edit` 这类原因会被旧写法
+* 一并报成「未给出失败原因」，且 body 被丢掉，2/2 误报）。所以判据是**逐个 body 判**：
+* 有原因就报原因，确实没有才明说「上游未给出原因」；任何情况下都不从空错误里编造
+* 原因，两种情况**都附脱敏后的 body**。这是本仓库 README「诚实声明」的要求。
 *
 * 凭据永不入消息：body 文本可能回显 `ms-` 令牌，过 `redactSecrets` 后再截断。
 * @param {object} failure - 失败信息。
@@ -3137,17 +3211,22 @@ function normalizeImageUrlInput(value) {
 * @returns {string} 一行说明。
 */
 function describeDrawFailure(failure) {
-	const text = redactSecrets(typeof failure.bodyText === "string" ? failure.bodyText : "").slice(0, 300);
+	const raw = typeof failure.bodyText === "string" ? failure.bodyText : "";
+	const text = redactSecrets(raw).slice(0, 300);
 	const status = Number.isFinite(failure.status) ? Number(failure.status) : 0;
 	const tail = text === "" ? "" : `; body: ${text}`;
-	if (status === 401 || status === 403) return `出图失败：HTTP ${status} —— 访问令牌无效、无权访问该模型，或账号未完成邮箱验证/实名（后者是实测遇到过的真实拦截）。请在面板确认令牌与账号状态${tail}`;
+	if (status === 401 || status === 403) return `出图失败：HTTP ${status} —— ${/邮箱|实名|email[^\n]{0,40}verif|verif\w*[^\n]{0,40}email|complete\s+your\s+profile/i.test(text) ? "访问令牌无效、无权访问该模型，或账号未完成邮箱验证/实名（上游 body 提到了账号态）" : "访问令牌无效或无权访问该模型（上游未指明具体原因）"}。请在面板确认令牌与账号状态${tail}`;
 	if (status === 404) return `出图失败：HTTP 404 —— 端点或模型不存在（检查 apiBase 与模型 id）${tail}`;
 	if (status === 429) return `出图失败：HTTP 429 —— 上游限流，请稍后重试${tail}`;
 	if (status >= 500) return `出图失败：HTTP ${status} —— 上游服务异常，稍后重试${tail}`;
 	const cause = str(failure.cause, "");
-	if (cause !== "") return `出图失败：${cause}${tail}`;
+	if (cause !== "") return `出图失败：${redactSecrets(cause)}${tail}`;
 	const taskStatus = str(failure.taskStatus, "");
-	if (taskStatus === "FAILED") return "出图失败：上游任务 FAILED，但未给出失败原因（实测 errors.code=0、message 为空），换模型或稍后重试";
+	if (taskStatus === "FAILED") {
+		const upstream = upstreamMessageOf(raw);
+		if (upstream !== "") return `出图失败：上游任务 FAILED —— ${redactSecrets(upstream)}${tail}`;
+		return `出图失败：上游任务 FAILED，但未给出失败原因（上游 errors.message 为空），换模型或稍后重试${tail}`;
+	}
 	if (taskStatus !== "") return `出图失败：任务停在 ${taskStatus}（非终态），已超过截止时间`;
 	return `出图失败：上游未给出可诊断的失败信息${tail}`;
 }
@@ -3178,62 +3257,6 @@ function createDrawCooldown(cooldownMs) {
 	};
 }
 
-//#endregion
-//#region src/host/draw-jobs.ts
-/**
-* 建一张出图作业表。
-* @param {DrawJobsOptions} [options] - 容量上限。
-* @returns {DrawJobs} 作业表。
-*/
-function createDrawJobs(options = {}) {
-	const maxJobs = Math.max(1, Math.floor(options.maxJobs ?? 64));
-	/** @type {Map<string, DrawJob>} 插入顺序即淘汰顺序（Map 保序）。 */
-	const jobs = /* @__PURE__ */ new Map();
-	const evictIfNeeded = () => {
-		while (jobs.size > maxJobs) {
-			const oldest = jobs.keys().next();
-			if (oldest.done === true) return;
-			jobs.delete(oldest.value);
-		}
-	};
-	return {
-		create({ taskId, model, prompt, now }) {
-			const jobId = taskId;
-			const job = {
-				jobId,
-				taskId,
-				model,
-				prompt,
-				submittedAt: typeof now === "number" && Number.isFinite(now) ? now : Date.now(),
-				polls: 0
-			};
-			const previous = jobs.get(jobId);
-			if (previous !== void 0) job.polls = previous.polls;
-			jobs.set(jobId, job);
-			evictIfNeeded();
-			return { ...job };
-		},
-		get(jobId) {
-			const found = jobs.get(jobId);
-			return found === void 0 ? null : { ...found };
-		},
-		notePolls(jobId, polls) {
-			const found = jobs.get(jobId);
-			if (found === void 0) return;
-			found.polls += Math.max(0, Math.floor(polls));
-		},
-		drop(jobId) {
-			jobs.delete(jobId);
-		},
-		dispose() {
-			jobs.clear();
-		},
-		size() {
-			return jobs.size;
-		}
-	};
-}
-
 //#endregion
 //#region src/host/draw-runtime.ts
 /**
@@ -3271,6 +3294,13 @@ const DRAW_TOOL_NAME = "modelscope_draw_image";
 /** 一次失败的冷却窗：出图慢，失败后立刻重试既易撞限流又白等。 */
 const DRAW_FAILURE_COOLDOWN_MS = 6e4;
 /**
+* 工具级硬护栏比单次等待预算多出的余量。
+*
+* 它保证**等待循环先返回**：护栏若与等待预算同值，正常路径会以 peer 的超时错误
+* 结束，而不是带 `jobId` 的 `pending`——那会把续查这条唯一的把手换成一个死胡同。
+*/
+const DRAW_TOOL_TIMEOUT_MARGIN_MS = 1e4;
+/**
 * 把 OpenAI 兼容 base 拼成出图端点。
 *
 * `…/v1` → `…/v1/images/generations`；已带该后缀则原样；更深路径回卷到 `/v1`。
@@ -3372,9 +3402,12 @@ async function submitDrawTask({ fetchImpl, apiBase, apiKey, model, prompt, image
 * @param {string} options.taskId - 上游任务 id。
 * @param {number} [options.waitMs] - 本次调用的等待预算。
 * @param {number} [options.pollIntervalMs] - 轮询间隔（测试可缩短）。
+* @param {() => boolean} [options.shouldStop] - 每轮轮询前问一次「还要不要继续」
+*   （撤下闸）。`signal` 只能表达**已经**中止，问不出「刚刚被撤下」——等待循环是
+*   本模块唯一的循环，撤下只有在这里能被周期性看见。
 * @returns {Promise<DrawAwait>} 三种结局之一。
 */
-async function awaitDrawTask({ fetchImpl, apiBase, apiKey, taskId, waitMs = DRAW_WAIT_BUDGET_MS, pollIntervalMs = DRAW_POLL_INTERVAL_MS, signal }) {
+async function awaitDrawTask({ fetchImpl, apiBase, apiKey, taskId, waitMs = DRAW_WAIT_BUDGET_MS, pollIntervalMs = DRAW_POLL_INTERVAL_MS, signal, shouldStop }) {
 	const headers = {
 		Authorization: `Bearer ${apiKey}`,
 		"Content-Type": "application/json"
@@ -3388,6 +3421,10 @@ async function awaitDrawTask({ fetchImpl, apiBase, apiKey, taskId, waitMs = DRAW
 			kind: "pending",
 			polls
 		};
+		if (shouldStop?.() === true) return {
+			kind: "pending",
+			polls
+		};
 		try {
 			await sleep(interval, signal);
 		} catch {
@@ -3404,20 +3441,28 @@ async function awaitDrawTask({ fetchImpl, apiBase, apiKey, taskId, waitMs = DRAW
 				headers: {
 					...headers,
 					[TASK_TYPE_HEADER]: TASK_TYPE_IMAGE_GENERATION
-				}
+				},
+				...signal !== void 0 ? { signal } : {}
 			});
 		} catch {
+			if (signal?.aborted === true) return {
+				kind: "pending",
+				polls
+			};
 			continue;
 		}
 		const pollText = await safeText(polled);
-		if (!polled.ok) return {
-			kind: "failed",
-			message: describeDrawFailure({
-				...polled.status !== void 0 ? { status: polled.status } : {},
-				...pollText !== "" ? { bodyText: pollText } : {},
-				...lastStatus !== void 0 ? { taskStatus: lastStatus } : {}
-			})
-		};
+		if (!polled.ok) {
+			const previous = lastStatus !== void 0 ? `（上一轮读到 ${lastStatus}）` : "";
+			return {
+				kind: "failed",
+				message: describeDrawFailure({
+					...polled.status !== void 0 ? { status: polled.status } : {},
+					...pollText !== "" ? { bodyText: pollText } : {},
+					cause: `轮询请求失败：HTTP ${polled.status ?? "未知"}，本轮未读到任务状态${previous}`
+				})
+			};
+		}
 		const data = await safeJson(polled, pollText);
 		const status = readTaskStatus(data);
 		if (status !== null) lastStatus = status;
@@ -3516,21 +3561,34 @@ function drawModelIds(entries) {
 * @returns {unknown} 已定义的 agent 工具。
 */
 function defineDrawTool({ defineTool, fetchImpl, resolveApiKey, getEntries, settings, getPreferredModelId, cooldown = createDrawCooldown(DRAW_FAILURE_COOLDOWN_MS), jobs = createDrawJobs(), pollIntervalMs = DRAW_POLL_INTERVAL_MS, isDisposed = () => false }) {
-	/** 总放弃线：从提交算起，跨多次调用累计。 */
-	const timeoutMs = Math.max(3e4, Math.floor(Number(settings?.drawTimeoutMs) > 0 ? Number(settings?.drawTimeoutMs) : DRAW_TIMEOUT_MS));
+	/**
+	* 总放弃线：从提交算起，跨多次调用累计。
+	*
+	* 上下界与 `host-config.resolveSettings` 同源，这里再夹一次是为了让本函数的
+	* 不变式**自足**：`waitMs + margin <= timeoutMs <= DRAW_TIMEOUT_MAX_MS`（见下面
+	* `waitMs` 与工具定义里的 `timeoutMs`）。直接调用本函数（不经配置层）时也成立。
+	*/
+	const timeoutMs = Math.min(DRAW_TIMEOUT_MAX_MS, Math.max(3e4, Math.floor(Number(settings?.drawTimeoutMs) > 0 ? Number(settings?.drawTimeoutMs) : DRAW_TIMEOUT_MS)));
 	/**
 	* 单次调用愿意等的时间。
 	*
-	* 只夹**上界**（不该超过总放弃线，超过它的等待没有意义）；下界交给
-	* `host-config` 的 `drawWaitMs` clamp——同一个数在两处各夹一次，上限/下限就会
-	* 各说一套话（`drawTimeoutMs` 的 clamp 早已是本仓库的教训）。
+	* 上界是 `timeoutMs - margin`，**不是** `timeoutMs`：工具的硬护栏取
+	* `waitMs + margin`，若允许两者相等，护栏就会越过 `DRAW_TIMEOUT_MAX_MS`
+	* （配置允许 `drawWaitMs == drawTimeoutMs`，上限 1_800_000 → 护栏 1_810_000），
+	* 且「等待循环先返回」从结构保证退化成「用户不会把两个值设成相等」的运气。
+	* 下界交给 `host-config` 的 `drawWaitMs` clamp——同一个数在两处各夹一次，上限/
+	* 下限就会各说一套话（`drawTimeoutMs` 的 clamp 早已是本仓库的教训）。
 	*/
-	const waitMs = Math.min(timeoutMs, Math.max(1, Math.floor(Number(settings?.drawWaitMs) > 0 ? Number(settings?.drawWaitMs) : DRAW_WAIT_BUDGET_MS)));
+	const waitMs = Math.min(Math.max(1, timeoutMs - DRAW_TOOL_TIMEOUT_MARGIN_MS), Math.max(1, Math.floor(Number(settings?.drawWaitMs) > 0 ? Number(settings?.drawWaitMs) : DRAW_WAIT_BUDGET_MS)));
 	const apiBase = str(settings?.apiBase, "https://api-inference.modelscope.cn/v1");
 	const abortController = new AbortController();
 	const abortIfDisposed = () => {
 		if (isDisposed()) abortController.abort();
 	};
+	const shouldStop = () => {
+		abortIfDisposed();
+		return isDisposed();
+	};
 	/**
 	* 等一个作业，把 {@link awaitDrawTask} 的三种结局翻译成工具结果或错误。
 	*
@@ -3551,7 +3609,8 @@ function defineDrawTool({ defineTool, fetchImpl, resolveApiKey, getEntries, sett
 			taskId: job.taskId,
 			waitMs,
 			pollIntervalMs,
-			signal: abortController.signal
+			signal: abortController.signal,
+			shouldStop
 		});
 		if (awaited.kind === "failed") {
 			jobs.drop(job.jobId);
@@ -3574,6 +3633,7 @@ function defineDrawTool({ defineTool, fetchImpl, resolveApiKey, getEntries, sett
 		}
 		const elapsedMs = Date.now() - job.submittedAt;
 		if (elapsedMs >= timeoutMs) throw new Error(describeDrawFailure({ cause: `超过总预算（${Math.round(timeoutMs / 1e3)}s，${polls} 次轮询）仍未拿到结果。上游任务（${job.taskId}）可能仍在生成——实测排队时长在 1–15 分钟间大幅波动，与请求本身无关；注意放弃后原任务的结果不保证还能取回` }));
+		const resumeHint = jobs.get(job.jobId) !== null ? `稍后带 jobId ${job.jobId} 再调用本工具即可继续查询（只查询、不会重复出图；作业表只在本次挂载内有效，重启 DSH 或重挂插件后要重新提交）` : "本次挂载已撤下（插件被卸载/重载），作业表已清空——这一轮之后**不能**再带 jobId 续查；上游任务可能仍在生成，但结果不保证还能取回，重新出图请去掉 jobId 再调用";
 		return {
 			source: "modelscope",
 			status: "pending",
@@ -3581,7 +3641,7 @@ function defineDrawTool({ defineTool, fetchImpl, resolveApiKey, getEntries, sett
 			model: job.model,
 			url: "",
 			prompt: job.prompt,
-			hint: `仍在生成中（已等 ${Math.round(elapsedMs / 1e3)}s，${polls} 次轮询，task ${job.taskId}）：上游排队通常 1–15 分钟。稍后带 jobId ${job.jobId} 再调用本工具即可继续查询（只查询、不会重复出图）`
+			hint: `仍在生成中（已等 ${Math.round(elapsedMs / 1e3)}s，${polls} 次轮询，task ${job.taskId}）：上游排队通常 1–15 分钟。${resumeHint}`
 		};
 	};
 	return defineTool({
@@ -3645,7 +3705,7 @@ function defineDrawTool({ defineTool, fetchImpl, resolveApiKey, getEntries, sett
 				text: result?.hint || "图片已生成"
 			}]
 		},
-		timeoutMs: waitMs + 1e4,
+		timeoutMs: waitMs + DRAW_TOOL_TIMEOUT_MARGIN_MS,
 		async execute(params) {
 			if (abortController.signal.aborted || isDisposed()) throw new Error("modelscope draw tool is no longer mounted");
 			const apiKey = await resolveApiKey();
@@ -3899,7 +3959,7 @@ async function resolveService(ctx, service, isDisposed) {
 * 读一次开关，决定是否注册出图工具。
 * @param {object} ctx - Host 上下文。
 * @param {object} wiring - `{ settings, configError, tokenStore, inference, providerStore, publisher, logger }`。
-* @param {object} deps - 测试缝（`loadToolsModule`、`drawFetch`）。
+* @param {object} deps - 测试缝（`loadToolsModule`、`drawFetch`、`pollIntervalMs`）。
 * @returns {Promise<void>}
 */
 async function registerDrawTool(ctx, wiring, deps = {}) {
@@ -3948,6 +4008,8 @@ async function registerDrawTool(ctx, wiring, deps = {}) {
 				drawTimeoutMs: settings.drawTimeoutMs,
 				drawWaitMs: settings.drawWaitMs
 			},
+			...wiring.drawJobs !== void 0 ? { jobs: wiring.drawJobs } : {},
+			...deps.pollIntervalMs !== void 0 ? { pollIntervalMs: deps.pollIntervalMs } : {},
 			isDisposed
 		}));
 		setDrawToolMounted(true);
@@ -5008,12 +5070,13 @@ async function buildSnapshotBody(wiring) {
 		const allowedList = parseAllowedList(enabledIds);
 		const enabledCount = enabledCountOf(allowedList, roster.map((row) => row.id));
 		const contextWindow = await providerStore.contextWindow().catch(() => null);
+		const catalogNote = models.ok ? null : `模型目录读不到：${models.error}`;
 		return {
 			enabled,
 			source,
 			llmAvailable: publisher.state.llmAvailable === true,
 			registered: publisher.state.registered === true,
-			error: typeof publisher.state.error === "string" ? publisher.state.error : null,
+			error: typeof publisher.state.error === "string" ? publisher.state.error : catalogNote,
 			modelCount: roster.length,
 			enabledCount,
 			allowed: allowedList.mode,
@@ -6003,25 +6066,73 @@ function registerRoutes(ctx, wiring) {
 //#endregion
 //#region src/host/index.ts
 /**
-* dsh-connect-modelscope-token-plan — Host 半边（thin router）。
-*
-* 读魔搭 API-Inference 的**本地用量**，并把它与官方魔粒余额一起经一条只读 /api
-* 路由喂给 Client 面板。口径分工：推理响应**不携带**额度头（SPIKE.md §结论 1），但
-* 官方另有魔粒余额端点（`GET {siteBase}/openapi/v1/magicubes/balance`，SPIKE.md
-* 文首后记，2026-10-04 实测可用），面板头条读的是它；本文件下的兄弟模块只负责本地
-* 计数那一半（按模型分布 / 本地趋势 / 429 事件流），回答官方余额答不了的问题。
-* 重活都在专注的兄弟模块里，本文件
-* 只保留 Cordis 入口（name/inject/apply）、wiring 装配与卸载副作用：
-*
-*   - `host-config.ts`        配置契约 + isAdmitted 信任围栏
-*   - `routes.ts`             四条路由的门面（snapshot/models/token/probe）
-*   - `ms-auth.ts`            访问令牌存取（静态钥匙，无登录流）
-*   - `inference-client.ts`   模型目录（零额度）+ probe 调用（带分诊）
-*   - `usage-store.ts`        本地计数：天桶/单模型/事件流（原子写、版本守卫）
-*   - `snapshot-aggregate.ts` 快照聚合（软失败）
-*   - `state-store.ts`        状态文件原子原语
+* dsh-connect-modelscope-token-plan — Host 半边（装配入口）。
+*
+* 本插件的定位是**额度 + provider + 出图 + 上下文窗口策展**的多功能集成（见
+* AGENTS.md「定位变更」），不再是「只做额度信息」的那一版。口径分工：推理响应
+* **不携带**额度头（SPIKE.md §结论 1），但官方另有魔粒余额端点
+* （`GET {siteBase}/openapi/v1/magicubes/balance`，SPIKE.md 文首后记，2026-10-04
+* 实测可用），面板头条读的是它；本文件下的兄弟模块只负责本地计数那一半（按模型
+* 分布 / 本地趋势 / 429 事件流），回答官方余额答不了的问题。
+*
+* 重活都在专注的兄弟模块里，本文件只保留 Cordis 入口（name/inject/apply）、
+* wiring 装配与卸载副作用。兄弟模块按域分组：
+*
+*   **配置与凭据**
+*   - `host-config.ts`        配置契约 + isAdmitted 信任围栏 + 夹取常量
+*   - `switch-precedence.ts`  开关优先级：面板值 > patch 默认
+*   - `ms-auth.ts`            访问令牌存取（静态钥匙，无登录流；唯一凭据出口）
+*
+*   **路由（7 条，`routes.ts` 是门面，`routes/` 下各域一份）**
+*   - `routes/snapshot.ts`    面板轮询的唯一只读路由
+*   - `routes/models.ts`      模型目录
+*   - `routes/token.ts`       令牌保存/忘掉/验证
+*   - `routes/probe.ts`       零额度鉴权探针
+*   - `routes/provider.ts`    provider 开关/清单/窗口/重置
+*   - `routes/draw.ts`        出图开关/模型/重置
+*   - `routes/usage-prefs.ts` 趋势显示窗口
+*   - `routes/http.ts`        CORS / JSON / 错误脱敏的公共辅助
+*   - `routes/paths.ts`       路由路径常量
+*
+*   **数据层（`state-store.ts` 是共用原语）**
+*   - `state-store.ts`        原子写/版本守卫/读缓存/写队列（四个 store 共用）
+*   - `usage-store.ts`        本地计数：天桶/单模型/事件流
+*   - `provider-store.ts`     开关 + 允许清单 + 窗口覆盖的持久化
+*   - `draw-store.ts`         出图开关 + 模型偏好
+*   - `usage-prefs-store.ts`  趋势显示窗口偏好 + `resolveWindowDays` 夹取
+*   - `inference-client.ts`   HTTP 出口：模型目录 + 魔粒余额 + 探针
+*   - `coalesced-fetch.ts`    有界并发缓存（目录/余额/标签共用）
+*   - `context-catalog.ts`    内置上下文窗口策展表（models.dev 交叉真值）
+*
+*   **Provider 注册**
+*   - `llm-models.ts`         目录 → descriptor 映射（peer-free）
+*   - `llm-adapter.ts` / `llm-adapter-core.ts`  适配器装配（core 为三族共享）
+*   - `provider-publish.ts`   发布状态机：队列/disposed 闸/回滚
+*   - `provider-reconcile.ts` desired-state 收敛器（轮询 + 路由统一触发）
+*   - `publish-core.ts`       三族共享的发布原语
+*
+*   **观测与纠正**
+*   - `usage-observer.ts`     真实对话 → 本地计数/事件（观察流出口）
+*   - `llm-error-fix.ts`      429 误判纠正（QUOTA → RATE_LIMIT）
+*   - `llm-retry.ts`          重试策略（按 code 决定退避）
 *   - `codes.ts`              错误分类单一真源
-*   - `usage-observer.ts`     真实对话 → 本地计数/事件（观察流出口，见该文件头）
+*
+*   **出图工具**
+*   - `draw.ts`               协议纯逻辑半边（peer-free）
+*   - `draw-register.ts`      工具注册（挂载时一次性，不可撤销）
+*   - `draw-runtime.ts`       运行时（两段式：提交 → 轮询）
+*   - `draw-jobs.ts`          作业表（本次挂载内有效）
+*   - `draw-tool-state.ts`    缺席原因 + 本次挂载注册位（内存）
+*
+*   **聚合与工具**
+*   - `snapshot-aggregate.ts` 快照聚合（软失败，绝不白屏）
+*   - `doctor.ts`             只读盘点工具
+*   - `util.ts`               通用工具（脱敏/错误消息/类型守卫）
+*   - `types.ts`              Host 侧类型定义
+*
+* 完整的「文件 → 一句话职责 → 关键导出」表在 AGENTS.md 的代码地图里，由
+* test/docs.test.mjs §14 门禁守着（每个 src/*.ts 都必须登记）。本注释只做入口
+* 处的分组索引——**新增兄弟模块时两处都要改**，别让这里再落后一轮。
 *
 * @module dsh-connect-modelscope-token-plan
 */
@@ -6062,6 +6173,7 @@ function apply(ctx, config = {}, deps = {}) {
 		profile,
 		logger: ctx.logger
 	});
+	const drawJobs = createDrawJobs();
 	const usagePrefsStore = createFileUsagePrefsStore({
 		profile,
 		logger: ctx.logger
@@ -6098,6 +6210,7 @@ function apply(ctx, config = {}, deps = {}) {
 		inference,
 		providerStore,
 		drawStore,
+		drawJobs,
 		usagePrefsStore,
 		publisher,
 		reconcile,
@@ -6117,6 +6230,7 @@ function apply(ctx, config = {}, deps = {}) {
 		return () => {
 			clearInterval(timer);
 			resetDrawToolNote();
+			drawJobs.dispose();
 			publisher.dispose();
 			publisher.release();
 			for (const off of offs) try {

package/lib/llm-adapter.js

@@ -1,4 +1,4 @@
-import { D as redactSecrets, c as LLM_PROVIDER_ID, i as name, l as buildDescriptors, o as LLM_API_KEY_NAME, s as LLM_DISPLAY_NAME, v as CODE, x as reclassifyStream } from "./host-config.js";
+import { O as redactSecrets, S as reclassifyStream, a as name, c as LLM_DISPLAY_NAME, l as LLM_PROVIDER_ID, s as LLM_API_KEY_NAME, u as buildDescriptors, y as CODE } from "./host-config.js";
 import { createProvider } from "@earendil-works/pi-ai";
 import { openAICompletionsApi } from "@earendil-works/pi-ai/api/openai-completions.lazy";
 import { PiAiAdapter } from "@deepseek-ai/dsh-llm-pi-ai";

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "ModelScope Model Access",
-    "description": "Register ModelScope's language models and draw tool into DSH with one toggle: image-recognition capability and context windows auto-filled, usable the moment it is registered (both default off); the free-quota panel — official Magicube balance, local call counts, trends, rate-limit events — works even without registering."
+    "description": "Bring the ModelScope language and image-generation models into DSH as default-off switches, with image recognition and context windows filled in automatically. The card also shows the free Magicube balance, links each model to its ModelScope page, and records local call counts, a daily trend and rate-limit events. All of it needs only an API key, with no account sign-in."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "魔搭模型接入",
-    "description": "一键把魔搭（ModelScope）的语言模型与生图工具注册进 DSH：自动填入图片识别能力与上下文窗口，注册即可用（均默认关）；不注册也能看免费额度面板：官方魔粒余额、本地调用计数、趋势、限流事件。"
+    "description": "一键接入魔搭社区的语言、生图模型到 DSH ，自动填入图片识别与上下文窗口（默认关）；还可查看免费魔粒余额、跳转到模型信息页，记录本地调用计数、趋势、限流事件。上述功能仅需填入 API key ，不需要登陆账号。"
   }
 }

package/package.json

@@ -2,13 +2,13 @@
   "name": "dsh-connect-modelscope-token-plan",
   "displayName": "DSH Connect ModelScope Token Plan",
   "icon": "./icon.svg",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "homepage": "https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan",
   "bugs": {
     "url": "https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan/issues"
   },
   "author": "eghrhegpe",
-  "description": "ModelScope (modelscope.cn) access bundle for DSH: opt-in registration of ModelScope language models and draw tool as an OpenAI-compatible provider (vision and context windows auto-filled, usable the moment registered), plus a free-quota panel with the official Magicube balance, per-model local call counts, daily trends and 429 event list — usable without registering.",
+  "description": "Bring the ModelScope language and image-generation models into DSH as default-off switches, with image recognition and context windows filled in automatically. The card also shows the free Magicube balance, links each model to its ModelScope page, and records local call counts, a daily trend and rate-limit events. All of it needs only an API key, with no account sign-in.",
   "keywords": [
     "dsh-plugin",
     "deepseek-harness",