weaver-work-cli 0.1.28 → 0.1.31

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

@@ -0,0 +1,557 @@
+/**
+ * ⑧ 报价单生成合同：xlsx 解析 + docx 模板填充（零依赖 OOXML）。
+ *
+ * 语义与源脚本 quote_to_contract.py 对齐：
+ * - 硬门禁：没有真实 .docx 模板禁止生成合同，禁止把报价单直接渲染成合同。
+ * - sheet 由用户选择，禁止自动选（sheets 只列名）。
+ * - 分层打分：精确(100) > 去括号精确(98) > 别名是标签子串(70-95) > 标签是别名子串(60) > 字符重合(40)；
+ *   “大写/小写”硬约束避免“甲方”被“甲方联系人”反超。
+ * - 纵向合并：文本列可继承、数值列只归首行（防止 20 万被重复计成 200 万）。
+ * - 一致性校验：分节明细求和 vs 表内合计、明细总计 vs 标准价合计、折扣提示。
+ */
+import { basename, resolve } from 'node:path';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { contractValidationError } from '../errors.js';
+import { requireNonEmptyString } from './shared.js';
+import { listSheetNames, readGrid } from '../ooxml/xlsx.js';
+import { fillDocx, labelBefore } from '../ooxml/docx.js';
+// ---------------------------------------------------------------- 人民币大写
+const DIGITS = '零壹贰叁肆伍陆柒捌玖';
+const UNITS = ['', '拾', '佰', '仟'];
+const GROUPS = ['', '万', '亿', '万亿'];
+export function rmbUpper(num) {
+    const s = String(num ?? '').replace(/,/gu, '').trim();
+    if (!s || !/^-?\d+(\.\d+)?$/.test(s))
+        return '';
+    const neg = s.startsWith('-');
+    const v = parseFloat(s);
+    const cents = Math.round(Math.abs(v) * 100);
+    const yuan = Math.floor(cents / 100);
+    const jiaoFen = cents % 100;
+    const jiao = Math.floor(jiaoFen / 10);
+    const fen = jiaoFen % 10;
+    const chunk4 = (g) => {
+        let out = '';
+        let zero = false;
+        for (let pos = 3; pos >= 0; pos--) {
+            const d = Math.floor(g / 10 ** pos) % 10;
+            if (d === 0) {
+                zero = true;
+            }
+            else {
+                if (zero && out)
+                    out += '零';
+                zero = false;
+                out += DIGITS[d] + UNITS[pos];
+            }
+        }
+        return out;
+    };
+    const intPart = (n) => {
+        if (n === 0)
+            return '零';
+        const groups = [];
+        let x = n;
+        while (x > 0) {
+            groups.push(x % 10000);
+            x = Math.floor(x / 10000);
+        }
+        let res = '';
+        for (let i = groups.length - 1; i >= 0; i--) {
+            const g = groups[i];
+            if (g === 0) {
+                if (res && i > 0 && groups.slice(0, i).some((v) => v !== 0) && !res.endsWith('零'))
+                    res += '零';
+                continue;
+            }
+            if (res && g < 1000 && !res.endsWith('零'))
+                res += '零';
+            res += chunk4(g) + GROUPS[i];
+        }
+        return res.replace(/^零+|零+$/gu, '') || '零';
+    };
+    let res = intPart(yuan) + '元';
+    if (jiao === 0 && fen === 0) {
+        res += '整';
+    }
+    else {
+        if (jiao)
+            res += DIGITS[jiao] + '角';
+        else if (fen)
+            res += '零';
+        if (fen)
+            res += DIGITS[fen] + '分';
+    }
+    return (neg ? '负' : '') + res;
+}
+// ---------------------------------------------------------------- xlsx 报价单解析
+const HEADER_ALIASES = {
+    no: ['编号', '序号'],
+    name: ['功能模块', '涉及功能模块', '授权许可项', '实施服务项', '报价内容', '名称'],
+    way: ['产品实现方式'],
+    desc: ['功能描述', '详细描述', '描述', '说明'],
+    price: ['单价'],
+    qty: ['数量'],
+    amount: ['金额'],
+    remark: ['备注'],
+};
+const SECTION_RE = /^([一二三四五六七八九十]+)\s*、\s*(.+)$/u;
+function isNum(s) {
+    const t = s.replace(/,/gu, '');
+    return t !== '' && /^-?\d+(\.\d+)?$/u.test(t);
+}
+function toNum(s) {
+    const t = s.replace(/,/gu, '');
+    if (!t || !/^-?\d+(\.\d+)?$/u.test(t))
+        return null;
+    const f = parseFloat(t);
+    return Number.isInteger(f) ? f : f;
+}
+function fmtNum(v) {
+    if (v === null || v === undefined || v === '')
+        return '';
+    const s = String(v).replace(/[,￥¥]/gu, '').trim();
+    const f = Number(s);
+    if (!Number.isFinite(f))
+        return String(v);
+    return f === Math.trunc(f) ? f.toLocaleString('en-US') : f.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+}
+export function parseQuote(buffer, sheetName, keepRemark = false, includeZero = false) {
+    const names = listSheetNames(buffer);
+    if (names.length === 0)
+        throw contractValidationError('xlsx_invalid', 'xlsx 中没有工作表。');
+    const sheet = sheetName ?? names[0];
+    const sheetIndex = names.indexOf(sheet);
+    if (sheetIndex < 0) {
+        throw contractValidationError('sheet_not_found', `sheet 不存在：${sheet}；可选：${names.join('、')}`);
+    }
+    const grid = readGrid(buffer, sheetIndex);
+    const rowvals = (r, numeric = false) => {
+        const out = [];
+        for (let c = 1; c <= grid.maxCol; c++) {
+            const direct = grid.values.get(r)?.get(c);
+            let v = direct?.text ?? '';
+            if (v === '' && !numeric)
+                v = grid.textMerged.get(`${r}:${c}`)?.text ?? '';
+            out.push(v.replace(/\u00a0/gu, ' ').trim());
+        }
+        return out;
+    };
+    const numrow = (r) => {
+        const out = [];
+        for (let c = 1; c <= grid.maxCol; c++) {
+            const direct = grid.values.get(r)?.get(c);
+            let v = direct?.text ?? '';
+            // 数值列：纵向合并值只归首行——非首行一律视为空
+            if (grid.numMerged.has(`${r}:${c}`) && grid.textMerged.get(`${r}:${c}`) !== undefined) {
+                // 首行本身：numMerged 与 textMerged 都指向自身，直接用原值
+            }
+            else if (grid.textMerged.get(`${r}:${c}`) !== undefined) {
+                v = '';
+            }
+            out.push(v.replace(/\u00a0/gu, ' ').trim());
+        }
+        return out;
+    };
+    const rows = [];
+    const nrows = [];
+    for (let r = 1; r <= grid.maxRow; r++) {
+        rows.push(rowvals(r));
+        nrows.push(numrow(r));
+    }
+    const firstIdx = (row, keys) => {
+        for (let i = 0; i < row.length; i++)
+            if (keys.includes(row[i]))
+                return i;
+        return null;
+    };
+    // ---- 元信息
+    const meta = { customer: '', quote_date: '', sales: '', phone: '' };
+    for (const row of rows) {
+        const joined = row.join('');
+        for (const [label, key] of [['客户名称', 'customer'], ['报价日期', 'quote_date'], ['客户经理', 'sales'], ['联系电话', 'phone']]) {
+            if (!joined.includes(label) || meta[key])
+                continue;
+            const i = firstIdx(row, [label + '：', label + ':', label]);
+            if (i === null)
+                continue;
+            for (let j = i + 1; j < row.length; j++) {
+                const v = row[j];
+                if (v && v.replace(/[：:]$/u, '') !== label && !['报价日期', '客户经理', '联系电话'].some((x) => v.startsWith(x))) {
+                    meta[key] = v.replace(/[：:]$/u, '');
+                    break;
+                }
+            }
+        }
+    }
+    // ---- 项目总价区
+    const totals = {};
+    for (const row of rows) {
+        for (const [label, key] of [['标准价合计', 'standard_total'], ['最终优惠报价', 'final_total']]) {
+            if (totals[key] !== undefined)
+                continue;
+            const i = firstIdx(row, [label + '：', label + ':', label]);
+            if (i === null)
+                continue;
+            for (let j = i + 1; j < row.length; j++) {
+                if (isNum(row[j])) {
+                    totals[key] = toNum(row[j]);
+                    totals[key + '_upper'] = rmbUpper(totals[key]);
+                    break;
+                }
+            }
+        }
+    }
+    // ---- 分节明细
+    const sections = [];
+    let cur = null;
+    let headerIdx = null;
+    for (let ri = 0; ri < rows.length; ri++) {
+        const row = rows[ri];
+        const nrow = nrows[ri];
+        let m = null;
+        for (const v of row) {
+            m = SECTION_RE.exec(v);
+            if (m)
+                break;
+        }
+        if (m) {
+            const title = m[2].replace(/（单价[:：].*?）|\(单价[:：].*?\)/gu, '').trim();
+            cur = { code: m[1], title, items: [], total: null };
+            sections.push(cur);
+            headerIdx = null;
+            continue;
+        }
+        if (!cur)
+            continue;
+        if (row.some((v) => v.startsWith('合计'))) {
+            for (const v of row) {
+                if (isNum(v)) {
+                    cur.total = toNum(v);
+                    break;
+                }
+            }
+            headerIdx = null;
+            continue;
+        }
+        if (!headerIdx) {
+            const ino = firstIdx(row, HEADER_ALIASES.no);
+            const iamt = firstIdx(row, HEADER_ALIASES.amount);
+            if (ino !== null && iamt !== null) {
+                headerIdx = Object.fromEntries(Object.entries(HEADER_ALIASES).map(([k, v]) => [k, firstIdx(row, v)]));
+            }
+            continue;
+        }
+        const g = (k) => {
+            const i = headerIdx[k];
+            return i !== null && i !== undefined && i < row.length ? row[i] : '';
+        };
+        const gn = (k) => {
+            const i = headerIdx[k];
+            return i !== null && i !== undefined && i < nrow.length ? nrow[i] : '';
+        };
+        const no = g('no');
+        const name = g('name');
+        const price = toNum(gn('price'));
+        const qty = toNum(gn('qty'));
+        let amount = toNum(gn('amount'));
+        if (!name && (amount === null || amount === undefined))
+            continue;
+        if ((amount === null || amount === undefined) && price !== null) {
+            amount = price * (qty !== null && qty !== undefined ? qty : 1);
+        }
+        if (!includeZero && (qty === 0 || amount === 0))
+            continue;
+        let desc = g('desc').replace(/\s+/gu, ' ').trim();
+        if (desc.length > 120)
+            desc = desc.slice(0, 120) + '…';
+        const item = { no, name, way: g('way'), desc, price, qty, amount };
+        if (keepRemark)
+            item.remark = g('remark').replace(/\s+/gu, ' ').slice(0, 200);
+        cur.items.push(item);
+    }
+    // ---- 一致性校验
+    const checks = [];
+    for (const s of sections) {
+        s.sum_items = s.items.reduce((acc, i) => acc + (Number(i.amount) || 0), 0);
+        if (s.total !== null && s.sum_items !== s.total) {
+            checks.push({ section: `${s.code}、${s.title}`, sheet_total: s.total, sum_items: s.sum_items, diff: s.sum_items - s.total });
+        }
+    }
+    const grand = sections.reduce((acc, s) => acc + (s.sum_items ?? 0), 0);
+    totals.sum_items_grand = grand;
+    const standard = totals.standard_total;
+    totals.has_mismatch = checks.length > 0 || (standard !== undefined && grand !== standard);
+    totals.diff_vs_standard = standard === undefined ? null : grand - standard;
+    const warnings = [];
+    if (checks.length) {
+        warnings.push('分节明细求和与表内『合计』不一致，请与报价人核对：' +
+            checks.map((c) => `${c.section} 表内${c.sheet_total}/明细${c.sum_items}`).join('；'));
+    }
+    if (totals.diff_vs_standard) {
+        warnings.push(`全部明细求和 ${grand} 与『标准价合计』${standard} 不一致，差额 ${totals.diff_vs_standard}`);
+    }
+    const final = totals.final_total;
+    if (final !== undefined && standard !== undefined && final !== standard) {
+        warnings.push(`存在折扣：标准价 ${standard} → 最终优惠报价 ${final}，合同金额应以最终优惠报价为准`);
+    }
+    if (!meta.customer)
+        warnings.push('报价单未填写『客户名称』，签约主体必须由用户提供');
+    return { source_sheet: sheet, available_sheets: names, meta, totals, sections, checks, warnings };
+}
+// ---------------------------------------------------------------- docx 填充（字段打分）
+const FIELD_ALIASES = {
+    party_a: ['甲方', '买方', '客户名称', '客户', '采购方', '需方', '购货方', '甲方名称', '买方名称'],
+    party_a_addr: ['甲方地址', '买方地址', '客户地址', '甲方住所', '注册地址'],
+    party_a_contact: ['甲方联系人', '买方联系人', '客户联系人', '项目联系人'],
+    party_a_phone: ['甲方电话', '买方电话', '联系电话', '客户电话', '甲方联系方式'],
+    party_b: ['乙方', '卖方', '供方', '销售方', '乙方名称', '卖方名称'],
+    party_b_addr: ['乙方地址', '卖方地址', '乙方住所'],
+    party_b_contact: ['乙方联系人', '卖方联系人', '客户经理', '销售经理'],
+    party_b_phone: ['乙方电话', '卖方电话'],
+    sign_date: ['签订日期', '签署日期', '签订时间', '合同日期', '日期'],
+    quote_date: ['报价日期', '报价时间'],
+    amount: ['合同总金额', '合同金额', '总金额', '合同总价', '项目总价', '金额合计', '合同总价款', '总价'],
+    amount_upper: ['大写金额', '金额大写', '人民币大写', '大写'],
+    software_fee: ['软件功能模块费用', '软件功能费用', '软件费用', '模块费用'],
+    license_fee: ['使用授权许可费用', '授权许可费用', '许可费用', '授权费用'],
+    license_qty: ['许可数量', '用户数', '授权用户数', '注册用户数'],
+    implement_fee: ['项目实施服务费用', '实施服务费用', '实施费用'],
+    ai_fee: ['合同AI扩展能力费用', 'AI扩展能力费用', 'AI能力费用', '智能助手费用'],
+    thirdparty_fee: ['第三方费用', '第三方产品费用'],
+    project_name: ['项目名称', '项目名称及内容', '合同名称'],
+    delivery: ['交付期限', '交付时间', '实施周期', '项目周期', '履行期限'],
+    payment: ['付款方式', '支付方式', '结算方式', '付款条件'],
+    sales: ['客户经理', '报价人', '销售代表'],
+};
+const NUMERIC_KEYS = new Set(['amount', 'software_fee', 'license_fee', 'license_qty', 'implement_fee', 'ai_fee', 'thirdparty_fee']);
+function cleanLabel(label) {
+    let lab = label.replace(/\u00a0/gu, ' ').trim();
+    for (const ch of ['：', ':', '（买方）', '(买方)', '（卖方）', '(卖方)'])
+        lab = lab.split(ch).join('');
+    return lab.replace(/[（(]/gu, '').replace(/[）)]/gu, '').trim();
+}
+export function scoreLabel(label, key) {
+    const lab = cleanLabel(label);
+    if (!lab)
+        return 0;
+    if (lab in FIELD_ALIASES)
+        return lab === key ? 100 : 0;
+    if (lab.includes('大写') && key !== 'amount_upper')
+        return 0;
+    if (lab.includes('小写') && key === 'amount_upper')
+        return 0;
+    const aliases = FIELD_ALIASES[key] ?? [];
+    if (aliases.includes(lab))
+        return 100;
+    for (const a of aliases) {
+        if (lab === a.replace(/[（(]/gu, '').replace(/[）)]/gu, ''))
+            return 98;
+    }
+    let best = 0;
+    for (const a of aliases) {
+        if (a.length >= 2 && lab.includes(a)) {
+            best = Math.max(best, Math.min(95, 70 + Math.floor((30 * a.length) / Math.max(lab.length, 1))));
+        }
+    }
+    for (const a of aliases) {
+        if (lab.length >= 3 && a.includes(lab))
+            best = Math.max(best, 60);
+    }
+    if (best)
+        return best;
+    for (const a of aliases) {
+        const common = [...new Set(a)].filter((ch) => lab.includes(ch)).length;
+        if (common >= 2)
+            best = Math.max(best, 40);
+    }
+    return best;
+}
+export function makeFiller(data) {
+    const valOf = (k) => {
+        const v = data[k];
+        if (v === null || v === undefined || v === '')
+            return '';
+        return NUMERIC_KEYS.has(k) ? fmtNum(v) : String(v);
+    };
+    return {
+        bestKey(label, floor) {
+            let bk = null;
+            let bs = 0;
+            for (const k of Object.keys(FIELD_ALIASES)) {
+                const s = scoreLabel(label, k);
+                if (s > bs) {
+                    bk = k;
+                    bs = s;
+                }
+            }
+            return bs >= floor ? { key: bk, score: bs } : { key: null, score: bs };
+        },
+        valOf,
+    };
+}
+// ---------------------------------------------------------------- 操作定义
+function assertContractDocument(path) {
+    const absolute = resolve(path);
+    if (!/\.(docx)$/iu.test(absolute)) {
+        throw contractValidationError('bad_document', '只支持 .docx 模板；.doc 老格式请先另存为 .docx。');
+    }
+    return absolute;
+}
+export const contractQuoteOperations = [
+    {
+        name: 'contract.quote.rmb',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: { num: { type: 'string' } },
+            required: ['num'],
+        },
+        async execute(input) {
+            const text = rmbUpper(requireNonEmptyString(input.num, 'num'));
+            if (!text)
+                throw contractValidationError('bad_number', '数值应为纯数字（可含千分位逗号）。');
+            return { status: 'DONE', data: { num: input.num, rmb_upper: text } };
+        },
+    },
+    {
+        name: 'contract.quote.sheets',
+        risk: 'read-with-upload',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: { path: { type: 'string' } },
+            required: ['path'],
+        },
+        async execute(input) {
+            const path = resolve(String(input.path));
+            const sheets = listSheetNames(readFileSync(path));
+            if (!sheets.length)
+                throw contractValidationError('xlsx_invalid', 'xlsx 中没有工作表。');
+            return {
+                status: 'DONE',
+                data: { sheets, note: '把候选 sheet 列给用户选择；不要自动选第一个以外的 sheet。' },
+            };
+        },
+    },
+    {
+        name: 'contract.quote.parse',
+        risk: 'read-with-upload',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                path: { type: 'string' },
+                sheet: { type: 'string' },
+                keepRemark: { type: 'boolean' },
+                includeZero: { type: 'boolean', description: '保留数量为0/金额0的未选购项' },
+            },
+            required: ['path'],
+        },
+        async execute(input) {
+            const path = resolve(String(input.path));
+            const parsed = parseQuote(readFileSync(path), input.sheet ? String(input.sheet) : null, Boolean(input.keepRemark), Boolean(input.includeZero));
+            return { status: 'DONE', data: parsed };
+        },
+    },
+    {
+        name: 'contract.quote.fill',
+        risk: 'read-with-upload',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                template: { type: 'string', description: '真实合同模板 .docx 路径（必须）' },
+                data: { type: 'string', description: '数据 JSON 文件路径；含 __sections 时追加明细表' },
+                out: { type: 'string' },
+                detail: { type: 'string', enum: ['append', 'none'] },
+                mapOut: { type: 'string', description: '映射日志输出路径（filled/unfilled）' },
+            },
+            required: ['template', 'data', 'out'],
+        },
+        async execute(input) {
+            const template = assertContractDocument(String(input.template));
+            if (!existsSync(template)) {
+                throw contractValidationError('template_missing', '合同模板缺失：必须先取到真实的 .docx 模板才能生成合同。取不到就停止并请用户提供模板文件；禁止把报价单内容直接生成成一份合同。');
+            }
+            let data;
+            try {
+                data = JSON.parse(readFileSync(resolve(String(input.data)), 'utf8'));
+            }
+            catch (error) {
+                throw contractValidationError('bad_data', `数据 JSON 无法读取或解析：${error instanceof Error ? error.message : String(error)}`);
+            }
+            const detail = input.detail === 'none' ? 'none' : 'append';
+            const filler = makeFiller(data);
+            const { buffer, result } = fillDocx(template, filler, {
+                detail,
+                sections: (data['__sections'] ?? undefined),
+                amount: (data['amount'] ?? null),
+            });
+            const out = resolve(String(input.out));
+            writeFileSync(out, buffer);
+            const response = {
+                out,
+                template: basename(template),
+                filled_count: result.filled.length,
+                filled: result.filled,
+                unfilled: result.unfilled,
+                warning: result.unfilled.length > 0
+                    ? '存在未填充占位/空白：请把 unfilled 列表给用户确认，缺的信息让用户补充后再填，不要编造。'
+                    : null,
+            };
+            if (input.mapOut) {
+                writeFileSync(resolve(String(input.mapOut)), JSON.stringify({ filled: result.filled, unfilled: result.unfilled }, null, 2), 'utf8');
+                response.map_out = resolve(String(input.mapOut));
+            }
+            return { status: 'DONE', data: response };
+        },
+    },
+];
+export function quoteContractContracts() {
+    return [
+        {
+            name: 'contract.quote.rmb',
+            summary: '数字转人民币大写（纯本地）',
+            risk: 'read',
+            inputSchema: {
+                type: 'object', additionalProperties: false,
+                properties: { num: { type: 'string' } }, required: ['num'],
+            },
+        },
+        {
+            name: 'contract.quote.sheets',
+            summary: '列出报价单 xlsx 的全部 sheet 名',
+            risk: 'read-with-upload',
+            inputSchema: {
+                type: 'object', additionalProperties: false,
+                properties: { path: { type: 'string' } }, required: ['path'],
+            },
+        },
+        {
+            name: 'contract.quote.parse',
+            summary: '解析报价单 xlsx：元信息/总价/分节明细/一致性校验',
+            risk: 'read-with-upload',
+            inputSchema: {
+                type: 'object', additionalProperties: false,
+                properties: {
+                    path: { type: 'string' }, sheet: { type: 'string' },
+                    keepRemark: { type: 'boolean' }, includeZero: { type: 'boolean' },
+                }, required: ['path'],
+            },
+        },
+        {
+            name: 'contract.quote.fill',
+            summary: '用真实 .docx 模板 + 数据 JSON 生成合同 docx',
+            risk: 'read-with-upload',
+            inputSchema: {
+                type: 'object', additionalProperties: false,
+                properties: {
+                    template: { type: 'string' }, data: { type: 'string' }, out: { type: 'string' },
+                    detail: { type: 'string', enum: ['append', 'none'] }, mapOut: { type: 'string' },
+                }, required: ['template', 'data', 'out'],
+            },
+        },
+    ];
+}
+export { labelBefore };

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

