weaver-work-cli 0.1.42 → 0.1.44

package/dist/shortcuts/reception/host.js

@@ -0,0 +1,125 @@
+import { getE10Session } from '../../internal/e10/context.js';
+import { E10ApiError, createE10RequestRuntime, } from '../../internal/e10/request-runtime.js';
+import { receptionBusinessError, receptionEnvironmentError } from './errors.js';
+import { UploadProtocolError, uploadToFileService } from './upload.js';
+/** 单次上传的总时限。分片上传是多轮请求，留足 3 分钟。 */
+const UPLOAD_TIMEOUT_MS = 180_000;
+export function createReceptionHost(ctx) {
+    let cached = null;
+    async function resolve() {
+        if (cached)
+            return cached;
+        const e10 = await getE10Session(ctx);
+        if (!e10) {
+            cached = {
+                e10: null,
+                info: {
+                    available: false,
+                    baseUrl: '',
+                    userId: '',
+                    reason: '未取得 E10 会话：附件不会上传，产物按本地文件交付',
+                },
+            };
+            return cached;
+        }
+        cached = {
+            e10,
+            info: { available: true, baseUrl: e10.getBaseUrl(), userId: e10.userId },
+        };
+        return cached;
+    }
+    async function getSession() {
+        return (await resolve()).info;
+    }
+    async function requireRuntime() {
+        const { e10, info } = await resolve();
+        if (!e10) {
+            throw receptionEnvironmentError('NO_SESSION', info.reason || '未取得 E10 会话');
+        }
+        return { runtime: createE10RequestRuntime(ctx, e10), session: info };
+    }
+    /**
+     * 上传一份文件。
+     *
+     * 走 teamsCheck → preUploadCheck → module/upload 三阶段（见 `upload.ts`）。
+     * 旧的 `/api/file/upload` 已废弃，调用只会得到 200 + 空响应，别再回去。
+     */
+    async function uploadFile(filePath, options = {}) {
+        const { e10, info } = await resolve();
+        if (!e10) {
+            return {
+                ok: false,
+                reason: 'NO_SESSION',
+                localPath: filePath,
+                error: info.reason || '无可用会话，已跳过上传（文件已生成，按本地文件交付）',
+            };
+        }
+        const baseUrl = String(info.baseUrl || '').replace(/\/+$/u, '');
+        const runtime = createE10RequestRuntime(ctx, e10);
+        // 默认 document（E10 的文件归属取值）；需要别的归属时用 RECEPTION_UPLOAD_MODULE 覆盖。
+        const module = options.module || process.env.RECEPTION_UPLOAD_MODULE || 'document';
+        try {
+            const uploaded = await uploadToFileService({
+                transport: {
+                    post: (path, formData) => runtime.requestJson({
+                        module: 'reception',
+                        operation: 'reception.upload',
+                        method: 'POST',
+                        path,
+                        formData,
+                        headers: {
+                            langtype: 'zh_CN',
+                            referer: `${baseUrl}/`,
+                        },
+                        timeoutMs: UPLOAD_TIMEOUT_MS,
+                    }),
+                },
+                filePath,
+                module,
+                userId: info.userId ? String(info.userId) : undefined,
+                name: options.name,
+            });
+            return {
+                ok: true,
+                fileid: uploaded.fileid,
+                name: uploaded.name,
+                size: uploaded.size,
+                kind: uploaded.kind,
+                localPath: filePath,
+                previewUrl: `${baseUrl}/sp/file/filePreview/${uploaded.fileid}`,
+            };
+        }
+        catch (error) {
+            if (error instanceof UploadProtocolError) {
+                return {
+                    ok: false,
+                    localPath: filePath,
+                    reason: error.subtype,
+                    error: error.message,
+                    httpStatus: error.httpStatus,
+                    contentType: error.contentType,
+                    detail: error.detail,
+                    hint: `链路 teamsCheck → preUploadCheck → module/upload，module=${module}`,
+                };
+            }
+            if (error instanceof E10ApiError) {
+                return { ok: false, localPath: filePath, reason: 'UPLOAD_NETWORK', error: `网络异常: ${error.message}` };
+            }
+            return {
+                ok: false,
+                localPath: filePath,
+                reason: 'UPLOAD_LOCAL_ERROR',
+                error: `上传异常: ${error.message}`,
+            };
+        }
+    }
+    return { getSession, requireRuntime, uploadFile };
+}
+/** 未登录时不该静默继续的场景，统一用它取 baseUrl 并给出可读错误。 */
+export async function requireBaseUrl(host) {
+    const session = await host.getSession();
+    if (!session.available || !session.baseUrl) {
+        throw receptionBusinessError('BASE_URL_MISSING', '未取得 E10 会话，无法确定环境地址');
+    }
+    return session.baseUrl;
+}

