weaver-work-cli 0.1.2 → 0.1.5

package/dist/shortcuts/asset/operations/query.js

@@ -0,0 +1,249 @@
+import { buildCardLink, pickPersonField } from '../host.js';
+import { ziguanjiaValidationError } from '../errors.js';
+import { ziguanjiaFixed } from '../manifest.js';
+import { loadTypeCache, matchTypeName, saveTypeCache } from './type-cache.js';
+import { asObject, buildPageInfo, evaluateVersionGate, getDatas, mainTableOf, ok, } from './shared.js';
+const SCENE_TAGS = ziguanjiaFixed.VIEW_LINK_SCENE_TAGS;
+export class ZiguanjiaQueryOperation {
+    name;
+    config;
+    constructor(name, config) {
+        this.name = name;
+        this.config = config;
+    }
+    async execute(input, context) {
+        const { host } = context;
+        const body = asObject(input, this.name);
+        for (const key of Object.keys(body)) {
+            if (!this.config.bodyFields.includes(key)
+                && key !== 'page_no'
+                && key !== 'page_size'
+                && key !== 'person_id'
+                && key !== 'with_view_link') {
+                throw ziguanjiaValidationError('input_field_unsupported', `查询不支持字段：${key}`);
+            }
+        }
+        if (this.config.requireAtLeastOne && !this.config.requireAtLeastOne.some((f) => body[f] !== undefined && body[f] !== '')) {
+            throw ziguanjiaValidationError('input_required', `至少需要提供一个字段：${this.config.requireAtLeastOne.join(' / ')}`);
+        }
+        const session = await host.getSession();
+        const mainTable = {};
+        const query = {};
+        for (const field of this.config.bodyFields) {
+            // person_id 是"人员值"输入，由下方 person 块按契约落到 URL / 运行时字段 / 固定字段，禁止直写 mainTable。
+            if (field === 'person_id')
+                continue;
+            if (body[field] !== undefined && body[field] !== '')
+                mainTable[field] = body[field];
+        }
+        // 人员过滤三态：URL 查询参数 / 运行时字段定义 / 固定 body 字段；person_id 缺省时按 defaultPersonIdFromSession 回落当前登录人。
+        const providedPersonId = body.person_id !== undefined && body.person_id !== '' ? body.person_id : undefined;
+        const hasPurchaser = body.purchaser !== undefined && body.purchaser !== '';
+        const personValue = providedPersonId !== undefined
+            ? providedPersonId
+            : this.config.defaultPersonIdFromSession && !hasPurchaser
+                ? session.userId
+                : undefined;
+        if (personValue !== undefined) {
+            if (this.config.personQueryParam) {
+                query[this.config.personQueryParam] = personValue;
+            }
+            else if (this.config.personField) {
+                const fields = await host.getFormFields(this.config.personField.formTag);
+                const field = pickPersonField(fields, this.config.personField.candidates);
+                if (!field || !field.name) {
+                    throw ziguanjiaValidationError('person_field_unresolved', `无法从表单 ${this.config.personField.formTag} 的字段定义中确定领用人字段（候选：${this.config.personField.candidates.join(' / ')}）；请明确提供具体的领用人字段名或人员 ID`);
+                }
+                mainTable[field.name] = personValue;
+            }
+            else if (this.config.writePersonIdTo) {
+                mainTable[this.config.writePersonIdTo] = personValue;
+            }
+            else {
+                mainTable.person_id = personValue;
+            }
+        }
+        const pageInfo = buildPageInfo(body.page_no, body.page_size, this.config.pageSizeDefault);
+        const request = {
+            endpoint: 'getFormDataList',
+            interfacePk: this.config.interfacePk,
+            operation: this.name,
+            body: { mainTable, pageInfo },
+        };
+        // 仅在确有人员过滤时才带 URL query，保持无过滤时请求形状干净。
+        if (Object.keys(query).length > 0)
+            request.query = query;
+        const result = await host.ebuilderRequest(request);
+        const datas = getDatas(result).map(mainTableOf);
+        let viewLinkWarning;
+        if (this.config.viewLinkScene && body.with_view_link !== false) {
+            const formTag = SCENE_TAGS[this.config.viewLinkScene];
+            try {
+                const objId = await host.resolveFormId({ formTag, operation: this.name });
+                for (const item of datas) {
+                    const dataId = item.id ?? item.mainTable?.id;
+                    const link = dataId !== undefined && dataId !== null ? buildCardLink(session.baseUrl, objId, String(dataId)) : null;
+                    if (link)
+                        item.view_link = link;
+                }
+            }
+            catch (error) {
+                // 红线：链接是附加信息，解析失败只说明「链接暂不可用」，绝不因此重试主查询。
+                viewLinkWarning = `查看链接暂不可用：${error instanceof Error ? error.message : String(error)}；主查询已成功，不要因此重试查询。`;
+            }
+        }
+        return ok('COMPLETE', {
+            items: datas,
+            count: datas.length,
+            ...(viewLinkWarning ? { view_link_warning: viewLinkWarning } : {}),
+        });
+    }
+}
+export class ZiguanjiaResolveOperation {
+    name;
+    interfacePk;
+    nameField;
+    enableTypeCache;
+    constructor(name, interfacePk, nameField, enableTypeCache = false) {
+        this.name = name;
+        this.interfacePk = interfacePk;
+        this.nameField = nameField;
+        this.enableTypeCache = enableTypeCache;
+    }
+    async execute(input, context) {
+        const { host } = context;
+        const body = asObject(input, this.name);
+        const nameValue = typeof body[this.nameField] === 'string' ? body[this.nameField].trim() : '';
+        if (nameValue === '')
+            throw ziguanjiaValidationError('input_required', `必须提供 ${this.nameField}`);
+        // 资产类型：优先用运行时缓存（24h），减少反复打接口（_dict.md「资产类型解析」）。
+        if (this.enableTypeCache) {
+            const session = await host.getSession();
+            const cache = await loadTypeCache(session.baseUrl);
+            if (cache) {
+                const m = matchTypeName(cache.items, nameValue);
+                if (m) {
+                    return this.resolved(nameValue, m.id, m.matched, cache.items.length);
+                }
+                // 缓存命中但名称未匹配：回退实时全量枚举并刷新缓存（可能字典新增了类型）。
+            }
+            const all = await this.enumerateAll(host);
+            if (!cache)
+                await saveTypeCache(session.baseUrl, all);
+            const m2 = matchTypeName(all, nameValue);
+            if (m2)
+                return this.resolved(nameValue, m2.id, m2.matched, all.length);
+            const contains = all.filter((i) => i.type_name.includes(nameValue) || nameValue.includes(i.type_name));
+            if (contains.length > 1) {
+                throw ziguanjiaValidationError('resolve_ambiguous', `按 ${this.nameField}=${nameValue} 模糊解析到多条候选，请改用 ID 或提供更精确名称`, {
+                    candidates: contains.slice(0, 10).map((i) => ({ id: i.id, name: i.type_name })),
+                });
+            }
+            throw ziguanjiaValidationError('resolve_not_found', `未解析到 ${this.nameField}=${nameValue} 的资产类型（本环境正式名如「便携式计算机」而非「笔记本电脑」）`);
+        }
+        // 地点 / 状态：实时查询 + 精确匹配；0 命中回退全量枚举再比对；contains 命中单条采用。
+        const filtered = await host.ebuilderRequest({
+            endpoint: 'getFormDataList',
+            interfacePk: this.interfacePk,
+            operation: this.name,
+            body: { mainTable: { [this.nameField]: nameValue }, pageInfo: buildPageInfo(undefined, undefined, 50) },
+        });
+        const exact = getDatas(filtered).map(mainTableOf).filter((item) => String(item[this.nameField] ?? '') === nameValue);
+        if (exact.length >= 1) {
+            if (exact.length > 1) {
+                throw ziguanjiaValidationError('resolve_ambiguous', `按 ${this.nameField}=${nameValue} 解析到多条记录，请改用 ID 明确指定`, {
+                    candidates: exact.slice(0, 10).map((item) => item.id ?? item.mainTable?.id),
+                });
+            }
+            return this.resolved(nameValue, String(exact[0].id ?? exact[0].mainTable?.id), 'exact', exact.length);
+        }
+        const full = await host.ebuilderRequest({
+            endpoint: 'getFormDataList',
+            interfacePk: this.interfacePk,
+            operation: this.name,
+            body: { mainTable: {}, pageInfo: buildPageInfo(undefined, undefined, 50) },
+        });
+        const allItems = getDatas(full).map(mainTableOf);
+        const exactAll = allItems.filter((item) => String(item[this.nameField] ?? '') === nameValue);
+        if (exactAll.length >= 1) {
+            if (exactAll.length > 1) {
+                throw ziguanjiaValidationError('resolve_ambiguous', `按 ${this.nameField}=${nameValue} 解析到多条记录，请改用 ID 明确指定`, {
+                    candidates: exactAll.slice(0, 10).map((item) => item.id ?? item.mainTable?.id),
+                });
+            }
+            return this.resolved(nameValue, String(exactAll[0].id ?? exactAll[0].mainTable?.id), 'exact', allItems.length);
+        }
+        const contains = allItems.filter((item) => {
+            const v = String(item[this.nameField] ?? '');
+            return v !== '' && (v.includes(nameValue) || nameValue.includes(v));
+        });
+        if (contains.length === 1) {
+            return this.resolved(nameValue, String(contains[0].id ?? contains[0].mainTable?.id), 'contains', allItems.length);
+        }
+        if (contains.length > 1) {
+            throw ziguanjiaValidationError('resolve_ambiguous', `按 ${this.nameField}=${nameValue} 模糊解析到多条候选，请改用 ID 或提供更精确名称`, {
+                candidates: contains.slice(0, 10).map((item) => ({ id: item.id ?? item.mainTable?.id, name: item[this.nameField] })),
+            });
+        }
+        throw ziguanjiaValidationError('resolve_not_found', `未解析到 ${this.nameField}=${nameValue} 的引用记录`);
+    }
+    resolved(nameValue, id, matched, total) {
+        const items = [{ id, name: nameValue }];
+        return ok(matched === 'contains' ? 'RESOLVED_FUZZY' : 'COMPLETE', {
+            items,
+            count: items.length,
+            nameField: this.nameField,
+            resolved_id: id,
+            matched,
+            ...(matched === 'contains' ? { note: `名称「${nameValue}」映射到正式名，已采用对应 ID` } : {}),
+            total_scanned: total,
+        });
+    }
+    /** 资产类型全量枚举（pageSize 50，封顶 40 页 = 2000 条），用于缓存与兜底匹配。 */
+    async enumerateAll(host) {
+        const out = [];
+        for (let page = 1; page <= 40; page++) {
+            const result = await host.ebuilderRequest({
+                endpoint: 'getFormDataList',
+                interfacePk: this.interfacePk,
+                operation: this.name,
+                body: { mainTable: {}, pageInfo: { pageNo: String(page), pageSize: '50' } },
+            });
+            const datas = getDatas(result).map(mainTableOf);
+            if (datas.length === 0)
+                break;
+            for (const item of datas) {
+                const id = item.id ?? item.mainTable?.id;
+                const typeName = item[this.nameField];
+                if (id !== undefined && id !== null && typeName !== undefined && typeName !== null) {
+                    out.push({ id: String(id), type_name: String(typeName) });
+                }
+            }
+            if (datas.length < 50)
+                break;
+        }
+        return out;
+    }
+}
+export class ZiguanjiaGateCheckOperation {
+    name = 'asset.gate.check';
+    async execute(_input, context) {
+        const { host } = context;
+        const result = await host.ebuilderRequest({
+            endpoint: 'getFormDataList',
+            interfacePk: 'zgjasset_search_appver',
+            operation: this.name,
+            body: { mainTable: {}, pageInfo: { pageNo: '1', pageSize: '10' } },
+        });
+        const gate = evaluateVersionGate(result);
+        if (!gate.passed) {
+            return ok('VERSION_GATE_FAILED', {
+                passed: false,
+                raw: gate.raw ?? null,
+                version: gate.version ?? null,
+                message: '版本门禁未通过，需要 zgjasset_search_appver 存在 ver_name ≥ V14 的记录',
+            });
+        }
+        return ok('VERSION_GATE_PASSED', { passed: true, raw: gate.raw ?? null, version: gate.version ?? null });
+    }
+}

