@yanglaofish/dsh-proxy-pro 1.0.8 → 1.0.9

package/lib/client.js

@@ -322,7 +322,9 @@ window.__ModuleLoader__.load({
         if (!fallback) return { text: "未知", tone: "warn" };
         if (fallback.verdict === "usable") return { text: "链路通 · 目标正常响应", tone: "ok" };
         if (fallback.verdict === "degraded") return { text: "链路通 · 这次请求被目标拒绝", tone: "warn" };
-        if (fallback.verdict === "unusable") return { text: "链路不通 · 网络/代理问题", tone: "bad" };
+        // 5xx：拿到了 HTTP 应答，链路通但服务端/网关报错（严重性误导修复：不算"链路不通"）
+        if (fallback.kind === "gateway" || fallback.kind === "server-error") return { text: "链路通 · 目标/网关报错", tone: "warn" };
+        if (fallback.unusable === true || fallback.verdict === "unusable") return { text: "链路不通 · 网络/代理问题", tone: "bad" };
         return fallback.ok ? { text: "链路通", tone: "ok" } : { text: "链路不通", tone: "bad" };
       }
 

package/lib/proxy-core.js

@@ -417,10 +417,43 @@ export function classifyTargetFailure(error) {
     fix: '对比直连/代理两侧并重试；用 proxy_status 查看生效路由。' }
 }
 