package/dist/shortcuts/reception/index.js

@@ -0,0 +1,198 @@
+import { join } from 'node:path';
+import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { stateRoot } from '../../core/state.js';
+import { DEFAULT_WORKFLOW, STATE_SUBDIR } from './constants.js';
+import { receptionValidationError } from './errors.js';
+import { createReceptionHost } from './host.js';
+import { assertManifestMatchesRegistry, receptionManifest } from './manifest.js';
+import { executeReceptionOperation, normalizeInput } from './operations.js';
+import { jsonArg, textOf } from './operations/shared.js';
+/**
+ * 命令面。
+ *
+ * 形态选择：保留 `ask / doc / render` 三个动词 + `schema / run` 通用入口。
+ * 理由不是"省事"，而是这三条命令的返回值是给宿主消费的（面板定义、browsertool），
+ * 塞进 CRUD 式 operation 语义反而更别扭；同时补 schema，让 Agent 仍能自查合约。
+ */
+function asOptions(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+/** `<stateRoot>/reception/`，与 profile 同级，多环境不串。 */
+function stateDirOf(ctx) {
+    return join(stateRoot(ctx), STATE_SUBDIR);
+}
+function contextOf(ctx, options) {
+    const stateDir = stateDirOf(ctx);
+    const outDir = textOf(options, 'outDir') || join(stateDir, 'out');
+    return { host: createReceptionHost(ctx), stateDir, outDir };
+}
+function successEnvelope(operation, state, data, warnings, next) {
+    return {
+        schemaVersion: 1,
+        ok: true,
+        operation,
+        data: data === undefined ? null : data,
+        meta: { state, ...(next ? { next } : {}) },
+        warnings,
+    };
+}
+function failureEnvelope(error) {
+    return { schemaVersion: 1, ok: false, error: toErrorEnvelope(error) };
+}
+async function runOperation(ctx, operation, input, options) {
+    try {
+        const result = await executeReceptionOperation(operation, input, contextOf(ctx, options));
+        const envelope = successEnvelope(operation, result.state, result.data, result.warnings || [], result.next || null);
+        ctx.output.write(envelope, { json: true });
+        // 业务上判定不成功（如 render 无任何字段有值）时用参数错误退出，便于调用方分流
+        if (result.ok === false)
+            process.exitCode = ExitCode.UsageError;
+    }
+    catch (error) {
+        /*
+         * 错误信封走 stdout，与本模块的成功输出同一通道。
+         *
+         * 其它 shortcut（plan / asset）走 stderr，这里刻意不同：接待流程的调用方是模型，
+         * 它只解析 stdout；SKILL.md 的失败矩阵全部依赖 `error.subtype` 分流，
+         * 走 stderr 会被多数宿主丢掉，表现为"命令失败了但不知道为什么"。
+         */
+        ctx.output.write(failureEnvelope(error), { json: true });
+        process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
+    }
+}
+function parseAnswers(options, code = 'ANSWERS') {
+    return jsonArg(options, 'answers', { code });
+}
+export const receptionShortcut = {
+    name: 'reception',
+    description: '泛微客户参观接待流程（面板 / 行程单与内部方案 / 填单页预填）',
+    category: 'shortcut',
+    register({ program, action }) {
+        assertManifestMatchesRegistry();
+        const reception = program.command('reception')
+            .description('泛微客户参观接待流程：出面板 → 出两份产物并挂附件 → 输出填单页 browsertool');
+        reception.command('schema')
+            .description('输出 operation 合约（Agent 自查入口）')
+            .action(action((ctx) => {
+            ctx.output.write(receptionManifest, { json: true });
+        }));
+        reception.command('run')
+            .description('按 operation 名执行（reception.ask / reception.doc / reception.render）')
+            .argument('<operation>', 'operation 名，如 reception.ask')
+            .option('--input <path>', 'JSON 入参文件，- 表示 stdin')
+            .option('--input-json <json>', '内联 JSON 入参')
+            .option('--out-dir <dir>', '产物输出目录')
+            .action(action(async (ctx, operation, options) => {
+            const opts = asOptions(options);
+            let input = {};
+            if (opts.inputJson) {
+                const parsed = jsonArg({ inputJson: opts.inputJson }, 'inputJson', { code: 'INPUT_JSON', required: true });
+                input = normalizeInput(parsed);
+            }
+            else if (typeof opts.input === 'string' && opts.input.trim() && opts.input !== '-') {
+                throw receptionValidationError('INPUT_UNSUPPORTED', '请用 --input-json 传参，或直接使用动词命令', {
+                    hint: 'read 类操作没有大结果回传需求，不支持 --input 文件',
+                });
+            }
+            await runOperation(ctx, String(operation), input, opts);
+        }));
+        reception.command('ask')
+            .description('出交互面板（缺项才出屏，总屏数 ≤2）')
+            .option('--known <json>', '7 项抽取结果（内联 JSON）')
+            .option('--known-file <path>', '7 项抽取结果（JSON 文件，推荐）')
+            .option('--user <names>', '陪同人员姓名，多人逗号分隔；不传用当前登录人兜底')
+            .option('--customer <name>', '客户名称，覆盖 known.customer')
+            .option('--workflow <name>', `目标流程名，默认「${DEFAULT_WORKFLOW}」`)
+            .option('--out-dir <dir>', '产物输出目录')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            const known = jsonArg(opts, 'known', {
+                code: 'KNOWN',
+                required: true,
+                hint: '推荐用文件传参：先写 known.json（无 BOM 的 UTF-8），再 reception ask --known-file known.json',
+            });
+            await runOperation(ctx, 'reception.ask', {
+                known,
+                user: textOf(opts, 'user') || undefined,
+                customer: textOf(opts, 'customer') || undefined,
+                workflow: textOf(opts, 'workflow') || undefined,
+            }, opts);
+        }));
+        reception.command('doc')
+            .description('生成行程单 docx + 内部参考文档 md，并上传附件（零写请求）')
+            .option('--run-id <id>', 'ask 返回的 runId')
+            .option('--known <json>', 'run 失效时用于现场重建的 7 项抽取结果')
+            .option('--known-file <path>', '同上，JSON 文件')
+            .option('--answers <json>', '面板回填值（内联 JSON）')
+            .option('--answers-file <path>', '面板回填值（JSON 文件，推荐）')
+            .option('--cases-file <path>', '案例 + 专家检索结果 JSON')
+            .option('--workflow <name>', '目标流程名')
+            .option('--out-dir <dir>', '产物输出目录')
+            .option('--snapshot <path>', '字段快照路径（同时用于推导 render.py）')
+            .option('--render-py <path>', '显式指定 render.py')
+            .option('--no-upload', '跳过附件上传，只出本地文件')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await runOperation(ctx, 'reception.doc', {
+                runId: textOf(opts, 'runId') || undefined,
+                known: jsonArg(opts, 'known', { code: 'KNOWN' }) || undefined,
+                answers: parseAnswers(opts) || undefined,
+                casesFile: textOf(opts, 'casesFile') || undefined,
+                workflow: textOf(opts, 'workflow') || undefined,
+                outDir: textOf(opts, 'outDir') || undefined,
+                snapshot: textOf(opts, 'snapshot') || undefined,
+                renderPy: textOf(opts, 'renderPy') || undefined,
+                noUpload: opts.upload === false,
+            }, opts);
+        }));
+        reception.command('render')
+            .description('输出填单页 browsertool（纯本地，不调接口）')
+            .option('--run-id <id>', 'ask / doc 返回的 runId')
+            .option('--answers <json>', '面板回填值（内联 JSON）')
+            .option('--answers-file <path>', '面板回填值（JSON 文件，推荐）')
+            .option('--attachment-fileid <ids>', '附件 fileid，多个逗号分隔')
+            .option('--sdk-render <type>', '打开形态：inline / popup / drawer（默认 drawer）')
+            .option('--snapshot <path>', '字段快照路径')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await runOperation(ctx, 'reception.render', {
+                runId: textOf(opts, 'runId') || undefined,
+                answers: parseAnswers(opts) || undefined,
+                attachmentFileid: textOf(opts, 'attachmentFileid') || undefined,
+                sdkRender: textOf(opts, 'sdkRender') || undefined,
+                snapshot: textOf(opts, 'snapshot') || undefined,
+            }, opts);
+        }));
+        reception.command('doc-render')
+            .description('一次完成「出件 + 传附件 + 拼填单参数」（doc 与 render 合并，省一次工具往返）')
+            .option('--run-id <id>', 'ask 返回的 runId')
+            .option('--known <json>', 'run 失效时用于现场重建的 7 项抽取结果')
+            .option('--known-file <path>', '同上，JSON 文件')
+            .option('--answers <json>', '面板回填值（内联 JSON）')
+            .option('--answers-file <path>', '面板回填值（JSON 文件，推荐）')
+            .option('--cases-file <path>', '案例 + 专家检索结果 JSON')
+            .option('--workflow <name>', '目标流程名')
+            .option('--out-dir <dir>', '产物输出目录')
+            .option('--snapshot <path>', '字段快照路径（同时用于推导 render.py）')
+            .option('--render-py <path>', '显式指定 render.py')
+            .option('--no-upload', '跳过附件上传，只出本地文件')
+            .option('--sdk-render <type>', '打开形态：inline / popup / drawer（默认 drawer）')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await runOperation(ctx, 'reception.docRender', {
+                runId: textOf(opts, 'runId') || undefined,
+                known: jsonArg(opts, 'known', { code: 'KNOWN' }) || undefined,
+                answers: parseAnswers(opts) || undefined,
+                casesFile: textOf(opts, 'casesFile') || undefined,
+                workflow: textOf(opts, 'workflow') || undefined,
+                outDir: textOf(opts, 'outDir') || undefined,
+                snapshot: textOf(opts, 'snapshot') || undefined,
+                renderPy: textOf(opts, 'renderPy') || undefined,
+                noUpload: opts.upload === false,
+                sdkRender: textOf(opts, 'sdkRender') || undefined,
+            }, opts);
+        }));
+    },
+};