package/dist/shortcuts/asset/operations/registry.js

@@ -0,0 +1,85 @@
+import { ziguanjiaValidationError } from '../errors.js';
+import { ziguanjiaFixed, ziguanjiaOperations } from '../manifest.js';
+import { ZiguanjiaGateCheckOperation, ZiguanjiaQueryOperation, ZiguanjiaResolveOperation, } from './query.js';
+import { ZiguanjiaViewLinkOperation } from './viewlink.js';
+import { ZiguanjiaCreateOperation, ZiguanjiaDepreOperation, ZiguanjiaPurchOperation, ZiguanjiaRepairCreateOperation, ZiguanjiaRepairQueryOperation, ZiguanjiaReturnCreateOperation, ZiguanjiaReturnQueryOperation, ZiguanjiaUpdateOperation, ZiguanjiaUseOperation, } from './write.js';
+const EB = ziguanjiaFixed.EB_INTERFACE_PK;
+function buildRegistry() {
+    const registry = new Map();
+    const handlers = [
+        new ZiguanjiaGateCheckOperation(),
+        new ZiguanjiaQueryOperation('asset.list', {
+            interfacePk: EB.baseList,
+            bodyFields: ['id', 'asset_name', 'asset_number', 'stateid', 'asset_type_browse', 'location_browse', 'admin_istrator', 'resourceid'],
+            pageSizeDefault: 10,
+            // 资产列表：给了人员才拼 ?person_id=，未给人员不拼（不设置 defaultPersonIdFromSession）。
+            personQueryParam: 'person_id',
+            viewLinkScene: 'asset_info',
+        }),
+        new ZiguanjiaQueryOperation('asset.detail', {
+            interfacePk: EB.baseDetail,
+            bodyFields: ['id', 'asset_number', 'asset_name'],
+            pageSizeDefault: 10,
+            requireAtLeastOne: ['id', 'asset_number', 'asset_name'],
+            viewLinkScene: 'asset_info',
+        }),
+        new ZiguanjiaQueryOperation('asset.uselist', {
+            interfacePk: EB.useList,
+            bodyFields: [],
+            pageSizeDefault: 5,
+            // 领用人字段以运行时字段定义为准（候选 resourceid/apply_person/use_person），不硬编码 person_id。
+            defaultPersonIdFromSession: true,
+            personField: { formTag: 'uf_asset_use', candidates: ['resourceid', 'apply_person', 'use_person'] },
+            viewLinkScene: 'asset_use',
+        }),
+        new ZiguanjiaQueryOperation('asset.repaillist', {
+            interfacePk: EB.repairList,
+            bodyFields: [],
+            pageSizeDefault: 5,
+            // 报修记录：人员写入主表 repair_user（来源 _person.md 契约）。
+            defaultPersonIdFromSession: true,
+            writePersonIdTo: 'repair_user',
+            viewLinkScene: 'asset_repail',
+        }),
+        new ZiguanjiaQueryOperation('asset.purchaselist', {
+            interfacePk: EB.purchList,
+            bodyFields: ['purchaser'],
+            pageSizeDefault: 5,
+            // 采购申请：人员拼 ?person_id=（默认当前登录人）；purchaser 走 body，二者同一请求只用其一。
+            defaultPersonIdFromSession: true,
+            personQueryParam: 'person_id',
+            viewLinkScene: 'asset_purch_apply',
+        }),
+        new ZiguanjiaResolveOperation('asset.resolve.location', EB.location, 'house_name'),
+        new ZiguanjiaResolveOperation('asset.resolve.status', EB.status, 'status_name'),
+        new ZiguanjiaResolveOperation('asset.resolve.type', EB.type, 'type_name', true),
+        new ZiguanjiaCreateOperation(),
+        new ZiguanjiaUpdateOperation(),
+        new ZiguanjiaUseOperation(),
+        new ZiguanjiaReturnQueryOperation(),
+        new ZiguanjiaReturnCreateOperation(),
+        new ZiguanjiaRepairQueryOperation(),
+        new ZiguanjiaRepairCreateOperation(),
+        new ZiguanjiaPurchOperation(),
+        new ZiguanjiaDepreOperation(),
+        new ZiguanjiaViewLinkOperation(),
+    ];
+    for (const handler of handlers) {
+        if (registry.has(handler.name))
+            throw new Error(`duplicate ziguanjia operation handler: ${handler.name}`);
+        registry.set(handler.name, handler);
+    }
+    for (const contract of ziguanjiaOperations) {
+        if (!registry.has(contract.name))
+            throw new Error(`missing ziguanjia operation handler: ${contract.name}`);
+    }
+    return registry;
+}
+const ziguanjiaOperationRegistry = buildRegistry();
+export function getZiguanjiaOperation(operation) {
+    const handler = ziguanjiaOperationRegistry.get(operation);
+    if (!handler) {
+        throw ziguanjiaValidationError('operation_unknown', `资管家不支持操作：${operation}`);
+    }
+    return handler;
+}

