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

package/CHANGELOG.md

@@ -26,6 +26,15 @@
 > **发版时**：顶部开 `## [X.Y.Z] — YYYY-MM-DD`，完整流程见
 > [RELEASING.md](RELEASING.md) §3（本文开头这段是**写作者规范**，那是**发布操作流程**）。
 
+## [0.6.2] — 2026-10-18
+
+**插件命名与卡片文案以「模型接入」为主题重排**
+
+- 卡片标题与面板页头「魔搭接入 · 额度面板」改为「魔搭模型接入」（英文同步 ModelScope Model Access）。
+- 描述改以「模型接入」为本体：一键注册魔搭语言模型与生图工具，自动填入图片识别与上下文窗口，注册即可用（均默认关）；免费额度面板降为加分项，不注册也能看。
+- provider 注册不再挂过时的「（路线图）」标签（实际已交付），改按 opt-in 如实写「均默认关」。
+- 无行为变化：本版只改面板展示文案与注释，功能、数据与流程同 0.6.1。
+
 ## [0.6.1] — 2026-10-18
 
 **迁移窗口期不再看不见旧数据**

package/client.js

@@ -136,7 +136,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 	var zh, en;
 	var init_i18n = __esmMin((() => {
 		zh = {
-			"panel.title": "魔搭接入 · 额度面板",
+			"panel.title": "魔搭模型接入",
 			"panel.refresh": "刷新",
 			"panel.updated": "更新于 {time}",
 			"panel.loading": "加载中…",
@@ -288,7 +288,7 @@ var dsh_connect_modelscope_token_plan_client = (function() {
 			"composer.stale": "上次数据"
 		};
 		en = {
-			"panel.title": "ModelScope Access · Quota",
+			"panel.title": "ModelScope Model Access",
 			"panel.refresh": "Refresh",
 			"panel.updated": "Updated {time}",
 			"panel.loading": "Loading…",

package/lib/host-config.js

@@ -181,37 +181,63 @@ function extractStructuredType(message) {
 	return match ? match[1] ?? null : null;
 }
 /**
-* 一个被 peer 判为 QUOTA 的失败，是否其实是限频、应纠正为 RATE_LIMIT。
+* 一个被 peer 判为 QUOTA 的失败，按哪条判据路径处理——429 重分类的**可观测
+* 理由**。纯函数，复用同一批判据（模块私有的 {@link RATE_SIGNAL} /
+* {@link RATE_CAP_WORDING}、{@link hasHardQuotaWordingIn}、结构化 type），不
+* 引入第二份词表；返回稳定短串（非自由文本），供面板/日志/测试引用“为什么
+* 这么判”。
 *
 * 这是修正 v1（纯文本启发）漏判的核心：`{"message":"rpm exhausted",
 * "type":"quota_exceeded_error","code":"8"}` 这种体——魔搭把**请求速率上限**
-* 复用 `quota_exceeded_error` 这个名字，纯文本里没有 “rate limit” 字样，v1 的
+* 复用 `quota_exceeded_error` 这个名字，纯文本里没有 rate limit 字样，v1 的
 * `looksLikeRateLimit` 既没命中限频信号也没命中硬额度，于是留在 QUOTA、不重试、
-* 直接失败。本函数改读结构化 `type`，逐层收窄：
-*
-*   1. `type` 含 `rate_limit` → 本就是限频（peer 多数已判 RATE_LIMIT，这里是防御）。
-*   2. `type` 含 `quota` 但仍带 {@link RATE_CAP_WORDING}（rpm/tpm/每分钟/限流…）
-*      → 是“被错命名为 quota 的速率上限”，纠正为 RATE_LIMIT。
-*   3. `type` 含 `quota` 且无任何速率信号（token/credit/balance 真耗尽）→ 保留 QUOTA。
-*   4. `type` 是其它非 quota 值 → 保守不纠正。
-*   5. 无结构化 `type` → 退回 v1 的 {@link looksLikeRateLimit}。
+* 直接失败。本函数改读结构化 `type` 逐层收窄，每个返回串对应一条路径：
+*
+*   - `"not_quota_code"`             失败为空或 code≠QUOTA，纠正层不适用。
+*   - `"structured:rate_limit_type"`  结构化 type 含 rate_limit，本就是限频（防御，纠正）。
+*   - `"structured:quota_rate_cap"`   结构化 type 含 quota 且命中 {@link RATE_CAP_WORDING}
+*                                     （rpm/tpm/每分钟/限流…）→ 错命名，纠正。
+*   - `"structured:quota_no_cap"`     结构化 type 含 quota 且无速率信号（token/credit/
+*                                     balance 真耗尽）→ 保留 QUOTA。
+*   - `"structured:other_type"`       结构化 type 是其它非 quota 值 → 保守不纠正。
+*   - `"text:rate_signal"`            无结构化 type，纯文本命中 {@link RATE_SIGNAL} 且
+*                                     无硬额度字样 → 纠正。
+*   - `"text:hard_quota"`             无结构化 type，命中硬额度字样 → 保留 QUOTA。
+*   - `"text:no_rate_signal"`         无结构化 type 也无限频信号 → 保留 QUOTA。
 *
 * 不纠正真配额耗尽：那是共享 Token Plan 池的硬耗尽，重试只会延长冷却窗口
 * （ROADMAP §1 纪律），所以宁可快失败。
 * @param {{code?: string, message?: string}} failure
-* @returns {boolean} true 表示应纠正为 RATE_LIMIT。
+* @returns {string} 标记处理路径的稳定短串。
 */
-function shouldReclassifyQuotaToRate(failure) {
-	if (!failure || failure.code !== CODE.QUOTA) return false;
+function reclassifyReason(failure) {
+	if (!failure || failure.code !== CODE.QUOTA) return "not_quota_code";
 	const message = typeof failure.message === "string" ? failure.message : "";
 	const type = extractStructuredType(message);
 	if (type !== null) {
 		const t = type.toLowerCase();
-		if (/rate[_\s-]?limit/.test(t)) return true;
-		if (/quota/.test(t)) return RATE_CAP_WORDING.test(message);
-		return false;
+		if (/rate[_\s-]?limit/.test(t)) return "structured:rate_limit_type";
+		if (/quota/.test(t)) return RATE_CAP_WORDING.test(message) ? "structured:quota_rate_cap" : "structured:quota_no_cap";
+		return "structured:other_type";
 	}
-	return looksLikeRateLimit(message);
+	if (!RATE_SIGNAL.some((re) => re.test(message.toLowerCase()))) return "text:no_rate_signal";
+	return hasHardQuotaWordingIn(message) ? "text:hard_quota" : "text:rate_signal";
+}
+/** 判为「应纠正为 RATE_LIMIT」的理由集合——{@link shouldReclassifyQuotaToRate} 的唯一真源。 */
+const RECLASSIFY_TRUE_REASONS = /* @__PURE__ */ new Set([
+	"structured:rate_limit_type",
+	"structured:quota_rate_cap",
+	"text:rate_signal"
+]);
+/**
+* 一个被 peer 判为 QUOTA 的失败，是否其实是限频、应纠正为 RATE_LIMIT。
+* 布尔判定单一真源：读 {@link reclassifyReason} 是否落在「应纠正」集合里，分支
+* 逻辑不再写第二遍；可观测“为什么这么判”见 {@link reclassifyReason} 的返回串。
+* @param {{code?: string, message?: string}} failure
+* @returns {boolean} true 表示应纠正为 RATE_LIMIT。
+*/
+function shouldReclassifyQuotaToRate(failure) {
+	return RECLASSIFY_TRUE_REASONS.has(reclassifyReason(failure));
 }
 /**
 * 把单个流 chunk 里的失败码在误判时纠正。
@@ -1103,7 +1129,7 @@ const inject = ["webServer"];
 * 产物反而引入第二份真源；这里用常量、由 test/config.test.mjs 钉住与
 * package.json 一致。
 */
-const PLUGIN_VERSION = "0.6.1";
+const PLUGIN_VERSION = "0.6.2";
 /**
 * 默认值。刻意不含额度常数——理由见本文件头。
 * 面板头条是官方魔粒余额，次数口径的推算已在面板收敛时删除，这里若留着

package/lib/index.js

@@ -4762,7 +4762,7 @@ function syncSignaturesAfterPublish(state) {
 * 最多收敛成两遍 reconcile，不会排 N 遍。调用方 await 返回的 promise，即
 * 「我的触发已被消费」。
 * @param {ProviderReconcilerDeps} deps - wiring 子集。
-* @returns {{reconcile: () => Promise<void>}} 触发一次收敛。
+* @returns {{reconcile: () => Promise<void>; health: () => {{ lastError: unknown }} }}
 */
 function createProviderReconciler(deps) {
 	const { settings, providerStore, inference, publisher, usageEvents, logger } = deps;
@@ -4861,6 +4861,14 @@ function createProviderReconciler(deps) {
 	/** 有新触发待消费。闭包状态，不暴露——触发方只看得见 {@link reconcile}。 */
 	let dirty = false;
 	/**
+	* 最近一次「未被 runOnce 自行记档」的意外反抗（executor 层面漏网的抛，如
+	* `publisher.state` 的 getter 同步抛），下一遍成功即清空。路由侧 await 拿到
+	* `result` 会自行 respondError；但**轮询侧 `void reconcile()` 会把它丢掉**——
+	* 这份 lastError + 一条 warn 是「这一遍没收敛成」对操作员/测试唯一可观测的
+	* 记档（否则链的防毒化会把它连同结果一起吞成 0 痕迹，见 {@link reconcile} 注释）。
+	*/
+	let lastError = null;
+	/**
 	* 触发一次收敛。幂等且可重入：在途时只置 dirty，由在途那一轮替本调用消费
 	* （N 次连续触发最多收敛成两遍 reconcile，不会排 N 遍）。
 	* @returns {Promise<void>} 本触发已被消费（注册态已反映 desired）后 resolve。
@@ -4875,10 +4883,20 @@ function createProviderReconciler(deps) {
 				if (++guard > 20) break;
 			}
 		});
+		result.then(() => {
+			lastError = null;
+		}, (error) => {
+			lastError = error;
+			logger?.warn?.(`${name}: reconcile pass failed (${redactSecrets(errMsg(error))}); state will be reconciled on the next trigger`);
+		});
 		chain = result.then(() => void 0, () => void 0);
 		return result;
 	};
-	return { reconcile };
+	return {
+		reconcile,
+		/** 最近一次未被记档的意外反抗（成功即清空）；null = 当前健康。 */
+		health: () => ({ lastError })
+	};
 }
 
 //#endregion

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "ModelScope Quota Connect",
-    "description": "ModelScope API-Inference free-quota panel: official Magicube balance, local call counts and trends, rate-limit event stream, auth-free model catalog and zero-quota token validation, plus optional registration of ModelScope as an OpenAI-compatible DSH provider (roadmap)."
+    "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."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "魔搭接入 · 额度面板",
-    "description": "魔搭（ModelScope）API-Inference 免费额度面板：官方魔粒余额、本地调用计数与趋势、限流事件流、免认证模型目录与零额度令牌校验，可选把魔搭注册成 DSH 的 OpenAI 兼容 provider（路线图）。"
+    "title": "魔搭模型接入",
+    "description": "一键把魔搭（ModelScope）的语言模型与生图工具注册进 DSH：自动填入图片识别能力与上下文窗口，注册即可用（均默认关）；不注册也能看免费额度面板：官方魔粒余额、本地调用计数、趋势、限流事件。"
   }
 }

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.1",
+  "version": "0.6.2",
   "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) connect bundle for the Harness Web UI: the official Magicube balance plus, for calls made through this plugin, per-model counts, a daily trend, and a 429 error event list on the Plugins-page panel, plus a default-off switch that registers ModelScope models as a DSH LLM provider.",
+  "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.",
   "keywords": [
     "dsh-plugin",
     "deepseek-harness",