package/dist/shortcuts/reception/manifest.js

@@ -0,0 +1,177 @@
+import { receptionOperationNames } from './operations/registry.js';
+export const receptionOperations = [
+    {
+        name: 'reception.ask',
+        risk: 'read',
+        summary: '按 7 项抽取结果出交互面板：缺项才出屏，总屏数 ≤2（客户需求 + 接待细节）。返回 runId 供 doc 使用。',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['known'],
+            properties: {
+                known: {
+                    type: 'object',
+                    description: '模型抽取的 7 项：customer/headcount/visitDate/visitType/companions/demand/接待细节',
+                    additionalProperties: true,
+                },
+                user: { type: 'string', description: '陪同人员姓名，多人用逗号分隔；不传则用当前登录人兜底' },
+                customer: { type: 'string', description: '客户名称（覆盖 known.customer）' },
+                workflow: { type: 'string', description: '目标流程名，默认「泛微客户参观接待流程」' },
+            },
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                runId: { type: 'string' },
+                panels: { type: 'array', items: { type: 'object' } },
+                known: { type: 'object' },
+                timings: { type: 'object' },
+            },
+        },
+    },
+    {
+        name: 'reception.doc',
+        risk: 'read',
+        summary: '生成客户版行程单 docx 与内部版接待交流参考文档 md，并上传两份附件拿 fileid。零写请求：流程不落库、不提交。',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                runId: { type: 'string', description: 'ask 返回的 runId；run 失效时改用 known 现场重建' },
+                known: { type: 'object', description: 'run 失效时的 7 项抽取结果，用于现场重建 run' },
+                answers: { type: 'object', description: 'ask_user 面板回填值：{customer_need, logistics, fields}' },
+                casesFile: { type: 'string', description: '案例 + 专家检索结果 JSON 文件路径（软依赖，缺省则不注入）' },
+                workflow: { type: 'string', description: '目标流程名' },
+                outDir: { type: 'string', description: '产物输出目录' },
+                noUpload: { type: 'boolean', description: '跳过附件上传，只出本地文件' },
+                snapshot: { type: 'string', description: '字段快照路径；同时用于推导技能包内 render.py 位置' },
+                renderPy: { type: 'string', description: '显式指定 render.py 路径' },
+            },
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                runId: { type: 'string' },
+                rebuilt: { type: 'boolean' },
+                files: { type: 'array', items: { type: 'object' } },
+                internalDoc: {
+                    type: ['object', 'null'],
+                    description: '内部参考文档正文 {name,path,content}；null 表示没生成。模型据此在对话中原样贴出，不必再读产物文件',
+                },
+                attachments: { type: 'array', items: { type: 'object' } },
+                attachmentPending: { type: 'boolean' },
+                qa: { type: 'object' },
+                verify: { type: 'object' },
+                timings: { type: 'object' },
+            },
+        },
+    },
+    {
+        name: 'reception.render',
+        risk: 'read',
+        summary: '按快照把接待数据拼成 customParams，输出 <browsertool> 供宿主打开填单页。纯本地，不调接口。',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['runId'],
+            properties: {
+                runId: { type: 'string', description: 'ask / doc 返回的 runId' },
+                answers: { type: 'object', description: '面板回填值，覆盖 run.answers' },
+                attachmentFileid: { type: 'string', description: '显式指定附件 fileid，多个用逗号分隔' },
+                sdkRender: {
+                    type: 'string',
+                    enum: ['inline', 'popup', 'drawer'],
+                    description: '打开形态：drawer 为右侧抽屉（默认）',
+                },
+                snapshot: { type: 'string', description: '字段快照路径' },
+            },
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                customParams: { type: 'object' },
+                fieldAssignKeys: { type: 'string' },
+                detailRowCount: { type: 'integer' },
+                attachmentPending: { type: 'boolean' },
+                sdkRenderType: { type: 'string' },
+                todos: { type: 'array', items: { type: 'string' } },
+                browsertool: { type: 'string' },
+                browsertoolFile: { type: 'string', description: 'browsertool 落盘的绝对路径（正斜杠）' },
+                browsertoolRef: { type: 'string', description: '文件引用形态，宿主支持时模型只输出这一行' },
+                timings: { type: 'object' },
+            },
+        },
+    },
+    {
+        name: 'reception.docRender',
+        risk: 'read',
+        summary: '一次完成 doc + render：出 docx/md、上传附件、拼 customParams、落 browsertool。'
+            + '两者之间没有人工确认点，合并只为省一次工具往返；失败语义与分开调用一致。',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                runId: { type: 'string', description: 'ask 返回的 runId；run 失效时改用 known 现场重建' },
+                known: { type: 'object', description: 'run 失效时的 7 项抽取结果，用于现场重建 run' },
+                answers: { type: 'object', description: 'ask_user 面板回填值：{customer_need, logistics, fields}' },
+                casesFile: { type: 'string', description: '案例 + 专家检索结果 JSON 文件路径（软依赖）' },
+                workflow: { type: 'string', description: '目标流程名' },
+                outDir: { type: 'string', description: '产物输出目录' },
+                noUpload: { type: 'boolean', description: '跳过附件上传，只出本地文件' },
+                snapshot: { type: 'string', description: '字段快照路径；同时用于推导技能包内 render.py 位置' },
+                renderPy: { type: 'string', description: '显式指定 render.py 路径' },
+                sdkRender: {
+                    type: 'string',
+                    enum: ['inline', 'popup', 'drawer'],
+                    description: '填单页打开形态：drawer 为右侧抽屉（默认）',
+                },
+            },
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                runId: { type: 'string' },
+                rebuilt: { type: 'boolean' },
+                files: { type: 'array', items: { type: 'object' } },
+                internalDoc: {
+                    type: ['object', 'null'],
+                    description: '内部参考文档正文 {name,path,content}；null 表示没生成。模型据此在对话中原样贴出，不必再读产物文件',
+                },
+                attachments: { type: 'array', items: { type: 'object' } },
+                attachmentPending: { type: 'boolean' },
+                uploadDiagnostics: { type: 'array', items: { type: 'object' } },
+                customParams: { type: 'object' },
+                fieldAssignKeys: { type: 'string' },
+                detailRowCount: { type: 'integer' },
+                todos: { type: 'array', items: { type: 'string' } },
+                browsertool: { type: 'string' },
+                browsertoolFile: { type: 'string' },
+                browsertoolRef: { type: 'string' },
+                qa: { type: 'object' },
+                timings: { type: 'object' },
+            },
+        },
+    },
+];
+export const receptionManifest = {
+    schemaVersion: 1,
+    name: 'reception',
+    title: '泛微客户参观接待流程（面板/出件/填单页）',
+    version: '1.0.0',
+    host: 'e10-reception',
+    status: 'builtin',
+    sourceSkill: 'weaver-e10-reception-flow',
+    capabilities: ['reception'],
+    /** 全链路零写请求：只上传附件，流程由用户在页面上提交。 */
+    writePolicy: 'none',
+    operations: receptionOperations,
+    operationNames: receptionOperationNames,
+};
+/** 命令面自检时用；与 registry 保持一致，避免文档与实现脱节。 */
+export function assertManifestMatchesRegistry() {
+    const declared = receptionOperations.map((item) => item.name).sort();
+    const registered = [...receptionOperationNames].sort();
+    if (declared.join(',') !== registered.join(',')) {
+        throw new Error(`manifest 与 registry 不一致：\nmanifest=${declared.join(',')}\nregistry=${registered.join(',')}`);
+    }
+}

