dsh-connect-modelscope-token-plan 0.4.0 → 0.5.0

package/cordis.patch.yml

@@ -24,8 +24,12 @@
         # 删除——留着它们只会让人以为面板能算「还剩几次」，而它算不出。
         # 本地计数的独家价值在分布 / 趋势 / 429 事件流，不在「离上限多远」。
         # ------------------------------------------------------------------
-        # 本地趋势保留天数（插件私有状态文件里的天桶数量，与上游无关）。
+        # 趋势图显示天数（面板标题「近 N 天」与图上柱数）——面板里可改看多长。
         trendDays: 14
+        # 本地趋势**保留**天数（插件私有状态文件里的天桶数量，与上游无关）。
+        # 独立于 trendDays：显示只决定「画多少」，保留决定「留多少」。留得比画得多，
+        # 面板才可能让你把窗口调到更远。显示窗口恒被硬夹在保留之内。
+        retentionDays: 90
         # 429/错误事件环形缓冲的上限（面板只展示最近的）。上界 1000，硬夹。
         maxEvents: 50
         # Host 侧对 /v1/models 的缓存秒数；面板脚注直接引用此值。上界 600。
@@ -77,13 +81,14 @@
         # 没有任何 text-to-image。官方示例里的 Qwen/Qwen-Image-2.1-Turbo 与
         # black-forest-labs/FLUX.1-Kontext-dev **都不在目录内**，后者实测 FAILED。
         drawModelId: ""
-        # 单次出图总预算（毫秒），含提交与全部轮询。上界 900000（15 分钟）。
-        # 别调小：实测最慢一次 859s 才成功，而超时放弃**不等于**任务死亡
-        # （上游会继续跑），把预算压到 5 分钟曾实测击穿。
+        # 单次出图总预算（毫秒），含提交与全部轮询。上界 1800000（30 分钟），
+        # 严格高于这个默认值——它**不是**上限。别调小：实测最慢一次 859s 才成功，
+        # 而超时放弃**不等于**任务死亡（上游会继续跑），把预算压到 5 分钟曾实测击穿。
         drawTimeoutMs: 900000
         # 单次出图**工具调用**愿意等的时间（毫秒）。与上面那条是两件事：那是
         # 「这张图值不值得继续等」的总放弃线，这是「一轮对话被占住多久」。
         # 等不到就返回 pending + jobId，agent 带 jobId 再调用即可续查。
+        # 实际取值夹在 10s 与上面那条 drawTimeoutMs 之间（等待超过总放弃线没有意义）。
         drawWaitMs: 90000
         # 追加可信 Host 名（默认 localhost / 127.0.0.1 / ::1，只增不替）。
         # allowedHosts: []

package/lib/host-config.js

