@qing3a/flow-rpa-app 0.6.0 → 0.7.1

package/dist/gate-runtime.d.ts

@@ -0,0 +1,27 @@
+/**
+ * T035-1（S2）：同站闸门 key 的 **① 运行时实际 host** 观测源。
+ *
+ * 问题：闸门的 `acquire`（run 前）发生在页面存在之前——
+ *  - mock 模式 / resume：页面驱动由执行层临时构建，入口层拿不到；
+ *  - 真实模式：每次 run 前会**会话轮换**（重启浏览器到 about:blank），此刻读到的
+ *    「当前标签 URL」是上一次会话的残留页，不是本次 run 真正会访问的站点。
+ * 在 run 前硬探一次浏览器只会把上一次的残留站点记成这次的闸门维度（错锚），所以入口层**不探测**。
+ *
+ * 做法：执行层在 run 起点把**运行时页面 URL**按 flowId 记成只读观测；
+ * 入口层（server run_flow / CLI precheckRun）下次解析闸门 key 时把它当优先级 ① 的来源。
+ *
+ * 边界：
+ *  - 优先级 ②（流程声明的 navigate host）始终压得住它——有声明就用声明，观测只在**无声明**时生效；
+ *  - 因此这条观测只影响「没有 navigate 步骤的流程」（正是 S2 的漏洞面），不会改写已有流程的闸门维度；
+ *  - 按 flowId 分桶：A 流程观测到的站点不会被 B 流程借用（跨站不互相污染）。
+ */
+/** 记录一次运行时 URL 观测（测试注入缝：绕开页面驱动，直接设定「本流程上次所在站点」） */
+export declare function setObservedRuntimeUrl(flowId: string, url: string): void;
+/**
+ * 记录一次运行时页面 URL 观测（执行层 run 起点调用；探针抛错 → 转为「无观测」，绝不阻断 run）。
+ * `page.currentUrl()` 由驱动提供：mock 页面如实回 URL，真实 CdpPage 在会话轮换后通常回 about:blank
+ * （此时记录空串 = 本流程暂时没有可用观测，入口层退回优先级 ② / ③）。
+ */
+export declare function observeRuntimeUrl(flowId: string, probe: () => Promise<string> | string, record?: (url: string) => void): Promise<string>;
+/** 该流程最近一次 run 起点观测到的运行时页面 URL（无观测 → 空串） */
+export declare function observedRuntimeUrl(flowId: string): string;

package/dist/gate-runtime.js

@@ -0,0 +1,44 @@
+/**
+ * T035-1（S2）：同站闸门 key 的 **① 运行时实际 host** 观测源。
+ *
+ * 问题：闸门的 `acquire`（run 前）发生在页面存在之前——
+ *  - mock 模式 / resume：页面驱动由执行层临时构建，入口层拿不到；
+ *  - 真实模式：每次 run 前会**会话轮换**（重启浏览器到 about:blank），此刻读到的
+ *    「当前标签 URL」是上一次会话的残留页，不是本次 run 真正会访问的站点。
+ * 在 run 前硬探一次浏览器只会把上一次的残留站点记成这次的闸门维度（错锚），所以入口层**不探测**。
+ *
+ * 做法：执行层在 run 起点把**运行时页面 URL**按 flowId 记成只读观测；
+ * 入口层（server run_flow / CLI precheckRun）下次解析闸门 key 时把它当优先级 ① 的来源。
+ *
+ * 边界：
+ *  - 优先级 ②（流程声明的 navigate host）始终压得住它——有声明就用声明，观测只在**无声明**时生效；
+ *  - 因此这条观测只影响「没有 navigate 步骤的流程」（正是 S2 的漏洞面），不会改写已有流程的闸门维度；
+ *  - 按 flowId 分桶：A 流程观测到的站点不会被 B 流程借用（跨站不互相污染）。
+ */
+/** flowId → 最近一次 run 起点观测到的运行时页面 URL */
+const observed = new Map();
+/** 记录一次运行时 URL 观测（测试注入缝：绕开页面驱动，直接设定「本流程上次所在站点」） */
+export function setObservedRuntimeUrl(flowId, url) {
+    observed.set(flowId, url);
+}
+/**
+ * 记录一次运行时页面 URL 观测（执行层 run 起点调用；探针抛错 → 转为「无观测」，绝不阻断 run）。
+ * `page.currentUrl()` 由驱动提供：mock 页面如实回 URL，真实 CdpPage 在会话轮换后通常回 about:blank
+ * （此时记录空串 = 本流程暂时没有可用观测，入口层退回优先级 ② / ③）。
+ */
+export async function observeRuntimeUrl(flowId, probe, record = (url) => observed.set(flowId, url)) {
+    let url = '';
+    try {
+        url = String(await probe());
+    }
+    catch {
+        url = ''; // 探针失败 = 探不到（降级到流程声明 / flow 维度），不是错误
+    }
+    record(url);
+    return url;
+}
+/** 该流程最近一次 run 起点观测到的运行时页面 URL（无观测 → 空串） */
+export function observedRuntimeUrl(flowId) {
+    return observed.get(flowId) ?? '';
+}
+//# sourceMappingURL=gate-runtime.js.map

