@qing3a/flow-rpa-engine 0.1.0

package/dist/platform.js

@@ -0,0 +1,215 @@
+import { createHash } from 'node:crypto';
+import { mkdirSync, readFileSync, writeFileSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { writeJsonAtomic } from './atomic.js';
+/** 平台客户端（无状态；每次 pkg_update 独立请求） */
+export class PlatformClient {
+    baseUrl;
+    token;
+    constructor(baseUrl, token) {
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.token = token;
+    }
+    /** 拉取包 manifest（GET /api/packages/<name>，Bearer 认证） */
+    async fetchManifest(name) {
+        const url = `${this.baseUrl}/api/packages/${name}`;
+        const body = await httpGet(url, this.token);
+        let v;
+        try {
+            v = JSON.parse(body);
+        }
+        catch (e) {
+            throw new Error(`manifest 解析失败: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        const data = v && typeof v === 'object' ? v.data : undefined;
+        if (data === undefined)
+            throw new Error('响应缺少 data');
+        if (!data || typeof data !== 'object')
+            throw new Error('manifest 字段不匹配');
+        const m = data;
+        if (typeof m.name !== 'string' ||
+            typeof m.type !== 'string' ||
+            typeof m.version !== 'string' ||
+            typeof m.hash !== 'string' ||
+            !Array.isArray(m.files) ||
+            !m.files.every((f) => typeof f === 'string')) {
+            throw new Error('manifest 字段不匹配');
+        }
+        return {
+            name: m.name,
+            type: m.type,
+            version: m.version,
+            hash: m.hash,
+            files: m.files,
+            signature: typeof m.signature === 'string' ? m.signature : undefined,
+        };
+    }
+    /** 下载包内单文件（GET /api/packages/<name>/files/<f>，Bearer 认证） */
+    async fetchFile(name, file) {
+        const url = `${this.baseUrl}/api/packages/${name}/files/${file}`;
+        const bytes = await httpGetBytes(url, this.token);
+        return bytes;
+    }
+    /** 下载整个包（按 manifest.files），返回 {文件名: 内容}（按键排序） */
+    async downloadPackage(manifest) {
+        const out = new Map();
+        for (const f of [...manifest.files].sort()) {
+            const data = await this.fetchFile(manifest.name, f);
+            out.set(f, data);
+        }
+        return out;
+    }
+    /** 计算包 hash（与 md-forge hashFiles 同口径：files 按键排序，name\0content，SHA-256 hex） */
+    static computeHash(files) {
+        const map = files instanceof Map ? files : new Map(Object.entries(files));
+        const h = createHash('sha256');
+        for (const [name, data] of [...map.entries()].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) {
+            h.update(name, 'utf8');
+            h.update(Buffer.from([0]));
+            h.update(data);
+        }
+        return h.digest('hex');
+    }
+    /**
+     * M10 D-O1：上传观察包目录到平台（POST {base}/api/observations，multipart）。
+     * bundleDir 为 outbox/<flow_id>_v<version>_<run_id>/；身份前缀 = <flow_id>_v<version>_<run_id>。
+     * 返回 { status: 'accepted' | 'duplicate', dir }；网络/4xx/5xx 抛错（由调用方记台账 Failed）。
+     */
+    async uploadObservation(bundleDir) {
+        // 目录名 = 身份前缀（flow_id_v<version>_<run_id>）
+        const identity = bundleDir.split(/[\\/]/).filter(Boolean).pop() ?? '';
+        const files = readdirSync(bundleDir)
+            .filter((f) => statSync(join(bundleDir, f)).isFile())
+            .sort();
+        // 必选文件检查（D-O1：manifest/run/dom_snapshot 必选）
+        const names = new Set(files);
+        for (const req of ['manifest.json', 'run.json', 'dom_snapshot.json']) {
+            if (!names.has(req))
+                throw new Error(`观察包缺必选文件 ${req}（${bundleDir}）`);
+        }
+        // multipart 组装：字段名 files；originalname = <identity>_<file>
+        const boundary = `----flow-rpa-${Date.now().toString(36)}`;
+        const chunks = [];
+        for (const f of files) {
+            const content = readFileSync(join(bundleDir, f));
+            chunks.push(Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="files"; filename="${identity}_${f}"\r\nContent-Type: application/octet-stream\r\n\r\n`, 'utf8'));
+            chunks.push(content);
+            chunks.push(Buffer.from('\r\n', 'utf8'));
+        }
+        chunks.push(Buffer.from(`--${boundary}--\r\n`, 'utf8'));
+        const body = Buffer.concat(chunks);
+        const resp = await fetch(`${this.baseUrl}/api/observations`, {
+            method: 'POST',
+            signal: AbortSignal.timeout(60_000),
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                'Content-Type': `multipart/form-data; boundary=${boundary}`,
+            },
+            body,
+        });
+        const text = await resp.text();
+        let v;
+        try {
+            v = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`上传响应非 JSON: HTTP ${resp.status} ${text.slice(0, 120)}`);
+        }
+        if (!(resp.status >= 200 && resp.status < 300)) {
+            const msg = v && typeof v === 'object' ? v.error : undefined;
+            const detail = msg && typeof msg === 'object' ? JSON.stringify(msg).slice(0, 200) : String(msg ?? text).slice(0, 200);
+            throw new Error(`上传失败 HTTP ${resp.status}: ${detail}`);
+        }
+        const data = v && typeof v === 'object' ? v.data : undefined;
+        if (!data || typeof data !== 'object')
+            throw new Error('上传响应缺少 data');
+        const d = data;
+        if (typeof d.status !== 'string' || typeof d.dir !== 'string')
+            throw new Error('上传响应 data 字段不匹配');
+        return { status: d.status, dir: d.dir };
+    }
+}
+/** 哈希校验：下载的包文件重新计算 hash，与 manifest.hash 比对 */
+export function verifyHash(manifest, files) {
+    const actual = PlatformClient.computeHash(files);
+    if (actual !== manifest.hash) {
+        throw new Error(`哈希校验失败: 期望 ${manifest.hash} 实际 ${actual}（包可能损坏或被篡改）`);
+    }
+}
+/** 本地 flows/ 目录中某 flow 的当前版本（读 flow.json 的 version 字段；不存在返回 undefined） */
+export function localFlowVersion(flowsDir, name) {
+    const flowPath = join(flowsDir, name, 'flow.json');
+    try {
+        const v = JSON.parse(readFileSync(flowPath, 'utf8'));
+        if (typeof v.version === 'number')
+            return v.version;
+        throw new Error('本地 flow.json 缺 version');
+    }
+    catch (e) {
+        if (e instanceof Error && e.message === '本地 flow.json 缺 version')
+            throw e;
+        return undefined; // 文件不存在 → undefined
+    }
+}
+/**
+ * 执行 pkg_update：拉 manifest → 比版本 → 有更新下载 → 哈希校验 → 替换 flows/。
+ * 校验失败抛错（不落盘）。
+ */
+export async function pkgUpdate(client, flowsDir, name) {
+    // 1. 拉 manifest
+    const manifest = await client.fetchManifest(name);
+    const platformVersion = Number.parseInt(manifest.version, 10);
+    if (Number.isNaN(platformVersion)) {
+        throw new Error(`平台版本号非数字: ${manifest.version}`);
+    }
+    // 2. 本地版本比对
+    const local = localFlowVersion(flowsDir, name);
+    const mkResult = (status, msg) => ({
+        name,
+        status,
+        localVersion: local,
+        platformVersion,
+        hash: manifest.hash,
+        dir: undefined,
+        message: msg,
+    });
+    if (local !== undefined && local >= platformVersion) {
+        // 已是最新或本地更新（不回退）
+        return mkResult(local > platformVersion ? 'newer' : 'up_to_date', local > platformVersion ? '本地版本高于平台，不更新' : '已是最新版本');
+    }
+    // 3. 下载 + 哈希校验（校验失败抛错，不落盘）
+    const files = await client.downloadPackage(manifest);
+    verifyHash(manifest, files);
+    // 4. 替换本地 flows/<name>/
+    const pkgDir = join(flowsDir, name);
+    mkdirSync(pkgDir, { recursive: true });
+    for (const [f, data] of files) {
+        // 包文件直接写（flow.json / scenes.json / thesaurus.json 等）
+        writeFileSync(join(pkgDir, f), data);
+    }
+    // 本地记录一份 manifest.json（= 拉到的平台 manifest；不在 files 列表里）
+    writeJsonAtomic(join(pkgDir, 'manifest.json'), manifest);
+    return mkResult('updated', `流程包已更新到 v${platformVersion}（${files.size} 个文件）`);
+}
+/** 简单 HTTP GET（原生 fetch，Node 24 内置） */
+async function httpGet(url, token) {
+    const bytes = await httpGetBytes(url, token);
+    return new TextDecoder().decode(bytes);
+}
+async function httpGetBytes(url, token) {
+    const resp = await fetch(url, {
+        signal: AbortSignal.timeout(30_000),
+        headers: {
+            Accept: 'application/json',
+            ...(token ? { Authorization: `Bearer ${token}` } : {}),
+        },
+    });
+    const status = resp.status;
+    const body = new Uint8Array(await resp.arrayBuffer());
+    if (!(status >= 200 && status < 300)) {
+        const text = new TextDecoder().decode(body);
+        throw new Error(`HTTP ${status}: ${[...text].slice(0, 200).join('')}`);
+    }
+    return body;
+}
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

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

