codebee 0.1.49 → 0.1.51

package/app/core/preview.py

@@ -0,0 +1,293 @@
+# -*- coding: utf-8 -*-
+"""运行预览：把任务工作目录里的网页成品挂成「可实时查看」的页面。
+
+借鉴对话式编程产品（右栏「运行 / index.html / style.css / script.js」页签）：
+代码任务跑完，用户要的不是翻文件，而是**直接看到东西跑起来**。这里提供两件事：
+
+1. list_app(run_id)：从本任务的成品文件里挑出可预览的应用——入口 HTML +
+   同目录的代码文件（按 html→css→js 排序），供前端渲染页签条。
+2. serve(run_id, rel)：只读挂载工作目录里的静态资源，供 iframe / 新窗口直接
+   打开（<img>/<link>/<script> 这些子资源请求带不了自定义请求头）。
+
+**访问令牌走路径段**（/preview/<run>/<令牌>/<文件>）：子资源是浏览器按文档
+URL 相对解析的，查询串不会被继承——令牌只能放路径里才覆盖得到 style.css /
+script.js。鉴权本身直接复用 remote.request_authed（与 /api/* 同一把尺子，
+含反向代理下"带转发头的 loopback 算远程"的判断），所以本地免令牌、公网必须
+带令牌，两条路都不需要新写一套判断。
+
+安全边界（这是把一个任意目录交给浏览器渲染，必须写清楚）：
+- 只认静态扩展名白名单，单文件体积上限；路径 resolve 后必须落在工作目录内。
+- 工作目录下的服务端可执行物（.py/.php/.rb/.sh…）不在白名单，不会被预览。
+- HTML 响应注入 <base>（相对资源在子路径下也解析得对）+ 一段极小的补丁：
+  页面里的 fetch/XHR 指向 /api/ 时自动补上访问令牌，让「对话生成的示例应用」
+  能真的连通后端。补丁只加一个请求头；写接口该 423/401 的照旧。
+- 前端把预览 iframe 挂在同一来源下、不加 sandbox：预览要**像真的在跑**——生成的
+  示例应用大量用 localStorage，sandbox 去掉 same-origin 会让它当场抛 SecurityError，
+  而 allow-same-origin 的 sandbox 等于没加（页面可自行摘掉）。这与本地 dev server
+  的信任模型一致：跑的是你自己的代码、在你自己的机器上。代价是预览页能读到
+  本会话的 localStorage 令牌，故「预览」页签只在用户主动点开时才加载（不预跑）。
+"""
+from __future__ import annotations
+
+import json
+import re
+from pathlib import Path
+
+from . import store
+
+# 静态资源白名单：只挂能安全交给浏览器渲染的扩展名。刻意不含 .py/.php/.rb/.sh
+# 等工作目录里可能出现的服务端可执行物——预览是只读静态托管，不是网站服务器。
+PREVIEW_EXT = {
+    ".html", ".htm", ".css", ".js", ".mjs", ".cjs", ".json", ".map",
+    ".svg", ".png", ".jpg", ".jpeg", ".gif", ".webp", ".bmp", ".ico", ".avif",
+    ".woff", ".woff2", ".ttf", ".otf", ".eot",
+    ".mp3", ".wav", ".ogg", ".mp4", ".webm",
+    ".txt", ".md", ".csv", ".xml", ".wasm", ".yml", ".yaml", ".toml",
+}
+
+# 页签条里列出的扩展名（比可挂载范围窄）：图片/字体是资源不是「文件」，
+# 给它们开页签只是噪音。
+TAB_EXT = {".html", ".htm", ".css", ".js", ".mjs", ".cjs", ".json", ".svg",
+           ".txt", ".md", ".csv", ".xml", ".yml", ".yaml", ".toml", ".map"}
+
+_HTML_EXT = {".html", ".htm"}
+
+# 页签排序权重：入口 → 样式 → 脚本 → 数据 → 其它
+_TAB_ORDER = {".html": 0, ".htm": 0, ".css": 1, ".js": 2, ".mjs": 2, ".cjs": 2,
+              ".json": 3, ".map": 4, ".svg": 5, ".md": 6, ".txt": 6, ".csv": 6,
+              ".xml": 6, ".yml": 6, ".yaml": 6, ".toml": 6}
+
+BASE = "/preview"           # 路由前缀，与 main.py 的 do_GET 分发约定
+MAX_FILE = 4 << 20          # 单文件上限：超过不挂（大文件走「成果」页签下载）
+MAX_TABS = 12               # 页签上限：防病态目录撑爆页签条
+MAX_LIST = 400              # 参与挑选的成品文件上限
+
+_MIME = {
+    ".html": "text/html; charset=utf-8", ".htm": "text/html; charset=utf-8",
+    ".css": "text/css; charset=utf-8", ".js": "text/javascript; charset=utf-8",
+    ".mjs": "text/javascript; charset=utf-8", ".cjs": "text/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8", ".map": "application/json; charset=utf-8",
+    ".svg": "image/svg+xml", ".png": "image/png", ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg", ".gif": "image/gif", ".webp": "image/webp",
+    ".bmp": "image/bmp", ".ico": "image/x-icon", ".avif": "image/avif",
+    ".woff": "font/woff", ".woff2": "font/woff2", ".ttf": "font/ttf",
+    ".otf": "font/otf", ".eot": "application/vnd.ms-fontobject",
+    ".mp3": "audio/mpeg", ".wav": "audio/wav", ".ogg": "audio/ogg",
+    ".mp4": "video/mp4", ".webm": "video/webm",
+    ".txt": "text/plain; charset=utf-8", ".md": "text/plain; charset=utf-8",
+    ".csv": "text/plain; charset=utf-8", ".xml": "text/xml; charset=utf-8",
+    ".wasm": "application/wasm",
+    ".yml": "text/plain; charset=utf-8", ".yaml": "text/plain; charset=utf-8",
+    ".toml": "text/plain; charset=utf-8",
+}
+
+_TXT = {".html", ".htm", ".css", ".js", ".mjs", ".cjs", ".json", ".map", ".svg",
+        ".txt", ".md", ".csv", ".xml", ".yml", ".yaml", ".toml"}
+
+_HEAD_RE = re.compile(r"<head\b[^>]*>", re.I)
+_HTML_RE = re.compile(r"<html\b[^>]*>", re.I)
+
+
+def _ext(name):
+    return Path(str(name or "")).suffix.lower()
+
+
+def safe_rel(rel):
+    """归一化工作目录内相对路径。返回 None 表示越界/非法。"""
+    rel = str(rel or "").replace("\\", "/").lstrip("/")
+    if not rel:
+        return None
+    parts = [p for p in rel.split("/") if p not in ("", ".")]
+    if not parts or any(p == ".." for p in parts):
+        return None
+    # 隐藏目录（.git/.zcode/.claude…）是工具过程文件，不是成品，一律不给挂
+    if any(p.startswith(".") for p in parts):
+        return None
+    return "/".join(parts)
+
+
+def resolve(run_id, rel):
+    """把 rel 解析到运行工作目录内的真实文件。返回 (Path|None, 错误文本)。
+
+    与 store.read_run_file 同一道守卫：resolve 之后必须仍在工作目录内，
+    顺带挡掉软链接指向工作目录之外的形态。
+    """
+    wd = store.run_workdir(run_id)
+    if not wd:
+        return None, "该运行没有关联的工作目录"
+    safe = safe_rel(rel)
+    if not safe:
+        return None, "非法路径"
+    if _ext(safe) not in PREVIEW_EXT:
+        return None, "该类型不支持预览"
+    root = Path(wd).resolve()
+    try:
+        p = (root / safe).resolve()
+    except OSError:
+        return None, "非法路径"
+    if root != p and root not in p.parents:
+        return None, "非法路径"
+    if not p.is_file():
+        return None, "文件不存在"
+    return p, None
+
+
+def _base_href(run_id, tok, rel):
+    """入口 HTML 的 <base>：挂在 /preview/<run>/<令牌>/<入口目录>/ 上。
+
+    令牌放在路径里是为了让 style.css / ./js/a.js / ../x.css 这些相对子资源
+    自动继承它（查询串不会被子资源继承）；这个绝对路径也让相对资源在
+    子目录入口（web/index.html）下解析得对。
+    """
+    d = rel.rsplit("/", 1)[0] if "/" in rel else ""
+    return "%s/%s/%s/%s" % (BASE, run_id, tok, (d + "/") if d else "")
+
+
+def _patch_token(tok):
+    """注入页面脚本：预览页里的 fetch/XHR 打 /api/ 时自动补访问令牌。
+
+    生成的示例应用常直接 fetch("/api/...")，而子资源与脚本发起的请求带不了
+    自定义请求头——不补的话预览里一切接口调用都 401，用户会以为是自己代码写
+    错了。补丁只加一个请求头；写接口该 423/401 的照旧，不放行任何服务端能力。
+    """
+    tk = json.dumps(str(tok or ""))
+    return (
+        "<script>(function(){var TK=%s;if(!TK)return;try{"
+        "var isApi=function(u){u=String(u||'');return u.indexOf('/api/')===0"
+        "||u.indexOf('api/')===0;};"
+        "var _f=window.fetch;if(_f){window.fetch=function(i,o){o=o||{};"
+        "var u=(typeof i==='string')?i:((i&&i.url)||'');"
+        "if(isApi(u)){try{o.headers=new Headers(o.headers||{});"
+        "o.headers.set('X-CodeBee-Token',TK);}catch(e){}}"
+        "return _f.call(this,i,o);};}"
+        "var _o=XMLHttpRequest.prototype.open;"
+        "XMLHttpRequest.prototype.open=function(m,u){"
+        "this.__cbApi=isApi(u);return _o.apply(this,arguments);};"
+        "var _s=XMLHttpRequest.prototype.send;"
+        "XMLHttpRequest.prototype.send=function(b){"
+        "if(this.__cbApi){try{this.setRequestHeader('X-CodeBee-Token',TK);}"
+        "catch(e){}}return _s.apply(this,arguments);};"
+        "}catch(e){}})();</script>" % tk
+    )
+
+
+def _inject(html, run_id, tok, rel):
+    """把 <base> + 令牌补丁插到入口 HTML 的最前面（head 内最优先）。"""
+    inject = ('<base href="%s">' % _base_href(run_id, tok, rel)) + _patch_token(tok)
+    m = _HEAD_RE.search(html)
+    if m:
+        return html[:m.end()] + inject + html[m.end():]
+    m = _HTML_RE.search(html)
+    if m:
+        return html[:m.end()] + inject + html[m.end():]
+    return inject + html
+
+
+def _decode(data):
+    for enc in ("utf-8", "gbk"):
+        try:
+            return data.decode(enc)
+        except UnicodeDecodeError:
+            continue
+    return data.decode("utf-8", "replace")
+
+
+def serve(run_id, rel, tok=""):
+    """读取一个预览资源。返回 (bytes|None, content-type, 错误文本)。"""
+    p, err = resolve(run_id, rel)
+    if err:
+        return None, "", err
+    try:
+        if p.stat().st_size > MAX_FILE:
+            return None, "", "文件过大，不支持预览"
+        data = p.read_bytes()
+    except OSError as e:
+        return None, "", "读取失败: %s" % e
+    ext = p.suffix.lower()
+    ctype = _MIME.get(ext, "application/octet-stream")
+    if ext in _HTML_EXT:
+        # 入口页：注入 <base> 与令牌补丁，并按 UTF-8 重编码（非 UTF-8 落 GBK
+        # 回退——子代理在中文 Windows 上常把文件写成 GBK）
+        data = _inject(_decode(data), run_id, tok, rel).encode("utf-8")
+    elif ext in _TXT:
+        data = _decode(data).encode("utf-8")
+    return data, ctype, None
+
+
+def _pick_entry(avail):
+    """挑入口 HTML：优先工作目录根的 index.html，其次最浅、最新。
+
+    先只看根目录（单页应用的标准形态），根目录没有 HTML 时才退到最浅的子目录
+    入口——`web/index.html` 这类布局也该能预览。
+    """
+    htmls = [f for f in avail if _ext(f["name"]) in _HTML_EXT]
+    if not htmls:
+        return ""
+    roots = [f for f in htmls if "/" not in f["name"]]
+    cands = roots or htmls
+    best = None
+    for f in cands:
+        name = f["name"]
+        base = name.rsplit("/", 1)[-1].lower()
+        key = (0 if base in ("index.html", "index.htm") else 1,
+               name.count("/"), -int(f.get("mtime") or 0), name)
+        if best is None or key < best[0]:
+            best = (key, name)
+    return best[1] if best else ""
+
+
+def _tab_key(f):
+    name = f["name"]
+    return (_TAB_ORDER.get(_ext(name), 9), name.count("/"),
+            -int(f.get("mtime") or 0), name)
+
+
+def preview_path(run_id, tok):
+    """预览根路径（带路径令牌）：前端据此拼 iframe src 与新窗口地址。
+
+    令牌为空时落「-」占位段：远程开着时它会自然 401，本机（remote 未配令牌
+    或 loopback 豁免）照常放行——路径里永远有一段，前端不用做两种拼接。
+    """
+    return "%s/%s/%s/" % (BASE, run_id, tok or "-")
+
+
+def list_app(run_id, tok=""):
+    """本任务可预览的网页应用。返回前端渲染页签条所需的全部信息。
+
+    {"ok": False, "reason": "no_run"|"no_workdir"|"no_steps"|"no_html"} 表示没有
+    可预览的东西（前端据此把「预览」页签整体隐藏，不打扰非前端任务）。
+    """
+    if not store.get_run(run_id):
+        return {"ok": False, "reason": "no_run"}
+    wd, files = store.run_artifacts(run_id, limit=MAX_LIST)
+    if not wd or not Path(wd).is_dir():
+        return {"ok": False, "reason": "no_workdir"}
+    # 与「成果」同一口径：一步没跑出来过的任务没有成品可言（历次都在检出等
+    # 前置环节失败时，工作目录里的变动是并行活动的噪音）
+    run = store.get_run(run_id) or {}
+    if not store.task_step_count(run.get("task_id") or ""):
+        return {"ok": False, "reason": "no_steps"}
+    avail = [f for f in (files or [])
+             if _ext(f["name"]) in PREVIEW_EXT
+             and int(f.get("size") or 0) <= MAX_FILE]
+    entry = _pick_entry(avail)
+    if not entry:
+        return {"ok": False, "reason": "no_html", "workdir": wd}
+    edir = entry.rsplit("/", 1)[0] if "/" in entry else ""
+    tabs = [f for f in avail
+            if _ext(f["name"]) in TAB_EXT
+            and (f["name"].rsplit("/", 1)[0] if "/" in f["name"] else "") == edir]
+    tabs.sort(key=_tab_key)
+    names, seen = [], set()
+    for f in tabs:
+        if f["name"] in seen:
+            continue
+        seen.add(f["name"])
+        names.append(f["name"])
+        if len(names) >= MAX_TABS:
+            break
+    # 入口一定在，且一定排第一（页签条第一格就是"这个应用"，运行视图另占一格）
+    names = [entry] + [n for n in names if n != entry]
+    return {"ok": True, "entry": entry, "workdir": wd,
+            "base": preview_path(run_id, tok),
+            "files": [{"name": n, "ext": _ext(n).lstrip(".")} for n in names]}