+/**
+ * 单侧通道的徽章：按真实语义给色，杜绝"严重性误导"（LESSONS §32）。
+ * - usable（2xx/3xx/401）→ 🟢 链路通 · 目标正常响应
+ * - degraded（403/404/405/429 等被目标拒绝）→ 🟡 链路通 · 目标拒绝（…）
+ * - 5xx（500/502/503/504 拿到应答但目标/网关报错）→ 🟡 链路通 · 目标/网关报错（…）
+ * - 407 认证拦截 → 🔴 链路不通 · 代理要求认证
+ * - 其他不可达（DNS/拒绝/超时/本地错误）→ 🔴 链路不通 · …
+ * 关键区分：**只要拿到了 HTTP 应答（含 4xx/5xx）链路就是通的**，只有
+ * 连接层失败（未拿到应答）才是"链路不通"。404 曾因 ok=false 被误标红色
+ * 链路不通 → 截图"代理与直连均失败"误导（2026-09-18 用户实况）。
+ */
+function dualBadge(probe) {
+  const detail = (s) => String(s ?? '').replace(/^HTTP \d+ — /, '')
+  if (!probe) return { text: '结果未知', tone: 'warn' }
+  if (probe.verdict === 'usable') return { text: '链路通 · 目标正常响应', tone: 'ok' }
+  if (probe.verdict === 'degraded') {
+    return { text: `链路通 · 目标拒绝（${detail(probe.short) || '请求被拒'}）`, tone: 'warn' }
+  }
+  if (probe.kind === 'gateway' || probe.kind === 'server-error') {
+    return { text: `链路通 · 目标/网关报错（${detail(probe.short) || String(probe.status ?? '5xx')}）`, tone: 'warn' }
+  }
+  if (probe.kind === 'auth') return { text: '链路不通 · 代理要求认证', tone: 'bad' }
+  return { text: `链路不通 · ${detail(probe.short) || '连接失败'}`, tone: 'bad' }
+}
+
 /**
  * 双通道综合判定：把「强制走代理」与「强制直连」两次探测合成为一份可给人
  * 看的结果：两条徽章（各自带 tone 色）+ 一条推荐。
  *
+ * 三个概念分离（LESSONS §32 严重性误导修复）：
+ * - 可达（reachable）：通道真正拿到了目标应答——usable 或 degraded（4xx）。
+ *   5xx 属"链路通但目标/网关报错"（kind=gateway/server-error），不算可达
+ *   也不算不通，徽章黄色；407/连接层失败才是"不通"。
+ * - 健康（healthy）：usbale，目标给了正常应答。
+ * - 徽章：由 dualBadge 按实际 verdict/kind 生成，绝不把 404/403 标红。
+ *   只有连接层失败才标红"链路不通"。
+ *
  * 单侧探针拿不到应答者身份，因此「代理策略拦截」只能靠两侧对比得到方向性
  * 结论（LESSONS §30：直连通+代理失败 → 问题在代理一侧；代理通+直连失败 →
  * 代理是唯一通路；都失败 → 环境/服务端问题；都通 → 保持现状）。
@@ -431,18 +464,22 @@ export function classifyTargetFailure(error) {
  *   badge = { text, tone: 'ok'|'warn'|'bad' }。
  */
 export function combineDualProbe(proxyProbe, directProbe) {
-  const proxyOk = proxyProbe?.ok === true
-  const directOk = directProbe?.ok === true
-  const proxyAuth = proxyProbe?.kind === 'auth'
-    || (proxyProbe?.verdict === 'unusable' && /NTLM|407/.test(String(proxyProbe?.short ?? '')))
+  const p = proxyProbe ?? {}
+  const d = directProbe ?? {}
+  const pReach = p.verdict === 'usable' || p.verdict === 'degraded'
+  const dReach = d.verdict === 'usable' || d.verdict === 'degraded'
+  const pOk = p.verdict === 'usable'
+  const dOk = d.verdict === 'usable'
+  const proxyAuth = p.kind === 'auth'
+    || (p.verdict === 'unusable' && /NTLM|407/.test(String(p.short ?? '')))
 
   const notReachable = (probe, label) => {
     const detail = (probe?.short ?? '未知原因').replace(/^HTTP \d+ — /, '')
     return `${label}：${detail}`
   }
 
-  // 都通 → 都可以
-  if (proxyOk && directOk) {
+  // ① 都健康 → 都可以（保持现状）
+  if (pOk && dOk) {
     return {
       verdict: 'both-ok',
       short: '代理与直连均通',
@@ -453,45 +490,98 @@ export function combineDualProbe(proxyProbe, directProbe) {
     }
   }
 
-  // 只有代理通 → 走代理
-  if (proxyOk && !directOk) {
+  // ② 只有代理健康 → 走代理
+  if (pOk && !dOk) {
     return {
       verdict: 'proxy-only',
       short: '只有走代理能通',
-      why: `直连 ${notReachable(directProbe, '失败')}；走代理正常——该目标在当前网络需经代理访问。`,
+      why: `直连 ${notReachable(d, '失败')}；走代理正常——该目标在当前网络需经代理访问。`,
       fix: '确认该域名不在 NO_PROXY 直连名单里；保持代理开启。',
       proxyBadge: { text: '链路通 · 目标正常响应', tone: 'ok' },
-      directBadge: { text: '链路不通 · 直连失败', tone: 'bad' },
+      directBadge: dualBadge(d),
     }
   }
 
-  // 只有直连通 → 问题在代理一侧（可能是策略拦截/认证/代理故障）
-  if (!proxyOk && directOk) {
+  // ③ 只有直连健康 → 问题在代理一侧（认证拦截 / 不可达 / 被目标拒绝）
+  if (!pOk && dOk) {
+    const pSide = proxyAuth
+      ? '代理要求 NTLM 认证（407），请求没到目标'
+      : p.verdict === 'degraded'
+        ? '经代理已到达目标，但目标拒绝了这次请求（403/404/429 等）'
+        : '经代理未能连接目标（可能是代理策略拦截、代理故障或链路异常）'
     const base = proxyAuth
       ? {
           why: '代理要求 NTLM 认证（407），而直连正常——该目标不值得绕代理。',
           fix: '该域名走代理会被认证卡住：把它加入 NO_PROXY 直连名单即可；无需打开认证窗口。',
         }
       : {
-          why: '经代理失败而直连正常——问题最可能在代理一侧：访问策略拦截、代理故障，或代理到目标之间的链路异常。',
-          fix: '先重试排除临时故障；仍失败则检查代理可用性或联系管理员。若确认是策略拦截，把该域名加入 NO_PROXY 直连名单。',
+          why: `${pSide}；而直连正常——结论：该域名走直连更可靠。`,
+          fix: p.verdict === 'degraded'
+            ? '把该域名加入 NO_PROXY 直连名单即可绕开代理侧的目标拒绝；若确需走代理，检查 key/UA/权限。'
+            : '先重试排除临时故障；仍失败则检查代理可用性或联系管理员。若确认是策略拦截，把该域名加入 NO_PROXY 直连名单。',
         }
     return {
       verdict: proxyAuth ? 'direct-only-auth' : 'direct-only',
-      short: proxyAuth ? '直连可通 · 代理需认证' : '直连可通 · 代理被拦',
+      short: proxyAuth ? '直连可通 · 代理需认证' : (p.verdict === 'degraded' ? '直连可通 · 代理侧被目标拒绝' : '直连可通 · 代理被拦'),
       ...base,
-      proxyBadge: { text: proxyAuth ? '链路不通 · 代理要求认证' : '链路不通 · 经代理访问失败', tone: 'bad' },
+      proxyBadge: dualBadge(p),
       directBadge: { text: '链路通 · 目标正常响应', tone: 'ok' },
     }
   }
 
-  // 都失败 → 环境/服务端问题
+  // ④ 都不健康但都可达（双 4xx：链路通，目标对探测路径有异常应答）
+  if (pReach && dReach) {
+    const pNote = notReachable(p, '代理').replace(/^失败：/, '代理：')
+    const dNote = notReachable(d, '直连').replace(/^失败：/, '直连：')
+    return {
+      verdict: 'both-reached',
+      short: '双链路通 · 目标应答异常',
+      why: `两条通道都到达了目标，但目标返回异常状态：${pNote}；${dNote}。`,
+      fix: '探测的是根路径/裸前缀，目标可能对 HEAD 或未授权请求如此应答——改用真实调用端点（如 /models、/chat/completions）复测，或检查该主机的 API Key。',
+      proxyBadge: dualBadge(p),
+      directBadge: dualBadge(d),
+    }
+  }
+
+  // ⑤ 只有代理可达（哪怕 404/403，也是唯一通路）——修复重点：
+  //    404 不再落入"双失败"，恢复为代理是唯一通路（腾讯 Copilot 实况）
+  if (pReach && !dReach) {
+    const pNote = p.verdict === 'usable' ? '正常响应' : notReachable(p, '请求被拒').replace(/^请求被拒：/, '')
+    return {
+      verdict: 'proxy-only',
+      short: p.verdict === 'usable' ? '只有走代理能通' : '只有走代理可达 · 目标有异常应答',
+      why: `直连 ${notReachable(d, '失败')}；经代理 ${pNote}——该域名在当前网络只有代理通道能到达目标。`,
+      fix: p.verdict === 'usable'
+        ? '确认该域名不在 NO_PROXY 直连名单里；保持代理开启。'
+        : '走代理链路是通的，但目标返回异常（尝试换真实端点复测）；同时确认该域名不在 NO_PROXY 直连名单里。',
+      proxyBadge: dualBadge(p),
+      directBadge: dualBadge(d),
+    }
+  }
+
+  // ⑥ 只有直连可达（代理侧 4xx/5xx 或不可达）
+  if (dReach) {
+    return {
+      verdict: proxyAuth ? 'direct-only-auth' : 'direct-only',
+      short: proxyAuth ? '直连可达 · 代理需认证' : (d.verdict === 'usable' ? '直连可通 · 代理被拦' : '直连可达 · 代理侧异常'),
+      why: proxyAuth
+        ? '代理要求 NTLM 认证（407），而直连正常——该目标不值得绕代理。'
+        : `经代理 ${p.kind === 'gateway' || p.kind === 'server-error' ? '返回网关/服务端错误（链路本身通，问题在目标或中间网关）' : `失败（${notReachable(p, '').replace(/^：/, '')}）`}；直连 ${dOk ? '正常' : notReachable(d, '可达但目标异常')}。`,
+      fix: proxyAuth
+        ? '把该域名加入 NO_PROXY 直连名单即可。'
+        : '建议该域名走直连（加入 NO_PROXY）；若代理侧是 4xx/5xx，也检查一下真实调用端点。',
+      proxyBadge: dualBadge(p),
+      directBadge: dualBadge(d),
+    }
+  }
+
+  // ⑦ 都不可达（连接层失败）→ 环境/服务端问题
   return {
     verdict: 'both-bad',
     short: '代理与直连均失败',
-    why: `两条通道都没拿到正常应答：代理 ${notReachable(proxyProbe, '失败')}；直连 ${notReachable(directProbe, '失败')}。`,
+    why: `两条通道都没能建立到目标的连接：代理 ${notReachable(p, '失败')}；直连 ${notReachable(d, '失败')}。`,
     fix: '是环境或服务端问题，与代理开关无关：检查网络/目标服务，或稍后重试。',
-    proxyBadge: { text: `链路不通 · ${notReachable(proxyProbe, '代理失败')}`, tone: 'bad' },
-    directBadge: { text: `链路不通 · ${notReachable(directProbe, '直连失败')}`, tone: 'bad' },
+    proxyBadge: dualBadge(p),
+    directBadge: dualBadge(d),
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yanglaofish/dsh-proxy-pro",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "DSH proxy manager: route model requests, web fetches and spawned tools through the Windows system proxy or a custom address; per-URL route diagnosis, one-click toggle from the conversation header, a dedicated Settings page, and keepalive-aware 407 hints.",
   "type": "module",
   "main": "./lib/index.js",