codebee 0.1.14 → 0.1.16

package/app/core/notify.py

@@ -71,7 +71,10 @@ def push_run_async(run_id):
 
 
 def push_run(run_id):
-    """组装 run 结果摘要并推送（webhook 未配置时静默跳过）。"""
+    """组装 run 结果摘要并推送（webhook 未配置时静默跳过）。
+
+    摘要末尾附分享页路径（notify_base_url 设置非空时拼完整链接，否则只给
+    run_id 供在本机 CodeBee 界面查找）。"""
     hook = _webhook()
     if not hook:
         return False
@@ -90,6 +93,13 @@ def push_run(run_id):
     if v.get("overall") is not None:
         lines.append("综合评分 %.1f（%s）" % (
             float(v["overall"]), "达标" if v.get("publishable") else "未达标"))
+    try:
+        from .settings import load as _sload
+        base = str(_sload().get("notify_base_url") or "").strip().rstrip("/")
+        if base:
+            lines.append("📄 详情：%s/api/runs/%s/share" % (base, run_id))
+    except Exception:
+        pass
     return push_text("\n".join(lines))
 
 

package/app/core/paihang.py

@@ -1,10 +1,14 @@
 # -*- coding: utf-8 -*-
-"""扫榜选材：抓取七猫排行榜公开页，产出选题分析素材。
+"""扫榜选材：抓取公开排行榜页，产出选题分析素材。
 
-数据源：www.qimao.com/paihang/（公开可抓，2026-09-19 实测 200/106KB，
-书名与分类在 a 标签中文文本里）。下载走 curl 子进程（与 covergen 同款，
-Python 不经手响应体以外的东西），解析用宽松正则——页面结构变了宁可
-返回空（调用方回落普通直连提示词），不做脆弱的强解析。
+数据源（双源聚合，任一失败不影响另一源）：
+- 七猫：www.qimao.com/paihang/（公开可抓，2026-09-19 实测 200/106KB）
+- 番茄 Web 版：fanqienovel.com/rank（公开可抓，题材分类+书名在
+  中文 a 标签里；App 端接口有 SecuritySign/X-Argus 签名——那才是难路，
+  Web 版榜单页不需要签名，别走弯路）
+
+下载走 curl 子进程（与 covergen 同款），解析用宽松正则——页面结构变了
+宁可返回空（调用方回落普通直连提示词），不做脆弱的强解析。
 """
 from __future__ import annotations
 
@@ -13,31 +17,40 @@ import re
 
 log = logging.getLogger(__name__)
 
-RANK_URL = "https://www.qimao.com/paihang/"
+QIMAO_RANK_URL = "https://www.qimao.com/paihang/"
+FANQIE_RANK_URL = "https://fanqienovel.com/rank"
 _UA = ("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
        "(KHTML, like Gecko) Chrome/126 Safari/537.36")
 
-# 页面 UI 噪音词（非书目/分类）
+# 页面 UI 噪音词（非书目/分类）：页面 chrome、导航、tab 名、登录/搜索等
 _NOISE = {"加入书架", "立即阅读", "开始阅读", "免费阅读", "全部", "分类", "排行",
-          "排行榜", "完本", "连载中", "阅读", "书城", "男生", "女生"}
+          "排行榜", "完本", "连载中", "阅读", "书城", "男生", "女生",
+          "帮助中心", "作家助手", "客服", "登录", "注册", "立即登录",
+          "搜索", "热门作品排行", "大热榜", "新书榜", "完结榜", "收藏榜",
+          "更新榜", "日榜", "月榜", "蝉联", "榜首", "热度", "免费", "畅销",
+          "下载", "客户端", "首页", "我的", "设置", "更多", "返回", "关于"}
 
+_CJK_RE = re.compile(r">([\u4e00-\u9fa5]{2,12})<")
 
-def fetch_rank_items(limit=40):
-    """抓七猫排行榜页并提取中文元素材（书名/分类混排，去 UI 噪音）。
 