package/app/core/router.py

@@ -1,15 +1,18 @@
-# -*- coding: utf-8 -*-
-"""智能路由：能力基线 × 历史胜率 × 角色约束 → 选智能体，并给出可解释的理由。"""
-from __future__ import annotations
-
+# -*- coding: utf-8 -*-
+"""智能路由：能力基线 × 历史胜率 × 角色约束 → 选智能体，并给出可解释的理由。"""
+from __future__ import annotations
+
+import os
+import re
+
 from . import dispatch, history
-
-# 各类智能体的能力基线（0-100）。真实 CLI 里官方双雄最高。
-CAPABILITY = {
-    "codex": 84, "claude": 84, "opencode": 74, "qwen": 72,
-    "aider": 70, "openclaw": 60, "generic": 55, "mock": 10,
-}
-
+
+# 各类智能体的能力基线（0-100）。真实 CLI 里官方双雄最高。
+CAPABILITY = {
+    "codex": 84, "claude": 84, "opencode": 74, "qwen": 72,
+    "aider": 70, "openclaw": 60, "generic": 55, "mock": 10,
+}
+
 MAX_REPAIR_ROUNDS = 2  # 自动修复循环上限
 AUTO_CRITIC_LIMIT = 2  # 自动内容评审只取综合分前两名；手工模式仍尊重完整名单
 
