codebee 0.1.15 → 0.1.17

package/app/core/pipeline.py

@@ -82,6 +82,9 @@ def _agents():
 # 本轮运行的智能体池：execute_run 入口快照，_run_step 死链补位时扫描。
 # 直接调 _run_step 的场景（单测/内部工具）池为空 → 补位不触发，闸门语义不变。
 _CURRENT_AGENTS: list = []
+# 本次 run 的任务宪章注入块（execute_run 起跑时从 .codebee/constitution.md 读入；
+# 步骤函数在各提示词组装点引用，空串=未配置零噪音）
+_RUN_CONSTITUTION = ""
 
 
 def _dead_binding_substitute(dead_id, resume=None):
@@ -660,6 +663,11 @@ CODE_REVIEW_PROMPT = """你是代码评审员（不要修改任何文件）。
   "summary": "一句话结论"
 }
 
+## 评审要求（findings 锚定证据）
+每个 issue 的 detail 必须给出「文件名:行号」（从 diff 的 hunk 头 @@ -a,b +c,d @@ 与上下文推算），
+并引用该处一行关键代码作为依据——没有证据定位的问题不要报，宁可少报不报猜测。
+（借鉴 pr-af：findings grounded in code evidence 是评审可信度的根。）
+
 ## 任务目标
 __GOAL__
 
@@ -792,7 +800,7 @@ def _code_bestof(run, task, impl, difficulty, ev):
             agt_b = modelhub.bind_agent(impl, difficulty)
             res = None
             for i, sub in enumerate(subtasks):
-                prompt = (CODE_IMPL_PROMPT
+                prompt = (_RUN_CONSTITUTION + CODE_IMPL_PROMPT
                           .replace("__GOAL__", task["goal"])
                           .replace("__SUBTASK__", sub["detail"] if sub["detail"] else sub["title"])
                           .replace("__CONTEXT__", task.get("context") or "（无）")
@@ -941,7 +949,7 @@ def _run_code(run, task, agents, ev, stats, mode):
                         (s.get("title") or "")[:40] for s in subtasks[:i]) or "（无）"
                     prog = ("\n\n## 计划进度（第 %d/%d 项）\n已完成：%s。当前接着做下面这一项，"
                             "不要重做已完成的。" % (i + 1, len(subtasks), done_titles))
-                prompt = (CODE_IMPL_PROMPT
+                prompt = (_RUN_CONSTITUTION + CODE_IMPL_PROMPT
                           .replace("__GOAL__", task["goal"])
                           .replace("__SUBTASK__",
                                    sub["detail"] if sub["detail"] else sub["title"])
@@ -1396,10 +1404,25 @@ __GOAL__
 ## 背景与上下文
 __CONTEXT__
 
+## 评审维度（写前自查）
+__RUBRIC__
+（按这些维度组织内容重点——评审会按它们打分）
+
 ## 要求
 - 只修改 `__FILE__` 这一个文件；保持 Markdown 结构。
 - 完成后用 3 句话说明本轮写了什么。"""
 