@@ -0,0 +1,78 @@
+import { contractPolicyError } from '../errors.js';
+import { recommendPageUrl } from './page.js';
+import { requireNonEmptyString } from './shared.js';
+/** 「合同范文管理」对象的固定 obj_id，不是环境占位符，禁止替换。 */
+export const RECOMMEND_TEXT_OBJ_ID = '1290191829260230657';
+function text(value) {
+    if (typeof value === 'string' && value.trim())
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return undefined;
+}
+function mapRecommendation(item) {
+    const labels = (item.extract_labels ?? {});
+    return {
+        rank: item.rank,
+        fileName: item.file_name,
+        matchScore: item.match_score,
+        matchReason: item.match_reason,
+        matchedFields: item.matched_fields,
+        templateId: text(item.template_id) ?? text(item.id),
+        docId: text(item.doc_id),
+        files: item.file_id,
+        classificationId: text(item.classification_id),
+        creator: item.creator,
+        updater: item.updater,
+        createTime: item.create_time,
+        updateTime: item.update_time,
+        labels: {
+            title: labels.title,
+            summary: labels.summary,
+            contractType: labels.contract_type,
+            riskLevel: labels.risk_level,
+            amountRange: labels.amount_range,
+            industry: labels.industry,
+            scene: labels.scene,
+            role: labels.role,
+            paymentTerms: labels.payment_terms,
+            keyClauses: labels.key_clauses,
+            jurisdiction: labels.jurisdiction,
+            tags: labels.tags,
+        },
+    };
+}
+export const contractRecommendOperations = [
+    {
+        name: 'contract.recommend.doc',
+        async execute(input, { host }) {
+            const content = requireNonEmptyString(input.content, 'content', 4000);
+            const value = await host.contractRequest({
+                method: 'POST',
+                path: '/api/ebd/contract/file/recommendContractDoc',
+                body: { content, textObjId: RECOMMEND_TEXT_OBJ_ID },
+                // 服务端 AI 语义匹配本身需要 30~40 秒，超时放到 180 秒，不要因慢而重试。
+                timeoutMs: 180_000,
+            });
+            const data = (value?.data ?? {});
+            const cacheKey = text(data.cacheKey);
+            if (!cacheKey) {
+                throw contractPolicyError('recommend_cache_key_missing', '推荐接口未返回 cacheKey，无法打开推荐结果页', {
+                    path: '/api/ebd/contract/file/recommendContractDoc',
+                });
+            }
+            const list = Array.isArray(data.recommendList) ? data.recommendList : [];
+            const session = await host.getSession();
+            return {
+                status: list.length ? 'COMPLETE' : 'EMPTY',
+                data: {
+                    cacheKey,
+                    total: list.length,
+                    recommendations: list.map(mapRecommendation),
+                    url: recommendPageUrl(session.baseUrl, cacheKey),
+                    page: { width: 1000 },
+                },
+            };
+        },
+    },
+];

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

