dsh-kylin-media 0.1.1 → 0.2.1

package/README.md

@@ -50,7 +50,8 @@ npm publish          # prepack 会自动跑 smoke
 
 | 项 | 说明 |
 |---|---|
-| 网关地址 | 默认 `http://127.0.0.1:8288`；局域网用 `http://<主机IP>:8288`，frp / 反代填对外地址 |
+| 网关地址 | 默认 `http://127.0.0.1:8288`；局域网用 `http://<主机IP>:8288`，frp / 反代填对外地址。编辑的是「当前线路」的地址 |
+| 连接线路 | 可同时保存多条地址（本机 / 局域网 / frp 公网），点圆点切换当前线路，「测试连接」与所有 `media_*` 都用它；「全部测速」并发探测每条线路并标出最快可用的那条 |
 | 访问 Key | 网关 `API_KEY_MODE=always` 时必填；保存后不再回显明文，留空表示沿用已保存的值 |
 | 单次最多等待 | 工具调用内等待任务的秒数（10-600）；超时不影响网关侧任务，可继续用 `media_job` |
 | 产物目录 | 留空 = `<会话目录>/media-output/<任务 id>/`；也可填绝对路径 |
@@ -61,6 +62,13 @@ npm publish          # prepack 会自动跑 smoke
 
 > 常见坑：网关默认监听明文 HTTP（`API_PORT=8288`）。frp / 反代把 8288 映射出去后仍然是 HTTP，地址要写 `http://<对外地址>:<端口>`；写成 `https://` 会在 TLS 握手阶段被断开，错误信息里会提示「这个端口没有完成 TLS 握手…把地址改成 http:// 再试」。反过来，如果前面套了 nginx / Caddy 的 HTTPS，则必须写 `https://`（自签证书还需要让运行宿主信任该 CA）。
 
+> 为什么「本机 / 局域网」地址连不上：
+> 1. `127.0.0.1` / `localhost` 只有**网关和插件跑在同一台机器**时才通。网关在远端（例如 Windows 主机）而插件在 Mac 上时，本机地址必然被拒绝。
+> 2. 局域网地址要求两者**在同一网段**，且网关监听 `HOST=0.0.0.0`（默认）、系统防火墙放行 8288（仓库里有 `add-firewall-rule.bat`）。可先用 `curl http://<主机IP>:8288/api/health` 验证。
+> 3. 上面两条都不满足时只能用 frp / 公网地址。把三条地址都加进「连接线路」，点「全部测速」即可看出哪条通、哪条最快；失败原因直接写在行内（拒绝连接 / 不可达 / 域名解析失败 / 协议写反）。
+>
+> 局域网里偶发 `EHOSTUNREACH`（刚唤醒、Wi-Fi 切换、ARP 未就绪）不用管：所有 GET 探测都会自动重试最多 2 次；仍失败时先在本机 `curl http://<主机IP>:8288/api/health` 复核。
+
 ## 工具
 
 | 工具 | 作用 |

package/client.js

