codebee 0.1.52 → 0.1.53

package/CHANGELOG.md

@@ -23,6 +23,12 @@ README 元数据带回，供老版本在「发现新版本」时展示新版更
 
 - **首选 KEY 超限自动切备用了**：同厂商多密钥此前只认欠费类文案——首选 KEY 撞上 429 限流（智谱「并发数超过限制」「每分钟Token数已超过上限」、claude 的 rate_limit_error、codex 的 "429 Too Many Requests" 等）只记一笔错误、不进冷却，每个新步骤仍从超限的首选 KEY 重新烧起。现在限流文案与欠费同口径：进冷却 30 分钟、密钥镜像自动切下一把、链展开跳过冷却中的 KEY（到期或「恢复」按钮一键回首选）。顺带补一处漏账：无显式链时「换模型回退」的链条目不带 KEY 标记，这类重试失败此前完全不记 KEY 账。
 
+## v0.1.53（2026-09-23）
+
+- 换将救活两类「假终态」：上游内容拒答（"can't help with this" 一类 refusal）与真超时，现在都会换绑定链上下一个候选再试——此前拒答直接判死整轮任务（链上异上游候选从未被尝试），超时能不能换全凭输出尾段碰巧带 "timeout" 字样；真实案：夜间知识库整理任务被网关 gemini 拒答后整 run 白烧
+- 同一慢上游连烧止损：链上候选连续两次相同超时即收手（换将=换壳不换命），最坏从 N×单步超时压到 2×；取消显式列为终态绝不降级
+- 网关模型漂移可见：请求 A 模型被网关实际映射成 B 模型时（真实案：请求 deepseek-v4.1-flash 实服 gemini-3.8-flash），失败信息与步骤日志明确标注「请求 X，上游实服 Y」，排查看对病根
+
 ## v0.1.52（2026-09-22）
 
 - 手动指定执行者优先级全面收口：用户点名的 CLI 压过一切自动选择——路由不换将、旁观不抢占、绑定不覆盖；「手动指定执行者」作为一等偏好随任务走

package/README.md

@@ -21,10 +21,11 @@ Kimi Code、MiMo Code、Grok Build、Pi、DeepSeek Harness……），提供
 不会把你的任务内容交给任何第三方。
 
 <!-- relnotes:start -->
-### 最新版更新内容（v0.1.52）
+### 最新版更新内容（v0.1.53）
 
-- 手动指定执行者为一等偏好：用户点名的 CLI 压过自动路由，全程不换将、不被抢占
-- 管理页执行者下拉与新建任务菜单统一；静默挂死看门狗防误杀保留
+- 换将救活两类「假终态」：上游内容拒答（refusal）与真超时都会换链上下一个候选再试，不再整轮白烧
+- 同一慢上游连烧止损：连续两次相同超时即收手；取消绝不降级
+- 网关模型漂移可见：请求与实际服务的模型不一致时，失败信息明确标注
 <!-- relnotes:end -->
 
 ---

package/app/core/automation.py

