codebee 0.1.14 → 0.1.16

package/app/core/publish/flows-fanqie-calibrated.json

@@ -0,0 +1,324 @@
+{
+ "_note": "番茄真机校准（2026-09-19 定稿，建书+发章结构全部实测）：编辑器=/main/writer/<book_id>/publish/ 直达（章节号 input.serial-input 纯数字；标题 div.serial-editor-input-hint input ≥5字/30上限；正文 .ProseMirror ≥1000字；「下一步」保存校验后按钮组右缘箭头展开下拉含「定时发布」）。建书=/main/writer/create 直达表单：radio 签约模式/目标读者（label 真实点击）→ 阅读标签 select（y<430）弹层 arco-anchor 切主分类/主题/角色/情节 + 标签云点击 + 确认 → 内容标签 select（y>430）弹层 情感/人设/世界观 同构 → 名称/主角1/主角2/简介 → 立即创建 → 跳 book-info/<id>。",
+ "check_login": [
+  {
+   "do": "navigate",
+   "url": "about:blank"
+  },
+  {
+   "do": "navigate",
+   "url": "{home}"
+  },
+  {
+   "do": "url_any",
+   "any": [
+    "fanqienovel.com"
+   ]
+  }
+ ],
+ "upload_chapter": [
+  {
+   "do": "navigate",
+   "url": "about:blank"
+  },
+  {
+   "do": "navigate",
+   "url": "{editor_url}"
+  },
+  {
+   "do": "url_any",
+   "any": [
+    "fanqienovel.com"
+   ]
+  },
+  {
+   "do": "wait",
+   "sel": ".ProseMirror",
+   "timeout": 20
+  },
+  {
+   "do": "fill",
+   "sel": "input.serial-input, input.byte-input",
+   "key": "chapter_no"
+  },
+  {
+   "do": "fill",
+   "sel": "div.serial-editor-input-hint input",
+   "key": "chapter_title"
+  },
+  {
+   "do": "fill",
+   "sel": ".ProseMirror",
+   "key": "chapter_body"
+  },
+  {
+   "do": "shot",
+   "name": "chapter-filled"
+  },
+  {
+   "do": "click_real",
+   "text": "下一步",
+   "scope": "button",
+   "tries": 15
+  },
+  {
+   "do": "click_arrow",
+   "target": "下一步"
+  },
+  {
+   "do": "click_real",
+   "text": "定时发布",
+   "tries": 12,
+   "optional": true
+  },
+  {
+   "do": "click_real",
+   "text": "发布",
+   "tries": 12,
+   "optional": true
+  },
+  {
+   "do": "verify",
+   "url": "{chapter_manage_url}",
+   "any": [
+    "{chapter_title}"
+   ],
+   "settle": 6
+  }
+ ],
+ "probe_form": [
+  {
+   "do": "navigate",
+   "url": "about:blank"
+  },
+  {
+   "do": "navigate",
+   "url": "https://fanqienovel.com/main/writer/create"
+  },
+  {
+   "do": "url_any",
+   "any": [
+    "fanqienovel.com"
+   ]
+  },
+  {
+   "do": "wait",
+   "sel": "input[placeholder='请输入作品名称']",
+   "timeout": 20
+  },
+  {
+   "do": "probe",
+   "note": "建书表单"
+  }
+ ],
+ "create_book": [
+  {
+   "do": "navigate",
+   "url": "about:blank"
+  },
+  {
+   "do": "navigate",
+   "url": "https://fanqienovel.com/main/writer/create"
+  },
+  {
+   "do": "url_any",
+   "any": [
+    "fanqienovel.com"
+   ]
+  },
+  {
+   "do": "wait",
+   "sel": "input[placeholder='请输入作品名称']",
+   "timeout": 20
+  },
+  {
+   "do": "sleep",
+   "s": 3
+  },
+  {
+   "do": "click_real",
+   "text": "{signing_mode}",
+   "scope": "label.arco-radio,span.arco-radio,[class*=serial-radio]",
+   "tries": 8
+  },
+  {
+   "do": "click_real",
+   "text": "{target_reader}",
+   "scope": "label.arco-radio,span.arco-radio,[class*=serial-radio]",
+   "tries": 8
+  },
+  {
+   "do": "click_real",
+   "text": "知道了",
+   "scope": "button",
+   "tries": 4,
+   "optional": true
+  },
+  {
+   "do": "click_real",
+   "text": "请选择作品标签",
+   "scope": "[class*=select-view],div,span",
+   "y_max": 430,
+   "tries": 10
+  },
+  {
+   "do": "click_real",
+   "text": "{category}",
+   "scope": ".category-modal span,.category-modal div,.category-modal li",
+   "tries": 8
+  },
+  {
+   "do": "click_real",
+   "text": "主题",
+   "scope": ".category-modal .arco-anchor-link",
+   "tries": 8
+  },
+  {
+   "do": "click_real",
+   "text": "{tag_theme}",
+   "scope": ".category-modal span,.category-modal div,.category-modal li",
+   "y_min": 140,
+   "tries": 8,
+   "optional": true
+  },
+  {
+   "do": "click_real",
+   "text": "角色",
+   "scope": ".category-modal .arco-anchor-link",
+   "tries": 8
+  },
+  {
+   "do": "click_real",
+   "text": "{tag_role}",
+   "scope": ".category-modal span,.category-modal div,.category-modal li",
+   "y_min": 140,
+   "tries": 8,
+   "optional": true
+  },
+  {
+   "do": "click_real",
+   "text": "情节",
+   "scope": ".category-modal .arco-anchor-link",
+   "tries": 8
+  },
+  {
+   "do": "click_real",
+   "text": "{tag_plot}",
+   "scope": ".category-modal span,.category-modal div,.category-modal li",
+   "y_min": 140,
+   "tries": 8,
+   "optional": true
+  },
+  {
+   "do": "click_real",
+   "text": "确认",
+   "scope": ".category-modal button",
+   "tries": 8
+  },
+  {
+   "do": "wait_gone",
+   "sel": ".category-modal",
+   "timeout": 25
+  },
+  {
+   "do": "click_real",
+   "text": "请选择作品标签",
+   "scope": "[class*=select-view],div,span",
+   "tries": 15
+  },
+  {
+   "do": "click_real",
+   "text": "情感",
+   "scope": ".category-modal .arco-anchor-link",
+   "tries": 8
+  },
+  {
+   "do": "click_real",
+   "text": "{tag_content_emotion}",
+   "scope": ".category-modal span,.category-modal div,.category-modal li",
+   "y_min": 140,
+   "tries": 8,
+   "optional": true
+  },
+  {
+   "do": "click_real",
+   "text": "人设",
+   "scope": ".category-modal .arco-anchor-link",
+   "tries": 8
+  },
+  {
+   "do": "click_real",
+   "text": "{tag_content_character}",
+   "scope": ".category-modal span,.category-modal div,.category-modal li",
+   "y_min": 140,
+   "tries": 8,
+   "optional": true
+  },
+  {
+   "do": "click_real",
+   "text": "世界观",
+   "scope": ".category-modal .arco-anchor-link",
+   "tries": 8
+  },
+  {
+   "do": "click_real",
+   "text": "{tag_content_world}",
+   "scope": ".category-modal span,.category-modal div,.category-modal li",
+   "y_min": 140,
+   "tries": 8,
+   "optional": true
+  },
+  {
+   "do": "click_real",
+   "text": "确认",
+   "scope": ".category-modal button",
+   "tries": 8
+  },
+  {
+   "do": "wait_gone",
+   "sel": ".category-modal",
+   "timeout": 25
+  },
+  {
+   "do": "fill",
+   "sel": "input[placeholder='请输入作品名称']",
+   "key": "title"
+  },
+  {
+   "do": "fill",
+   "sel": "input[placeholder='请输入主角名1']",
+   "key": "protagonist"
+  },
+  {
+   "do": "fill",
+   "sel": "input[placeholder='请输入主角名2']",
+   "key": "protagonist2"
+  },
+  {
+   "do": "fill",
+   "sel": "textarea[placeholder*='请输入50-500字']",
+   "key": "summary"
+  },
+  {
+   "do": "shot",
+   "name": "create-book-filled"
+  },
+  {
+   "do": "click_real",
+   "text": "立即创建",
+   "scope": "button",
+   "tries": 10
+  },
+  {
+   "do": "wait",
+   "sel": "body",
+   "timeout": 10
+  },
+  {
+   "do": "url_any",
+   "any": [
+    "book-info"
+   ]
+  }
+ ]
+}