package/dist/shortcuts/asset/operations/shared.js

@@ -0,0 +1,100 @@
+import { ziguanjiaValidationError } from '../errors.js';
+export function ok(status, data) {
+    return { status, data };
+}
+export function asObject(value, name = '业务输入') {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw ziguanjiaValidationError('input_invalid', `${name}必须是 JSON 对象`);
+    }
+    return value;
+}
+export function getDatas(value) {
+    const root = value && typeof value === 'object' && 'datajson' in value ? value.datajson : value;
+    if (!root || !Array.isArray(root.datas))
+        return [];
+    return root.datas;
+}
+export function mainTableOf(item) {
+    if (!item || typeof item !== 'object')
+        return {};
+    if (item.mainTable && typeof item.mainTable === 'object')
+        return item.mainTable;
+    return item;
+}
+export function buildPageInfo(pageNo, pageSize, defaultPageSize = 10) {
+    // 源资料约定 pageInfo.pageNo/pageSize 为字符串（"1"/"10"），E10 ebuilder 按字符串分页。
+    const norm = (value, fallback) => {
+        const num = typeof value === 'number' && Number.isFinite(value) ? value : Number(value);
+        return String(typeof num === 'number' && Number.isFinite(num) && num >= 1 ? Math.trunc(num) : fallback);
+    };
+    return {
+        pageNo: norm(pageNo, 1),
+        pageSize: norm(pageSize, defaultPageSize),
+    };
+}
+export function asPositiveString(value, name) {
+    if (typeof value !== 'string' || !/^\d+$/u.test(value) || value === '0') {
+        throw ziguanjiaValidationError('input_invalid', `${name} 必须是正整数文本`);
+    }
+    return value;
+}
+/**
+ * 动作流返回统一透传。
+ *
+ * 源资料约定：业务数据挂在 `actionData.responseData.customData.mainTable`
+ * （部分环境/接口可能只到 `actionData.customData.mainTable`）。
+ * 创建类动作流返回的 `lcID`（流程 ID）/ `ghbh`（归还编号）/ `lcbt`（流程标题）/
+ * `repail_no` 等关键标识都在 `mainTable` 里，是后续拼「查看详情」链接的唯一来源
+ * （见 `_viewlink.md`：asset_return / asset_repail / asset_use / asset_purch_apply 场景取 lcID 作 dataID）。
+ *
+ * 因此**必须整体透传**，并额外把 `mainTable` 提到顶层、再保留 customData / responseData，
+ * 避免调用方取不到流程 ID 而无法生成链接（历史缺陷：return.create 只回 resultCode/resultMsg，
+ * 把 actionData 整个丢掉，导致归还单拿不到 lcID）。
+ */
+export function actionFlowResult(result) {
+    const actionData = result?.actionData ?? {};
+    const responseData = actionData?.responseData ?? {};
+    const customData = responseData?.customData ?? actionData?.customData ?? {};
+    return {
+        resultCode: result?.resultCode,
+        resultMsg: result?.resultMsg,
+        actionData,
+        responseData,
+        customData,
+        mainTable: customData?.mainTable ?? {},
+    };
+}
+function extractVersionField(mainTable) {
+    const raw = mainTable?.ver_name ?? mainTable?.current_ver;
+    if (raw === undefined || raw === null)
+        return undefined;
+    return String(raw).trim();
+}
+export function parseVersion(value) {
+    const cleaned = value.replace(/^v/iu, '').replace(/\s+/gu, '');
+    const match = cleaned.match(/\d+/u);
+    return match ? Number(match[0]) : undefined;
+}
+export function evaluateVersionGate(value) {
+    const datas = getDatas(value);
+    const first = datas[0] ? mainTableOf(datas[0]) : undefined;
+    const raw = first ? extractVersionField(first) : undefined;
+    if (!raw)
+        return { passed: false, raw };
+    const version = parseVersion(raw);
+    if (version === undefined)
+        return { passed: false, raw, versionField: raw };
+    return { passed: version >= 14, raw, version };
+}
+export async function ensureVersionGate(host, operation) {
+    const result = await host.ebuilderRequest({
+        endpoint: 'getFormDataList',
+        interfacePk: 'zgjasset_search_appver',
+        operation,
+        body: { mainTable: {}, pageInfo: { pageNo: '1', pageSize: '10' } },
+    });
+    const gate = evaluateVersionGate(result);
+    if (!gate.passed) {
+        throw ziguanjiaValidationError('version_gate_failed', `版本门禁未通过（zgjasset_search_appver 无 ver_name ≥ V14 记录，实际=${gate.raw ?? '空'}），已停止，不执行任何资产查询 / 写操作。待门禁真正通过后再处理。`, { gate });
+    }
+}