@@ -38,6 +38,25 @@ window.__ModuleLoader__.load({
       testing: '测试中…',
       clearKey: '清除 Key',
       cleared: '已清除访问 Key',
+      lines: '连接线路',
+      linesHint: '点左侧圆点切换当前线路（测试与工具都用它）；「测速」只查连通性。127.0.0.1 / localhost 只有当网关跑在同一台机器时才通，局域网地址要同网段且防火墙放行端口。',
+      lineAdd: '把当前地址加为线路',
+      lineTest: '测速',
+      linesUnavailable: '当前宿主版本还不支持线路管理：重启宿主（插件 0.2.0）后这里会显示可切换的线路。',
+      lineTestAll: '全部测速',
+      lineTesting: '测速中…',
+      lineFailed: '失败',
+      lineActive: '当前线路',
+      lineSwitch: '切换为当前线路',
+      lineRemove: '删除线路',
+      lineSwitched: '已切换到该线路',
+      lineAdded: '已添加线路',
+      lineRemoved: '已删除线路',
+      lineExists: '这个地址已经在列表里了',
+      lineKeepOne: '至少要保留一条线路',
+      noLineReachable: '所有线路都不通：检查网关是否运行、地址/端口是否正确、防火墙是否放行',
+      localNetworkHint: '（局域网目标全部 EHOSTUNREACH：多为 macOS「本地网络」权限拦截——去 系统设置 → 隐私与安全性 → 本地网络 放行本 App 后重试）',
+      fastestLine: '最快线路：',
       saved: '已保存',
       failed: '操作失败：',
       loadFailed: '配置加载失败，请确认插件已激活后重试。',
@@ -115,6 +134,25 @@ window.__ModuleLoader__.load({
       testing: 'Testing…',
       clearKey: 'Clear key',
       cleared: 'Access key cleared',
+      lines: 'Connection lines',
+      linesHint: 'Click the dot to switch the active line (tests and tools use it). "Test" only checks reachability. 127.0.0.1 / localhost works only when the gateway runs on this machine; a LAN address needs the same subnet and an open firewall port.',
+      lineAdd: 'Add current address as a line',
+      lineTest: 'Test',
+      linesUnavailable: 'This host does not support connection lines yet: restart the host (plugin 0.2.0) to manage and switch lines here.',
+      lineTestAll: 'Test all',
+      lineTesting: 'Testing…',
+      lineFailed: 'failed',
+      lineActive: 'Active line',
+      lineSwitch: 'Switch to this line',
+      lineRemove: 'Remove line',
+      lineSwitched: 'Switched to this line',
+      lineAdded: 'Line added',
+      lineRemoved: 'Line removed',
+      lineExists: 'That address is already in the list',
+      lineKeepOne: 'Keep at least one line',
+      noLineReachable: 'No line is reachable: check the gateway process, address/port and firewall',
+      localNetworkHint: ' (every LAN target returns EHOSTUNREACH: usually macOS Local Network privacy - allow this app in System Settings > Privacy & Security > Local Network, then retry)',
+      fastestLine: 'Fastest line: ',
       saved: 'Saved',
       failed: 'Operation failed: ',
       loadFailed: 'Failed to load settings. Make sure the plugin is active, then retry.',
@@ -213,6 +251,20 @@ window.__ModuleLoader__.load({
         '.km-hint{font-size:11.5px;line-height:1.55;color:var(--dsw-alias-label-tertiary,#8a919c)}',
         '.km-keyrow{display:flex;gap:8px;align-items:stretch}',
         '.km-keyrow input{flex:1;min-width:0}',
+        '.km-lines{display:flex;flex-direction:column;gap:6px;margin-top:8px}',
+        '.km-line{display:flex;align-items:center;gap:10px;border:1px solid var(--dsw-alias-border-l2,rgba(127,127,127,.22));border-radius:var(--dsw-radius-sm,8px);padding:7px 10px;background:var(--dsw-alias-bg-layer-1,transparent);min-width:0}',
+        '.km-line[data-active=true]{border-color:var(--dsw-alias-brand-primary,#4c7dff);background:color-mix(in srgb, var(--dsw-alias-brand-primary,#4c7dff) 9%, transparent)}',
+        '.km-line-radio{appearance:none;flex:none;width:14px;height:14px;padding:0;border-radius:50%;border:1px solid var(--dsw-alias-border-l3,rgba(127,127,127,.45));background:transparent;cursor:pointer;position:relative}',
+        '.km-line-radio[data-active=true]{border-color:var(--dsw-alias-brand-primary,#4c7dff)}',
+        '.km-line-radio[data-active=true]::after{content:"";position:absolute;inset:2px;border-radius:50%;background:var(--dsw-alias-brand-primary,#4c7dff)}',
+        '.km-line-main{flex:1;min-width:0;display:flex;flex-direction:column;gap:1px}',
+        '.km-line-name{font-size:12px;color:var(--dsw-alias-label-primary,#1f2329)}',
+        '.km-line-url{font-family:var(--dsw-font-mono,ui-monospace,SFMono-Regular,Menlo,Consolas,monospace);font-size:11px;color:var(--dsw-alias-label-tertiary,#8a919c);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+        '.km-line-status{flex:none;font-size:11px;color:var(--dsw-alias-label-tertiary,#8a919c);white-space:nowrap}',
+        '.km-line-status[data-state=ok]{color:var(--dsw-alias-state-success-primary,#2f8f5b)}',
+        '.km-line-status[data-state=error]{color:var(--dsw-alias-state-error-primary,#d9534f)}',
+        '.km-line-actions{display:flex;gap:8px;flex-wrap:wrap;margin-top:10px}',
+        '.km-btn-mini{padding:4px 9px;font-size:11.5px;line-height:1.2}',
         '.km-actions{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin-top:18px;padding-top:14px;border-top:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.12))}',
         '.km-btn{appearance:none;display:inline-flex;align-items:center;gap:6px;border:1px solid var(--dsw-alias-border-l2,rgba(127,127,127,.25));background:transparent;color:var(--dsw-alias-label-primary,#1f2329);border-radius:var(--dsw-radius-sm,8px);padding:7px 14px;font:inherit;font-size:13px;line-height:1.2;cursor:pointer;transition:background-color .16s ease,border-color .16s ease,color .16s ease}',
         '.km-btn:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.07));border-color:var(--dsw-alias-border-l3,rgba(127,127,127,.4))}',
@@ -324,6 +376,12 @@ window.__ModuleLoader__.load({
       var modelNoticeHook = React.useState(null);
       var modelNotice = modelNoticeHook[0];
       var setModelNotice = modelNoticeHook[1];
+      var linesHook = React.useState({});
+      var lineResults = linesHook[0];
+      var setLineResults = linesHook[1];
+      var linesBusyHook = React.useState(false);
+      var linesBusy = linesBusyHook[0];
+      var setLinesBusy = linesBusyHook[1];
 
       /* 点选即保存：{ type: modelId }，空串表示回到「自动」。 */
       function selectModel(type, modelId) {
@@ -348,6 +406,155 @@ window.__ModuleLoader__.load({
         });
       }
 
+      function hostOf(url) {
+        try { return new URL(url).host || url; } catch (error) { return url; }
+      }
+
+      function setLineResult(id, value) {
+        setLineResults(function (previous) {
+          var next = Object.assign({}, previous);
+          next[id] = value;
+          return next;
+        });
+      }
+
+      /* 线路相关的接口都会返回最新 publicState：直接落到快照与地址输入框。 */
+      function applyState(state) {
+        setSnapshot({ status: 'ready', data: state, error: null });
+        setDefaults(state.defaultModels || {});
+        setDraft(function (previous) {
+          if (previous === null) {
+            return {
+              baseUrl: state.baseUrl,
+              waitSeconds: String(state.waitSeconds),
+              outputDir: state.outputDir,
+              autoDownload: state.autoDownload
+            };
+          }
+          return Object.assign({}, previous, { baseUrl: state.baseUrl });
+        });
+      }
+
+      function selectEndpoint(id) {
+        if (busy || linesBusy) return;
+        setNotice(null);
+        request('endpoints.select', { id: id }).then(function (payload) {
+          if (!payload.ok) throw new Error(payloadError(payload));
+          applyState(payload.value);
+          setNotice({ kind: 'ok', text: t('lineSwitched') });
+          runTest();
+        }).catch(function (error) {
+          setNotice({ kind: 'error', text: t('failed') + (error && error.message ? error.message : String(error)) });
+        });
+      }
+
+      function probeLine(id) {
+        setLineResult(id, { status: 'loading' });
+        request('endpoints.probe', { id: id }).then(function (payload) {
+          if (!payload.ok) throw new Error(payloadError(payload));
+          var value = payload.value;
+          setLineResult(id, value.reachable
+            ? { status: 'ok', latencyMs: value.latencyMs, message: '' }
+            : { status: 'error', latencyMs: value.latencyMs, message: value.error ? value.error.message : '' });
+        }).catch(function (error) {
+          setLineResult(id, { status: 'error', message: error && error.message ? error.message : String(error) });
+        });
+      }
+
+      function currentLines() {
+        return Array.isArray(data.endpoints) ? data.endpoints : [];
+      }
+
+      function probeAll() {
+        if (linesBusy) return;
+        var lines = currentLines();
+        if (lines.length === 0) return;
+        setLinesBusy(true);
+        setNotice(null);
+        var pending = {};
+        for (var index = 0; index < lines.length; index += 1) pending[lines[index].id] = { status: 'loading' };
+        setLineResults(pending);
+        request('endpoints.probeAll', {}).then(function (payload) {
+          if (!payload.ok) throw new Error(payloadError(payload));
+          var next = {};
+          var best = null;
+          for (var probe = 0; probe < payload.value.results.length; probe += 1) {
+            var result = payload.value.results[probe];
+            next[result.id] = result.reachable
+              ? { status: 'ok', latencyMs: result.latencyMs, message: '' }
+              : { status: 'error', latencyMs: result.latencyMs, message: result.error ? result.error.message : '' };
+            if (result.reachable && (best === null || result.latencyMs < best.latencyMs)) best = result;
+          }
+          setLineResults(next);
+          if (best === null) {
+            var blocked = false;
+            for (var check = 0; check < payload.value.results.length; check += 1) {
+              var failed = payload.value.results[check];
+              if (failed.reachable === false && failed.error && /EHOSTUNREACH/.test(String(failed.error.message))) blocked = true;
+            }
+            setNotice({ kind: 'error', text: t('noLineReachable') + (blocked ? t('localNetworkHint') : '') });
+          } else setNotice({ kind: 'ok', text: t('fastestLine') + best.name + ' · ' + String(best.latencyMs) + 'ms' });
+        }).catch(function (error) {
+          setNotice({ kind: 'error', text: t('failed') + (error && error.message ? error.message : String(error)) });
+        }).then(function () {
+          setLinesBusy(false);
+        });
+      }
+
+      function addLine() {
+        if (linesBusy || draft === null) return;
+        var url = String(draft.baseUrl || '').trim().replace(/\/+$/, '');
+        if (url === '') return;
+        var lines = currentLines();
+        for (var index = 0; index < lines.length; index += 1) {
+          if (lines[index].baseUrl === url) {
+            setNotice({ kind: 'error', text: t('lineExists') });
+            return;
+          }
+        }
+        setLinesBusy(true);
+        setNotice(null);
+        request('settings.update', { patch: { endpoints: lines.concat([{ name: hostOf(url), baseUrl: url }]) } }).then(function (payload) {
+          if (!payload.ok) throw new Error(payloadError(payload));
+          applyState(payload.value);
+          setNotice({ kind: 'ok', text: t('lineAdded') });
+        }).catch(function (error) {
+          setNotice({ kind: 'error', text: t('failed') + (error && error.message ? error.message : String(error)) });
+        }).then(function () {
+          setLinesBusy(false);
+        });
+      }
+
+      function removeLine(id) {
+        if (linesBusy) return;
+        var lines = currentLines();
+        var kept = [];
+        var removedActive = false;
+        for (var index = 0; index < lines.length; index += 1) {
+          if (lines[index].id === id) {
+            removedActive = lines[index].id === data.activeEndpointId;
+            continue;
+          }
+          kept.push(lines[index]);
+        }
+        if (kept.length === 0) {
+          setNotice({ kind: 'error', text: t('lineKeepOne') });
+          return;
+        }
+        setLinesBusy(true);
+        setNotice(null);
+        request('settings.update', { patch: { endpoints: kept } }).then(function (payload) {
+          if (!payload.ok) throw new Error(payloadError(payload));
+          applyState(payload.value);
+          setNotice({ kind: 'ok', text: t('lineRemoved') });
+          if (removedActive) runTest();
+        }).catch(function (error) {
+          setNotice({ kind: 'error', text: t('failed') + (error && error.message ? error.message : String(error)) });
+        }).then(function () {
+          setLinesBusy(false);
+        });
+      }
+
       function runTest() {
         setTest({ status: 'loading', data: null, error: null });
         request('test', {}).then(function (payload) {
@@ -461,6 +668,7 @@ window.__ModuleLoader__.load({
         }
       }
 
+      var endpoints = Array.isArray(data.endpoints) ? data.endpoints : null;
       var connectionCard = React.createElement('section', { className: 'km-card' },
         React.createElement('div', { className: 'km-card-head' },
           React.createElement('h3', null, t('connection')),
@@ -496,7 +704,61 @@ window.__ModuleLoader__.load({
                 onClick: clearKey,
                 disabled: busy
               }, t('clearKey')) : null),
-            React.createElement('span', { className: 'km-hint' }, t('keyHint')))),
+            React.createElement('span', { className: 'km-hint' }, t('keyHint'))),
+          React.createElement('div', { className: 'km-field km-span2' },
+            React.createElement('label', null, t('lines')),
+            React.createElement('span', { className: 'km-hint' }, t('linesHint')),
+            endpoints === null ? React.createElement('span', { className: 'km-hint' }, t('linesUnavailable')) : null,
+            React.createElement('div', { className: 'km-lines' },
+              (endpoints || []).map(function (endpoint) {
+                var active = endpoint.id === data.activeEndpointId;
+                var result = lineResults[endpoint.id] || { status: 'idle' };
+                var statusText = result.status === 'loading' ? t('lineTesting')
+                  : result.status === 'ok' ? String(result.latencyMs) + 'ms'
+                    : result.status === 'error' ? t('lineFailed') : t('idle');
+                return React.createElement('div', {
+                  key: endpoint.id,
+                  className: 'km-line',
+                  'data-active': active ? 'true' : 'false'
+                },
+                  React.createElement('button', {
+                    type: 'button',
+                    className: 'km-line-radio',
+                    'data-active': active ? 'true' : 'false',
+                    title: active ? t('lineActive') : t('lineSwitch'),
+                    onClick: function () { selectEndpoint(endpoint.id); }
+                  }),
+                  React.createElement('div', { className: 'km-line-main' },
+                    React.createElement('div', { className: 'km-line-name' }, endpoint.name),
+                    React.createElement('div', { className: 'km-line-url' }, endpoint.baseUrl)),
+                  React.createElement('span', { className: 'km-line-status', 'data-state': result.status, title: result.message || '' }, statusText),
+                  React.createElement('button', {
+                    type: 'button',
+                    className: 'km-btn km-btn-mini',
+                    onClick: function () { probeLine(endpoint.id); },
+                    disabled: result.status === 'loading'
+                  }, t('lineTest')),
+                  React.createElement('button', {
+                    type: 'button',
+                    className: 'km-btn km-btn-mini km-btn-danger',
+                    onClick: function () { removeLine(endpoint.id); },
+                    disabled: linesBusy || endpoints === null || endpoints.length <= 1,
+                    title: t('lineRemove')
+                  }, '×'));
+              })),
+            React.createElement('div', { className: 'km-line-actions' },
+              React.createElement('button', {
+                type: 'button',
+                className: 'km-btn km-btn-mini',
+                onClick: addLine,
+                disabled: linesBusy
+              }, t('lineAdd')),
+              React.createElement('button', {
+                type: 'button',
+                className: 'km-btn km-btn-mini',
+                onClick: probeAll,
+                disabled: linesBusy
+              }, linesBusy ? t('testing') : t('lineTestAll'))))),
 
         React.createElement('div', { className: 'km-actions' },
           React.createElement('button', {

package/entry.js

@@ -17,7 +17,7 @@ import { createTools } from './lib/tools.js'
 
 export const name = 'dsh-kylin-media'
 export const inject = ['tools', 'webServer']
-export const VERSION = '0.1.1'
+export const VERSION = '0.2.1'
 
 const ROOT = dirname(fileURLToPath(import.meta.url))
 const SKILLS_DIR = join(ROOT, 'skills')

package/lib/gateway.js

@@ -95,6 +95,30 @@ function looksLikeSchemeMismatch(detail) {
   return /EPROTO|ERR_SSL|wrong version number|unexpected eof|SSL routines|ssl3_|packet length too long|record layer|secure TLS connection|TLS connection/i.test(detail)
 }
 
+function isLoopbackBase(base) {
+  try {
+    const host = new URL(base).hostname.toLowerCase().replace(/^\[|\]$/g, '')
+    return host === '127.0.0.1' || host === 'localhost' || host === '::1'
+  } catch {
+    return false
+  }
+}
+
+/** 连不上时按原因给动作：协议写反 / 本机没服务 / 不可达 / 解析失败。 */
+function reachabilityHint(base, detail) {
+  if (looksLikeSchemeMismatch(detail)) return schemeHint(base, detail)
+  if (/ECONNREFUSED/i.test(detail)) {
+    if (isLoopbackBase(base)) return '。本机这个端口没有服务在监听：网关跑在另一台机器上时，请填那台机器的局域网地址或 frp 公网地址'
+    return '。目标拒绝连接：确认网关进程在运行、端口正确，并已放行防火墙'
+  }
+  if (/ENOTFOUND|EAI_AGAIN|getaddrinfo/i.test(detail)) return '。域名解析失败：检查地址拼写或 DNS'
+  if (/EHOSTUNREACH|ENETUNREACH/i.test(detail)) {
+    return '。链路层没通：目标在同一局域网时，先在 macOS「系统设置 → 隐私与安全性 → 本地网络」放行本 App（被拦时就是 EHOSTUNREACH）；其次看网关主机是否休眠、刚切过 Wi-Fi 或 ARP 未就绪，隔几秒重试。可在终端 curl ' + base + '/api/health 复核'
+  }
+  if (/ETIMEDOUT|timed out|timeout/i.test(detail)) return '。SYN 没响应：多半是防火墙丢包（Windows 入站规则要放行该端口），或两台机器不在同一网段'
+  return ''
+}
+
 /** 把 https/http 写反是最常见的「连不上」：TLS 握手失败时直接给出改法。 */
 function schemeHint(base, detail) {
   if (!looksLikeSchemeMismatch(detail)) return ''
@@ -122,41 +146,59 @@ export function createGateway(settings) {
     return headers
   }
 
+  /** 刚唤醒 / Wi-Fi 切换 / ARP 未就绪时的瞬时失败，重试就能过去。 */
+  function isTransient(detail) {
+    return /EHOSTUNREACH|ENETUNREACH|ECONNRESET|EPIPE|EAI_AGAIN|socket hang up/i.test(detail)
+  }
+
   async function request(path, options) {
     const opts = options === undefined ? {} : options
+    const method = opts.method || 'GET'
     const timeoutMs = opts.timeoutMs === undefined ? defaultTimeout : opts.timeoutMs
-    const combined = combineSignal(opts.signal, timeoutMs)
-    try {
-      const response = await fetch(base + path, {
-        method: opts.method || 'GET',
-        headers: opts.headers || authHeaders({}),
-        body: opts.body,
-        signal: combined.signal
-      })
-      const text = await response.text()
-      let payload = null
-      if (text !== '') {
-        try {
-          payload = JSON.parse(text)
-        } catch {
-          payload = null
+    // 只重试幂等的 GET/HEAD；POST 可能已经在网关侧建了任务，绝不重放。
+    const attempts = method === 'GET' || method === 'HEAD' ? 3 : 1
+    let lastError = null
+    for (let attempt = 1; attempt <= attempts; attempt += 1) {
+      const combined = combineSignal(opts.signal, timeoutMs)
+      try {
+        const response = await fetch(base + path, {
+          method,
+          headers: opts.headers || authHeaders({}),
+          body: opts.body,
+          signal: combined.signal
+        })
+        const text = await response.text()
+        let payload = null
+        if (text !== '') {
+          try {
+            payload = JSON.parse(text)
+          } catch {
+            payload = null
+          }
         }
+        if (!response.ok || (isRecord(payload) && payload['ok'] === false)) {
+          throw failForStatus(response.status, payload, text)
+        }
+        return payload
+      } catch (error) {
+        if (error instanceof GatewayError) throw error
+        if (opts.signal !== undefined && opts.signal !== null && opts.signal.aborted) throw error
+        if (combined.timedOut()) {
+          throw new GatewayError('timeout', '请求网关超时（' + String(timeoutMs) + 'ms）：' + base + reachabilityHint(base, 'ETIMEDOUT'), 0, null)
+        }
+        const detail = describeCause(error)
+        const retryNote = attempt < attempts && isTransient(detail) ? '' : (attempts > 1 && isTransient(detail) ? '（已自动重试 ' + String(attempts - 1) + ' 次）' : '')
+        lastError = new GatewayError('gateway-unreachable', '无法连接网关 ' + base + '：' + detail + reachabilityHint(base, detail) + retryNote, 0, null)
+        if (attempt < attempts && isTransient(detail)) {
+          await new Promise(function (resolve) { setTimeout(resolve, 250 * attempt) })
+          continue
+        }
+        throw lastError
+      } finally {
+        combined.close()
       }
-      if (!response.ok || (isRecord(payload) && payload['ok'] === false)) {
-        throw failForStatus(response.status, payload, text)
-      }
-      return payload
-    } catch (error) {
-      if (error instanceof GatewayError) throw error
-      if (opts.signal !== undefined && opts.signal !== null && opts.signal.aborted) throw error
-      if (combined.timedOut()) {
-        throw new GatewayError('timeout', '请求网关超时（' + String(timeoutMs) + 'ms）：' + base, 0, null)
-      }
-      const detail = describeCause(error)
-      throw new GatewayError('gateway-unreachable', '无法连接网关 ' + base + '：' + detail + schemeHint(base, detail), 0, null)
-    } finally {
-      combined.close()
     }
+    throw lastError
   }
 
   async function health() {

package/lib/routes.js

@@ -6,6 +6,7 @@
  */
 import { createGateway } from './gateway.js'
 import { summarizeModels } from './catalog.js'
+import { hostLabel, isHttpBaseUrl } from './store.js'
 
 export const PLUGIN_NAME = 'dsh-kylin-media'
 export const API_PREFIX = '/dsh-kylin-media/api'
@@ -99,6 +100,63 @@ async function testConnection(store, signal) {
   }
 }
 
+/** 只探连通性（health，8 秒超时），用于线路列表的逐条测速：快，不拉能力目录。 */
+async function probeEndpoint(store, baseUrl, signal) {
+  const settings = store.settings()
+  const gateway = createGateway({ ...settings, baseUrl })
+  const started = Date.now()
+  try {
+    const health = await gateway.health()
+    const comfy = health !== null && typeof health === 'object' && health['comfy'] !== null && typeof health['comfy'] === 'object' ? health['comfy'] : null
+    const auth = health !== null && typeof health === 'object' && health['auth'] !== null && typeof health['auth'] === 'object' ? health['auth'] : null
+    return {
+      reachable: true,
+      latencyMs: Date.now() - started,
+      gateway: {
+        version: health !== null && typeof health === 'object' ? health['version'] ?? null : null,
+        authMode: auth === null ? null : auth['mode'] ?? null
+      },
+      comfy: {
+        reachable: comfy !== null && comfy['reachable'] === true,
+        upstreams: comfy !== null && Array.isArray(comfy['upstreams']) ? comfy['upstreams'].length : 0
+      },
+      error: null
+    }
+  } catch (error) {
+    return {
+      reachable: false,
+      latencyMs: Date.now() - started,
+      gateway: null,
+      comfy: null,
+      error: {
+        code: error !== null && typeof error === 'object' && typeof error.code === 'string' ? error.code : 'gateway-unreachable',
+        message: errorText(error)
+      }
+    }
+  }
+}
+
+function findEndpoint(state, id) {
+  return state.endpoints.find(function (endpoint) { return endpoint.id === id })
+}
+
+/** 解析探测目标：显式 baseUrl > 指定 id > 当前线路。 */
+function resolveProbeTarget(store, payload) {
+  const state = store.publicState()
+  const rawUrl = typeof payload['baseUrl'] === 'string' ? payload['baseUrl'].trim().replace(/\/+$/, '') : ''
+  const id = typeof payload['id'] === 'string' ? payload['id'].trim() : ''
+  if (rawUrl !== '') {
+    if (!isHttpBaseUrl(rawUrl)) return { error: 'invalid-base-url' }
+    return { target: { id: id === '' ? 'probe' : id, name: hostLabel(rawUrl), baseUrl: rawUrl } }
+  }
+  if (id !== '') {
+    const endpoint = findEndpoint(state, id)
+    return endpoint === undefined ? { error: 'unknown-endpoint' } : { target: endpoint }
+  }
+  const active = findEndpoint(state, state.activeEndpointId)
+  return active === undefined ? { error: 'unknown-endpoint' } : { target: active }
+}
+
 /** 纯函数路由：不碰 req/res，便于单测直接调用。 */
 export async function handleRequest(store, request, body) {
   if (!isLoopbackHost(request.headers)) {
@@ -113,7 +171,7 @@ export async function handleRequest(store, request, body) {
   if (!pathname.startsWith(API_PREFIX)) return undefined
   const action = pathname.slice(API_PREFIX.length).replace(/^\/+/, '')
   if (method === 'GET' && action === 'state') {
-    return { status: 200, payload: { ok: true, value: { ...store.publicState(), name: PLUGIN_NAME, version: '0.1.1' } } }
+    return { status: 200, payload: { ok: true, value: { ...store.publicState(), name: PLUGIN_NAME, version: '0.2.1' } } }
   }
   if (method !== 'POST') {
     return { status: 405, payload: errorPayload('method-not-allowed', '写操作必须使用 POST') }
@@ -136,6 +194,35 @@ export async function handleRequest(store, request, body) {
   if (action === 'test') {
     return { status: 200, payload: { ok: true, value: await testConnection(store, request.signal) } }
   }
+  if (action === 'endpoints.select') {
+    const id = typeof payload['id'] === 'string' ? payload['id'].trim() : ''
+    const state = store.publicState()
+    if (id === '' || findEndpoint(state, id) === undefined) {
+      return { status: 404, payload: errorPayload('unknown-endpoint', '没有这条连接线路：' + id) }
+    }
+    const result = store.update({ activeEndpointId: id })
+    if (!result.ok) return { status: 400, payload: errorPayload('invalid-settings', result.errors.join('; ')) }
+    return { status: 200, payload: { ok: true, value: result.state } }
+  }
+  if (action === 'endpoints.probe') {
+    const resolved = resolveProbeTarget(store, payload)
+    if (resolved.error !== undefined) {
+      return resolved.error === 'unknown-endpoint'
+        ? { status: 404, payload: errorPayload('unknown-endpoint', '没有这条连接线路') }
+        : { status: 400, payload: errorPayload('invalid-base-url', '探测地址必须是 http(s) 地址') }
+    }
+    const target = resolved.target
+    const probe = await probeEndpoint(store, target.baseUrl, request.signal)
+    return { status: 200, payload: { ok: true, value: { id: target.id, name: target.name, baseUrl: target.baseUrl, ...probe } } }
+  }
+  if (action === 'endpoints.probeAll') {
+    const state = store.publicState()
+    const results = await Promise.all(state.endpoints.map(async function (endpoint) {
+      const probe = await probeEndpoint(store, endpoint.baseUrl, request.signal)
+      return { id: endpoint.id, name: endpoint.name, baseUrl: endpoint.baseUrl, ...probe }
+    }))
+    return { status: 200, payload: { ok: true, value: { results } } }
+  }
   return { status: 404, payload: errorPayload('not-found', '未知操作 ' + action) }
 }
 

package/lib/store.js

@@ -22,9 +22,15 @@ export const DEFAULT_SETTINGS = {
   requestTimeoutMs: 30000,
   autoDownload: true,
   outputDir: '',
-  defaultModels: {}
+  defaultModels: {},
+  endpoints: [],
+  activeEndpointId: ''
 }
 
+export const MAX_ENDPOINTS = 10
+/** 线路 id：小写字母/数字/短横线，最长 32，便于在 URL、日志里稳定引用。 */
+const ENDPOINT_ID = /^[a-z0-9][a-z0-9-]{0,31}$/
+
 /** 能力类型键：与网关能力目录的 type 同形，避免把任意字段写进设置。 */
 const TYPE_KEY = /^[a-z][a-z0-9_]{0,31}$/
 const MAX_MODEL_ID_LENGTH = 200
@@ -81,6 +87,47 @@ export function normalizeDefaultModels(input) {
   return map
 }
 
+/** 从地址取一个人类可读的线路名（host:port）。 */
+export function hostLabel(url) {
+  try {
+    return new URL(url).host || String(url)
+  } catch {
+    return String(url)
+  }
+}
+
+/** 只保留合法、去重后的线路；一条都没有时用 fallbackUrl 建一条。 */
+function normalizeEndpoints(raw, fallbackUrl) {
+  const list = Array.isArray(raw) ? raw : []
+  const endpoints = []
+  const ids = new Set()
+  const urls = new Set()
+  for (const item of list) {
+    if (endpoints.length >= MAX_ENDPOINTS) break
+    if (!isRecord(item)) continue
+    const value = typeof item['baseUrl'] === 'string' ? item['baseUrl'].trim().replace(/\/+$/, '') : ''
+    if (!isHttpBaseUrl(value) || urls.has(value)) continue
+    let id = typeof item['id'] === 'string' ? item['id'].trim() : ''
+    if (!ENDPOINT_ID.test(id) || ids.has(id)) id = ''
+    if (id === '') {
+      let index = endpoints.length + 1
+      id = 'ep' + String(index)
+      while (ids.has(id)) {
+        index += 1
+        id = 'ep' + String(index)
+      }
+    }
+    const name = readString(item['name'], '', 40)
+    endpoints.push({ id, name: name === '' ? hostLabel(value) : name, baseUrl: value })
+    ids.add(id)
+    urls.add(value)
+  }
+  if (endpoints.length === 0) {
+    endpoints.push({ id: 'default', name: hostLabel(fallbackUrl), baseUrl: fallbackUrl })
+  }
+  return endpoints
+}
+
 function clampInt(value, min, max, fallback) {
   const parsed = typeof value === 'number' ? value : Number(value)
   if (!Number.isFinite(parsed)) return fallback
@@ -95,8 +142,15 @@ export function normalizeSettings(input) {
   const key = typeof raw['apiKey'] === 'string'
     ? raw['apiKey'].replace(/[\r\n]/g, '').trim().slice(0, MAX_SECRET_LENGTH)
     : ''
+  const endpoints = normalizeEndpoints(raw['endpoints'], baseUrl)
+  let activeEndpointId = typeof raw['activeEndpointId'] === 'string' ? raw['activeEndpointId'].trim() : ''
+  if (!endpoints.some(function (endpoint) { return endpoint.id === activeEndpointId })) activeEndpointId = endpoints[0].id
+  const activeEndpoint = endpoints.find(function (endpoint) { return endpoint.id === activeEndpointId })
   return {
-    baseUrl,
+    // baseUrl 始终等于当前线路：工具、路由、客户端只认这一个地址。
+    baseUrl: activeEndpoint === undefined ? baseUrl : activeEndpoint.baseUrl,
+    endpoints,
+    activeEndpointId,
     apiKey: key,
     waitSeconds: clampInt(raw['waitSeconds'], 10, 600, DEFAULT_SETTINGS.waitSeconds),
     pollIntervalMs: clampInt(raw['pollIntervalMs'], 500, 10000, DEFAULT_SETTINGS.pollIntervalMs),
@@ -167,6 +221,65 @@ export function validatePatch(input) {
       }
     }
   }
+  if (input['endpoints'] !== undefined) {
+    if (!Array.isArray(input['endpoints'])) {
+      errors.push('endpoints 必须是数组')
+    } else if (input['endpoints'].length === 0) {
+      errors.push('至少保留一条连接线路')
+    } else if (input['endpoints'].length > MAX_ENDPOINTS) {
+      errors.push('最多 ' + String(MAX_ENDPOINTS) + ' 条连接线路')
+    } else {
+      const list = []
+      const ids = new Set()
+      const urls = new Set()
+      for (const item of input['endpoints']) {
+        if (!isRecord(item)) {
+          errors.push('连接线路必须是对象')
+          continue
+        }
+        const url = typeof item['baseUrl'] === 'string' ? item['baseUrl'].trim().replace(/\/+$/, '') : ''
+        if (!isHttpBaseUrl(url)) {
+          errors.push('连接线路地址必须是 http(s)：' + String(item['baseUrl']))
+          continue
+        }
+        if (urls.has(url)) {
+          errors.push('连接线路重复：' + url)
+          continue
+        }
+        let id = typeof item['id'] === 'string' ? item['id'].trim() : ''
+        if (id !== '' && !ENDPOINT_ID.test(id)) {
+          errors.push('连接线路 id 非法：' + id)
+          continue
+        }
+        if (id !== '' && ids.has(id)) {
+          errors.push('连接线路 id 重复：' + id)
+          continue
+        }
+        if (id === '') {
+          let index = list.length + 1
+          id = 'ep' + String(index)
+          while (ids.has(id)) {
+            index += 1
+            id = 'ep' + String(index)
+          }
+        }
+        const name = typeof item['name'] === 'string' ? item['name'].trim().slice(0, 40) : ''
+        list.push({ id, name: name === '' ? hostLabel(url) : name, baseUrl: url })
+        ids.add(id)
+        urls.add(url)
+      }
+      if (list.length > 0) patch.endpoints = list
+    }
+  }
+  if (input['activeEndpointId'] !== undefined) {
+    if (typeof input['activeEndpointId'] !== 'string') {
+      errors.push('activeEndpointId 必须是字符串')
+    } else {
+      const active = input['activeEndpointId'].trim()
+      if (active.length > 32) errors.push('activeEndpointId 过长')
+      else patch.activeEndpointId = active
+    }
+  }
   if (input['outputDir'] !== undefined) {
     if (typeof input['outputDir'] !== 'string') {
       errors.push('outputDir 必须是字符串')
@@ -222,7 +335,11 @@ export class MediaStore {
 
   /** 完整设置（含明文 Key）：只允许宿主内部使用。 */
   settings() {
-    return { ...this.data, defaultModels: { ...this.data.defaultModels } }
+    return {
+      ...this.data,
+      defaultModels: { ...this.data.defaultModels },
+      endpoints: this.data.endpoints.map(function (endpoint) { return { ...endpoint } })
+    }
   }
 
   /** 供客户端 / 路由使用：永远不带明文 Key。 */
@@ -236,14 +353,24 @@ export class MediaStore {
       requestTimeoutMs: this.data.requestTimeoutMs,
       autoDownload: this.data.autoDownload,
       outputDir: this.data.outputDir,
-      defaultModels: { ...this.data.defaultModels }
+      defaultModels: { ...this.data.defaultModels },
+      endpoints: this.data.endpoints.map(function (endpoint) { return { ...endpoint } }),
+      activeEndpointId: this.data.activeEndpointId
     }
   }
 
   update(patch) {
     const result = validatePatch(patch)
     if (result.errors.length > 0) return { ok: false, errors: result.errors }
-    this.data = normalizeSettings({ ...this.data, ...result.patch })
+    const merged = { ...this.data, ...result.patch }
+    // 只改 baseUrl 时改的是「当前线路」的地址，不新建线路；整表提交时以提交的为准。
+    if (result.patch.baseUrl !== undefined && result.patch.endpoints === undefined) {
+      const activeId = this.data.activeEndpointId
+      merged.endpoints = this.data.endpoints.map(function (endpoint) {
+        return endpoint.id === activeId ? { ...endpoint, baseUrl: result.patch.baseUrl } : endpoint
+      })
+    }
+    this.data = normalizeSettings(merged)
     this.save()
     return { ok: true, state: this.publicState() }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-kylin-media",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "麒麟（QiLin）/ DSH 多媒体网关插件：连接本地 comfyui-gateway，在会话里出图、出视频、出音乐、对口型，并做语音转写、合成与分离。",
   "keywords": [
     "deepseek-harness",

package/scripts/client-test.mjs

@@ -64,8 +64,14 @@ const STATE = {
   autoDownload: true,
   outputDir: '',
   defaultModels: { text2image: 'qwen-image-2.1-lite' },
+  baseUrl: 'http://125.64.108.97:54157',
+  endpoints: [
+    { id: 'local', name: '127.0.0.1:8288', baseUrl: 'http://127.0.0.1:8288' },
+    { id: 'public', name: '125.64.108.97:54157', baseUrl: 'http://125.64.108.97:54157' }
+  ],
+  activeEndpointId: 'public',
   name: 'dsh-kylin-media',
-  version: '0.1.1'
+  version: '0.2.0'
 }
 const CATALOG = {
   types: [
@@ -103,11 +109,67 @@ const TEST_PAYLOAD = {
 }
 
 function respond(action, options) {
-  calls.push({ action, method: options === undefined || options.method === undefined ? 'GET' : options.method, body: options === undefined || options.body === undefined ? null : JSON.parse(options.body) })
+  const body = options === undefined || options.body === undefined ? null : JSON.parse(options.body)
+  calls.push({ action, method: options === undefined || options.method === undefined ? 'GET' : options.method, body: body })
   let payload
   if (action === 'state') payload = { ok: true, value: STATE }
   else if (action === 'test') payload = { ok: true, value: TEST_PAYLOAD }
-  else if (action === 'settings.update') payload = { ok: true, value: STATE }
+  else if (action === 'settings.update') {
+    const patch = body !== null && body.patch !== undefined ? body.patch : {}
+    if (Array.isArray(patch.endpoints)) {
+      STATE.endpoints = patch.endpoints
+      if (!STATE.endpoints.some(function (line) { return line.id === STATE.activeEndpointId })) {
+        STATE.activeEndpointId = STATE.endpoints[0].id
+        STATE.baseUrl = STATE.endpoints[0].baseUrl
+      }
+    }
+    if (typeof patch.baseUrl === 'string') {
+      STATE.baseUrl = patch.baseUrl
+      STATE.endpoints = STATE.endpoints.map(function (line) {
+        return line.id === STATE.activeEndpointId ? Object.assign({}, line, { baseUrl: patch.baseUrl }) : line
+      })
+    }
+    if (patch.defaultModels !== undefined) STATE.defaultModels = patch.defaultModels
+    payload = { ok: true, value: STATE }
+  }
+  else if (action === 'endpoints.select') {
+    const line = STATE.endpoints.find(function (item) { return item.id === (body === null ? '' : body.id) })
+    if (line === undefined) payload = { ok: false, error: { code: 'unknown-endpoint', message: '没有这条连接线路' } }
+    else {
+      STATE.activeEndpointId = line.id
+      STATE.baseUrl = line.baseUrl
+      payload = { ok: true, value: STATE }
+    }
+  }
+  else if (action === 'endpoints.probe') {
+    const line = STATE.endpoints.find(function (item) { return item.id === (body === null ? '' : body.id) }) || STATE.endpoints[0]
+    const reachable = line.id !== 'local'
+    payload = { ok: true, value: {
+      id: line.id,
+      name: line.name,
+      baseUrl: line.baseUrl,
+      reachable: reachable,
+      latencyMs: reachable ? 21 : 3,
+      gateway: reachable ? { version: '0.3.0', authMode: 'always' } : null,
+      comfy: reachable ? { reachable: true, upstreams: 2 } : null,
+      error: reachable ? null : { code: 'connection-refused', message: '本机没有服务监听' }
+    } }
+  }
+  else if (action === 'endpoints.probeAll') {
+    payload = { ok: true, value: { results: STATE.endpoints.map(function (line) {
+      const reachable = line.id !== 'local'
+      return {
+        id: line.id,
+        name: line.name,
+        baseUrl: line.baseUrl,
+        reachable: reachable,
+        latencyMs: reachable ? 18 : 3,
+        gateway: reachable ? { version: '0.3.0', authMode: 'always' } : null,
+        comfy: reachable ? { reachable: true, upstreams: 2 } : null,
+        error: reachable ? null : { code: 'gateway-unreachable', message: '无法连接网关：EHOSTUNREACH connect EHOSTUNREACH' }
+      }
+    }) } }
+  }
   else if (action === 'key.clear') payload = { ok: true, value: STATE }
   else payload = { ok: false, error: { code: 'not-found', message: 'unexpected ' + action } }
   return Promise.resolve({ status: 200, json: function () { return Promise.resolve(payload) } })
@@ -236,6 +298,72 @@ const clearedUpdate = calls.filter(function (call) { return call.action === 'set
 check(clearedUpdate !== undefined && clearedUpdate.body.patch.defaultModels !== undefined, 'auto row posts a defaultModels patch')
 check(clearedUpdate !== undefined && clearedUpdate.body.patch.defaultModels.text2image === undefined, 'auto row clears the type default')
 
+/* ---------- 连接线路 ---------- */
+const lineRows = findAll(render(), function (node) {
+  return typeof node.props.className === 'string' && /(^|\s)km-line(\s|$)/.test(node.props.className)
+})
+check(lineRows.length === 2, 'two connection lines are rendered')
+const activeRows = lineRows.filter(function (row) { return row.props['data-active'] === 'true' })
+check(activeRows.length === 1 && textOf(activeRows[0]).includes('125.64.108.97:54157'), 'the stored active line is marked')
+
+const localRow = lineRows.find(function (row) { return textOf(row).includes('127.0.0.1:8288') })
+const localRadio = findAll(localRow, function (node) { return node.props.className === 'km-line-radio' })[0]
+check(localRadio !== undefined, 'each line has a radio switch')
+localRadio.props.onClick()
+await settle()
+const selectCall = calls.filter(function (call) { return call.action === 'endpoints.select' }).pop()
+check(selectCall !== undefined && selectCall.body.id === 'local', 'switching a line posts endpoints.select')
+
+const probeAllButton = findAll(render(), function (node) { return node.type === 'button' && textOf(node) === 'lineTestAll' })[0]
+check(probeAllButton !== undefined, 'test-all button exists')
+probeAllButton.props.onClick()
+await settle()
+const probeAllCall = calls.filter(function (call) { return call.action === 'endpoints.probeAll' }).pop()
+check(probeAllCall !== undefined, 'test all posts endpoints.probeAll')
+const statuses = findAll(render(), function (node) {
+  return typeof node.props.className === 'string' && node.props.className.indexOf('km-line-status') >= 0
+}).map(textOf)
+check(statuses.indexOf('18ms') >= 0 && statuses.indexOf('lineFailed') >= 0, 'test all renders per-line latency and failure')
+// 全部线路都 EHOSTUNREACH 时给出 macOS 本地网络权限提示
+const savedLineList = STATE.endpoints
+STATE.endpoints = [{ id: 'local', name: '127.0.0.1:8288', baseUrl: 'http://127.0.0.1:8288' }]
+const onlyLocalButton = findAll(render(), function (node) { return node.type === 'button' && textOf(node) === 'lineTestAll' })[0]
+onlyLocalButton.props.onClick()
+await settle()
+check(textOf(render()).includes('localNetworkHint'), 'all-EHOSTUNREACH lines surface the macOS local-network hint')
+STATE.endpoints = savedLineList
+
+const urlInput = findAll(render(), function (node) { return node.props.id === 'km-base-url' })[0]
+urlInput.props.onChange({ target: { value: 'http://192.168.1.5:8288' } })
+await settle()
+const addButton = findAll(render(), function (node) { return node.type === 'button' && textOf(node) === 'lineAdd' })[0]
+addButton.props.onClick()
+await settle()
+const addCall = calls.filter(function (call) { return call.action === 'settings.update' }).pop()
+check(addCall !== undefined && addCall.body.patch.endpoints.length === 3, 'adding the current address appends a line')
+check(addCall !== undefined && addCall.body.patch.endpoints[2].baseUrl === 'http://192.168.1.5:8288', 'the new line keeps the typed address')
+
+const lanRow = findAll(render(), function (node) {
+  return typeof node.props.className === 'string' && /(^|\s)km-line(\s|$)/.test(node.props.className) && textOf(node).includes('192.168.1.5:8288')
+})[0]
+check(lanRow !== undefined, 'the new line is rendered after saving')
+const removeButton = findAll(lanRow, function (node) { return node.type === 'button' && textOf(node) === '×' })[0]
+removeButton.props.onClick()
+await settle()
+const removeCall = calls.filter(function (call) { return call.action === 'settings.update' }).pop()
+check(removeCall !== undefined && removeCall.body.patch.endpoints.length === 2, 'removing a line posts the remaining lines')
+
+/* ---------- 旧宿主（state 不带 endpoints）不崩、给出重启提示 ---------- */
+const savedEndpoints = STATE.endpoints
+const savedActive = STATE.activeEndpointId
+delete STATE.endpoints
+delete STATE.activeEndpointId
+const legacyTree = render()
+check(textOf(legacyTree).includes('linesUnavailable'), 'old host state renders the restart hint instead of crashing')
+check(findAll(legacyTree, function (node) { return typeof node.props.className === 'string' && /(^|\s)km-line(\s|$)/.test(node.props.className) }).length === 0, 'old host state renders no line rows')
+STATE.endpoints = savedEndpoints
+STATE.activeEndpointId = savedActive
+
 if (failures > 0) {
   console.error('client-test: ' + String(failures) + ' failure(s)')
   process.exit(1)

package/scripts/selftest.mjs

@@ -130,6 +130,45 @@ await new Promise(function (resolve) { server.listen(0, '127.0.0.1', resolve) })
 const port = server.address().port
 const baseUrl = 'http://127.0.0.1:' + String(port)
 
+// GET 自动重试：瞬时 EHOSTUNREACH（刚唤醒 / ARP 未就绪）重试后应成功；一直失败时给出已重试次数
+const { createGateway } = await import(new URL('../lib/gateway.js', import.meta.url))
+function hostUnreachable() {
+  const error = new TypeError('fetch failed')
+  const cause = new Error('connect EHOSTUNREACH 192.168.1.71:8288')
+  cause.code = 'EHOSTUNREACH'
+  error.cause = cause
+  return error
+}
+const originalFetch = globalThis.fetch
+let flakyCalls = 0
+globalThis.fetch = async function (url, init) {
+  flakyCalls += 1
+  if (flakyCalls === 1) throw hostUnreachable()
+  return originalFetch(url, init)
+}
+try {
+  const flakyHealth = await createGateway({ baseUrl, apiKey: KEY, requestTimeoutMs: 5000 }).health()
+  check(flakyHealth.version === '0.3.0', 'a transient EHOSTUNREACH is retried and then succeeds')
+} finally {
+  globalThis.fetch = originalFetch
+}
+check(flakyCalls === 2, 'the transient GET was retried exactly once')
+
+let downCalls = 0
+globalThis.fetch = async function () {
+  downCalls += 1
+  throw hostUnreachable()
+}
+try {
+  await createGateway({ baseUrl, apiKey: KEY, requestTimeoutMs: 5000 }).health()
+  check(false, 'a permanently unreachable gateway should fail')
+} catch (error) {
+  check(error.message.includes('已自动重试 2 次'), 'exhausted retries are reported in the message')
+} finally {
+  globalThis.fetch = originalFetch
+}
+check(downCalls === 3, 'a GET is attempted three times before failing')
+
 const store = new MediaStore(HOME)
 let result = store.update({ baseUrl, waitSeconds: 10, pollIntervalMs: 500, requestTimeoutMs: 5000, autoDownload: true })
 check(result.ok, 'store.update accepts valid settings')
@@ -180,6 +219,7 @@ check(forbidden.status === 403, 'non-loopback Host is rejected with 403')
 const stateResponse = await callRoute({ url: '/dsh-kylin-media/api/state' })
 check(stateResponse.status === 200, 'GET state is 200')
 check(stateResponse.body.ok === true && stateResponse.body.value.hasKey === true, 'state reports key configured')
+check(Array.isArray(stateResponse.body.value.endpoints) && stateResponse.body.value.endpoints.length === 1, 'state exposes the default connection line')
 check(JSON.stringify(stateResponse.body).includes(KEY) === false, 'state response never contains plaintext key')
 const badBase = await callRoute({ method: 'POST', url: '/dsh-kylin-media/api/settings.update', body: { patch: { baseUrl: 'ftp://nope' } } })
 check(badBase.status === 400, 'invalid base URL is rejected with 400')
@@ -196,6 +236,47 @@ check(testResponse.status === 200 && testResponse.body.value.reachable === true,
 check(testResponse.body.value.catalog.types.length >= 1, 'test action returns a catalogue')
 check(testResponse.body.value.catalog.types[0].models[0].id === 'mock-image', 'test payload lists concrete models')
 
+// 连接线路：多地址保存、切换、探测（都用 mock 网关；备用线走不存在的路径，快速返回 404）
+const linesUpdate = await callRoute({ method: 'POST', url: '/dsh-kylin-media/api/settings.update', body: { patch: {
+  endpoints: [
+    { id: 'primary', name: '主线路', baseUrl },
+    { id: 'secondary', name: '备用线路', baseUrl: baseUrl + '/backup' },
+    { id: 'public', name: '公网', baseUrl: baseUrl + '/public' }
+  ],
+  activeEndpointId: 'public'
+} } })
+check(linesUpdate.status === 200, 'settings.update accepts connection lines')
+check(linesUpdate.body.value.endpoints.length === 3, 'three connection lines are stored')
+check(linesUpdate.body.value.activeEndpointId === 'public' && linesUpdate.body.value.baseUrl === baseUrl + '/public', 'the active line drives baseUrl')
+
+const switchLine = await callRoute({ method: 'POST', url: '/dsh-kylin-media/api/endpoints.select', body: { id: 'primary' } })
+check(switchLine.status === 200 && switchLine.body.value.activeEndpointId === 'primary', 'endpoints.select switches the active line')
+check(switchLine.body.value.baseUrl === baseUrl, 'switching restores that line address')
+const unknownLine = await callRoute({ method: 'POST', url: '/dsh-kylin-media/api/endpoints.select', body: { id: 'nope' } })
+check(unknownLine.status === 404, 'unknown line is 404')
+
+const probeOne = await callRoute({ method: 'POST', url: '/dsh-kylin-media/api/endpoints.probe', body: { id: 'primary' } })
+check(probeOne.status === 200 && probeOne.body.value.reachable === true, 'endpoints.probe reaches the mock gateway')
+check(probeOne.body.value.gateway.version === '0.3.0', 'probe reports the gateway version')
+const probeBad = await callRoute({ method: 'POST', url: '/dsh-kylin-media/api/endpoints.probe', body: { baseUrl: 'ftp://nope' } })
+check(probeBad.status === 400, 'endpoints.probe rejects a non-http address')
+
+const probeAll = await callRoute({ method: 'POST', url: '/dsh-kylin-media/api/endpoints.probeAll', body: {} })
+check(probeAll.status === 200 && probeAll.body.value.results.length === 3, 'endpoints.probeAll probes every line')
+const probeById = {}
+for (const item of probeAll.body.value.results) probeById[item.id] = item
+check(probeById.primary.reachable === true, 'probeAll marks the reachable line')
+check(probeById.secondary.reachable === false && typeof probeById.secondary.error.message === 'string', 'probeAll reports the unreachable line with a reason')
+
+const duplicateLines = restarted.update({ endpoints: [{ id: 'a', baseUrl }, { id: 'b', baseUrl }] })
+check(duplicateLines.ok === false, 'duplicate line addresses are rejected')
+const invalidLine = restarted.update({ endpoints: [{ id: 'x', baseUrl: 'ftp://nope' }] })
+check(invalidLine.ok === false, 'non-http line addresses are rejected')
+
+// 还原成单线路，后面的工具用例继续打 mock 根地址
+const restoredLine = restarted.update({ endpoints: [{ id: 'default', name: 'mock', baseUrl }], activeEndpointId: 'default' })
+check(restoredLine.ok && restoredLine.state.baseUrl === baseUrl, 'restoring a single line resets baseUrl')
+
 const tools = createTools({ store: restarted, workingDirectory: { get: function () { return OUTPUT } } })
 const byName = {}
 for (const definition of tools) byName[definition.name] = definition

package/scripts/smoke.mjs

@@ -61,6 +61,8 @@ check(!/request\('[^']+'\)/.test(client), 'client always POSTs write actions (no
 check(client.includes("query('state')"), 'client reads state through the GET query helper')
 check(client.includes('defaultModels'), 'client persists per-type default models')
 check(client.includes('km-model-radio'), 'client renders selectable model rows')
+check(client.includes("request('endpoints.select'"), 'client switches connection lines')
+check(client.includes('km-line-radio'), 'client renders line switches')
 
 const entryModule = await import(new URL('../entry.js', import.meta.url))
 check(entryModule.name === PACKAGE, 'entry name matches package')

package/skills/kylin-media/SKILL.md

@@ -16,7 +16,7 @@ description: 调用本地 comfyui-gateway 的多媒体能力（文生图/改图/
 
 | type | 用途 | 典型模型 | 必填 params |
 |---|---|---|---|
-| text2image | 文生图 | zimage-turbo、qwen-image-2.1 | prompt |
+| text2image | 文生图 | zimage-turbo、qwen-image-2.1-lite | prompt |
 | image_edit | 参考图改图 | qwen-image-edit-2509 | prompt、image |
 | text2video | 文生视频 | minimax-h3-t2v | prompt |
 | image2video | 图生视频 / 首尾帧 / 多参考 | minimax-h3-fl2va、-flf2v、-multiref、wan2.2-ti2v-5b | prompt、image |
@@ -42,3 +42,4 @@ description: 调用本地 comfyui-gateway 的多媒体能力（文生图/改图/
 - 长任务（视频、音乐、分离）优先异步：media_generate wait=false 拿到 id，再用 media_job 轮询，避免一次工具调用长时间占用。
 - 参数名必须来自 paramSchema，未知字段会被网关 400 拒绝；参数校验失败会回传 details。
 - 不要向用户回显访问 Key；插件界面只显示脱敏串。
+- 连不上先看地址形态：127.0.0.1 只对同机网关有效，局域网要求同网段且防火墙放行；用户在「设置 → 多媒体网关 → 连接线路」里保存多条地址并切换，media_* 一律走当前线路。