@@ -19,35 +22,43 @@ def _task_type(ttype):
     if isinstance(ttype, dict):
         return str(ttype.get("type") or ttype.get("dimension") or "direct")
     return str(ttype or "direct")
-
-
+
+
 def _binding_bonus(agent_id, dispatch_mode=False):
-    """绑定链可用性加分/减分：链上有可用条目 +8，解析为空 -25。2026-09-16 实测：
-    静态能力基线让配额烧干的 codex 永远压过健康备用 CLI，绑定空的 CLI 更是连
-    用户配置的模型都没用上——先按「能不能按配置跑起来」校准。2026-09-17 起
-    空链步骤在 pipeline 直接判失败（不再静默回落本机默认），此处只管排序。"""
-    try:
-        from . import modelhub
+    """绑定链可用性加分/减分：解析出的调用链有备胎（≥2 条）+8；单条 = 单点
+    无降级空间 +0；解析为空 -25。2026-09-16 实测：静态能力基线让配额烧干的
+    codex 永远压过健康备用 CLI，绑定空的 CLI 更是连用户配置的模型都没用上
+    ——先按「能不能按配置跑起来」校准。2026-09-22 续修：单条链（含空链+
+    仅 provider_id 的旧数据）拿过 +8 是信号失真——2026-09-22 智谱余额清零
+    实测「绑定链可用」的 claude/kimi 全是单点，无一家有第二口气。返回
+    (分值, 理由文本)。"""
+    try:
+        from . import modelhub
         pref = modelhub._binding_for(agent_id)
         configured = bool(modelhub._binding_chain(pref) or pref.get("provider_id"))
         if not configured:
