weaver-work-cli 0.1.42 → 0.1.44

package/dist/shortcuts/ehr/operations/recruit-position.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_MS, CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { createHash } from 'node:crypto';
 import { ehrConfirmationError, ehrValidationError } from '../errors.js';
 import { WRITE, SCHEMA_ID, ehrSuccess, schemaOf, } from './types.js';
@@ -25,6 +26,10 @@ const TEXT_KEYS = ['position_name'];
 const MTEXT_KEYS = ['position_duty', 'work_request'];
 const ASSOC_KEYS = ['demand'];
 const PERSON_DEFAULT_KEYS = ['recr_principal', 'employ_manager'];
+// 🔴 薪资（salary_min / salary_max）必须沿用现值，不能留空：
+// 这两个字段是**表单必填项**，不传就会导致后端必填校验失败、整个建职位流程直接报错。
+// 但历史职位薪资确实可能是脏数据（实测抓到过 300 元月薪），因此不静默使用——
+// 通过 summary.inheritedFromRef 逐项暴露给用户核对，并对明显偏低的值追加 inheritedSalaryWarnings 提示。
 const REF_COPY_KEYS = [
     'position_nature',
     'job_category',
@@ -41,6 +46,7 @@ const OPTION_DEFAULTS = { salary_type: '月薪', recruit_type: '社会招聘', s
 const SET_FIELDS = [
     { arg: 'education', key: 'education', kind: 'dict', label: '学历要求（按数据字典名称）' },
     { arg: 'workYears', key: 'work_years', kind: 'dict', label: '工作年限（按数据字典名称）' },
+    { arg: 'workLocation', key: 'work_location', kind: 'assoc', label: '工作地点（办公地点名称/详细地址，如「上海」或完整地址）' },
     { arg: 'jobCategory', key: 'job_category', kind: 'dict', label: '职位类别（按数据字典名称）' },
     { arg: 'positionNature', key: 'position_nature', kind: 'dict', label: '职位属性（按数据字典名称）' },
     { arg: 'salaryType', key: 'salary_type', kind: 'option', label: '薪酬类型（月薪/年薪等）' },
@@ -95,6 +101,105 @@ async function fetchReferenceDetails(env, cache, objId, formId) {
         return [];
     }
 }
+const WORK_PLACE_NAMES = ['办公地点', '工作地点'];
+/** 「办公地点」菜单定位：三级来源（lists.all_search → cache.menus（若存在）→ allMenus 接口），不依赖单一缓存键。
+ *  背景同 recruit-stage：原实现直接读 cache.menus，而该环境缓存没有 menus 字段 → 恒取不到 → 工作地点永远写不进去。 */
+async function findWorkPlaceMenu(env, cache) {
+    const ok = (m) => !!(m && m.listId);
+    const pick = (list) => {
+        const hit = list.find((m) => ok(m) && WORK_PLACE_NAMES.some((n) => String(m.menuName || '').includes(n)));
+        return hit ? hit : null;
+    };
+    // ① 环境缓存 all_search（与面试数字人菜单同一模式）
+    const hit1 = pick((cache.lists?.all_search || []));
+    if (hit1)
+        return hit1;
+    // ② legacy menus（部分环境可能有）
+    const hit2 = pick((cache.menus || []));
+    if (hit2)
+        return hit2;
+    // ③ allMenus 接口兜底
+    try {
+        const r = (await env.host.request({
+            path: '/api/cusapp/app/allMenus',
+            query: { isFront: 1, appId: String(cache.appId || ''), terminalType: 'PC' },
+        }));
+        const flat = [];
+        (function walk(nodes) {
+            for (const n of nodes || []) {
+                if (n && typeof n === 'object') {
+                    flat.push(n);
+                    walk(n.children || n.childs);
+                }
+            }
+        })((r?.data?.cusAppMenus || r?.data));
+        return pick(flat);
+    }
+    catch {
+        return null;
+    }
+}
+/** 工作地点：按名称/详细地址/区域文本解析「办公地点」记录 id；解析不到返回 null（调用方进 setSkipped，不臆造 id）。 */
+async function resolveWorkLocation(env, cache, value) {
+    const v = String(value).trim();
+    if (!v)
+        return null;
+    const menu = await findWorkPlaceMenu(env, cache);
+    if (!menu?.listId)
+        return null;
+    let pObj = '';
+    try {
+        const t = (await env.host.request({
+            path: '/api/ebuilder/form/obj/getObjsByTag',
+            query: { appId: String(cache.appId || ''), tag: 'uf_rcrt_work_place' },
+        }));
+        const d = t?.data;
+        if (Array.isArray(d) && d[0])
+            pObj = String(d[0].id || '');
+    }
+    catch {
+        /* tag 未注册：用菜单节点兜底 */
+    }
+    if (!pObj)
+        pObj = String(menu.objId || '');
+    if (!pObj)
+        return null;
+    const body = buildListBody({
+        listId: menu.listId,
+        cusMenuId: menu.cusMenuId,
+        menuName: menu.menuName || '办公地点',
+        title: menu.menuName || '办公地点',
+        pageSize: 200,
+    });
+    const r = (await env.host.request({
+        path: `/api/ebuilder/form/list/getListDatas?passid=${pObj}&cid=${pObj}`,
+        body,
+        headers: { ebBusinessId: menu.listId },
+    }));
+    const rows = (r?.data?.data || r?.data?.displayData || []);
+    const hit = rows.find((x) => {
+        const name = String(x?.name || '');
+        const detail = String(x?.detail_location || '');
+        const area = String(x?.area_text || '');
+        return name.includes(v) || detail.includes(v) || area.includes(v) || (!!detail && v.includes(detail));
+    });
+    return hit ? { id: String(hit.form_data_id || hit.id), name: String(hit.detail_location || hit.name || v) } : null;
+}
+/** 从提交 detail 取可读值（用于 summary 里点名「继承来的值」） */
+function detailDisplayValue(detail) {
+    if (!detail)
+        return '';
+    const d = detail;
+    if (d.content !== undefined && d.content !== null)
+        return String(d.content);
+    if (Array.isArray(d.dataOptions) && d.dataOptions[0]) {
+        const o = d.dataOptions[0];
+        return String(o.content ?? o.optionId ?? '');
+    }
+    if (d.dataText?.content !== undefined)
+        return String(d.dataText.content).replace(/<[^>]+>/g, '').slice(0, 60);
+    return '';
+}
 async function buildPositionPlan(env, cache, args) {
     const form = cache.forms.position_manage;
     const objId = form?.objId;
@@ -169,6 +274,15 @@ async function buildPositionPlan(env, cache, args) {
             put({ formField: { id: fieldId }, dataOptions: [{ optionId: String(optionId), content: value }] });
             applied.push(`${field.key}=${value}`);
         }
+        else if (field.kind === 'assoc') {
+            const loc = await resolveWorkLocation(env, cache, value);
+            if (!loc) {
+                skipped.push(`${field.key}=${value}（未匹配到「办公地点」记录，已跳过）`);
+                continue;
+            }
+            put({ formField: { id: fieldId }, dataOptions: [{ optionId: loc.id, content: loc.name }] });
+            applied.push(`${field.key}=${value}`);
+        }
         else if (field.kind === 'dict') {
             const ids = cache.dict.by_name[value] || [];
             const unique = [...new Set(ids.map(String))];
@@ -237,6 +351,18 @@ async function buildPositionPlan(env, cache, args) {
     const inverse = {};
     for (const [dataKey, fieldId] of Object.entries(fields))
         inverse[String(fieldId)] = dataKey;
+    // 继承来的薪资若明显偏低（历史脏数据，实测出现过 300 元月薪），额外点名提示。
+    // 不阻断提交（薪资是必填项，阻断等于无法建档），但要求 Agent 在确认摘要里明确提示用户核对。
+    const inheritedSalaryWarnings = [];
+    for (const key of ['salary_min', 'salary_max']) {
+        if (!inherited.includes(key))
+            continue;
+        const raw = detailDisplayValue(refMap.get(String(fid(key))));
+        const num = Number(String(raw).replace(/[^\d.]/g, ''));
+        if (raw && Number.isFinite(num) && num > 0 && num < 1000) {
+            inheritedSalaryWarnings.push(`${key} 继承值「${raw}」明显偏低（疑历史脏数据），请人工核对后再提交`);
+        }
+    }
     return {
         objId,
         formId,
@@ -250,6 +376,12 @@ async function buildPositionPlan(env, cache, args) {
             explicitApplied: applied,
             explicitSkipped: skipped,
             inheritedFromExistingPosition: inherited,
+            // 带值的继承清单：Agent 必须在确认摘要里逐项点名（尤其 work_location），
+            // 不得因为它是默认值就略过——历史上这里曾静默带出过重复地点等脏数据。
+            inheritedFromRef: inherited.length
+                ? inherited.map((k) => ({ field: k, value: detailDisplayValue(refMap.get(String(fid(k)))) }))
+                : undefined,
+            inheritedSalaryWarnings: inheritedSalaryWarnings.length ? inheritedSalaryWarnings : undefined,
             noReferenceValue: missingRef,
             principalDefault: session.userId ? '当前登录用户' : '未解析到当前用户',
         },
@@ -283,13 +415,13 @@ const positionCreatePrepare = {
             userId: session.userId,
             payload: { objId: plan.objId, formId: plan.formId, positionName: String(args.positionName).trim(), dataDetails: plan.dataDetails },
             fingerprint: fingerprint({ objId: plan.objId, dataDetails: plan.dataDetails }),
-        }, 10 * 60 * 1000);
+        }, CONTINUATION_TTL_MS);
         return ehrSuccess('ehr.recruit.position.create.prepare', {
             status: 'AWAITING_CONFIRMATION',
             preview: { action: '生成职位JD并建职位（saveFormData → addPosition）', ...plan.summary },
             willSubmit: { objId: plan.objId, formId: plan.formId, dataDetails: plan.dataDetails },
             continuation,
-            expiresInSeconds: 600,
+            expiresInSeconds: CONTINUATION_TTL_SECONDS,
         });
     },
 };

package/dist/shortcuts/ehr/operations/recruit-write.js

@@ -1,7 +1,7 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { createHash } from 'node:crypto';
 import { ehrConfirmationError, ehrPartialError, ehrValidationError, EhrCliError } from '../errors.js';
 import { WRITE, ehrSuccess, schemaOf, } from './types.js';
-const CONTINUATION_TTL_SECONDS = 600;
 function fingerprint(value) {
     return createHash('sha256').update(JSON.stringify(value ?? null)).digest('hex').slice(0, 32);
 }

package/dist/shortcuts/esb/continuation.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_MS } from '../../core/continuation-ttl.js';
 import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
 import { existsSync } from 'node:fs';
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
@@ -35,7 +36,7 @@ function signature(payload, key) {
 }
 export function createEsbContinuationSigner(ctx) {
     return {
-        async issue(payload, ttlMs = 10 * 60_000) {
+        async issue(payload, ttlMs = CONTINUATION_TTL_MS) {
             const issuedAt = Date.now();
             const body = encode({ ...payload, issuedAt, expiresAt: issuedAt + ttlMs });
             const sig = signature(body, await loadKey(ctx));

package/dist/shortcuts/esb/index.js

@@ -1,5 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { reportPlatformError } from '../../core/error-codes.js';
 import { createEsbContinuationSigner } from './continuation.js';
 import { createEsbHost } from './host.js';
 import { esbManifest } from './manifest.js';
@@ -85,6 +86,7 @@ async function executeAndPrint(ctx, operation, input) {
         ctx.output.write(successEnvelope(operation, result), { json: true });
     }
     catch (error) {
+        reportPlatformError(error);
         console.error(JSON.stringify(failureEnvelope(error), null, 2));
         process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
     }

package/dist/shortcuts/esb/operations/trigger.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { esbSuccess } from './types.js';
 import { esbValidationError } from '../errors.js';
 import { isEsbFlowUnavailable } from '../host.js';
@@ -51,7 +52,7 @@ export const esbTriggerHandlers = {
             requestPreview: payload,
             templateFields,
             continuation: token,
-            expiresInSeconds: 600,
+            expiresInSeconds: CONTINUATION_TTL_SECONDS,
         }, { status: 'PREPARED' }, warnings);
     },
     'esb.trigger.apply': async (input, { host, continuation }) => {

package/dist/shortcuts/fna/continuation.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_MS } from '../../core/continuation-ttl.js';
 import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
 import { existsSync } from 'node:fs';
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
@@ -35,7 +36,7 @@ function signature(payload, key) {
 }
 export function createFnaContinuationSigner(ctx) {
     return {
-        async issue(payload, ttlMs = 10 * 60_000) {
+        async issue(payload, ttlMs = CONTINUATION_TTL_MS) {
             const issuedAt = Date.now();
             const body = encode({ ...payload, issuedAt, expiresAt: issuedAt + ttlMs });
             const sig = signature(body, await loadKey(ctx));

package/dist/shortcuts/fna/index.js

@@ -1,5 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { reportPlatformError } from '../../core/error-codes.js';
 import { createFnaContinuationSigner } from './continuation.js';
 import { createFnaHost } from './host.js';
 import { fnaManifest } from './manifest.js';
@@ -84,6 +85,7 @@ async function executeAndPrint(ctx, operation, input) {
         ctx.output.write(successEnvelope(operation, result), { json: true });
     }
     catch (error) {
+        reportPlatformError(error);
         console.error(JSON.stringify(failureEnvelope(error), null, 2));
         process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
     }

package/dist/shortcuts/fna/operations/invoice-writeoff.js

@@ -1,7 +1,7 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { fnaPartialError, fnaValidationError, isFnaNetworkError } from '../errors.js';
 import { fnaSuccess, READ, schemaOf, SCHEMA_INTEGER_POSITIVE, WRITE } from './types.js';
 import { compact, fingerprint, normalizeWeaTable, requireConfirm, requireRequestIds, toPositiveInt, unwrapData, verifyLease } from './shared.js';
-const CONTINUATION_TTL_SECONDS = 600;
 /** 发票核销公开字段（InvWriteOffSearchVo 非分页部分）。 */
 const WRITE_OFF_FILTER_FIELDS = {
     invoiceStatus: {

package/dist/shortcuts/fna/operations/loan.js

@@ -1,7 +1,7 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { fnaPartialError, fnaValidationError, isFnaNetworkError } from '../errors.js';
 import { fnaSuccess, READ, schemaOf, SCHEMA_INTEGER_POSITIVE, SCHEMA_STRING_NONEMPTY, WRITE } from './types.js';
 import { compact, fingerprint, normalizeWeaTable, requireConfirm, requireRemindRows, summarizeRemindRows, toPositiveInt, unwrapData, verifyLease } from './shared.js';
-const CONTINUATION_TTL_SECONDS = 600;
 const LOAN_MENU_FIELDS = {
     menuCode: { ...SCHEMA_STRING_NONEMPTY, description: '菜单编码，如 fesx_fna_borrowingManagement（与环境核对）' },
     permissionSetCode: { ...SCHEMA_STRING_NONEMPTY, description: '权限集编码，如 fesx_fna_borrowingManagement.default（与环境核对）' },

package/dist/shortcuts/hrm/index.js

@@ -1,5 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { reportPlatformError } from '../../core/error-codes.js';
 import { createHrmHost } from './host.js';
 import { hrmManifest } from './manifest.js';
 import { executeHrmOperation } from './operations.js';
@@ -129,6 +130,7 @@ async function executeAndPrint(ctx, operation, input) {
         ctx.output.write(successEnvelope(operation, result), { json: true });
     }
     catch (error) {
+        reportPlatformError(error);
         console.error(JSON.stringify(failureEnvelope(error), null, 2));
         process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
     }

package/dist/shortcuts/im/continuation.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_MS } from '../../core/continuation-ttl.js';
 import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
 import { existsSync } from 'node:fs';
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
@@ -35,7 +36,7 @@ function signature(payload, key) {
 }
 export function createImContinuationSigner(ctx) {
     return {
-        async issue(payload, ttlMs = 10 * 60_000) {
+        async issue(payload, ttlMs = CONTINUATION_TTL_MS) {
             const issuedAt = Date.now();
             const body = encode({ ...payload, issuedAt, expiresAt: issuedAt + ttlMs });
             const sig = signature(body, await loadKey(ctx));

package/dist/shortcuts/index.js

@@ -145,6 +145,11 @@ export const builtinShortcuts = [
         description: '泛微E10今承达合同管理 CLI',
         load: async () => (await import('./contract/index.js')).contractShortcut,
     }),
+    lazyShortcut({
+        name: 'reception',
+        description: '泛微客户参观接待流程 CLI（面板/行程单与内部方案/填单页预填）',
+        load: async () => (await import('./reception/index.js')).receptionShortcut,
+    }),
 ];
 /** 全部 shortcut 的 CLI 元数据（不触发任何实现模块加载）。 */
 export function shortcutMetadata() {

package/dist/shortcuts/invoice/continuation.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_MS } from '../../core/continuation-ttl.js';
 import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
 import { existsSync } from 'node:fs';
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
@@ -35,7 +36,7 @@ function signature(payload, key) {
 }
 export function createInvoiceContinuationSigner(ctx) {
     return {
-        async issue(payload, ttlMs = 10 * 60_000) {
+        async issue(payload, ttlMs = CONTINUATION_TTL_MS) {
             const issuedAt = Date.now();
             const body = encode({ ...payload, issuedAt, expiresAt: issuedAt + ttlMs });
             const sig = signature(body, await loadKey(ctx));

package/dist/shortcuts/invoice/index.js

@@ -1,11 +1,12 @@
 import { readFile } from 'node:fs/promises';
+import { Option } from 'commander';
 import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { reportPlatformError } from '../../core/error-codes.js';
 import { createInvoiceContinuationSigner } from './continuation.js';
 import { createInvoiceHost } from './host.js';
 import { invoiceManifest } from './manifest.js';
 import { executeInvoiceOperation } from './operations.js';
-import { normalizeFields, normalizeView, formatFrom, assertProjectionSupported, applyInvoiceProjection, } from './projection.js';
-import { renderInvoiceMarkdown } from './markdown.js';
+import { normalizeFields, normalizeView, assertProjectionSupported, applyInvoiceProjection, } from './projection.js';
 import { invoiceValidationError } from './errors.js';
 function asOptions(value) {
     return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
@@ -62,27 +63,32 @@ function withJsonInputOptions(command) {
 /**
  * 输出投影选项：让调用方一次拿到可读结果，而不必再写脚本解析完整 envelope。
  * `--view summary` 只对 list 类 operation 生效、`--view detail` 只对 invoice.get 生效（见 projection.ts）；
- * `--fields` 对所有 operation 生效；`--format markdown` 是渲染档，直接出表格文本（见 markdown.ts）。
+ * `--fields` 对所有 operation 生效。
  */
 function withOutputOptions(command) {
     command
         .option('--view <mode>', 'output view: full (default), summary (list ops) or detail (invoice.get)')
-        .option('--format <mode>', 'output format: json (default) or markdown (human-readable text)')
-        .option('--fields <paths>', 'comma-separated dot paths to keep, e.g. number,detailUrl');
+        .option('--fields <paths>', 'comma-separated dot paths to keep, e.g. number,detailUrl')
+        .addOption(new Option('--format <mode>').hideHelp());
     return command;
 }
+/** `--format` 已移除但仍隐藏接住：照旧 skill 调用的 Agent 要拿到改用 `--view` 的提示，而不是 unknown option。 */
+function rejectRemovedFormat(value) {
+    if (value === undefined || String(value).trim() === 'json')
+        return;
+    throw invoiceValidationError('format_removed', '--format markdown 已移除：列表改用 --view summary，invoice get 改用 --view detail，再按字段在回复里拼 markdown 表格');
+}
 function withInvoiceOptions(command) {
     return withOutputOptions(withJsonInputOptions(command));
 }
 function projectionFrom(options) {
     const opts = asOptions(options);
+    rejectRemovedFormat(opts.format);
     const view = normalizeView(opts.view);
     const fields = normalizeFields(opts.fields);
-    const format = formatFrom(opts.format);
     return {
         ...(view ? { view } : {}),
         ...(fields ? { fields } : {}),
-        ...(format ? { format } : {}),
     };
 }
 function intOption(value) {
@@ -123,17 +129,10 @@ async function executeAndPrint(ctx, operation, input, projection = {}) {
             continuation: createInvoiceContinuationSigner(ctx),
         });
         const projected = applyInvoiceProjection(operation, result.data, projection);
-        if (projection.format === 'markdown') {
-            // 渲染档输出的是文本，不是 envelope：与 --json 混用会让调用方误判输出契约，直接拦住。
-            if (ctx.getGlobalOptions().json) {
-                throw invoiceValidationError('input_conflict', '--format markdown 与 --json 互斥：markdown 是渲染档（文本），不是 JSON。去掉 --json 再试');
-            }
-            process.stdout.write(renderInvoiceMarkdown(operation, projected.data));
-            return;
-        }
         ctx.output.write(successEnvelope(operation, { status: result.status, data: projected.data }, projected.meta), { json: true });
     }
     catch (error) {
+        reportPlatformError(error);
         console.error(JSON.stringify(failureEnvelope(error), null, 2));
         process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
     }

package/dist/shortcuts/invoice/invoice-record.js

@@ -0,0 +1,93 @@
+/**
+ * 发票记录与票面扩展信息 `ext` 的语义提取。
+ *
+ * `ext` 是**字符串化的 JSON**。费用说明、城市、备注（常写出差地、订单行程）、起止地、上下车站点
+ * 只在这里，报销按城市 / 行程筛票离不开它。list 的完整输出（`extInfo`）、summary 视图、
+ * detail 视图共用这一份口径，避免同一业务概念在不同出口换名。
+ */
+/**
+ * `/api/inc/sync` 的 `mext` 按位选择返回哪些 ext 字段（1=trate、2=ttax …），不传就不返回 ext。
+ * 全 1 掩码返回完整 ext；取 int32 上限，避免服务端按 int 解析时溢出。
+ */
+export const FULL_EXT_MASK = 2147483647;
+/** `extInfo` 及 summary / detail 视图里来自 `ext` 的语义字段。 */
+export const EXT_INFO_FIELDS = [
+    'expenseNote',
+    'content',
+    'city',
+    'province',
+    'comment',
+    'from',
+    'to',
+    'stationGetOn',
+    'stationGetOff',
+];
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function text(value) {
+    if (value === undefined || value === null)
+        return '';
+    return String(value).replace(/^\uFEFF/u, '').trim();
+}
+function firstText(...values) {
+    for (const value of values) {
+        const candidate = text(value);
+        if (candidate)
+            return candidate;
+    }
+    return '';
+}
+/**
+ * 列表项一般是平铺的发票对象；也兼容 `{ info, ret, is_valid }` 包装（与 `invoice.get` 同形）。
+ * 只有外层没有票面字段、且 `info` 是对象时才拆包，避免误拆业务字段。
+ */
+export function invoiceRecordOf(item) {
+    const record = asRecord(item);
+    const inner = asRecord(record.info);
+    const hasOwnInvoiceFields = record.comm_info !== undefined || record.fid !== undefined || record.number !== undefined;
+    return !hasOwnInvoiceFields && Object.keys(inner).length ? inner : record;
+}
+/** 解析失败按空对象处理，不让脏数据打断输出。已是对象时直接使用。 */
+export function parseInvoiceExt(value) {
+    if (value && typeof value === 'object')
+        return asRecord(value);
+    const raw = text(value);
+    if (!raw)
+        return {};
+    try {
+        return asRecord(JSON.parse(raw));
+    }
+    catch {
+        return {};
+    }
+}
+function productNames(products) {
+    if (!Array.isArray(products))
+        return '';
+    return products.map((product) => text(asRecord(product).name)).filter(Boolean).join('、');
+}
+/**
+ * 从一条发票记录里提取 `ext` 的语义字段，空值省键。
+ * 起止地与上下车站点在不同票种里位置不一：先取 `ext`，再取票面顶层，最后取 `ext.passengersService[0]`。
+ */
+export function invoiceExtInfo(invoice) {
+    const ext = parseInvoiceExt(invoice.ext);
+    const passenger = asRecord(Array.isArray(ext.passengersService) ? ext.passengersService[0] : undefined);
+    const info = {
+        expenseNote: text(ext.expenseDesc),
+        content: firstText(ext.content, productNames(ext.products)),
+        city: text(ext.city),
+        province: firstText(ext.province, invoice.province),
+        comment: text(ext.comment),
+        from: firstText(ext.from, invoice.from, passenger.from),
+        to: firstText(ext.to, invoice.to, passenger.to),
+        stationGetOn: firstText(ext.station_geton, invoice.station_geton, passenger.station_geton),
+        stationGetOff: firstText(ext.station_getoff, invoice.station_getoff, passenger.station_getoff),
+    };
+    for (const [key, value] of Object.entries(info)) {
+        if (!value)
+            delete info[key];
+    }
+    return info;
+}