package/dist/shortcuts/reception/operations/ask.js

@@ -0,0 +1,71 @@
+import { DEFAULT_WORKFLOW } from '../constants.js';
+import { buildPanels } from './panels.js';
+import { newRunId, saveRun } from './runs.js';
+import { nameList } from './shared.js';
+export async function ask(input, ctx) {
+    const startedAt = Date.now();
+    const known = input.known || {};
+    const workflow = input.workflow || DEFAULT_WORKFLOW;
+    const warnings = [];
+    const customerKeyword = input.customer || (typeof known.customer === 'string' ? known.customer : '');
+    // 宿主已支持直接传中文，人机交互前不再查客户/人员的 ID（省掉两次接口往返）。
+    // 人员：--user 或 known.companions 里的姓名直接落到 companions；
+    // 一个都没有时，compose 用 empId（当前登录人）兜底填「参与人员」。
+    const data = { ...known };
+    delete data.customerId;
+    if (customerKeyword)
+        data.customer = customerKeyword;
+    // 主联络人优先级：`known.escorts`（明确指定的对接人）> `--user`（陪同）> `known.companions` > 登录人兜底。
+    //
+    // 事故背景：模型把对接人写在 `escorts`，同时把「当前操作人」当成陪同传给了 `--user`，
+    // 旧代码只认后两者，于是主联络人被填成操作人。
+    // 因此这里让 `escorts` 赢：它语义最明确（对接人 = 主联络人），而 `--user` 可能是操作人。
+    const escorts = nameList(known.escorts);
+    const explicitUser = nameList(input.user || '');
+    const companions = nameList(known.companions);
+    const names = escorts.length ? escorts : (explicitUser.length ? explicitUser : companions);
+    if (names.length)
+        data.companions = names.map((name) => ({ name }));
+    // ask 完全不读会话：解析会话要读加密 auth 并解 keyring，实测 ~300ms，
+    // 而 ask 只拿它填 empId（登录人兜底）和 base（拼 URL），这两件事 doc / render 阶段
+    // 本来就绕不开会话，放在那里做即可。ask 保持纯本地，冷启动从 643ms 降到 340ms。
+    data.empId = '';
+    const runId = newRunId();
+    saveRun(ctx.stateDir, {
+        runId,
+        createdAt: new Date().toISOString(),
+        workflow,
+        outDir: ctx.outDir,
+        base: '',
+        data,
+        customer: null,
+        user: null,
+        mode: 'browsertool',
+    });
+    const panels = buildPanels(data);
+    return {
+        state: 'asked',
+        ok: true,
+        data: {
+            runId,
+            known: {
+                customer: data.customer || '',
+                visitDate: data.visitDate || '',
+                visitType: data.visitType || '',
+                companions: data.companions || [],
+                // 兜底由 render 阶段补：ask 不读会话，这里恒为空
+                contactFallback: '',
+            },
+            panels,
+            timings: { totalMs: Date.now() - startedAt },
+        },
+        warnings,
+        next: {
+            command: 'ask_user(panels) → weaver-work-cli reception doc --run-id … --answers \'{...}\'',
+            reason: '一次问完；answers 原样回传',
+        },
+    };
+}
+export const askOperation = {
+    execute: (input, ctx) => ask(input, ctx),
+};

