e10-ebuilder-prototype 0.5.0 → 0.5.4

package/README.md

@@ -1,7 +1,7 @@
 # e10-ebuilder-prototype
 
 根据 E10 **应用 ID 或后台应用地址生成应用原型，包含已发布菜单中的页面、建模列表和流程页面**。
-当前版本 0.5.0。保持我们的 TypeScript CLI 为主：CLI 管登录、菜单发现、配置采集、截图、任务队列、校验、恢复与打包；宿主 AI 根据完整截图或建模配置生成独立 HTML。CLI 不调用 LLM，不要求额外模型 API Key，也不调用 ui-code-agent 生成。
+版本 0.5.4，默认并发 6。保持我们的 TypeScript CLI 为主：CLI 管登录、菜单发现、配置采集、截图、任务队列、校验、恢复与打包；宿主 AI 根据完整截图或建模配置生成独立 HTML。CLI 不调用 LLM，不要求额外模型 API Key，也不调用 ui-code-agent 生成。
 
 ## 范围与交付
 
@@ -31,7 +31,7 @@ ZIP 名为 `应用页面-<appId>.zip`，位于任务目录 artifacts/；本地
 需要 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/
+npm install -g e10-ebuilder-prototype@0.5.4 --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
 # 或使用后台应用地址：
