yindie-erp-mcp 2.0.4 → 2.0.5

package/dist/client.js

@@ -1,3 +1,6 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { basename, join } from 'node:path';
 /** ERP API 客户端 */
 export class YindieClient {
     /** 后端根地址 */
@@ -63,6 +66,45 @@ export class YindieClient {
     async postForm(path, formFactory) {
         return this.requestForm(path, formFactory);
     }
+    /** 下载文件到临时目录，返回落盘路径 */
+    async download(method, path, fileName, options = {}, retried = false) {
+        const url = new URL(path, this.baseUrl);
+        for (const [key, value] of Object.entries(options.params ?? {})) {
+            if (value !== undefined && value !== '') {
+                url.searchParams.set(key, value);
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            clientid: this.clientId
+        };
+        const init = { method, headers };
+        if (options.body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+            init.body = JSON.stringify(options.body);
+        }
+        const response = await fetch(url, init);
+        const contentType = response.headers.get('content-type') ?? '';
+        if (contentType.includes('application/json')) {
+            const result = (await response.json());
+            if (result.code === 401 && !retried) {
+                this.token = await this.relogin();
+                return this.download(method, path, fileName, options, true);
+            }
+            throw new Error(result.msg || `下载失败: ${path}`);
+        }
+        if (!response.ok) {
+            throw new Error(`下载失败: ${path}（HTTP ${response.status}）`);
+        }
+        const headerName = response.headers.get('download-filename');
+        const name = fileName ?? (headerName ? decodeURIComponent(headerName) : basename(path));
+        const bytes = Buffer.from(await response.arrayBuffer());
+        const dir = join(tmpdir(), 'yindie-erp-exports');
+        await mkdir(dir, { recursive: true });
+        const filePath = join(dir, basename(name));
+        await writeFile(filePath, bytes);
+        return { filePath, size: bytes.length };
+    }
     /** 统一 HTTP 请求 */
     async request(method, path, body, params, retried = false) {
         const url = new URL(path, this.baseUrl);

package/dist/craft/guide.js

@@ -1,9 +1,6 @@
 import { JACKET_STYLE_GROUPS, PANTS_STYLE_GROUPS } from './template.js';
 /** 拼字段示例 */
 function buildExample(item) {
-    if (item.control === 'fixed') {
-        return JSON.stringify({ input: item.fixedText || '' });
-    }
     if (item.control === 'radio') {
         const first = item.options?.[0] || '选项';
         if (item.alwaysInput || item.inputWhen?.includes(first)) {
@@ -35,7 +32,7 @@ function buildExample(item) {
         return JSON.stringify({ checkbox: item.options?.slice(0, 2) || [] });
     }
     if (item.control === 'input') {
-        return JSON.stringify({ input: '填写内容' });
+        return JSON.stringify({ input: item.defaultInput || '填写内容' });
     }
     if (item.control === 'combine' && item.multiFill) {
         const map = {};
@@ -60,9 +57,6 @@ function buildExample(item) {
 }
 /** 拼选择说明 */
 function buildHowTo(item) {
-    if (item.control === 'fixed') {
-        return `固定文案：${item.fixedText || ''}`;
-    }
     if (item.control === 'radio') {
         let text = `单选其一：${(item.options || []).join('／')}`;
         if (item.allowAdd) {
@@ -114,9 +108,11 @@ function buildHowTo(item) {
         return text;
     }
     if (item.control === 'input') {
-        return item.multiline
-            ? `文本域自由填写${item.inputSuffix ? '，后缀 ' + item.inputSuffix : ''}`
-            : `输入框填写${item.inputSuffix ? '，后缀 ' + item.inputSuffix : ''}`;
+        if (item.multiline) {
+            return `文本域自由填写${item.inputSuffix ? '，后缀 ' + item.inputSuffix : ''}`;
+        }
+        const suffix = item.inputSuffix ? `，后缀 ${item.inputSuffix}` : '';
+        return `输入框填写${suffix}${item.defaultInput ? `；默认「${item.defaultInput}」` : ''}`;
     }
     if (item.control === 'combine' && item.multiFill) {
         const parts = (item.combineOptions || []).map((o) => `${o.label}${o.needValue ? '(旁填值' + (o.suffix || '') + ')' : ''}`);
@@ -158,11 +154,7 @@ function flattenGroups(garmentPart, groups) {
                 syncSizeOptions: item.syncSizeOptions,
                 inputSuffix: item.inputSuffix,
                 multiline: item.multiline,
-                noteWhen: item.key === 'creaseHas'
-                    ? 'radio=有 → 填 note'
-                    : item.key === 'spareButton'
-                        ? 'radio=自己写 → 填 note'
-                        : undefined,
+                defaultInput: item.defaultInput,
                 fieldValueExample: buildExample(item),
                 howToSelect: buildHowTo(item)
             });
@@ -170,19 +162,44 @@ function flattenGroups(garmentPart, groups) {
     }
     return list;
 }
+/** 色卡白名单字段（与后端 ErpColorCardCatalog 一致） */
+const COLOR_CARD_FIELDS = [
+    { garmentPart: 'jacket', fieldKey: 'lining', titleCn: '里布' },
+    { garmentPart: 'jacket', fieldKey: 'handkerchiefShow', titleCn: '手巾袋露出' },
+    { garmentPart: 'jacket', fieldKey: 'fuse', titleCn: '粘衬' },
+    { garmentPart: 'jacket', fieldKey: 'sleeveButton', titleCn: '袖扣' },
+    { garmentPart: 'jacket', fieldKey: 'buttons', titleCn: '门襟大扣' },
+    { garmentPart: 'jacket', fieldKey: 'sleeveLining', titleCn: '袖里' },
+    { garmentPart: 'jacket', fieldKey: 'collarHang', titleCn: '领吊' },
+    { garmentPart: 'jacket', fieldKey: 'collarBottom', titleCn: '领底' },
+    { garmentPart: 'jacket', fieldKey: 'triangle', titleCn: '三角' },
+    { garmentPart: 'jacket', fieldKey: 'weltClimb', titleCn: '嵌线袋小攀' },
+    { garmentPart: 'jacket', fieldKey: 'innerPatch', titleCn: '里贴袋' },
+    { garmentPart: 'jacket', fieldKey: 'pocketCloth', titleCn: '上衣口袋布' },
+    { garmentPart: 'pants', fieldKey: 'crotchCloth', titleCn: '小裆布' },
+    { garmentPart: 'pants', fieldKey: 'liningHas', titleCn: '脚绸' },
+    { garmentPart: 'pants', fieldKey: 'backPocketStitch', titleCn: '后袋' },
+    { garmentPart: 'pants', fieldKey: 'backSeam', titleCn: '裤后缝' },
+    { garmentPart: 'pants', fieldKey: 'waistInnerStrip', titleCn: '腰里嵌条' },
+    { garmentPart: 'pants', fieldKey: 'waistInnerMaterial', titleCn: '腰里材质' },
+    { garmentPart: 'pants', fieldKey: 'pantsPocketCloth', titleCn: '裤子口袋布' },
+    { garmentPart: 'pants', fieldKey: 'button', titleCn: '裤子纽扣' },
+    { garmentPart: 'pants', fieldKey: 'hemTape', titleCn: '脚口织带' }
+];
 /** 工艺选择总指南 */
 export const CRAFT_SELECTION_GUIDE = {
     summary: '写工艺前先读本指南。fieldKey=指南里的 fieldKey；fieldValue=JSON 字符串，结构见各字段 fieldValueExample；craftModule=模块 key',
     controls: {
-        radio: '单选 → {"radio":"选项"}；特例 creaseHas/spareButton 可能再带 note',
+        radio: '单选 → {"radio":"选项"}；howToSelect 提示可填备注时再带 note',
         checkbox: '多选 → {"checkbox":["a","b"]}',
         'checkbox+perItemSize': '多选+尺寸 → {"checkbox":["领"],"combineMap":{"领":"0.15"}}',
         'checkbox+gateNone': '先有无再多选 → 无:{"radio":"无","checkbox":["无"]}；有:{"radio":"有","checkbox":["领"],"combineMap":{"领":"0.15"}}',
-        combine: '结合单选 → {"combineKey":"三折光","combineValue":"3"}；needValue=false 可不带 combineValue',
+        combine: '结合单选 → {"combineKey":"净脚口三折光压线","combineValue":"3"}；needValue=false 可不带 combineValue',
         'combine+multiFill': '多填 → {"combineMap":{"28L＊":"2","24L＊":"1"}}',
-        input: '输入 → {"input":"文案"}',
-        fixed: '固定文案，一般可不传'
+        input: '输入 → {"input":"文案"}；各模块末尾 xxNote 备注、人工填写项同此'
     },
+    colorCardFields: COLOR_CARD_FIELDS,
+    colorCardNote: '色卡选料写在 style_save colors[].colorCardJson（JSON 字符串，键=上面 fieldKey，值={materialCode,materialName,titleCn}；pantsPocketCloth 列仅裤子前后袋工艺有值时可填）',
     jacket: flattenGroups('jacket', JACKET_STYLE_GROUPS),
     pants: flattenGroups('pants', PANTS_STYLE_GROUPS)
 };

package/dist/craft/template.js

@@ -31,6 +31,7 @@ const MARK_ITEMS = [
             { label: '无', needValue: false },
         ],
     },
+    { key: 'markNote', label: '备注', control: 'input' },
 ];
 /** 印花组字段 */
 const PRINT_ITEMS = [
@@ -41,9 +42,10 @@ const PRINT_ITEMS = [
         options: ['有', '无'],
     },
     { key: 'printDetail', label: '印花位置及颜色', control: 'input' },
+    { key: 'printNote', label: '备注', control: 'input' },
 ];
 /** 制边部位 */
-const EDGE_PARTS = ['领', '驳', '挂面止口', '手巾袋上', '袖口', '下摆', '开叉'];
+const EDGE_PARTS = ['领', '驳', '挂面止口', '手巾袋上', '袋盖', '袖口', '下摆', '开叉'];
 /** 裤子工艺字段 */
 export const PANTS_STYLE_GROUPS = [
     {
@@ -132,10 +134,14 @@ export const PANTS_STYLE_GROUPS = [
                 control: 'combine',
                 combineOptions: [
                     {
-                        label: '三折光',
+                        label: '净脚口三折光压线',
+                        needValue: true,
+                        suffix: 'CM',
+                    },
+                    {
+                        label: '净脚口内折撬边',
                         needValue: true,
                         suffix: 'CM',
-                        textPrefix: '脚口',
                     },
                     {
                         label: '内撬',
@@ -166,6 +172,7 @@ export const PANTS_STYLE_GROUPS = [
                 alwaysInput: true,
                 inputPlaceholder: '特殊要求',
             },
+            { key: 'liningNote', label: '备注', control: 'input' },
         ],
     },
     {
@@ -192,8 +199,8 @@ export const PANTS_STYLE_GROUPS = [
                 label: '后袋',
                 control: 'combine',
                 combineOptions: [
-                    { label: '拷边', needValue: false },
-                    { label: '折光', needValue: false },
+                    { label: '拷边', needValue: true, suffix: '' },
+                    { label: '折光', needValue: true, suffix: '' },
                     { label: '包边', needValue: true, suffix: '' },
                 ],
             },
@@ -214,6 +221,7 @@ export const PANTS_STYLE_GROUPS = [
                     { label: '宽度', needValue: true, suffix: '' },
                 ],
             },
+            { key: 'topstitchNote', label: '备注', control: 'input' },
         ],
     },
     {
@@ -237,6 +245,17 @@ export const PANTS_STYLE_GROUPS = [
                 inputWhen: ['其他'],
                 inputPlaceholder: '材质',
             },
+            {
+                key: 'beadEdge',
+                label: '珠边',
+                control: 'combine',
+                textPrefix: '珠边',
+                combineOptions: [
+                    { label: '有', needValue: true, suffix: '', hideLabel: true },
+                    { label: '无', needValue: false },
+                ],
+            },
+            { key: 'waistInnerNote', label: '备注', control: 'input' },
         ],
     },
     {
@@ -265,26 +284,7 @@ export const PANTS_STYLE_GROUPS = [
                 control: 'radio',
                 options: ['卷边连腰', '卷边不连腰', '拷边'],
             },
-            {
-                key: 'clothMaterial',
-                label: '袋布材质',
-                control: 'radio',
-                options: ['80棉20涤', '65棉35涤', '100涤', '100棉', '面料', '其他'],
-                inputWhen: ['其他'],
-                inputPlaceholder: '材质',
-            },
-            {
-                key: 'clothTexture',
-                label: '袋布纹理',
-                control: 'radio',
-                options: ['斜纹', '平纹', '人字纹', '网眼', '无'],
-            },
-            {
-                key: 'clothColor',
-                label: '袋布颜色',
-                control: 'radio',
-                options: ['配色', '黑', '藏青', '本白', '漂白'],
-            },
+            { key: 'pocketFacingNote', label: '备注', control: 'input' },
         ],
     },
     {
@@ -329,8 +329,11 @@ export const PANTS_STYLE_GROUPS = [
                 key: 'bartackColor',
                 label: '配色',
                 control: 'radio',
-                options: ['套结配面料色'],
+                options: ['套结配面料色', '其他'],
+                inputWhen: ['其他'],
+                inputPlaceholder: '配色',
             },
+            { key: 'bartackNote', label: '备注', control: 'input' },
         ],
     },
     { key: 'mark', label: '标识', items: MARK_ITEMS },
@@ -341,7 +344,7 @@ export const PANTS_STYLE_GROUPS = [
         items: [
             {
                 key: 'button',
-                label: '纽扣',
+                label: '裤子纽扣',
                 control: 'combine',
                 multiFill: true,
                 combineOptions: [
@@ -400,6 +403,7 @@ export const PANTS_STYLE_GROUPS = [
                     { label: '无', needValue: false },
                 ],
             },
+            { key: 'accessoryNote', label: '备注', control: 'input' },
         ],
     },
     {
@@ -413,6 +417,7 @@ export const PANTS_STYLE_GROUPS = [
                 textPrefix: '挺缝线',
                 options: ['有', '无'],
             },
+            { key: 'creaseNote', label: '备注', control: 'input' },
         ],
     },
     {
@@ -466,6 +471,7 @@ export const PANTS_STYLE_GROUPS = [
                 control: 'radio',
                 options: ['挂装', '平箱有裤架', '平箱无裤架'],
             },
+            { key: 'packNote', label: '备注', control: 'input' },
         ],
     },
 ];
@@ -526,9 +532,9 @@ export const JACKET_STYLE_GROUPS = [
                 options: [
                     '贴袋',
                     '平袋有袋盖',
-                    '平袋双嵌线袋',
+                    '平袋双嵌线袋有袋盖',
                     '斜袋有袋盖',
-                    '斜袋双嵌线袋',
+                    '斜袋双嵌线袋有袋盖',
                 ],
             },
             {
@@ -604,6 +610,7 @@ export const JACKET_STYLE_GROUPS = [
                 inputWhen: ['备注'],
                 inputPlaceholder: '备注',
             },
+            { key: 'fuseNote', label: '备注', control: 'input' },
         ],
     },
     {
@@ -660,6 +667,7 @@ export const JACKET_STYLE_GROUPS = [
                     { label: '无', needValue: false },
                 ],
             },
+            { key: 'edgeNote', label: '备注', control: 'input' },
         ],
     },
     {
@@ -676,9 +684,9 @@ export const JACKET_STYLE_GROUPS = [
             },
             {
                 key: 'sleeveButton',
-                label: '纽扣',
+                label: '袖扣',
                 control: 'combine',
-                textPrefix: '纽扣',
+                textPrefix: '袖扣',
                 combineOptions: [
                     { label: '叠扣', needValue: true, suffix: '' },
                     { label: '平扣', needValue: true, suffix: '' },
@@ -686,12 +694,12 @@ export const JACKET_STYLE_GROUPS = [
             },
             {
                 key: 'sleeveButtonCount',
-                label: '每个袖口纽扣数',
+                label: '每个袖口袖扣数',
                 control: 'input',
             },
             {
                 key: 'buttons',
-                label: '扣子',
+                label: '门襟大扣',
                 control: 'combine',
                 multiFill: true,
                 combineOptions: [
@@ -710,9 +718,9 @@ export const JACKET_STYLE_GROUPS = [
             {
                 key: 'spare',
                 label: '备扣',
-                control: 'fixed',
+                control: 'input',
                 textPrefix: '备扣',
-                fixedText: '一大一小',
+                defaultInput: '一大一小',
             },
             {
                 key: 'thread',
@@ -726,12 +734,14 @@ export const JACKET_STYLE_GROUPS = [
             {
                 key: 'sleeveLining',
                 label: '袖里',
-                control: 'radio',
+                control: 'combine',
                 textPrefix: '袖里',
-                options: ['普通白底黑条', 'PLN白底细黑条', '配面料色', '其他'],
-                inputWhen: ['其他'],
-                inputPlaceholder: '袖里',
+                combineOptions: [
+                    { label: '有', needValue: true, suffix: '', hideLabel: true },
+                    { label: '无', needValue: false },
+                ],
             },
+            { key: 'sleeveNote', label: '备注', control: 'input' },
         ],
     },
     {
@@ -747,6 +757,7 @@ export const JACKET_STYLE_GROUPS = [
                     { label: '里布', needValue: true, suffix: '' },
                     { label: '丝带', needValue: true, suffix: '' },
                     { label: '领标', needValue: true, suffix: '' },
+                    { label: '其他', needValue: true, suffix: '' },
                 ],
             },
             {
@@ -759,6 +770,7 @@ export const JACKET_STYLE_GROUPS = [
                     { label: '特殊材料', needValue: true, suffix: '' },
                 ],
             },
+            { key: 'collarNote', label: '备注', control: 'input' },
         ],
     },
     {
@@ -804,13 +816,14 @@ export const JACKET_STYLE_GROUPS = [
             },
             {
                 key: 'pocketCloth',
-                label: '口袋布',
+                label: '上衣口袋布',
                 control: 'combine',
                 combineOptions: [
                     { label: '有', needValue: true, suffix: '', hideLabel: true },
                     { label: '无', needValue: false },
                 ],
             },
+            { key: 'innerNote', label: '备注', control: 'input' },
         ],
     },
     {
@@ -823,9 +836,9 @@ export const JACKET_STYLE_GROUPS = [
                 control: 'combine',
                 textPrefix: '大袋',
                 combineOptions: [
-                    { label: '直套结', needValue: false },
-                    { label: 'D套结', needValue: false },
-                    { label: '横套结0.6CM', needValue: false },
+                    { label: '直套结', needValue: true, suffix: '' },
+                    { label: 'D套结', needValue: true, suffix: '' },
+                    { label: '横套结0.6CM', needValue: true, suffix: '' },
                     { label: '无', needValue: false },
                 ],
             },
@@ -835,11 +848,12 @@ export const JACKET_STYLE_GROUPS = [
                 control: 'combine',
                 textPrefix: '里袋',
                 combineOptions: [
-                    { label: '直套结', needValue: false },
-                    { label: 'D套结', needValue: false },
+                    { label: '直套结', needValue: true, suffix: '' },
+                    { label: 'D套结', needValue: true, suffix: '' },
                     { label: '无', needValue: false },
                 ],
             },
+            { key: 'bartackNote', label: '备注', control: 'input' },
         ],
     },
     { key: 'mark', label: '标识', items: MARK_ITEMS },
@@ -847,7 +861,10 @@ export const JACKET_STYLE_GROUPS = [
     {
         key: 'handmade',
         label: '特殊手工',
-        items: [{ key: 'handmade', label: '特殊手工', control: 'input' }],
+        items: [
+            { key: 'handmade', label: '特殊手工', control: 'input' },
+            { key: 'handmadeNote', label: '备注', control: 'input' },
+        ],
     },
     {
         key: 'pack',
@@ -899,6 +916,7 @@ export const JACKET_STYLE_GROUPS = [
                 control: 'radio',
                 options: ['挂装', '平箱有衣架', '平箱无衣架', '立体箱'],
             },
+            { key: 'packNote', label: '备注', control: 'input' },
         ],
     },
 ];

package/dist/tool-meta.js

@@ -63,7 +63,7 @@ export const ENTITY_META = {
         addOptional: 'country, defaultCurrency, communicationChannel, email, phone, taxNo, shortCode, assigneeId, status, remark',
         editRequired: 'id, customerName, customerType',
         enums: 'customerType:direct/trader/foreign_trade; status:active/inactive(默认active)；customerCode 后端自动生成勿传；taxNo/shortCode 选手填',
-        removeConstraint: '客户存在关联PI时不可删除',
+        removeConstraint: '客户下 PI 关联的订单仍存在时不可删除；关联订单已删除的 PI 会随客户一起清理',
         next: 'erp_customer_contact_add → erp_customer_address_add → erp_pi_add'
     },
     erp_customer_contact: {
@@ -81,7 +81,7 @@ export const ENTITY_META = {
         label: '客户地址',
         prerequisite: '客户已创建',
         addRequired: 'customerId, addressType, detailAddress',
-        addOptional: 'recipient, company, country, province, city, postalCode, phone, isDefault(Y/N), remark',
+        addOptional: 'recipient, company, country, province, city, postalCode, phone, isDefault(Y/N), effectiveDate, remark',
         editRequired: 'id, customerId, addressType, detailAddress',
         enums: 'addressType:shipping/billing/sample'
     },
@@ -101,9 +101,9 @@ export const ENTITY_META = {
         label: 'PI',
         prerequisite: '客户已创建',
         addRequired: 'customerId, sourceType, piNo',
-        addOptional: 'orderId, piVersion, paymentTerms, totalAmount, currency, qtyTolerance, shippingMethod, shippingAddress, piFileOssId, status, confirmedDate, remark',
+        addOptional: 'orderId, piVersion, paymentTerms, totalAmount, currency, qtyTolerance, shippingMethod, packingType, shipmentPeriod, shippingAddress, piFileOssId, status, confirmedDate, remark, items',
         editRequired: 'id, customerId, sourceType, piNo',
-        enums: 'sourceType:customer/internal; status:draft/confirmed/superseded(默认draft)；piNo 手填可改，同号同版本重复报PI编号已存在；传 orderId 则关联订单（客户须一致）',
+        enums: 'sourceType:customer/internal; status:draft/confirmed/superseded(默认draft)；piNo 手填可改，同号同版本重复报PI编号已存在；传 orderId 则关联订单（客户须一致）；items 为明细行 [{rowKey, code, style, fabric, col, composition, subtotalQty, fobNingbo, subtotalAmount}]，包装方式 packingType 保存时同步订单',
         next: 'erp_order_add → erp_order_link_pi（若 add 已带 orderId 可跳过 link）'
     },
     erp_order: {
@@ -115,6 +115,7 @@ export const ENTITY_META = {
         addOptional: 'brandId, orderStatus(默认inquiry), orderDate, deliveryDate, contractDate, depositReceived(Y/N), qtyTolerance, shippingMethod, packingType, priority, sourceChannel, parentOrderId, remark',
         editRequired: 'id, orderNo, customerId, bizLine, assigneeId',
         enums: 'bizLine:direct/trader; orderStatus见erp_business_flow资源；orderNo 手填全库唯一可改；重复报订单号已存在',
+        removeConstraint: '删除会级联清该单 PI、款式树（含工艺/商标位置/色卡）和生产单，订单号改为 _原ID 释放号码',
         next: 'erp_order_link_pi → erp_order_style_save → erp_order_change_status'
     },
     erp_task: {
@@ -133,8 +134,8 @@ export const ENTITY_META = {
         addRequired: 'categoryId, materialCode, materialName',
         addOptional: 'spec, color, unit, defaultSupplierId, composition, width, weight, imageOssId, status, remark',
         editRequired: 'id, categoryId, materialName',
-        enums: 'materialCode 新增手填必传、唯一，修改不可改；分类 fabric：materialCode=面料号且 color(色号)必填；分类 lining：composition(成分)必填',
-        removeConstraint: '已被订单引用（款式面料色号行/colorCardJson 色卡料/工艺 materialCode）、生产单引用或有比价快照时不可删，可改为停用',
+        enums: 'materialCode 新增手填必传、唯一，修改不可改；分类 fabric：materialCode=面料号且 color(色号)必填；分类 lining：composition(成分)必填；编码命中已删除记录时 add 直接恢复并更新原记录，不报重复',
+        removeConstraint: '已被订单引用（款式面料色号行/colorCardJson 色卡料/工艺 materialCode）、生产单引用或有比价快照时不可删，可改为停用；删前用 material.bound_orders 查引用',
         next: '面料 → style_save colors[].fabricMaterialId（colorCode 取物料 color）；色卡料 → colors[].colorCardJson'
     },
     erp_material_category: {
@@ -198,10 +199,10 @@ export const ENTITY_META = {
         label: '生产单',
         prerequisite: '订单已存在',
         addRequired: 'orderId, bizLine',
-        addOptional: 'poVersion, poStatus(默认draft), deliveryDate, qtyTolerance, shippingMethod, shippingAddress, packingType, bulkSampleRequired(Y/N), remark',
+        addOptional: 'poVersion, poStatus(默认draft), deliveryDate, qtyTolerance, shippingMethod, shippingAddress, packingType, bulkSampleRequired(Y/N), bulkSampleDeadline, remark',
         editRequired: 'id, orderId, bizLine',
         enums: 'poStatus:draft/reviewing/issued/superseded；poNo 后端自动生成勿传',
-        removeConstraint: '已下发(issued)不可删除；仅draft可修改',
+        removeConstraint: '已下发(issued)且订单仍存在时不可删除；订单删除会连带清生产单；仅 draft 可修改',
         next: 'erp_production craft_save（可选）→ check → submit_review → issue；辅料工艺只读展示款式配置已选面料与色卡，一般不必 save_items'
     },
     erp_bid: {
@@ -258,7 +259,7 @@ export const WORKFLOW_META = {
         step: '录入款式明细',
         summary: '保存订单款式及颜色尺码/色卡物料，成功后回查 styles（含 id 作 styleId）；页面配置确定即调本接口',
         prerequisite: '订单已创建；payload 内 orderId 用字符串',
-        payload: '{orderId:string, styles:[{id?, styleNo?, styleName?, sampleNo?, shipSampleTip?, materialUsage?, garmentType?, fabricMaterialId?, meterage?, colors:[{fabricMaterialId, colorCode, colorName, colorCardJson?, sizes:[{sizeName, qty}]}]}]}；styleNo 可省略则默认订单号-序号；全库唯一；colors[].colorName 必填',
+        payload: '{orderId:string, styles:[{id?, styleNo?, styleName?, sampleNo?, shipSampleTip?, garmentType?, customerStyleRef?, materialUsage?, fabricMaterialId?, liningMaterialId?, styleImageOssId?, techFileOssId?, sizeChartJson?, remark?, colors:[{id?, fabricMaterialId, colorCode, colorName, customerStyleRef?, colorCardJson?, meterage?, materialUsage?, cuttableWidth?, totalQty?, remark?, sizes:[{sizeName, qty}]}]}]}；styleNo 可省略则默认订单号-序号；全库唯一；colors[].colorName 必填',
         constraint: '全量 styles 列表；已有 styles[].id 或同款号则更新主档并替换颜色尺码，工艺/商标保留，sizeChartJson/样板号/船样提示空则沿用库中值；无 id 为新增；未出现在列表中的旧款整树删除（含工艺）；款号重复报款号已存在；配置：每行 colors[] 各自 material.list/add 后面料 fabricMaterialId，colorCode 取该物料 color（色号），colorName=物料 materialName，勿手填独立色号、勿传 fabricColorNo；款式级 fabricMaterialId 取首行面料；色卡选料按行写入 colorCardJson（JSON 字符串，键=fieldKey 如 lining，值={materialCode,materialName,titleCn}）；页脚备注走 color_card_save，不在本接口',
         next: '从返回 styles[].id 取 styleId → craft_save；色卡备注 → color_card_save'
     },
@@ -268,7 +269,7 @@ export const WORKFLOW_META = {
         summary: '按 styleId 写 colorCardNote；与前端色卡弹窗一致',
         prerequisite: '款式已保存；选料已在 style_save.colorCardJson',
         payload: '{styleId:string, colorCardNote?, items?:[{garmentPart, fieldKey, colorCardCode?, materialCode?}]}',
-        constraint: '前端常规只传 colorCardNote 且 items:[]；选料不在本接口。items 写 craft 编号为遗留可选，一般勿填；PDF 导出无 MCP，走前端',
+        constraint: '前端常规只传 colorCardNote 且 items:[]；选料不在本接口。items 写 craft 编号为遗留可选，一般勿填；色卡导出用 action=color_card_export',
         next: 'erp_order action=change_status（如 color_card_confirmed）'
     },
     erp_bid_close: {
@@ -302,9 +303,9 @@ export const WORKFLOW_META = {
         step: '录入结构化工艺',
         summary: '保存款式上衣/裤子工艺及商标位置（选项对齐打样单模板，非字典）',
         prerequisite: '款式已保存且有 styleId；先读 erp_order_craft_schema 取 fieldKey',
-        payload: '{styleId, processNote?, crafts:[{garmentPart, craftModule, fieldKey, fieldValue}], labelPositions?:[...]}。键名必须是 crafts（复数）与 craftModule；每条带 garmentPart；fieldValue 为 JSON 字符串，旁框用 note 不是 input',
+        payload: '{styleId, processNote?, crafts:[{garmentPart, craftModule, fieldKey, fieldValue}], labelPositions?:[{garmentPart, labelType, positionSide?, sizeCm?, positionDesc?, materialId?, diagramOssId?, remark?, sortOrder?}]}。键名必须是 crafts（复数）与 craftModule；每条带 garmentPart；fieldValue 为 JSON 字符串，旁框用 note 不是 input',
         enums: 'garmentPart:jacket/pants; craftModule/fieldKey 见 schema；labelType/positionSide 仍用字典 erp_label_*',
-        constraint: '全量替换：按 styleId 先删该款全部工艺再插入。jacket+pants 必须放进同一次 crafts；分部位连调会互相覆盖。返回 data=写入条数。清空传 crafts:[]；processNote 为工艺备注（订单页会传）；色卡选料不在本接口，走 style_save colors[].colorCardJson',
+        constraint: '全量替换：按 styleId 先删该款全部工艺和商标位置再插入。jacket+pants 必须放进同一次 crafts；分部位连调会互相覆盖。已有商标位置时必须一并回传 labelPositions，漏传会清空。返回 data=写入条数。清空传 crafts:[]；processNote 为工艺备注（订单页会传）；色卡列 fieldValue 里的 colorCardCode/materialCode 由后端沿用旧值，勿手填；商标图片来自物料：materialId 选商标物料，diagramOssId 取该物料 imageOssId；色卡选料不在本接口，走 style_save colors[].colorCardJson',
         next: 'erp_order action=craft_get 校验 → erp_order_change_status 推进后再 erp_production_create_from_order'
     },
     erp_order_style_size_chart_save: {
@@ -322,7 +323,7 @@ export const WORKFLOW_META = {
         summary: '生产单草稿阶段保存款式工艺（同订单工艺模板与 JSON 存值）',
         prerequisite: '生产单 poStatus=draft，款式已存在',
         payload: '同订单 craft_save 的 crafts/craftModule/labelPositions；生产页通常不传 processNote',
-        constraint: '同订单 craft_save：全量替换，返回写入条数',
+        constraint: '同订单 craft_save：全量替换（含商标位置，漏传 labelPositions 会清空），返回写入条数',
         next: 'erp_production action=craft_get 校验 → erp_production_check'
     },
     erp_oss_upload: {
@@ -479,6 +480,10 @@ export const READ_META = {
         usage: '返回跟单员角色用户列表；建客户/订单或 order.assign 前取 assigneeId（字符串）',
         returns: '[{userId, userName, nickName}]'
     },
+    erp_user_options: {
+        usage: '返回全部用户；任务负责人等非跟单场景取 userId（字符串）',
+        returns: '[{userId, userName, nickName}]'
+    },
     erp_customer_list: {
         usage: '筛选客户类型 direct/trader/foreign_trade，状态 active/inactive'
     },
@@ -487,12 +492,19 @@ export const READ_META = {
         returns: '客户基本信息'
     },
     erp_customer_contact_list: { usage: '查某客户下全部联系人' },
+    erp_customer_contact_get: { usage: '按 ID 查单个联系人' },
     erp_customer_address_list: { usage: '查某客户地址，可按 shipping/billing/sample 筛选' },
+    erp_customer_address_get: { usage: '按 ID 查单个地址' },
     erp_customer_brand_list: { usage: '查某客户品牌列表，建订单时 brandId 来源' },
+    erp_customer_brand_get: { usage: '按 ID 查单个品牌' },
     erp_pi_list: { usage: 'PI状态 draft/confirmed/superseded，可按 customerId 筛选' },
     erp_pi_get: { usage: '查PI详情含金额、运输、发货地址' },
+    erp_pi_export: {
+        usage: '按 PI ID 导出形式发票 Excel 到本机',
+        returns: '{filePath, size}，filePath 为本机绝对路径'
+    },
     erp_order_list: {
-        usage: '订单状态见 erp_business_flow；可按 orderStatus/assigneeId/customerId 筛选'
+        usage: '订单状态见 erp_business_flow；可按 orderStatus/assigneeId/customerId/brandId/bizLine 筛选'
     },
     erp_order_get: { usage: '查订单主档', returns: '订单基本信息' },
     erp_order_style_list: {
@@ -508,6 +520,18 @@ export const READ_META = {
         usage: '按 styleId 读色卡工艺项清单（前端色卡弹窗实际用 style.colorCardJson 展示，本接口可选）；写备注用 color_card_save',
         returns: '[{garmentPart, fieldKey, titleCn, colorCardCode, materialCode, materialName, sort}]'
     },
+    erp_order_style_craft_export: {
+        usage: '单款导出工艺单 xlsx 到本机；默认走 preview-excel 不写附件，archive=true 才走 export-excel 写订单附件',
+        returns: '{filePath, size}，filePath 为本机绝对路径'
+    },
+    erp_order_style_color_card_export: {
+        usage: '单款导出色卡 Excel 到本机；默认走 color-card/preview 不写附件，archive=true 才走 color-card/export 写订单附件',
+        returns: '{filePath, size}，filePath 为本机绝对路径'
+    },
+    erp_order_attachment_export: {
+        usage: '按 ossId 下载订单附件到本机（含工艺单/色卡/尺寸表等全部附件）；ossId 从 attachment_list 取',
+        returns: '{filePath, size}，filePath 为本机绝对路径'
+    },
     erp_production_craft_schema: {
         usage: '同 erp_order_craft_schema'
     },
@@ -525,13 +549,22 @@ export const READ_META = {
     erp_task_get: { usage: '查任务详情' },
     erp_material_category_list: { usage: '查物料分类树，新建物料前先查 categoryId' },
     erp_material_list: {
-        usage: '分页查物料；款式配置选面料/色卡前先查；可按分类/编码/名称筛选'
+        usage: '分页查物料；款式配置选面料/色卡前先查；可按分类/编码/名称/状态筛选'
     },
     erp_material_get: { usage: '查物料详情；拿到 id/materialCode/color 再写入款式配置或色卡' },
+    erp_material_bound_orders: {
+        usage: '查引用该物料的订单（含 orderNo/customerName/styleNo/bindSource），删除或停用前确认',
+        returns: '[{orderId, orderNo, customerName, styleNo, styleName, bindSource}]'
+    },
     erp_material_supplier_list: { usage: '查某物料下可议价供应商清单' },
     erp_material_price_snapshot_list: { usage: '分页查比价快照，可按品名/编码/口径筛选' },
     erp_material_price_snapshot_get: { usage: '查比价快照详情（含 quotes 明细）' },
     erp_material_price_quote_list: { usage: '按 snapshotId 分页查明细，可筛匹配度/渠道/风险' },
+    erp_material_price_quote_get: { usage: '按 ID 查比价明细单条' },
+    erp_material_price_point_series: {
+        usage: '查比价历史点趋势；传 snapshotId 即由服务端解析标的，也可传 subjectKey 或 materialId',
+        returns: '[{priceDate, unitPrice, ...}]'
+    },
     erp_supplier_list: { usage: '供应商类型 fabric/accessory/both' },
     erp_supplier_get: { usage: '查供应商详情' },
     erp_bid_list: { usage: '可按 materialId/bidMode/bidStatus 筛选；状态由开结标时间懒刷新' },
@@ -642,12 +675,13 @@ export const ERP_BUSINESS_FLOW = {
             other: '其他',
             size_chart: '尺寸表',
             production_order: '生产单',
-            color_card: '色卡'
+            color_card: '色卡',
+            craft: '工艺单'
         },
         sampleType: { proto: '打样', pre_prod: '产前样', bulk: '船样', mass: '大货' },
         sampleStatus: { pending: '待制作', making: '制作中', shipped: '已寄出', confirmed: '已确认', rejected: '已驳回' },
         poItemCategory: {
-            button: '纽扣',
+            button: '裤子纽扣',
             label: '商标',
             hangtag: '吊牌',
             zipper: '拉链',
@@ -663,18 +697,23 @@ export const ERP_BUSINESS_FLOW = {
             combineValue: '结合项附加值(尺寸/备注等)',
             combineMap: '多填结合或逐项尺寸 Map<label,value>',
             note: 'radio/combine 旁侧编号或备注（不是 input）',
+            colorCardCode: '色卡选料色号，后端按旧值补回，一般勿传',
+            materialCode: '色卡选料物料编码，同上',
             customOptions: '＋新增自定义选项 chip（不是编号）'
         },
         craftGarmentPart: { jacket: '上衣', pants: '裤子' },
         craftModuleJacket: {
             style: '款式',
+            fuse: '粘衬',
             edge: '制边',
             sleeve: '袖子',
             collar: '领吊/领底',
             inner: '夹里',
             bartack: '套结',
-            brand: '商标',
-            mark: '标识'
+            mark: '标识',
+            print: '印花',
+            handmade: '特殊手工',
+            pack: '包装'
         },
         craftModulePants: {
             style: '款式',
@@ -682,29 +721,34 @@ export const ERP_BUSINESS_FLOW = {
             topstitch: '压明线',
             waistInner: '腰里/珠边',
             pocketFacing: '前后袋门巾',
-            pocketCloth: '袋布',
             bartack: '套结',
             mark: '标识',
+            print: '印花',
             accessory: '辅料',
-            crease: '挺缝线'
+            crease: '挺缝线',
+            pack: '包装'
         }
     },
     constraints: [
-        '客户存在关联PI时不可删除',
+        '客户删除：PI 关联的订单仍在时不可删；关联订单已删的 PI 随客户一起清掉',
+        '订单删除：级联清该单 PI、款式树和生产单，订单号改为 _原ID 释放号码可复用',
         '每订单仅一条生产单(erp_production_create_from_order)',
         'erp_production_create_from_order 仅 orderStatus=quoted|pre_prod_confirmed|po_drafting 且尚无生产单时可调用；成功后订单强制 orderStatus=po_drafting',
         '生产单仅draft可修改/编辑明细',
         '生产单submit_review: draft→reviewing',
         '生产单reject_review: reviewing→draft(需review权限)',
         '生产单issue: reviewing→issued(需issue权限)，同步订单→po_issued',
-        '已下发(issued)生产单不可删除',
+        '已下发(issued)生产单且订单仍在时不可删除；订单删除会连带清生产单',
         '工艺选项与怎么选见 erp_order_craft_schema.selectionGuide 或资源 yindie://erp/craft-guide',
         '工艺选项固定模板(对齐打样单)，不用 sys_dict；fieldValue 存 JSON(见 craftValueJson / fieldValueExample)',
         '工艺 fieldKey/craftModule 以 erp_order_craft_schema.fields 为准，勿再用旧字典码如 single_1',
         '款式面料色号：material.list/add → style_save colors[].fabricMaterialId，colorCode=物料 color，colorName 必填；勿传 fabricColorNo',
-        '色卡选料：material.list（category_code=fieldKey）/add → style_save colors[].colorCardJson；色卡备注：color_card_save（常规 items:[]）；PDF/工艺 Excel 导出无 MCP，走前端',
-        '物料删除：有绑定订单/生产单引用/比价快照时不可删',
+        '色卡选料：material.list（category_code=fieldKey）/add → style_save colors[].colorCardJson；色卡备注：color_card_save（常规 items:[]）',
+        'Excel 导出/预览都是二进制：工艺单/色卡用 erp_order action=craft_export/color_card_export，PI 用 erp_pi action=export，均落本机返回 filePath',
+        '物料删除：有绑定订单/生产单引用/比价快照时不可删；删前用 material.bound_orders 查引用',
+        '物料新增：编码命中已删除记录时直接恢复原记录并覆盖写入，不报重复',
         'craft_save 全量替换：同 styleId 的 jacket+pants 必须一次写入；分次调用后一次会删前一次',
+        'craft_save 会连商标位置一起全量替换：已有标位时须回传 labelPositions，漏传即清空',
         'craft_save 键名 crafts/craftModule；兼容历史 craft/module；旁框用 note；保存后 craft_get 校验',
         '商标位置 labelType/positionSide 仍用系统字典',
         '轮次可选：询盘可 inquiry→quoted 跳过打样（返单/大货）；记在 erp_order action=sample_*，不强制每单建轮次',
@@ -720,16 +764,16 @@ export const ERP_BUSINESS_FLOW = {
 /** MCP 服务端内置说明，连接时注入模型上下文 */
 export const ERP_MCP_INSTRUCTIONS = `银蝶 ERP MCP（域工具 + action 模式）。
 
-【开场】用户问待办/订单/我是谁 → erp_workbench action=summary 或 current_user；需跟单员 ID → action=merchandiser_options。
+【开场】用户问待办/订单/我是谁 → erp_workbench action=summary 或 current_user；需跟单员 ID → action=merchandiser_options；任务负责人 → action=user_options。
 【先读资源】复杂写操作前读 yindie://erp/usage-guide（工具用法）和 yindie://erp/business-flow（状态机/约束）；写工艺再读 yindie://erp/craft-guide 或 erp_order action=craft_schema；不确定可用 action 时读 yindie://erp/modules。
 
 【调用格式】选域工具（erp_customer/erp_order/erp_material 等），必填 action。有子实体时 action 写 target.action，如 customer.add、material.add、price_snapshot.list、thread.link。写操作用 payload 传 JSON 字符串；删用 ids；单条查改 id。所有雪花 ID 必须字符串。
 
 【主链路】customer.add → pi.add → order.add → order.link_pi →（面料 material.list/add）order.style_save(colors.fabricMaterialId/colorCode/colorName/colorCardJson) → order.craft_schema → order.craft_save(processNote?) →（可选）order.color_card_save(备注) →（尺寸表）order.size_chart_save + oss.upload×N + attachment_add×3 → order.change_status → production.create_from_order（订单→po_drafting）→ production.check → production.submit_review → production.issue。
 
-【工艺】先 craft_schema 拿 fieldKey 与 fieldValueExample，fieldValue 存 JSON 字符串；色卡选料写在 style_save colors[].colorCardJson；色卡页脚备注走 color_card_save（items:[]）；商标位置 labelType/positionSide 用系统字典。
+【工艺】先 craft_schema 拿 fieldKey 与 fieldValueExample，fieldValue 存 JSON 字符串；各模块末尾 xxNote 是备注（control=input，如 packNote）。craft_save 会连商标位置一起全量替换，已有标位须回传 labelPositions（materialId 选商标物料）；色卡选料写在 style_save colors[].colorCardJson；色卡页脚备注走 color_card_save（items:[]）；商标位置 labelType/positionSide 用系统字典；导出用 craft_export/color_card_export，附件下载用 attachment_export（ossId 取自 attachment_list），均返回本机落盘路径，前两者默认不写附件，archive=true 才归档。
 
-【物料】新增 material.add（materialCode 手填；fabric 必填 color 色号；lining 必填 composition，前后端均校验）；选已有 material.list → 面料色号行填 colors[].fabricMaterialId（colorCode=color，colorName=materialName），色卡选料填 colorCardJson。
+【物料】新增 material.add（materialCode 手填；fabric 必填 color 色号；lining 必填 composition，前后端均校验；编码命中已删记录会恢复原记录）；选已有 material.list → 面料色号行填 colors[].fabricMaterialId（colorCode=color，colorName=materialName），色卡选料填 colorCardJson；删前 material.bound_orders 查引用。
 
 【制单】create_from_order（成功后订单强制 po_drafting）→ 补交期等 → check（校验面料/色卡物料）→ submit_review → issue；辅料工艺只读，来自订单 style_save 已选面料与 colorCardJson，一般不调 save_items。
 
@@ -747,14 +791,14 @@ export const ERP_USAGE_GUIDE = {
     ],
     domains: {
         erp_workbench: {
-            actions: ['summary', 'current_user', 'merchandiser_options'],
-            note: '入口，优先 summary；建单/分派前 merchandiser_options 取 assigneeId'
+            actions: ['summary', 'current_user', 'merchandiser_options', 'user_options'],
+            note: '入口，优先 summary；建单/分派前 merchandiser_options 取 assigneeId；任务负责人用 user_options'
         },
         erp_customer: {
             actions: ['customer.*', 'contact.*', 'address.*', 'brand.*'],
-            note: 'action 示例 customer.add、contact.list；list/get 用 customerId 等筛选'
+            note: 'action 示例 customer.add、contact.list、contact.get；list/get 用 customerId 等筛选'
         },
-        erp_pi: { actions: ['list', 'get', 'add', 'edit', 'remove'] },
+        erp_pi: { actions: ['list', 'get', 'add', 'edit', 'remove', 'export'] },
         erp_oss: {
             actions: ['upload'],
             note: 'filePath=本机绝对路径；返回 ossId 再 order.attachment_add'
@@ -775,9 +819,11 @@ export const ERP_USAGE_GUIDE = {
                 'craft_schema',
                 'craft_get',
                 'craft_save',
+                'craft_export',
                 'size_chart_save',
                 'color_card_list',
                 'color_card_save',
+                'color_card_export',
                 'timeline_list',
                 'sample_list',
                 'sample_add',
@@ -790,9 +836,10 @@ export const ERP_USAGE_GUIDE = {
                 'shipment_remove',
                 'attachment_list',
                 'attachment_add',
+                'attachment_export',
                 'attachment_remove'
             ],
-            note: 'style_save 成功后返回 styles 含 styleId；craft_save 需 styleId'
+            note: 'style_save 成功后返回 styles 含 styleId；craft_save 需 styleId；craft_export/color_card_export/attachment_export 返回本机落盘路径，前两者 archive=true 才写订单附件'
         },
         erp_production: {
             actions: [
@@ -816,8 +863,8 @@ export const ERP_USAGE_GUIDE = {
         },
         erp_task: { actions: ['list', 'get', 'add', 'edit', 'remove'] },
         erp_material: {
-            actions: ['material.*', 'category.*', 'supplier.*', 'price_snapshot.*', 'price_quote.*'],
-            note: 'action 示例 material.add、category.list、supplier.list、price_snapshot.add；payload 见 payloadByEntity'
+            actions: ['material.*', 'category.*', 'supplier.*', 'price_snapshot.*', 'price_quote.*', 'price_point.*'],
+            note: 'action 示例 material.add、material.bound_orders、price_quote.get、price_point.series；payload 见 payloadByEntity'
         },
         erp_supplier: { actions: ['list', 'get', 'add', 'edit', 'remove'] },
         erp_bid: {
@@ -872,6 +919,10 @@ export const ERP_USAGE_GUIDE = {
                 }
             }
         },
+        {
+            intent: '导出工艺单/色卡',
+            call: { tool: 'erp_order', action: 'craft_export', styleId: '字符串' }
+        },
         {
             intent: '从订单生成生产单',
             call: { tool: 'erp_production', action: 'create_from_order', orderId: '字符串' }
@@ -914,13 +965,16 @@ export const ERP_USAGE_GUIDE = {
         'order.change_status': WORKFLOW_META.erp_order_change_status,
         'order.assign': WORKFLOW_META.erp_order_assign,
         'order.link_pi': WORKFLOW_META.erp_order_link_pi,
+        'pi.export': READ_META.erp_pi_export,
         'order.copy': WORKFLOW_META.erp_order_copy,
         'order.style_save': WORKFLOW_META.erp_order_style_save,
         'order.craft_get': READ_META.erp_order_style_craft_list,
         'order.craft_save': WORKFLOW_META.erp_order_style_craft_save,
+        'order.craft_export': READ_META.erp_order_style_craft_export,
         'order.size_chart_save': WORKFLOW_META.erp_order_style_size_chart_save,
         'order.color_card_list': READ_META.erp_order_style_color_card_list,
         'order.color_card_save': WORKFLOW_META.erp_order_style_color_card_save,
+        'order.color_card_export': READ_META.erp_order_style_color_card_export,
         'oss.upload': WORKFLOW_META.erp_oss_upload,
         'order.sample_add': WORKFLOW_META.erp_order_sample_add,
         'order.sample_edit': WORKFLOW_META.erp_order_sample_edit,

package/dist/tools-merged.js

@@ -17,7 +17,8 @@ const DOMAIN_TEMPLATES = [
         routes: {
             summary: { oldName: 'erp_workbench_summary' },
             current_user: { oldName: 'erp_current_user' },
-            merchandiser_options: { oldName: 'erp_merchandiser_options' }
+            merchandiser_options: { oldName: 'erp_merchandiser_options' },
+            user_options: { oldName: 'erp_user_options' }
         }
     },
     {
@@ -34,18 +35,21 @@ const DOMAIN_TEMPLATES = [
             },
             contact: {
                 list: { oldName: 'erp_customer_contact_list' },
+                get: { oldName: 'erp_customer_contact_get' },
                 add: { oldName: 'erp_customer_contact_add' },
                 edit: { oldName: 'erp_customer_contact_edit' },
                 remove: { oldName: 'erp_customer_contact_remove' }
             },
             address: {
                 list: { oldName: 'erp_customer_address_list' },
+                get: { oldName: 'erp_customer_address_get' },
                 add: { oldName: 'erp_customer_address_add' },
                 edit: { oldName: 'erp_customer_address_edit' },
                 remove: { oldName: 'erp_customer_address_remove' }
             },
             brand: {
                 list: { oldName: 'erp_customer_brand_list' },
+                get: { oldName: 'erp_customer_brand_get' },
                 add: { oldName: 'erp_customer_brand_add' },
                 edit: { oldName: 'erp_customer_brand_edit' },
                 remove: { oldName: 'erp_customer_brand_remove' }
@@ -61,7 +65,8 @@ const DOMAIN_TEMPLATES = [
             get: { oldName: 'erp_pi_get' },
             add: { oldName: 'erp_pi_add' },
             edit: { oldName: 'erp_pi_edit' },
-            remove: { oldName: 'erp_pi_remove' }
+            remove: { oldName: 'erp_pi_remove' },
+            export: { oldName: 'erp_pi_export' }
         }
     },
     {
@@ -91,9 +96,11 @@ const DOMAIN_TEMPLATES = [
             craft_schema: { oldName: 'erp_order_craft_schema' },
             craft_get: { oldName: 'erp_order_style_craft_list' },
             craft_save: { oldName: 'erp_order_style_craft_save' },
+            craft_export: { oldName: 'erp_order_style_craft_export' },
             size_chart_save: { oldName: 'erp_order_style_size_chart_save' },
             color_card_list: { oldName: 'erp_order_style_color_card_list' },
             color_card_save: { oldName: 'erp_order_style_color_card_save' },
+            color_card_export: { oldName: 'erp_order_style_color_card_export' },
             timeline_list: { oldName: 'erp_order_timeline_list' },
             sample_list: { oldName: 'erp_order_sample_list' },
             sample_add: { oldName: 'erp_order_sample_add' },
@@ -106,6 +113,7 @@ const DOMAIN_TEMPLATES = [
             shipment_remove: { oldName: 'erp_order_shipment_remove' },
             attachment_list: { oldName: 'erp_order_attachment_list' },
             attachment_add: { oldName: 'erp_order_attachment_add' },
+            attachment_export: { oldName: 'erp_order_attachment_export' },
             attachment_remove: { oldName: 'erp_order_attachment_remove' }
         }
     },
@@ -151,6 +159,7 @@ const DOMAIN_TEMPLATES = [
             material: {
                 list: { oldName: 'erp_material_list' },
                 get: { oldName: 'erp_material_get' },
+                bound_orders: { oldName: 'erp_material_bound_orders' },
                 add: { oldName: 'erp_material_add' },
                 edit: { oldName: 'erp_material_edit' },
                 remove: { oldName: 'erp_material_remove' }
@@ -176,9 +185,13 @@ const DOMAIN_TEMPLATES = [
             },
             price_quote: {
                 list: { oldName: 'erp_material_price_quote_list' },
+                get: { oldName: 'erp_material_price_quote_get' },
                 add: { oldName: 'erp_material_price_quote_add' },
                 edit: { oldName: 'erp_material_price_quote_edit' },
                 remove: { oldName: 'erp_material_price_quote_remove' }
+            },
+            price_point: {
+                series: { oldName: 'erp_material_price_point_series' }
             }
         }
     },
@@ -330,8 +343,13 @@ function inputSchemaFor(tpl, allowed) {
             orderId: optionalId.describe('订单 ID'),
             styleId: optionalId.describe('款式 ID（craft_get 必填）'),
             customerId: optionalId.describe('客户 ID'),
+            brandId: optionalId.describe('品牌 ID'),
+            bizLine: z.string().optional().describe('业务线 direct/trader'),
             orderStatus: z.string().optional().describe('订单状态'),
-            assigneeId: optionalId.describe('跟单员 ID')
+            assigneeId: optionalId.describe('跟单员 ID'),
+            fileName: z.string().optional().describe('导出类 action：落盘文件名'),
+            archive: z.boolean().optional().describe('导出类 action：true 归档到订单附件'),
+            ossId: optionalId.describe('OSS 文件 ID（attachment_export 必填）')
         };
     }
     if (tpl.name === 'erp_production') {
@@ -360,9 +378,12 @@ function inputSchemaFor(tpl, allowed) {
             materialId: optionalId.describe('物料 ID'),
             supplierId: optionalId.describe('供应商 ID'),
             snapshotId: optionalId.describe('比价快照 ID'),
+            subjectKey: z.string().optional().describe('比价标的键'),
             productName: z.string().optional().describe('品名'),
             categoryName: z.string().optional().describe('品类'),
             domain: z.string().optional().describe('比价口径 domestic/export'),
+            startDate: z.string().optional().describe('起始日期 yyyy-MM-dd'),
+            endDate: z.string().optional().describe('截止日期 yyyy-MM-dd'),
             matchLevel: z.string().optional().describe('匹配度 A/B/C/D'),
             platform: z.string().optional().describe('渠道/平台'),
             riskLevel: z.string().optional().describe('风险级别 high/mid/low/info'),

package/dist/tools.js

@@ -67,6 +67,13 @@ const READ_TOOLS = [
         inputSchema: {},
         handler: (client) => client.get('/erp/common/merchandiserOptions')
     },
+    {
+        name: 'erp_user_options',
+        description: '查询全部用户下拉选项（userId/userName/nickName），任务负责人等场景取 userId',
+        permission: null,
+        inputSchema: {},
+        handler: (client) => client.get('/erp/common/userOptions')
+    },
     {
         name: 'erp_customer_list',
         description: '分页查询客户列表，可按客户编码、名称、类型、状态筛选',
@@ -136,6 +143,33 @@ const READ_TOOLS = [
             status: args.status
         })
     },
+    {
+        name: 'erp_customer_contact_get',
+        description: '按 ID 查询客户联系人',
+        permission: 'erp:customer:query',
+        inputSchema: {
+            id: idField.describe('联系人 ID，字符串')
+        },
+        handler: (client, args) => client.get(`/erp/customer/contact/${asId(args.id)}`)
+    },
+    {
+        name: 'erp_customer_address_get',
+        description: '按 ID 查询客户地址',
+        permission: 'erp:customer:query',
+        inputSchema: {
+            id: idField.describe('地址 ID，字符串')
+        },
+        handler: (client, args) => client.get(`/erp/customer/address/${asId(args.id)}`)
+    },
+    {
+        name: 'erp_customer_brand_get',
+        description: '按 ID 查询客户品牌',
+        permission: 'erp:customer:query',
+        inputSchema: {
+            id: idField.describe('品牌 ID，字符串')
+        },
+        handler: (client, args) => client.get(`/erp/customer/brand/${asId(args.id)}`)
+    },
     {
         name: 'erp_pi_list',
         description: '分页查询 PI（形式发票）列表',
@@ -162,6 +196,18 @@ const READ_TOOLS = [
         },
         handler: (client, args) => client.get(`/erp/pi/${asId(args.id)}`)
     },
+    {
+        name: 'erp_pi_export',
+        description: '按 ID 导出 PI Excel 到本机并返回落盘路径',
+        permission: 'erp:pi:export',
+        inputSchema: {
+            id: idField.describe('PI ID，字符串')
+        },
+        handler: (client, args) => {
+            const id = asId(args.id);
+            return client.download('POST', `/erp/pi/${id}/export-excel`, `PI-${id}.xlsx`);
+        }
+    },
     {
         name: 'erp_order_list',
         description: '分页查询订单列表',
@@ -170,6 +216,8 @@ const READ_TOOLS = [
             ...pageShape,
             orderNo: z.string().optional().describe('订单号'),
             customerId: optionalId.describe('客户 ID，字符串'),
+            brandId: optionalId.describe('品牌 ID，字符串'),
+            bizLine: z.string().optional().describe('业务线 direct/trader'),
             orderStatus: z.string().optional().describe('订单状态'),
             assigneeId: optionalId.describe('跟单员 ID，字符串')
         },
@@ -177,6 +225,8 @@ const READ_TOOLS = [
             ...pageParams(args),
             orderNo: args.orderNo,
             customerId: asId(args.customerId),
+            brandId: asId(args.brandId),
+            bizLine: args.bizLine,
             orderStatus: args.orderStatus,
             assigneeId: asId(args.assigneeId)
         })
@@ -230,6 +280,20 @@ const READ_TOOLS = [
         },
         handler: (client, args) => client.get('/erp/order/style/craft/list', { styleId: asId(args.styleId) })
     },
+    {
+        name: 'erp_order_style_craft_export',
+        description: '按 styleId 导出工艺单 Excel 到本机并返回落盘路径；默认 preview 不写附件，archive=true 才归档到订单附件',
+        permission: 'erp:order:query',
+        inputSchema: {
+            styleId: idField.describe('款式 ID，字符串'),
+            fileName: z.string().optional().describe('落盘文件名，默认 craft-<styleId>.xlsx'),
+            archive: z.boolean().optional().describe('true 时写入订单附件，需 erp:order:export 权限')
+        },
+        handler: (client, args) => {
+            const styleId = asId(args.styleId);
+            return client.download('POST', args.archive ? '/erp/order/style/craft/export-excel' : '/erp/order/style/craft/preview-excel', args.fileName ?? `craft-${styleId}.xlsx`, { params: { styleId } });
+        }
+    },
     {
         name: 'erp_order_style_color_card_list',
         description: '按 styleId 打开色卡编号清单（工艺项 + colorCardCode/materialCode）',
@@ -239,6 +303,17 @@ const READ_TOOLS = [
         },
         handler: (client, args) => client.get('/erp/order/style/color-card', { styleId: asId(args.styleId) })
     },
+    {
+        name: 'erp_order_style_color_card_export',
+        description: '按 styleId 导出色卡 Excel 到本机并返回落盘路径；默认 preview 不写附件，archive=true 才归档到订单附件',
+        permission: 'erp:order:query',
+        inputSchema: {
+            styleId: idField.describe('款式 ID，字符串'),
+            fileName: z.string().optional().describe('落盘文件名，默认 color-card-<styleId>.xlsx'),
+            archive: z.boolean().optional().describe('true 时写入订单附件，需 erp:order:export 权限')
+        },
+        handler: (client, args) => client.download('POST', args.archive ? '/erp/order/style/color-card/export' : '/erp/order/style/color-card/preview', args.fileName ?? `color-card-${asId(args.styleId)}.xlsx`, { body: { styleIds: [asId(args.styleId)] } })
+    },
     {
         name: 'erp_production_craft_schema',
         description: '生产单工艺 schema + selectionGuide（同订单）',
@@ -273,6 +348,16 @@ const READ_TOOLS = [
         },
         handler: (client, args) => client.get('/erp/order/attachment/list', { orderId: asId(args.orderId) })
     },
+    {
+        name: 'erp_order_attachment_export',
+        description: '按 ossId 下载订单附件到本机并返回落盘路径；ossId 取自 attachment_list',
+        permission: 'system:oss:download',
+        inputSchema: {
+            ossId: idField.describe('OSS 文件 ID，字符串，取自 attachment_list'),
+            fileName: z.string().optional().describe('落盘文件名，默认取 OSS 原始文件名')
+        },
+        handler: (client, args) => client.download('GET', `/resource/oss/download/${asId(args.ossId)}`, args.fileName)
+    },
     {
         name: 'erp_order_sample_list',
         description: '查询订单轮次（可为空，可不建轮次）',
@@ -369,13 +454,15 @@ const READ_TOOLS = [
             ...pageShape,
             materialCode: z.string().optional().describe('物料编码（面料分类即面料号）'),
             materialName: z.string().optional().describe('物料名称'),
-            categoryId: optionalId.describe('分类 ID，字符串')
+            categoryId: optionalId.describe('分类 ID，字符串'),
+            status: z.string().optional().describe('状态 active/inactive')
         },
         handler: (client, args) => client.get('/erp/material/list', {
             ...pageParams(args),
             materialCode: args.materialCode,
             materialName: args.materialName,
-            categoryId: asId(args.categoryId)
+            categoryId: asId(args.categoryId),
+            status: args.status
         })
     },
     {
@@ -387,6 +474,15 @@ const READ_TOOLS = [
         },
         handler: (client, args) => client.get(`/erp/material/${asId(args.id)}`)
     },
+    {
+        name: 'erp_material_bound_orders',
+        description: '查询引用该物料的订单（含款号/绑定来源），删除或停用物料前先查',
+        permission: 'erp:material:query',
+        inputSchema: {
+            id: idField.describe('物料 ID，字符串')
+        },
+        handler: (client, args) => client.get(`/erp/material/${asId(args.id)}/boundOrders`)
+    },
     {
         name: 'erp_material_supplier_list',
         description: '查询物料可供应商清单',
@@ -449,6 +545,36 @@ const READ_TOOLS = [
             riskLevel: args.riskLevel
         })
     },
+    {
+        name: 'erp_material_price_quote_get',
+        description: '按 ID 查询比价明细单条',
+        permission: 'erp:material:price:query',
+        inputSchema: {
+            id: idField.describe('比价明细 ID，字符串')
+        },
+        handler: (client, args) => client.get(`/erp/material/price/quote/${asId(args.id)}`)
+    },
+    {
+        name: 'erp_material_price_point_series',
+        description: '查询物料比价历史点序列（趋势曲线），传 snapshotId 由服务端解析标的',
+        permission: 'erp:material:price:query',
+        inputSchema: {
+            snapshotId: optionalId.describe('比价快照 ID，传了它服务端据此解析标的键'),
+            subjectKey: z.string().optional().describe('标的键'),
+            materialId: optionalId.describe('物料 ID，subjectKey 缺失时兜底'),
+            domain: z.string().optional().describe('比价口径 domestic/export'),
+            startDate: z.string().optional().describe('起始日期 yyyy-MM-dd'),
+            endDate: z.string().optional().describe('截止日期 yyyy-MM-dd')
+        },
+        handler: (client, args) => client.get('/erp/material/price/point/series', {
+            snapshotId: asId(args.snapshotId),
+            subjectKey: args.subjectKey,
+            materialId: asId(args.materialId),
+            domain: args.domain,
+            startDate: args.startDate,
+            endDate: args.endDate
+        })
+    },
     {
         name: 'erp_bid_list',
         description: '分页查询物料招标列表',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yindie-erp-mcp",
-  "version": "2.0.4",
+  "version": "2.0.5",
   "description": "银蝶 ERP 独立 MCP 服务，通过 RuoYi API 提供查询与写操作能力",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,6 +12,8 @@
   },
   "scripts": {
     "build": "tsc",
+    "check": "node scripts/check-consistency.mjs",
+    "check:download": "node scripts/check-download.mjs",
     "start": "node dist/index.js",
     "dev": "tsc && node dist/index.js",
     "prepublishOnly": "npm run build",