codebee 0.1.18 → 0.1.20

package/app/core/pipeline.py

@@ -310,7 +310,8 @@ def _wait_gate(run_id, ev):
             return
         if ev is not None and ev.is_set():
             return
-        time.sleep(1.0)
+        # ev.wait 睡等：取消置位即刻醒来，不必耗满 1s 轮询间隔
+        (ev.wait(1.0) if ev is not None else time.sleep(1.0))
 
 
 def _binding_dead_msg(agent):
@@ -501,6 +502,7 @@ def _spawn_step(session_run_id, role, agent, prompt, workdir, readonly, ev,
                     "error_code": ErrorCode.ENV_BLOCK, "sid": "",
                     "raw": {"exit_code": None}, "kind": agent.get("kind", "generic"),
                     "model": agent.get("model")}
+    usage_recorded = False
     if _compaction_enabled() and not resume:
         # Phase 2（1D）：撑爆 → 压缩 → 守门重试；同时把 usage 累进 token_meter（1C）
         session = _get_session(session_run_id)
@@ -510,6 +512,7 @@ def _spawn_step(session_run_id, role, agent, prompt, workdir, readonly, ev,
                            images=images, require_tools=require_tools)
 
         def _call(p, **kw):
+            nonlocal usage_recorded
             # 模型可见即已记录（§1A 不变量）：入参/出参先落 session 日志
             session.append("user_message", {"content": p, "role": role},
                            turn_id=str(step["n"]))
