e10-ebuilder-prototype 0.5.0

package/README.md

@@ -0,0 +1,113 @@
+# e10-ebuilder-prototype
+
+根据 E10 **应用 ID 或后台应用地址生成应用原型，包含已发布菜单中的页面、建模列表和流程页面**。
+当前版本 0.5.0。保持我们的 TypeScript CLI 为主：CLI 管登录、菜单发现、配置采集、截图、任务队列、校验、恢复与打包；宿主 AI 根据完整截图或建模配置生成独立 HTML。CLI 不调用 LLM，不要求额外模型 API Key，也不调用 ui-code-agent 生成。
+
+## 范围与交付
+
+- `/api/cusapp/app/allMenus?appId=ID&terminalType=PC&isFront=0` 决定范围，未发布到 PC 菜单的页面/表单不生成独立入口；流程关联表单可作为字段和布局依赖采集。实际菜单名称、层级、顺序、默认项、同名入口均保留；回收站和设置排除。
+- PAGE 菜单对应普通搭建、ECode HTML、ECode React，统一截图并由宿主还原；同一页面的多个菜单共享产物而不合并入口。
+- SEARCH/VIEWPORT 按当前菜单的传统列表/NList 配置生成，不取一个表单的首列表。LAYOUT 直接打开对应增/查/改模式；支持已识别的 EB URL 和组合菜单标签。
+- 表单迁入参考包的采集契约、按钮隔离、字段控件与视图规范、增改查、主明细、评论/日志、本地 Mock 交互规范；同表单的多菜单共享记录。未知组件/条件/动作明确记录替代方式，不把未知后台动作接到线上。
+- 主框架由 CLI 固定生成，商务蓝风格；无顶部预览/设计/设置按钮。菜单仅切换本地 iframe，主框架不刷新。支持搜索、分组折叠、浏览器前进后退、刷新与移动端导航。
+- 解压后直接打开 `index.html`，不需要本地服务器。各业务 HTML 单独打开也可使用。
+
+```text
+index.html
+page/<页面ID>/<页面ID>.html
+page/<页面ID>/<名称>.png
+form/<菜单键>/<菜单键>.html
+form/<菜单键>/<名称>.png
+manifest.json
+```
+
+组合子菜单的菜单键为 `<父菜单键>-<子菜单ID>`。表单目录不用 objId 或底层 formId，避免多个入口覆盖。
+ZIP 名为 `应用页面-<appId>.zip`，位于任务目录 artifacts/；本地入口为 artifacts/site/index.html。
+原始表单配置、私有布局参考、真实参考记录 ID、草稿和认证信息不进入 ZIP。
+页面 PNG 是源站截图；表单 PNG 是从生成 HTML 离线渲染的效果图。
+
+## 使用
+
+需要 Node >=22.5、npm 和已安装 Google Chrome，playwright-core 固定 1.62.1，不下载浏览器。
+
+```sh
+npm install -g e10-ebuilder-prototype@0.5.0 --registry=https://registry.npmjs.org/
+e10-ebuilder-prototype auth set --base-url https://your-e10.example.com --eteamsid-stdin
+e10-ebuilder-prototype run --app-id 1234567890123456789 --dir ./work/app-demo --json
+# 或使用后台应用地址：
+e10-ebuilder-prototype run --app-url "https://your-e10.example.com/sp/ebdapp/detail/1234567890123456789" --dir ./work/app-demo --json
+```
+
+登录值从标准输入传入并加密保存；支持 auth status / auth status --local / auth profile list|current|use NAME。
+地址会解析 ID 并核对环境，已有任务还绑定用户与租户。ID 保持字符串，不转成浮点数。
+状态目录 `.e10-page-capture` 与 E10_PAGE_CAPTURE_HOME/CHROME 等设置沿用，既有登录无需迁移。
+
+`run` 完成确定性工作后停在 HTML，由宿主继续：
+
+```sh
+e10-ebuilder-prototype html next --dir ./work/app-demo --json
+# 宿主按 jobs 的 prompt 写入各自 outputPath，并做视觉/交互检查
+e10-ebuilder-prototype html accept --dir ./work/app-demo --kind page --page-id "<ID>" --token "<TOKEN>" --json
+e10-ebuilder-prototype html accept --dir ./work/app-demo --kind form --page-id "<菜单键>" --token "<TOKEN>" --json
+e10-ebuilder-prototype pack --dir ./work/app-demo --json
+```
+
+同一个生成队列最多 4 个任务，可按用户需求 --concurrency 1..8。page 输入 screenshotPath；form 输入 sourcePath，附带 contextPath 分片索引、guidePath 完整规范、runtimePath 固定存储脚本及 navigationPath 已发布目标映射。一个协调者串行 accept/fail/next，任务只写自己的草稿；宿主支持且允许并行时补位执行，否则如实采用顺序生成。
+
+生成文件为真实 DOM、内联 CSS/JS/SVG，无外部资源或后台调用。页面忠实还原视觉结构，空数据用一致 Mock 内容填充。表单按当前模式/字段/选项/按钮及布局依据生成，固定种子约 20 条主记录、明细每条 2–5 行；所有统计由数据推导。完整规范随 CLI 打包，不能用“能打开表格”代替验收。
+
+## 参考布局与临时记录
+
+默认只读业务记录：先读取至多一条现有记录，若可用则请求导出 HTML 作为私有布局参考；没有参考时根据全部自定义字段生成布局，报告缺项。导出可能在源站生成参考文件。
+
+与参考包相同的临时记录能力已迁入。明确允许这类采集写入时，在**新任务**加 `--allow-temporary-records`。启用后，如无法取得现有布局，按可构造字段创建最多一条带唯一标记的参考记录/表单，用它取得布局及查改按钮，随后按确切 ID 和标记删除并回查。不能可靠构造必填人员/关联/明细时使用字段兜底。
+
+创建前原子记录私有台账；响应丢失不重放写入，恢复时按精确标记只读核实；删除前再次核验归属，删除响应丢失只回查，不重复删除。清理未确认会阻止新临时写入和打包，恢复登录后 collect 先处理台账。默认不会因为读取参考包就自动开启线上写入。最终原型的操作始终只改本地 Mock 数据。
+
+## 状态与恢复
+
+`DISCOVER → COLLECT → CAPTURE → HTML → PACKAGE → DONE/PARTIAL`；需要登录时 WAITING_AUTH。
+顶层 `next|status` 只读，`html next` 分配任务。`run --dir DIR` 恢复中断，校验通过的配置/PNG/HTML复用。
+`retry` 重试失败配置/截图并重置失败生成；`html retry` 只重试 HTML。HTML/打包不读取登录环境。
+接收后需修正某页可用 `html retry --kind page|form --page-id ID --dir DIR`，只重开指定目标。
+`html fail --kind page|form --page-id ID --token TOKEN --reason TEXT` 记录生成失败，其余目标继续。
+
+待完成任务阻止打包。采集、截图或生成失败只能交付 PARTIAL 和明确失败占位；不能当成已接入表单。
+表单打包必须在离线 Chrome 初始化成功且无脚本错误；渲染失败可通过 html retry 修复。
+所有产物及最终 ZIP 以 SHA-256 校验。退出码 0 正常、2 PARTIAL、1 阻断错误。
+旧目录无 menuRequired 时保留旧清单/占位语义，使用新目录启用本次功能。
+
+固定 E10FormStore 提供 load/save/reset、navigate/parameters。主框架验证发送窗口和对象范围，按 appId:objId 存储；独立打开有 localStorage/内存回退。同表单多列表共享主数据，筛选、按钮和草稿独立。浏览器禁止持久化时回退仅维持当前会话。
+
+## 截图和资源限制
+
+PC 默认 1440×900，MOBILE-only 页面 390×844；默认并发 4。页面初始渲染上限 10 秒、稳定窗口 800ms；超时本轮失败，其他可恢复失败额外重试一次。就绪后立即继续，不固定睡眠。
+只用页面组件请求、可见加载、字体/图片、主体内容与稳定性判断；全局后台请求不阻塞。随后滚动检查、编码和清理另有边界，详见协议。
+
+截图覆盖当前已加载/可滚动内容，不自动点击标签或分页。承载 EB 主体的 iframe 完整滚动展开，普通内嵌网站保留设计视口。稳定业务错误可原样截图并带 warning，未知空白、超时、身份失效、内容丢失仍失败。源站错误截图不等于业务功能健康。
+
+每次尝试结束即关 Page，批次结束关本工具创建的上下文与 Chrome。默认最大高度 50000px、60M 像素。仅关闭自己拥有的进程；清理失败阻止完成。
+
+## 测试和 Skill 交付
+
+```sh
+npm ci --registry=https://registry.npmjs.org/
+npm test
+npm run test:package
+npm run pack:skill
+```
+
+artifacts/ 生成 npm tarball、本地版 Skill ZIP、registry 四文件版 Skill ZIP。本地版含本产品 tarball 及散列，依赖从公网 npm 安装；registry 版从公网 npm 安装固定版本，要求对应版本先发布。打包命令不会自动发布 npm 或上传 Skill。
+
+WorkBuddy 推荐提示词和执行流程见 [Skill](integrations/workbuddy-skill/SKILL.md)，迁入能力对应关系见 [表单能力核对](docs/FORM-PARITY.md)，协议见 [PROTOCOL](docs/PROTOCOL.md)。
+
+Windows 使用原生 Node，无需 Bash/WSL/Python；支持 WorkBuddy 内置 npm、中文/空格路径、受控进程清理与暂时文件占用重试。系统 Chrome 自动发现，非标准位置可指定 E10_PAGE_CAPTURE_CHROME。
+`npm run test:windows` 必须在 Windows 实机执行；macOS 的模拟分支不算实机通过，详见 [WINDOWS](docs/WINDOWS.md)。
+
+## 流程菜单（0.5.0）
+
+支持已发布的待办、已办、我提交的、共享、下属待办、全部流程、草稿、流程监控和流程新建入口，包含 WORKFLOW、明确 workflow URL 和组合子标签。只生成真实菜单；流程引用但没有独立菜单的 EB 表单仅作为字段/选项/布局依赖采集。普通表单的各菜单配置和按钮保持独立。
+
+流程列表的列、标签、筛选和按钮来自内置固定原型模板；目录接口提供真实流程名称和关联表单，不读取真实流程实例/审批权限。宿主按 CLI 的 workflow-guide 生成右侧页面，固定 E10WorkflowStore 负责本地已读、批量提交、草稿续填、收藏/关注、实例评论以及关联记录联合保存。所有流程动作仅修改本地模拟数据。流程仍使用 kind=form 队列和 form/<菜单键>/ 交付路径，job.workflowType 区分流程类别。
+
+完整流程协议见 [PROTOCOL.md](docs/PROTOCOL.md)。