@@ -482,6 +482,22 @@ const KNOWN_VISION_IDS = Object.freeze(/* @__PURE__ */ new Set([
 	"stepfun-ai/Step-3.7-Flash"
 ]));
 /**
+* 已知能**纯文生图**的目录内模型 id（2026-10-16 真机复核）。
+*
+* 为什么需要手工策展：api-inference 目录里至今**没有**平台声明的 `text-to-image`
+* 条目，只有 2 条 `image-to-image`——而两者行为**不同**：
+* `Qwen/Qwen-Image-Edit` 不带 `image_url` 纯文生图可用（本轮实测：提交成功、两次
+* 15min 排队超时后于 9.7min 出图）；`MusePublic/Qwen-Image-Edit` 纯文生图被上游
+* 直接拒绝（提交阶段 HTTP 4xx：`image_url is required for model: …`）。
+* 能力枚举把两者都归为 `image-to-image`，区分不了这个差异，所以这里用实测知识兜底：
+* 目录里没有 `text-to-image` 可挑时，默认偏向这个已知能用的 id，而不是「目录第一个」
+* （真实目录顺序 `MusePublic/…` 在前，照旧逻辑纯文生图必挂）。
+*
+* 与 `KNOWN_VISION_IDS` 放在一起：所有「哪些模型能做什么」的策展知识集中一处，
+* 不会漂。
+*/
+const KNOWN_T2I_MODEL_ID = "Qwen/Qwen-Image-Edit";
+/**
 * 把原始 `/v1/models` data 条目变成归一目录条目。
 *
 * 只做投影与回退，不做判断：`id` 必取，`name` 回退 id，`vision`/`contextWindow`/
@@ -899,6 +915,85 @@ function textToImageModelIds(entries) {
 	return idsOf(entries, (entry) => resolveModelCapability(entry) === "text-to-image");
 }
 /**
+* 一份目录里的出图候选，按首见顺序去重，带能力档与纯文生图标记。
+*
+* 与 {@link imageGenModelIds} 同一份判定（只认平台声明的出图能力），只是把
+* `reference` 需要的两个附加位一起投出来——面板的每一行徽章与「当前使用」都从
+* 这里派生，不各自再判一次。
+* @param {unknown} entries - 归一目录条目。
+* @returns {DrawCandidate[]} 出图候选。
+*/
+function drawCandidates(entries) {
+	const position = /* @__PURE__ */ new Map();
+	const out = [];
+	for (const entry of Array.isArray(entries) ? entries : []) {
+		if (entry === null || typeof entry !== "object" || Array.isArray(entry)) continue;
+		const e = entry;
+		if (!isImageGenModel(e)) continue;
+		const id = str(e.id, "");
+		if (id === "") continue;
+		const capability = resolveModelCapability(e);
+		const row = {
+			id,
+			capability: capability === "text-to-image" ? "text-to-image" : capability === "image-to-image" ? "image-to-image" : "other",
+			textToImage: capability === "text-to-image" || id === "Qwen/Qwen-Image-Edit"
+		};
+		const seen = position.get(id);
+		if (seen === void 0) {
+			position.set(id, out.length);
+			out.push(row);
+		} else out[seen] = row;
+	}
+	return out;
+}
+/**
+* 从目录里挑一个出图模型，并说明**为什么是它**。
+*
+* 优先级（高 → 低），与 `draw-runtime.ts` 的 `pickDrawModel` 同一份：
+* 1. `requested` —— 工具调用里显式给的 model（这里不投理由，调用方场景）；
+* 2. `preferred` —— 面板保存 / 配置 `drawModelId`；用户点了谁就是谁，不校验在不在目录；
+* 3. 平台声明为 `text-to-image` 的条目（将来目录补上真文生图模型时自动优先）；
+* 4. 已知能纯文生图的 `KNOWN_T2I_MODEL_ID`（今天目录的坑位）；
+* 5. 目录里第一个出图模型。
+*
+* `requested` 会以 `preferred` 的理由返回——它同样是「有人指定了」，面板不需要
+* 为一次工具调用区分这两者。
+* @param {unknown} entries - 归一目录条目。
+* @param {string} [requested] - 工具调用显式指定的 id。
+* @param {string} [preferred] - 面板/配置的默认 id。
+* @returns {DrawModelChoice} 选中的 id 与理由。
+*/
+function resolveDrawModelChoice(entries, requested, preferred) {
+	const want = str(requested, "");
+	if (want !== "") return {
+		id: want,
+		source: "preferred"
+	};
+	const preferredId = str(preferred, "");
+	if (preferredId !== "") return {
+		id: preferredId,
+		source: "preferred"
+	};
+	const ids = imageGenModelIds(entries);
+	if (ids.length === 0) return {
+		id: null,
+		source: null
+	};
+	const t2i = textToImageModelIds(entries);
+	if (t2i.length > 0) return {
+		id: t2i[0] ?? null,
+		source: "declared-text-to-image"
+	};
+	if (ids.includes("Qwen/Qwen-Image-Edit")) return {
+		id: KNOWN_T2I_MODEL_ID,
+		source: "known-text-to-image"
+	};
+	return {
+		id: ids[0] ?? null,
+		source: "catalog-first"
+	};
+}
+/**
 * 带额度可用性的面板 roster。
 *
 * 与 {@link rosterOf} 一样每 chat 模型 id 一行，但每行还带该模型额度池是否耗尽。
@@ -949,7 +1044,7 @@ const inject = ["webServer"];
 * 产物反而引入第二份真源；这里用常量、由 test/config.test.mjs 钉住与
 * package.json 一致。
 */