package/dist/shortcuts/reception/operations/browsertool.js

@@ -0,0 +1,58 @@
+/**
+ * `<browsertool>` 渲染。
+ *
+ * 依据官方《browsertool 渲染说明》：
+ *   fill_form + data          → iframe 填单
+ *   fill_form + sdkOptions    → E10 表单组件化渲染（本文件用的形态）
+ *   open_web                  → 打开外部网页 + XiaoEWorkspace 通信（不用于 E10 表单）
+ *
+ * 打开形态由 `arguments.sdkRenderType` 决定：
+ *   inline          内嵌（移动端默认）
+ *   popup / drawer  弹层（PC 端默认；drawer = 右侧抽屉，即"侧边打开"）
+ * 不传则用宿主默认值（实测为内嵌），所以这里显式给值。
+ *
+ * 除 title / src / sdkRenderType / 两处 routerProps / params 外全部写死；JSON 用 2 空格缩进。
+ */
+export const SDK_RENDER_TYPES = ['inline', 'popup', 'drawer'];
+function normalizeRenderType(value) {
+    const text = String(value || '').trim().toLowerCase();
+    return SDK_RENDER_TYPES.includes(text) ? text : '';
+}
+/** 默认形态：右侧抽屉（业务要的就是"侧边打开"）。可用 RECEPTION_SDK_RENDER 或 --sdk-render 覆盖。 */
+export const DEFAULT_SDK_RENDER = normalizeRenderType(process.env.RECEPTION_SDK_RENDER) || 'drawer';
+/** 对外：给定入参解析出最终形态（非法值回落到默认）。 */
+export const resolveRenderType = (value) => normalizeRenderType(value) || DEFAULT_SDK_RENDER;
+export function renderBrowsertool(options) {
+    const base = String(options.baseUrl || '').replace(/\/+$/u, '');
+    const id = String(options.workflowId || '').trim();
+    if (!base || !id)
+        throw new Error('渲染 browsertool 需要 baseUrl 与 workflowId');
+    const renderType = normalizeRenderType(options.sdkRenderType) || DEFAULT_SDK_RENDER;
+    const createPath = `/flowpage/create/${id}`;
+    const payload = {
+        version: 1,
+        callId: 'call_001',
+        toolId: 'fill_form',
+        arguments: {
+            type: 'e10',
+            title: String(options.workflowName || ''),
+            src: `${base}/sp/workflow${createPath}?workflowId=${id}&isCreate=1`,
+            sdkRenderType: renderType,
+            sdkOptions: {
+                compName: 'ui.CorsComponent',
+                routerType: 'MemoryRouter',
+                routerProps_pc: { initialEntries: [createPath] },
+                routerProps_mobile: { initialEntries: [createPath] },
+                params_pc: { app: '@weapp/workflow', compName: 'Comp.WffpRoute', noMDialog: true },
+                params_mobile: { app: '@weapp/workflow', compName: 'Comp.MWffpRoute', noMDialog: true },
+                params: {
+                    customParams: {
+                        ...options.customParams.values,
+                        fieldAssignKeys: options.customParams.keys.join(','),
+                    },
+                },
+            },
+        },
+    };
+    return `<browsertool>\n${JSON.stringify(payload, null, 2)}\n</browsertool>`;
+}