package/dist/api.d.ts

@@ -0,0 +1,12 @@
+import type { E10AuthContext } from './vendor/environment-auth.js';
+/** Preserve integer identifiers before JSON.parse can round them. */
+export declare function parseApiJson(text: string): unknown;
+export declare function apiData(payload: unknown, label: string): any;
+export declare class E10Client {
+    private auth;
+    constructor(auth: E10AuthContext);
+    get origin(): string;
+    clean<T>(value: T): T;
+    request(method: 'GET' | 'POST', pathname: string, body?: unknown, multipart?: boolean, rawEnvelope?: boolean): Promise<any>;
+    reference(fileId: string): Promise<string>;
+}

package/dist/api.js

@@ -0,0 +1,125 @@
+import { CaptureError } from './common.js';
+/** Preserve integer identifiers before JSON.parse can round them. */
+export function parseApiJson(text) {
+    const quoted = text.replace(/"(?:\\.|[^"\\])*"|-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?/g, (part) => {
+        if (/^-?\d{16,}$/.test(part) &&
+            (BigInt(part) > BigInt(Number.MAX_SAFE_INTEGER) ||
+                BigInt(part) < BigInt(Number.MIN_SAFE_INTEGER)))
+            return JSON.stringify(part);
+        return part;
+    });
+    return JSON.parse(quoted);
+}
+export function apiData(payload, label) {
+    const p = payload;
+    if (p && ['401', '403'].includes(String(p.code)))
+        throw new CaptureError('E10_LOGIN_REQUIRED', '登录或权限已失效，请重新执行 auth set');
+    if (!p ||
+        typeof p !== 'object' ||
+        Array.isArray(p) ||
+        (p.code !== undefined && !['0', '200'].includes(String(p.code))) ||
+        p.status === false ||
+        p.fail === true ||
+        (typeof p.message === 'object' && p.message && String(p.message.code ?? '0') !== '0') ||
+        (p.data?.datajson && p.data.datajson.status !== true) ||
+        !('data' in p))
+        throw new CaptureError('API_RESPONSE_INVALID', `${label} 返回结构或业务状态异常`);
+    return p.data;
+}
+export class E10Client {
+    auth;
+    constructor(auth) {
+        this.auth = auth;
+    }
+    get origin() {
+        return new URL(this.auth.baseUrl).origin;
+    }
+    clean(value) {
+        const visit = (v) => {
+            if (typeof v === 'string')
+                return v.replaceAll(this.auth.eteamsId, '[redacted]');
+            if (Array.isArray(v))
+                return v.map(visit);
+            if (v && typeof v === 'object')
+                return Object.fromEntries(Object.entries(v).map(([k, x]) => [
+                    k,
+                    /^(cookie|eteamsid|authorization|password|access[_-]?token|client[_-]?secret)$/i.test(k)
+                        ? '[redacted]'
+                        : visit(x),
+                ]));
+            return v;
+        };
+        return visit(value);
+    }
+    async request(method, pathname, body, multipart = false, rawEnvelope = false) {
+        if (!pathname.startsWith('/') ||
+            pathname.startsWith('//') ||
+            new URL(pathname, this.origin).origin !== this.origin)
+            throw new CaptureError('API_ORIGIN_INVALID', '接口必须位于当前登录环境');
+        const headers = {
+            Cookie: `ETEAMSID=${this.auth.eteamsId}`,
+            Accept: 'application/json',
+            Origin: this.origin,
+            Referer: this.origin + '/',
+        };
+        let encoded;
+        if (body !== undefined) {
+            if (multipart) {
+                const data = new FormData();
+                for (const [key, value] of Object.entries(body))
+                    data.set(key, String(value));
+                encoded = data;
+            }
+            else {
+                headers['Content-Type'] = 'application/json';
+                encoded = JSON.stringify(body);
+            }
+        }
+        const response = await fetch(new URL(pathname, this.origin), {
+            method,
+            headers,
+            body: encoded,
+            redirect: 'manual',
+            signal: AbortSignal.timeout(30000),
+        });
+        if ([301, 302, 303, 307, 308, 401, 403].includes(response.status))
+            throw new CaptureError('E10_LOGIN_REQUIRED', '登录或权限已失效，请重新执行 auth set');
+        if (!response.ok)
+            throw new CaptureError('API_HTTP', `${pathname.split('?')[0]} HTTP ${response.status}`, {
+                status: response.status,
+            });
+        let payload;
+        try {
+            payload = parseApiJson(await response.text());
+        }
+        catch {
+            throw new CaptureError('API_JSON_INVALID', '接口未返回有效 JSON');
+        }
+        return this.clean(rawEnvelope ? payload : apiData(payload, pathname.split('?')[0]));
+    }
+    async reference(fileId) {
+        if (!/^\d+$/.test(fileId))
+            throw new CaptureError('REFERENCE_INVALID', '布局文件 ID 无效');
+        const response = await fetch(new URL(`/api/file/remotedownload/${fileId}/download/true`, this.origin), {
+            headers: { Cookie: `ETEAMSID=${this.auth.eteamsId}` },
+            redirect: 'manual',
+            signal: AbortSignal.timeout(30000),
+        });
+        if ([301, 302, 303, 307, 308, 401, 403].includes(response.status))
+            throw new CaptureError('E10_LOGIN_REQUIRED', '布局下载需要重新登录');
+        if (!response.ok || !response.body)
+            throw new CaptureError('REFERENCE_HTTP', `布局下载 HTTP ${response.status}`);
+        const chunks = [];
+        let size = 0;
+        for await (const chunk of response.body) {
+            size += chunk.length;
+            if (size > 20 * 1024 * 1024)
+                throw new CaptureError('REFERENCE_TOO_LARGE', '布局参考超过 20 MiB');
+            chunks.push(chunk);
+        }
+        const html = new TextDecoder('utf-8', { fatal: true }).decode(Buffer.concat(chunks));
+        if (!/<(?:html|body|div|table|style)\b/i.test(html))
+            throw new CaptureError('REFERENCE_INVALID', '下载内容不是布局 HTML');
+        return this.clean(html);
+    }
+}