@@ -45,17 +45,28 @@ e10-ebuilder-prototype run --app-url "https://your-e10.example.com/sp/ebdapp/det
 `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 next --dir ./work/app-demo --brief --json
+# 宿主读取各 job 的 promptPath，写完整草稿；CLI 离线渲染后实际看图
+e10-ebuilder-prototype html inspect --dir ./work/app-demo --kind page --page-id "<ID>" --token "<TOKEN>" --json
+e10-ebuilder-prototype html accept --dir ./work/app-demo --kind page --page-id "<ID>" --token "<TOKEN>" --refill --brief --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，任务只写自己的草稿；宿主支持且允许并行时补位执行，否则如实采用顺序生成。
+同一个生成队列默认最多 6 个任务，可按用户需求 --concurrency 1..8。page 输入 screenshotPath；form 输入 sourcePath，附带 contextPath 分片索引、guidePath 完整规范、runtimePath 固定存储脚本及 navigationPath 已发布目标映射。一个协调者串行 accept/fail/next，任务只写自己的草稿；宿主支持且允许并行时补位执行，否则如实采用顺序生成。
 
 生成文件为真实 DOM、内联 CSS/JS/SVG，无外部资源或后台调用。页面忠实还原视觉结构，空数据用一致 Mock 内容填充。表单按当前模式/字段/选项/按钮及布局依据生成，固定种子约 20 条主记录、明细每条 2–5 行；所有统计由数据推导。完整规范随 CLI 打包，不能用“能打开表格”代替验收。
 
+## 独立部署检测兼容（0.5.1）
+
+isIndependentDeploy 请求失败时，默认按非独立部署继续采集，并记录兼容提示。需要部署路由的接口使用 `/api/ebuilder/form/`；检测成功返回 true 时使用 `/api/ebuilder{appId}/form/`。后续配置接口的真实错误照常报告，采集未成功不会标为完成。
+
+## 传统列表配置（0.5.2）
+
+基础设置、显示列、搜索、统计和固定条件统一使用 `/api/bs/ebuilder/form/` 接口，URL 在原参数基础上增加小写 `appid`。这些接口固定走后台路径，需要账号具备应用后台访问权限，不受独立部署检测结果影响。列表初始化、排序、按钮等接口沿用各自路径。
+
+固定条件接口成功但未返回 `data` 时按未配置条件处理；权限、HTTP 和业务错误仍明确报错。已有失败任务可在升级后执行 `retry --dir <原任务目录>`。
+
 ## 参考布局与临时记录
 
 默认只读业务记录：先读取至多一条现有记录，若可用则请求导出 HTML 作为私有布局参考；没有参考时根据全部自定义字段生成布局，报告缺项。导出可能在源站生成参考文件。
@@ -81,7 +92,7 @@ e10-ebuilder-prototype pack --dir ./work/app-demo --json
 
 ## 截图和资源限制
 
-PC 默认 1440×900，MOBILE-only 页面 390×844；默认并发 4。页面初始渲染上限 10 秒、稳定窗口 800ms；超时本轮失败，其他可恢复失败额外重试一次。就绪后立即继续，不固定睡眠。
+PC 默认 1440×900，MOBILE-only 页面 390×844；默认并发 6。页面初始渲染上限 10 秒、稳定窗口 800ms；超时本轮失败，其他可恢复失败额外重试一次。就绪后立即继续，不固定睡眠。
 只用页面组件请求、可见加载、字体/图片、主体内容与稳定性判断；全局后台请求不阻塞。随后滚动检查、编码和清理另有边界，详见协议。
 
 截图覆盖当前已加载/可滚动内容，不自动点击标签或分页。承载 EB 主体的 iframe 完整滚动展开，普通内嵌网站保留设计视口。稳定业务错误可原样截图并带 warning，未知空白、超时、身份失效、内容丢失仍失败。源站错误截图不等于业务功能健康。
@@ -111,3 +122,16 @@ Windows 使用原生 Node，无需 Bash/WSL/Python；支持 WorkBuddy 内置 npm
 流程列表的列、标签、筛选和按钮来自内置固定原型模板；目录接口提供真实流程名称和关联表单，不读取真实流程实例/审批权限。宿主按 CLI 的 workflow-guide 生成右侧页面，固定 E10WorkflowStore 负责本地已读、批量提交、草稿续填、收藏/关注、实例评论以及关联记录联合保存。所有流程动作仅修改本地模拟数据。流程仍使用 kind=form 队列和 form/<菜单键>/ 交付路径，job.workflowType 区分流程类别。
 
 完整流程协议见 [PROTOCOL.md](docs/PROTOCOL.md)。
+
+## WorkBuddy 生成效率（0.5.4）
+
+首次 status 未就绪时仅提示“首次使用需要初始化工作环境，大概需要几分钟，完成后自动继续。”
+ensure 保留后台进度与耗时，成功后自动继续，后续正常使用不再提示初始化或依赖名称。不要给 CLI 命令附加 tail 或吞掉退出码。
+
+页面先看完整原图再写完整首版，不要求逐像素测量。html inspect 统一生成离线校对截图，
+相同源码与完整截图可复用；宿主实际看图并集中修正，最多两轮视觉微调。业务缺项或运行错误仍需处理。
+
+WorkBuddy 子任务显式使用主任务当前实际模型，保留可继承的思考配置，不写死某个模型。
+后台生成完成一个接收一个，accept/fail --refill --brief 同时返回新任务；promptPath 将页面细节
+留在对应子任务。连接失败确认旧写者已退出后恢复一次，已有草稿可继续；持续失败明确报告。
+并发额度不是实际活跃数，也不保证线性提速，结论以同输入同模型的实际验收计时为准。

package/dist/api.d.ts

@@ -1,7 +1,9 @@
 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 function apiData(payload: unknown, label: string, options?: {
+    allowMissingData?: boolean;
+}): any;
 export declare class E10Client {
     private auth;
     constructor(auth: E10AuthContext);

package/dist/api.js

@@ -10,7 +10,7 @@ export function parseApiJson(text) {
     });
     return JSON.parse(quoted);
 }
-export function apiData(payload, label) {
+export function apiData(payload, label, options = {}) {
     const p = payload;
     if (p && ['401', '403'].includes(String(p.code)))
         throw new CaptureError('E10_LOGIN_REQUIRED', '登录或权限已失效，请重新执行 auth set');
@@ -22,7 +22,7 @@ export function apiData(payload, label) {
         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))
+        (!('data' in p) && (!options.allowMissingData || !['0', '200'].includes(String(p.code)))))
         throw new CaptureError('API_RESPONSE_INVALID', `${label} 返回结构或业务状态异常`);
     return p.data;
 }

package/dist/archive.d.ts

@@ -54,9 +54,9 @@ export declare function pack(store: Store, s: TaskState): Promise<{
             sha256: string | undefined;
             bytes: number | undefined;
             file: string | undefined;
-            status: "running" | "succeeded" | "failed";
+            status: "running" | "succeeded" | "failed" | "pending";
             sourceSha256: string;
-            promptVersion: 1 | 2 | 4 | 3 | 5;
+            promptVersion: 1 | 2 | 6 | 3 | 4 | 5 | 7 | 8 | 9;
             startedAt: string;
             finishedAt: string | undefined;
             error: {

package/dist/common.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.5.0";
+export declare const VERSION = "0.5.4";
 export declare class CaptureError extends Error {
     code: string;
     details?: unknown | undefined;

package/dist/common.js

@@ -3,7 +3,7 @@ import { renameWithRetry } from './runtime-support.mjs';
 import { createReadStream } from 'node:fs';
 import path from 'node:path';
 import { createHash, randomUUID } from 'node:crypto';
-export const VERSION = '0.5.0';
+export const VERSION = '0.5.4';
 export class CaptureError extends Error {
     code;
     details;

package/dist/form-context.d.ts

@@ -1,3 +1,3 @@
 import type { Store } from './store.js';
-/** Generated source views are disposable; regenerate from the verified canonical input on resume. */
+/** Bounded, lossless views. Fixed metadata is grouped, never reinterpreted or discarded. */
 export declare function formContext(store: Store, key: string): Promise<string>;

package/dist/form-context.js

@@ -1,10 +1,16 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { fileDigest } from './common.js';
+import { digest, fileDigest, CaptureError } from './common.js';
+import { formOptionData } from './form-options.js';
 import { formInputPath } from './forms.js';
 import { navigationKey } from './menus.js';
+const limit = 18000;
+const lineLimit = 1800; // WorkBuddy Read truncates long individual lines, not only large files.
 function* parts(value, location) {
-    if (JSON.stringify(value).length <= 18000) {
+    if (JSON.stringify(location).length > lineLimit - 96)
+        throw new CaptureError('FORM_CONTEXT_LIMIT', '配置属性路径超过宿主可完整读取的单行长度');
+    const encoded = JSON.stringify({ entries: [{ location, value }] }, null, 2);
+    if (encoded.length <= limit && encoded.split('\n').every((line) => line.length <= lineLimit)) {
         yield { location, value };
         return;
     }
@@ -17,34 +23,76 @@ function* parts(value, location) {
             yield* parts(item, `${location}.${key}`);
     }
     else if (typeof value === 'string') {
-        for (let offset = 0; offset < value.length; offset += 6000)
+        for (let offset = 0; offset < value.length;) {
+            let low = offset + 1, high = Math.min(value.length, offset + lineLimit - 32);
+            while (low < high) {
+                const middle = Math.ceil((low + high) / 2);
+                if (JSON.stringify(value.slice(offset, middle)).length <= lineLimit - 32)
+                    low = middle;
+                else
+                    high = middle - 1;
+            }
+            let end = low;
+            if (end < value.length && /[\uD800-\uDBFF]/.test(value[end - 1]))
+                end--;
             yield {
-                location: `${location} (characters ${offset}:${Math.min(value.length, offset + 6000)})`,
-                value: value.slice(offset, offset + 6000),
+                location: `${location} (characters ${offset}:${end})`,
+                value: value.slice(offset, end),
             };
+            offset = end;
+        }
     }
     else
         yield { location, value };
 }
-/** Generated source views are disposable; regenerate from the verified canonical input on resume. */
+/** Bounded, lossless views. Fixed metadata is grouped, never reinterpreted or discarded. */
 export async function formContext(store, key) {
-    const source = formInputPath(store, key), input = JSON.parse(await fs.readFile(source, 'utf8'));
-    const folder = path.join(store.meta, 'form-context', navigationKey(key), await fileDigest(source));
+    const source = formInputPath(store, key), sourceSha256 = await fileDigest(source);
+    const folder = path.join(store.meta, 'form-context', navigationKey(key), sourceSha256);
+    const indexPath = path.join(folder, 'index.json');
+    const previous = await fs
+        .readFile(indexPath, 'utf8')
+        .then(JSON.parse)
+        .catch(() => null);
+    if (previous?.schema === 4 &&
+        previous.sourceSha256 === sourceSha256 &&
+        Array.isArray(previous.fragments)) {
+        const valid = await Promise.all(previous.fragments.map(async (part) => typeof part.path === 'string' &&
+            path.basename(part.path) === part.path &&
+            (await fileDigest(path.join(folder, part.path)).catch(() => '')) === part.sha256));
+        if (valid.length && valid.every(Boolean))
+            return indexPath;
+    }
+    const input = JSON.parse(await fs.readFile(source, 'utf8'));
+    const options = formOptionData(input);
     await fs.mkdir(folder, { recursive: true });
-    const index = [];
-    for (const [category, value] of Object.entries(input)) {
-        let i = 0;
+    const fragments = [];
+    let batch = [];
+    const flush = async () => {
+        if (!batch.length)
+            return;
+        const filename = `context-${fragments.length + 1}.json`;
+        const bytes = JSON.stringify({ entries: batch }, null, 2);
+        await fs.writeFile(path.join(folder, filename), bytes, { mode: 0o600 });
+        fragments.push({
+            path: filename,
+            locations: batch.map((part) => part.location),
+            sha256: digest(bytes),
+        });
+        batch = [];
+    };
+    for (const [category, value] of Object.entries(options.context)) {
         for (const part of parts(value, category)) {
-            const filename = `${category.replace(/[^a-zA-Z0-9_-]/g, '_')}-${++i}.json`;
-            await fs.writeFile(path.join(folder, filename), JSON.stringify(part, null, 2), {
-                mode: 0o600,
-            });
-            index.push({ path: filename, location: part.location });
+            if (batch.length && JSON.stringify({ entries: [...batch, part] }, null, 2).length > limit)
+                await flush();
+            batch.push(part);
         }
     }
-    const indexPath = path.join(folder, 'index.json');
+    await flush();
     await fs.writeFile(indexPath, JSON.stringify({
+        schema: 4,
         source,
+        sourceSha256,
         appId: input.appId,
         objId: input.objId,
         menu: input.page,
@@ -52,7 +100,9 @@ export async function formContext(store, key) {
         customFieldCount: input.fields?.filter((f) => !f.system).length,
         layoutSource: input.layout?.source,
         warnings: input.warnings,
-        fragments: index,
+        optionDatasets: options.descriptions,
+        format: 'Each fragment contains entries [{location,value}]; read each fragment once. Long strings use character ranges and concatenate in order. A {$e10Options:id,count,sample} replaces a large options array: call E10FormOptions.get(id) in the generated HTML to retrieve the complete original array. sample describes shape only; never use it as the full choices. CLI injects all dataset values during inspect/accept. Original input retains every property; host-readable lines are bounded.',
+        fragments,
     }, null, 2), { mode: 0o600 });
     return indexPath;
 }

package/dist/form-options.d.ts

@@ -0,0 +1,12 @@
+/** Large static choice catalogs travel as data, never as model-authored business code. */
+export declare function formOptionData(input: any): {
+    context: any;
+    datasets: Record<string, any[]>;
+    descriptions: {
+        id: string;
+        count: number;
+        locations: string[];
+    }[];
+};
+export declare function formOptionsRuntime(datasets: Record<string, any[]>): string;
+export declare function attachFormOptions(source: string, datasets: Record<string, any[]>): string;

package/dist/form-options.js

@@ -0,0 +1,54 @@
+import { digest } from './common.js';
+/** Large static choice catalogs travel as data, never as model-authored business code. */
+export function formOptionData(input) {
+    const datasets = Object.create(null);
+    const descriptions = new Map();
+    const sample = (value, depth = 0) => {
+        if (Array.isArray(value))
+            return depth >= 2
+                ? `[${value.length} items]`
+                : value.slice(0, 2).map((v) => sample(v, depth + 1));
+        if (value && typeof value === 'object')
+            return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, sample(v, depth + 1)]));
+        return typeof value === 'string' && value.length > 160 ? value.slice(0, 160) + '…' : value;
+    };
+    const visit = (value, location, key = '') => {
+        if (key === 'options' && Array.isArray(value) && JSON.stringify(value).length > 8000) {
+            const id = digest(JSON.stringify(value));
+            datasets[id] = value;
+            if (!descriptions.has(id))
+                descriptions.set(id, { id, count: value.length, locations: [] });
+            descriptions.get(id).locations.push(location);
+            return { $e10Options: id, count: value.length, sample: sample(value) };
+        }
+        if (Array.isArray(value))
+            return value.map((v, i) => visit(v, `${location}[${i}]`));
+        if (value && typeof value === 'object')
+            return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, visit(v, location ? `${location}.${k}` : k, k)]));
+        return value;
+    };
+    return { context: visit(input, ''), datasets, descriptions: [...descriptions.values()] };
+}
+function installOptions(datasets) {
+    Object.defineProperty(window, 'E10FormOptions', {
+        value: Object.freeze({
+            get: (id) => {
+                if (!Object.prototype.hasOwnProperty.call(datasets, id))
+                    throw new Error('本菜单没有对应的选项数据集');
+                return JSON.parse(JSON.stringify(datasets[id]));
+            },
+        }),
+        configurable: true,
+    });
+}
+export function formOptionsRuntime(datasets) {
+    const json = JSON.stringify(JSON.stringify(datasets))
+        .replaceAll('<', '\\u003c')
+        .replaceAll('\u2028', '\\u2028')
+        .replaceAll('\u2029', '\\u2029');
+    return `<script id="e10-form-options">(${installOptions.toString()})(JSON.parse(${json}));</script>`;
+}
+export function attachFormOptions(source, datasets) {
+    const clean = source.replace(/<script\b[^>]*\bid\s*=\s*["']e10-form-options["'][^>]*>[\s\S]*?<\/script\s*>/gi, '');
+    return clean.replace(/<head(?:\s[^>]*)?>/i, (match) => match + formOptionsRuntime(datasets));
+}

package/dist/forms.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { atomicJson, CaptureError, errorInfo, fileDigest, mapLimit } from './common.js';
-import { E10Client, parseApiJson } from './api.js';
+import { E10Client, apiData, parseApiJson } from './api.js';
 import { recoverTemporaryRecords, withTemporaryRecord, SeedUnavailable, temporarySummary, } from './temporary-records.js';
 import { navigationKey } from './menus.js';
 import { APPROVAL_PATH, normalizeWorkflows, workflowPreset, workflowType } from './workflows.js';
@@ -45,6 +45,30 @@ export function configObject(value) {
         throw new CaptureError('FORM_CONFIG_INVALID', '表单配置不是对象');
     return result;
 }
+function listConditions(conditionId, raw) {
+    let rootData = typeof raw === 'string'
+        ? raw
+        : raw && Object.hasOwn(raw, 'rootdata')
+            ? raw.rootdata
+            : raw?.rootData;
+    if (typeof rootData === 'string' && rootData.trim()) {
+        try {
+            rootData = parseApiJson(rootData);
+        }
+        catch {
+            // Preserve unrecognized condition text for the host, as the source collector does.
+        }
+    }
+    const configured = rootData != null &&
+        rootData !== '' &&
+        !(typeof rootData === 'object' && Object.keys(rootData).length === 0);
+    return {
+        conditionId: conditionId == null ? '' : String(conditionId),
+        configured,
+        rootData: configured ? rootData : {},
+        raw: raw ?? {},
+    };
+}
 const systems = new Set([
     '1:name',
     '2:creator',
@@ -189,7 +213,13 @@ export async function collectForms(store, state, auth, retryFailed = false) {
     }
     if (!jobs.length && !(await temporarySummary(store)).pending)
         return;
-    const independent = await client.request('GET', `/api/ebuilder/form/app/isIndependentDeploy?appId=${state.appId}`);
+    const deploymentWarnings = [];
+    const independent = await client
+        .request('GET', `/api/ebuilder/form/app/isIndependentDeploy?appId=${state.appId}`)
+        .catch(() => {
+        deploymentWarnings.push('isIndependentDeploy 请求失败，已默认按非独立部署应用采集');
+        return false;
+    });
     if (typeof independent !== 'boolean')
         throw new CaptureError('DEPLOYMENT_INVALID', '独立部署状态不是布尔值');
     const prefix = '/api/ebuilder' + (independent ? state.appId : '');
@@ -395,6 +425,7 @@ export async function collectForms(store, state, auth, retryFailed = false) {
             status: 'running',
             attempt: (previous?.attempt || 0) + 1,
             updatedAt: new Date().toISOString(),
+            ...(deploymentWarnings.length ? { warnings: [...deploymentWarnings] } : {}),
         };
         await atomicJson(collectionPath(store, item.id), receipt);
         try {
@@ -443,7 +474,9 @@ export async function collectForms(store, state, auth, retryFailed = false) {
                 };
                 for (const button of buttons.items)
                     button.pageButtonRef = JSON.stringify([item.id, button.buttonRef]);
-                const warnings = [...new Set(forms.flatMap((f) => f.warnings))];
+                const warnings = [
+                    ...new Set([...deploymentWarnings, ...forms.flatMap((f) => f.warnings)]),
+                ];
                 if (catalog.skipped.length)
                     warnings.push(`流程目录跳过 ${catalog.skipped.length} 个非 EB 或归属/配置无效的流程；详见私有 workflowCatalog.skipped`);
                 if (!catalog.templates.length)
@@ -498,19 +531,26 @@ export async function collectForms(store, state, auth, retryFailed = false) {
                     throw new CaptureError('FORM_ID_MISMATCH', '菜单与列表表单不匹配');
                 objId = resolved;
                 const query = `apid=${state.appId}&tpaid=${item.viewId}&objId=${objId}`;
+                const bs = '/api/bs/ebuilder/form';
+                const bsQuery = `${query}&appid=${state.appId}`;
                 const routes = {
-                    basicSettings: `/list/getBaseInfo/${item.viewId}?${query}`,
-                    displayColumns: `/list/getListFields/${item.viewId}?${query}&isVirtualForm=false&clientType=PC`,
-                    sorting: `/viewlist/getViewOrder?${query}&viewType=tableView&viewId=${item.viewId}&isVirtualForm=false`,
-                    search: `/listFilter/getSearchFilters/${item.viewId}?${query}&isVirtualForm=false&viewType=tableView`,
-                    statistics: `/listStatistics/getStatisticsList/${item.viewId}?${query}&isVirtualForm=false`,
-                    buttons: `/list/getListButtons/${item.viewId}?passid=${objId}`,
+                    basicSettings: `${bs}/list/getBaseInfo/${item.viewId}?${bsQuery}`,
+                    displayColumns: `${bs}/list/getListFields/${item.viewId}?${bsQuery}&isVirtualForm=false&clientType=PC`,
+                    sorting: `${prefix}/form/viewlist/getViewOrder?${query}&viewType=tableView&viewId=${item.viewId}&isVirtualForm=false`,
+                    search: `${bs}/listFilter/getSearchFilters/${item.viewId}?${bsQuery}&isVirtualForm=false&viewType=tableView`,
+                    statistics: `${bs}/listStatistics/getStatisticsList/${item.viewId}?${bsQuery}&isVirtualForm=false`,
+                    buttons: `${prefix}/form/list/getListButtons/${item.viewId}?passid=${objId}`,
                 };
                 if (context.conditionId && String(context.conditionId) !== '0')
-                    routes.conditions = `/plugin/conditionEditor/getById?apid=${state.appId}&id=${decimal(context.conditionId, '条件')}&type=search&objId=${objId}`;
+                    routes.conditions = `${bs}/plugin/conditionEditor/getById?apid=${state.appId}&id=${decimal(context.conditionId, '条件')}&type=search&objId=${objId}&appid=${state.appId}`;
                 const responses = await Promise.allSettled(Object.entries(routes).map(async ([key, route]) => [
                     key,
-                    await cached(route, () => get(route)),
+                    await cached(route, async () => {
+                        if (key !== 'conditions')
+                            return client.request('GET', route);
+                        const payload = await client.request('GET', route, undefined, false, true);
+                        return apiData(payload, route.split('?')[0], { allowMissingData: true });
+                    }),
                 ]));
                 for (const result of responses)
                     if (result.status === 'rejected')
@@ -518,6 +558,7 @@ export async function collectForms(store, state, auth, retryFailed = false) {
                 const config = Object.fromEntries(responses.map((r) => r.value));
                 listButtons = config.buttons;
                 delete config.buttons;
+                config.conditions = listConditions(context.conditionId, config.conditions);
                 list = { kind: 'list', listId: item.viewId, config };
             }
             if (!objId || !sourceForms.has(objId))
@@ -526,7 +567,7 @@ export async function collectForms(store, state, auth, retryFailed = false) {
             receipt.objId = objId;
             const formId = objId;
             const shared = await collectObject(formId, true);
-            const warnings = [...shared.warnings];
+            const warnings = [...deploymentWarnings, ...shared.warnings];
             const formButtons = structuredClone(shared.contexts[item.kind === 'layout' ? item.id : ''] || shared.contexts['']);
             if (formButtons.view.status !== 'ready' || formButtons.edit.status !== 'ready')
                 warnings.push('查看/编辑模式按钮缺少记录上下文，不能借用列表按钮');

package/dist/html-handoff.d.ts

@@ -0,0 +1,25 @@
+import type { TaskState } from './model.js';
+import type { Store } from './store.js';
+/** The worker attests its review; this is not an independent visual quality score. */
+export declare function readyHtml(store: Store, state: TaskState, pageId: string, token: string, kind: 'page' | 'form', summary: string): Promise<{
+    ok: boolean;
+    kind: "page" | "form";
+    pageId: string;
+    receiptPath: string;
+    next: string;
+    frozen: boolean;
+}>;
+/** Called only by the coordinator under the queue lock. Each acceptance is durable. */
+export declare function acceptReadyHtml(store: Store, state: TaskState): Promise<{
+    accepted: {
+        kind: "page" | "form";
+        pageId: string;
+        summary: any;
+    }[];
+    rejected: {
+        kind: "page" | "form";
+        pageId: string;
+        code: string;
+        message: string;
+    }[];
+}>;

package/dist/html-handoff.js

@@ -0,0 +1,89 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { atomicJson, CaptureError, digest, fileDigest } from './common.js';
+import { prepareHtml, acceptHtml, draftPath } from './html.js';
+async function evidence(store, state, pageId, token, kind) {
+    const prepared = await prepareHtml(store, state, pageId, token, kind);
+    if (prepared.r.status !== 'running')
+        throw new CaptureError('HTML_JOB_NOT_RUNNING', '只可提交当前运行中的草稿');
+    const directory = path.join(path.dirname(prepared.draft), 'review');
+    const sourceSha256 = digest(prepared.bytes);
+    const widths = kind === 'form' ? [1440, 390] : [prepared.png.width];
+    const inspections = [];
+    for (const width of widths) {
+        const filename = path.join(directory, `inspection-${width}.json`);
+        const receipt = await fs
+            .readFile(filename, 'utf8')
+            .then(JSON.parse)
+            .catch(() => null);
+        if (!receipt?.ok ||
+            receipt.sourceSha256 !== sourceSha256 ||
+            receipt.viewport?.width !== width ||
+            !receipt.screenshots?.length)
+            throw new CaptureError('HTML_REVIEW_REQUIRED', `需要当前草稿 ${width}px 校对成功并实际看图`);
+        for (const image of receipt.screenshots) {
+            if (typeof image.path !== 'string' ||
+                path.dirname(image.path) !== directory ||
+                (await fileDigest(image.path).catch(() => '')) !== image.sha256)
+                throw new CaptureError('HTML_REVIEW_REQUIRED', '校对截图已变化，需要重新校对');
+        }
+        inspections.push({ width, sha256: await fileDigest(filename) });
+    }
+    return { directory, sourceSha256, inspections };
+}
+/** The worker attests its review; this is not an independent visual quality score. */
+export async function readyHtml(store, state, pageId, token, kind, summary) {
+    if (!summary?.trim() || summary.length > 4000)
+        throw new CaptureError('ARGUMENT_INVALID', 'summary 需为已实际检查和剩余差异的简短说明（1..4000字符）');
+    const proof = await evidence(store, state, pageId, token, kind);
+    const receiptPath = path.join(proof.directory, 'host-review.json');
+    await atomicJson(receiptPath, {
+        schema: 1,
+        kind,
+        pageId,
+        token,
+        sourceSha256: proof.sourceSha256,
+        inspections: proof.inspections,
+        summary: summary.trim(),
+        reviewedAt: new Date().toISOString(),
+    });
+    return { ok: true, kind, pageId, receiptPath, next: 'notify-coordinator', frozen: true };
+}
+/** Called only by the coordinator under the queue lock. Each acceptance is durable. */
+export async function acceptReadyHtml(store, state) {
+    const status = await store.status(state);
+    const accepted = [], rejected = [];
+    for (const result of [...status.htmlResults, ...status.formHtmlResults]) {
+        if (result?.status !== 'running')
+            continue;
+        const kind = result.kind || 'page';
+        const receiptPath = path.join(path.dirname(draftPath(store, result)), 'review', 'host-review.json');
+        const receipt = await fs
+            .readFile(receiptPath, 'utf8')
+            .then(JSON.parse)
+            .catch(() => null);
+        if (!receipt)
+            continue;
+        try {
+            const proof = await evidence(store, state, result.id, result.token, kind);
+            if (receipt.schema !== 1 ||
+                receipt.token !== result.token ||
+                receipt.pageId !== result.id ||
+                receipt.kind !== kind ||
+                receipt.sourceSha256 !== proof.sourceSha256 ||
+                JSON.stringify(receipt.inspections) !== JSON.stringify(proof.inspections) ||
+                typeof receipt.summary !== 'string' ||
+                !receipt.summary.trim() ||
+                receipt.summary.length > 4000)
+                throw new CaptureError('HTML_REVIEW_STALE', '完成回执与当前草稿/校对不一致');
+            await acceptHtml(store, state, result.id, result.token, kind, proof.sourceSha256);
+            accepted.push({ kind, pageId: result.id, summary: receipt.summary });
+        }
+        catch (error) {
+            if (!(error instanceof CaptureError))
+                throw error;
+            rejected.push({ kind, pageId: result.id, code: error.code, message: error.message });
+        }
+    }
+    return { accepted, rejected };
+}

package/dist/html-inspect.d.ts

@@ -0,0 +1,4 @@
+import type { Store } from './store.js';
+import type { TaskState } from './model.js';
+/** Deterministic local rendering, never a visual similarity assertion or model call. */
+export declare function inspectHtml(store: Store, state: TaskState, pageId: string, token: string, kind?: 'page' | 'form', width?: number): Promise<any>;