weaver-work-cli 0.1.28 → 0.1.31

package/dist/shortcuts/contract/operations/compare.js

@@ -0,0 +1,193 @@
+import { contractValidationError } from '../errors.js';
+import { comparePageUrl } from './page.js';
+import { requireNonEmptyString } from './shared.js';
+import { uploadFile } from './upload.js';
+const DEFAULT_PAGE_SIZE = 20;
+const VERSION_PAGE_SIZE = 100;
+function text(value) {
+    if (typeof value === 'string' && value.trim())
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return undefined;
+}
+function mapDocument(item) {
+    return {
+        id: text(item.id),
+        name: item.name,
+        folderPathName: item.folderPathName,
+        creatorName: item.docCreatorName,
+        authorName: item.docAuthorName,
+        lastUpdateTime: item.docLastUpdateTime,
+        createTime: item.docCreateTime,
+        contentType: item.contentType,
+        attachmentCount: item.countOfAttachment,
+        fileSize: item.docMetadata?.fileSize,
+        docStatus: item.docMetadata?.docStatus,
+        note: '这里的 id 是文档 ID，不是比对页需要的 fileId；确认 fileId 后再调用 contract.compare.page',
+    };
+}
+function mapVersion(item) {
+    return {
+        fileId: text(item.fileId) ?? text(item.id) ?? text(item.fileid),
+        docId: text(item.docId),
+        fileName: item.fileName ?? item.name,
+        version: item.version ?? item.versionNo,
+        size: item.fileSize ?? item.size,
+        creator: item.creatorName ?? item.creator,
+        createTime: item.createTime ?? item.uploadTime,
+    };
+}
+export const contractCompareOperations = [
+    {
+        name: 'contract.compare.upload',
+        async execute(input, { host }) {
+            const paths = input.paths;
+            if (!Array.isArray(paths) || paths.length === 0) {
+                throw contractValidationError('paths_required', 'paths 必须是非空的本地文件路径数组（基准文件在前，比对文件在后）');
+            }
+            if (paths.length > 2) {
+                throw contractValidationError('paths_too_many', '文档比对一次只接受 1~2 个文件：基准文件在前，比对文件在后');
+            }
+            const files = [];
+            for (const rawPath of paths) {
+                const path = requireNonEmptyString(rawPath, 'paths[]', 1000);
+                // 比对走独立 module，不能与审查/流程上传混用。
+                files.push(await uploadFile(host, { path, module: 'docCompared' }));
+            }
+            return {
+                status: 'COMPLETE',
+                data: {
+                    files,
+                    note: '基准文件与比对文件都拿到 fileId 后，再用 contract.compare.page 打开比对页；只比对一个文件的历史版本时改用 contract.compare.versions',
+                },
+            };
+        },
+    },
+    {
+        name: 'contract.compare.search',
+        async execute(input, { host }) {
+            const keyword = requireNonEmptyString(input.keyword, 'keyword', 200).trim();
+            const pageNo = Number.isInteger(input.pageNo) && input.pageNo > 0 ? input.pageNo : 1;
+            const pageSize = Number.isInteger(input.pageSize) && input.pageSize > 0 ? Math.min(input.pageSize, 100) : DEFAULT_PAGE_SIZE;
+            const value = await host.contractRequest({
+                method: 'POST',
+                path: '/api/doc/documents/list',
+                body: {
+                    conditions: [
+                        { id: 'name', type: 'string', value: keyword },
+                        { id: 'itsEqual_author', type: 'string', value: 'eq' },
+                        { id: 'itsEqual_creator', type: 'string', value: 'eq' },
+                        { id: 'itsBelong_label', type: 'string', value: 'eq' },
+                        { id: 'itsBelong_myTag', type: 'string', value: 'eq' },
+                        { id: 'itsBelong_folder', type: 'string', value: 'eq' },
+                    ],
+                    keywords: keyword,
+                    customConditions: [],
+                    pageNo,
+                    pageSize,
+                },
+            });
+            const data = (value?.data ?? {});
+            const list = Array.isArray(data.list) ? data.list : [];
+            return {
+                status: 'COMPLETE',
+                data: {
+                    keyword,
+                    total: data.total,
+                    pageNo: data.pageNo ?? pageNo,
+                    pageSize,
+                    documents: list.map(mapDocument),
+                    hint: list.length > 1 ? '命中多条时必须让用户确认具体文档，禁止自动选第一条' : undefined,
+                },
+            };
+        },
+    },
+    {
+        name: 'contract.compare.versions',
+        async execute(input, { host }) {
+            const fileId = requireNonEmptyString(input.fileId, 'fileId', 64);
+            const docId = text(input.docId);
+            const pageNo = Number.isInteger(input.pageNo) && input.pageNo > 0 ? input.pageNo : 1;
+            const body = {
+                pageNo,
+                pageSize: VERSION_PAGE_SIZE,
+                id: fileId,
+                startTime: '',
+                endTime: '',
+                userIds: '',
+                pauuid: '0c18b0f471184d8fa584501465fa5827',
+                endType: 'Windows',
+                module: 'document',
+                maxUploadSize: '5000',
+                mobile: false,
+                enterprisePan: false,
+                customParam: '{"fromPCDoc":1}',
+                authModule: 'document',
+                notLoggedIn: false,
+                autoSelect: false,
+                coordinateFlag: false,
+                deepClean: false,
+                publicFileHost: '',
+                tempFileType: '1',
+                create: false,
+                batchCollaboration: false,
+                fileId,
+            };
+            if (docId)
+                body.docId = docId;
+            const value = await host.contractRequest({
+                method: 'POST',
+                path: '/api/file/base/upload/findVersionList',
+                body,
+            });
+            const data = (value?.data ?? {});
+            const list = Array.isArray(data.list) ? data.list : Array.isArray(data) ? data : [];
+            return {
+                status: 'COMPLETE',
+                data: {
+                    fileId,
+                    total: data.total,
+                    versions: list.map(mapVersion),
+                    hint: list.length > 1 ? '多版本时让用户选择目标版本，禁止自动选第一条' : undefined,
+                },
+            };
+        },
+    },
+    {
+        name: 'contract.compare.page',
+        async execute(input, { host }) {
+            const baseFileId = requireNonEmptyString(input.baseFileId, 'baseFileId', 64);
+            const baseFileName = requireNonEmptyString(input.baseFileName, 'baseFileName', 300);
+            const compareFileId = requireNonEmptyString(input.compareFileId, 'compareFileId', 64);
+            const compareFileName = requireNonEmptyString(input.compareFileName, 'compareFileName', 300);
+            const session = await host.getSession();
+            return {
+                status: 'COMPLETE',
+                data: {
+                    url: comparePageUrl(session.baseUrl, { fileId: baseFileId, fileName: baseFileName }, { fileId: compareFileId, fileName: compareFileName }),
+                    page: { width: 1000 },
+                    note: 'url 保持字面方括号与中文原样，不做整体编码',
+                },
+            };
+        },
+    },
+    {
+        name: 'contract.compare.diff',
+        async execute(input, { host }) {
+            const baseFileId = requireNonEmptyString(input.baseFileId, 'baseFileId', 64);
+            const compareFileId = requireNonEmptyString(input.compareFileId, 'compareFileId', 64);
+            const value = await host.contractRequest({
+                method: 'POST',
+                path: '/api/ebd/contract/ai/getCompareRes',
+                // 两个字段都是数组，即使只有一个文件也不能传字符串。
+                body: { baseFileIds: [baseFileId], compareFileIds: [compareFileId] },
+                timeoutMs: 120_000,
+            });
+            return {
+                status: 'COMPLETE',
+                data: { baseFileId, compareFileId, result: value },
+            };
+        },
+    },
+];