package/dist/record.d.ts

@@ -0,0 +1,48 @@
+import type { FlowResult } from './executor.js';
+/**
+ * 执行记录（run.json）—— L2 学习的唯一输入（移植自 Rust `record.rs`）。
+ * 契约见 docs/FLOW-SCHEMA-v1.md「执行记录」：每步一条结构化记录。
+ * executor 产出结构化 FlowResult 后，经本模块转换为可序列化的 RunRecord。
+ */
+export interface RunRecord {
+    runId: string;
+    flowId: string;
+    flowVersion: number;
+    /** done / failed（整体） */
+    status: 'done' | 'failed';
+    error?: string;
+    /** ISO 时间（如 2026-08-24T00:00:00Z） */
+    startedAt: string;
+    steps: StepRecord[];
+}
+export interface StepRecord {
+    stepId: string;
+    /** 步骤类型（navigate/click/...），与 schema 的 type 一致 */
+    type?: string;
+    /** done / failed */
+    status: 'done' | 'failed';
+    error?: string;
+    verify?: VerifyRecord;
+    /** 步骤耗时（节奏学习/冷却的输入） */
+    durationMs: number;
+    /** 输入值（input 步骤；落盘时刻已掩码 —— 掩码前移，ARCHITECTURE #6） */
+    inputValueMasked?: string;
+    /** 提取字段标签 / 是否落盘明细 / 命中元素数 / 实际生效选择器（M4 扩展，记录进 run.json） */
+    field?: string;
+    saved?: boolean;
+    count?: number;
+    selectorHit?: string;
+    /** 冷却锚点（D-C1：wait 步骤 coolKey；server 层据此记账） */
+    cooldownKey?: string;
+}
+export interface VerifyRecord {
+    waitSelector?: string;
+    passed: boolean;
+    durationMs: number;
+}
+/**
+ * 从 executor 的结构化结果构建 run.json（run_id/started_at 由调用方提供）。
+ * 掩码前移：`keywords` 为本次执行的敏感词集合，落盘时刻对步骤/流程 error 掩码
+ * （明文不落盘）。只替换关键词原文，不动失败类别短语（类别判定不受影响）。
+ */
+export declare function fromFlowResult(runId: string, flowId: string, flowVersion: number, r: FlowResult, startedAt: string, keywords: string[]): RunRecord;

