pageqa 0.1.0 → 0.3.0

package/dist/jev.js

@@ -0,0 +1,103 @@
+/**
+ * Jev（TypeSafe System One）API 客户端
+ *
+ * Jev 是一个结构化决策模型（System One），不做文本生成，只返回
+ * 校准后的概率分布。适合用来增强断言验证的语义判断能力。
+ *
+ * API 文档：https://docs.typesafe.ai
+ * Endpoint: POST https://api.typesafe.ai/v1/systemone
+ *
+ * 用法：
+ *   const client = new JevClient(config);
+ *   if (client.enabled) {
+ *     const prob = await client.assertText(pageText, expectation);
+ *     // prob ∈ [0, 1]，超过阈值即判定成立
+ *   }
+ */
+const DEFAULT_ENDPOINT = "https://api.typesafe.ai/v1/systemone";
+const DEFAULT_TIMEOUT = 15_000; // 毫秒
+/** Jev 客户端 —— 封装对 TypeSafe API 的调用 */
+export class JevClient {
+    cfg;
+    debug;
+    constructor(cfg, debug = false) {
+        this.cfg = cfg;
+        this.debug = debug;
+    }
+    /** 当 API 密钥不为空时视为可用 */
+    get enabled() {
+        return this.cfg.enabled && Boolean(this.cfg.apiKey);
+    }
+    get threshold() {
+        return this.cfg.threshold;
+    }
+    /**
+     * 向 Jev API 发送评估请求
+     * @param state   待评估的内容（字符串 / 对象 / 数组）
+     * @param questions  问题定义，key 为答案返回时的 id
+     */
+    async evaluate(state, questions) {
+        const t0 = Date.now();
+        if (this.debug) {
+            process.stderr.write(`[jev] POST /v1/systemone model=${this.cfg.model} state_len=${state.length}\n`);
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT);
+        try {
+            const resp = await fetch(DEFAULT_ENDPOINT, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.cfg.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: this.cfg.model,
+                    state,
+                    questions,
+                }),
+                signal: controller.signal,
+            });
+            if (!resp.ok) {
+                const body = await resp.text();
+                throw new Error(`Jev API ${resp.status}: ${body}`);
+            }
+            const result = (await resp.json());
+            if (this.debug) {
+                const answer = result.answers?.["assertion_check"];
+                const noul = answer?.type === "noul" ? answer.noul : undefined;
+                process.stderr.write(`[jev] 响应 ${resp.status} 耗时=${Date.now() - t0}ms noul=${noul} usage=${JSON.stringify(result.usage)}\n`);
+            }
+            return result;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * 语义判断：页面文本是否匹配断言期望
+     * @returns 匹配概率 [0, 1]
+     */
+    async assertText(pageText, expectation) {
+        const t0 = Date.now();
+        if (this.debug) {
+            process.stderr.write(`[jev] assertText 期望="${expectation}" page_len=${pageText.length}\n`);
+        }
+        const resp = await this.evaluate(pageText, {
+            assertion_check: {
+                type: "noul",
+                instructions: `以下是一段浏览器页面的快照文本。请判断它是否包含或等效于给定的断言期望。考虑大小写变体、同义词、近义表达和格式差异。"${expectation}"`,
+                criteria: {
+                    yes: "页面文本中包含或等效于期望的内容",
+                    no: "页面文本中没有找到与期望相关的内容",
+                },
+            },
+        });
+        const answer = resp.answers?.["assertion_check"];
+        const noul = answer?.type === "noul" ? answer.noul : 0;
+        if (this.debug) {
+            process.stderr.write(`[jev] assertText 结果 noul=${noul} 阈值=${this.cfg.threshold} 耗时=${Date.now() - t0}ms\n`);
+        }
+        return noul;
+    }
+}
+//# sourceMappingURL=jev.js.map

package/dist/jev.js.map

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

package/dist/llm.js