package/dist/shortcuts/contract/operations/credit-page.js

@@ -0,0 +1,34 @@
+import { contractValidationError } from '../errors.js';
+import { creditPageUrl } from './page.js';
+import { requireNonEmptyString } from './shared.js';
+const MAX_SUBJECTS = 20;
+export const contractCreditPageOperations = [
+    {
+        name: 'contract.credit.page',
+        async execute(input, { host }) {
+            if (!Array.isArray(input.names) || input.names.length === 0) {
+                throw contractValidationError('names_required', 'names 必须是非空的企业全称数组');
+            }
+            if (input.names.length > MAX_SUBJECTS) {
+                throw contractValidationError('names_too_many', `一次最多查询 ${MAX_SUBJECTS} 个主体`);
+            }
+            const names = input.names.map((raw, index) => {
+                const name = requireNonEmptyString(raw, `names[${index}]`, 200).trim();
+                if (name.length < 4) {
+                    throw contractValidationError('name_not_full', `names[${index}] 看起来不是营业执照全称（"${name}"）；简称查不到，请补齐全称并先让用户确认`);
+                }
+                return name;
+            });
+            const session = await host.getSession();
+            return {
+                status: 'COMPLETE',
+                data: {
+                    names,
+                    url: creditPageUrl(session.baseUrl, names),
+                    page: { title: '资信查询', activate: true, width: 1000 },
+                    note: '本能力只打开资信页面，不调用资信数据接口；从合同抽取的主体必须先让用户确认全称',
+                },
+            };
+        },
+    },
+];

