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

package/CHANGELOG.md

@@ -26,6 +26,25 @@
 > **发版时**：顶部开 `## [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 新模型」**

package/README.md

@@ -43,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-…` 访问令牌即完成凭据配置（令牌永不入日志、永不进插件目录）。没有令牌时面板会提示你到这里来填。

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": "还没有本地调用记录。",
@@ -386,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",
@@ -408,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.",
@@ -1288,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} 归一后的状态。
@@ -1299,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 {
@@ -2210,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} 卡片节点。
 	*/
@@ -2273,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;
@@ -2431,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"
 		};
 	}));
 

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.6";
+const PLUGIN_VERSION = "0.7.0";
 /**
 * 默认值。刻意不含额度常数——理由见本文件头。
 * 面板头条是官方魔粒余额，次数口径的推算已在面板收敛时删除，这里若留着

package/lib/index.js

@@ -4202,11 +4202,10 @@ function sleep(ms, signal) {
 /** 当前缺席原因（`null` = 未登记 / 已清掉）。 */
 let note = null;
 /**
-* 本次挂载是否真的把工具注册上了。
+* 此刻工具是否真的在 registry 里。
 *
-* 与 `note` 的区别见文件头：`note` 是「注册尝试过且失败的原因」，这一位是「注册
-* 成功与否」。开关在挂载后才翻开的场景，两者都是「没有缺席原因 + 没注册上」，
-* 只有这一位能把它认出来。
+* 与 `note` 的区别见文件头：`note` 是「为什么没成」，这一位是「此刻在不在」。
+* 开关翻转会当场重算这一位，所以它是动态读数，不是「本次挂载」的存档。
 */
 let mounted = false;
 /**
@@ -4252,22 +4251,33 @@ function resetDrawToolNote() {
 //#endregion
 //#region src/host/draw-register.ts
 /**
-* 出图工具的挂载副作用：读开关 → 解析目录 → 注册 agent 工具。
+* 出图工具的挂载副作用：读开关 → 解析目录 → 注册 agent 工具；开关翻转时**现挂现卸**。
 *
 * 与 `provider-publish.ts` 的分工：那个管「魔搭作为 chat provider 的注册」，本文件
 * 管「给 agent 一个出图工具」。两者是**独立的开关**——回答的是不同问题，合并没有
 * 好处（用户可能想用工具出图但不想把魔搭塞进模型选择器，反之亦然）。
 *
-* 承重约束：**peer 的 tools registry 没有 unregister**。所以
-*  - 注册只在挂载时尝试**一次**，不在任何轮询/路由里重复调用；
-*  - 开关在挂载后翻转，要到下次 Host 启动才生效（面板文案必须说这句，否则用户
-*    会以为开关坏了）；
+* 承重契约：peer 的 tools.register 返回 disposer（`() => void` 注销句柄，见
+* `@deepseek-ai/dsh-tools` 的 `ToolsService.register`）。所以
+*  - 开关翻转可以在**本次 Host 生命周期内**生效：`sync()` 读一次开关，要开就注册、
+*    要关就调 disposer 摘掉，不需要等下次启动；
+*  - 句柄必须**存住**：丢掉它 = 插件卸载后注册残留（僵尸工具），而 registry 对重名
+*    insert 会抛错，下一次挂载直接失败（错误文本形如 `tool "<name>" is already
+*    registered`）。旧版把返回的 `unknown` 直接丢弃，正是这条缺口的来源；
 *  - 目录变化**不需要**重注册：工具在**调用时**才读目录（`getEntries` 是个函数），
 *    所以一次目录刷新会自然被下一次出图看到。
 *
-* 失败一律降级为「工具缺席」，绝不炸掉插件：tools 服务缺失、peer 加载失败、
-* registry 拒收——三种都由 `draw-tool-state.ts` 记下原因供面板显示。本文件不吞
-* 错误（那会让「工具为什么不在」无从诊断），只把它们翻译成可展示的原因码。
+* 并发：`sync()` 串行排队（`chain`），每次执行时**现读**开关，所以快速连点开关
+* 最终收敛到最后一次保存的值；重复 sync 幂等（已注册就跳过——真去重复注册会撞
+* registry 的重名保护，把它当正常分支会把「开关开着」误报成缺席）。
+*
+* 失败一律降级为「工具缺席」，绝不炸掉插件：tools 服务缺失、peer 加载失败、registry
+* 拒收——三种都由 `draw-tool-state.ts` 记下原因供面板显示。另有一种**非缺席**的
+* 降级：registry 收下了却**没返回 disposer**（旧 Host / 旧 peer）。工具能用但关不
+* 掉，记 `not-removable` 让面板说实话——否则用户关掉开关、面板显示「已关闭」而
+* 工具还在。
+*
+* 本文件不吞错误（那会让「工具为什么不在」无从诊断），只把它们翻译成可展示的原因码。
 *
 * peer-dependent：`@deepseek-ai/dsh-tools` 由 `deps.loadToolsModule` 惰性注入。
 *
@@ -4285,9 +4295,8 @@ function resetDrawToolNote() {
 /**
 * 解析一个可选服务，允许它稍后才注册。
 *
-* 承 sensenova 同名函数的纪律：**重试的是读，不是注册**——工具不能注销，重复注册
-* 比缺席更糟。这里只做有限次立即读取，不做长退避（服务要么已注册，要么这次挂载
-* 就没有）。
+* 承 sensenova 同名函数的纪律：**重试的是读，不是写**。这里只做有限次立即读取，
+* 不做长退避（服务要么已注册，要么这次就没有）。
 * @param {object} ctx - Host 上下文。
 * @param {string} service - 服务名。
 * @param {() => boolean} isDisposed - 卸载闸。
@@ -4303,67 +4312,142 @@ async function resolveService(ctx, service, isDisposed) {
 	return null;
 }
 /**
-* 读一次开关，决定是否注册出图工具。
+* 建一个出图工具挂载控制器（不产生副作用，`sync()` 才读开关/注册）。
 * @param {object} ctx - Host 上下文。
-* @param {object} wiring - `{ settings, configError, tokenStore, inference, providerStore, publisher, logger }`。
+* @param {object} wiring - `{ settings, configError, tokenStore, inference, drawStore, publisher, logger }`。
 * @param {object} deps - 测试缝（`loadToolsModule`、`drawFetch`、`pollIntervalMs`）。
-* @returns {Promise<void>}
+* @returns {DrawToolMount} 控制器。
 */