-    返回元素列表（保序去重，最多 limit 个）；抓取失败返回 []——调用方
-    回落普通直连提示词，扫榜永远不挡任务。"""
+def _curl_text(url):
+    """curl 子进程抓页面文本；失败返回空串。"""
     from . import runner
     try:
         r = runner.run_process(
-            argv=["curl", "-sS", "--max-time", "20", "-A", _UA, RANK_URL],
+            argv=["curl", "-sS", "--max-time", "20", "-A", _UA, url],
             timeout=30)
     except Exception:
-        return []
+        return ""
     if not r.get("ok"):
-        return []
+        return ""
+    return r.get("stdout") or ""
+
+
+def _extract_cjk(html, limit):
+    """从 HTML 提取中文元素材（去 UI 噪音、保序去重）。"""
     items, seen = [], set()
-    for t in re.findall(r">([\u4e00-\u9fa5]{2,12})<", r.get("stdout") or ""):
+    for t in _CJK_RE.findall(html or ""):
         if t in _NOISE or t in seen:
             continue
         seen.add(t)
@@ -47,18 +60,49 @@ def fetch_rank_items(limit=40):
     return items
 
 
+def fetch_qimao_rank(limit=30):
+    """七猫排行榜：返回元素列表，抓取失败返回 []。"""
+    return _extract_cjk(_curl_text(QIMAO_RANK_URL), limit)
+
+
+def fetch_fanqie_rank(limit=30):
+    """番茄 Web 版榜单：返回元素列表，抓取失败返回 []。"""
+    return _extract_cjk(_curl_text(FANQIE_RANK_URL), limit)
+
+
+def fetch_rank_items(limit=40):
+    """双源聚合：七猫+番茄各抓一份（去重合并，七猫在前）。
+
+    两源都失败才返回 []——单源挂了另一源仍可用，扫榜永不因单点挡任务。"""
+    qm = fetch_qimao_rank(limit)
+    fq = fetch_fanqie_rank(limit)
+    merged, seen = [], set(qm)
+    for t in fq:
+        if t not in seen:
+            seen.add(t)
+            merged.append(t)
+    return qm + merged
+
+
 def rank_scan_prompt(goal):
-    """组装扫榜选材分析提示词。榜单抓取失败返回 None（调用方回落直连提示词）。"""
-    items = fetch_rank_items()
-    if not items:
+    """组装扫榜选材分析提示词。双源都空返回 None（调用方回落直连提示词）。"""
+    qm = fetch_qimao_rank(30)
+    fq = fetch_fanqie_rank(30)
+    qm = [t for t in qm if t not in fq]   # 双源重合的只留七猫份
+    if not qm and not fq:
         return None
-    material = "、".join(items)
+    blocks = []
+    if qm:
+        blocks.append("### 七猫排行榜素材\n" + "、".join(qm))
+    if fq:
+        blocks.append("### 番茄排行榜素材\n" + "、".join(fq))
+    material = "\n\n".join(blocks)
     return (
-        "你是网文选题分析师。以下是刚刚抓取的七猫排行榜页面的书目与分类素材：\n\n"
+        "你是网文选题分析师。以下是刚刚抓取的两个平台排行榜页面的书目与分类素材：\n\n"
         "## 榜单元素材\n%s\n\n"
         "## 用户想写的方向\n%s\n\n"
         "## 你的产出（Markdown 报告）\n"
-        "1. **热门题材 Top3**：各自的共同特征与上榜代表书目\n"
+        "1. **热门题材 Top3**：各自的共同特征与上榜代表书目（跨平台重合的题材单独点出——双平台都热说明是真风口）\n"
         "2. **高频人设/套路总结**：3-5 条，点名反复出现的元素\n"
         "3. **差异化切入建议**：2-3 个，结合用户方向给出「题材+人设」组合与一句话理由\n"
         "直接输出分析报告，不要复述素材清单，不要输出与报告无关的内容。"

package/app/core/pipeline.py

@@ -1485,6 +1485,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:
@@ -1780,6 +1823,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
@@ -1929,10 +1985,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,
@@ -2188,6 +2245,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))

package/app/core/publish/browser.py

@@ -78,6 +78,39 @@ def _free_port():
     return port
 
 
+def _debug_ports_for_profile(user_data_dir):
+    """扫描本机浏览器进程命令行，返回使用该 profile 的主实例的调试端口。
+
+    跨平台：Windows 走 wmic（PS 启动太慢），POSIX 走 ps。只认主进程
+    （--type= 子进程没有调试端口）。路径按小写+正反斜杠归一后比对。"""
+    import subprocess as _sp
+    try:
+        if sys.platform == "win32":
+            out = _sp.check_output(
+                ["wmic", "process", "where", "Name='msedge.exe'", "get", "CommandLine"],
+                stderr=_sp.DEVNULL, timeout=12).decode("utf-8", "replace")
+            lines = out.splitlines()
+        else:
+            out = _sp.check_output(["ps", "-axo", "command"], timeout=12).decode()
+            lines = [l for l in out.splitlines()
+                     if "msedge" in l or "chrome" in l or "chromium" in l]
+    except Exception:
+        return []
+    key = str(user_data_dir).replace("\\", "/").strip("/").lower()
+    ports = []
+    for ln in lines:
+        ln = ln.strip()
+        if not ln or "--type=" in ln or "--remote-debugging-port=" not in ln:
+            continue
+        norm = ln.replace("\\\\", "/").replace("\\", "/").lower()
+        if key not in norm:
+            continue
+        m = re.search(r"--remote-debugging-port=(\d+)", ln)
+        if m:
+            ports.append(int(m.group(1)))
+    return ports
+
+
 class Browser:
     """一个浏览器子进程（一个 profile 一个实例）+ 它的调试端口。"""
 
@@ -106,7 +139,24 @@ class Browser:
         except OSError as e:
             raise BrowserError("浏览器启动失败：%s" % e)
         if not self._wait_ready(15.0):
-            raise BrowserError("浏览器调试端口 15 秒内没就绪（可能被安全软件拦截）")
+            # 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 秒内没就绪：该平台可能已有浏览器实例在跑但"
+                "端口探测不到——关掉它的所有窗口后重试，或重启电脑后首次连接")
 
     # ------------------------------------------------------------ 生命周期
     def _wait_ready(self, timeout):
@@ -404,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"),
     }
 
 
@@ -96,3 +110,19 @@ def tag_groups(meta):
         if isinstance(v, list) and v:
             out.append((key, [str(x) for x in v]))
     return out
+
+
+def editor_url(book):
+    """章节编辑器直达（真机实测）：/main/writer/<book_id>/publish/。"""
+    bid = str((book or {}).get("book_id") or "")
+    if bid:
+        return "https://fanqienovel.com/main/writer/%s/publish/" % bid
+    return CONFIG["home"]
+
+
+def chapter_manage_url(book):
+    """章节管理页（上线验证用）。"""
+    bid = str((book or {}).get("book_id") or "")
+    if bid:
+        return "https://fanqienovel.com/main/writer/chapter-manage/" + bid
+    return CONFIG["home"] + "book-manage"

package/app/core/publish/flow.py

@@ -109,7 +109,8 @@ def run_flow(page, steps, values=None, config=None, auto_submit=False,
                 for k, v in (values or {}).items():   # editor_url/draft_url 等任务级占位
                     url = url.replace("{%s}" % k, str(v))
                 note(i, "打开 %s" % url)
-                page.navigate(url)
+                # 重页（编辑器/管理列表）可按步放宽；缺省 45s（30s 对慢网偏紧）
+                page.navigate(url, timeout=float(st.get("timeout") or 45))
             elif act == "wait":
                 note(i, "等待 %s" % st["sel"])
                 page.wait_for(st["sel"], timeout=float(st.get("timeout") or 12))
@@ -145,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:
@@ -153,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)
@@ -194,6 +199,27 @@ def run_flow(page, steps, values=None, config=None, auto_submit=False,
                     time.sleep(0.9)
                 if not (r or {}).get("ok"):
                     raise FlowError((r or {}).get("err") or "click_in 失败")
+            elif act == "click_arrow":
+                # 展开下拉按钮组（番茄「下一步▾」）：点目标按钮组右缘 10px
+                note(i, "展开下拉箭头")
+                r = page.call(
+                    "(t)=>{"
+                    "const vis=e=>e.getBoundingClientRect().width>0;"
+                    "const btn=[...document.querySelectorAll('button')].find(e=>"
+                    "vis(e)&&(e.innerText||'').trim().includes(t));"
+                    "if(!btn)return{ok:false,err:'按钮未找到'};"
+                    "const host=btn.closest('[class*=group],[class*=dropdown]')||btn.parentElement;"
+                    "const r=host.getBoundingClientRect();"
+                    "return{ok:true,x:Math.round(r.x+r.width-10),y:Math.round(r.y+r.height/2)};}", str(st.get("target") or "下一步"))
+                if not (r or {}).get("ok"):
+                    raise FlowError((r or {}).get("err") or "箭头定位失败")
+                page.send("Input.dispatchMouseEvent",
+                          {"type": "mousePressed", "x": r["x"], "y": r["y"],
+                           "button": "left", "clickCount": 1}, timeout=8.0)
+                page.send("Input.dispatchMouseEvent",
+                          {"type": "mouseReleased", "x": r["x"], "y": r["y"],
+                           "button": "left", "clickCount": 1}, timeout=8.0)
+                time.sleep(float(st.get("settle") or 1.2))
             elif act == "click_match":
                 # 关键词选块（站点卡片等）：点同时包含所有关键词的最小元素
                 keys = [str(x) for x in (st.get("any") or []) if str(x).strip()]
@@ -312,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 占位。