-            return 0.0 if dispatch_mode else -25.0
+            return (0.0, "") if dispatch_mode else (-25.0, "，绑定链为空：相关步骤将判失败（-25.0）")
         b = modelhub.resolve_binding(agent_id)
-        return 8.0 if (b and b.get("call_chain")) else -25.0
-    except Exception:
-        return 0.0
-
-
+        n = len((b or {}).get("call_chain") or [])
+        if n >= 2:
+            return 8.0, "，绑定链可用（+8.0）"
+        if n == 1:
+            return 0.0, "，绑定单点无备胎（+0）"
+        return -25.0, "，绑定链为空：相关步骤将判失败（-25.0）"
+    except Exception:
+        return 0.0, ""
+
+
 def _history_bonus(stats, agent_id, ttype):
-    s = (stats.get(agent_id) or {}).get(ttype) or {}
-    if not s.get("runs"):
-        return 0.0
-    runs = s["runs"]
-    win_rate = s["wins"] / runs
-    # 胜率为主，经验为辅；败率要扣分且随样本量爬满（前 3 次线性加权，防一次
-    # 偶发失败把智能体埋了）。0/3 全败 = -18：常挂的 CLI 必须排到无历史的新
-    # 面孔之后（2026-09-17 前败率不扣分，0/3 还拿 +6 经验分，比没跑过还高）。
-    loss_penalty = 24.0 * (1.0 - win_rate) * min(1.0, runs / 3.0)
+    s = (stats.get(agent_id) or {}).get(ttype) or {}
+    if not s.get("runs"):
+        return 0.0
+    runs = s["runs"]
+    win_rate = s["wins"] / runs
+    # 胜率为主，经验为辅；败率要扣分且随样本量爬满（前 3 次线性加权，防一次
+    # 偶发失败把智能体埋了）。0/3 全败 = -18：常挂的 CLI 必须排到无历史的新
+    # 面孔之后（2026-09-17 前败率不扣分，0/3 还拿 +6 经验分，比没跑过还高）。
+    loss_penalty = 24.0 * (1.0 - win_rate) * min(1.0, runs / 3.0)
     return round(18.0 * win_rate + min(6.0, runs) - loss_penalty, 1)
 
 