package/app/core/publish/manager.py

@@ -322,15 +322,27 @@ def create_book_async(task_id, plat, auto_submit=False):
             b, page = _open_page(plat)
             values = mod.values_create_book(data)
             steps = _with_tag_steps(load_flow(plat, "create_book"),
-                                    mod.tag_groups(data), values)
+                                    mod.tag_groups(data), values, mod)
             flow.run_flow(page, steps, values=values, config=mod.CONFIG,
                           auto_submit=auto_submit,
                           shot=lambda n: page.screenshot(ledger.shot_path(plat, task_id, n)),
                           log=logs.append)
+            # book_id：创建成功后平台跳书籍详情/编辑器，从 URL 提取
+            # （番茄 book-info/<id>；七猫 information?id=<id>）。
+            # 提取不到就先用书名登记，发章按书名找书。
+            book_id = ""
+            try:
+                m_url = re.search(r"book-info/(\d+)|information\?id=(\d+)",
+                                  str(page.url() or ""))
+                if m_url:
+                    book_id = m_url.group(1) or m_url.group(2)
+            except Exception:
+                pass
             ledger.record(plat, "create_book", task_id=task_id, title=book_name,
-                          ok=True, shot=str(ledger.shot_path(plat, task_id, "")))
-            # book_id 拿不到（DOM 深链未知）：先用书名登记，发章按书名找书
-            ledger.save_book(task_id, plat, {"book_id": "", "title": book_name})
+                          book_id=book_id, ok=True,
+                          error="\n".join(logs)[:2000],
+                          shot=str(ledger.shot_path(plat, task_id, "")))
+            ledger.save_book(task_id, plat, {"book_id": book_id, "title": book_name})
             _set(plat, status="connected", error="")
         except Exception as e:
             _set(plat, status="error", error="建书失败：%s" % e)