package/dist/application.d.ts

@@ -0,0 +1,7 @@
+export declare function applicationInput(value: string): {
+    appId: string;
+    origin: undefined;
+} | {
+    appId: string;
+    origin: string;
+};

package/dist/application.js

@@ -0,0 +1,16 @@
+import { CaptureError, id } from './common.js';
+export function applicationInput(value) {
+    if (/^\d+$/.test(value))
+        return { appId: id(value), origin: undefined };
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new CaptureError('APP_INPUT_INVALID', '请提供应用 ID 或完整后台应用地址');
+    }
+    const match = url.pathname.match(/^\/sp\/ebdapp\/[^/]+\/(\d+)(?:\/.*)?$/);
+    if (!match || !['https:', 'http:'].includes(url.protocol) || url.username || url.password)
+        throw new CaptureError('APP_INPUT_INVALID', '应用地址应为 http(s)://环境/sp/ebdapp/入口/应用ID/...');
+    return { appId: id(match[1]), origin: url.origin };
+}

package/dist/archive.d.ts

@@ -0,0 +1,130 @@
+import type { TaskState } from './model.js';
+import { Store } from './store.js';
+export declare function pack(store: Store, s: TaskState): Promise<{
+    forms: {
+        id: string;
+        menuId: string;
+        name: string;
+        kind: "list" | "nlist" | "layout" | "workflow";
+        workflowType: import("./model.js").WorkflowType | undefined;
+        objId: string | undefined;
+        viewId: string | undefined;
+        mode: "view" | "add" | "edit" | undefined;
+        layoutId: string | undefined;
+        status: string;
+        collection: "running" | "succeeded" | "failed" | undefined;
+        warnings: string[];
+        error: {
+            code: string;
+            message: string;
+        } | undefined;
+        html: string | undefined;
+        png: string | undefined;
+        pngKind: string;
+        htmlSha256: string | undefined;
+        pngSha256: string | undefined;
+        sourceSha256: string | undefined;
+    }[] | {
+        status: string;
+        html: string | undefined;
+        png: string | undefined;
+        pngKind: string;
+        htmlSha256: string | undefined;
+        pngSha256: string | undefined;
+        id: string;
+        name: string;
+        appId: string;
+        url: string;
+    }[] | undefined;
+    pages: {
+        html: {
+            sourceHtmlSha256?: string | undefined;
+            sha256?: string | undefined;
+            bytes?: number | undefined;
+            file?: string | undefined;
+            status: string;
+            reason: string;
+            sourceSha256?: undefined;
+            promptVersion?: undefined;
+            startedAt?: undefined;
+            finishedAt?: undefined;
+            error?: undefined;
+        } | {
+            sourceHtmlSha256?: string | undefined;
+            sha256: string | undefined;
+            bytes: number | undefined;
+            file: string | undefined;
+            status: "running" | "succeeded" | "failed";
+            sourceSha256: string;
+            promptVersion: 1 | 2 | 4 | 3 | 5;
+            startedAt: string;
+            finishedAt: string | undefined;
+            error: {
+                code: string;
+                message: string;
+            } | undefined;
+            reason?: undefined;
+        } | undefined;
+        file?: string;
+        preview?: string | undefined;
+        id: string;
+        name: string;
+        url: string;
+        status?: "running" | "succeeded" | "failed" | undefined;
+        history?: import("./model.js").Attempt[] | undefined;
+        warnings?: {
+            code: string;
+            message: string;
+        }[];
+        sha256?: string;
+        width?: number;
+        height?: number;
+        bytes?: number;
+        appId: string;
+        terminal: "PC" | "MOBILE";
+        type?: "PAGE" | "ECODE_HTML" | "ECODE_REACT";
+    }[];
+    menus?: import("./model.js").MenuItem[] | undefined;
+    skippedMenus?: import("./model.js").SkippedMenu[] | undefined;
+    formSummary?: {
+        total: number;
+        integrated: number;
+        placeholders: number;
+        collection: {
+            succeeded: number;
+            failed: number;
+            pending: number;
+        };
+        html: {
+            succeeded: number;
+            failed: number;
+            running: number;
+            pending: number;
+        };
+    } | {
+        total: number;
+        integrated: number;
+        placeholders: number;
+        collection?: undefined;
+        html?: undefined;
+    } | undefined;
+    schema: number;
+    appId: string;
+    origin: string | undefined;
+    createdAt: string;
+    settings: import("./model.js").Settings;
+    status: string;
+    total: number;
+    succeeded: number;
+    failed: number;
+    html: {
+        required: boolean;
+        succeeded: number;
+        failed: number;
+        running: number;
+        pending: number;
+    };
+    appName: string | undefined;
+    entry: string | undefined;
+    templateVersion: number | undefined;
+}>;