@@ -79,20 +90,15 @@ def _online_bonus(agent, role, ttype):
 
 
 def score(agent, role, ttype, stats=None):
-    """返回 (总分, 理由字符串)。配额惩罚：catalog 里配了
-    quota_tokens_per_hour 的智能体，本小时用量越接近配额分越低
-    （封顶 -45，足以盖过历史加分），满额后仅在没有其他选择时才会被选中。"""
+    """返回 (总分, 理由字符串)。配额惩罚：catalog 里配了
+    quota_tokens_per_hour 的智能体，本小时用量越接近配额分越低
+    （封顶 -45，足以盖过历史加分），满额后仅在没有其他选择时才会被选中。"""
     stats = stats or {}
     ttype = _task_type(ttype)
-    base = CAPABILITY.get(agent.get("kind"), 60)
+    base = CAPABILITY.get(agent.get("kind"), 60)
     use_dispatch = bool(agent.get("_dispatch_task_type") or
                         agent.get("dispatch_enabled"))
-    bb = _binding_bonus(agent.get("id"), dispatch_mode=use_dispatch)
-    btxt = ""
-    if bb > 0:
-        btxt = "，绑定链可用（+%s）" % bb
-    elif bb < 0:
-        btxt = "，绑定链为空：相关步骤将判失败（%s）" % bb
+    bb, btxt = _binding_bonus(agent.get("id"), dispatch_mode=use_dispatch)
     hb = _history_bonus(stats, agent.get("id"), ttype)
     online, online_txt = _online_bonus(agent, role, ttype)
     # 保持公开 score() 的历史绝对分值；运行级候选由 pipeline 标记画像后