+# 调研报告类稿件的追加要求（借鉴 gpt-researcher 迭代深研）：有网络/读文件工具时
+# 多源交叉验证，单源结论降权——调研的可信度来自证据链而非文采
+RESEARCH_APPENDIX = """
+
+## 调研要求（证据链）
+- 有联网/检索工具就先搜集资料再写：同一关键结论至少两个独立来源交叉验证，
+  单源信息要标注「仅单一来源」。
+- 引用来源在文中用行内链接或脚注标明（域名即可，不编造 URL）。
+- 区分「事实」与「观点」：数据/时间/版本号给来源，预测/评价标明是分析。
+- 结构建议：结论先行 → 分层论证 → 风险与局限（说明哪些结论证据不足）。"""
+
 NOVEL_REVISE_PROMPT = """你是一名专业作者。请根据下方汇总评审意见修订稿件文件：`__FILE__`（直接写入该文件）。文件必须以 UTF-8 编码保存（PowerShell 写文件显式加 -Encoding UTF8，禁止依赖默认编码）。
 
 ## 原始写作任务
@@ -1465,13 +1488,19 @@ def _story_bible(workdir):
     if not txt:
         return ""
     return ("## 故事圣经（story-bible.md：人物/世界观/伏笔台账，本书一切写作与评审以此为准，"
-            "与其冲突处以圣经为准）\n\n" + txt)
+            "与其冲突处以圣经为准）\n\n"
+            "**连续性锁**（借鉴 drama-skills）：人物外貌/性格口头禅/物品/能力等需要跨章一致"
+            "的设定，写作时原样沿用圣经中的表述（可整句贴入正文），不要同义改写——每章用词"
+            "一致读者才不会出戏。\n\n" + txt)
 
 
 def _plot_modules(workdir):
     """剧情模块库（oh-story 拆文沉淀式）：工作目录里的 plot-modules.md
     （可复用的桥段/冲突/爽点/名场面素材模块），作者手工维护，每章起草与
     评审前自动注入。不存在/为空返回 ""——约定式功能，零配置零噪音。"""
+    p = os.path.abspath(os.path.join(str(workdir or ""), MODULES_FILE))
+    if not _inside(workdir, p) or not os.path.isfile(p):
+        return ""
     try:
         txt = _read_text_any_enc(p)[:_MODULES_MAX_CHARS].strip()
     except OSError:
@@ -1482,6 +1511,49 @@ def _plot_modules(workdir):
             "鼓励化用，不要照抄原句）\n\n" + txt)
 
 
+def _shrink_context_block(sk_block, bible, budget=12000):
+    """分层上下文降级（长提示词在容量受限通道上会挂起/秒拒，2026-09-17 讯飞实测）。
+
+    四层优先级：故事圣经（最高，设定冲突以它为准）> 剧情模块库 > 经验库 > 大纲/前情
+    （后两者在提示词正文里，永不动）。超预算时按优先级保序截断：
+    - 圣经截断保整段（按二级标题边界，无边界才硬截）
+    - 模块库截断保整模块（按「## 」标题边界）
+    - 经验库直接硬截（条目本身短，损失最小）
+    返回 (新 sk_block, 降级说明)。无降级返回原样。"""
+    total = len(sk_block or "") + len(bible or "")
+    if total <= budget:
+        return sk_block, bible, ""
+    notes = []
+    # 1) 先压经验库到 4K（条目短、损失最小）
+    if len(sk_block or "") > 4000:
+        sk_block = sk_block[:4000] + "\n\n（经验库已因上下文容量限制精简）"
+        notes.append("经验库→4K")
+        if len(sk_block) + len(bible or "") <= budget:
+            return sk_block, bible, "；".join(notes)
+    # 2) 模块库按模块边界截断
+    if bible and "## 剧情模块库" in bible:
+        head, sep, mods = bible.partition("## 剧情模块库")
+        mods = sep + mods
+        keep = mods[:6000]
+        cut = keep.rfind("\n## ")
+        if cut > 200:
+            keep = keep[:cut]
+        bible = head + keep + "\n\n（模块库已因上下文容量限制精简）"
+        notes.append("模块库→边界截断")
+        if len(sk_block) + len(bible) <= budget:
+            return sk_block, bible, "；".join(notes)
+    # 3) 圣经按二级标题边界截断到预算
+    if bible:
+        budget_left = max(2000, budget - len(sk_block or ""))
+        keep = bible[:budget_left]
+        cut = keep.rfind("\n## ")
+        if cut > 500:
+            keep = keep[:cut]
+        bible = keep + "\n\n（圣经已因上下文容量限制精简）"
+        notes.append("圣经→边界截断")
+    return sk_block, bible, "；".join(notes)
+
+
 def _critic_lens(critics, agent):
     """该评审的专属视角；单评审/手动指定时不播种（无从轮换，也别稀释注意力）。"""
     try:
@@ -1687,6 +1759,10 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
     mods = _plot_modules(workdir)
     if mods:
         bible = (bible + "\n\n" + mods) if bible else mods
+    # 任务宪章（spec-kit constitution）：作者定的质量原则拼在注入块最前——
+    # 优先级最高的约束放最前面，写作者先读原则再读设定
+    if _RUN_CONSTITUTION:
+        bible = _RUN_CONSTITUTION + (bible or "")
 
 
     def crit_prompt_for(text, note=""):
@@ -1777,6 +1853,19 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
                 if t:
                     tails.append("（第 %d 章结尾）…%s" % (j, t[-260:].strip()))
             prev = "\n".join(tails) or "（无）"
+            # findings 中期记忆（借鉴 agentmemory 持久记忆）：此前各章的关键事实
+            # 追加在 .codebee/findings.md，注入时只取前一章之前的记录（当章发现
+            # 会在当章评审后追加进来）。300+ 章长篇的前情只看近 2 章不够，
+            # findings 填补中期记忆空洞。失败静默。
+            try:
+                fd_p = os.path.join(workdir, ".codebee", "findings.md")
+                if os.path.isfile(fd_p):
+                    fd_txt = _read_text_any_enc(fd_p)
+                    if fd_txt:
+                        # 截到 3000 字防无限膨胀；只在尾部追加时自动增长，注入头固定
+                        prev += "\n\n## 此前章节发现摘要\n" + fd_txt[:3000]
+            except Exception:
+                pass
 
         # 评审-修订（每章至多 1 轮修订）
         rounds_used = 1
@@ -1926,10 +2015,11 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
                         time.sleep(30 * draft_attempt)   # 30s / 60s 退避
                     if draft_attempt and len(prompt) > 12000 and sk_block and sk_block in prompt:
                         # 长提示词在容量受限通道（讯飞托管 35B 等）上会挂起/秒拒
-                        # ——降级重试：经验库块截到 4K 字，保留大纲/前情/本章要点
-                        # （2026-09-17 七猫实测：全量 30KB 对讯飞必挂）
-                        use_prompt = prompt.replace(
-                            sk_block, sk_block[:4000] + "\n\n（经验库已因通道容量限制精简）")
+                        # ——分层降级：经验库→4K、模块库按模块边界、圣经按二级标题
+                        # 边界，保大纲/前情/本章要点（2026-09-17 七猫实测：全量
+                        # 30KB 对讯飞必挂）
+                        sk2, bible2, _note = _shrink_context_block(sk_block, bible, budget=12000)
+                        use_prompt = prompt.replace(sk_block, sk2).replace(bible, bible2)
                     res = _run_step(run_id, "draft-c%d" % i, modelhub.bind_agent(impl, difficulty), use_prompt,
                                     step_wd, readonly=False, ev=ev, timeout=2400,
                                     resume=resume_ctx["session"] if resume_ctx else None,
@@ -2185,6 +2275,22 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
                                "words": _wc(_read_chapter(workdir, i))})
         # 每章即时持久化：长篇中断/超时后可断点续跑，不丢已完成章的分数
         store.update_run(run_id, chapter_scores=chapter_scores)
+        # findings 沉淀（借鉴 agentmemory 持久记忆）：章节标题+要点追加到
+        # .codebee/findings.md——后续章节起草时随圣经/模块库注入，弥补
+        # 前情提要只看近 2 章结尾的中期记忆空洞。失败静默。
+        try:
+            fd_p = os.path.join(workdir, ".codebee", "findings.md")
+            os.makedirs(os.path.dirname(fd_p), exist_ok=True)
+            header_needed = not os.path.isfile(fd_p)
+            with open(fd_p, "a", encoding="utf-8") as f:
+                if header_needed:
+                    f.write("# 章节发现（每章评审达标后自动追加，供后续章节参考）\n\n")
+                f.write("- 第%d章《%s》：%s（%d 字，%s）\n" % (
+                    i, ch["title"],
+                    ch.get("beats") or "按大纲推进", chapter_scores[-1]["words"],
+                    "%.1f 分" % means.get("情节", 0.0) if means else "无评分"))
+        except Exception:
+            pass
 
     # ---- 3) 全局一致性评审（覆盖 1..end 全书：续写批次必须连同旧章一起查一致性）
     full_text = "\n\n".join(_read_chapter(workdir, i) for i in range(1, end + 1))
@@ -2321,10 +2427,25 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
                     fixed.append(i)
             store.update_run(run_id, chapter_scores=chapter_scores)
             _check_cancel(ev)
+        if not fixed:
+            # 最弱章重改全部失败（供应商拥堵/流断等）→ 章稿没有任何变化，
+            # 继续跑全书重评只会白烧评审链，组长步骤一挂「工作中」就是几十
+            # 分钟（2026-09-19 实案：polish-c18/c11 双败后仍进全书重评，
+            # 单个评审 35 分钟，用户侧只见打磨 2/3 久卡不动）。直接收尾。
+            store.finish_step(run_id, pstep["n"], "failed",
+                              summary="重改未成功（%s 全部失败），本轮打磨中止；"
+                                      "已落盘章稿不受影响"
+                                      % "、".join("第 %d 章" % c["chapter"] for c in weak))
+            break
         # 重评全书一致性（同一评审闭包；本轮全挂则保留上一轮结论——评审链挂了
         # 不代表书变差，不能拿「无法评审」覆盖真实分数）
-        full_text = "\n\n".join(_read_chapter(workdir, i2) for i2 in range(1, end + 1))
-        gscored2, gmeans_acc2 = run_global_round(critics)
+        try:
+            full_text = "\n\n".join(_read_chapter(workdir, i2) for i2 in range(1, end + 1))
+            gscored2, gmeans_acc2 = run_global_round(critics)
+        except BaseException:
+            store.finish_step(run_id, pstep["n"], "failed",
+                              summary="打磨后全书重评异常中止，已落盘章稿不受影响")
+            raise
         if gscored2:
             global_means = {d: round(sum(xs) / len(xs), 1) for d, xs in gmeans_acc2.items()}
             global_pass = _all_ge(global_means, threshold)
@@ -2583,13 +2704,19 @@ def _run_content_review(run, task, agents, ev, stats, mode):
         except Exception:
             pass
     else:
+        is_research = task.get("type") == "research"
+
         def _draft_prompt_for(vfile):
             p = (_tpl(task, "draft_prompt", NOVEL_DRAFT_PROMPT).replace("__FILE__", vfile)
                  .replace("__GOAL__", task["goal"])
-                 .replace("__CONTEXT__", task.get("context") or "（无）"))
+                 .replace("__CONTEXT__", task.get("context") or "（无）")
+                 .replace("__RUBRIC__", "、".join(dims) if dims else "（按流程默认维度）"))
             if outline:
                 p += "\n\n## 编排者大纲（按要点组织稿件）\n" + \
                      "\n".join("- " + i for i in outline["items"])
+            if is_research:
+                # 调研报告追加证据链要求（gpt-researcher 借鉴）
+                p += RESEARCH_APPENDIX
             return p
 
         best_of = max(1, min(3, int(task.get("best_of") or 1)))
@@ -2795,6 +2922,23 @@ def _run_serial_qa(run, task, agents, ev):
                      error="答疑失败（执行/评审链不可用）——" + "；".join(errors[-3:]))
 
 
+def _read_constitution(workdir):
+    """任务宪章（借鉴 spec-kit constitution）：工作目录 .codebee/constitution.md
+    （作者手工维护的质量原则——代码规范/文风/测试要求）。存在且非空时返回注入块，
+    每次 run 的所有智能体提示词都会带上；否则返回 ""（零配置零噪音）。"""
+    p = os.path.abspath(os.path.join(str(workdir or ""), ".codebee", "constitution.md"))
+    if not _inside(workdir, p) or not os.path.isfile(p):
+        return ""
+    try:
+        txt = _read_text_any_enc(p)[:6000].strip()
+    except OSError:
+        return ""
+    if not txt:
+        return ""
+    return ("## 项目宪章（constitution.md：本项目一切产出的质量原则，优先级最高，"
+            "与其他要求冲突时以宪章为准）\n\n" + txt + "\n\n")
+
+
 def _write_task_spec(task, workdir):
     """任务规格落盘 .codebee/spec.md（借鉴 agent-orchestrator 的 .spec/PROMPT.md 与
     planning-with-files 的文件化计划）：任务定义随工作目录留存、随任务分支版本化，