package/dist/archive.js

@@ -0,0 +1,151 @@
+import fs from 'node:fs/promises';
+import { renameWithRetry } from './runtime-support.mjs';
+import { createWriteStream } from 'node:fs';
+import { pipeline } from 'node:stream/promises';
+import { ZipFile } from 'yazl';
+import { atomicJson, CaptureError, fileDigest } from './common.js';
+import { buildSite } from './site.js';
+export async function pack(store, s) {
+    const status = await store.status(s);
+    if (!s.pages ||
+        status.pending ||
+        status.collection.pending ||
+        status.temporaryRecords.pending ||
+        status.state === 'DISCOVER')
+        throw new CaptureError('CAPTURE_INCOMPLETE', '菜单发现、表单采集或页面截图未完成，请执行 run');
+    if (status.html.pending)
+        throw new CaptureError('HTML_INCOMPLETE', '仍有待生成或未接收的 HTML，先执行 html next 并由宿主 AI 完成');
+    const partial = !!(status.failed ||
+        status.collection.failed ||
+        (s.htmlRequired && status.html.failed));
+    delete s.archive;
+    await store.save(s);
+    const site = s.siteRequired ? await buildSite(store, s, status) : undefined;
+    const manifest = {
+        schema: s.menuRequired ? 4 : 3,
+        appId: s.appId,
+        origin: s.environment?.origin,
+        createdAt: new Date().toISOString(),
+        settings: s.settings,
+        status: partial ? 'PARTIAL' : 'DONE',
+        total: status.total,
+        succeeded: status.succeeded,
+        failed: status.failed,
+        html: status.html,
+        appName: s.appName,
+        entry: site ? 'index.html' : undefined,
+        templateVersion: site?.templateVersion,
+        ...(s.menuRequired
+            ? { menus: s.menus, skippedMenus: s.skippedMenus, formSummary: status.forms }
+            : {}),
+        forms: s.menuRequired
+            ? (s.formPages || []).map((f, i) => {
+                const item = site?.items.find((item) => item.kind === 'form' && item.id === f.id);
+                return {
+                    id: f.id,
+                    menuId: f.menuId,
+                    name: f.name,
+                    kind: f.kind,
+                    workflowType: f.workflowType,
+                    objId: status.formResults[i]?.objId,
+                    viewId: f.viewId,
+                    mode: f.mode,
+                    layoutId: f.layoutId,
+                    status: item?.available ? 'succeeded' : 'failed',
+                    collection: status.formResults[i]?.status,
+                    warnings: status.formResults[i]?.warnings || [],
+                    error: status.formResults[i]?.error || status.formHtmlResults[i]?.error,
+                    html: item?.html,
+                    png: item?.png,
+                    pngKind: item?.available ? 'generated' : 'placeholder',
+                    htmlSha256: item && site?.metadata.get(item.html)?.sha256,
+                    pngSha256: item?.png && site?.metadata.get(item.png)?.sha256,
+                    sourceSha256: status.formResults[i]?.sha256,
+                };
+            })
+            : s.forms?.map((f) => ({
+                ...f,
+                status: 'not-integrated',
+                html: site?.items.find((i) => i.kind === 'form' && i.id === f.id)?.html,
+                png: site?.items.find((i) => i.kind === 'form' && i.id === f.id)?.png,
+                pngKind: 'placeholder',
+                htmlSha256: site?.metadata.get(site.items.find((i) => i.kind === 'form' && i.id === f.id).html)?.sha256,
+                pngSha256: site?.metadata.get(site.items.find((i) => i.kind === 'form' && i.id === f.id).png)?.sha256,
+            })),
+        pages: s.pages.map((p, i) => {
+            const r = status.htmlResults[i];
+            const html = !s.htmlRequired
+                ? undefined
+                : status.results[i]?.status !== 'succeeded'
+                    ? { status: 'skipped', reason: '截图失败，未生成 HTML' }
+                    : r && {
+                        status: r.status,
+                        file: r.file,
+                        sha256: r.sha256,
+                        bytes: r.bytes,
+                        sourceSha256: r.sourceSha256,
+                        promptVersion: r.promptVersion,
+                        startedAt: r.startedAt,
+                        finishedAt: r.finishedAt,
+                        error: r.error,
+                    };
+            const preview = site?.items.find((item) => item.kind === 'page' && item.id === p.id);
+            return {
+                ...p,
+                ...status.results[i],
+                ...(preview ? { file: preview.png, preview: preview.html } : {}),
+                html: html && {
+                    ...html,
+                    ...(preview && 'file' in html && html.file
+                        ? {
+                            file: preview.html,
+                            ...site.metadata.get(preview.html),
+                            sourceHtmlSha256: html.sha256,
+                        }
+                        : {}),
+                },
+            };
+        }),
+    };
+    await fs.mkdir(store.artifacts, { recursive: true });
+    await atomicJson(store.artifact('manifest.json'), manifest);
+    const siteReceipt = await site?.finish(manifest);
+    const filename = `应用页面-${s.appId}.zip`;
+    const temp = store.artifact(`${filename}.tmp`);
+    const zip = new ZipFile();
+    if (siteReceipt)
+        for (const file of siteReceipt.files)
+            zip.addFile(store.artifact(file.path), file.path.slice('site/'.length));
+    else
+        zip.addBuffer(Buffer.from(JSON.stringify(manifest, null, 2)), 'manifest.json');
+    for (const [i, r] of status.results.entries()) {
+        if (!site && r?.status === 'succeeded' && r.file)
+            zip.addFile(store.artifact(r.file), r.file);
+        const html = status.htmlResults[i];
+        if (!site && s.htmlRequired && (await store.verifiedHtml(html, r)))
+            zip.addFile(store.artifact(html.file), html.file);
+        for (const a of r?.history || [])
+            if (a.diagnostic) {
+                await fs.access(store.artifact(a.diagnostic));
+                zip.addFile(store.artifact(a.diagnostic), a.diagnostic);
+            }
+    }
+    try {
+        const writing = pipeline(zip.outputStream, createWriteStream(temp, { mode: 0o600 }));
+        zip.end();
+        await writing;
+        await renameWithRetry(temp, store.artifact(filename));
+    }
+    finally {
+        await fs.rm(temp, { force: true });
+    }
+    s.archive = {
+        path: filename,
+        sha256: await fileDigest(store.artifact(filename)),
+        completedAt: new Date().toISOString(),
+        partial,
+        site: siteReceipt,
+    };
+    await store.save(s);
+    return manifest;
+}

package/dist/capture.d.ts

@@ -0,0 +1,15 @@
+import type { TaskState } from './model.js';
+import type { E10AuthContext } from './vendor/environment-auth.js';
+import { Store } from './store.js';
+export declare function launchChrome(): Promise<{
+    browser: import("playwright-core").Browser;
+    pid: number;
+    version: string;
+    directory: string;
+    close: () => Promise<void>;
+}>;
+export declare function capture(store: Store, state: TaskState, auth: E10AuthContext, options?: {
+    retryFailed?: boolean;
+    requireEntrance?: boolean;
+    progress?: (event: unknown) => void;
+}): Promise<void>;