package/dist/record.js

@@ -0,0 +1,42 @@
+import { maskKeywords } from './mask.js';
+/**
+ * 从 executor 的结构化结果构建 run.json（run_id/started_at 由调用方提供）。
+ * 掩码前移：`keywords` 为本次执行的敏感词集合，落盘时刻对步骤/流程 error 掩码
+ * （明文不落盘）。只替换关键词原文，不动失败类别短语（类别判定不受影响）。
+ */
+export function fromFlowResult(runId, flowId, flowVersion, r, startedAt, keywords) {
+    return {
+        runId,
+        flowId,
+        flowVersion,
+        status: r.status,
+        error: r.error ? maskKeywords(r.error, keywords) : undefined,
+        startedAt,
+        steps: r.steps.map((s) => stepToRecord(s, keywords)),
+    };
+}
+function stepToRecord(s, keywords) {
+    return {
+        stepId: s.stepId,
+        type: s.kind,
+        status: s.status,
+        error: s.error ? maskKeywords(s.error, keywords) : undefined,
+        verify: s.verify ? verifyToRecord(s.verify) : undefined,
+        durationMs: s.durationMs,
+        inputValueMasked: s.inputValueMasked,
+        field: s.field,
+        saved: s.saved,
+        count: s.count,
+        selectorHit: s.selectorHit,
+        cooldownKey: s.cooldownKey,
+    };
+}
+function verifyToRecord(v) {
+    // wait_selector 字段在契约示例中是具体的选择器；这里取 detail（验证点内容）
+    return {
+        waitSelector: v.detail,
+        passed: v.passed,
+        durationMs: v.durationMs,
+    };
+}
+//# sourceMappingURL=record.js.map