@@ -100,41 +106,120 @@ def score(agent, role, ttype, stats=None):
     affinity, affinity_txt = (dispatch.agent_affinity(agent.get("kind"), ttype, role)
                               if use_dispatch else (0.0, "兼容模式"))
     total = base + bb + hb + affinity + online
-    hs = (stats.get(agent.get("id")) or {}).get(ttype)
-    htxt = ("，历史 %d/%d 胜（%s）" % (hs["wins"], hs["runs"], "%+.1f" % hb)) if hs else "，无历史记录"
-    quota_txt = ""
-    quota = int(agent.get("quota_tokens_per_hour") or 0)
-    if quota > 0:
-        try:
-            from . import usage
-            used = usage.agent_tokens_recent(agent.get("id"), hours=1)
-        except Exception:
-            used = 0
-        if used > 0:
-            ratio = min(1.0, used / float(quota))
-            penalty = round(-45.0 * ratio, 1)
-            if penalty:
-                total += penalty
-                quota_txt = "，本小时 %d/%d tokens（%s）" % (used, quota, penalty)
+    hs = (stats.get(agent.get("id")) or {}).get(ttype)
+    htxt = ("，历史 %d/%d 胜（%s）" % (hs["wins"], hs["runs"], "%+.1f" % hb)) if hs else "，无历史记录"
+    quota_txt = ""
+    quota = int(agent.get("quota_tokens_per_hour") or 0)
+    if quota > 0:
+        try:
+            from . import usage
+            used = usage.agent_tokens_recent(agent.get("id"), hours=1)
+        except Exception:
+            used = 0
+        if used > 0:
+            ratio = min(1.0, used / float(quota))
+            penalty = round(-45.0 * ratio, 1)
+            if penalty:
+                total += penalty
+                quota_txt = "，本小时 %d/%d tokens（%s）" % (used, quota, penalty)
     return total, "能力基线 %d，%s%s%s%s%s，总分 %s" % (
         base, affinity_txt, btxt, htxt, online_txt, quota_txt, round(total, 1))
-
-
+
+
 def pick(agents, role, ttype, stats=None, exclude=()):
-    """按分选出最优智能体。返回 (agent, 理由) 或 (None, "")。"""
-    stats = stats or history.agent_stats()
-    best, best_reason = None, ""
-    for a in agents:
-        if a["id"] in exclude:
-            continue
-        total, reason = score(a, role, ttype, stats)
-        if best is None or total > best[0]:
-            best, best_reason = (total, a), reason
-    if best is None:
-        return None, ""
+    """按分选出最优智能体。返回 (agent, 理由) 或 (None, "")。"""
+    stats = stats or history.agent_stats()
+    best, best_reason = None, ""
+    for a in agents:
+        if a["id"] in exclude:
+            continue
+        total, reason = score(a, role, ttype, stats)
+        if best is None or total > best[0]:
+            best, best_reason = (total, a), reason
+    if best is None:
+        return None, ""
     return best[1], best_reason
 
 
