weaver-work-cli 0.1.40 → 0.1.44

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>`;
+}

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

@@ -0,0 +1,129 @@
+import { buildCustomParams } from './customparams.js';
+import { normalizeScheduleRows } from './schedule.js';
+import { nameList } from './shared.js';
+/**
+ * 把「接待数据 + 字段快照」合成 customParams（纯本地、零网络）。
+ *
+ * 这是渲染段的核心：不依赖实时 formctx，也不需要 continuation。
+ * 字段清单来自技能包里的快照，字段 ID 与 doNotWrite / attachmentMountField 都在快照里。
+ */
+const pick = (map, key) => (key && map && map[String(key)] !== undefined ? String(map[String(key)]) : '');
+/** 附件 id 归一：接受 [{fileid,name}] / ['id1','id2'] / 'id1,id2' / 单串，返回去重后的 id 数组。 */
+export function normAttachmentIds(list, single = '') {
+    const fromList = (Array.isArray(list) ? list : [])
+        .map((item) => {
+        if (typeof item === 'string')
+            return item.trim();
+        if (!item || typeof item !== 'object')
+            return '';
+        const record = item;
+        return String(record.fileid || record.optionId || record.fileId || record.id || '').trim();
+    })
+        .filter(Boolean);
+    if (fromList.length)
+        return [...new Set(fromList)];
+    return String(single || '').split(',').map((item) => item.trim()).filter(Boolean);
+}
+export function composeInitialValues(options) {
+    const { snapshot, data = {}, attachmentFileid = '', attachmentFileids = null } = options;
+    const fields = (snapshot && snapshot.fields) || [];
+    const codes = (snapshot && snapshot.optionCodes) || {};
+    const warnings = [];
+    const todos = [];
+    const params = { values: {}, keys: [] };
+    const valueOf = (name) => {
+        switch (name) {
+            // 客户名直接传中文，宿主已支持；不再拼 {id,name} 对象
+            case '来访客户名称':
+                return data.customer || '';
+            case '参观访问类型':
+                return pick(codes['参观访问类型'], data.visitType) || data.visitType || '';
+            case '客户到达日期':
+            case '客户参观日期':
+                return data.visitDate || data.arrivalDate || '';
+            case '客户需求':
+                return data.demand || '';
+            case '客户性质':
+                return pick(codes['客户性质'], data.nature) || data.nature || '';
+            case '项目金额（万元）':
+                return data.amount === 0 || data.amount ? data.amount : '';
+            case '泛微分支机构参与人员（主联络人，此人必须陪客户一同参观）': {
+                // escorts 是用户明确指定的对接人，优先级最高：companions 可能被 --user 覆盖成当前操作人。
+                // 直接传中文姓名；一个都没有时才用当前登录人 employeeid 兜底。
+                const escorts = nameList(data.escorts);
+                if (escorts.length)
+                    return escorts;
+                const list = Array.isArray(data.companions) ? data.companions : [];
+                const names = list
+                    .map((item) => (typeof item === 'string' ? item : item && (item.name || item.id)))
+                    .map((item) => String(item || '').trim())
+                    .filter(Boolean);
+                if (names.length)
+                    return names;
+                return data.empId ? [String(data.empId)] : [];
+            }
+            case '是否需要高层参与':
+                return pick(codes['是否需要高层参与'], data.senior) || data.senior || '';
+            case '客户带队人':
+                return data.leader || '';
+            case '客户参观接待行程单（由行政经理汇总后反馈）':
+                // doNotWrite，走下方挂载字段
+                return '';
+            default:
+                return '';
+        }
+    };
+    const items = [];
+    for (const field of fields) {
+        if (field.doNotWrite)
+            continue;
+        const value = valueOf(field.name);
+        if (value === '' || value === null || value === undefined) {
+            if (field.required && ['客户性质', '项目金额（万元）', '客户带队人', '是否需要高层参与'].includes(field.name)) {
+                todos.push(`${field.name} 未填`);
+            }
+            continue;
+        }
+        items.push({ fieldId: field.id, value });
+    }
+    // 附件挂载字段（不在 formctx 的 10 个字段里，但页面认这个 id）
+    // 多附件（行程单 docx + 接待方案 md）：同字段多值用 `,`，交给 buildCustomParams 拼
+    const mount = (snapshot && snapshot.attachmentMountField && snapshot.attachmentMountField.fieldId) || '';
+    const attachIds = normAttachmentIds(attachmentFileids, attachmentFileid);
+    const attachmentPending = attachIds.length === 0;
+    if (mount && attachIds.length)
+        items.push({ fieldId: mount, value: attachIds });
+    // 日程明细开关 + 7 列
+    const details = (snapshot && snapshot.details) || {};
+    const rows = normalizeScheduleRows(data);
+    const switchCode = (details.switch && details.switch.codes && details.switch.codes[details.switch.on]) || '1';
+    if (rows.length && details.switch)
+        items.push({ fieldId: details.switch.fieldId, value: switchCode });
+    for (const [semantic, fieldId] of Object.entries(details.columns || {})) {
+        rows.forEach((row, index) => items.push({
+            fieldId: String(fieldId),
+            value: row[semantic],
+            dataIndex: index,
+        }));
+    }
+    if (!rows.length)
+        warnings.push('日程明细为 0 行：页面上明细会是空的');
+    const built = buildCustomParams(items);
+    params.values = built.values;
+    params.keys = built.keys;
+    if (attachmentPending)
+        todos.push('行程单附件未上传（可在页面手动添加）');
+    if (!data.companions || !data.companions.length)
+        todos.push('陪同人员未填');
+    if (!data.demand)
+        todos.push('客户需求未填');
+    return {
+        values: params.values,
+        keys: params.keys,
+        todos,
+        warnings,
+        attachmentPending,
+        detailRowCount: rows.length,
+        items,
+    };
+}