@@ -1,7 +1,16 @@
 import { contractValidationError } from '../errors.js';
 import { contractOperations } from '../manifest.js';
+import { contractAssistantOperations } from './assistant.js';
+import { contractClauseLibraryOperations } from './clause-library.js';
 import { contractClauseReferenceOperations } from './clause-reference.js';
+import { contractCompareOperations } from './compare.js';
+import { contractCreditPageOperations } from './credit-page.js';
+import { contractFlowOperations } from './flow.js';
+import { contractPerformanceOperations } from './performance.js';
+import { contractQuoteOperations } from './quote.js';
+import { contractRecommendOperations } from './recommend.js';
 import { contractRequestOperations } from './request.js';
+import { contractReviewOperations } from './review.js';
 import { contractSubjectOperations } from './subject.js';
 import { contractTemplateOperations } from './template.js';
 import { contractWorkflowOperations } from './workflow.js';
@@ -9,10 +18,19 @@ function buildRegistry() {
     const registry = new Map();
     const handlers = [
         ...contractTemplateOperations,
+        ...contractClauseLibraryOperations,
         ...contractClauseReferenceOperations,
         ...contractSubjectOperations,
         ...contractWorkflowOperations,
         ...contractRequestOperations,
+        ...contractReviewOperations,
+        ...contractFlowOperations,
+        ...contractRecommendOperations,
+        ...contractCompareOperations,
+        ...contractCreditPageOperations,
+        ...contractAssistantOperations,
+        ...contractPerformanceOperations,
+        ...contractQuoteOperations,
     ];
     for (const handler of handlers) {
         if (registry.has(handler.name))