@@ -65,7 +65,7 @@ _DEFAULTS = {"id": "", "name": "", "prompt": "", "workdir": "", "kind": "", "tim
              "mode": "auto", "thinking": "standard",
              "direct_provider_id": "", "direct_model": "",
              "enabled": False, "created_at": "", "last_run": "", "next_run": "",
-             "run_count": 0, "last_status": ""}
+             "run_count": 0, "last_status": "", "last_run_id": ""}
 
 # 允许通过 update() 修改的字段（id/created_at/run_count 等运行痕迹不可改）
 _UPDATABLE = ("name", "prompt", "workdir", "kind", "time", "interval_hours",
@@ -386,8 +386,9 @@ def _fire(snapshot, now):
     """触发一个到期任务：拉起运行并推进 last_run/next_run/run_count/last_status。
     once 触发完自动停用。拉起失败只记 error，next_run 照常推进（下个周期重试）。"""
     status = "started"
+    run_id = ""
     try:
-        _launch_run(snapshot)
+        run_id = _launch_run(snapshot) or ""
     except Exception as e:
         log.warning("automation: 定时触发 %s 失败: %r", snapshot.get("id"), e)
         status = "error"
@@ -398,6 +399,8 @@ def _fire(snapshot, now):
         cur["last_run"] = _fmt_dt(now)
         cur["run_count"] = int(cur.get("run_count") or 0) + 1
         cur["last_status"] = status
+        if run_id:
+            cur["last_run_id"] = run_id
         if cur.get("kind") == "once":
             cur["enabled"] = False
             cur["next_run"] = ""
@@ -408,6 +411,49 @@ def _fire(snapshot, now):
 
 # ---------------------------------------------------------------- 调度线程
 
+def _default_run_status(rid):
+    """按 run_id 查运行状态（终态回写用）；查不到返回 None。"""
+    from . import store
+    try:
+        r = store.get_run(rid)
+    except Exception:
+        return None
+    return (r or {}).get("status") or None
+
+
+# 测试可替换的查态钩子
+_RUN_STATUS = _default_run_status
+
+_RUN_TERMINAL = ("done", "failed", "cancelled")
+
+
+def _reconcile_statuses():
+    """把 last_status 停在 started 的任务对账到真实运行终态。此前触发后永不
+    回写，任务卡片永远显示「运行中」（2026-09-23 实案：三个任务全部如此）。
+    store 查不到或还没到终态就保持原样，下一轮 tick 再看。"""
+    with _LOCK:
+        pending = {tid: t.get("last_run_id") for tid, t in _TASKS.items()
+                   if t.get("last_run_id") and t.get("last_status") == "started"}
+    if not pending:
+        return
+    settled = {}
+    for tid, rid in pending.items():
+        st = _RUN_STATUS(rid)
+        if st in _RUN_TERMINAL:
+            settled[tid] = st
+    if not settled:
+        return
+    with _LOCK:
+        dirty = False
+        for tid, st in settled.items():
+            t = _TASKS.get(tid)
+            if (t and t.get("last_run_id") == pending[tid]
+                    and t.get("last_status") == "started"):
+                t["last_status"] = st
+                dirty = True
+        if dirty:
+            _save_locked()
+
 def _tick():
     """扫描一遍到期任务并逐个触发。单任务异常只跳过该条，绝不上抛。"""
     now = datetime.now()
@@ -429,6 +475,11 @@ def _tick():
             _fire(dict(t), now)
         except Exception:
             log.exception("automation: tick 处理任务 %s 异常，已跳过", tid)
+    # 运行终态对账：last_status 停在 started 的任务查一次真实终态（见函数注）。
+    try:
+        _reconcile_statuses()
+    except Exception:
+        log.debug("automation: 运行终态对账跳过", exc_info=True)
     # 定时发布联动（P2.5）：任务级 auto_publish 标记到点触发批量发布。
     # 发布逻辑全在 publish/auto（护栏/幂等/单飞），这里只当调度宿主。
     try:
@@ -581,10 +632,11 @@ def run_now(tid):
     now = datetime.now()
     run_id = ""
     status = "started"
+    run_id = ""
     try:
         with _LOCK:
             snapshot = dict(_TASKS[tid])
-        run_id = _launch_run(snapshot)
+        run_id = _launch_run(snapshot) or ""
     except Exception as e:
         log.warning("automation: 手动触发 %s 失败: %r", tid, e)
         status = "error"
@@ -601,6 +653,8 @@ def run_now(tid):
             t["last_run"] = _fmt_dt(now)
         t["run_count"] = int(t.get("run_count") or 0) + 1
         t["last_status"] = status
+        if run_id:
+            t["last_run_id"] = run_id
         _save_locked()
         return dict(t), run_id
 

package/app/core/branching.py

@@ -0,0 +1,105 @@
+# -*- coding: utf-8 -*-
+"""多线剧情推演（inkos 借鉴 2026-09-23）：写章前一次调用生成 2-3 条分支
+节拍计划，自带推荐择优，选中分支注入本章 BEATS；全部分支追加审计文件
+.codebee/branch-plans.md 供回看。计划级赛马——比 prose 级 Best-of-N 省
+一个数量级的 token。"""
+from __future__ import annotations
+
+import logging
+import os
+
+log = logging.getLogger(__name__)
+
+BRANCH_PLAN_PROMPT = """你是网文剧情策划。基于全书设定与上一章结尾，为下一章生成 __N__ 条**彼此方向不同**的剧情分支计划。
+
+要求：
+- 每条分支给出：本章节拍（50-120 字：事件/冲突/推进）+ 章末钩子（一句话）+ 一句取舍理由（为什么选/不选它）
+- 分支之间要有真实的方向差异（不同冲突来源/不同人物决定/不同信息揭示），不是同一件事换措辞
+- 你是策划也是评委：综合大纲意图、前情、人物动机，推荐其中最有力的一条
+
+只输出一个 ```json 代码块：
+{"branches": [{"beats": "…", "hook": "…", "why": "…"}, …], "pick": 0}
+pick = 推荐分支的下标（0 起）。
+
+## 全书目标
+__GOAL__
+
+## 大纲上下文（本章前后）
+__OUTLINE__
+
+## 上一章结尾
+__PREV__
+"""
+
+
+def plan_branches(run_id, task, i, goal, outline_txt, prev, n, *, log_path=None):
+    """生成并择优一条分支计划。返回 (beats, hook) 或 None（失败/未启用走原大纲）。
+
+    编排者一次调用产 N 条+自荐 pick；失败静默回落原大纲节拍（推演是增强
+    不是闸门）。全部分支连同 pick 追加 .codebee/branch-plans.md 审计。"""
+    if n < 2:
+        return None
+    from . import modelhub, runner
+    if n < 2:
+        return None
+    orch = modelhub.resolve_orchestrator()
+    if not orch:
+        return None
+    prov, model = orch
+    prompt = (BRANCH_PLAN_PROMPT
+              .replace("__N__", str(n))
+              .replace("__GOAL__", goal[:600])
+              .replace("__OUTLINE__", outline_txt[:3000])
+              .replace("__PREV__", (prev or "（开篇）")[-1200:]))
+    res = modelhub.chat(prov["id"], model, prompt, max_tokens=4000, timeout=300)
+    if not res.get("ok"):
+        return None
+    data = runner.extract_json(res.get("text") or "")
+    branches = (data or {}).get("branches") if isinstance(data, dict) else None
+    if not isinstance(branches, list):
+        return None
+    usable = [b for b in branches
+              if isinstance(b, dict) and str(b.get("beats") or "").strip()]
+    if len(usable) < 2:
+        return None
+    try:
+        pick = int(data.get("pick") or 0)
+    except (TypeError, ValueError):
+        pick = 0
+    pick = max(0, min(pick, len(usable) - 1))
+    chosen = usable[pick]
+    try:
+        from . import store as _store
+        wd = _store.run_workdir(run_id) or ""
+    except Exception:
+        wd = ""
+    _append_audit(wd, i, usable, pick)
+    return (str(chosen["beats"]).strip()[:300],
+            str(chosen.get("hook") or "").strip()[:80] or None)
+
+
+def _append_audit(workdir, chapter, branches, pick):
+    """全部分支追加 .codebee/branch-plans.md（失败静默——审计是增强）。"""
+    if not workdir:
+        return
+    try:
+        p = os.path.abspath(os.path.join(str(workdir), ".codebee",
+                                         "branch-plans.md"))
+        root = os.path.abspath(str(workdir))
+        if root not in p.split(os.sep)[:-len([".codebee", "branch-plans.md"])]:
+            if not p.startswith(root + os.sep):
+                return
+        os.makedirs(os.path.dirname(p), exist_ok=True)
+        with open(p, "a", encoding="utf-8") as f:
+            if f.tell() == 0:
+                f.write("# 多线剧情推演（每章分支计划与择优，供回看）\n\n")
+            f.write("## 第 %d 章\n" % chapter)
+            for k, b in enumerate(branches):
+                mark = "✅ " if k == pick else ""
+                f.write("- %s%s（钩子：%s）——%s\n" % (
+                    mark, str(b.get("beats") or "")[:160],
+                    str(b.get("hook") or "")[:60],
+                    str(b.get("why") or "")[:120]))
+            f.write("\n")
+    except Exception:
+        pass

package/app/core/pipeline.py

@@ -19,7 +19,7 @@ import re
 import threading
 import time
 
-from . import aiflavor, attachments, catalog, dispatch_log, history, hooks, jobs, knowledge, manager, modelhub, mocks, paihang, planner, registry, router, runner, skills, store, task_compile, usage, volumes
+from . import aiflavor, attachments, branching, catalog, dispatch_log, history, hooks, jobs, knowledge, manager, modelhub, mocks, paihang, planner, registry, router, runner, skills, store, task_compile, usage, volumes
 from . import builtin_agent
 from . import diagnostics
 from . import paths as paths_mod
@@ -2556,6 +2556,20 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
             scope = ("本章 = 大纲第 %d 章" % i) if start == 1 else (
                 "本批为第 %d–%d 章，下列按全书章号列出各章要点" % (start, end))
 
+            # 多线剧情推演（inkos 借鉴 2026-09-23）：serial.branches>=2 时
+            # 写章前一次编排者调用生成 N 条分支节拍、自荐择优，选中分支替换
+            # 本章 BEATS/HOOK（计划级赛马，省 prose 级开销）；失败静默走原大纲。
+            branch_beats = branch_hook = None
+            try:
+                n_branch = max(1, min(3, int(serial.get("branches") or 1)))
+                if n_branch >= 2:
+                    got = branching.plan_branches(
+                        run_id, task, i, task["goal"], outline_txt, prev, n_branch)
+                    if got:
+                        branch_beats, branch_hook = got
+            except Exception:
+                branch_beats = None
+
             def _draft_prompt(vfile):
                 return (SERIAL_CHAPTER_PROMPT
                         .replace("__SKILLS__", sk_block)
@@ -2567,8 +2581,8 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
                         .replace("__PREV__", prev)
                         .replace("__LEDGER__", ledger_txt)
                         .replace("__TITLE__", ch["title"])
-                        .replace("__BEATS__", ch["beats"] or "按大纲推进")
-                        .replace("__HOOK__", ch.get("hook") or "留下悬念")
+                        .replace("__BEATS__", branch_beats or ch["beats"] or "按大纲推进")
+                        .replace("__HOOK__", branch_hook or ch.get("hook") or "留下悬念")
                         .replace("__WORDS__", str(wpc)))
 
             n_variants = max(1, min(3, int(serial.get("variants") or 1)))

package/app/core/runner.py

@@ -823,6 +823,10 @@ def _parse_claude_json(stdout):
         int(u.get("cache_creation_input_tokens") or 0)
     usage = {"input": inp, "output": out, "cached": cached, "reasoning": 0,
              "total": inp + out + cached}
+    # 网关实服模型：请求 deepseek-v4.1-flash 却被网关映射成 gemini-3.8-flash
+    # 之类（2026-09-23 夜班实案）——用量统计记错名、失败排查看错病根，都
+    # 靠 result 行的 modelUsage 对出来
+    served = sorted({str(k) for k in ((data.get("modelUsage") or {}) or {})})
     return {
         "text": data.get("result") or "",
         "cost_usd": data.get("total_cost_usd") or 0.0,
@@ -831,6 +835,7 @@ def _parse_claude_json(stdout):
         "is_error": bool(data.get("is_error")),
         # §07 T1.1：claude -p 返回本次会话 id，供 --resume 复用
         "sid": str(data.get("session_id") or ""),
+        "served_models": served,
     }
 
 
@@ -898,6 +903,55 @@ RATE_LIMIT_GRACE_S = 45      # 宽限等待时长：限流窗口通常按分钟
 RATE_LIMIT_GRACE_N = 1       # 每步宽限次数：只兜一次，防限流长拖整轮时间
 
 
+# 上游内容拒答（refusal）：claude CLI 把 refusal stop_reason 渲染成
+# "API Error: <model> can't help with this. Start a new session to continue."
+# 这是网关后面那个模型对本次会话内容的过滤决定，不是任务终态——换一家
+# 异上游候选常常就能跑通。2026-09-23 夜班实案：doc 起草被 gemini 拒答后
+# 判成非瞬态整链早死，链上云知声候选根本没被尝试。
+_REFUSAL = ("can't help with this", "couldn't help with this",
+            'stop_reason":"refusal"', "content policy", "content filtering")
+
+
+def _refusal_error(err):
+    err = (err or "").lower()
+    return any(k in err for k in _REFUSAL)
+
+
+def _fail_sig(err):
+    """错误串的病根特征（剥掉输出尾段/数字/会话 id 等易变片段），供换将
+    循环做同因连撞止损。与 jobs._err_signature 同思路的轻量版，避免 core
+    模块环。超时错误的尾段是每次被杀时刻的输出快照，必然不同，签名只取
+    头部（；分隔符之前）。"""
+    s = str(err or "")
+    for sep in ("；stderr/stdout", "；日志错误行"):
+        i = s.find(sep)
+        if i > 0:
+            s = s[:i]
+            break
+    s = re.sub(r"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}",
+               "<sid>", s)
+    s = re.sub(r"\d+", "N", s)
+    return re.sub(r"\s+", " ", s).strip()[:200]
+
+
+def _claude_drift_note(att_model, parsed):
+    """请求模型 vs 网关实服模型不一致时的注记；一致或无从判断返回空。"""
+    served = (parsed or {}).get("served_models") or []
+    if not served or not att_model or served == [att_model]:
+        return ""
+    return "[模型漂移] 请求 %s，上游实服 %s" % (att_model, ",".join(served))
+
+
+def _log_note(log_path, text):
+    if not log_path or not text:
+        return
+    try:
+        with open(log_path, "a", encoding="utf-8") as fh:
+            fh.write("\n[%s]\n" % text)
+    except OSError:
+        pass
+
+
 def _rate_limited(err):
     err = (err or "").lower()
     return any(k in err for k in _RATE_LIMIT)
@@ -1255,7 +1309,8 @@ def run_agent(agent, prompt, workdir=None, readonly=True,
     防模型纯口头谎报「环境受限」蒙混过关（2026-09-17 mo-so 实测）。
 
     模型尝试顺序来自 _resolve_attempts：跨厂商链（每条独立 env）或
-    主模型 + 降级备选；瞬态错误才换下一条，取消/超时/解析失败不降级。
+    主模型 + 降级备选；瞬态/配额/超时/上游拒答换下一条，取消与解析
+    失败不降级；超时连续两次同签名即止损（同一慢上游换壳无用）。
 
     5E：catalog `orch.timeout_ms`（毫秒）优先于 caller 传入的 timeout。
     """
@@ -1308,6 +1363,7 @@ def run_agent(agent, prompt, workdir=None, readonly=True,
     attempts = _resolve_attempts(agent)
     out = None
     grace_left = RATE_LIMIT_GRACE_N  # 链尾限流宽限预算：整链撞 429 时原地等一个窗口再试一次
+    prev_sig = ""  # 上一次尝试的失败签名：同因连撞止损用
     for ai, att in enumerate(attempts):
         env = dict(base_env)
         env.update(att["env"])
@@ -1370,6 +1426,10 @@ def run_agent(agent, prompt, workdir=None, readonly=True,
                     parsed_err = _parse_claude_json(res["stdout"] or "")
                     if parsed_err and parsed_err.get("is_error") and parsed_err.get("text"):
                         out["error"] = "claude 返回 is_error: " + parsed_err["text"][:500]
+                        drift = _claude_drift_note(att.get("model"), parsed_err)
+                        if drift:
+                            out["error"] += "；" + drift
+                            _log_note(log_path, drift)
                 if kind == "codex" and att.get("provider_id"):
                     el = out["error"].lower()
                     if (("wire_api" in el and "no longer supported" in el)
@@ -1442,9 +1502,14 @@ def run_agent(agent, prompt, workdir=None, readonly=True,
                 out["tokens"] = parsed["tokens"]
                 out["usage"] = parsed["usage"]
                 out["sid"] = parsed.get("sid") or ""  # §07 T1.1
+                drift = _claude_drift_note(att.get("model"), parsed)
+                if drift:
+                    _log_note(log_path, drift)
                 if parsed["is_error"]:
                     out["ok"] = False
                     out["error"] = "claude 返回 is_error: " + parsed["text"][:500]
+                    if drift:
+                        out["error"] += "；" + drift
                     out["error_code"] = _classify_failure(res, kind="claude", parsed=parsed)
                     break
                 if not out["text"] and attempt == 0:
@@ -1471,10 +1536,30 @@ def run_agent(agent, prompt, workdir=None, readonly=True,
                     attempts.append(att)
                     continue
             return out
-        # 瞬态网络错误 → 换下一条；欠费/配额耗尽同样换（可能是同厂商的备用 KEY，
-        # 也可能是另一家厂商）——账单断了死磕同一把 KEY 没有任何意义。
-        if not (_transient_error(out.get("error")) or _quota_error(out.get("error"))):
-            return out  # 非瞬态（取消/超时/解析失败）不降级
+        # 换将闸门：什么失败值得烧链上下一个候选。
+        # · 瞬态/配额（文本特征，含 CLI 内部 api_retry 的 429/5xx 字样）照旧；
+        # · 超时：显式可换（看 res 标志位）——慢上游换快候选可能救回。
+        #   2026-09-23 夜班实案：旧逻辑里超时能否换将全赌输出尾部碰巧含有
+        #   "timeout" 字样（当时是步骤里读到的代码 timeout=900 撞的表）。
+        # · 上游内容拒答（refusal）：是那家模型的过滤决定，不是任务终态，
+        #   换异上游候选常常就活；判死则整 run 白烧（同案：gemini 拒答后
+        #   链上云知声候选从未被尝试）。
+        raw = out.get("raw") or {}
+        if (raw.get("cancelled")   # 取消是用户意志，绝不降级（尾段可能带瞬态字样）
+                or not (_transient_error(out.get("error")) or _quota_error(out.get("error"))
+                        or _refusal_error(out.get("error"))
+                        or raw.get("timed_out"))):
+            return out  # 取消/解析失败等真终态不降级
+        # 超时同因连撞止损：头部签名（超时/输出停滞）连续相同就收手——
+        # 链上候选绑同一上游时换将=换壳不换命（2026-09-22 429 集群教训；
+        # 2026-09-23 夜班实案同一慢上游连烧 3×20 分钟全超时零产出），最坏
+        # 情况从 N×步超时压到 2×。其余瞬态/拒答仍按链长全部尝试：各家病根
+        # 不同，每个候选都值得一次机会。
+        if raw.get("timed_out"):
+            sig = _fail_sig(out.get("error"))
+            if sig and sig == prev_sig:
+                return out
+            prev_sig = sig
     return out
 
 

package/app/core/store.py

@@ -223,6 +223,15 @@ def create_task(payload):
                     v = 1
                 if v > 1:
                     s["variants"] = v
+                # 多线剧情推演（inkos 借鉴 2026-09-23）：2-3 = 写章前生成
+                # N 条分支节拍计划择优注入（计划级赛马，省 prose 级开销）；
+                # 越界钳到 3（与 variants 同口径：上限仍可用，1=不启用不落键）
+                try:
+                    br = max(1, min(3, int(serial.get("branches") or 1)))
+                except Exception:
+                    br = 1
+                if br > 1:
+                    s["branches"] = br
                 # 分卷：显式卷表优先（新建任务时用户明确给出的分卷信息），
                 # 其次每卷章数等长切卷。卷边界一律由 volumes 模块从「章号」
                 # 确定性推导——续写批次沿用同一份卷表/每卷章数即自动接上同一卷，

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codebee",
-  "version": "0.1.52",
+  "version": "0.1.53",
   "description": "CodeBee · 多智能体编排台 — 统一编排本机 AI 编码 CLI（Codex / Claude Code / QwenCode / OpenCode / Aider…）：目标→拆解→路由→执行→验证→跨厂商评审→修复→报告。纯 Python 标准库实现，本地 Web UI。",
   "license": "MIT",
   "bin": {