@@ -2952,6 +3096,11 @@ def execute_run(run_id):
     # 任务规格文件化（借鉴 planning-with-files/agent-orchestrator）：任何任务都在
     # 工作目录留一份 .codebee/spec.md——原始意图可见、随任务分支版本化
     _write_task_spec(task, task["workdir"])
+    # 任务宪章（借鉴 spec-kit constitution）：工作目录 .codebee/constitution.md
+    # 是作者定下的质量原则（代码规范/文风/测试要求），每次 run 注入所有智能体
+    # 提示词——代码/文章/翻译全类型通用，一次定义持续生效。缺省零噪音。
+    global _RUN_CONSTITUTION
+    _RUN_CONSTITUTION = _read_constitution(task["workdir"])
     agents = _agents()
     global _CURRENT_AGENTS
     _CURRENT_AGENTS = agents

package/app/core/publish/browser.py

@@ -139,14 +139,21 @@ class Browser:
         except OSError as e:
             raise BrowserError("浏览器启动失败：%s" % e)
         if not self._wait_ready(15.0):
-            # Edge 对已有实例的 profile：新进程转交参数后秒退，调试端口是
-            # 老实例自己的（甚至自选的，真机实测指定 59852 实际跑 56394）。
-            # 等自己指定的端口必然超时——扫进程命令行找该 profile 的真端口接管。
+            # Edge 对已有实例的 profile：新进程转交参数后秒退（stdout 会打
+            # 「正在现有浏览器会话中打开」），调试端口是老实例自己的（甚至
+            # 自选的，真机实测指定 59852 实际跑 56394）。等自己指定的端口必然
+            # 超时——先扫进程命令行找该 profile 的真端口接管（含隐藏的后台
+            # 常驻实例：Edge「启动加速/后台运行」的进程锁着 profile 不可见）。
             for p in _debug_ports_for_profile(self.user_data_dir):
                 if p != self.port and port_alive(p, timeout=2.0):
                     self.port = p
                     self.proc = None         # 老实例不是本对象起的：close 不杀它
                     return