+# 空链 CLI 的真实上游在各自本机配置里（注册表里的 provider_id 是 UI 残留，
+# 2026-09-22 实测 qwencode 注册表指 prov-36 本机却指公司网关）。正则探针
+# 只为换将时识别「同上游」，读不到就算未知——未知不参与剔除，宁白试不误杀。
+_LOCAL_ENDPOINT_PROBES = (
+    ("kimi-code", "~/.kimi-code/config.toml", r'baseUrl\s*=\s*"([^"]+)"'),
+    ("claude-code", "~/.claude/settings.json", r'"ANTHROPIC_BASE_URL"\s*:\s*"([^"]+)"'),
+    ("qwencode", "~/.qwen/settings.json", r'"OPENAI_BASE_URL"\s*:\s*"([^"]+)"'),
+    ("opencode", "~/.config/opencode/opencode.json", r'"baseURL"\s*:\s*"([^"]+)"'),
+    ("opencode", "~/.config/opencode/opencode.jsonc", r'"baseURL"\s*:\s*"([^"]+)"'),
+    ("codex-cli", "~/.codex/config.toml", r'base_url\s*=\s*"([^"]+)"'),
+)
+
+
+def _host_of(url):
+    """上游归一：只留 host:port。/api/anthropic 与 /v1 的路径差异不算换上游。"""
+    m = re.match(r"^[a-zA-Z][a-zA-Z0-9+.-]*://([^/?#]+)", str(url or "").strip())
+    return m.group(1).lower() if m else ""
+
+
+def agent_upstreams(agent_id):
+    """候选实际会用到的上游集合（host:port 归一）。显式链 > CLI 本机配置
+    端点；两者都拿不到返回空集 = 未知。"""
+    ups = set()
+    try:
+        from . import modelhub
+        pref = modelhub._binding_for(agent_id)
+        chain = modelhub._binding_chain(pref)
+        provs = {p.get("id"): p for p in modelhub.providers()}
+        if chain:
+            for item in chain:
+                pid = (item.get("provider_id") or "").strip()
+                h = _host_of((provs.get(pid) or {}).get("base_url"))
+                if h:
+                    ups.add(h)
+    except Exception:
+        pass
+    if not ups:
+        for aid, path, pat in _LOCAL_ENDPOINT_PROBES:
+            if aid != agent_id:
+                continue
+            try:
+                with open(os.path.expanduser(path), "r", encoding="utf-8",
+                          errors="ignore") as fh:
+                    txt = fh.read()
+            except OSError:
+                continue
+            for m in re.finditer(pat, txt):
+                h = _host_of(m.group(1))
+                if h:
+                    ups.add(h)
+    return ups
+
+
+def pick_switch_candidate(agents, role, ttype, stats, exclude=(),
+                          dead_upstreams=()):
+    """换将选将。配额类死亡背景下：与死者同上游的候选依次让位，直到找到
+    异上游/上游未知的候选（2026-09-22 实案：kimi 与 claude 同骑智谱，0.1 分
+    之差把异上游 qwencode 压在下面，换将=换壳不换命）。异上游耗尽后同上游
+    候选捡回分数最高者——聊胜于无。"""
+    exclude = set(exclude)
+    best, reason = pick(agents, role, ttype, stats, exclude=exclude)
+    if best is None or not dead_upstreams:
+        return best, reason
+    deferred = []
+    while best is not None:
+        ups = agent_upstreams(best.get("id"))
+        if not (ups and any(ups & dead for dead in dead_upstreams)):
+            break  # 异上游或上游未知：就用它
+        deferred.append((best, reason))
+        best, reason = pick(agents, role, ttype, stats, exclude=exclude | {
+            x.get("id") for x, _ in deferred})
+    if best is None and deferred:
+        best, reason = deferred[0]  # 异上游全灭：同上游里挑最高的顶上
+    elif deferred:
+        reason = ("%s（%s 与死者同上游，延后让位异上游候选）"
+                  % (reason, deferred[-1][0].get("id")))
+    return best, reason
+
+
 def route_plan(agents, role, task_spec, stats=None, exclude=(), selected=None,
                participants=(), selection_reason=""):
     """生成可审计的候选排序，并可用实际选路覆盖评分预选结果。"""
@@ -177,31 +262,31 @@ def route_plan(agents, role, task_spec, stats=None, exclude=(), selected=None,
             "candidates": rows,
             "fallback": [x["agent_id"] for x in rows
                          if x["agent_id"] not in active_ids]}