@@ -522,6 +525,7 @@ def _spawn_step(session_run_id, role, agent, prompt, workdir, readonly, ev,
                 from .token_meter import token_meter
                 token_meter.accumulate(session_run_id, r.get("usage"),
                                        model=r.get("model") or "")
+                usage_recorded = True
             except Exception:
                 pass
             return r
@@ -533,6 +537,15 @@ def _spawn_step(session_run_id, role, agent, prompt, workdir, readonly, ev,
         res = runner.run_agent(agent, prompt, workdir=workdir, readonly=readonly,
                                timeout=timeout, cancel_event=ev, log_path=str(log_abs),
                                resume=resume, images=images, require_tools=require_tools)
+    # 默认关闭压缩和 resume 都走直通分支，也必须把真实 usage 送进预算表；否则
+    # 下一步永远看到 used=0，max_tokens_per_run 只是一个无效设置。
+    if not usage_recorded:
+        try:
+            from .token_meter import token_meter
+            token_meter.accumulate(session_run_id, res.get("usage"),
+                                   model=res.get("model") or "")
+        except Exception:
+            pass
     return res
 
 
@@ -632,6 +645,7 @@ __GOAL__
 
 ## 本步指令
 __SUBTASK__
+__FILES__
 
 ## 背景与上下文
 __CONTEXT__
@@ -693,6 +707,16 @@ def _verify_hint(task):
     return ""
 
 
+def _files_hint(sub):
+    """计划锚定文件清单（OpenSpec explore 借鉴）：计划里带了 files 就明示改动面，
+    让实现者知道该动哪些文件、不必全盘摸索。无 files 时返回空串（旧计划兼容）。"""
+    files = (sub or {}).get("files")
+    if not isinstance(files, list) or not files:
+        return ""
+    return "\n- 本步涉及文件（计划已锚定，先读再改）：" + "、".join(
+        "`%s`" % str(f) for f in files[:10])
+
+
 def _run_verify(run_id, task, workdir, ev):
     """确定性验证。返回 (verify_pass, ran)。"""
     if not task.get("verify_command"):
@@ -803,6 +827,7 @@ def _code_bestof(run, task, impl, difficulty, ev):
                 prompt = (_RUN_CONSTITUTION + CODE_IMPL_PROMPT
                           .replace("__GOAL__", task["goal"])
                           .replace("__SUBTASK__", sub["detail"] if sub["detail"] else sub["title"])
+                          .replace("__FILES__", _files_hint(sub))
                           .replace("__CONTEXT__", task.get("context") or "（无）")
                           .replace("__VERIFY_HINT__", _verify_hint(task)))
                 res = _run_step(run_id, "race%d-impl" % k, agt_b, prompt, wt_path,
@@ -953,6 +978,7 @@ def _run_code(run, task, agents, ev, stats, mode):
                           .replace("__GOAL__", task["goal"])
                           .replace("__SUBTASK__",
                                    sub["detail"] if sub["detail"] else sub["title"])
+                          .replace("__FILES__", _files_hint(sub))
                           .replace("__CONTEXT__", task.get("context") or "（无）")
                           .replace("__VERIFY_HINT__", _verify_hint(task))) + prog
                 role = "implement" if len(subtasks) == 1 else "implement-%d/%d" % (i + 1, len(subtasks))
@@ -1396,7 +1422,7 @@ def _pick_reviewer_legacy(agents, impl):
 
 # ---------------------------------------------------------------- review 引擎（小说/文档/翻译/调研…通用）
 
-NOVEL_DRAFT_PROMPT = """你是一名专业作者。请在当前工作目录中撰写/修订稿件文件：`__FILE__`（直接写入该文件）。文件必须以 UTF-8 编码保存（PowerShell 写文件显式加 -Encoding UTF8，禁止依赖默认编码）。
+NOVEL_DRAFT_PROMPT = """你是__ROLE__。请在当前工作目录中撰写/修订稿件文件：`__FILE__`（直接写入该文件）。文件必须以 UTF-8 编码保存（PowerShell 写文件显式加 -Encoding UTF8，禁止依赖默认编码）。
 
 ## 写作任务
 __GOAL__
@@ -1412,6 +1438,69 @@ __RUBRIC__
 - 只修改 `__FILE__` 这一个文件；保持 Markdown 结构。
 - 完成后用 3 句话说明本轮写了什么。"""
 
+# review 引擎共用执行骨架，但交付物不能只靠 rubric 猜格式。每个内置类型给出
+# 最小成品契约，起草和修订都注入；自定义流程继续使用通用回退，避免强加结构。
+CONTENT_DELIVERY_CONTRACTS = {
+    "novel": ("小说作者", [
+        "遵守用户给定的题材、篇幅、视角和风格；未给出的核心设定不要擅自扩张。",
+        "用场景、行动和对话推进冲突，人物动机与前后因果保持一致。",
+    ]),
+    "article": ("平台内容主编", [
+        "标题、开头钩子、正文层级和结尾行动建议要适配目标平台与读者。",
+        "事实、数据和引语不得编造；缺少来源时明确标注待核实。",
+    ]),
+    "video_script": ("短视频编导", [
+        "按镜头或时间段写清画面、口播、字幕/音效与预计时长，前 3 秒给出钩子。",
+        "每个画面都应可实际拍摄或制作，结尾给出自然的互动或转化动作。",
+    ]),
+    "doc": ("技术文档编辑", [
+        "先明确读者、目的和前置条件，再按可执行步骤组织正文。",
+        "命令、参数、示例与限制必须一致；无法确认的内容明确标注。",
+    ]),
+    "translation": ("专业译者与审校", [
+        "忠实保留原文含义、语气、数字、专名、占位符、链接和 Markdown 结构，不增译或漏译。",
+        "术语译法全文一致；歧义或无法确认的专名保留原文并加简短译注。",
+    ]),
+    "research": ("研究分析师", [
+        "围绕决策问题组织证据、对比、结论与可执行建议，避免资料堆砌。",
+        "结论必须能回溯到来源；证据不足处明确写出不确定性和验证办法。",
+    ]),
+    "speech": ("演讲撰稿人", [
+        "按场合、听众和时长控制篇幅，使用适合现场说出的短句与自然转场。",
+        "开场建立关系，主体围绕一个核心信息展开，结尾给出清晰收束或号召。",
+    ]),
+    "weekly_report": ("业务汇报顾问", [
+        "按成果与影响、关键数据、问题阻塞、下步行动（负责人/时间）组织内容。",
+        "只使用用户提供或可核验的数据；缺失数字保留待补项，不虚构业绩。",
+    ]),
+    "email": ("商务沟通顾问", [
+        "包含明确主题、称呼、来意、必要背景、请求/下一步和得体落款。",
+        "语气匹配双方关系；日期、承诺、附件与联系人不得凭空补造。",
+    ]),
+    "tech_proposal": ("解决方案架构师", [
+        "覆盖现状与目标、约束、候选方案对比、推荐架构、实施阶段、风险与回滚、验收指标。",
+        "区分已知事实、假设和待验证项；成本收益给出计算口径而非虚构数字。",
+    ]),
+    "resume": ("招聘与简历顾问", [
+        "围绕目标岗位提炼真实经历，用行动、结果和技能关键词表达岗位匹配度。",
+        "不得虚构经历、公司、学历、指标或技术栈；缺少量化数据时保留待补提示。",
+    ]),
+}
+
+
+def _content_role(task):
+    """返回内置类型的专业角色；自定义 review 流程使用中性角色。"""
+    spec = CONTENT_DELIVERY_CONTRACTS.get(str(task.get("type") or ""))
+    return spec[0] if spec else "内容交付专家"
+
+
+def _content_contract(task):
+    """把类型成品约束渲染为稳定提示块；无内置契约时不额外注入。"""
+    spec = CONTENT_DELIVERY_CONTRACTS.get(str(task.get("type") or ""))
+    if not spec:
+        return ""
+    return "\n\n## 本类型交付约束\n" + "\n".join("- " + item for item in spec[1])
+
 # 调研报告类稿件的追加要求（借鉴 gpt-researcher 迭代深研）：有网络/读文件工具时
 # 多源交叉验证，单源结论降权——调研的可信度来自证据链而非文采
 RESEARCH_APPENDIX = """
@@ -1421,9 +1510,10 @@ RESEARCH_APPENDIX = """
   单源信息要标注「仅单一来源」。
 - 引用来源在文中用行内链接或脚注标明（域名即可，不编造 URL）。
 - 区分「事实」与「观点」：数据/时间/版本号给来源，预测/评价标明是分析。
-- 结构建议：结论先行 → 分层论证 → 风险与局限（说明哪些结论证据不足）。"""
+- 结构硬性要求：报告第一段必须是「**核心结论**」三行以内的要点摘要（结论先行），
+  之后才展开分层论证 → 风险与局限（说明哪些结论证据不足）。"""
 
-NOVEL_REVISE_PROMPT = """你是一名专业作者。请根据下方汇总评审意见修订稿件文件：`__FILE__`（直接写入该文件）。文件必须以 UTF-8 编码保存（PowerShell 写文件显式加 -Encoding UTF8，禁止依赖默认编码）。
+NOVEL_REVISE_PROMPT = """你是__ROLE__。请根据下方汇总评审意见修订稿件文件：`__FILE__`（直接写入该文件）。文件必须以 UTF-8 编码保存（PowerShell 写文件显式加 -Encoding UTF8，禁止依赖默认编码）。
 
 ## 原始写作任务
 __GOAL__
@@ -1647,6 +1737,10 @@ def _critique_json(res, dims):
     if isinstance(gj, dict) and isinstance(gj.get("scores"), dict) and gj.get("scores"):
         return gj
     prose = runner.scores_from_prose(text, dims)
+    if not prose:
+        # 第四道网（BAML 借鉴）：维度名没命中时按「X：N 分」模式泛化抓取——
+        # 自定义 rubric 改了维度措辞而模型用了自己的说法时仍能救回
+        prose = runner.extract_scores_from_text(text)
     if prose:
         return {"scores": prose, "issues": [], "summary": text[:400]}
     return {"scores": {}, "issues": [],
@@ -2016,9 +2110,12 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
                 use_prompt = prompt
                 for draft_attempt in range(3):
                     if draft_attempt:
-                        if ev is not None and ev.is_set():
-                            break
-                        time.sleep(30 * draft_attempt)   # 30s / 60s 退避
+                        # 30s / 60s 退避；ev.wait 睡等可被取消即刻唤醒
+                        if ev is not None:
+                            if ev.wait(30 * draft_attempt):
+                                break
+                        else:
+                            time.sleep(30 * draft_attempt)
                     if draft_attempt and len(prompt) > 12000 and sk_block and sk_block in prompt:
                         # 长提示词在容量受限通道（讯飞托管 35B 等）上会挂起/秒拒
                         # ——分层降级：经验库→4K、模块库按模块边界、圣经按二级标题
@@ -2103,9 +2200,12 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
                 for race_round in range(2):
                     # 全变体失败（网关突发限流）→ 60s 退避重赛一轮，别一章判死
                     if race_round:
-                        if ev is not None and ev.is_set():
-                            break
-                        time.sleep(60)
+                        # ev.wait 睡等可被取消即刻唤醒
+                        if ev is not None:
+                            if ev.wait(60):
+                                break
+                        else:
+                            time.sleep(60)
                         for kk in range(n_variants):
                             # 清上一轮残稿：防陈旧半成品被本轮评分误认成新成品
                             try:
@@ -2664,13 +2764,15 @@ def _run_content_review(run, task, agents, ev, stats, mode):
         impl, _ = _pick_implementer(agents, task.get("implementer"))
         critics = _pick_critics_manual(agents, task)
     else:
-        impl, route["author"] = router.pick(agents, "implement", "novel", stats)
-        critics, route["critics"] = router.pick_critics(agents, "novel", stats, impl=impl)
+        task_type = task.get("type") or "novel"
+        impl, route["author"] = router.pick(agents, "implement", task_type, stats)
+        critics, route["critics"] = router.pick_critics(agents, task_type, stats, impl=impl)
     if impl is None:
         store.update_run(run_id, status="failed", error="没有可用智能体", ended_at=_now())
         return
     if resume_ctx is not None and mode == "auto":
-        critics, route["critics"] = router.pick_critics(agents, "novel", stats, impl=impl)
+        critics, route["critics"] = router.pick_critics(
+            agents, task.get("type") or "novel", stats, impl=impl)
 
     # ---- 规划（小说为模板计划）
     _wait_gate(run_id, ev)
@@ -2714,6 +2816,7 @@ def _run_content_review(run, task, agents, ev, stats, mode):
 
         def _draft_prompt_for(vfile):
             p = (_tpl(task, "draft_prompt", NOVEL_DRAFT_PROMPT).replace("__FILE__", vfile)
+                 .replace("__ROLE__", _content_role(task))
                  .replace("__GOAL__", task["goal"])
                  .replace("__CONTEXT__", task.get("context") or "（无）")
                  .replace("__RUBRIC__", "、".join(dims) if dims else "（按流程默认维度）"))
@@ -2723,6 +2826,7 @@ def _run_content_review(run, task, agents, ev, stats, mode):
             if is_research:
                 # 调研报告追加证据链要求（gpt-researcher 借鉴）
                 p += RESEARCH_APPENDIX
+            p += _content_contract(task)
             return p
 
         best_of = max(1, min(3, int(task.get("best_of") or 1)))
@@ -2822,8 +2926,10 @@ def _run_content_review(run, task, agents, ev, stats, mode):
                 pass
         else:
             prompt = (NOVEL_REVISE_PROMPT.replace("__FILE__", ms_name)
+                      .replace("__ROLE__", _content_role(task))
                       .replace("__GOAL__", task["goal"])
                       .replace("__CRITIQUE__", "\n".join(crit_lines)))
+            prompt += _content_contract(task)
             _run_step(run_id, "revise-r%d" % r, modelhub.bind_agent(impl, difficulty), prompt,
                       workdir, readonly=False, ev=ev,
                       resume=resume_ctx["session"] if resume_ctx else None)
@@ -3008,11 +3114,28 @@ def _write_task_evidence(run_id, task, workdir, summary_lines):
             for ln in summary_lines:
                 f.write("- %s\n" % str(ln)[:300])
             f.write("\n")
+        _archive_stamp(run_id, task, workdir, summary_lines)
         return path
     except Exception:
         return ""
 
 
+def _archive_stamp(run_id, task, workdir, summary_lines):
+    """归档戳（借鉴 OpenSpec archive）：evidence 落盘后向 spec.md 尾部追加
+    「已完成」快照行——spec 从「意图」升格为「意图+交付记录」的活档案。
+    失败静默。"""
+    try:
+        spec = os.path.join(workdir, ".codebee", "spec.md")
+        if not os.path.isfile(spec):
+            return
+        with open(spec, "a", encoding="utf-8") as f:
+            f.write("\n---\n**✅ 已交付** · %s · run %s\n%s\n" % (
+                _now(), run_id,
+                "\n".join("- %s" % str(ln)[:160] for ln in summary_lines[:5])))
+    except Exception:
+        return
+
+
 def _evidence_lines_from_run(run_id, task):
     """从 run 步骤与 verdict 提取证据行（确定性事实，不抄模型输出）。"""
     run = store.get_run(run_id) or {}

package/app/core/planner.py

@@ -12,7 +12,7 @@ import os
 import re
 import time
 
-from . import modelhub, runner, skills, usage
+from . import knowledge, modelhub, runner, skills, usage
 
 MAX_SUBTASKS = 4
 DEFAULT_OUTLINE_TIMEOUT = 900   # 8 章大纲 + 经验包注入是重生成任务，300s 实测不够
@@ -116,10 +116,16 @@ def _log_usage(source, role, task, res, agent=None, tool="", model="", provider=
 
 CODE_PLAN_PROMPT = """你是技术负责人。请把下面的开发目标拆解为 __N__ 个以内、按顺序执行的子任务，
 并判定任务难度。只输出一个 ```json 代码块，不要输出其他内容。JSON 结构：
-{"difficulty": "easy 或 hard", "subtasks": [{"title": "简短标题", "detail": "具体要做什么，给执行工程师的直接指令"}]}
+{"difficulty": "easy 或 hard", "subtasks": [{"title": "简短标题", "detail": "具体要做什么，给执行工程师的直接指令", "files": ["涉及的文件路径"]}]}
 难度判定：常规增删改查/小函数/格式调整 = easy；跨模块改动/架构调整/复杂算法/安全相关 = hard。
 子任务粒度要可独立验证；最后一个子任务必须包含整体联调/收尾。
 
+## 先探索再计划（重要，借鉴 OpenSpec explore）
+拆解之前先用你的读文件/搜索工具**实际查看工作目录**，找到目标相关的真实文件与函数，再据此拆解。
+detail 必须点名真实存在的文件路径；files 列出该子任务会改动的文件（新建的写目标路径）。
+**没探索过就不要凭想象编路径**——计划的可执行性取决于它对真实代码库的贴合度。
+若工作目录为空（全新项目），files 写计划新建的文件路径。
+
 ## 开发目标
 __GOAL__
 
@@ -274,6 +280,9 @@ def make_serial_outline(task, author_agent=None, workdir=None, ev=None, log_path
     wpc = int(serial.get("words_per_chapter") or 2500)
     start = int(serial.get("start_chapter") or 1)
     sk_block, _ = skills.block_for(task)
+    kb_block = knowledge.block_for(task)
+    if kb_block:
+        sk_block = (sk_block + "\n\n" + kb_block) if sk_block else kb_block
     prev_title = ""
     if start > 1:
         prev_lines, done, prev_title, prev_tail = _prev_serial_story(task)
@@ -367,7 +376,10 @@ def make_serial_outline(task, author_agent=None, workdir=None, ev=None, log_path
 
 
 def _norm_subtasks(data):
-    """规范化 LLM 计划输出；不合规返回 None。"""
+    """规范化 LLM 计划输出；不合规返回 None。
+
+    files 字段（OpenSpec explore 借鉴）：计划锚定的真实文件清单，透传给执行步
+    让实现者知道改动面（缺失/非法时留空，向后兼容旧计划）。"""
     if not isinstance(data, dict):
         return None
     subs = data.get("subtasks")
@@ -381,7 +393,13 @@ def _norm_subtasks(data):
         detail = str(s.get("detail") or "").strip()
         if not title:
             continue
-        steps.append({"title": title[:60], "detail": detail[:1500]})
+        step = {"title": title[:60], "detail": detail[:1500]}
+        files = s.get("files")
+        if isinstance(files, list):
+            clean = [str(f).strip()[:200] for f in files if str(f).strip()][:10]
+            if clean:
+                step["files"] = clean
+        steps.append(step)
     return steps or None
 
 

package/app/core/publish/manager.py

@@ -86,16 +86,56 @@ def view():
 
 
 def recover_orphans():
-    """启动收尸：waiting_login / busy 的线程随进程重启死掉，统一改判 error。"""
+    """启动收尸：waiting_login / busy 的线程随进程重启死掉，统一改判 error。
+
+    升级自愈：旧版「等扫码窗口一关就冤判超时」留下的 error（error 文案带
+    「等待登录超时」）排队后台复核——profile 登录态还在的直接翻 connected，
+    别让升级完还挂着旧冤案；attach 不到活实例就维持原样（用户点重连时
+    新终审逻辑自会兜住）。"""
     _load()
     n = 0
+    stale = []
     for plat in PLATFORMS:
-        if _st(plat).get("status") in ("waiting_login", "busy"):
+        s = _st(plat)
+        if s.get("status") in ("waiting_login", "busy"):
             _set(plat, status="error", error="上次操作随服务重启中断，请重试")
             n += 1
+        elif s.get("status") == "error" and "等待登录超时" in (s.get("error") or ""):
+            stale.append(plat)
+    if stale:
+        threading.Thread(target=_recheck_stale_errors, args=(stale,),
+                         daemon=True, name="pub-stale-recheck").start()
     return n
 
 
+def _recheck_stale_errors(plats):
+    """旧版假超时的后台复核：只 attach 还活着的浏览器实例（绝不 launch——
+    升级重启时静默弹窗口吓人），登录态复核过了翻 connected；否则不动。"""
+    for plat in plats:
+        if _st(plat).get("status") != "error":
+            continue                  # 用户已先行操作（重连/断开），别覆盖
+        port = _st(plat).get("port") or 0
+        if not port:
+            continue
+        try:
+            b = Browser.attach(int(port))
+        except Exception:
+            continue                  # 实例已死：不 launch，维持原错误
+        with LOCK:
+            _browsers[plat] = b
+        page = b.first_page(create=False)
+        if page is None:
+            continue
+        try:
+            ok, _u = _check_login(plat, page)
+        except Exception:
+            continue
+        if ok and _st(plat).get("status") == "error":
+            _set(plat, status="connected", error="",
+                 last_login=time.strftime("%m-%d %H:%M"))
+            ledger.record(plat, "connect", ok=True)
+
+
 # ---------------------------------------------------------------- 浏览器会话
 def _profiles_base():
     """profile 存放根：用户主目录 ~/.codebee/publish_profiles（仓库外）。
@@ -245,13 +285,31 @@ def connect(plat):
             except (BrowserError, Exception):
                 pass                        # 页面被用户关掉等：继续等到超时
             time.sleep(5)
-        _set(plat, status="error", error="等待登录超时（15 分钟），请重新点连接")
+        _finalize_login_wait(plat)
 
     threading.Thread(target=wait_login, daemon=True,
                      name="pub-login-%s" % plat).start()
     return True, ""
 
 
+def _finalize_login_wait(plat):
+    """等扫码超时后的终审：用户可能已在本窗口登录后把窗口关了（profile
+    里登录态还在），attach-or-launch 重拉页面再复核一次，别急着冤判
+    超时——「明明登录着却报超时」是发布卡死感的最大来源。复核也过不了
+    才落超时错误。返回 True 表示复核通过（已判 connected）。"""
+    try:
+        _b, page = _open_page(plat)
+        ok, _u = _check_login(plat, page)
+    except Exception:
+        ok = False
+    if ok:
+        _set(plat, status="connected", last_login=time.strftime("%m-%d %H:%M"))
+        ledger.record(plat, "connect", ok=True)
+    else:
+        _set(plat, status="error", error="等待登录超时（15 分钟），请重新点连接")
+    return ok
+
+
 def disconnect(plat):
     b = _browsers.pop(plat, None)
     if b:
@@ -357,6 +415,25 @@ def create_book_async(task_id, plat, auto_submit=False):
     return True, ""
 
 
+# ---------------------------------------------------------------- 动作：登记已有作品
+def register_book(task_id, plat, title, book_id=""):
+    """人工登记平台已有作品：建书流程没走通、或用户纯手工在平台上建的
+    书，补进台账让卡片翻到「已建书·发一章」，避免再点「创建作品」造出
+    重复书。只动本地台账不碰浏览器；发章按书名找书，title 必填，
+    book_id 选填（有直达 URL 时填）。已登记会覆盖更新（兼纠错口）。"""
+    from .. import store
+    if plat not in PLATFORMS:
+        return False, "未知平台"
+    if not store.get_task(task_id):
+        return False, "任务不存在"
+    title = (title or "").strip()
+    if not title:
+        return False, "作品名必填（发章按作品名在平台找书）"
+    ledger.save_book(task_id, plat, {"book_id": str(book_id or "").strip(),
+                                     "title": title[:120]})
+    return True, ""
+
+
 def _with_tag_steps(steps, groups, values, mod=None):
     """标签走数据驱动：清单进 values["_tags"]（[组名, 标签] 对），由 flow 的
     "tags" 步骤按组切换点选。组显示名映射来自**对应平台模块**的