+            if self.proc.poll() == 0:
+                raise BrowserError(
+                    "浏览器把启动请求转给了已在运行的会话（该平台浏览器有隐藏的"
+                    "后台实例占着档案）——请在任务管理器结束所有 Edge 进程，"
+                    "或重启电脑后重试；登录态不受影响")
             raise BrowserError(
                 "浏览器调试端口 15 秒内没就绪：该平台可能已有浏览器实例在跑但"
                 "端口探测不到——关掉它的所有窗口后重试，或重启电脑后首次连接")
@@ -447,25 +454,32 @@ class Page:
             raise BrowserError("点击失败：%s" % ((r or {}).get("err") or sel))
         return True
 
-    def real_click_text(self, text, scope="", contains=True, exact_fallback=True):
+    def real_click_text(self, text, scope="", contains=True, exact_fallback=True,
+                        y_min=None, y_max=None):
         """按文本真实点击：JS 定位元素中心坐标 → CDP Input 派发鼠标事件序列。
 
         qm-btn 一类自定义按钮只认真实事件序列（mousedown/mouseup/focus），
         el.click() 对它们无效——建书「确认创建」/发章「立即发布」都栽在这。
+        y_min/y_max 限定元素纵向范围（区分同名 select、限制弹层内点击）。
         返回 {ok, tag?, via}；找不到元素返回 {ok: False, err}。"""
         r = self.call(
-            "(t,scope,c)=>{"
-            "const els=[...document.querySelectorAll(scope||'button,a,[role=button],span,li,[class*=btn]')];"
+            "(t,scope,c,y0,y1)=>{"
+            "const vis=e=>e.getBoundingClientRect().width>0;"
+            "const els=[...document.querySelectorAll(scope||'button,a,[role=button],span,li,[class*=btn]')].filter(vis);"
             "let cands=els.filter(e=>{const x=(e.innerText||'').trim();"
             "return x&&(c?x.includes(t):x===t);});"
             "if(!cands.length&&c){cands=els.filter(e=>(e.innerText||'').trim()===t);}"
+            "if(y0!==null)cands=cands.filter(e=>e.getBoundingClientRect().y>=y0);"
+            "if(y1!==null)cands=cands.filter(e=>e.getBoundingClientRect().y<=y1);"
             "if(!cands.length)return{ok:false,err:'nf'};"
             "cands.sort((a,b)=>((a.innerText||'').trim().length)-((b.innerText||'').trim().length));"
             "const el=cands[0];el.scrollIntoView({block:'center'});"
             "const rc=el.getBoundingClientRect();"
             "return{ok:true,x:Math.round(rc.x+rc.width/2),y:Math.round(rc.y+rc.height/2),"
             "tag:el.tagName,cls:(el.className||'').toString().slice(0,30)};}",
-            str(text), scope or "", bool(contains))
+            str(text), scope or "", bool(contains),
+            int(y_min) if y_min is not None else None,
+            int(y_max) if y_max is not None else None)
         if not (r or {}).get("ok"):
             return {"ok": False, "err": "页面上找不到文本为「%s」的可点元素" % text}
         x, y = r["x"], r["y"]