-
-
-def pick_reviewer(agents, impl, ttype, stats=None):
-    """评审者：跨厂商是硬规则（Codeband 的对抗式配对）——同族评审有同款盲区，
-    评审者必须来自与实现者不同的 kind；跨族池为空才回退同厂商并如实备注，
-    绝不把回退伪装成跨厂商。"""
-    stats = stats or history.agent_stats()
-    impl_kind = impl.get("kind")
-    real = [a for a in agents if a.get("mode") == "real" and a["id"] != impl["id"]]
-    cross = [a for a in real if a.get("kind") != impl_kind]
-    if cross:
-        best = max(cross, key=lambda a: score(a, "review", ttype, stats)[0])
-        _, reason = score(best, "review", ttype, stats)
-        return best, "跨厂商评审（%s ≠ %s）：%s" % (best.get("kind"), impl_kind, reason)
-    if real:
-        best = max(real, key=lambda a: score(a, "review", ttype, stats)[0])
-        _, reason = score(best, "review", ttype, stats)
-        return best, ("（无跨厂商智能体可用，回退同厂商 %s 评审——建议启用其他厂商的 CLI）"
-                      % impl_kind) + reason
-    mb = next((a for a in agents if a["id"] == "mock-b"), None)
-    if mb and impl.get("mode") != "mock":
-        return mb, "（无第二个真实智能体，用 mock 评审）"
-    return impl, "（自评：仅有实现者一个智能体可用）"
-
-
+
+
+def pick_reviewer(agents, impl, ttype, stats=None):
+    """评审者：跨厂商是硬规则（Codeband 的对抗式配对）——同族评审有同款盲区，
+    评审者必须来自与实现者不同的 kind；跨族池为空才回退同厂商并如实备注，
+    绝不把回退伪装成跨厂商。"""
+    stats = stats or history.agent_stats()
+    impl_kind = impl.get("kind")
+    real = [a for a in agents if a.get("mode") == "real" and a["id"] != impl["id"]]
+    cross = [a for a in real if a.get("kind") != impl_kind]
+    if cross:
+        best = max(cross, key=lambda a: score(a, "review", ttype, stats)[0])
+        _, reason = score(best, "review", ttype, stats)
+        return best, "跨厂商评审（%s ≠ %s）：%s" % (best.get("kind"), impl_kind, reason)
+    if real:
+        best = max(real, key=lambda a: score(a, "review", ttype, stats)[0])
+        _, reason = score(best, "review", ttype, stats)
+        return best, ("（无跨厂商智能体可用，回退同厂商 %s 评审——建议启用其他厂商的 CLI）"
+                      % impl_kind) + reason
+    mb = next((a for a in agents if a["id"] == "mock-b"), None)
+    if mb and impl.get("mode") != "mock":
+        return mb, "（无第二个真实智能体，用 mock 评审）"
+    return impl, "（自评：仅有实现者一个智能体可用）"
+
+
 def pick_critics(agents, ttype, stats=None, impl=None):
     """自动内容评审组选综合分前两名（排除作者本人）。
 
@@ -214,9 +299,9 @@ def pick_critics(agents, ttype, stats=None, impl=None):
         ranked = sorted(real, key=lambda a: score(a, "review", ttype, stats)[0], reverse=True)
         real = ranked[:AUTO_CRITIC_LIMIT]
         note = "按成功率与延迟选择前 %d 名评审（共 %d 名候选）" % (len(real), len(ranked))
-        if impl and impl.get("mode") == "real" \
-                and all(a.get("kind") == impl.get("kind") for a in real):
-            note += "；评审组与作者同为 %s，建议启用其他厂商 CLI 交叉评审" % impl.get("kind")
-        return real, note
-    mocks = [a for a in agents if a.get("mode") == "mock"] or agents[:2]
-    return mocks, "（无真实智能体，用内置 mock 演示）"
+        if impl and impl.get("mode") == "real" \
+                and all(a.get("kind") == impl.get("kind") for a in real):
+            note += "；评审组与作者同为 %s，建议启用其他厂商 CLI 交叉评审" % impl.get("kind")
+        return real, note
+    mocks = [a for a in agents if a.get("mode") == "mock"] or agents[:2]
+    return mocks, "（无真实智能体，用内置 mock 演示）"