package/dist/shortcuts/contract/operations/flow.js

@@ -0,0 +1,98 @@
+import { contractValidationError } from '../errors.js';
+import { flowPageUrl } from './page.js';
+import { requireNonEmptyString } from './shared.js';
+import { assertContractDocument, uploadFile } from './upload.js';
+/**
+ * 四个合同流程的固定 workflowId / fieldId。
+ * 这些是业务常量（不是环境 ID），但流程页面里的其他 ID 仍需运行时解析。
+ */
+export const FLOW_PRESETS = [
+    { key: '契约锁', label: '契约锁合同审批流程', workflowId: '100003460000002066', fieldId: '100003720000025579' },
+    { key: '新客户', label: '新客户购买合同审批流程', workflowId: '1269716062340284522', fieldId: '1269716066559755048' },
+    { key: '老客户增值', label: '老客户增值合同审批流程', workflowId: '1283761429944369334', fieldId: '100003720000039590' },
+    { key: '常规二次销售', label: '常规二次销售合同审批流程', workflowId: '1283761687634100307', fieldId: '100003720000029309' },
+];
+export function resolveFlow(value) {
+    const raw = requireNonEmptyString(value, 'flow', 64).trim();
+    const exact = FLOW_PRESETS.find((preset) => preset.key === raw || preset.label === raw);
+    if (exact)
+        return exact;
+    const fuzzy = FLOW_PRESETS.filter((preset) => raw.includes(preset.key) || preset.label.includes(raw));
+    if (fuzzy.length === 1)
+        return fuzzy[0];
+    throw contractValidationError('flow_unknown', `flow 必须是以下之一：${FLOW_PRESETS.map((preset) => preset.key).join(' / ')}；未指定时必须先询问用户，不能替用户选择`);
+}
+function requestIdOf(value) {
+    const root = (value ?? {});
+    const candidate = root.requestInfo?.requestId
+        ?? root.data?.requestInfo?.requestId
+        ?? root.data?.requestId
+        ?? root.requestId;
+    if (candidate === undefined || candidate === null)
+        return undefined;
+    const text = String(candidate).trim();
+    return text ? text : undefined;
+}
+export const contractFlowOperations = [
+    {
+        name: 'contract.flow.page',
+        async execute(input, { host }) {
+            const flow = resolveFlow(input.flow);
+            const session = await host.getSession();
+            return {
+                status: 'COMPLETE',
+                data: {
+                    flow: flow.key,
+                    flowLabel: flow.label,
+                    workflowId: flow.workflowId,
+                    url: flowPageUrl(session.baseUrl, flow.workflowId),
+                    page: { width: 1000 },
+                },
+            };
+        },
+    },
+    {
+        name: 'contract.flow.launch',
+        async execute(input, { host }) {
+            const flow = resolveFlow(input.flow);
+            const path = requireNonEmptyString(input.path, 'path', 1000);
+            assertContractDocument(path);
+            const baseParam = await host.contractRequest({
+                method: 'POST',
+                path: '/api/workflow/core/flowPage/loadBaseParam',
+                query: { isCreate: 1, workflowId: flow.workflowId },
+                body: { workflowId: flow.workflowId, isCreate: 1, isMobile: 0 },
+            });
+            const requestId = requestIdOf(baseParam);
+            if (!requestId) {
+                throw contractValidationError('request_id_missing', 'loadBaseParam 未返回 requestInfo.requestId，已停止上传，避免文件挂到错误流程', { workflowId: flow.workflowId });
+            }
+            const uploaded = await uploadFile(host, {
+                path,
+                module: 'workflow',
+                extraFields: {
+                    authModule: 'workflow',
+                    source: 'form',
+                    fieldId: flow.fieldId,
+                    sourceRefId: requestId,
+                    refId: requestId,
+                    folderId: '300',
+                },
+            });
+            const session = await host.getSession();
+            return {
+                status: 'COMPLETE',
+                data: {
+                    flow: flow.key,
+                    flowLabel: flow.label,
+                    workflowId: flow.workflowId,
+                    fieldId: flow.fieldId,
+                    requestId,
+                    file: uploaded,
+                    url: flowPageUrl(session.baseUrl, flow.workflowId, uploaded.fileId),
+                    page: { width: 1000 },
+                },
+            };
+        },
+    },
+];

