dsh-neartoken 0.19.2 → 0.21.0

package/README.md

@@ -24,7 +24,7 @@
 |---|---|
 | `src/index.ts` | 配置 schema、按凭据现状挂载 provider、装配其余模块 |
 | `src/host/account.ts` | RFC 8628 形状的设备授权：发起、按 interval 轮询、把 key 写进 credentials |
-| `src/host/routes.ts` | 设置页调用的同源路由（状态 / 余额立即刷新 / 授权 / 取消 / 断开 / 模型白名单 / 生图设置） |
+| `src/host/routes.ts` | 设置页与模型选择器调用的同源路由（状态 / 余额立即刷新 / 授权 / 取消 / 断开 / 模型白名单 / 生图设置 / 长连接端点） |
 | `src/host/whitelist.ts` | 白名单读写在插件自身 Config 的 `enabledModels`（volatile），存 profile patch |
 | `src/host/pricing.ts` | 拉 `/api/pricing`，展开成 `"<组>::<模型>"` 路由，过滤出能聊的模型 |
 | `src/host/model-caps.ts` | 一个模型能不能聊、上下文窗口多大、可选的推理等级（只读站点声明，不存模型表） |
@@ -33,6 +33,7 @@
 | `src/host/protocol-router.ts` | 按模型选上游协议（claude / gemini / gpt / 其余） |
 | `src/host/session-key.ts` | 从 `GenerateOptions.sessionId` 取会话亲和键，四条 wire 用它让站点把会话粘在同一渠道 |
 | `src/host/provider-mount.ts` | 路由挂载、撤下、白名单变更时 `replace()` 重播 |
+| `src/host/relay.ts` | 模型接口走哪个域名：站点根或长连接端点，由模型选择器里的开关决定 |
 | `src/host/topup.ts` | 站点充值面：读 amount 档位与渠道、下单，把 403 `DSH_TOKEN_REQUIRED` 翻成「是否 DSH 密钥」的原因 |
 | `src/host/images.ts` | 生图：挑通道、发请求、两种响应都读成 bytes |
 | `src/host/image-tool.ts` | `generate_image` 工具：选模型/分组、把图写进 attachment |
@@ -59,6 +60,8 @@
 
 分组路由按同一文档：请求头 `x-neartoken-group` 的值是 `/api/pricing` 的 `group_refs` 给出的 **`#<id>`**（纯 ASCII），分组名只用于展示；某分组没有 ref 时不发该头，按令牌自身分组路由。
 
+模型选择器的根菜单里，「分组」下面一行是**长连接端点**开关：打开后所有**模型接口**（`/v1/chat/completions`、`/v1/messages`、`/v1/responses`、`/v1/images/*`、Gemini 的 `/v1beta/*`）改走 `https://direct.neartoken.cc`，站点控制台的 `/api/*`（目录、用量、钱包、充值、设备授权）仍走 `baseURL`。开关写进插件配置的 `directLink`（volatile），点完立刻对下一次请求生效，不需要重启。它只出现在本插件自己的 provider 上。
+
 模型选择器里的分组是**显式选择**：换模型时先保留当前分组；新模型不在该分组时，按分组名上的档位标签（`[低价]` / `[满血]` / `[官key]` 等）就近匹配同一档位的分组，而不是落回站点目录里的第一个分组——那一个往往是倍率最高的。跨模型族（`[低价] DeepSeek` → GPT）也按标签匹配。
 
 ## 数据概览（消耗 / Token / 模型堆积）
@@ -105,6 +108,8 @@ https://<site>/dsh/device?user_code=K7QM-3XPD&aff=<code>
 | 字段 | 默认 | 说明 |
 |---|---|---|
 | `baseURL` | `https://neartoken.cc` | 站点根地址，不带尾斜杠 |
+| `directEndpoint` | `https://direct.neartoken.cc` | 长连接端点；模型选择器打开开关后模型接口改走它，`/api/*` 不受影响 |
+| `directLink` | `false` | 长连接端点开关；volatile，模型选择器直接写它 |
 | `apiKeyEnv` | `NEARTOKEN_API_KEY` | 授权写入、adapter 读取的凭据引用名 |
 | `catalogTtlMs` | `300000` | `/api/pricing` 目录缓存时长 |
 | `defaultContextWindow` | `200000` | 没有任何来源能说明某模型上下文窗口时上报的值 |