package/dist/gate-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-runtime.js","sourceRoot":"","sources":["../src/gate-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,wCAAwC;AACxC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAA;AAE1C,mDAAmD;AACnD,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,GAAW;IAC/D,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,KAAqC,EACrC,SAAgC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC;IAElE,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,GAAG,EAAE,CAAA,CAAC,qCAAqC;IAChD,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,CAAA;IACX,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;AACnC,CAAC"}

package/dist/registry.d.ts

@@ -5,6 +5,8 @@ import { type FlowPatch } from '@qing3a/flow-rpa-engine/src/schema.js';
  * 扫描 flows/ 目录下各子目录的 flow.json，缓存解析结果。
  * D5（2026-08-26）：加载 flow.json 后合并用户覆盖层 flow.patch.json
  * （按 stepId 定向整行替换 verify/params；patch 语法错误 → 警告不阻断，D1 fail-loud 复用）。
+ * T035-2（2026-09-10，ANTI-BAN-PRINCIPLES §五 S6）：加载后比对**内置基线哈希**，
+ * 标注流程来源（`builtin` / `builtin-modified` / `local`）——本地改动**可见但不阻断**。
  */
 /** 流程参数声明（D-R6；list_flows 返回，供 Agent 组装 vars） */
 export interface FlowInputDecl {
@@ -12,7 +14,18 @@ export interface FlowInputDecl {
     /** 必填（D-R6：缺省 false；缺 required 参数时 run_flow 报「缺少必填参数」） */
     required: boolean;
     description?: string;
+    /** T031C-1：缺省值（String 化后透传给 Agent）。有 default ⇒ 调用方可省略（required 也不例外） */
+    default?: string;
 }
+/**
+ * T035-2（S6）：流程来源标注。
+ * - `builtin`：目录文件名与内容都与**内置基线**逐一致（原样分发的内置流程包）
+ * - `builtin-modified`：命中基线（是内置流程），但至少一个文件内容与基线不符（用户本地改过）
+ * - `local`：不在基线清单里（用户自建流程，或内置目录被改名）
+ * 无基线数据（用户目录里没有 `baseline.json`，或包内副本缺失）时统一标 `local`——
+ * **不可校验不等于有罪**：降级为无校验 + 一行日志，不告警、不阻断。
+ */
+export type FlowOrigin = 'builtin' | 'builtin-modified' | 'local';
 /** 流程摘要（list_flows 返回） */
 export interface FlowSummary {
     id: string;
@@ -20,24 +33,42 @@ export interface FlowSummary {
     version: number;
     path: string;
     inputs: FlowInputDecl[];
+    /** T035-2（S6）：来源标注（工具面可见；不落 run.json） */
+    origin: FlowOrigin;
+}
+/** 基线清单（`flows/baseline.json`；由脚本生成，禁止手写） */
+export interface FlowBaseline {
+    /** 清单格式版本（当前 1）；未来格式变更靠它做兼容分支 */
+    version: number;
+    /** 生成时刻（ISO；仅供人看） */
+    generatedAt: string;
+    /** flowId → { 文件名 → sha256 } */
+    flows: Record<string, {
+        files: Record<string, string>;
+    }>;
 }
+/** 基线文件名（与流程目录同级，即 flows/ 下） */
+export declare const BASELINE_FILE = "baseline.json";
+/** 解析基线清单（缺失/损坏/格式不符 → undefined = 无校验；**绝不抛错**） */
+export declare function loadBaseline(flowsDir: string): FlowBaseline | undefined;
 /** D5 整行替换合并：patch.steps[id].verify / params 整体替换原值（dsh 整行语义） */
 export declare function applyPatch(flow: Flow, patch: FlowPatch | undefined): Flow;
 export declare class FlowRegistry {
     private readonly flowsDir;
     /** flow_id → 已解析的流程定义（缓存；flow 为 patch 合并后的最终形态） */
     private cache;
-    /** 最近一次扫描的流程加载警告（坏 flow.json / 坏 patch 等；fail-loud 警告态，get_status 呈现） */
+    /** 最近一次扫描的流程加载警告（坏 flow.json / 坏 patch / 偏离内置基线等；fail-loud 警告态，get_status 呈现） */
     private _warnings;
     constructor(flowsDir: string);
     /** 最近一次扫描的警告（D1 fail-loud：坏流程启动即呈现，不静默跳过） */
     warnings(): string[];
-    /** 扫描 flows/ 下各子目录的 flow.json（含 D5 patch 合并） */
+    /** 扫描 flows/ 下各子目录的 flow.json（含 D5 patch 合并 + T035-2 基线比对） */
     list(): FlowSummary[];
     get(flowId: string): {
         version: number;
         raw: string;
         flow: Flow;
+        origin: FlowOrigin;
     } | undefined;
     /** 流程目录（pkg_update 替换用） */
     flowsDirOf(): string;

package/dist/registry.js

@@ -1,17 +1,66 @@
-import { readdirSync, readFileSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { readdirSync, readFileSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { parseFlow } from '@qing3a/flow-rpa-engine/src/validate.js';
 import { FlowPatchSchema } from '@qing3a/flow-rpa-engine/src/schema.js';
-/** 读取用户覆盖层（flows/<name>/flow.patch.json；不存在 → undefined；解析失败 → 警告信息 + undefined） */
-function loadPatch(flowDir, name, warnings) {
-    const patchPath = join(flowDir, 'flow.patch.json');
+/** 基线文件名（与流程目录同级，即 flows/ 下） */
+export const BASELINE_FILE = 'baseline.json';
+/** 解析基线清单（缺失/损坏/格式不符 → undefined = 无校验；**绝不抛错**） */
+export function loadBaseline(flowsDir) {
     let raw;
     try {
-        raw = readFileSync(patchPath, 'utf8');
+        raw = readFileSync(join(flowsDir, BASELINE_FILE), 'utf8');
     }
     catch {
-        return undefined; // 无 patch（正常）
+        return undefined; // 无基线文件（老版本流程目录 / 用户自建目录）
     }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || typeof parsed.flows !== 'object' || parsed.flows === null)
+            return undefined;
+        return {
+            version: typeof parsed.version === 'number' ? parsed.version : 0,
+            generatedAt: typeof parsed.generatedAt === 'string' ? parsed.generatedAt : '',
+            flows: parsed.flows,
+        };
+    }
+    catch {
+        return undefined; // 基线损坏 → 退化为无校验（fail-soft：它只是「来源可见性」，不是执行前置）
+    }
+}
+/** sha256（十六进制小写） */
+function sha256(bytes) {
+    return createHash('sha256').update(bytes).digest('hex');
+}
+/** 流程目录下的文件名（小写排序；目录/子目录不进清单——starter 包只有平铺文件） */
+function listFlowFiles(flowDir) {
+    try {
+        return readdirSync(flowDir)
+            .filter((f) => {
+            try {
+                return statSync(join(flowDir, f)).isFile();
+            }
+            catch {
+                return false;
+            }
+        })
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+/** 读取用户覆盖层（`flow.patch.json` 的**原始字节**；不存在 → undefined） */
+function readPatchRaw(flowDir) {
+    try {
+        return readFileSync(join(flowDir, 'flow.patch.json'), 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 解析覆盖层原始字节（语法/结构错误 → 警告 + undefined；原流程生效） */
+function parsePatch(raw, name, warnings) {
     try {
         return FlowPatchSchema.parse(JSON.parse(raw));
     }
@@ -41,7 +90,7 @@ export class FlowRegistry {
     flowsDir;
     /** flow_id → 已解析的流程定义（缓存；flow 为 patch 合并后的最终形态） */
     cache = new Map();
-    /** 最近一次扫描的流程加载警告（坏 flow.json / 坏 patch 等；fail-loud 警告态，get_status 呈现） */
+    /** 最近一次扫描的流程加载警告（坏 flow.json / 坏 patch / 偏离内置基线等；fail-loud 警告态，get_status 呈现） */
     _warnings = [];
     constructor(flowsDir) {
         this.flowsDir = flowsDir;
@@ -50,9 +99,10 @@ export class FlowRegistry {
     warnings() {
         return this._warnings;
     }
-    /** 扫描 flows/ 下各子目录的 flow.json（含 D5 patch 合并） */
+    /** 扫描 flows/ 下各子目录的 flow.json（含 D5 patch 合并 + T035-2 基线比对） */
     list() {
         this._warnings = [];
+        this.cache.clear(); // 每次扫描重建缓存：来源标注不做陈旧缓存（文件可能刚被改）
         const out = [];
         let entries;
         try {
@@ -63,6 +113,9 @@ export class FlowRegistry {
         catch {
             return [];
         }
+        // T035-2：基线只读一次（每目录都读会浪费；缺失 → 无校验降级）
+        const baseline = loadBaseline(this.flowsDir);
+        let modifiedCount = 0;
         for (const name of entries) {
             const flowDir = join(this.flowsDir, name);
             const flowPath = join(flowDir, 'flow.json');
@@ -74,7 +127,27 @@ export class FlowRegistry {
                 continue;
             }
             try {
-                const flow = applyPatch(parseFlow(raw), loadPatch(flowDir, name, this._warnings));
+                const patchRaw = readPatchRaw(flowDir);
+                const flow = applyPatch(parseFlow(raw), patchRaw !== undefined ? parsePatch(patchRaw, name, this._warnings) : undefined);
+                // T035-2（S6）：来源判定——基线声称认得这个 id 吗？逐文件哈希一致吗？
+                // 目录名与 flow.id 都可作为基线键（starter 同步后两者一致；用户改名后仍能认出来）
+                const base = baseline?.flows?.[name] ?? baseline?.flows?.[flow.id];
+                let origin = 'local';
+                if (base && base.files && typeof base.files === 'object') {
+                    const actual = new Map();
+                    for (const f of listFlowFiles(flowDir))
+                        actual.set(f, sha256(readFileSync(join(flowDir, f))));
+                    const expected = base.files;
+                    const expectedNames = Object.keys(expected);
+                    const sameFileSet = expectedNames.length === actual.size && expectedNames.every((f) => actual.has(f));
+                    const sameContent = sameFileSet && expectedNames.every((f) => actual.get(f) === expected[f]);
+                    origin = sameContent ? 'builtin' : 'builtin-modified';
+                    if (origin === 'builtin-modified') {
+                        modifiedCount++;
+                        // 不阻断执行（用户有权改自己的流程）；只在 doctor / get_status / 启动日志呈现
+                        this._warnings.push(`流程 ${flow.id} 与内置基线不一致（本地已改动）`);
+                    }
+                }
                 out.push({
                     id: flow.id,
                     name: flow.name,
@@ -84,9 +157,12 @@ export class FlowRegistry {
                         name: i.name,
                         required: i.required === true,
                         ...(i.description ? { description: i.description } : {}),
+                        // T031C-1：default 一并透传（Agent 不必靠猜缺省值；executor 侧同源注入）
+                        ...(i.default !== undefined ? { default: String(i.default) } : {}),
                     })),
+                    origin,
                 });
-                this.cache.set(flow.id, { version: flow.version, raw, flow });
+                this.cache.set(flow.id, { version: flow.version, raw, flow, origin });
             }
             catch (e) {
                 // D1：解析失败不静默跳过——收集警告（启动/状态页呈现），等 run_flow 才暴露太晚
@@ -94,6 +170,14 @@ export class FlowRegistry {
                 continue;
             }
         }
+        // T035-2：无基线（或基线里一个流程都不认得）→ **一行降级日志**（可校验性本身要可见，
+        // 但「包内 baseline.json 缺失」不是用户的问题，故用日志而不用警告——见 brief「不报错」）
+        if (baseline === undefined && out.length > 0) {
+            console.log(`[flow-rpa] 无内置流程基线（${BASELINE_FILE} 缺失或损坏），跳过来源校验（不阻断执行）`);
+        }
+        else if (baseline !== undefined && modifiedCount > 0) {
+            console.log(`[flow-rpa] ${modifiedCount} 个内置流程与基线不一致（本地已改动，仅告警不阻断）`);
+        }
         out.sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
         return out;
     }

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/runner.d.ts

@@ -7,8 +7,9 @@ import { ObservationExporter } from '@qing3a/flow-rpa-engine/src/export.js';
 import { PerfGate } from '@qing3a/flow-rpa-engine/src/bench.js';
 import { CooldownGate, SiteGate } from '@qing3a/flow-rpa-engine/src/gate.js';
 import { BehaviorArchive } from '@qing3a/flow-rpa-engine/src/behavior.js';
-import { FlowRegistry } from './registry.js';
+import { FlowRegistry, type FlowOrigin } from './registry.js';
 import type { RunConfig } from './config.js';
+import { type GateKeyResolution, type GateKeySource } from './gate-key.js';
 /**
  * run_flow 异步执行层（移植 Rust `server.rs` 的 execute_run/spawn_run + M9 D-R1/D-R2）。
  *
@@ -34,6 +35,11 @@ export interface RunFlowResult {
     pauseGuidance?: string;
     /** T027/B2：登录态预检拒绝（run 保持 paused 未执行；CLI 据此退出码 1，与「resume 后再次 paused」区分） */
     precheckRejected?: boolean;
+    /** T035-2（S6）：流程来源（builtin / builtin-modified / local）——**只进工具面/CLI 输出，不落 run.json** */
+    origin?: FlowOrigin;
+    /** T035-1（S2）：本次 run 实际使用的同站闸门 key（`site:<host>` / `flow:<id>`）与维度——只进工具面 */
+    gateKey?: string;
+    gateKeySource?: GateKeySource;
 }
 /**
  * T027/B2：pauseReason → 结构化下一步指引（人工接管交接，bsk human-in-the-loop 借鉴）。
@@ -54,6 +60,12 @@ export interface RunFlowArgs {
         loopIter?: number;
         loopSub?: number;
     };
+    /**
+     * T035-1（S2）：调用方**已解析过**的闸门 key（server/CLI 的 run 前 acquire 用过的那一个）。
+     * 传入 = 同一 run 的 acquire 与 penalize 记同一个 key（不重复探测页面、不产生二次口径漂移）；
+     * 不传（如 resume_run）= run 内按「运行时 host → 流程声明 host → flow 维度」现解析。
+     */
+    gateKeyResolved?: GateKeyResolution;
 }
 /** 执行上下文（runner 持有全部共享状态） */
 export interface ExecCtx {
@@ -115,7 +127,17 @@ export declare class MockPage implements PageOps {
     private extracted;
     /** 测试用：waitMs 真实阻塞时长（默认 0 = no-op；设 >0 可让 run 慢下来验证队列忙） */
     slowWaitMs: number;
+    /** 测试用：注入的非拟人兜底事件（takeFallbacks 取走并清空；默认空 = 纯拟人路径） */
+    fallbackEvents: Array<{
+        kind: string;
+        selector?: string;
+    }>;
     setEnvCheck(config: EnvCheck | undefined): void;
+    /** 兜底计量（PageOps.takeFallbacks）：取走并清空 */
+    takeFallbacks(): Array<{
+        kind: string;
+        selector?: string;
+    }>;
     navigate(url: string): Promise<void>;
     click(sel: string, index: number): Promise<void>;
     input(_sel: string, v: string): Promise<void>;
@@ -139,7 +161,12 @@ export declare class MockPage implements PageOps {
  */
 export declare function housekeepingAfterRun(ctx: ExecCtx): Promise<void>;
 /** 同步执行一个 run（构造驱动 → 解释执行 → 落盘 → 自动上报 → 更新运行状态） */
-export declare function executeRun(ctx: ExecCtx, args: RunFlowArgs, runId: string): Promise<RunFlowResult>;
+export declare function executeRun(ctx: ExecCtx, args: RunFlowArgs, runId: string, 
+/**
+ * 测试注入的页面驱动（**仅 mock 模式生效**；缺省 new MockPage()）。
+ * 真实模式恒用 CdpPage —— 注入值被忽略，测试缝隙不会漏进真实执行路径。
+ */
+pageOverride?: PageOps): Promise<RunFlowResult>;
 /**
  * T027/B2：登录态探测器（真实模式缺省实现）——连 9222 现有标签页，
  * 用 engine region.ts 登录区双重特征（isLoginSignal：路由特征 + 页面文本强标记，与 executor 每步复查同源）判定是否已登录。
@@ -173,7 +200,7 @@ export declare function resumeRun(ctx: ExecCtx, runId: string, precheck?: Resume
  * 不破坏 open-browser/懒加载登录：登录态在 profile（重启保留）；下次 open-browser/run 重新拉起。
  */
 export declare function rotateBrowserSession(port: number, edgePath: string, userDataDir: string): Promise<void>;
-/** 流程的目标站点 host（取首个 navigate 步骤的 url；无 navigate 返回 undefined —— 不节流 mock） */
+/** 流程声明的目标站点 host（T035-1 起 = **全部** navigate 步骤里最后一个；无 navigate → undefined） */
 export declare function flowHost(ctx: ExecCtx, flowId: string): string | undefined;
 /** 队列当前状态（自描述聚合用 D-S1；只读） */
 export declare function queueState(): {

package/dist/runner.js

@@ -9,9 +9,13 @@ import { nowIso, RunStore, extractSink } from '@qing3a/flow-rpa-engine/src/stora
 import { cleanTmpFiles, retireRuns } from '@qing3a/flow-rpa-engine/src/housekeeping.js';
 import { ObservationExporter } from '@qing3a/flow-rpa-engine/src/export.js';
 import { PerfGate } from '@qing3a/flow-rpa-engine/src/bench.js';
-import { CooldownGate, hostOf, SiteGate } from '@qing3a/flow-rpa-engine/src/gate.js';
+import { CooldownGate, DEEP_CRAWL_MIN_PAGES, deepCrawlPenaltySecs, hostOf, SiteGate } from '@qing3a/flow-rpa-engine/src/gate.js';
 import { BehaviorArchive } from '@qing3a/flow-rpa-engine/src/behavior.js';
 import { FlowRegistry } from './registry.js';
+import { defaultEdgePath } from './config.js';
+import { rotationFromConfig, rotationLogLine, setRotationObservation } from './session-rotation.js';
+import { declaredNavigateHost, gateKeyLabel, reportGateFallback, resolveGateKeyInRun, } from './gate-key.js';
+import { observeRuntimeUrl } from './gate-runtime.js';
 /**
  * T027/B2：pauseReason → 结构化下一步指引（人工接管交接，bsk human-in-the-loop 借鉴）。
  * 只进工具返回 message / CLI 输出，绝不落 run.json（data/ 格式冻结）；绝不自动 resume（无人值守边界）。
@@ -22,7 +26,7 @@ export function pauseGuidance(reason, runId) {
         return `请在引擎浏览器（open-browser/run 弹出的专用浏览器）完成登录后执行 ${resumeHint}`;
     }
     if (reason === 'env_check') {
-        return `引擎检测到环境风险（验证码/风险弹窗，流程 envCheck 配置命中）——请人工查看页面并处理后执行 ${resumeHint}；绝不自动重试（防封铁律）`;
+        return `引擎检测到环境风险（命中风险页基线 / 验证码 / 风险弹窗）——请人工查看页面并处理后执行 ${resumeHint}；绝不自动重试（防封铁律）`;
     }
     return `请人工处理页面状态后执行 ${resumeHint}`;
 }
@@ -137,10 +141,18 @@ export class MockPage {
     extracted = [];
     /** 测试用：waitMs 真实阻塞时长（默认 0 = no-op；设 >0 可让 run 慢下来验证队列忙） */
     slowWaitMs = MockPage.defaultSlowWaitMs;
+    /** 测试用：注入的非拟人兜底事件（takeFallbacks 取走并清空；默认空 = 纯拟人路径） */
+    fallbackEvents = [];
     setEnvCheck(config) {
         this.envCheck = config;
         MockPage.lastEnvCheck = config;
     }
+    /** 兜底计量（PageOps.takeFallbacks）：取走并清空 */
+    takeFallbacks() {
+        const out = this.fallbackEvents;
+        this.fallbackEvents = [];
+        return out;
+    }
     async navigate(url) {
         this.url = url;
     }
@@ -233,18 +245,33 @@ function loadBehaviorRules(flowsDir, flowId) {
     }
 }
 /** 同步执行一个 run（构造驱动 → 解释执行 → 落盘 → 自动上报 → 更新运行状态） */
-export async function executeRun(ctx, args, runId) {
+export async function executeRun(ctx, args, runId, 
+/**
+ * 测试注入的页面驱动（**仅 mock 模式生效**；缺省 new MockPage()）。
+ * 真实模式恒用 CdpPage —— 注入值被忽略，测试缝隙不会漏进真实执行路径。
+ */
+pageOverride) {
     const cached = ctx.registry.get(args.flowId);
     if (!cached) {
         const r = { runId, status: 'failed', error: `流程不存在: ${args.flowId}` };
         ctx.runs.set(runId, r);
         return r;
     }
-    const { flow, version } = cached;
+    const { flow, version, origin } = cached;
+    // T033-2（S5）：会话轮换状态显式化——与 doctor/get_status 同一判据（session-rotation.ts）。
+    // 「有没有轮换、依据哪个 edgePath」不再只藏在代码分支里：mock 驱动如实呈现「未轮换」。
+    const rotation = setRotationObservation({
+        ...rotationFromConfig(ctx.config.edgePath, defaultEdgePath()),
+        ...(ctx.config.mock ? { enabled: false, reason: 'disabled', edgePath: '' } : {}),
+    });
+    if (!ctx.config.mock) {
+        // 真实 run 每次打一行：本次 run 是否轮换 + 依据的 edgePath
+        console.log(`[flow-rpa] ${rotationLogLine(rotation)}`);
+    }
     // 驱动选择：mock（调试/无浏览器）或真实浏览器（M8 CdpPage）
     let page;
     if (ctx.config.mock) {
-        page = new MockPage();
+        page = pageOverride ?? new MockPage();
     }
     else {
         // T010 P2-6（修订）：run 前轮换——每次 run 用全新浏览器会话（同 profile 登录态保留）。
@@ -252,7 +279,7 @@ export async function executeRun(ctx, args, runId) {
         // 失败仅日志（ensureBrowser 会按需拉起，不阻断）。
         if (ctx.config.edgePath.length > 0) {
             await rotateBrowserSession(ctx.config.cdpPort, ctx.config.edgePath, ctx.config.userDataDir).catch((e) => {
-                console.log(`[flow-rpa] 会话轮换失败（浏览器保持，run 前重试）: ${e instanceof Error ? e.message : String(e)}`);
+                console.log(`[flow-rpa] 会话轮换失败（浏览器保持，运行前重试）: ${e instanceof Error ? e.message : String(e)}`);
             });
         }
         const { CdpPage } = await import('@qing3a/flow-rpa-engine/src/cdp/page.js');
@@ -260,6 +287,15 @@ export async function executeRun(ctx, args, runId) {
         await cdpPage.ensureBrowser(ctx.config.edgePath, ctx.config.userDataDir);
         page = cdpPage;
     }
+    // T035-1（S2）：闸门 key 只在 run 起点解析**一次**，acquire 与 penalize 共用同一个 key。
+    // 优先级：① 调用方已解析（server/CLI 的 run 前 acquire 用过的那一个，零重复探测、零口径漂移）
+    // → ② 运行时页面 host（`page.currentUrl()`；mock 页面如实回 URL，真实 CdpPage 在会话轮换后
+    // 通常是 about:blank → 探不到就降级，闸门不会因此消失）→ ③ 流程声明的 navigate host
+    // → ④ `flow:<id>` 维度兜底 + 一行告警。任何情况下 key 都存在——闸门不再有「静默无 key」态。
+    const runtimeUrl = await observeRuntimeUrl(flow.id, () => page.currentUrl());
+    const gate = resolveGateKeyInRun(args.gateKeyResolved, runtimeUrl, flow.id, flow.steps);
+    if (gate.source === 'flow')
+        reportGateFallback(flow.id);
     // A1 ENV_CHECK 注入（D-V1）：flow.json 顶层 envCheck → 页面检测配置；缺省不检测（D-V4）
     if (flow.envCheck) {
         const setEnvCheck = page.setEnvCheck;
@@ -291,6 +327,9 @@ export async function executeRun(ctx, args, runId) {
             onBehavior: (entry) => ctx.behavior.record(entry),
             // P2 区域识别规则（behavior.rules.json 随流程包分发；引擎零业务逻辑——缺失则不识别区域）
             behaviorRules: loadBehaviorRules(ctx.flowsDir, flow.id),
+            // T037-3（0.7.0）节奏层人格：本安装/本账号的翻页节拍区间（引擎护栏内取段；
+            // 流程显式 paceMs 优先，人格不得突破下限）。缺省节奏 → 引擎缺省 15~25s（行为不变）。
+            nextPagePaceMs: ctx.config.simProfile.rhythm?.nextPagePaceMs,
             // T015 P0-2：resume 起点（暂停点后继续，不重跑已完成步骤）
             ...(args.resume
                 ? {
@@ -329,7 +368,15 @@ export async function executeRun(ctx, args, runId) {
             keywords: [],
         });
         ctx.store.saveRun(rec);
-        ctx.runs.set(runId, { runId, status: 'failed', error: `流程中断（已落盘 ${events.length} 条步骤记录）: ${e instanceof Error ? e.message : String(e)}`, owner: args.owner });
+        ctx.runs.set(runId, {
+            runId,
+            status: 'failed',
+            error: `流程中断（已落盘 ${events.length} 条步骤记录）: ${e instanceof Error ? e.message : String(e)}`,
+            owner: args.owner,
+            origin,
+            gateKey: gate.key,
+            gateKeySource: gate.source,
+        });
         throw e;
     }
     // D-S1：DOM 快照采集（真实浏览器分支；finalize 可能已关 tab → 捕获异常，失败不阻断 run 落盘）
@@ -396,6 +443,9 @@ export async function executeRun(ctx, args, runId) {
             pauseReason: result.pauseReason,
             owner: args.owner,
             pauseGuidance: pauseGuidance(result.pauseReason, runId), // T027/B2：结构化指引（message 层）
+            origin,
+            gateKey: gate.key,
+            gateKeySource: gate.source,
         };
         ctx.runs.set(runId, pr);
         return pr;
@@ -419,6 +469,9 @@ export async function executeRun(ctx, args, runId) {
         error: runError,
         perfNote: perfCheck.message,
         owner: args.owner,
+        origin,
+        gateKey: gate.key,
+        gateKeySource: gate.source,
     };
     ctx.runs.set(runId, r);
     // D-C2（M5 半成品 #3 接通）：run 结束后对带 cooldownKey 的步骤记账（key=flow#step#coolKey）
@@ -427,6 +480,33 @@ export async function executeRun(ctx, args, runId) {
             ctx.coolGate.record(`${flow.id}#${step.stepId}#${step.cooldownKey}`);
         }
     }
+    // 翻页防封护栏（2026-09-06，远程用户猎聘风控实证）：翻过页的 run 记同站惩罚窗口——
+    // 下一个关键词的 run 至少再等 DEEP_CRAWL_PENALTY_SECS 秒（run 间常规节流 15~70s 不足以
+    // 拉开「连翻 N 页」的节奏）。计入失败 run（翻到一半失败同样已产生深翻页行为）。
+    // T035-1（S2）：惩罚记在**本 run 的闸门 key** 上（与 acquire 同一个 key，见函数头 gate 解析）——
+    // 没有 navigate 步骤的自建流程同样进惩罚窗口，不再因「无 host」而整块跳过。
+    const flipped = result.steps.reduce((sum, s) => sum + (s.pagesFlipped ?? 0), 0);
+    if (flipped >= DEEP_CRAWL_MIN_PAGES) {
+        // 时长区间随机（150~300s）：可观测停顿不得固定值（值域纪律 ①，ANTI-BAN-PRINCIPLES）
+        const penaltySecs = deepCrawlPenaltySecs();
+        ctx.siteGate.penalize(gate.key, penaltySecs);
+        console.log(`[flow-rpa] 深度翻页冷却: 本次 run 翻页 ${flipped} 页 → ${gateKeyLabel(gate)} 下次执行至少再等 ${penaltySecs}s`);
+    }
+    // 兜底计量（B 类捷径，ANTI-BAN-PRINCIPLES ②）：记录本次 run 实际发生的非拟人兜底事件，
+    // 落 data/behavior/fallback-events.jsonl（追加式旁路台账；不写 run.json——data/ 记录格式冻结）。
+    // 目的：让「兜底率」可度量（0 是目标，>0 必须能解释），是 reactFallback/合成事件逐条消除的前提。
+    const fallbackHits = result.steps.flatMap((s) => (s.fallbacks ?? []).map((f) => ({ stepId: s.stepId, kind: f.kind, selector: f.selector })));
+    if (fallbackHits.length > 0) {
+        try {
+            const fbPath = join(ctx.store.root, 'behavior', 'fallback-events.jsonl');
+            mkdirSync(join(ctx.store.root, 'behavior'), { recursive: true });
+            appendFileSync(fbPath, JSON.stringify({ at: nowIso(), runId, flowId: flow.id, owner: args.owner, hits: fallbackHits }) + '\n', 'utf8');
+        }
+        catch {
+            // 旁路计量：写失败不影响 run
+        }
+        console.log(`[flow-rpa] 兜底计量: 本次 run 发生 ${fallbackHits.length} 次非拟人兜底（${[...new Set(fallbackHits.map((h) => h.kind))].join(', ')}）——目标 0，见 docs/ANTI-BAN-PRINCIPLES.md`);
+    }
     // T020 P0-2：run 完成后顺带清理（超窗 runs 归档/删除 + 残留 tmp 清扫；失败不阻断收尾）
     await housekeepingAfterRun(ctx);
     // T010 P2-6：会话轮换已前移至 run 开始前（每次 run 新会话）——run 尾部不再轮换
@@ -591,17 +671,12 @@ export async function rotateBrowserSession(port, edgePath, userDataDir) {
         throw new Error(`浏览器新会话 ${port} 未就绪（${edgePath}）`);
     }
 }
-/** 流程的目标站点 host（取首个 navigate 步骤的 url；无 navigate 返回 undefined —— 不节流 mock） */
+/** 流程声明的目标站点 host（T035-1 起 = **全部** navigate 步骤里最后一个；无 navigate → undefined） */
 export function flowHost(ctx, flowId) {
     const cached = ctx.registry.get(flowId);
     if (!cached)
         return undefined;
-    const nav = cached.flow.steps.find((s) => s.type === 'navigate');
-    const url = typeof nav?.params.url === 'string' ? nav.params.url : undefined;
-    if (!url)
-        return undefined;
-    const h = hostOf(url);
-    return h.length > 0 ? h : undefined;
+    return declaredNavigateHost(cached.flow.steps);
 }
 const queue = { running: false, pending: [] };
 /** 队列当前状态（自描述聚合用 D-S1；只读） */