package/dist/shortcuts/contract/operations/page.js

@@ -0,0 +1,66 @@
+/**
+ * 页面地址构造。
+ *
+ * 源资料的硬约束：这些 sp 页面地址**不做整体编码**，`:`、`/`、`?`、`&`、`=`、`[`、`]`
+ * 与中文文件名一律保持原样；只有资信查询的 `name[N]` 参数值需要单独 encodeURIComponent。
+ * 因此这里全部用字符串拼接，不用 URL / URLSearchParams（它们会把中文和方括号编码掉）。
+ */
+export function baseOf(baseUrl) {
+    return baseUrl.replace(/\/+$/u, '');
+}
+/** 合同智能审查页：spfiles[N][fileid|name|docId]，索引从 0 开始，三个参数缺一不可。 */
+export function reviewPageUrl(baseUrl, files) {
+    const segments = [];
+    files.forEach((file, index) => {
+        segments.push(`spfiles[${index}][fileid]=${file.fileId}`);
+        segments.push(`spfiles[${index}][name]=${file.name}`);
+        if (file.docId)
+            segments.push(`spfiles[${index}][docId]=${file.docId}`);
+    });
+    return `${baseOf(baseUrl)}/sp/contract/business/ai-contract?${segments.join('&')}`;
+}
+export const COMPARE_OPTION_DEFAULTS = {
+    'options[ignoreImages]': '0',
+    'options[ignoreSpace]': '1',
+    'options[ignorePageHeader]': '0',
+    'options[ignorePunctuation]': '1',
+    'options[conversionAngle]': '0',
+    'options[conversionStyle]': '0',
+    'options[conversionSpecialSymbols]': '0',
+    'options[ignoreMark]': '1',
+    'options[ignoreWatermark]': '1',
+    'options[ignoreSeal]': '1',
+};
+/** 文档比对页：baseFileId/baseFileName + compareFileId/compareFileName + 固定 options。 */
+export function comparePageUrl(baseUrl, base, compare, options = COMPARE_OPTION_DEFAULTS) {
+    const segments = [
+        `baseFileId=${base.fileId}`,
+        `baseFileName=${base.fileName}`,
+        `compareFileId=${compare.fileId}`,
+        `compareFileName=${compare.fileName}`,
+        ...Object.entries(options).map(([key, value]) => `${key}=${value}`),
+    ];
+    return `${baseOf(baseUrl)}/sp/contract/business/doc-compare?${segments.join('&')}`;
+}
+/** 企业资信页：name[N] 索引从 0 始，只对参数值做一次 encodeURIComponent。 */
+export function creditPageUrl(baseUrl, names) {
+    const segments = names.map((name, index) => `name[${index}]=${encodeURIComponent(name)}`);
+    return `${baseOf(baseUrl)}/sp/contract/business/credit?${segments.join('&')}`;
+}
+/** 流程发起页；带 fileId 时追加 automaticFormFilling=true 触发自动回填。 */
+export function flowPageUrl(baseUrl, workflowId, fileId) {
+    const base = `${baseOf(baseUrl)}/sp/workflow/flowpage/create/${workflowId}?workflowId=${workflowId}&isCreate=1`;
+    return fileId ? `${base}&fileId=${fileId}&automaticFormFilling=true` : base;
+}
+/** 范文推荐结果页。 */
+export function recommendPageUrl(baseUrl, cacheKey) {
+    return `${baseOf(baseUrl)}/sp/contract/business/template-list?recommendKey=${cacheKey}`;
+}
+/** 条款库页（源资料要求每次条款库操作后都打开，tab=1 固定）。 */
+export function clauseLibraryPageUrl(baseUrl) {
+    return `${baseOf(baseUrl)}/sp/contract/terms-library?tab=1`;
+}
+/** 智能助手设置页。 */
+export function aiSettingPageUrl(baseUrl) {
+    return `${baseOf(baseUrl)}/sp/contract/business/ai-setting`;
+}