@@ -2,12 +2,12 @@ import { createModels, createProvider } from "@earendil-works/pi-ai";
 import * as openaiCompletions from "@earendil-works/pi-ai/api/openai-completions";
 import { loadConfig } from "./config.js";
 /**
- * LLM 后端：基于 @earendil-works/pi-ai 构造一个指向 CodeBuddy 本地反代的自定义 provider。
+ * LLM 后端：基于 @earendil-works/pi-ai 构造一个指向可配置的 OpenAI 兼容端点的自定义 provider。
  *
  * 配置优先级（高 -> 低）：环境变量 PAGEQA_LLM_*  >  用户配置文件（~/.pageqa/config.json）  >  内置默认值。
- * 首次运行会自动在用户主目录创建配置文件，便于用户修改模型/反代地址/密钥。
+ * 首次运行会自动在用户主目录创建配置文件，便于用户修改模型/端点地址/密钥。
  */
-const PROVIDER_ID = "codebuddy";
+const PROVIDER_ID = "pageqa";
 const MODELS = [
     { id: "hunyuan-2.0-instruct", name: "Hunyuan 2.0 Instruct", contextWindow: 32000, maxOutput: 64000 },
     { id: "hy3", name: "Hy3", contextWindow: 192000, maxOutput: 64000 },
@@ -16,7 +16,7 @@ const MODELS = [
 /** 构造一个静态解析的 ApiKeyAuth（避免交互式 env 探测）。 */
 function staticApiKeyAuth(apiKey, baseUrl) {
     return {
-        name: "CodeBuddy Proxy",
+        name: "OpenAI Compatible",
         resolve: async () => ({ auth: { apiKey, baseUrl }, source: "static" }),
     };
 }
@@ -28,7 +28,7 @@ export function createLlmBackend() {
     const models = createModels();
     const provider = createProvider({
         id: PROVIDER_ID,
-        name: "CodeBuddy (本地反代)",
+        name: "OpenAI Compatible (自定义端点)",
         auth: { apiKey: staticApiKeyAuth(DEFAULT_API_KEY, DEFAULT_BASE_URL) },
         models: MODELS.map((m) => ({
             id: m.id,
@@ -55,7 +55,7 @@ export function createLlmBackend() {
     models.setProvider(provider);
     const model = models.getModel(PROVIDER_ID, DEFAULT_MODEL);
     if (!model) {
-        throw new Error(`未找到模型 ${DEFAULT_MODEL}（provider=${PROVIDER_ID}）。请确认 CodeBuddy 反代可用。`);
+        throw new Error(`未找到模型 ${DEFAULT_MODEL}（provider=${PROVIDER_ID}）。请检查 ~/.pageqa/config.json 中的 model 与 baseUrl 配置。`);
     }
     return { models, model };
 }

package/dist/llm.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm.js","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAwB,MAAM,uBAAuB,CAAC;AAC3F,OAAO,KAAK,iBAAiB,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;GAKG;AAEH,MAAM,WAAW,GAAG,WAAW,CAAC;AAShC,MAAM,MAAM,GAA2B;IACrC,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,sBAAsB,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE;IACpG,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE;IACnE,EAAE,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,qBAAqB,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;CACzG,CAAC;AAEF,0CAA0C;AAC1C,SAAS,gBAAgB,CAAC,MAAc,EAAE,OAAe;IACvD,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAAC;IACrC,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC;IACnC,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC;IAChC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,cAAc,CAAC;QAC9B,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC,eAAe,EAAE,gBAAgB,CAAC,EAAE;QACrE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,oBAAoB;YACzB,QAAQ,EAAE,WAAW;YACrB,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,CAAC,MAAM,CAAC;YACf,SAAS,EAAE,KAAK;YAChB,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;YAC1D,MAAM,EAAE;gBACN,aAAa,EAAE,KAAK;gBACpB,qBAAqB,EAAE,KAAK;gBAC5B,uBAAuB,EAAE,KAAK;gBAC9B,cAAc,EAAE,YAAY;gBAC5B,0BAA0B,EAAE,KAAK;aAClC;SACF,CAAC,CAAC;QACH,GAAG,EAAE,iBAAiB;KACvB,CAAC,CAAC;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE7B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,SAAS,aAAa,aAAa,WAAW,uBAAuB,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAwB,MAAM,uBAAuB,CAAC;AAC3F,OAAO,KAAK,iBAAiB,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;GAKG;AAEH,MAAM,WAAW,GAAG,QAAQ,CAAC;AAS7B,MAAM,MAAM,GAAqB;IAC/B,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,sBAAsB,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE;IACpG,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE;IACnE,EAAE,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,qBAAqB,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;CACzG,CAAC;AAEF,0CAA0C;AAC1C,SAAS,gBAAgB,CAAC,MAAc,EAAE,OAAe;IACvD,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAAC;IACrC,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC;IACnC,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC;IAChC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,cAAc,CAAC;QAC9B,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,2BAA2B;QACjC,IAAI,EAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC,eAAe,EAAE,gBAAgB,CAAC,EAAE;QACrE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,oBAAoB;YACzB,QAAQ,EAAE,WAAW;YACrB,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,CAAC,MAAM,CAAC;YACf,SAAS,EAAE,KAAK;YAChB,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;YAC1D,MAAM,EAAE;gBACN,aAAa,EAAE,KAAK;gBACpB,qBAAqB,EAAE,KAAK;gBAC5B,uBAAuB,EAAE,KAAK;gBAC9B,cAAc,EAAE,YAAY;gBAC5B,0BAA0B,EAAE,KAAK;aAClC;SACF,CAAC,CAAC;QACH,GAAG,EAAE,iBAAiB;KACvB,CAAC,CAAC;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE7B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,SAAS,aAAa,aAAa,WAAW,oDAAoD,CACnG,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/report.d.ts

@@ -14,3 +14,14 @@ export interface TestReport {
  * 并用「断言「X」：成立。证据...」句式。无法解析时降级为基于 PASS/FAIL 关键字的整体判断。
  */
 export declare function buildReport(input: string, transcript: string): TestReport;
+/** 统计用例（自然语言测试步骤）中的断言数量，用于校验执行完整性。 */
+export declare function countAssertions(script: string): number;
+/**
+ * 解析 agent 的进度声明「步骤完成：M/N」。
+ * 取最后一次声明：续跑时 agent 会输出多条进度，只有最后一条代表当前状态。
+ */
+export declare function parseProgress(text: string): {
+    done: number;
+    total: number;
+} | null;
+export declare function parseAssertions(text: string): AssertionResult[];

package/dist/report.js

@@ -10,32 +10,88 @@ export function buildReport(input, transcript) {
     }
     else {
         // 无结构化断言：依据关键字与「不成立/失败」判定
-        const lowered = transcript.toLowerCase();
         const negative = /不成立|未找到|失败|不存在|not found|fail|missing/.test(transcript);
         status = negative ? "fail" : "pass";
     }
+    // 完整性校验：用例里写了 N 条断言，就应当看到 N 条结果；
+    // 少了解析结果说明 agent 只跑了其中一部分（长流程最容易半途结束）。
+    const expected = countAssertions(input);
+    if (expected > 0 && assertions.length < expected) {
+        status = "fail";
+        assertions.push({
+            expectation: `用例中的断言全部执行（实际 ${assertions.length}/${expected}）`,
+            verdict: "fail",
+            evidence: "解析到的断言少于用例中的断言数量，疑似步骤未执行完就结束",
+        });
+    }
+    // agent 自报的步骤进度未跑满，同样判失败。
+    const progress = parseProgress(transcript);
+    if (progress && progress.done < progress.total) {
+        status = "fail";
+        assertions.push({
+            expectation: `全部步骤执行完成（${progress.done}/${progress.total}）`,
+            verdict: "fail",
+            evidence: "agent 自报的步骤完成度不足",
+        });
+    }
     const summary = extractSummary(transcript);
     return { status, assertions, summary, transcript };
 }
-function parseAssertions(text) {
+/** 统计用例（自然语言测试步骤）中的断言数量，用于校验执行完整性。 */
+export function countAssertions(script) {
+    return (script.match(/断言/g) ?? []).length;
+}
+/**
+ * 解析 agent 的进度声明「步骤完成：M/N」。
+ * 取最后一次声明：续跑时 agent 会输出多条进度，只有最后一条代表当前状态。
+ */
+export function parseProgress(text) {
+    const re = /步骤完成\s*[:：]\s*(\d+)\s*[/／]\s*(\d+)/g;
+    const matches = [...text.matchAll(re)];
+    const m = matches.at(-1);
+    if (!m)
+        return null;
+    const done = Number(m[1]);
+    const total = Number(m[2]);
+    if (!Number.isFinite(done) || !Number.isFinite(total) || total <= 0)
+        return null;
+    return { done, total };
+}
+export function parseAssertions(text) {
     const results = [];
-    // 匹配两种常见句式：
-    //   断言「X」：成立/不成立。证据...
+    // 预处理：
+    //   1) 去掉 markdown 加粗标记（agent 常输出「…：**成立**」）
+    //   2) 把「成立/不成立」前的换行折回同一行
+    const cleaned = text
+        .replace(/\*\*|__/g, "")
+        .replace(/[ \t]*\n[ \t]*(?=(?:成立|不成立))/g, "");
+    // 匹配两种常见句式（描述里可含「」/引号等标点）：
+    //   断言 X：成立/不成立。证据...
     //   断言「X」成立。证据...
-    const re = /断言[「"']?([^」"']+?)[""」]?\s*(?:[:：]\s*)?(成立|不成立)/g;
+    const re = /断言\s*(.+?)\s*(?:[:：]\s*)?(不成立|成立)/g;
     let m;
-    while ((m = re.exec(text)) !== null) {
-        const expectation = m[1].trim();
+    while ((m = re.exec(cleaned)) !== null) {
+        const expectation = stripEdges(m[1]);
         const verdict = m[2] === "成立" ? "pass" : "fail";
-        const after = text.slice(m.index + m[0].length).split("\n")[0].trim();
-        const evidence = after.startsWith("。") ? after.slice(1).trim() : after;
+        const after = cleaned.slice(m.index + m[0].length).split("\n")[0];
+        const evidence = stripEdges(after);
         results.push({ expectation, verdict, evidence: evidence || undefined });
     }
     return results;
 }
+/** 去掉首尾的连接符/标点噪声（agent 常写「…：**成立**，证据…」「…」——成立）。 */
+function stripEdges(text) {
+    return text
+        .replace(/^[\s,，。、;；:：]+/, "")
+        .replace(/[\s,，。、;；:：\-—]+$/, "")
+        .trim();
+}
 function extractSummary(text) {
     // 取最后一段非空文本作为摘要
-    const paras = text.split("\n").map((l) => l.trim()).filter(Boolean);
+    const paras = text
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean);
     return paras.at(-1) ?? "";
 }
 //# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -1 +1 @@
-{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,UAAkB;IAC3D,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAE/C,IAAI,MAAuB,CAAC;IAC5B,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3E,CAAC;SAAM,CAAC;QACN,0BAA0B;QAC1B,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,uCAAuC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1E,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACtC,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,YAAY;IACZ,uBAAuB;IACvB,kBAAkB;IAClB,MAAM,EAAE,GAAG,kDAAkD,CAAC;IAC9D,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,IAAI,SAAS,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,gBAAgB;IAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpE,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"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"}

package/dist/vars.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 脚本运行时变量：读取测试脚本时把 `${...}` 占位符替换为本次运行的实际取值，
+ * 避免用例名称里的时间戳被写死（例如反复运行会撞名）。
+ *
+ * 支持 `${名称}` 与 `${名称:<格式>}` 两种写法：
+ *   - timestamp  -> yyyyMMddHHmm（默认格式）
+ *   - date       -> yyyyMMdd
+ *   - time       -> HHmmss
+ *   - datetime   -> yyyyMMddHHmmss
+ * 自定义格式支持 yyyy / yy / MM / dd / HH / mm / ss / SSS 组合，例如
+ * `${timestamp:yyyy-MM-dd HH:mm}`。
+ *
+ * 未识别的名称或格式原样保留，因此脚本里写 `${PATH}` 之类的字面量不会被误替换。
+ */
+/** 按本机本地时间格式化，支持 yyyy/yy/MM/dd/HH/mm/ss/SSS。 */
+export declare function formatLocalTime(date: Date, pattern: string): string;
+/** 展开脚本中的运行时变量占位符；同一脚本共用同一时刻，保证各处取值一致。 */
+export declare function expandVars(script: string, now?: Date): string;
+/** 供 `--help`/文档展示的占位符清单（读取脚本时按运行时本地时间展开）。 */
+export declare const VAR_HELP: string;

package/dist/vars.js

@@ -0,0 +1,70 @@
+/**
+ * 脚本运行时变量：读取测试脚本时把 `${...}` 占位符替换为本次运行的实际取值，
+ * 避免用例名称里的时间戳被写死（例如反复运行会撞名）。
+ *
+ * 支持 `${名称}` 与 `${名称:<格式>}` 两种写法：
+ *   - timestamp  -> yyyyMMddHHmm（默认格式）
+ *   - date       -> yyyyMMdd
+ *   - time       -> HHmmss
+ *   - datetime   -> yyyyMMddHHmmss
+ * 自定义格式支持 yyyy / yy / MM / dd / HH / mm / ss / SSS 组合，例如
+ * `${timestamp:yyyy-MM-dd HH:mm}`。
+ *
+ * 未识别的名称或格式原样保留，因此脚本里写 `${PATH}` 之类的字面量不会被误替换。
+ */
+const PRESETS = {
+    timestamp: "yyyyMMddHHmm",
+    date: "yyyyMMdd",
+    time: "HHmmss",
+    datetime: "yyyyMMddHHmmss",
+};
+const PLACEHOLDER = /\$\{([A-Za-z_][A-Za-z0-9_]*)(?::([^}]*))?\}/g;
+function pad(n, len) {
+    return String(n).padStart(len, "0");
+}
+/** 按本机本地时间格式化，支持 yyyy/yy/MM/dd/HH/mm/ss/SSS。 */
+export function formatLocalTime(date, pattern) {
+    return pattern.replace(/yyyy|yy|MM|dd|HH|mm|ss|SSS/g, (token) => {
+        switch (token) {
+            case "yyyy":
+                return pad(date.getFullYear(), 4);
+            case "yy":
+                return pad(date.getFullYear() % 100, 2);
+            case "MM":
+                return pad(date.getMonth() + 1, 2);
+            case "dd":
+                return pad(date.getDate(), 2);
+            case "HH":
+                return pad(date.getHours(), 2);
+            case "mm":
+                return pad(date.getMinutes(), 2);
+            case "ss":
+                return pad(date.getSeconds(), 2);
+            case "SSS":
+                return pad(date.getMilliseconds(), 3);
+            default:
+                return token;
+        }
+    });
+}
+/** 展开脚本中的运行时变量占位符；同一脚本共用同一时刻，保证各处取值一致。 */
+export function expandVars(script, now = new Date()) {
+    return script.replace(PLACEHOLDER, (whole, name, pattern) => {
+        const preset = Object.prototype.hasOwnProperty.call(PRESETS, name)
+            ? PRESETS[name]
+            : undefined;
+        if (preset === undefined)
+            return whole;
+        const fmt = pattern?.trim();
+        return formatLocalTime(now, fmt ? fmt : preset);
+    });
+}
+/** 供 `--help`/文档展示的占位符清单（读取脚本时按运行时本地时间展开）。 */
+export const VAR_HELP = [
+    "  ${timestamp}                 yyyyMMddHHmm（如 202609191146）",
+    "  ${date} / ${time}            yyyyMMdd / HHmmss",
+    "  ${datetime}                  yyyyMMddHHmmss",
+    "  ${timestamp:<格式>}          自定义格式，支持 yyyy/yy/MM/dd/HH/mm/ss/SSS",
+    "                               例：${timestamp:yyyy-MM-dd HH:mm}",
+].join("\n");
+//# sourceMappingURL=vars.js.map

package/dist/vars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vars.js","sourceRoot":"","sources":["../src/vars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,OAAO,GAA2B;IACtC,SAAS,EAAE,cAAc;IACzB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,gBAAgB;CAC3B,CAAC;AAEF,MAAM,WAAW,GAAG,8CAA8C,CAAC;AAEnE,SAAS,GAAG,CAAC,CAAS,EAAE,GAAW;IACjC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,eAAe,CAAC,IAAU,EAAE,OAAe;IACzD,OAAO,OAAO,CAAC,OAAO,CAAC,6BAA6B,EAAE,CAAC,KAAK,EAAE,EAAE;QAC9D,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,OAAO,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;YACpC,KAAK,IAAI;gBACP,OAAO,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;YAC1C,KAAK,IAAI;gBACP,OAAO,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACrC,KAAK,IAAI;gBACP,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;YAChC,KAAK,IAAI;gBACP,OAAO,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;YACjC,KAAK,IAAI;gBACP,OAAO,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;YACnC,KAAK,IAAI;gBACP,OAAO,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;YACnC,KAAK,KAAK;gBACR,OAAO,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC;YACxC;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,MAAY,IAAI,IAAI,EAAE;IAC/D,OAAO,MAAM,CAAC,OAAO,CACnB,WAAW,EACX,CAAC,KAAa,EAAE,IAAY,EAAE,OAAgB,EAAE,EAAE;QAChD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;YAChE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACf,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACvC,MAAM,GAAG,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5B,OAAO,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC,CACF,CAAC;AACJ,CAAC;AAED,8CAA8C;AAC9C,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,6DAA6D;IAC7D,kDAAkD;IAClD,+CAA+C;IAC/C,kEAAkE;IAClE,gEAAgE;CACjE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/examples/element-plus-upload.md

@@ -0,0 +1,13 @@
+# Element Plus 上传组件用例：点击 Click to upload 上传本地图片
+
+> 本文件是 pageqa 的自然语言测试脚本。`# ` 标题与本节说明会被忽略，只有 `## ` 场景下的内容会被执行。
+> 前置：bsk daemon 已连接一个真实浏览器；本地文件 `D:\Downloads\二维码.png` 存在。
+
+## U1 点击 Click to upload 上传文件并校验文件出现在上传列表
+
+打开 https://element-plus.org/zh-CN/component/upload
+读取页面内容，确认已进入 Element Plus 的 Upload 上传组件文档页
+在「基础用法」示例中定位显示「Click to upload」的上传触发按钮
+点击该「Click to upload」按钮并上传本地文件 D:\Downloads\二维码.png（用 upload 工具把该按钮作为触发元素，不要单独 click，否则会弹出无法自动化的系统文件选择框）
+等待 2 秒，让上传列表完成渲染
+断言页面中已出现上传的文件名 二维码.png

package/examples/github-star.md

@@ -0,0 +1,19 @@
+# GitHub 仓库 Star 用例：klren0312/pageqa
+
+> 本文件是 pageqa 的自然语言测试脚本。`# ` 标题与本节说明会被忽略，只有 `## ` 场景下的内容会被执行。
+> 前置：bsk daemon 已连接一个**已登录 GitHub** 的真实浏览器；未登录时 Star 会跳转登录页，G2 将 FAIL。
+
+## G1 打开仓库页并校验内容
+
+打开 https://github.com/klren0312/pageqa
+读取页面内容
+断言标题包含 pageqa
+断言页面包含 klren0312/pageqa
+
+## G2 为仓库点 Star（幂等）
+
+打开 https://github.com/klren0312/pageqa
+读取页面内容，定位页面右上角的星标按钮（当前显示为「Star」或「Starred」）
+如果星标按钮显示「Star」，点击它并等待 2 秒
+如果星标按钮已经显示「Starred」，跳过点击，直接进入断言
+断言星标按钮当前显示为「Starred」

package/examples/smoke.md

@@ -10,6 +10,3 @@
 
 ## A3 失败场景（断言不存在文本）
 打开 https://example.com 并断言页面包含 'THIS_TEXT_SHOULD_NOT_EXIST_XYZ'
-
-> 说明：自然语言意图由 pi-agent-core 驱动的 agent 解析为浏览器操作步骤，并经 browserskill（bsk）连接真实浏览器执行。
-> 默认 LLM 后端为 CodeBuddy 本地反代（混元），无需官网 Key。

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "pageqa",
-  "version": "0.1.0",
-  "description": "用自然语言驱动的页面测试 agent：基于 pi-agent-core 编排 + browserskill 驱动真实浏览器，经 CodeBuddy 反代（混元）实现免 Key 自然语言测试。",
+  "version": "0.3.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/klren0312/pageqa.git"
+  },
+  "description": "用自然语言驱动的页面 QA agent：pi-agent-core 编排测试步骤，browserskill(bsk) 驱动真实浏览器执行，LLM 端点可配置（OpenAI 兼容）；输出文本/JSON 报告与可直接接入 CI 的退出码。",
   "type": "module",
   "bin": {
     "pageqa": "dist/index.js"
@@ -12,6 +16,7 @@
     "start": "node dist/index.js",
     "pretest": "npm run build",
     "test": "node --test tests/smoke.test.mjs",
+    "test:unit": "npm run build && node --test tests/report.test.mjs",
     "prepublishOnly": "npm run build"
   },
   "files": [