package/dist/shortcuts/asset/operations/type-cache.js

@@ -0,0 +1,49 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+/**
+ * 资产类型解析运行时缓存（源资料 _dict.md「资产类型解析」）。
+ * 资产类型数据量可能很大，且「默认子集只返部分记录」是常见坑；首次解析某环境全量类型后
+ * 落到 skill 包之外的运行时数据目录，之后本地匹配、24h 过期重建。严禁写入 skill 包内（对外分发）。
+ */
+const CACHE_DIR = path.join(os.homedir(), '.workbuddy', 'data', 'weaver-e10-ziguanjia');
+const TTL_MS = 24 * 60 * 60 * 1000;
+export async function loadTypeCache(env) {
+    try {
+        const raw = await fs.readFile(path.join(CACHE_DIR, `asset_type_cache_${env}.json`), 'utf8');
+        const data = JSON.parse(raw);
+        if (data.env !== env)
+            return null;
+        const age = Date.now() - new Date(data.updated_at).getTime();
+        if (!Number.isFinite(age) || age >= TTL_MS)
+            return null;
+        if (!Array.isArray(data.items))
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+export async function saveTypeCache(env, items) {
+    try {
+        await fs.mkdir(CACHE_DIR, { recursive: true });
+        await fs.writeFile(path.join(CACHE_DIR, `asset_type_cache_${env}.json`), JSON.stringify({ env, updated_at: new Date().toISOString(), count: items.length, items }, null, 2));
+    }
+    catch {
+        // 缓存写入失败仅影响下次加速，不阻断解析
+    }
+}
+/**
+ * 在已加载的类型集合中按名称匹配：精确命中单条直接采用；contains 命中单条采用（如「笔记本」命中「便携式计算机」），
+ * 并注明映射到正式名；0 命中或命中多条返回 null，由调用方决定兜底或报歧义。
+ */
+export function matchTypeName(items, name) {
+    const exact = items.find((i) => i.type_name === name);
+    if (exact)
+        return { id: exact.id, matched: 'exact' };
+    const contains = items.filter((i) => i.type_name.includes(name) || name.includes(i.type_name));
+    if (contains.length === 1)
+        return { id: contains[0].id, matched: 'contains' };
+    return null;
+}

package/dist/shortcuts/asset/operations/types.js

@@ -0,0 +1 @@
+export {};

package/dist/shortcuts/asset/operations/viewlink.js

@@ -0,0 +1,117 @@
+import { assertNoForbiddenKeys } from '../host.js';
+import { ziguanjiaValidationError } from '../errors.js';
+import { ziguanjiaFixed } from '../manifest.js';
+import { asObject, ok } from './shared.js';
+const SCENE_TAGS = ziguanjiaFixed.VIEW_LINK_SCENE_TAGS;
+const DEPRE_VIEWPORT_PATH = ziguanjiaFixed.DEPRE_VIEWPORT_PATH;
+const APP_TAG = 'weaver-asset-eb';
+const DEFAULT_ANCHOR = '查看详情';
+function isCardScene(scene) {
+    return Object.prototype.hasOwnProperty.call(SCENE_TAGS, scene);
+}
+function joinUrl(baseUrl, path) {
+    if (typeof baseUrl !== 'string' || baseUrl.trim() === '')
+        return null;
+    return `${baseUrl.replace(/\/+$/u, '')}${path}`;
+}
+/**
+ * 数据 ID 必须是可直接放进路径片段的裸 ID，不含空白与路径/查询分隔符，
+ * 避免拼接出越权或打不开的链接。
+ */
+function assertSafeDataId(dataId) {
+    if (/[\s/\\?#]/u.test(dataId)) {
+        throw ziguanjiaValidationError('input_invalid', `数据 ID 含有不允许的字符：${dataId}`);
+    }
+}
+/**
+ * 构造卡片式查看链接 /sp/ebdfpage/card/0/{表单ID}/{数据ID}，
+ * 表单 ID 经「应用标签 → 表单标签」两步接口实时解析，不写死、不臆造。
+ *
+ * 契约红线：链接是附加信息。主查询/新建/修改/动作流已经成功后，
+ * 链接解析失败只如实说明「链接暂不可用」，绝不因此重试主操作
+ * （重试会重复查询、重复建单、重复改动数据）。
+ */
+export class ZiguanjiaViewLinkOperation {
+    name = 'asset.viewlink';
+    async execute(input, context) {
+        const body = asObject(input, this.name);
+        assertNoForbiddenKeys(body);
+        const scene = typeof body.scene === 'string' ? body.scene.trim() : '';
+        if (scene === '') {
+            throw ziguanjiaValidationError('input_required', 'scene 必填');
+        }
+        const anchor = typeof body.anchor === 'string' && body.anchor.trim() !== ''
+            ? body.anchor.trim()
+            : DEFAULT_ANCHOR;
+        const session = await context.host.getSession();
+        // 计提任务是固定 viewport 页面，路径内已含页面 ID，不需要表单 ID 标签解析。
+        if (scene === 'depre_task') {
+            const calcMonth = typeof body.calc_month === 'string' ? body.calc_month.trim() : '';
+            if (!/^\d{4}-\d{2}$/u.test(calcMonth)) {
+                throw ziguanjiaValidationError('input_invalid', 'depre_task 场景必须提供 calc_month，格式 YYYY-MM');
+            }
+            const path = `${DEPRE_VIEWPORT_PATH}?calc_month=${calcMonth}`;
+            return ok('COMPLETE', {
+                scene,
+                mode: 'viewport',
+                formTag: null,
+                objId: null,
+                anchor,
+                links: [{ dataId: null, calc_month: calcMonth, path, url: joinUrl(session.baseUrl, path), anchor }],
+                available: true,
+                warnings: [],
+            });
+        }
+        if (!isCardScene(scene)) {
+            throw ziguanjiaValidationError('input_invalid', `不支持的 scene：${scene}`);
+        }
+        const ids = body.ids;
+        if (!Array.isArray(ids) || ids.length === 0) {
+            throw ziguanjiaValidationError('input_required', 'ids 必填，至少提供一个数据 ID（字符串）');
+        }
+        const dataIds = ids
+            .map((item) => (item === undefined || item === null ? '' : String(item).trim()))
+            .filter((item) => item !== '');
+        if (dataIds.length === 0) {
+            throw ziguanjiaValidationError('input_invalid', 'ids 不能全为空值');
+        }
+        for (const dataId of dataIds)
+            assertSafeDataId(dataId);
+        const formTag = SCENE_TAGS[scene];
+        let objId = null;
+        let warnings = [];
+        try {
+            objId = await context.host.resolveFormId({ formTag, appTag: APP_TAG, operation: this.name });
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            warnings = [`链接暂不可用：${reason}；主操作已成功，不要因此重试查询 / 建单 / 改单。`];
+        }
+        if (!objId) {
+            return ok('VIEWLINK_UNAVAILABLE', {
+                scene,
+                mode: 'card',
+                formTag,
+                objId: null,
+                anchor,
+                links: [],
+                available: false,
+                warnings,
+            });
+        }
+        const links = dataIds.map((dataId) => {
+            const path = `/sp/ebdfpage/card/0/${objId}/${dataId}`;
+            return { dataId, path, url: joinUrl(session.baseUrl, path), anchor };
+        });
+        return ok('COMPLETE', {
+            scene,
+            mode: 'card',
+            formTag,
+            objId,
+            anchor,
+            links,
+            available: true,
+            warnings,
+        });
+    }
+}