-const PLUGIN_VERSION = "0.4.0";
+const PLUGIN_VERSION = "0.5.0";
 /**
 * 默认值。刻意不含额度常数——理由见本文件头。
 * 面板头条是官方魔粒余额，次数口径的推算已在面板收敛时删除，这里若留着
@@ -960,8 +1055,23 @@ const CONFIG_DEFAULTS = Object.freeze({
 	apiBase: "https://api-inference.modelscope.cn/v1",
 	/** 站点源站，只用于面板外链（访问令牌页 / 文档）。 */
 	siteBase: "https://modelscope.cn",
-	/** 本地趋势保留天数（usage-store 天桶数量；超出即修剪）。 */
+	/**
+	* 趋势图**显示**天数（面板标题「近 N 天」与图上柱数）——默认值，用户可在面板里
+	* 改看多长。
+	*
+	* **与 retentionDays 是两件事**（2026-10-17 拆开）：这个数只决定「画多少」，
+	* 不再决定「留多少」。曾经一个 trendDays 同时是保留窗口，于是「想多看几天」等于
+	* 「改保留策略」，改小还会把历史当场剪掉——拆开正是为了消除这层耦合。
+	*/
 	trendDays: 14,
+	/**
+	* 本地趋势**保留**天数（usage-store 天桶的修剪窗口；超出即删）。
+	*
+	* 取 90：够回看一个季度，而每个天桶只是两个整数——留 90 天的磁盘代价可忽略。
+	* 显示窗口恒被夹在它之内（见 resolveSettings），所以「画得比留得多」这个会把
+	* 已剪的日子画成 0（与「那天真的没调用」在面板上无法区分）的组合不会出现。
+	*/
+	retentionDays: 90,
 	/** Host 侧对 /v1/models 的缓存秒数。 */
 	cacheSeconds: 60,
 	/** 面板轮询间隔——由 Host 下发、面板跟随，两端不各自假设。 */