@@ -345,14 +357,16 @@ def create_book_async(task_id, plat, auto_submit=False):
     return True, ""
 
 
-def _with_tag_steps(steps, groups, values):
+def _with_tag_steps(steps, groups, values, mod=None):
     """标签走数据驱动：清单进 values["_tags"]（[组名, 标签] 对），由 flow 的
-    "tags" 步骤按组切换点选。组显示名映射来自平台模块 TAG_GROUP_LABELS
-    （缺省平台无映射时退化为纯标签）。兼容旧流程表（无 tags 步骤时插桩）。"""
-    from . import qimao as _qm
+    "tags" 步骤按组切换点选。组显示名映射来自**对应平台模块**的
+    TAG_GROUP_LABELS（曾硬编码 qimao——番茄任务 key 撞名被套上七猫组名，
+    插桩 text 变 list repr）。兼容旧流程表（无 tags 步骤时插桩）；流程表
+    已用 {tag_x} 占位（番茄式 click_real）时不插桩——占位由 values 自答。"""
     flat = []
+    labels = getattr(mod, "TAG_GROUP_LABELS", {}) if mod else {}
     for key, tags in groups or []:
-        grp = getattr(_qm, "TAG_GROUP_LABELS", {}).get(key, "")
+        grp = labels.get(key, "")
         flat.extend([grp, str(t)] if grp and str(t).strip() else str(t)
                     for t in tags if str(t).strip())
     if not flat:
@@ -360,6 +374,8 @@ def _with_tag_steps(steps, groups, values):
     if any(st.get("do") == "tags" for st in steps):
         values["_tags"] = flat
         return steps
+    if any("{tag_" in str(st.get("text") or "") for st in steps if st.get("text")):
+        return steps                  # 流程表自带标签占位（番茄式）：values 已就绪
     tag_steps = [{"do": "click_text", "text": str(t), "contains": False,
                   "scope": "[class*=tag] li,span,label,[class*=label]"}
                  for t in flat]

package/app/core/publish/qimao.py

@@ -77,13 +77,28 @@ TAG_GROUP_LABELS = {"tags_style": "风格", "tags_role": "角色",
 
 
 def values_create_book(meta):
+    from .. import bookmeta_catalog as cat
+    target_reader = (meta.get("target_reader") or "").strip()
+    category_main = (meta.get("category_main") or "").strip()
+    category_sub = (meta.get("category_sub") or "").strip()
+    # 旧数据兜底：二级有值但一级空/与二级不自洽（如女生专属的「现实故事」
+    # 配了男生频道）会让一级 click_text 静默跳过、死在流程中段——按官方
+    # 目录跨频道反查对齐，频道与一级跟着二级走
+    if category_sub and not (category_main and
+                             category_sub in (cat.QIMAO_CATS.get(target_reader)
+                                              or {}).get(category_main, [])):
+        loc = cat.qimao_locate_sub(category_sub)
+        if loc:
+            target_reader, category_main = loc
+        else:
+            category_sub = ""
     return {
         "title": (meta.get("book_name") or "").strip(),
         "summary": (meta.get("summary") or "").strip(),
         "protagonist": (meta.get("protagonist_1") or "").strip(),
-        "target_reader": (meta.get("target_reader") or "").strip(),
-        "category_main": (meta.get("category_main") or "").strip(),
-        "category_sub": (meta.get("category_sub") or "").strip(),
+        "target_reader": target_reader,
+        "category_main": category_main,
+        "category_sub": category_sub,
         "status": (meta.get("status") or "连载中").strip(),
     }
 

package/app/core/runner.py

@@ -90,8 +90,12 @@ def _npm_shim_bypass(argv):
 
 
 def _kill_tree(pid):
-    """杀整棵进程树。Windows 用 taskkill /T；POSIX 靠 spawn 时的
-    start_new_session（子进程自成一个进程组，pgid==pid）用 killpg 连孙带杀。"""
+    """杀整棵进程树。Windows：先 TerminateProcess 直接杀根进程（毫秒级，绝不
+    挂），再 taskkill /T 兜底扫子孙（短等待，卡死即放弃——真实案例 2026-09-19：
+    某些机器状态下 taskkill /F /T 对普通进程也挂死 30s+，等满 15s 超时会让每次
+    超时杀进程都卡 20s，看门狗/超时全被拖死；漏杀的孙进程由启动孤儿清扫兜底）。
+    POSIX 靠 spawn 时的 start_new_session（子进程自成一个进程组，pgid==pid）
+    用 killpg 连孙带杀。"""
     if os.name != "nt":
         try:
             os.killpg(pid, signal.SIGKILL)
@@ -103,10 +107,21 @@ def _kill_tree(pid):
         except Exception:
             pass
         return
+    # Windows 没有 signal.SIGKILL（直接引用会 AttributeError）；os.kill 带任意
+    # 信号值都走 TerminateProcess，用 SIGTERM
     try:
-        subprocess.run(
+        os.kill(pid, signal.SIGTERM)   # Windows 语义 = TerminateProcess，只杀根进程
+    except OSError:
+        pass                           # 根进程可能已被 taskkill 抢先杀掉
+    except Exception:
+        pass
+    try:
+        tk = subprocess.Popen(
             ["taskkill", "/F", "/T", "/PID", str(pid)],
-            capture_output=True, creationflags=CREATE_NO_WINDOW, timeout=15)
+            stdin=subprocess.DEVNULL, stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL, close_fds=True,   # 不继承被杀进程的管道句柄，否则 EOF 永不来、drain 烧满超时
+            creationflags=CREATE_NO_WINDOW)
+        tk.wait(timeout=1.2)           # 健康机器 <1s；卡死就不再陪等（后台自行结束）
     except Exception:
         pass
 

package/app/core/settings.py

@@ -18,7 +18,7 @@ _FILE = paths.DATA_DIR / "settings.json"
 # 成功发章上限、平台连续失败几次后暂停自动发布（publish/auto.py 读取）
 DEFAULTS = {"max_concurrent_jobs": 6, "default_workdir": "", "hooks_token": "",
             "telemetry_errors": True, "publish_daily_cap": 10,
-            "publish_fail_streak": 3, "notify_webhook": ""}
+            "publish_fail_streak": 3, "notify_webhook": "", "notify_base_url": ""}
 # 并发上限 12：worker 只是拉起 CLI 子进程的调度位，跨任务无共享资源；
 # 同任务单飞守卫在 jobs 层。默认 6 对齐「多任务并行不排队」的使用预期。
 MIN_WORKERS, MAX_WORKERS = 1, 12
@@ -101,6 +101,8 @@ def save(patch):
                 return cur, "publish_fail_streak 必须是 1-10 的整数"
         if "notify_webhook" in patch:
             cur["notify_webhook"] = str(patch.get("notify_webhook") or "").strip()[:300]
+        if "notify_base_url" in patch:
+            cur["notify_base_url"] = str(patch.get("notify_base_url") or "").strip()[:200]
         _FILE.parent.mkdir(parents=True, exist_ok=True)
         tmp = _FILE.with_suffix(".tmp")
         tmp.write_text(json.dumps(cur, ensure_ascii=False, indent=2), encoding="utf-8")

package/app/core/share_page.py

@@ -0,0 +1,111 @@
+# -*- coding: utf-8 -*-
+"""可分享报告页（借鉴 agency-orchestrator 的 ao report）：把 run 成果渲染成
+自包含单文件 HTML——零 JS、内联样式、离线可看，直接发群/发人。
+
+纯函数无网络；数据全部来自调用方（store/paths 已读好的对象）。
+"""
+from __future__ import annotations
+
+import html as _html
+import time
+
+
+def _esc(s):
+    return _html.escape(str(s if s is not None else ""), quote=True)
+
+
+def _md_ish(text):
+    """极简 Markdown 呈现：标题/列表/粗体/代码，够报告阅读即可，不做完整解析。"""
+    out = []
+    for ln in (text or "").splitlines():
+        e = _esc(ln)
+        if ln.startswith("# "):
+            out.append("<h1>%s</h1>" % e[2:])
+        elif ln.startswith("## "):
+            out.append("<h2>%s</h2>" % e[3:])
+        elif ln.startswith("### "):
+            out.append("<h3>%s</h3>" % e[4:])
+        elif ln.startswith("- "):
+            out.append("<li>%s</li>" % e[2:])
+        else:
+            out.append("<p>%s</p>" % e)
+    return "\n".join(out)
+
+
+_SHARE_TPL = """<!DOCTYPE html>
+<html lang="zh"><head><meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>__TITLE__ · CodeBee 任务报告</title>
+<style>
+body{margin:0;background:#f5f6f8;color:#1c2330;font:15px/1.65 -apple-system,"PingFang SC","Microsoft YaHei",sans-serif}
+.wrap{max-width:760px;margin:0 auto;padding:28px 18px 60px}
+.head{border-bottom:3px solid #2b6cb0;padding-bottom:14px;margin-bottom:22px}
+h1{margin:0 0 6px;font-size:24px}
+.meta{color:#5a6472;font-size:13px}
+.badge{display:inline-block;border-radius:999px;padding:2px 12px;font-size:13px;font-weight:600}
+.badge.ok{background:#e6f6ec;color:#177245}.badge.bad{background:#fdeaea;color:#b42318}
+.badge.off{background:#eef0f3;color:#5a6472}
+.card{background:#fff;border:1px solid #e3e6ea;border-radius:12px;padding:18px 20px;margin-bottom:18px}
+.card h2{font-size:16px;margin:0 0 12px;color:#2b6cb0}
+table{border-collapse:collapse;width:100%}
+td{padding:6px 10px;border-bottom:1px solid #eef0f3}
+tr.sum td{font-weight:700;border-top:2px solid #e3e6ea}
+.step{display:flex;gap:10px;padding:7px 0;border-bottom:1px dashed #eef0f3;font-size:13.5px;align-items:baseline}
+.step .n{color:#8a93a0;font-weight:700}.step .role{font-weight:600;min-width:88px}
+.step .who{color:#5a6472;min-width:90px}.step .sum{flex:1}.st{font-size:12px}
+.st.done{color:#177245}.st.failed{color:#b42318}
+h1,h2,h3{margin:14px 0 8px}li{margin:4px 0}.trow{padding:2px 0;border-bottom:1px dotted #eee}
+p{margin:8px 0}.mut{color:#8a93a0}code{background:#f0f2f5;padding:1px 6px;border-radius:4px}
+pre{background:#f0f2f5;padding:12px;border-radius:8px;overflow-x:auto;white-space:pre-wrap}
+</style></head><body><div class="wrap">
+<div class="head"><h1>__TITLE__</h1>
+<div class="meta">__META__ · __ST__ · CodeBee 生成于 __NOW__</div></div>
+<div class="card"><h2>结果</h2><span class="badge __STCLS__">__ST__</span>__OVERALL__</div>
+<div class="card"><h2>步骤</h2>__STEPS__</div>
+<div class="card"><h2>报告</h2>__REPORT__</div>
+<div class="meta">由 <b>CodeBee</b> 多智能体编排台生成</div>
+</div></body></html>"""
+
+
+def render_share_html(run, task, report_text):
+    """渲染自包含分享页。run/task/report_text 缺失时优雅降级。"""
+    run = run or {}
+    task = task or {}
+    status = str(run.get("status") or "")
+    st_label = {"done": "已完成", "failed": "失败", "cancelled": "已取消",
+                "running": "进行中"}.get(status, status)
+    st_cls = {"done": "ok", "failed": "bad", "cancelled": "off"}.get(status, "off")
+    verdict = run.get("verdict") or {}
+    means = verdict.get("scores") or {}
+
+    score_rows = ""
+    for d, v in means.items():
+        score_rows += "<tr><td>%s</td><td>%.1f</td></tr>" % (_esc(d), float(v))
+    if verdict:
+        score_rows += ('<tr class="sum"><td>综合</td>'
+                       '<td>%.1f</td></tr>' % float(verdict.get("overall") or 0))
+
+    steps_rows = ""
+    for s in run.get("steps") or []:
+        steps_rows += (
+            '<div class="step"><span class="n">%02d</span>'
+            '<span class="role">%s</span><span class="who">%s</span>'
+            '<span class="sum">%s</span><span class="st %s">%s</span></div>'
+            % (s.get("n") or 0, _esc(s.get("role") or ""),
+               _esc(s.get("agent_label") or s.get("agent") or ""),
+               _esc((s.get("summary") or "")[:220]), _esc(s.get("status") or ""),
+               _esc(s.get("status") or "")))
+
+    report_html = _md_ish(report_text) if report_text else "<p class='mut'>（暂无报告）</p>"
+    overall_note = ("综合 %.1f 分" % float(verdict.get("overall"))
+                    if verdict.get("overall") is not None else "")
+
+    return (_SHARE_TPL
+            .replace("__TITLE__", _esc(task.get("title") or run.get("title") or "任务报告"))
+            .replace("__META__", _esc(task.get("goal") or ""))
+            .replace("__ST__", _esc(st_label))
+            .replace("__STCLS__", st_cls)
+            .replace("__NOW__", _esc(time.strftime("%Y-%m-%d %H:%M")))
+            .replace("__OVERALL__", _esc(overall_note))
+            .replace("__STEPS__", steps_rows or "<p class='mut'>（无步骤）</p>")
+            .replace("__REPORT__", report_html))

package/app/core/telemetry.py

@@ -29,7 +29,7 @@ import time
 import urllib.request
 import zipfile
 
-from . import errorlog, paths, settings
+from . import errorlog, paths, settings, tlsctx
 
 # 端点：部署后把 CloudBase HTTP 函数 URL 填到这里（见 cloudfunctions/telemetry-collect/）
 ENDPOINT = os.environ.get("TUTTI_TELEMETRY_URL", "").strip()
@@ -107,7 +107,8 @@ def _post(url, payload):
             headers={"Content-Type": "application/json",
                      "User-Agent": "CodeBee-Telemetry/1"},
             method="POST")
-        with urllib.request.urlopen(req, timeout=TIMEOUT_S) as resp:
+        with urllib.request.urlopen(req, timeout=TIMEOUT_S,
+                                    context=tlsctx.context()) as resp:
             return int(resp.status or 0)
     except Exception:
         return 0

package/app/core/tlsctx.py

@@ -46,3 +46,19 @@ def context():
     if _CTX is None:
         _CTX = _build()
     return _CTX
+
+
+def humanize(err_text):
+    """证书验证失败 → 可行动的人话提示（非证书类错误原样返回）。
+
+    兜底 CA 仍验证失败只剩两类真实原因：本机代理对 HTTPS 做 TLS 拦截
+    （其根证书只在系统钥匙串/浏览器里，Python 的静态 CA 束不认），或极端
+    环境连 /etc/ssl/cert.pem 都没有。SSL_CERT_FILE 是 OpenSSL 标准逃生门，
+    create_default_context() 本就吃它，无需额外代码。"""
+    text = str(err_text or "")
+    if "CERTIFICATE_VERIFY_FAILED" not in text:
+        return text
+    return (text + " —— 证书验证仍失败：① 若开着代理/安全软件且开启了 HTTPS 拦截，"
+            "关掉拦截，或把其根证书导出后设环境变量 SSL_CERT_FILE 指向它再启动；"
+            "② 确认系统存在 /etc/ssl/cert.pem；③ 刚升级过 CodeBee 的话，"
+            "旧服务进程可能还在跑——关掉终端窗口重开")