package/app/core/publish/fanqie.py

@@ -75,15 +75,29 @@ FLOWS = {"create_book": CREATE_BOOK, "upload_chapter": UPLOAD_CHAPTER,
          "check_login": CHECK_LOGIN, "probe_form": PROBE_FORM}
 
 
+def _first(meta, key):
+    v = meta.get(key)
+    return str(v[0]).strip() if isinstance(v, list) and v else str(v or "").strip()
+
+
 def values_create_book(meta):
-    """bookmeta 字段 → 建书表单值。标签/分类逐项点击由流程按 values.tags 展开
-    （manager 组装时把 tags 列表拍平成 click_text 步骤追加）。"""
+    """bookmeta 字段 → 建书表单值。标签弹层的分区点选用单值字段
+    （每组选 1 个最稳：番茄主题/角色/情节各≤2、内容组各有上限），
+    数组全量点选由 tag_groups 路径兼容。"""
     return {
         "title": (meta.get("book_name") or "").strip(),
         "summary": (meta.get("summary") or "").strip(),
         "protagonist": (meta.get("protagonist_1") or "").strip(),
+        "protagonist2": (meta.get("protagonist_2") or "").strip(),
         "signing_mode": (meta.get("signing_mode") or "连载模式").strip(),
         "category": (meta.get("category") or "").strip(),
+        "target_reader": (meta.get("target_reader") or "男频").strip(),
+        "tag_theme": _first(meta, "tags_theme"),
+        "tag_role": _first(meta, "tags_role"),
+        "tag_plot": _first(meta, "tags_plot"),
+        "tag_content_emotion": _first(meta, "content_emotion"),
+        "tag_content_character": _first(meta, "content_character"),
+        "tag_content_world": _first(meta, "content_world"),
     }
 
 