@@ -995,6 +1105,10 @@ const CONFIG_DEFAULTS = Object.freeze({
 	* 取 15 分钟：覆盖已观测到的最慢一次（537s）并留一倍余量。**注意超时放弃不等于
 	* 任务死亡**——上游任务会继续跑（且记录最终会被回收，见 docs/SPIKE-image-gen.md
 	* §坑 5）。宁可多等，不要把一张已经在生成的图扔掉。
+	*
+	* 「15 分钟够不够」我们**没有把握**（上面的实测还在恶化），所以夹取的上界
+	* `DRAW_TIMEOUT_MAX_MS` 取 30 分钟，严格高于本默认值——觉得不够就往上调，
+	* 别把它当上限用。
 	*/
 	drawTimeoutMs: 9e5,
 	/**
@@ -1023,6 +1137,20 @@ function clampInt(raw, def, min, max = Infinity) {
 	return Math.min(max, Math.max(min, Math.floor(num(raw, def))));
 }
 /**
+* `drawTimeoutMs` 的**上界**——必须严格大于它的默认值。
+*
+* 这个上界曾经与默认值同为 900_000，于是该字段只能调小、不能调大。而「15 分钟
+* 够不够」恰恰是本文件自己承认**没有把握**的问题：上面的注释记着同模型连测
+* 61s→261s→**537s** 的单调恶化、5 分钟预算被实测击穿，docs/SPIKE-image-gen.md
+* 还记着一次 900s 预算的 e2e 在 905s 放弃。把一个**已知可能不够用**的数值同时
+* 写成默认值与硬上限，等于在用户最需要「多等一会儿」的时刻把旋钮焊死——而且
+* 焊死在一个已被实测证伪的数上。
+*
+* 取 30 分钟：仍是有界的（不会让一次工具调用无限期挂着），但比默认值高出一倍，
+* 慢档用户有可调空间。它同时是 `drawWaitMs` 的上界来源（见 resolveSettings）。
+*/
+const DRAW_TIMEOUT_MAX_MS = 18e5;
+/**
 * 端点必须是合法的 http(s) 绝对地址；不是就在**挂载时**抛（resolveSettings
 * 捕获后转成 configError 经快照呈现），而不是等到第一次轮询才变成莫名其妙的
 * 网络失败。
@@ -1049,11 +1177,14 @@ function resolveSettings(config) {
 		const siteBase = str(source.siteBase, CONFIG_DEFAULTS.siteBase).replace(/\/+$/, "");
 		assertHttpUrl(apiBase, "apiBase");
 		assertHttpUrl(siteBase, "siteBase");
+		const drawTimeoutMs = clampInt(source.drawTimeoutMs, CONFIG_DEFAULTS.drawTimeoutMs, 3e4, DRAW_TIMEOUT_MAX_MS);
+		const retentionDays = clampInt(source.retentionDays, CONFIG_DEFAULTS.retentionDays, 1, 365);
 		return {
 			settings: {
 				apiBase,
 				siteBase,
-				trendDays: clampInt(source.trendDays, CONFIG_DEFAULTS.trendDays, 1, 365),
+				trendDays: clampInt(source.trendDays, CONFIG_DEFAULTS.trendDays, 1, retentionDays),
+				retentionDays,
 				cacheSeconds: clampInt(source.cacheSeconds, CONFIG_DEFAULTS.cacheSeconds, 5, 600),
 				pollSeconds: clampInt(source.pollSeconds, CONFIG_DEFAULTS.pollSeconds, 5, 3600),
 				inferenceTimeoutMs: clampInt(source.inferenceTimeoutMs, CONFIG_DEFAULTS.inferenceTimeoutMs, 1e3, 6e5),
@@ -1061,8 +1192,8 @@ function resolveSettings(config) {
 				registerProvider: source.registerProvider === true,
 				drawEnabled: source.drawEnabled === true,
 				drawModelId: str(source.drawModelId, CONFIG_DEFAULTS.drawModelId),
-				drawTimeoutMs: clampInt(source.drawTimeoutMs, CONFIG_DEFAULTS.drawTimeoutMs, 3e4, 9e5),
-				drawWaitMs: clampInt(source.drawWaitMs, CONFIG_DEFAULTS.drawWaitMs, 1e4, 9e5),
+				drawTimeoutMs,
+				drawWaitMs: clampInt(source.drawWaitMs, CONFIG_DEFAULTS.drawWaitMs, 1e4, drawTimeoutMs),
 				allowedHosts: resolveAllowedHosts(source)
 			},
 			configError: null
@@ -1073,6 +1204,7 @@ function resolveSettings(config) {
 				apiBase: CONFIG_DEFAULTS.apiBase,
 				siteBase: CONFIG_DEFAULTS.siteBase,
 				trendDays: CONFIG_DEFAULTS.trendDays,
+				retentionDays: CONFIG_DEFAULTS.retentionDays,
 				cacheSeconds: CONFIG_DEFAULTS.cacheSeconds,
 				pollSeconds: CONFIG_DEFAULTS.pollSeconds,
 				inferenceTimeoutMs: CONFIG_DEFAULTS.inferenceTimeoutMs,
@@ -1148,4 +1280,4 @@ function isAdmitted(request, allowedHosts) {
 }
 
 //#endregion
-export { obj as C, str as D, redactSecrets as E, verbatim as O, errMsg as S, pluginError as T, CODE as _, resolveSettings as a, reclassifyStream as b, LLM_PROVIDER_ID as c, isVisionModel as d, normalizeEntry as f, parseAllowedList as g, enabledCountOf as h, name as i, buildDescriptors as l, textToImageModelIds as m, inject as n, LLM_API_KEY_NAME as o, rosterWithAvailability as p, isAdmitted as r, LLM_DISPLAY_NAME as s, PLUGIN_VERSION as t, imageGenModelIds as u, hasHardQuotaWordingIn as v, optional as w, degrade as x, looksLikeRateLimit as y };
+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 };