package/dist/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../src/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAgDxC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,MAAc,EACd,WAAmB,EACnB,CAAa,EACb,SAAiB,EACjB,QAAkB;IAElB,OAAO;QACL,KAAK;QACL,MAAM;QACN,WAAW;QACX,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;QAC5D,SAAS;QACT,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;KACrD,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CACnB,CAAmP,EACnP,QAAkB;IAElB,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;QAC5D,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QACvD,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;QACpC,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CAAC,CAAgB;IACtC,kDAAkD;IAClD,OAAO;QACL,YAAY,EAAE,CAAC,CAAC,MAAM;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAA;AACH,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+/**
+ * 流程定义 schema v1（移植自 Rust `engine/src/lib.rs`，语义逐条对应）。
+ *
+ * 契约要点（与 Rust 版一致）：
+ * - 顶层字段 camelCase 序列化；`platform`/`trigger`/`version` 有默认值
+ * - 步骤类型 `type` 为 snake_case；`params` 是自由键值（动作参数由执行器解释）
+ * - `verify` 可选（缺省 = 执行器无法判定成败，schema 铁律；校验层面不强制）
+ * - 字段默认值：version=1、trigger.mode=manual、verify.timeoutMs=15000
+ *
+ * TS 扩展（Rust 版无，EXECUTION-SPEC 定案）：
+ * - `inputs`（D-R6）：顶层可选参数声明，供 list_flows 返回 / run_flow 必填校验
+ * - `envCheck`（D-V1）：顶层可选环境风险检测配置（verifyUrls/dialogs），随流程包分发
+ *   （zod 默认 strip 未知键 —— 这两个字段必须显式声明，否则被丢弃）
+ *
+ * 注意：这里不做「嵌套 loop 拒绝」——那是 EXECUTION-SPEC M4 的扩展语义，
+ * 到 M4 时在 validate 层加（避免现在加验证与基线行为分叉）。
+ * 结构错误（解析失败）走 zod 错误信息；语义校验在 validate.ts。
+ */
+export declare const TriggerSchema: z.ZodDefault<z.ZodObject<{
+    mode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export type Trigger = {
+    mode: string;
+};
+export declare const StepTypeSchema: z.ZodEnum<{
+    input: "input";
+    navigate: "navigate";
+    click: "click";
+    extract: "extract";
+    next_page: "next_page";
+    loop: "loop";
+    wait: "wait";
+    finalize: "finalize";
+}>;
+/** 步骤类型（与 Rust `StepType` 枚举一一对应） */
+export type StepType = z.infer<typeof StepTypeSchema>;
+export declare const VerifySchema: z.ZodObject<{
+    waitSelector: z.ZodOptional<z.ZodString>;
+    urlContains: z.ZodOptional<z.ZodString>;
+    textContains: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$loose>;
+export type Verify = z.infer<typeof VerifySchema>;
+export declare const StepSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        input: "input";
+        navigate: "navigate";
+        click: "click";
+        extract: "extract";
+        next_page: "next_page";
+        loop: "loop";
+        wait: "wait";
+        finalize: "finalize";
+    }>;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    verify: z.ZodOptional<z.ZodObject<{
+        waitSelector: z.ZodOptional<z.ZodString>;
+        urlContains: z.ZodOptional<z.ZodString>;
+        textContains: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+export type Step = z.infer<typeof StepSchema>;
+/** 流程参数声明（D-R6，2026-08-25 定案）：name 必填；required 默认 false；description 可选 */
+export declare const InputSchema: z.ZodObject<{
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type FlowInput = z.infer<typeof InputSchema>;
+/** 环境风险检测配置（D-V1）：verifyUrls=风险 URL 子串；dialogs=弹窗（selector + 关闭按钮链） */
+export declare const EnvCheckSchema: z.ZodObject<{
+    verifyUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dialogs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        selector: z.ZodString;
+        closeSelectors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type EnvCheck = z.infer<typeof EnvCheckSchema>;
+export declare const FlowSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    platform: z.ZodDefault<z.ZodString>;
+    version: z.ZodDefault<z.ZodNumber>;
+    trigger: z.ZodDefault<z.ZodObject<{
+        mode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    envCheck: z.ZodOptional<z.ZodObject<{
+        verifyUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        dialogs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            selector: z.ZodString;
+            closeSelectors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            input: "input";
+            navigate: "navigate";
+            click: "click";
+            extract: "extract";
+            next_page: "next_page";
+            loop: "loop";
+            wait: "wait";
+            finalize: "finalize";
+        }>;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        verify: z.ZodOptional<z.ZodObject<{
+            waitSelector: z.ZodOptional<z.ZodString>;
+            urlContains: z.ZodOptional<z.ZodString>;
+            textContains: z.ZodOptional<z.ZodString>;
+            timeoutMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$loose>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Flow = z.infer<typeof FlowSchema>;
+/** 步骤类型全集（供执行器 / 记录器使用） */
+export declare const STEP_TYPES: readonly StepType[];
+/**
+ * 反序列化（结构校验）。等价 Rust `serde_json::from_str::<Flow>`。
+ * 只做结构，不做语义校验（validate.ts 的 validate 负责）。
+ */
+export declare function parseFlowJson(raw: unknown): Flow;

package/dist/schema.js

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+/**
+ * 流程定义 schema v1（移植自 Rust `engine/src/lib.rs`，语义逐条对应）。
+ *
+ * 契约要点（与 Rust 版一致）：
+ * - 顶层字段 camelCase 序列化；`platform`/`trigger`/`version` 有默认值
+ * - 步骤类型 `type` 为 snake_case；`params` 是自由键值（动作参数由执行器解释）
+ * - `verify` 可选（缺省 = 执行器无法判定成败，schema 铁律；校验层面不强制）
+ * - 字段默认值：version=1、trigger.mode=manual、verify.timeoutMs=15000
+ *
+ * TS 扩展（Rust 版无，EXECUTION-SPEC 定案）：
+ * - `inputs`（D-R6）：顶层可选参数声明，供 list_flows 返回 / run_flow 必填校验
+ * - `envCheck`（D-V1）：顶层可选环境风险检测配置（verifyUrls/dialogs），随流程包分发
+ *   （zod 默认 strip 未知键 —— 这两个字段必须显式声明，否则被丢弃）
+ *
+ * 注意：这里不做「嵌套 loop 拒绝」——那是 EXECUTION-SPEC M4 的扩展语义，
+ * 到 M4 时在 validate 层加（避免现在加验证与基线行为分叉）。
+ * 结构错误（解析失败）走 zod 错误信息；语义校验在 validate.ts。
+ */
+// ---- 顶层 ----
+export const TriggerSchema = z
+    .object({
+    // zod 4：trigger 整体缺省时应用 { mode: 'manual' }（对齐 Rust #[serde(default)] + default_trigger_mode）。
+    // 内层 mode 允许缺省（输入 { } 也通过），输出恒有 mode。
+    mode: z.string().optional(),
+})
+    .default({ mode: 'manual' });
+export const StepTypeSchema = z.enum([
+    'navigate',
+    'click',
+    'input',
+    'extract',
+    'next_page',
+    'loop',
+    'wait',
+    'finalize',
+]);
+export const VerifySchema = z
+    .object({
+    waitSelector: z.string().optional(),
+    urlContains: z.string().optional(),
+    textContains: z.string().optional(),
+    timeoutMs: z.number().default(15_000),
+})
+    .passthrough();
+export const StepSchema = z.object({
+    id: z.string(),
+    type: StepTypeSchema,
+    params: z.record(z.string(), z.unknown()).default({}),
+    verify: VerifySchema.optional(),
+});
+/** 流程参数声明（D-R6，2026-08-25 定案）：name 必填；required 默认 false；description 可选 */
+export const InputSchema = z.object({
+    name: z.string(),
+    required: z.boolean().optional(),
+    description: z.string().optional(),
+});
+/** 环境风险检测配置（D-V1）：verifyUrls=风险 URL 子串；dialogs=弹窗（selector + 关闭按钮链） */
+export const EnvCheckSchema = z.object({
+    verifyUrls: z.array(z.string()).optional(),
+    dialogs: z
+        .array(z.object({ selector: z.string(), closeSelectors: z.array(z.string()).optional() }))
+        .optional(),
+});
+export const FlowSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    platform: z.string().default(''),
+    version: z.number().default(1),
+    trigger: TriggerSchema,
+    inputs: z.array(InputSchema).optional(),
+    envCheck: EnvCheckSchema.optional(),
+    steps: z.array(StepSchema),
+});
+/** 步骤类型全集（供执行器 / 记录器使用） */
+export const STEP_TYPES = [
+    'navigate',
+    'click',
+    'input',
+    'extract',
+    'next_page',
+    'loop',
+    'wait',
+    'finalize',
+];
+/**
+ * 反序列化（结构校验）。等价 Rust `serde_json::from_str::<Flow>`。
+ * 只做结构，不做语义校验（validate.ts 的 validate 负责）。
+ */
+export function parseFlowJson(raw) {
+    return FlowSchema.parse(raw);
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/simprofile.d.ts

@@ -0,0 +1,94 @@
+/**
+ * 模拟参数差异化层（sim profile）—— 从 hr-rpa-mcp `src/core/simprofile.mjs`
+ * 完整移植（Rust `simprofile.rs` 已 1:1 复刻原版，TS 直接按 Rust 语义翻译，三者一致）。
+ *
+ * 目的：让每台机器/每个实例的拟人行为参数「基准」互不相同。首次运行时用机器指纹
+ * 生成稳定的 ±15% 乘性扰动，缓存到本地 sim-profile.json，之后每次运行读同一份缓存。
+ *
+ * 原则：
+ * - BASE_SIM 的值 = human.mjs 原硬编码值（勿改，作基准）
+ * - 只扰动「行为风格」参数；不扰动「结构边界」
+ * - 纯本地，无服务器依赖
+ */
+/** 扰动幅度（±百分比） */
+export declare const PERTURB_PCT = 0.15;
+/** 统一 PRNG 接口：next() 返回 [0,1) 浮点（对应 JS `rng()`） */
+export type Rng = () => number;
+/**
+ * 确定性 PRNG：xorshift32（对应 hr-rpa-mcp `createRng`）。
+ * `t ^= t<<13; t ^= t>>>17; t ^= t<<5; t>>>0; return (t%1e6)/1e6`
+ */
+export declare class XorShift32 {
+    private s;
+    constructor(seed: number);
+    /** 无种子默认随机（等价 Rust `XorShift32::time_seeded`）：取高精度时钟低 32 位作种子 */
+    static timeSeeded(): XorShift32;
+    next(): number;
+}
+/**
+ * mulberry32：确定性 PRNG（hr-rpa-mcp simprofile 的机器指纹扰动用）。
+ * 全部为 32 位有符号整数运算（|0 / Math.imul / >>> 0），TS 用 >>>0 保证无符号。
+ */
+export declare function mulberry32(a: number): Rng;
+/** 拟人参数配置（对应 JS BASE_SIM 全字段，camelCase） */
+export interface SimProfile {
+    jitter: number;
+    moveMedianMs: number;
+    moveSigma: number;
+    startOffsetRange: [number, number];
+    clickJitter: number;
+    hoverRangeMs: [number, number];
+    overshootProbability: number;
+    overshootPx: [number, number];
+    overshootMedianMs: number;
+    overshootSigma: number;
+    pressMedianMs: number;
+    pressSigma: number;
+    doubleClickRangeMs: [number, number];
+    wheelRatioRange: [number, number];
+    wheelInertiaStepsRange: [number, number];
+    wheelUniformStepsRange: [number, number];
+    wheelIntervalMs: [number, number];
+    dragJitter: number;
+    pressDelayMs: [number, number];
+    releaseDelayMs: [number, number];
+    dragPreMedianMs: number;
+    dragPreSigma: number;
+    dragMoveMedianMs: number;
+    dragMoveSigma: number;
+    wpmRange: [number, number];
+    errorRate: number;
+    thinkPauseChance: number;
+    thinkPauseRangeMs: [number, number];
+    finalPauseMs: number;
+    typeSigma: number;
+    typeErrSigma: number;
+    typeBackspaceSigma: number;
+    randomClickMaxClicks: number;
+    randomClickIntervalMs: number;
+}
+export declare const BASE_SIM: SimProfile;
+/** 机器指纹 → 稳定 seed：用户名/主机名/域/工作目录（不含绝对时间，同机稳定） */
+export declare function machineSeed(): number;
+/** 由 BASE_SIM 生成一份扰动后的 profile（对应 JS `perturbBase`） */
+export declare function perturbBase(rng: Rng): SimProfile;
+/** 带版本号标识的缓存文件格式（与 Rust / hr-rpa-mcp 一致：`__v` 顶键） */
+export interface ProfileFile {
+    __v: number;
+    [key: string]: unknown;
+}
+/** 加载后的 profile：带 __v（与 Rust `load_sim_profile` 返回的结构一致） */
+export interface LoadedSimProfile {
+    __v: number;
+    profile: SimProfile;
+}
+/**
+ * 加载本机模拟参数：首次生成扰动并缓存，之后读缓存（同机稳定）。
+ * 任何异常都回退到 BASE_SIM（未扰动基准），绝不阻断主流程。
+ * 等价 Rust `load_sim_profile(profile_file)`。
+ */
+export declare function loadSimProfile(profileFile: string): LoadedSimProfile;
+/** 从任意对象解析 SimProfile（字段缺失/类型不符 → null，等价 Rust from_value 的 ok()） */
+export declare function parseProfile(v: unknown): SimProfile | null;
+/** 默认缓存路径：由 app 层注入数据目录（测试传临时文件，隔离真实拟人参数） */
+export declare function defaultProfileFile(dataDir: string): string;