-async function registerDrawTool(ctx, wiring, deps = {}) {
+function createDrawToolMount(ctx, wiring, deps = {}) {
 	const { settings, configError, tokenStore, inference, drawStore, publisher, logger } = wiring;
 	const loggerFor = logger ?? ctx.logger;
-	setDrawToolNote(null);
-	setDrawToolMounted(false);
-	try {
-		if (configError !== null) return;
-		const panelValue = drawStore ? await drawStore.enabled().catch(() => null) : null;
-		if (resolveSwitchEnabled(panelValue, settings.drawEnabled === true) !== true) return;
-		const isDisposed = () => publisher?.isDisposed?.() === true;
-		const tools = await resolveService(ctx, "tools", isDisposed);
-		if (tools === null || typeof tools.register !== "function") {
-			setDrawToolNote("no-tools-service");
-			return;
+	/** 当前已注册工具的注销句柄；`null` = 没挂上（或已摘掉）。 */
+	let disposeTool = null;
+	/** peer 的 `defineTool` 只解析一次：成功后就缓存，失败留到下次 sync 重试。 */
+	let defineTool = null;
+	/** 卸载闸：`dispose()` 之后任何在途/后续 sync 都不再注册。 */
+	let closed = false;
+	/** 串行链：保证「读开关 → 挂/卸」不会被两次 sync 交错执行。 */
+	let chain = Promise.resolve();
+	const isDisposed = () => closed || publisher?.isDisposed?.() === true;
+	/**
+	* 摘掉已注册的工具（幂等）。
+	*
+	* 先清注册位再调 disposer：即使 disposer 抛了，面板也不该继续显示「已注册」。
+	* @returns {void}
+	*/
+	function unmount() {
+		const dispose = disposeTool;
+		disposeTool = null;
+		setDrawToolMounted(false);
+		if (dispose !== null) try {
+			dispose();
+		} catch (error) {
+			loggerFor?.warn?.(`${name}: draw tool dispose failed (${redactSecrets(errMsg(error))})`);
 		}
-		let defineTool = null;
+		setDrawToolNote(null);
+	}
+	/**
+	* 解析 peer 的 `defineTool`（成功后缓存）。
+	* @returns {Promise<Function|null>} `defineTool` 或 `null`（失败已记原因）。
+	*/
+	async function loadDefineTool() {
+		if (defineTool !== null) return defineTool;
 		try {
 			const mod = await Promise.resolve(deps.loadToolsModule ? deps.loadToolsModule() : import("@deepseek-ai/dsh-tools"));
-			defineTool = mod?.defineTool ?? mod?.default?.defineTool ?? null;
+			const found = mod?.defineTool ?? mod?.default?.defineTool ?? null;
+			if (typeof found === "function") {
+				defineTool = found;
+				return found;
+			}
 		} catch (error) {
-			setDrawToolNote("peer-load-failed");
 			loggerFor?.warn?.(`${name}: draw tool peer module failed to load (${redactSecrets(errMsg(error))}) — the tool is absent`);
-			return;
 		}
-		if (typeof defineTool !== "function") {
-			setDrawToolNote("peer-load-failed");
-			return;
+		return null;
+	}
+	/**
+	* 一次收敛：读开关，要开就注册、要关就注销。
+	* @returns {Promise<void>}
+	*/
+	async function apply() {
+		if (closed) return;
+		try {
+			if (configError !== null) return;
+			const panelValue = drawStore ? await drawStore.enabled().catch(() => null) : null;
+			if (resolveSwitchEnabled(panelValue, settings.drawEnabled === true) !== true) {
+				unmount();
+				return;
+			}
+			if (disposeTool !== null) {
+				setDrawToolNote(null);
+				setDrawToolMounted(true);
+				return;
+			}
+			const tools = await resolveService(ctx, "tools", isDisposed);
+			if (tools === null || typeof tools.register !== "function") {
+				setDrawToolNote("no-tools-service");
+				setDrawToolMounted(false);
+				return;
+			}
+			const found = await loadDefineTool();
+			if (found === null) {
+				setDrawToolNote("peer-load-failed");
+				setDrawToolMounted(false);
+				return;
+			}
+			const drawFetch = deps.drawFetch ?? ((url, options) => fetch(url, options));
+			const dispose = tools.register(defineDrawTool({
+				defineTool: found,
+				fetchImpl: drawFetch,
+				resolveApiKey: async () => (await tokenStore.resolve()).value,
+				getEntries: async () => {
+					return (await inference.fetchModels().catch(() => null))?.entries ?? [];
+				},
+				getPreferredModelId: async () => {
+					const panelValue = drawStore ? await drawStore.modelId().catch(() => null) : null;
+					return resolveSwitchValue(panelValue, settings.drawModelId === "" ? void 0 : settings.drawModelId) ?? null;
+				},
+				settings: {
+					apiBase: settings.apiBase,
+					drawModelId: settings.drawModelId,
+					drawTimeoutMs: settings.drawTimeoutMs,
+					drawWaitMs: settings.drawWaitMs
+				},
+				...wiring.drawJobs !== void 0 ? { jobs: wiring.drawJobs } : {},
+				...deps.pollIntervalMs !== void 0 ? { pollIntervalMs: deps.pollIntervalMs } : {},
+				isDisposed
+			}));
+			if (typeof dispose === "function") {
+				disposeTool = dispose;
+				setDrawToolNote(null);
+				setDrawToolMounted(true);
+			} else {
+				disposeTool = null;
+				setDrawToolNote("not-removable");
+				setDrawToolMounted(true);
+				loggerFor?.warn?.(`${name}: draw tool registered without a disposer — turning the switch off cannot unmount it on this host`);
+			}
+		} catch (error) {
+			setDrawToolNote("registry-refused");
+			setDrawToolMounted(false);
+			loggerFor?.warn?.(`${name}: draw tool registration refused (${redactSecrets(errMsg(error))}) — the tool is absent`);
 		}
-		const drawFetch = deps.drawFetch ?? ((url, options) => fetch(url, options));
-		tools.register(defineDrawTool({
-			defineTool,
-			fetchImpl: drawFetch,
-			resolveApiKey: async () => (await tokenStore.resolve()).value,
-			getEntries: async () => {
-				return (await inference.fetchModels().catch(() => null))?.entries ?? [];
-			},
-			getPreferredModelId: async () => {
-				const panelValue = drawStore ? await drawStore.modelId().catch(() => null) : null;
-				return resolveSwitchValue(panelValue, settings.drawModelId === "" ? void 0 : settings.drawModelId) ?? null;
-			},
-			settings: {
-				apiBase: settings.apiBase,
-				drawModelId: settings.drawModelId,
-				drawTimeoutMs: settings.drawTimeoutMs,
-				drawWaitMs: settings.drawWaitMs
-			},
-			...wiring.drawJobs !== void 0 ? { jobs: wiring.drawJobs } : {},
-			...deps.pollIntervalMs !== void 0 ? { pollIntervalMs: deps.pollIntervalMs } : {},
-			isDisposed
-		}));
-		setDrawToolMounted(true);
-	} catch (error) {
-		setDrawToolNote("registry-refused");
-		loggerFor?.warn?.(`${name}: draw tool registration refused (${redactSecrets(errMsg(error))}) — the tool is absent`);
 	}
+	return {
+		sync() {
+			chain = chain.then(apply).catch((error) => {
+				loggerFor?.warn?.(`${name}: draw tool sync failed (${redactSecrets(errMsg(error))})`);
+			});
+			return chain;
+		},
+		dispose() {
+			closed = true;
+			unmount();
+		},
+		mounted() {
+			return drawToolMounted();
+		}
+	};
 }
 
 //#endregion
@@ -6148,12 +6232,11 @@ function registerProviderRoute(ctx, wiring) {
 * 「给 agent 一个出图工具」。两者的开关、状态文件、候选集合都不同，合并会让
 * 「关掉出图」波及 provider 的注册时序（详见 draw-store.ts 的头注）。
 *
-* 一处**与 provider 路由不同**的地方必须说清：provider 开关翻转会**立即**重注册
-* （publish 是活的重建），而出图工具的开关翻转**要等下次 Host 启动**——peer 的
-* tools registry 没有 unregister，工具一旦注册就摘不下来（完整论述见
-* draw-register.ts 文件头注）。所以本路由保存成功后
-* 不改挂载状态，只在响应里给出 `mountPending`，让面板能说清这件事，而不是让用户
-* 以为开关坏了。
+* 开关翻转**当场生效**：保存成功后本路由 await 挂载控制器的 `syncDraw()`（注册
+* 或注销），再把**收敛之后**的真实状态写进响应。所以面板拿到的不是「已保存、等
+* 重启」，而是「已挂上」或「挂载失败的原因」。`syncDraw` 由装配层注入（`index.ts`
+* 把同一个控制器交给路由与挂载），本路由不自己建——否则「注册」与「注销」会各持
+* 一份状态。
 *
 * peer-free：不 import 任何 Host peer。
 * @module dsh-connect-modelscope-token-plan/routes/draw
@@ -6192,7 +6275,7 @@ async function readEntries(inference) {
 * @returns {Function} 注销回调。
 */
 function registerDrawRoute(ctx, wiring) {
-	const { settings, drawStore, inference, logger } = wiring;
+	const { settings, drawStore, inference, syncDraw, logger } = wiring;
 	/**
 	* 组装响应。GET 与写成功后的响应共用，两个方向不可能对「当前状态」说两套话。
 	* @param {object} [extra] - 追加/覆盖字段。
@@ -6218,15 +6301,15 @@ function registerDrawRoute(ctx, wiring) {
 			effectiveSource: choice.source,
 			absentReason: drawToolNote(),
 			/**
-			* 开关的保存**不会**改变本次挂载的工具。
+			* 开关为开、但工具此刻还没挂上（正在收敛，或收敛失败）。
 			*
-			* 工具无法注销（peer 的 tools registry 没有 unregister），所以开关翻转只在
-			* 下次 Host 启动时生效。面板据此显示一句说明——否则用户会以为开关坏了。
-			* 判据：开关为开且**本次挂载没注册上**。
+			* 现在开关翻转是**当场**收敛的（见上面的 `syncDraw`），所以正常保存后这一位
+			* 就是 false。它仍然有用：GET 与进程刚启动、还没跑到第一次 sync 时仍可能为
+			* true，面板靠它区分「暂时没挂」与「挂上了」。
 			*
-			* 注意判据不是「有缺席原因」：缺席原因非 null 表示注册尝试过且失败，而挂载
-			* 那一刻开关是关的（用户之后才翻开）时 absentReason 为 null、却同样没注册
-			* 上——后者才是最需要这句提示的场景。见 `draw-tool-state.ts` 文件头。
+			* 注意判据不是「有缺席原因」：缺席原因非 null 表示收敛已尝试且失败（面板会
+			* 优先显示那个原因），而「还没跑完」时 absentReason 为 null。见
+			* `draw-tool-state.ts` 文件头。
 			*/
 			mountPending: resolveSwitchEnabled(panelSwitch, settings.drawEnabled) === true && drawToolMounted() !== true,
 			preferredInCatalog: preferredModelId === null ? null : catalog.ok ? candidates.some((row) => row.id === preferredModelId) : null,
@@ -6276,6 +6359,7 @@ function registerDrawRoute(ctx, wiring) {
 			try {
 				if (hasEnabled) await drawStore.saveEnabled(body.enabled);
 				if (body.modelId !== void 0) await drawStore.saveModelId(body.modelId);
+				if (hasEnabled) await syncDraw?.();
 			} catch (error) {
 				respondError(response, error);
 				return;
@@ -6297,6 +6381,7 @@ function registerDrawRoute(ctx, wiring) {
 			}));
 			try {
 				await drawStore.reset();
+				await syncDraw?.();
 			} catch (error) {
 				respondError(response, error);
 				return;
@@ -6479,7 +6564,7 @@ function registerRoutes(ctx, wiring) {
 *
 *   **出图工具**
 *   - `draw.ts`               协议纯逻辑半边（peer-free）
-*   - `draw-register.ts`      工具注册（挂载时一次性，不可撤销）
+*   - `draw-register.ts`      工具挂载控制器（开关翻转现挂现卸）
 *   - `draw-runtime.ts`       运行时（两段式：提交 → 轮询）
 *   - `draw-jobs.ts`          作业表（本次挂载内有效）
 *   - `draw-tool-state.ts`    缺席原因 + 本次挂载注册位（内存）
@@ -6582,12 +6667,16 @@ function apply(ctx, config = {}, deps = {}) {
 		reconcile,
 		logger: ctx.logger
 	};
-	const offs = registerRoutes(ctx, wiring);
+	const drawMount = createDrawToolMount(ctx, wiring, deps);
+	const offs = registerRoutes(ctx, {
+		...wiring,
+		syncDraw: () => drawMount.sync()
+	});
 	ctx.effect(() => {
 		reconcile().catch((error) => {
 			ctx.logger?.warn?.(`${name}: mount reconcile failed (${redactSecrets(errMsg(error))})`);
 		});
-		registerDrawTool(ctx, wiring, deps);
+		drawMount.sync();
 		const timer = setInterval(() => {
 			reconcile().catch((error) => {
 				ctx.logger?.warn?.(`${name}: scheduled reconcile failed (${redactSecrets(errMsg(error))})`);
@@ -6595,6 +6684,7 @@ function apply(ctx, config = {}, deps = {}) {
 		}, settings.pollSeconds * 1e3);
 		return () => {
 			clearInterval(timer);
+			drawMount.dispose();
 			resetDrawToolNote();
 			drawJobs.dispose();
 			publisher.dispose();

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.6",
+  "version": "0.7.0",
   "homepage": "https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan",
   "bugs": {
     "url": "https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan/issues"