@@ -220,7 +225,7 @@ location / {
 
 | 通道 | 判定 | 请求 | 响应 |
 |---|---|---|---|
-| `images` | 声明含 `image-generation`（gpt-image 系） | `POST /v1/images/generations` | `data[0].b64_json` 或临时 `url` |
+| `images` | 声明含 `image-generation`（gpt-image 系） | `POST /v1/images/tasks` 提交 → `GET /v1/images/tasks/<id>` 轮询 | 任务 `SUCCESS` 的 `data[0].url` / `b64_json`；站点回落同步时直接是 `data[0]` |
 | `genai` | 声明含 `gemini`（nano-banana、`gemini-*-image`） | `POST /v1beta/models/<model>:generateContent` | `candidates[0].content.parts[].inlineData`（结构化） |
 | `chat` | 其余（只有 `openai` 的，如 grok-imagine） | `POST /v1/chat/completions` | 回复文本里的 `data:image/...;base64,` 或图片链接 |
 
@@ -234,7 +239,7 @@ Gemini 系走原生 surface 而不是 openai 兼容层：同模型同提示词
 
 `images` 传工作区里的图片路径，工具读成 data URL 后按通道发送：
 
-- **images 通道**：作为 `image` 数组（data URL）发给 `/v1/images/generations`（站点 DTO 里没有可用的 `edits` 路由，参考图只能搭生成请求）
+- **images 通道**：作为 `image` 数组（data URL）随任务提交发给 `/v1/images/tasks`（站点 DTO 里没有可用的 `edits` 路由，参考图只能搭生成请求）
 - **genai 通道**：作为 `inlineData` part 与提示词一起进 `contents[0].parts`
 - **chat 通道**：作为 `image_url` content part 与提示词一起进 `messages`
 
@@ -251,13 +256,22 @@ Gemini 系走原生 surface 而不是 openai 兼容层：同模型同提示词
 
 限制：一次只出一张图（`n` 未暴露）；`mask` 局部重绘、`input_fidelity` 未暴露。
 
+### 异步任务
+
+`images` 通道的模型走站点的 **durable task**：`POST /v1/images/tasks` 立刻返回 `202 + task_id`，插件每 3 秒（退避到 5 秒）轮询 `GET /v1/images/tasks/<id>`，`SUCCESS` 后再取 `data[0].url` / `b64_json`。慢模型不再靠一条长 HTTP 撑时间 —— 连接断了，任务还在站点上跑。
+
+- **轮询只重读，不重提交**：轮询撞上 5xx、网关故障或断网，按同一 `task_id` 再来一次；任务没有幂等键，重复提交会重复计费，所以提交没拿到任务就原样报给模型，由模型决定要不要重试。
+- **取消只停轮询**：`exec.signal` 中止后本地不再查询，站点上的任务照常跑完并按站点规则计费。
+- **失败带站点原话**：`FAILURE` 的 `fail_reason`（例如 `DataInspectionFailed: …`）直接进错误消息，不用去站点后台翻。
+- **两种回落都能接**：站点没把该模型认领成任务时，同一端点直接回 `200 + data[]`；不认这个端点的老站点回 404，插件改用 `POST /v1/images/generations` 同步等一次。
+
 ### 超时
 
 生图是几十秒到几分钟的活，所以有两条时间线，故意错开：
 
 | 层 | 值 | 超时后模型看到什么 |
 |---|---|---|
-| 插件自己的预算 | `imageTimeoutMs`（默认 300 秒） | `the site did not return an image within 300s (imageTimeoutMs); … retry, raise imageTimeoutMs, or enable a faster image model` |
+| 插件自己的预算 | `imageTimeoutMs`（默认 300 秒），**从提交到拿到图的总预算**（含轮询） | `the site did not return an image within 300s (imageTimeoutMs); … a submitted task keeps running on the site and is billed when it finishes …` |
 | 工具调用截止时间 | `imageTimeoutMs + 30 秒`，声明给 harness 的 timeout policy | 通用的 `tool call timed out after …ms` |
 
 自己那条早 30 秒触发，所以正常情况模型拿到的是**能指路**的那条（等了多久、该调哪个旋钮）；harness 那条只兜住「工具无视 abort 继续跑」。预算耗尽和调用方取消是分开处理的（`AbortSignal.any` 里单独持有预算信号），取消原样向上传递，不会被写成超时。

package/lib/client.js

@@ -44,6 +44,8 @@ window.__ModuleLoader__.load({
 		const MODELS_PATH = "/neartoken/models";
 		/** Read the picture models and the image-generation setting; POST one change to it. */
 		const IMAGES_PATH = "/neartoken/images";
+		/** Read the long-connection switch; POST its new state. */
+		const LINK_PATH = "/neartoken/link";
 		/** Read the site's top-up offer; POST one order and open its checkout page. */
 		const TOPUP_PATH = "/neartoken/topup";
 		/**
@@ -200,6 +202,20 @@ window.__ModuleLoader__.load({
 						const refusal = await response.json().catch(() => ({ message: `HTTP ${String(response.status)}` }));
 						throw new Error(refusal.message ?? `HTTP ${String(response.status)}`);
 					}
+				},
+				async link() {
+					return await jsonOf(await fetcher(LINK_PATH, { headers: { accept: "application/json" } }));
+				},
+				async saveLink(direct) {
+					const response = await fetcher(LINK_PATH, {
+						method: "POST",
+						headers: { "content-type": "application/json" },
+						body: JSON.stringify({ direct })
+					});
+					if (!response.ok) {
+						const refusal = await response.json().catch(() => ({ message: `HTTP ${String(response.status)}` }));
+						throw new Error(refusal.message ?? `HTTP ${String(response.status)}`);
+					}
 				}
 			};
 		}
@@ -456,23 +472,23 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var group_tags_module_css_default = {
-			"toneIndigo": "FotuUq_toneIndigo",
-			"toneLime": "FotuUq_toneLime",
-			"toneRose": "FotuUq_toneRose",
-			"toneEmerald": "FotuUq_toneEmerald",
-			"ratioChip": "FotuUq_ratioChip",
-			"toneFuchsia": "FotuUq_toneFuchsia",
 			"toneOrange": "FotuUq_toneOrange",
+			"toneTeal": "FotuUq_toneTeal",
+			"ratioChip": "FotuUq_ratioChip",
+			"toneRose": "FotuUq_toneRose",
+			"toneIndigo": "FotuUq_toneIndigo",
 			"tag": "FotuUq_tag",
-			"toneViolet": "FotuUq_toneViolet",
+			"toneEmerald": "FotuUq_toneEmerald",
 			"toneSky": "FotuUq_toneSky",
-			"toneAmber": "FotuUq_toneAmber",
+			"ratioBase": "FotuUq_ratioBase",
 			"ratioPricey": "FotuUq_ratioPricey",
-			"ratioCheap": "FotuUq_ratioCheap",
-			"toneTeal": "FotuUq_toneTeal",
+			"toneAmber": "FotuUq_toneAmber",
 			"toneCyan": "FotuUq_toneCyan",
+			"ratioCheap": "FotuUq_ratioCheap",
 			"tonePink": "FotuUq_tonePink",
-			"ratioBase": "FotuUq_ratioBase"
+			"toneViolet": "FotuUq_toneViolet",
+			"toneFuchsia": "FotuUq_toneFuchsia",
+			"toneLime": "FotuUq_toneLime"
 		};
 		//#endregion
 		//#region src/client/group-tags.tsx
@@ -517,7 +533,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:D:\Projects\deepseek-harness\dsh-neartoken\src\client\ModelGroupSelect.module.css.mjs
-		const css$1 = "._2pt-bW_root{min-width:0;position:relative}._2pt-bW_trigger{border-radius:var(--dsw-radius-sm);min-width:0;max-width:min(360px,45cqw);height:28px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;outline:none;align-items:center;gap:4px;padding:0 4px 0 8px;font-size:13px;font-weight:400;line-height:20px;display:flex}._2pt-bW_trigger:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}._2pt-bW_trigger:focus-visible{box-shadow:0 0 0 2px var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary))}._2pt-bW_trigger:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}._2pt-bW_triggerLabel{text-overflow:ellipsis;white-space:nowrap;min-width:0;overflow:hidden}._2pt-bW_triggerEffort{text-overflow:ellipsis;white-space:nowrap;min-width:0;color:var(--dsw-alias-label-caption);flex-shrink:1000;overflow:hidden}._2pt-bW_triggerIcon{display:var(--dsh-composer-model-icon-display,none);flex:none}._2pt-bW_chevron{color:var(--dsw-alias-label-caption);flex:none}._2pt-bW_menu{z-index:1100;--dsw-elevation-stroke-color:var(--dsw-alias-border-l1);width:max-content;min-width:min(240px,100vw - 32px);max-width:min(420px,100vw - 32px);max-height:min(360px,100vh - 96px);box-shadow:var(--dsw-elevation-prominent);color:var(--dsw-alias-label-primary);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border:0;flex-direction:column;padding:4px;display:flex;position:fixed;overflow:hidden}._2pt-bW_status,._2pt-bW_empty{color:var(--dsw-alias-label-tertiary);padding:8px;font-size:12px;line-height:18px}._2pt-bW_error,._2pt-bW_warning{border-radius:var(--dsw-radius-md);background:var(--dsw-alias-interactive-bg-hover-danger);color:var(--dsw-alias-state-error-primary);justify-content:space-between;align-items:flex-start;gap:6px;margin-bottom:3px;padding:6px 7px;font-size:11px;line-height:16px;display:flex}._2pt-bW_warning{background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-state-warn-label)}._2pt-bW_retry{color:inherit;font:inherit;cursor:pointer;background:0 0;border:none;flex:none;padding:0;font-weight:600}._2pt-bW_searchRow{flex-shrink:0;margin:2px 0 3px;position:relative}._2pt-bW_searchRow ._2pt-bW_search{border-radius:var(--dsw-radius-md);background:0 0;border:0 solid #0000;height:auto;padding:5px 7px;display:flex}._2pt-bW_searchRow ._2pt-bW_search input{padding:0;font-size:12px;line-height:normal}._2pt-bW_searchClear{width:24px;height:24px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;border-radius:50%;justify-content:center;align-items:center;padding:0;display:inline-flex;position:absolute;top:50%;right:4px;transform:translateY(-50%)}._2pt-bW_searchClear:hover,._2pt-bW_searchClear:focus-visible{background:var(--dsw-alias-interactive-bg-hover);outline:none}._2pt-bW_groups{min-height:0;overflow-y:auto}._2pt-bW_option{box-sizing:border-box;border-radius:var(--dsw-radius-md);width:auto;min-width:100%;min-height:34px;color:inherit;text-align:left;cursor:pointer;background:0 0;border:none;outline:none;align-items:center;gap:6px;padding:5px 7px;display:flex}._2pt-bW_option:not(._2pt-bW_modelOption):hover:not(:disabled),._2pt-bW_option:focus-visible,._2pt-bW_optionActive:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}._2pt-bW_selected{background:0 0}._2pt-bW_option:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}._2pt-bW_optionCopy{flex-direction:column;flex:1;min-width:0;display:flex}._2pt-bW_modelName{color:inherit;text-overflow:ellipsis;white-space:nowrap;font-size:13px;font-weight:400;line-height:18px;overflow:hidden}._2pt-bW_optionTrailing{flex:none;align-items:center;gap:6px;display:flex}._2pt-bW_variantCount{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-tertiary);border-radius:999px;padding:0 5px;font-size:10px;line-height:16px}._2pt-bW_check{color:var(--dsw-alias-label-primary);flex:0 0 14px;place-items:center;display:grid}._2pt-bW_check svg{width:14px;height:14px}._2pt-bW_cell{box-sizing:border-box;border-radius:var(--dsw-radius-md);width:auto;min-width:100%;height:34px;color:var(--dsw-alias-label-primary);cursor:pointer;text-align:left;background:0 0;border:none;outline:none;align-items:center;gap:6px;padding:0 8px;font-size:13px;line-height:20px;display:flex}._2pt-bW_cell:hover:not(:disabled),._2pt-bW_cell:focus-visible{background:var(--dsw-alias-interactive-bg-hover)}._2pt-bW_cell:disabled{cursor:default}._2pt-bW_cellLabel{white-space:nowrap;flex:none}._2pt-bW_cellValue{text-align:right;min-width:0;color:var(--dsw-alias-label-tertiary);flex:auto;justify-content:flex-end;display:flex;overflow:hidden}._2pt-bW_cellChevron{width:12px;height:12px;color:var(--dsw-alias-menu-icon);flex:none}._2pt-bW_groupInline{align-items:center;gap:4px;min-width:0;display:inline-flex;overflow:hidden}._2pt-bW_groupName{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}._2pt-bW_groupOptionLabel{align-items:center;min-width:0;display:flex;overflow:hidden}._2pt-bW_toast{z-index:1100;border-radius:var(--dsw-radius-md);background:var(--dsw-alias-interactive-bg-hover-danger);max-width:320px;color:var(--dsw-alias-state-error-primary);padding:6px 10px;font-size:11px;line-height:16px;position:absolute;bottom:calc(100% + 6px);right:0}";
+		const css$1 = "._2pt-bW_root{min-width:0;position:relative}._2pt-bW_trigger{border-radius:var(--dsw-radius-sm);min-width:0;max-width:min(360px,45cqw);height:28px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;outline:none;align-items:center;gap:4px;padding:0 4px 0 8px;font-size:13px;font-weight:400;line-height:20px;display:flex}._2pt-bW_trigger:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}._2pt-bW_trigger:focus-visible{box-shadow:0 0 0 2px var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary))}._2pt-bW_trigger:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}._2pt-bW_triggerLabel{text-overflow:ellipsis;white-space:nowrap;min-width:0;overflow:hidden}._2pt-bW_triggerEffort{text-overflow:ellipsis;white-space:nowrap;min-width:0;color:var(--dsw-alias-label-caption);flex-shrink:1000;overflow:hidden}._2pt-bW_triggerIcon{display:var(--dsh-composer-model-icon-display,none);flex:none}._2pt-bW_chevron{color:var(--dsw-alias-label-caption);flex:none}._2pt-bW_menu{z-index:1100;--dsw-elevation-stroke-color:var(--dsw-alias-border-l1);width:max-content;min-width:min(240px,100vw - 32px);max-width:min(420px,100vw - 32px);max-height:min(360px,100vh - 96px);box-shadow:var(--dsw-elevation-prominent);color:var(--dsw-alias-label-primary);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border:0;flex-direction:column;padding:4px;display:flex;position:fixed;overflow:hidden}._2pt-bW_status,._2pt-bW_empty{color:var(--dsw-alias-label-tertiary);padding:8px;font-size:12px;line-height:18px}._2pt-bW_error,._2pt-bW_warning{border-radius:var(--dsw-radius-md);background:var(--dsw-alias-interactive-bg-hover-danger);color:var(--dsw-alias-state-error-primary);justify-content:space-between;align-items:flex-start;gap:6px;margin-bottom:3px;padding:6px 7px;font-size:11px;line-height:16px;display:flex}._2pt-bW_warning{background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-state-warn-label)}._2pt-bW_retry{color:inherit;font:inherit;cursor:pointer;background:0 0;border:none;flex:none;padding:0;font-weight:600}._2pt-bW_searchRow{flex-shrink:0;margin:2px 0 3px;position:relative}._2pt-bW_searchRow ._2pt-bW_search{border-radius:var(--dsw-radius-md);background:0 0;border:0 solid #0000;height:auto;padding:5px 7px;display:flex}._2pt-bW_searchRow ._2pt-bW_search input{padding:0;font-size:12px;line-height:normal}._2pt-bW_searchClear{width:24px;height:24px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;border-radius:50%;justify-content:center;align-items:center;padding:0;display:inline-flex;position:absolute;top:50%;right:4px;transform:translateY(-50%)}._2pt-bW_searchClear:hover,._2pt-bW_searchClear:focus-visible{background:var(--dsw-alias-interactive-bg-hover);outline:none}._2pt-bW_groups{min-height:0;overflow-y:auto}._2pt-bW_option{box-sizing:border-box;border-radius:var(--dsw-radius-md);width:auto;min-width:100%;min-height:34px;color:inherit;text-align:left;cursor:pointer;background:0 0;border:none;outline:none;align-items:center;gap:6px;padding:5px 7px;display:flex}._2pt-bW_option:not(._2pt-bW_modelOption):hover:not(:disabled),._2pt-bW_option:focus-visible,._2pt-bW_optionActive:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}._2pt-bW_selected{background:0 0}._2pt-bW_option:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}._2pt-bW_optionCopy{flex-direction:column;flex:1;min-width:0;display:flex}._2pt-bW_modelName{color:inherit;text-overflow:ellipsis;white-space:nowrap;font-size:13px;font-weight:400;line-height:18px;overflow:hidden}._2pt-bW_optionTrailing{flex:none;align-items:center;gap:6px;display:flex}._2pt-bW_variantCount{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-tertiary);border-radius:999px;padding:0 5px;font-size:10px;line-height:16px}._2pt-bW_check{color:var(--dsw-alias-label-primary);flex:0 0 14px;place-items:center;display:grid}._2pt-bW_check svg{width:14px;height:14px}._2pt-bW_cell{box-sizing:border-box;border-radius:var(--dsw-radius-md);width:auto;min-width:100%;height:34px;color:var(--dsw-alias-label-primary);cursor:pointer;text-align:left;background:0 0;border:none;outline:none;align-items:center;gap:6px;padding:0 8px;font-size:13px;line-height:20px;display:flex}._2pt-bW_cell:hover:not(:disabled),._2pt-bW_cell:focus-visible{background:var(--dsw-alias-interactive-bg-hover)}._2pt-bW_cell:disabled{cursor:default}._2pt-bW_cellLabel{white-space:nowrap;flex:none}._2pt-bW_cellValue{text-align:right;min-width:0;color:var(--dsw-alias-label-tertiary);flex:auto;justify-content:flex-end;display:flex;overflow:hidden}._2pt-bW_cellChevron{width:12px;height:12px;color:var(--dsw-alias-menu-icon);flex:none}._2pt-bW_cellSwitch{box-sizing:border-box;width:auto;min-width:100%;height:34px;color:var(--dsw-alias-label-primary);align-items:center;gap:6px;padding:0 8px;font-size:13px;line-height:20px;display:flex}._2pt-bW_linkError{border-radius:var(--dsw-radius-md);background:var(--dsw-alias-interactive-bg-hover-danger);color:var(--dsw-alias-state-error-primary);margin:0 0 3px;padding:6px 7px;font-size:11px;line-height:16px}._2pt-bW_groupInline{align-items:center;gap:4px;min-width:0;display:inline-flex;overflow:hidden}._2pt-bW_groupName{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}._2pt-bW_groupOptionLabel{align-items:center;min-width:0;display:flex;overflow:hidden}._2pt-bW_toast{z-index:1100;border-radius:var(--dsw-radius-md);background:var(--dsw-alias-interactive-bg-hover-danger);max-width:320px;color:var(--dsw-alias-state-error-primary);padding:6px 10px;font-size:11px;line-height:16px;position:absolute;bottom:calc(100% + 6px);right:0}";
 		const tagId$1 = "dsh-neartoken/ModelGroupSelect.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
 			const tag = document.createElement("style");
@@ -527,39 +543,41 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var ModelGroupSelect_module_css_default = {
-			"triggerEffort": "_2pt-bW_triggerEffort",
-			"cellLabel": "_2pt-bW_cellLabel",
-			"groups": "_2pt-bW_groups",
-			"modelName": "_2pt-bW_modelName",
-			"groupName": "_2pt-bW_groupName",
-			"searchRow": "_2pt-bW_searchRow",
+			"cellChevron": "_2pt-bW_cellChevron",
 			"retry": "_2pt-bW_retry",
-			"empty": "_2pt-bW_empty",
-			"triggerLabel": "_2pt-bW_triggerLabel",
-			"status": "_2pt-bW_status",
-			"chevron": "_2pt-bW_chevron",
-			"search": "_2pt-bW_search",
-			"warning": "_2pt-bW_warning",
+			"cellSwitch": "_2pt-bW_cellSwitch",
+			"optionCopy": "_2pt-bW_optionCopy",
+			"error": "_2pt-bW_error",
 			"option": "_2pt-bW_option",
-			"cellValue": "_2pt-bW_cellValue",
-			"variantCount": "_2pt-bW_variantCount",
-			"cellChevron": "_2pt-bW_cellChevron",
 			"selected": "_2pt-bW_selected",
+			"variantCount": "_2pt-bW_variantCount",
+			"optionActive": "_2pt-bW_optionActive",
+			"groupInline": "_2pt-bW_groupInline",
 			"triggerIcon": "_2pt-bW_triggerIcon",
-			"searchClear": "_2pt-bW_searchClear",
-			"cell": "_2pt-bW_cell",
-			"groupOptionLabel": "_2pt-bW_groupOptionLabel",
+			"empty": "_2pt-bW_empty",
+			"check": "_2pt-bW_check",
+			"chevron": "_2pt-bW_chevron",
+			"status": "_2pt-bW_status",
+			"cellValue": "_2pt-bW_cellValue",
+			"modelName": "_2pt-bW_modelName",
+			"search": "_2pt-bW_search",
+			"root": "_2pt-bW_root",
 			"optionTrailing": "_2pt-bW_optionTrailing",
-			"toast": "_2pt-bW_toast",
-			"groupInline": "_2pt-bW_groupInline",
 			"modelOption": "_2pt-bW_modelOption",
-			"check": "_2pt-bW_check",
-			"optionCopy": "_2pt-bW_optionCopy",
-			"trigger": "_2pt-bW_trigger",
+			"linkError": "_2pt-bW_linkError",
+			"groups": "_2pt-bW_groups",
+			"groupName": "_2pt-bW_groupName",
 			"menu": "_2pt-bW_menu",
-			"error": "_2pt-bW_error",
-			"root": "_2pt-bW_root",
-			"optionActive": "_2pt-bW_optionActive"
+			"toast": "_2pt-bW_toast",
+			"triggerLabel": "_2pt-bW_triggerLabel",
+			"groupOptionLabel": "_2pt-bW_groupOptionLabel",
+			"warning": "_2pt-bW_warning",
+			"triggerEffort": "_2pt-bW_triggerEffort",
+			"cellLabel": "_2pt-bW_cellLabel",
+			"trigger": "_2pt-bW_trigger",
+			"searchRow": "_2pt-bW_searchRow",
+			"cell": "_2pt-bW_cell",
+			"searchClear": "_2pt-bW_searchClear"
 		};
 		//#endregion
 		//#region src/client/ModelGroupSelect.tsx
@@ -612,7 +630,7 @@ window.__ModuleLoader__.load({
 		* @param props - owner share (locked) + injected directory face + the locale seat.
 		* @returns the trigger and, while open, the three-level menu.
 		*/
-		function ModelGroupSelect({ locked, available, directory, load, select, t }) {
+		function ModelGroupSelect({ locked, available, directory, load, select, readLink, saveLink, t }) {
 			const state = (0, react.useSyncExternalStore)((fn) => directory.subscribe(fn), () => directory.getSnapshot());
 			const [open, setOpen] = (0, react.useState)(false);
 			const [pane, setPane] = (0, react.useState)("root");
@@ -624,6 +642,12 @@ window.__ModuleLoader__.load({
 			const menuRef = (0, react.useRef)(null);
 			const searchRef = (0, react.useRef)(null);
 			const [menuPos, setMenuPos] = (0, react.useState)(null);
+			/** The long-connection switch, once the Host answered; undefined while unread. */
+			const [direct, setDirect] = (0, react.useState)(void 0);
+			/** Whether a switch write is on the wire. */
+			const [linkBusy, setLinkBusy] = (0, react.useState)(false);
+			/** Why the last switch write was refused; cleared by the next one. */
+			const [linkError, setLinkError] = (0, react.useState)(null);
 			const id = (0, react.useId)();
 			const accountName = t("provider.account");
 			const providers = (0, react.useMemo)(() => state.groups.map((group) => ({
@@ -729,6 +753,24 @@ window.__ModuleLoader__.load({
 				pane,
 				showSearch
 			]);
+			const ownSeat = located !== void 0 && isGroupedProvider(located.provider.id);
+			(0, react.useEffect)(() => {
+				if (!open || !ownSeat) return;
+				let live = true;
+				readLink().then((next) => {
+					if (live) setDirect(next.direct);
+				}, (failure) => {
+					if (live) setLinkError(t("link.failed", { message: failure instanceof Error ? failure.message : String(failure) }));
+				});
+				return () => {
+					live = false;
+				};
+			}, [
+				open,
+				ownSeat,
+				readLink,
+				t
+			]);
 			if (!available) return null;
 			const settle = (result) => {
 				if (result === void 0) return;
@@ -783,6 +825,18 @@ window.__ModuleLoader__.load({
 					...effort === void 0 ? {} : { reasoningEffort: effort }
 				});
 			};
+			const toggleDirect = (next) => {
+				setDirect(next);
+				setLinkBusy(true);
+				setLinkError(null);
+				saveLink(next).then(() => {
+					setLinkBusy(false);
+				}, (failure) => {
+					setDirect(!next);
+					setLinkBusy(false);
+					setLinkError(t("link.failed", { message: failure instanceof Error ? failure.message : String(failure) }));
+				});
+			};
 			const onKeyDown = (event) => {
 				if (event.nativeEvent.isComposing) return;
 				if (event.key === "Escape" && open) {
@@ -891,6 +945,26 @@ window.__ModuleLoader__.load({
 										groupChoices.length > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronRightOutlineRegular, { className: ModelGroupSelect_module_css_default.cellChevron })
 									]
 								}),
+								ownSeat && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: ModelGroupSelect_module_css_default.cellSwitch,
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: ModelGroupSelect_module_css_default.cellLabel,
+										children: t("link.label")
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: ModelGroupSelect_module_css_default.cellValue,
+										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Switch, {
+											checked: direct === true,
+											disabled: linkBusy || direct === void 0,
+											label: t("link.label"),
+											onChange: toggleDirect
+										})
+									})]
+								}),
+								linkError === null ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: ModelGroupSelect_module_css_default.linkError,
+									role: "status",
+									children: linkError
+								}),
 								reasoning !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 									type: "button",
 									role: "menuitem",
@@ -1164,107 +1238,107 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var NearTokenSection_module_css_default = {
-			"voucherEmpty": "_02HI2q_voucherEmpty",
-			"row": "_02HI2q_row",
-			"notice": "_02HI2q_notice",
-			"series0": "_02HI2q_series0",
-			"series5": "_02HI2q_series5",
-			"voucherList": "_02HI2q_voucherList",
-			"label": "_02HI2q_label",
-			"tally": "_02HI2q_tally",
-			"metaLabel": "_02HI2q_metaLabel",
+			"tipTitle": "_02HI2q_tipTitle",
 			"badgeOn": "_02HI2q_badgeOn",
-			"metaChecks": "_02HI2q_metaChecks",
-			"metaCheck": "_02HI2q_metaCheck",
-			"rowMeta": "_02HI2q_rowMeta",
-			"rowRatio": "_02HI2q_rowRatio",
-			"form": "_02HI2q_form",
-			"cardHead": "_02HI2q_cardHead",
-			"linkLine": "_02HI2q_linkLine",
-			"metaBtn": "_02HI2q_metaBtn",
+			"fact": "_02HI2q_fact",
+			"yScale": "_02HI2q_yScale",
+			"actions": "_02HI2q_actions",
 			"metaField": "_02HI2q_metaField",
-			"search": "_02HI2q_search",
-			"tipGroup": "_02HI2q_tipGroup",
-			"topup": "_02HI2q_topup",
-			"title": "_02HI2q_title",
-			"cardToggle": "_02HI2q_cardToggle",
-			"countPicked": "_02HI2q_countPicked",
-			"factValue": "_02HI2q_factValue",
-			"metaBtnOn": "_02HI2q_metaBtnOn",
+			"plot": "_02HI2q_plot",
+			"metaHead": "_02HI2q_metaHead",
+			"intro": "_02HI2q_intro",
+			"refresh": "_02HI2q_refresh",
+			"hit": "_02HI2q_hit",
+			"series5": "_02HI2q_series5",
+			"countDot": "_02HI2q_countDot",
+			"cardHead": "_02HI2q_cardHead",
 			"select": "_02HI2q_select",
+			"button": "_02HI2q_button",
+			"chevronOpen": "_02HI2q_chevronOpen",
+			"hint": "_02HI2q_hint",
+			"yTick": "_02HI2q_yTick",
+			"metaHint": "_02HI2q_metaHint",
 			"axisLabel": "_02HI2q_axisLabel",
-			"series3": "_02HI2q_series3",
-			"voucherFact": "_02HI2q_voucherFact",
-			"factLabel": "_02HI2q_factLabel",
-			"linkRow": "_02HI2q_linkRow",
+			"topupBar": "_02HI2q_topupBar",
 			"facts": "_02HI2q_facts",
-			"link": "_02HI2q_link",
-			"topupChips": "_02HI2q_topupChips",
+			"row": "_02HI2q_row",
 			"buttonSmall": "_02HI2q_buttonSmall",
-			"rowName": "_02HI2q_rowName",
-			"voucherRow": "_02HI2q_voucherRow",
-			"tipRow": "_02HI2q_tipRow",
-			"tipGroupName": "_02HI2q_tipGroupName",
-			"badge": "_02HI2q_badge",
-			"refresh": "_02HI2q_refresh",
-			"metaIntro": "_02HI2q_metaIntro",
+			"rowRatio": "_02HI2q_rowRatio",
+			"card": "_02HI2q_card",
+			"voucherEmpty": "_02HI2q_voucherEmpty",
+			"gridBase": "_02HI2q_gridBase",
+			"plotPanel": "_02HI2q_plotPanel",
+			"chart": "_02HI2q_chart",
+			"code": "_02HI2q_code",
+			"countPicked": "_02HI2q_countPicked",
+			"swatch": "_02HI2q_swatch",
 			"count": "_02HI2q_count",
-			"metaInput": "_02HI2q_metaInput",
-			"topupInput": "_02HI2q_topupInput",
-			"chevronOpen": "_02HI2q_chevronOpen",
-			"metaActions": "_02HI2q_metaActions",
-			"segment": "_02HI2q_segment",
+			"list": "_02HI2q_list",
+			"autosave": "_02HI2q_autosave",
 			"codeRow": "_02HI2q_codeRow",
-			"segmentOn": "_02HI2q_segmentOn",
-			"yScale": "_02HI2q_yScale",
-			"chevron": "_02HI2q_chevron",
+			"metaBtn": "_02HI2q_metaBtn",
+			"segment": "_02HI2q_segment",
+			"rowMeta": "_02HI2q_rowMeta",
+			"topup": "_02HI2q_topup",
+			"series4": "_02HI2q_series4",
 			"valueRow": "_02HI2q_valueRow",
-			"buttonPrimary": "_02HI2q_buttonPrimary",
-			"topupBar": "_02HI2q_topupBar",
-			"intro": "_02HI2q_intro",
-			"autosave": "_02HI2q_autosave",
-			"tipTitle": "_02HI2q_tipTitle",
-			"countDot": "_02HI2q_countDot",
+			"form": "_02HI2q_form",
+			"axisRow": "_02HI2q_axisRow",
+			"linkRow": "_02HI2q_linkRow",
+			"factValue": "_02HI2q_factValue",
+			"voucherFact": "_02HI2q_voucherFact",
+			"metaEditor": "_02HI2q_metaEditor",
+			"topupChipActive": "_02HI2q_topupChipActive",
+			"rowName": "_02HI2q_rowName",
+			"voucherGroup": "_02HI2q_voucherGroup",
+			"metaActions": "_02HI2q_metaActions",
+			"notice": "_02HI2q_notice",
+			"tip": "_02HI2q_tip",
+			"legend": "_02HI2q_legend",
+			"segmentOn": "_02HI2q_segmentOn",
 			"topupChip": "_02HI2q_topupChip",
-			"metaHint": "_02HI2q_metaHint",
-			"plotPanel": "_02HI2q_plotPanel",
-			"yTick": "_02HI2q_yTick",
-			"plot": "_02HI2q_plot",
 			"gridLine": "_02HI2q_gridLine",
-			"fact": "_02HI2q_fact",
-			"hit": "_02HI2q_hit",
-			"metaEditor": "_02HI2q_metaEditor",
-			"legendItem": "_02HI2q_legendItem",
+			"axis": "_02HI2q_axis",
 			"handle": "_02HI2q_handle",
-			"swatch": "_02HI2q_swatch",
-			"series1": "_02HI2q_series1",
-			"name": "_02HI2q_name",
-			"legendName": "_02HI2q_legendName",
+			"series3": "_02HI2q_series3",
+			"section": "_02HI2q_section",
+			"link": "_02HI2q_link",
 			"series2": "_02HI2q_series2",
-			"invite": "_02HI2q_invite",
+			"tipGroup": "_02HI2q_tipGroup",
+			"series0": "_02HI2q_series0",
+			"label": "_02HI2q_label",
+			"factLabel": "_02HI2q_factLabel",
+			"topupInput": "_02HI2q_topupInput",
+			"search": "_02HI2q_search",
 			"plotRow": "_02HI2q_plotRow",
+			"legendItem": "_02HI2q_legendItem",
+			"buttonPrimary": "_02HI2q_buttonPrimary",
 			"metaTitle": "_02HI2q_metaTitle",
-			"voucherAmount": "_02HI2q_voucherAmount",
-			"axisRow": "_02HI2q_axisRow",
-			"gridBase": "_02HI2q_gridBase",
-			"legend": "_02HI2q_legend",
-			"actions": "_02HI2q_actions",
-			"axis": "_02HI2q_axis",
-			"legendCost": "_02HI2q_legendCost",
+			"topupChips": "_02HI2q_topupChips",
+			"cardToggle": "_02HI2q_cardToggle",
+			"name": "_02HI2q_name",
 			"toolbar": "_02HI2q_toolbar",
-			"topupChipActive": "_02HI2q_topupChipActive",
-			"tip": "_02HI2q_tip",
-			"button": "_02HI2q_button",
-			"section": "_02HI2q_section",
-			"chart": "_02HI2q_chart",
-			"voucherGroup": "_02HI2q_voucherGroup",
-			"code": "_02HI2q_code",
-			"list": "_02HI2q_list",
-			"series4": "_02HI2q_series4",
-			"hint": "_02HI2q_hint",
-			"metaHead": "_02HI2q_metaHead",
+			"invite": "_02HI2q_invite",
+			"voucherList": "_02HI2q_voucherList",
+			"metaInput": "_02HI2q_metaInput",
+			"metaIntro": "_02HI2q_metaIntro",
+			"chevron": "_02HI2q_chevron",
+			"title": "_02HI2q_title",
+			"voucherRow": "_02HI2q_voucherRow",
+			"metaChecks": "_02HI2q_metaChecks",
+			"voucherAmount": "_02HI2q_voucherAmount",
+			"metaCheck": "_02HI2q_metaCheck",
+			"tipGroupName": "_02HI2q_tipGroupName",
 			"segmented": "_02HI2q_segmented",
-			"card": "_02HI2q_card"
+			"tally": "_02HI2q_tally",
+			"legendCost": "_02HI2q_legendCost",
+			"linkLine": "_02HI2q_linkLine",
+			"metaBtnOn": "_02HI2q_metaBtnOn",
+			"series1": "_02HI2q_series1",
+			"tipRow": "_02HI2q_tipRow",
+			"legendName": "_02HI2q_legendName",
+			"metaLabel": "_02HI2q_metaLabel",
+			"badge": "_02HI2q_badge"
 		};
 		//#endregion
 		//#region src/client/NearTokenSection.tsx
@@ -3003,6 +3077,8 @@ window.__ModuleLoader__.load({
 			"menu.model": "模型",
 			"menu.group": "分组",
 			"menu.effort": "推理等级",
+			"link.label": "长连接端点",
+			"link.failed": "端点切换失败：{message}",
 			"effort.providerDefault": "Default",
 			"status.loading": "正在刷新模型列表…",
 			"error.action": "模型操作失败：{message}",
@@ -3140,6 +3216,8 @@ window.__ModuleLoader__.load({
 			"menu.model": "Model",
 			"menu.group": "Group",
 			"menu.effort": "Effort",
+			"link.label": "Long-lived endpoint",
+			"link.failed": "Could not switch the endpoint: {message}",
 			"effort.providerDefault": "Default",
 			"status.loading": "Refreshing model list…",
 			"error.action": "Model operation failed: {message}",
@@ -3316,7 +3394,9 @@ window.__ModuleLoader__.load({
 							load: () => {
 								if (available) directory.load().catch(() => {});
 							},
-							select: (selection) => available ? directory.select(selection) : Promise.resolve(void 0)
+							select: (selection) => available ? directory.select(selection) : Promise.resolve(void 0),
+							readLink: () => api.link(),
+							saveLink: (direct) => api.saveLink(direct)
 						};
 					}
 				}, ModelGroupSelect));