package/app/core/publish/flow.py

@@ -146,6 +146,8 @@ def run_flow(page, steps, values=None, config=None, auto_submit=False,
                 # 真实鼠标事件点击（CDP Input 派发）：qm-btn 等自定义按钮
                 # 只认真实事件序列，el.click() 无效。发布确认链全靠它。
                 text = str(st.get("text") or "")
+                for k, v in (values or {}).items():   # {target_reader} 等动态值
+                    text = text.replace("{%s}" % k, str(v))
                 for k, v in (values or {}).items():
                     text = text.replace("{%s}" % k, str(v))
                 if not text:
@@ -154,7 +156,9 @@ def run_flow(page, steps, values=None, config=None, auto_submit=False,
                 r = None
                 for _try in range(int(st.get("tries") or 25)):
                     r = page.real_click_text(text, st.get("scope") or
-                                             "a,button,[class*=btn]")
+                                             "a,button,[class*=btn]",
+                                             y_min=st.get("y_min"),
+                                             y_max=st.get("y_max"))
                     if (r or {}).get("ok"):
                         break
                     time.sleep(0.4)
@@ -334,6 +338,26 @@ def run_flow(page, steps, values=None, config=None, auto_submit=False,
                     note(i, "提交 %s" % st.get("sel") or "")
                     page.wait_for(st["sel"], timeout=8)
                     page.click(st["sel"])
+            elif act == "sleep":
+                # 固定等待（SPA 水合/动画缓冲）：比 wait 更钝但最可靠
+                time.sleep(float(st.get("s") or 1.0))
+                note(i, "等待 %.1fs" % float(st.get("s") or 1.0))
+            elif act == "wait_gone":
+                # 等元素消失（弹层关闭动画对齐）：连发点击被关闭动画的
+                # mask 吞掉是多层弹窗流程的经典竞态
+                sel = st["sel"]
+                note(i, "等待 %s 消失" % sel)
+                deadline = time.time() + float(st.get("timeout") or 10)
+                while time.time() < deadline:
+                    try:
+                        if not page.exists(sel, timeout=1.0):
+                            break
+                    except BrowserError:
+                        break
+                    time.sleep(0.4)
+                else:
+                    raise FlowError("等待 %s 消失超时" % sel)
+                note(i, "已消失")
             elif act == "verify":
                 # 上线验证：导航到验证页断言文本在场——防「流程完成但平台
                 # 静默未发布」的假成功（0 字草稿案）。url/any 支持 values 占位。