yindie-erp-mcp 2.0.6 → 2.0.7

package/dist/craft/guide.js

@@ -77,7 +77,10 @@ function buildHowTo(item) {
         }
         text += `可多选部位：${(item.options || []).join('／')}；勾选后每项再选尺寸 ${(item.sizeOptions || []).join('/')}`;
         if (item.allowCustomSize) {
-            text += '或手填';
+            text += '或手填尺寸';
+        }
+        if (item.allowAdd) {
+            text += '；自定义部位写入 customOptions[] 并同步进 checkbox/combineMap';
         }
         if (item.syncSizeOptions?.length) {
             text += `；${item.syncSizeOptions.join('／')} 尺寸联动`;
@@ -193,13 +196,13 @@ export const CRAFT_SELECTION_GUIDE = {
         radio: '单选 → {"radio":"选项"}；howToSelect 提示可填备注时再带 note',
         checkbox: '多选 → {"checkbox":["a","b"]}',
         'checkbox+perItemSize': '多选+尺寸 → {"checkbox":["领"],"combineMap":{"领":"0.15"}}',
-        'checkbox+gateNone': '先有无再多选 → 无:{"radio":"无","checkbox":["无"]}；有:{"radio":"有","checkbox":["领"],"combineMap":{"领":"0.15"}}',
+        'checkbox+gateNone': '先有无再多选 → 无:{"radio":"无","checkbox":["无"]}；有:{"radio":"有","checkbox":["领"],"combineMap":{"领":"0.15"}}；allowAdd:true 自定义部位须同时写 customOptions[]+checkbox（+combineMap 尺寸），缺 checkbox 拒写（导出也不显示）',
         combine: '结合单选 → {"combineKey":"净脚口三折光压线","combineValue":"3"}；needValue=false 可不带 combineValue',
         'combine+multiFill': '多填 → {"combineMap":{"28L＊":"2","24L＊":"1"}}',
         input: '输入 → {"input":"文案"}；各模块末尾 xxNote 备注、人工填写项同此'
     },
     colorCardFields: COLOR_CARD_FIELDS,
-    colorCardNote: '色卡选料写在 style_save colors[].colorCardJson（JSON 字符串，键=上面 fieldKey，值={materialCode,materialName,titleCn}；pantsPocketCloth 列仅裤子前后袋工艺有值时可填）',
+    colorCardNote: '色卡选料写在 style_save colors[].colorCardJson（JSON 字符串，键=上面 fieldKey，值={materialCode,materialName,titleCn}；pantsPocketCloth 列仅裤子前后袋工艺有值时可填）。color_card_export 只读 colorCardJson，无选料拒写；工艺 onCard 只影响前端可选列，不是导出数据源；备注走 color_card_save',
     jacket: flattenGroups('jacket', JACKET_STYLE_GROUPS),
     pants: flattenGroups('pants', PANTS_STYLE_GROUPS)
 };

package/dist/craft/normalize-self-check.js

@@ -19,6 +19,101 @@ function main() {
     if (normalized.garmentPart !== undefined || normalized.craft !== undefined) {
         throw new Error('兼容键应删除');
     }
+    let rejected = false;
+    try {
+        normalizeCraftSavePayload({
+            styleId: '1',
+            crafts: [{ garmentPart: 'jacket', craftModule: 'style', fieldKey: 'description', fieldValue: '{"radio":"单挂9扣瞎填"}' }]
+        });
+    }
+    catch {
+        rejected = true;
+    }
+    if (!rejected) {
+        throw new Error('非法选项应拒');
+    }
+    normalizeCraftSavePayload({
+        styleId: '1',
+        crafts: [
+            {
+                garmentPart: 'jacket',
+                craftModule: 'edge',
+                fieldKey: 'outerNeedle',
+                fieldValue: '{"radio":"有","checkbox":["领"],"combineMap":{"领":"0.15"}}'
+            }
+        ]
+    });
+    let badPress = false;
+    try {
+        normalizeCraftSavePayload({
+            styleId: '1',
+            crafts: [
+                {
+                    garmentPart: 'jacket',
+                    craftModule: 'edge',
+                    fieldKey: 'outerPress',
+                    fieldValue: '{"radio":"瞎填","checkbox":["瞎填部位"]}'
+                }
+            ]
+        });
+    }
+    catch {
+        badPress = true;
+    }
+    if (!badPress) {
+        throw new Error('outerPress 非法 gate 应拒');
+    }
+    let badPressBox = false;
+    try {
+        normalizeCraftSavePayload({
+            styleId: '1',
+            crafts: [
+                {
+                    garmentPart: 'jacket',
+                    craftModule: 'edge',
+                    fieldKey: 'outerPress',
+                    fieldValue: '{"radio":"有","checkbox":["瞎填部位A"]}'
+                }
+            ]
+        });
+    }
+    catch {
+        badPressBox = true;
+    }
+    if (!badPressBox) {
+        throw new Error('outerPress 非法 checkbox 应拒');
+    }
+    normalizeCraftSavePayload({
+        styleId: '1',
+        crafts: [
+            {
+                garmentPart: 'jacket',
+                craftModule: 'edge',
+                fieldKey: 'outerPress',
+                fieldValue: '{"radio":"有","checkbox":["自定义部位"],"customOptions":["自定义部位"],"combineMap":{"自定义部位":"0.15"}}'
+            }
+        ]
+    });
+    let customOnly = false;
+    try {
+        normalizeCraftSavePayload({
+            styleId: '1',
+            crafts: [
+                {
+                    garmentPart: 'jacket',
+                    craftModule: 'edge',
+                    fieldKey: 'outerPress',
+                    fieldValue: '{"radio":"有","checkbox":["领"],"customOptions":["前门襟"],"combineMap":{"领":"0.15"}}'
+                }
+            ]
+        });
+    }
+    catch {
+        customOnly = true;
+    }
+    if (!customOnly) {
+        throw new Error('customOptions 未进 checkbox 应拒');
+    }
     console.log('normalizeCraftSavePayload self-check ok');
 }
 main();

package/dist/craft/validate-options.js

@@ -0,0 +1,118 @@
+import { JACKET_STYLE_GROUPS, PANTS_STYLE_GROUPS } from './template.js';
+/** 字段索引 key=garmentPart.fieldKey */
+const FIELD_INDEX = buildIndex();
+/** 构建字段索引 */
+function buildIndex() {
+    const map = new Map();
+    indexPart(map, 'jacket', JACKET_STYLE_GROUPS);
+    indexPart(map, 'pants', PANTS_STYLE_GROUPS);
+    return map;
+}
+/** 索引一个部位 */
+function indexPart(map, part, groups) {
+    for (const group of groups) {
+        for (const item of group.items) {
+            map.set(`${part}.${item.key}`, item);
+        }
+    }
+}
+/** 校验 crafts 选项值（按 control / gateNone） */
+export function assertCraftOptionValues(crafts) {
+    if (!Array.isArray(crafts)) {
+        return;
+    }
+    crafts.forEach((row, index) => {
+        if (!row || typeof row !== 'object' || Array.isArray(row)) {
+            return;
+        }
+        const craft = row;
+        const part = craft.garmentPart;
+        const fieldKey = craft.fieldKey;
+        const fieldValue = craft.fieldValue;
+        if (typeof part !== 'string' || typeof fieldKey !== 'string' || typeof fieldValue !== 'string') {
+            return;
+        }
+        const def = FIELD_INDEX.get(`${part}.${fieldKey}`);
+        if (!def || def.control === 'input' || !fieldValue.startsWith('{')) {
+            return;
+        }
+        const json = JSON.parse(fieldValue);
+        const prefix = `crafts[${index}] ${part}.${fieldKey}`;
+        const custom = new Set(json.customOptions || []);
+        const optionSet = new Set([...(def.options || []), ...custom]);
+        const combineSet = new Set((def.combineOptions || []).map((o) => o.label));
+        for (const label of custom) {
+            combineSet.add(label);
+        }
+        const noneLabel = def.noneLabel || '无';
+        if (def.control === 'radio') {
+            if (json.radio != null && json.radio !== '') {
+                assertIn(prefix, 'radio', json.radio, optionSet);
+            }
+            return;
+        }
+        if (def.control === 'combine') {
+            if (json.combineKey != null && json.combineKey !== '') {
+                assertIn(prefix, 'combineKey', json.combineKey, combineSet);
+            }
+            if (json.combineMap) {
+                for (const key of Object.keys(json.combineMap)) {
+                    assertIn(prefix, 'combineMap', key, combineSet);
+                }
+            }
+            return;
+        }
+        if (def.control === 'checkbox') {
+            if (def.gateNone) {
+                const gateSet = new Set(['有', noneLabel]);
+                if (json.radio != null && json.radio !== '') {
+                    assertIn(prefix, 'radio', json.radio, gateSet);
+                }
+                const bodyAllowed = new Set(optionSet);
+                bodyAllowed.add(noneLabel);
+                if (Array.isArray(json.checkbox)) {
+                    for (const value of json.checkbox) {
+                        assertIn(prefix, 'checkbox', value, bodyAllowed);
+                    }
+                }
+                if (json.combineMap) {
+                    for (const key of Object.keys(json.combineMap)) {
+                        assertIn(prefix, 'combineMap', key, bodyAllowed);
+                    }
+                }
+                assertCustomInCheckbox(prefix, json.customOptions, json.checkbox);
+                return;
+            }
+            if (Array.isArray(json.checkbox)) {
+                for (const value of json.checkbox) {
+                    assertIn(prefix, 'checkbox', value, optionSet);
+                }
+            }
+            if (json.combineMap) {
+                for (const key of Object.keys(json.combineMap)) {
+                    assertIn(prefix, 'combineMap', key, optionSet);
+                }
+            }
+            assertCustomInCheckbox(prefix, json.customOptions, json.checkbox);
+        }
+    });
+}
+/** customOptions 须同步进 checkbox，否则导出不显示 */
+function assertCustomInCheckbox(prefix, customOptions, checkbox) {
+    if (!Array.isArray(customOptions) || customOptions.length === 0) {
+        return;
+    }
+    const boxes = new Set(Array.isArray(checkbox) ? checkbox : []);
+    for (const opt of customOptions) {
+        if (!boxes.has(opt)) {
+            throw new Error(`${prefix} customOptions 中的「${opt}」须同时写入 checkbox，否则导出不显示`);
+        }
+    }
+}
+/** 断言取值在白名单（allowAdd 自定义项须写入 customOptions 后才进白名单） */
+function assertIn(prefix, kind, value, allowed) {
+    if (allowed.has(value)) {
+        return;
+    }
+    throw new Error(`${prefix} 取值非法：${value}，可选：${[...allowed].join('/')}`);
+}

package/dist/index.js

@@ -21,7 +21,7 @@ async function main() {
     const moduleActions = legacy ? undefined : buildModuleActions(permissions);
     const server = new McpServer({
         name: 'yindie-erp',
-        version: '2.0.1'
+        version: '2.0.17'
     }, {
         instructions: ERP_MCP_INSTRUCTIONS
     });

package/dist/tool-helpers.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { assertCraftOptionValues } from './craft/validate-options.js';
 /** JSON 请求体字段 */
 export const payloadField = z.string().describe('JSON 请求体，字段与后端 BO 一致');
 /** 主键字段 */
@@ -6,7 +7,7 @@ export const idsField = z.string().describe('主键 ID，多个用英文逗号
 /** 单个主键字段，字符串避免雪花 ID 精度丢失 */
 export const idField = z.string().describe('主键 ID');
 /** 样衣类型白名单 */
-export const SAMPLE_TYPES = new Set(['proto', 'pre_prod', 'bulk', 'mass']);
+export const SAMPLE_TYPES = new Set(['proto', 'pre_prod', 'bulk', 'mass', 'sales', 'photo']);
 /** ≥16 位数字字面量改成字符串，避免雪花 ID 精度丢失 */
 export function preserveSnowflakeIds(text) {
     return text.replace(/([:\[,]\s*)(\d{16,})(\s*[,\]}])/g, '$1"$2"$3');
@@ -46,6 +47,63 @@ export function parsePayload(args) {
     }
     throw new Error('payload 必须是 JSON 字符串');
 }
+/** 解析 get 主键：顶层 id|orderId → payload.id|orderId */
+export function resolveGetId(args) {
+    const top = args.id ?? args.orderId;
+    if (top != null && top !== '') {
+        return String(top);
+    }
+    if (args.payload == null) {
+        return undefined;
+    }
+    const payload = parsePayload(args);
+    const id = payload.id ?? payload.orderId;
+    if (id == null || id === '') {
+        return undefined;
+    }
+    return String(id);
+}
+/** 解析逗号分隔或数组 ID 列表 */
+export function asIdList(value) {
+    if (value == null || value === '') {
+        return undefined;
+    }
+    const raw = Array.isArray(value) ? value : String(value).split(',');
+    const ids = raw.map((item) => String(item).trim()).filter((item) => item !== '');
+    return ids.length > 0 ? ids : undefined;
+}
+/** 按逗号字段白名单裁剪对象/数组 */
+export function pickFields(data, fields) {
+    if (fields == null || fields === '') {
+        return data;
+    }
+    const keys = fields.split(',').map((s) => s.trim()).filter((s) => s !== '');
+    if (keys.length === 0) {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return data.map((item) => pickFields(item, fields));
+    }
+    if (data == null || typeof data !== 'object') {
+        return data;
+    }
+    const src = data;
+    const out = {};
+    for (const key of keys) {
+        if (key in src) {
+            out[key] = src[key];
+        }
+    }
+    return out;
+}
+/** 解析 include 列表 */
+export function parseInclude(value) {
+    if (value == null || value === '') {
+        return new Set();
+    }
+    const raw = Array.isArray(value) ? value : String(value).split(',');
+    return new Set(raw.map((item) => String(item).trim()).filter((item) => item !== ''));
+}
 /** 规整 style_save：自动包 styles，禁止空列表 */
 export function normalizeStyleSavePayload(raw) {
     if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
@@ -72,7 +130,7 @@ export function normalizeSamplePayload(raw) {
     }
     const payload = { ...raw };
     if (payload.sampleType != null && !SAMPLE_TYPES.has(String(payload.sampleType))) {
-        throw new Error(`sampleType 仅允许 proto/pre_prod/bulk/mass，收到：${payload.sampleType}`);
+        throw new Error(`sampleType 仅允许 proto/pre_prod/bulk/mass/sales/photo，收到：${payload.sampleType}`);
     }
     if (payload.roundName == null && payload.sampleNo != null) {
         payload.roundName = payload.sampleNo;
@@ -110,6 +168,7 @@ export function normalizeCraftSavePayload(raw) {
     if (topPart !== undefined) {
         delete payload.garmentPart;
     }
+    assertCraftOptionValues(payload.crafts);
     return payload;
 }
 /** 解析删除主键 */

package/dist/tool-meta.js

@@ -96,25 +96,25 @@ export const ENTITY_META = {
         enums: 'brandCode 后端自动生成勿传；shortCode 复制订单号用缩写'
     },
     erp_pi: {
-        module: 'PI管理',
-        step: '业务流程第2步：形式发票',
+        module: '订单管理·关联PI',
+        step: '订单详情「关联PI」Tab（独立 PI 菜单已隐藏；与前端 PiFormPanel 同能力）',
         label: 'PI',
-        prerequisite: '客户已创建',
-        addRequired: 'customerId, sourceType, piNo',
-        addOptional: 'orderId, piVersion, paymentTerms, totalAmount, currency, qtyTolerance, shippingMethod, packingType, shipmentPeriod, shippingAddress, piFileOssId, status, confirmedDate, remark, items',
+        prerequisite: '订单已创建；客户已建档',
+        addRequired: 'orderId, customerId, sourceType, piNo',
+        addOptional: '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 则关联订单（客户须一致）；items 为明细行 [{rowKey, code, style, fabric, col, composition, subtotalQty, fobNingbo, subtotalAmount}]，包装方式 packingType 保存时同步订单',
-        next: 'erp_order_add → erp_order_link_pi（若 add 已带 orderId 可跳过 link）'
+        enums: 'sourceType:customer/internal; status:draft/confirmed/superseded(默认draft)；piNo 手填；orderId 日常必填（对齐前端订单内建 PI）；items:[{rowKey?, code, style, fabric, col, composition, subtotalQty, fobNingbo, subtotalAmount}]；前端「同步款式」=先 style_list 再填 items，无单独 API；packingType 保存时同步订单；export 按 PI id 导出 Excel',
+        next: '已带 orderId 则无需 link_pi；继续 style_save / change_status'
     },
     erp_order: {
         module: '订单管理',
         step: '业务流程第3步：创建订单',
         label: '订单',
-        prerequisite: '订单客户与季度已建立；先用 erp_order action=customer_list 找订单客户，再 action=season_list 取 seasonId',
-        addRequired: 'orderNo, seasonId',
+        prerequisite: '订单客户已建立；先用 erp_order action=customer_list 取 orderCustomerId',
+        addRequired: 'orderNo, orderCustomerId',
         addOptional: 'orderStatus(默认inquiry), orderDate, deliveryDate, contractDate, depositReceived(Y/N), qtyTolerance, shippingMethod, packingType, priority, sourceChannel, parentOrderId, remark',
-        editRequired: 'id, orderNo',
-        enums: 'orderStatus见erp_business_flow资源；orderNo 手填全库唯一可改；重复报订单号已存在；客户/品牌/业务线由季度所属订单客户带出，勿传；跟单员只在订单客户维护，订单不再有跟单员',
+        editRequired: 'id',
+        enums: 'orderStatus见erp_business_flow资源；orderNo 手填全库唯一可改（edit 可省略则沿用库值）；重复报订单号已存在；客户/品牌/业务线由订单客户带出，勿传；跟单员只在订单客户维护，订单不再有跟单员',
         removeConstraint: '删除会级联清该单 PI、款式树（含工艺/商标位置/色卡）和生产单，订单号改为 _原ID 释放号码',
         next: 'erp_order_link_pi → erp_order_style_save → erp_order_change_status'
     },
@@ -127,19 +127,8 @@ export const ENTITY_META = {
         addOptional: 'brandId, remark',
         editRequired: 'id, customerId, bizLine, assigneeId',
         enums: 'bizLine:direct/trader；assigneeId 多个用英文逗号分隔；同一客户+品牌+业务线不可重复建档',
-        removeConstraint: '订单客户下存在季度时不可删除',
-        next: 'erp_order action=season_add'
-    },
-    erp_order_season: {
-        module: '订单管理',
-        step: '业务流程第3步前置：在订单客户下建季度',
-        label: '订单季度',
-        prerequisite: '订单客户已建档；orderCustomerId 来自 erp_order action=customer_list',
-        addRequired: 'orderCustomerId, seasonName',
-        editRequired: 'id, orderCustomerId, seasonName',
-        enums: 'seasonName 手填，如 2026SS / 历史订单',
-        removeConstraint: '季度下存在订单时不可删除',
-        next: 'erp_order action=add（带 seasonId）'
+        removeConstraint: '订单客户下存在订单时不可删除',
+        next: 'erp_order action=add（带 orderCustomerId）'
     },
     erp_task: {
         module: '任务协同',
@@ -219,14 +208,14 @@ export const ENTITY_META = {
     erp_production: {
         module: '生产管理',
         step: '手动新建生产单(通常用fromOrder)',
-        label: '生产单',
-        prerequisite: '订单已存在；【暂不用】前端制单中心菜单已隐藏，常规业务勿新建/推进生产单',
+        label: '制单中心生产单(PO)',
+        prerequisite: '【不用】制单中心整模块停用。勿与订单页款式行按钮「生产单」混淆：那个按钮=工艺编辑(craft_save/craft_export)，仍要用；本域是 PO 主档 create_from_order/check/issue，不要主动调',
         addRequired: 'orderId, bizLine',
         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 可修改',
-        next: '【暂不用】勿引导 create_from_order / check / issue；订单侧款式工艺色卡尺寸表即可'
+        next: '【不用】勿引导 create_from_order / check / issue；订单侧用 craft（页面「生产单」按钮）'
     },
     erp_bid: {
         module: '招标管理',
@@ -248,8 +237,8 @@ export const WORKFLOW_META = {
         step: '推进订单生命周期',
         summary: '变更订单状态',
         prerequisite: '订单已创建',
-        payload: '{id, orderStatus, remark?}；优先 payload.id，顶层 id/orderId 仅兜底写入 payload.id',
-        constraint: '流转: inquiry→sampling|doc_preparing|quoted(跳过打样); sampling→sample_shipped; sample_shipped→sample_confirmed; sample_confirmed→quoted; quoted→po_drafting; doc_preparing→pre_prod_sample; pre_prod_sample→pre_prod_confirmed; pre_prod_confirmed→po_drafting; po_drafting→po_ai_checking; po_ai_checking→color_card_confirmed|po_drafting; color_card_confirmed→po_reviewing; po_reviewing→po_issued',
+        payload: '{id|orderId, orderStatus, remark?}；payload.id → payload.orderId → 顶层 id/orderId 依次兜底',
+        constraint: '流转: inquiry→sampling|doc_preparing|quoted(跳过打样); sampling→sample_shipped; sample_shipped→sample_confirmed; sample_confirmed→quoted; quoted→po_drafting; doc_preparing→pre_prod_sample; pre_prod_sample→pre_prod_confirmed; pre_prod_confirmed→po_drafting; po_drafting→po_ai_checking; po_ai_checking→color_card_confirmed|po_drafting; color_card_confirmed→po_reviewing; po_reviewing→po_issued；非法跳步报当前状态与允许后继',
         next: '状态推进到此结束即可；【暂不用】勿再调 erp_production_create_from_order（制单中心已隐藏）'
     },
     erp_order_link_pi: {
@@ -274,8 +263,9 @@ export const WORKFLOW_META = {
         step: '录入款式明细',
         summary: '保存订单主款式及颜色尺码/色卡物料，成功后回查 styles（含 id 作 styleId、roundStyles）；页面配置确定即调本接口',
         prerequisite: '订单已创建；payload 内 orderId 用字符串',
-        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, cutQty?, actualQty?}]}]}]}；必须 styles 非空数组；顶层误放单款字段时 MCP 会自动包一层；styleNo 可省略则默认订单号-序号；colors[].colorName 必填；qty/cutQty?/actualQty?',
-        constraint: 'styles:[] 拒写；只传主款（勿塞 roundStyles）；全量 styles；已有 id/同款号则更新并替换颜色尺码，工艺/商标保留；空 sizeChartJson/样板号/船样提示沿用库值；未出现的旧主款整树删除；轮次克隆由 sample_add 生成',
+        payload: '{orderId:string, confirmReduce?, styles:[{id?, styleNo?, styleName?, sampleNo?, shipSampleTip?, garmentType:jacket|pants|suit, customerStyleRef?, materialUsage?, fabricMaterialId?, liningMaterialId?, styleImageOssId?, techFileOssId?, sizeChartJson?, remark?, colors:[{id?, fabricMaterialId, colorCode, colorName, customerStyleRef?, colorCardJson?, meterage?, materialUsage?, cuttableWidth?, totalQty?, remark?, sizes:[{sizeName, qty, cutQty?, actualQty?}]}]}]}；必须 styles 非空数组；顶层误放单款字段时 MCP 会自动包一层；styleNo 可省略则默认订单号-序号；colors[].colorName 必填；qty生产单/cutQty预裁单/actualQty实裁单',
+        enums: 'garmentType:{jacket:上衣, pants:裤子, suit:套装}；与尺寸表 category top/bottom/set 不同',
+        constraint: '【警告】未出现在 styles 的旧主款会整树删除（含工艺/尺码/轮次克隆）；数量减少时必须 confirmReduce:true，否则拒写；返回 deletedStyleIds/deletedRoundStyleIds。styles:[] 拒写；只传主款（勿塞 roundStyles）；全量 styles；已有 id/同款号则更新并替换颜色尺码，工艺/商标保留；空 sizeChartJson/样板号/船样提示沿用库值；garmentType 仅 jacket/pants/suit；fabricMaterialId 等须真实存在；轮次克隆由 sample_add 生成',
         next: '从返回 styles[].id 取 styleId → craft_save；轮次尺寸表写 roundStyles[].styleNo；色卡备注 → color_card_save'
     },
     erp_order_style_color_card_save: {
@@ -284,8 +274,8 @@ 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 编号为遗留可选，一般勿填；色卡导出用 action=color_card_export',
-        next: 'erp_order action=change_status（如 color_card_confirmed）'
+        constraint: '前端常规只传 colorCardNote 且 items:[]；选料不在本接口。items 写 craft 编号为遗留可选，一般勿填；色卡导出用 action=color_card_export（只认 colorCardJson，无选料会拒）',
+        next: 'erp_order action=color_card_export 或 change_status（如 color_card_confirmed）'
     },
     erp_bid_close: {
         module: '招标管理',
@@ -319,17 +309,17 @@ export const WORKFLOW_META = {
         summary: '保存款式上衣/裤子工艺及商标位置（选项对齐打样单模板，非字典）',
         prerequisite: '款式已保存且有 styleId；先读 erp_order_craft_schema 取 fieldKey',
         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；分部位连调会互相覆盖。已有商标位置时必须一并回传 labelPositions，漏传会清空。返回 data=写入条数。清空传 crafts:[]；processNote 为工艺备注（订单页会传）；色卡列 fieldValue 里的 colorCardCode/materialCode 由后端沿用旧值，勿手填；商标图片来自物料：materialId 选商标物料，diagramOssId 取该物料 imageOssId；色卡选料不在本接口，走 style_save colors[].colorCardJson',
-        next: 'erp_order action=craft_get 校验 → erp_order_change_status 推进即可；【暂不用】勿再调生产单'
+        enums: 'garmentPart:jacket/pants; craftModule/fieldKey 见 schema；labelType/positionSide 见 business-flow.enums.labelType/labelPositionSide',
+        constraint: '全量替换：按 styleId 先删该款全部工艺和商标位置再插入。jacket+pants 必须放进同一次 crafts；分部位连调会互相覆盖。【警告】已有商标位置时必须一并回传 labelPositions，漏传会清空。按 control 校验：radio∈options；combine∈combineOptions；checkbox∈options；checkbox+gateNone 时 radio 仅有/无，checkbox/combineMap 再对 options（官方 example 含 radio:有 合法）。input/note 不校验。返回 data=写入条数。清空传 crafts:[]；processNote 为工艺备注；色卡选料走 style_save.colorCardJson',
+        next: 'erp_order action=craft_get 校验 → 可选 craft_export → change_status；对应页面款式行「生产单」按钮（工艺），不是制单中心'
     },
     erp_order_style_size_chart_save: {
         module: '订单管理',
         step: '写入尺寸表入库视图',
         summary: '按 orderId+styleNo 写入款式 sizeChartJson（erpView）；主款或轮次克隆款均可；成功写变更日志；UI 与 MCP 共用',
         prerequisite: '款式已存在；payload 为入库视图，不是整包；MCP 侧需用户确认，UI 点保存即可',
-        payload: '{orderId:string, styleNo, sizeChartJson:{view_version,style_no,category:top|bottom|set,unit,source:{sha256},sizes:[{raw}],rows:[{std_key,std_zh,category:top|bottom,raw_name?,raw_name_zh?,delta?,is_extra?,values:[{size,type,raw,value_cm?}]}]}, confirmedBy:确认人ID, source?:mcp|ui}',
-        constraint: 'sha256 为空拒写；style_no 与入参/视图不一致拒写；同键重试不写库；固定部位 std_key 对齐上衣/裤子模板，可加 is_extra 行；delta 空用 null；轮次表用克隆款 styleNo（sample_list.roundStyleId→style_list.roundStyles）',
+        payload: '{orderId:string, styleNo, sizeChartJson:{view_version,style_no,category:top|bottom|set,unit,source:{sha256},sizes:[{raw}],rows:[{std_key,std_zh,category:top|bottom,raw_name?,raw_name_zh?,delta?,is_extra?,values:[{size,type,raw,value_cm?}]}],issues?:[],pending?:{to_supplement:[],to_confirm:[]}}, confirmedBy:确认人ID, source?:mcp|ui}',
+        constraint: 'confirmedBy/sha256/缺字段一次报全；issues/pending 可省略（后端补空）；style_no 与入参/视图不一致拒写；同键重试不写库；固定部位 std_key 对齐上衣/裤子模板，可加 is_extra 行；delta 空用 null；轮次表用克隆款 styleNo（sample_list.roundStyleId→style_list.roundStyles）',
         next: '可选 size_chart_export / oss.upload+attachment_add 留底；查历史 size_chart_logs'
     },
     erp_production_craft_save: {
@@ -345,9 +335,9 @@ export const WORKFLOW_META = {
         module: '对象存储',
         step: '上传本地文件拿 ossId',
         summary: 'multipart 上传本机文件到 /resource/oss/upload，返回 ossId/url/fileName',
-        prerequisite: 'stdio MCP 与文件同机；账号有 system:oss:upload；OSS 配置可用',
+        prerequisite: 'stdio MCP 与文件同机；账号有 system:oss:upload；OSS 配置可用（缺配置会报 OSS上传失败:…）',
         payload: 'filePath: 本机绝对路径（不是 payload JSON）',
-        constraint: '只读本地路径，不接收远程 URL；返回的 ossId 再交给 attachment_add',
+        constraint: '只读本地路径，不接收远程 URL；本地不可读/空文件先拒；后端失败透出 OSS上传失败：原因；返回的 ossId 再交给 attachment_add',
         returns: '{ossId, url, fileName}',
         next: 'erp_order_attachment_add（尺寸表 remark=原始|归一xlsx|归一json）'
     },
@@ -358,7 +348,7 @@ export const WORKFLOW_META = {
         prerequisite: '订单已创建；先 erp_oss_upload（或页面上传）拿到 ossId',
         payload: '{orderId, styleId?, attachType, fileName, ossId, fileSize?, source?, remark?}',
         enums: 'attachType:pi/tech_drawing/customer_file/other/size_chart/production_order/color_card/craft；尺寸表细分靠 remark=原始|归一xlsx|归一json',
-        constraint: '时间线查询已过滤 eventType=attachment'
+        constraint: 'ossId 须存在于 OSS，否则拒写；时间线查询已过滤 eventType=attachment'
     },
     erp_order_attachment_remove: {
         module: '订单管理',
@@ -373,8 +363,8 @@ export const WORKFLOW_META = {
         summary: '新增订单轮次并克隆主款式（pending；页面 Tab「轮次」）',
         prerequisite: '订单已创建；styleId 必须是主款（parentStyleId 为空）',
         payload: '{orderId, sampleType, styleId, roundName?, priority?, colorName?, plannedFinishDate?, remark?}；误传 sampleNo 会映射为 roundName',
-        enums: 'sampleType 仅 proto/pre_prod/bulk/mass；priority:low/normal/high/urgent(默认normal)；roundName 与 sampleType 独立',
-        constraint: 'MCP 校验 sampleType 白名单；新建后 pending；后端克隆主款→roundStyles；list 回填 roundStyleId；尺寸表/工艺写克隆款'
+        enums: 'sampleType:{proto:头样,pre_prod:产前样,bulk:船样,mass:大货,sales:销售样,photo:照片样}；priority:low/normal/high/urgent(默认normal)；roundName 与 sampleType 独立',
+        constraint: 'MCP 校验 sampleType 白名单；新建后 pending；返回 data=新样衣ID；后端克隆主款→roundStyles（款号父款-R1）；list 回填 roundStyleId；尺寸表/工艺写克隆款'
     },
     erp_order_sample_edit: {
         module: '订单管理',
@@ -382,6 +372,7 @@ export const WORKFLOW_META = {
         summary: '修改轮次基础信息（不含状态）；换主款会重克隆',
         prerequisite: '轮次已存在；styleId 须为主款',
         payload: '{id, orderId, sampleType, styleId, roundName?, priority?, colorName?, plannedFinishDate?, shipDate?, trackingNo?, courierCompany?, remark?}；sampleNo→roundName',
+        enums: 'sampleType 同 sample_add：{proto:头样,pre_prod:产前样,bulk:船样,mass:大货,sales:销售样,photo:照片样}',
         constraint: 'MCP 校验 sampleType；不可 edit 改状态；改 styleId/roundName 会重建克隆款'
     },
     erp_order_sample_change_status: {
@@ -519,22 +510,21 @@ export const READ_META = {
         returns: '{filePath, size}，filePath 为本机绝对路径'
     },
     erp_order_list: {
-        usage: '订单状态见 erp_business_flow；可按 orderStatus/customerId/brandId/bizLine/seasonId 筛选'
+        usage: '订单状态见 erp_business_flow；可按 orderStatus/orderCustomerId/customerId/brandId/bizLine 筛选'
     },
     erp_order_customer_list: {
         usage: '查订单客户（跟单员挂在此层）；可按 customerId/bizLine/orderNo/orderStatus 筛选',
         returns: 'rows[].{id,customerId,brandId,bizLine,assigneeId,assigneeName}'
     },
-    erp_order_season_list: {
-        usage: '按 orderCustomerId 查季度，建订单前取 seasonId',
-        returns: '[{id,orderCustomerId,seasonName}]'
+    erp_order_get: {
+        usage: '查订单主档；认顶层 id|orderId 或 payload.id|orderId；include=samples,shipments,timeline 追加；fields 逗号裁剪',
+        returns: '订单基本信息（可含 samples/shipments/timeline）'
     },
-    erp_order_get: { usage: '查订单主档', returns: '订单基本信息' },
     erp_order_style_list: {
-        usage: '查主款树：colors/sizes(含qty/cutQty/actualQty)/crafts/商标；轮次克隆在 roundStyles（parentStyleId/sampleId/roundName）；入参 orderId 或 orderNo；写工艺/尺寸表前必查'
+        usage: '查主款树：colors/sizes(qty生产单/cutQty预裁单/actualQty实裁单)/crafts/商标；轮次克隆在 roundStyles；入参 orderId 或 orderNo；fields 逗号裁剪'
     },
     erp_order_craft_schema: {
-        usage: '必读返回 selectionGuide：jacket/pants 每字段 options、howToSelect、fieldValueExample；再按示例拼 fieldValue JSON 字符串写入 craft_save；旁框键为 note'
+        usage: '返回 fields + selectionGuide；体积过大传 compact=true 省略 selectionGuide，完整选项读 yindie://erp/craft-guide；再按示例拼 fieldValue 写 craft_save'
     },
     erp_order_style_craft_list: {
         usage: '按 styleId 读已存工艺行，验证 craft_save；也可用 order.style_list 看 styles[].crafts'
@@ -544,21 +534,25 @@ export const READ_META = {
         returns: '[{garmentPart, fieldKey, titleCn, colorCardCode, materialCode, materialName, sort}]'
     },
     erp_order_style_craft_export: {
-        usage: '单款导出工艺单 xlsx；qtyType=prod|cut|actual（默认 prod）；默认 preview 不写附件，archive=true 才归档',
+        usage: '单款导出工艺 Excel（页面「生产单」导出）；【已去掉】多款合并导出，勿传 styleIds，请逐款导出；qtyType=prod|cut|actual；默认文件名含 qtyType；preview 默认，archive=true 才归档（失败直接报错）；fileName 只取 basename',
         returns: '{filePath, size}，filePath 为本机绝对路径'
     },
     erp_order_style_size_chart_logs: {
-        usage: 'styleId 必填；查尺寸表变更快照（sizeChartJson/source/sha256/operatorName）',
+        usage: '查尺寸表变更快照；styleId，或 orderId+styleNo 解析',
         returns: '[{id,orderId,styleId,styleNo,sizeChartJson,source,sha256,operatorId,operatorName,createTime}]'
     },
     erp_order_style_size_chart_export: {
-        usage: 'styleId 必填；可传 sizeChartJson，或 orderId+styleId 从 style_list 回查；fileName 仅文件名（落盘临时目录/yindie-erp-exports）；archive=true 写附件',
+        usage: 'styleId 必填；可传 sizeChartJson，或 orderId+styleId 从 style_list 回查；fileName 只取 basename；archive=true 写附件',
         returns: '{filePath, size}，filePath 为本机绝对路径'
     },
     erp_order_style_color_card_export: {
-        usage: '单款导出色卡 Excel 到本机；默认走 color-card/preview 不写附件，archive=true 才走 color-card/export 写订单附件',
+        usage: '单款导出色卡 Excel（与前端一致，勿传多款）；硬前置 colorCardJson 有 materialCode，否则拒写并点名款号/色号；默认 preview，archive=true 才归档',
         returns: '{filePath, size}，filePath 为本机绝对路径'
     },
+    erp_material_price_snapshot_export: {
+        usage: '导出比价快照 Excel（对齐前端材料比价列表导出）；可筛 productName/materialCode/categoryName/domain',
+        returns: '{filePath, size}'
+    },
     erp_order_attachment_export: {
         usage: '按 ossId 下载订单附件到本机（含工艺单/色卡/尺寸表等全部附件）；ossId 从 attachment_list 取',
         returns: '{filePath, size}，filePath 为本机绝对路径'
@@ -575,9 +569,13 @@ export const READ_META = {
         usage: '查订单轮次（styleId=主款，roundStyleId=克隆款，roundName/priority）；可不建轮次'
     },
     erp_order_shipment_list: { usage: '查订单出货记录，按 shipSeq 升序；一单可多批' },
-    erp_production_list: { usage: '【暂不用】制单中心已隐藏；生产单状态 draft/reviewing/issued/superseded' },
-    erp_production_get: { usage: '【暂不用】查生产单主档、styles（含 colors.colorCardJson）及缺项；辅料展示读款式配置已选面料与色卡' },
-    erp_production_check_list: { usage: '【暂不用】查生产单历次校验记录及得分' },
+    erp_production_list: {
+        usage: '【不用】制单中心停用；勿与页面款式行「生产单」(工艺)混淆；状态 draft/reviewing/issued/superseded；筛 poNo/poStatus'
+    },
+    erp_production_get: {
+        usage: '【不用】制单中心 PO 主档；页面「生产单」按钮请走 order.craft_*'
+    },
+    erp_production_check_list: { usage: '【不用】制单中心校验记录' },
     erp_task_list: { usage: '任务状态 pending/in_progress/completed/cancelled' },
     erp_task_get: { usage: '查任务详情' },
     erp_material_category_list: { usage: '查物料分类树，新建物料前先查 categoryId' },
@@ -613,8 +611,8 @@ export const ERP_BUSINESS_FLOW = {
     mainFlow: [
         '1. erp_customer action=customer.add 建客户(勿传customerCode；可传 taxNo/shortCode)',
         '2. erp_customer action=contact.add / address.add / brand.add 补全资料(brand 可传 shortCode)',
-        '3. erp_pi action=add 创建PI(需customerId, sourceType, piNo；可选 orderId 直接关联订单)',
-        '4. erp_workbench action=merchandiser_options 取跟单员 → erp_order action=customer_add 建订单客户 → action=season_add 建季度 → action=add(需 orderNo,seasonId，默认inquiry；复制订单号规则26SB01)',
+        '3. 订单详情关联PI：erp_pi action=add（需 orderId, customerId, sourceType, piNo；独立 PI 菜单已隐藏）',
+        '4. erp_workbench action=merchandiser_options 取跟单员 → erp_order action=customer_add 建订单客户 → action=add(需 orderNo,orderCustomerId，默认inquiry；复制订单号规则26SB01)',
         '5. 若 PI 未带 orderId：erp_order action=link_pi 关联PI',
         '6. erp_material list/add 选或新增面料（fabric 必填色号 color）→ erp_order action=style_save（colors[].fabricMaterialId/colorCode/colorName/colorCardJson + 尺码）',
         '7. erp_order action=craft_schema → craft_save 写工艺选项（jacket+pants 一次全量）→ craft_get 校验',
@@ -708,7 +706,8 @@ export const ERP_BUSINESS_FLOW = {
             color_card: '色卡',
             craft: '工艺单'
         },
-        sampleType: { proto: '打样', pre_prod: '产前样', bulk: '船样', mass: '大货' },
+        sampleType: { proto: '头样', pre_prod: '产前样', bulk: '船样', mass: '大货', sales: '销售样', photo: '照片样' },
+        garmentType: { jacket: '上衣', pants: '裤子', suit: '套装' },
         sampleStatus: { pending: '待制作', making: '制作中', shipped: '已寄出', confirmed: '已确认', rejected: '已驳回' },
         poItemCategory: {
             button: '裤子纽扣',
@@ -729,7 +728,7 @@ export const ERP_BUSINESS_FLOW = {
             note: 'radio/combine 旁侧编号或备注（不是 input）',
             colorCardCode: '色卡选料色号，后端按旧值补回，一般勿传',
             materialCode: '色卡选料物料编码，同上',
-            customOptions: '＋新增自定义选项 chip（不是编号）'
+            customOptions: 'allowAdd 字段的自定义 chip；须与 checkbox/combineMap 同写，勿只塞进 checkbox'
         },
         craftGarmentPart: { jacket: '上衣', pants: '裤子' },
         craftModuleJacket: {
@@ -757,28 +756,58 @@ export const ERP_BUSINESS_FLOW = {
             accessory: '辅料',
             crease: '挺缝线',
             pack: '包装'
-        }
+        },
+        labelType: {
+            main_label: '上衣主标',
+            collar_label: '上衣领标',
+            small_woven: '小织标',
+            jacket_brand: '上衣商标',
+            pants_main: '裤子主标',
+            ear_loop: '裤子挂耳',
+            flag_label: '后裤片旗标',
+            fit_label: '版型标',
+            pants_brand: '裤子商标',
+            pants_flag: '裤子旗标'
+        },
+        labelPositionSide: { front: '前面', back: '后面' }
     },
     constraints: [
         '客户删除：PI 关联的订单仍在时不可删；关联订单已删的 PI 随客户一起清掉',
         '订单删除：级联清该单 PI、款式树和生产单，订单号改为 _原ID 释放号码可复用',
-        '【暂不用】制单中心菜单已隐藏：勿主动 erp_production create_from_order / check / submit_review / issue，除非用户明确要求',
-        '每订单仅一条生产单(erp_production_create_from_order)；仅 orderStatus=quoted|pre_prod_confirmed|po_drafting 且尚无生产单时可调用；成功后订单强制 orderStatus=po_drafting',
-        '生产单仅draft可修改/编辑明细；submit_review draft→reviewing；reject_review reviewing→draft；issue reviewing→issued 并同步订单→po_issued',
-        '已下发(issued)生产单且订单仍在时不可删除；订单删除会连带清生产单',
+        '【命名】订单页款式行「生产单」=工艺(craft_save/craft_export)，要用；「制单中心」erp_production=PO 主档，不用',
+        '【不用】制单中心已停用：勿主动 erp_production create_from_order / save_items / check / submit_review / issue',
+        '制单中心 API 仍保留：每单最多一条 PO；仅 quoted|pre_prod_confirmed|po_drafting 可 from_order；成功会把订单改成 po_drafting；仅用户点名时再动',
+        '制单中心 draft 可改；submit_review draft→reviewing；reject→draft；issue→issued 并订单 po_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:[]）',
-        'Excel 导出/预览都是二进制：工艺单 craft_export（qtyType=prod|cut|actual）、色卡 color_card_export、尺寸表 size_chart_export、PI export，均落本机返回 filePath',
+        '【色卡生成】material.list/add → style_save colors[].colorCardJson（选料，键=白名单 fieldKey，值={materialCode,materialName,titleCn}）→ 可选 craft_save（仅影响前端可选列 onCard）→ 可选 color_card_save（仅备注）→ color_card_export；导出只认 colorCardJson，无选料直接拒',
+        '色卡备注：color_card_save 常规 {styleId,colorCardNote,items:[]}；选料不在 color_card_save',
+        'Excel 导出/预览都是二进制：工艺单 craft_export（qtyType=prod生产单|cut预裁单|actual实裁单，标题同步）、色卡 color_card_export、尺寸表 size_chart_export、PI export，均落本机返回 filePath',
+        '【不用】erp_production 制单中心整模块停用；主链路止于 order.change_status；勿与页面「生产单」按钮(工艺)混淆',
         '轮次 sample_add 会克隆主款；style_list 主款挂 roundStyles；尺寸表/工艺按轮次用 roundStyleId；style_save 只传主款',
         '物料删除：有绑定订单/生产单引用/比价快照时不可删；删前用 material.bound_orders 查引用',
         '物料新增：编码命中已删除记录时直接恢复原记录并覆盖写入，不报重复',
         'craft_save 全量替换：同 styleId 的 jacket+pants 必须一次写入；分次调用后一次会删前一次',
         'craft_save 会连商标位置一起全量替换：已有标位时须回传 labelPositions，漏传即清空',
         'craft_save 键名 crafts/craftModule；兼容历史 craft/module；旁框用 note；保存后 craft_get 校验',
-        '商标位置 labelType/positionSide 仍用系统字典',
+        '商标位置 labelType/positionSide 见 enums.labelType / labelPositionSide（字典 erp_label_type / erp_label_position_side），非法值后端拒写',
+        'attachment_add 的 ossId 须已存在于 OSS，否则拒写',
+        '导出 archive=true 时 OSS/附件写入失败会直接报错（不再静默）',
+        'craft_export 默认文件名 craft-<styleId>-<qtyType>.xlsx；后端归档名带生产单/预裁单/实裁单',
+        'order.get / order.edit 认顶层 id|orderId 或 payload.id|orderId；雪花 ID 须字符串',
+        'timeline_list 含 sample 轮次事件（attachment/size_chart 仍排除）；轮次明细也可用 sample_list',
+        'oss.upload 失败透出 OSS上传失败：原因；本地路径不可读/空文件先拒',
+        'craft_export cut/actual 数量空时回退 qty；色卡导出缺料报错带款号/色号',
+        'size_chart_save source.sha256 须 64 位；与视图字段同一遍校验汇总报错（有 type 等错误时不误报 sha 缺失）',
+        'size_chart_logs 认 styleId 或 orderId+styleNo',
+        '【已去掉】工艺/色卡多款合并导出：与前端一致仅单款，勿传 styleIds；请逐款 craft_export / color_card_export',
+        '材料比价列表导出：erp_material action=price_snapshot.export（对齐前端）',
+        'PI 日常入口=订单详情关联PI；add 带 orderId+customerId+piNo+sourceType；同步款式无独立 API，先 style_list 再填 items',
+        'order.get include=samples,shipments,timeline；get/style_list 可用 fields 裁剪；craft_schema compact=true 省略 selectionGuide',
+        '订单无季度层：customer_add 后直接 add(orderNo,orderCustomerId)；勿再调 season_*',
+        '订单客户下有订单不可删；list 可按 orderCustomerId 筛该客户全部订单',
         '轮次可选：询盘可 inquiry→quoted 跳过打样（返单/大货）；记在 erp_order action=sample_*，不强制每单建轮次',
         '返单用 erp_order action=copy：复制主档+款式工艺，不复制PI/样衣/生产单，新单 parentOrderId 指向源单',
         '单据编号：customerCode/supplierCode/categoryCode/brandCode/supplierMaterialCode/poNo/bidNo 后端发号勿传；materialCode 手填必传；piNo/orderNo 手填必传（订单复制发26SB01）；styleNo 可省略则默认订单号-序号',
@@ -786,9 +815,11 @@ export const ERP_BUSINESS_FLOW = {
         '招标 MCP 为内部接口，不含供应商门户 portal/login、portal/quote',
         '所有雪花 ID 入参必须字符串，禁止 number；MCP 会对 payload/响应中 ≥16 位数字字面量保真为字符串',
         'style_save 必须 styles 非空；顶层单款字段 MCP 会自动包 styles:[...]；styles:[] 拒写',
-        'sampleType 仅 proto/pre_prod/bulk/mass；误传 sampleNo 映射为 roundName',
-        'change_status 优先 payload.id；顶层 id/orderId 会兜底写入 payload.id',
-        '导出 fileName 仅取文件名，落盘系统临时目录/yindie-erp-exports'
+        '【警告】style_save 未出现的旧主款整树删除；减款须 confirmReduce:true；返回 deletedStyleIds/deletedRoundStyleIds',
+        'garmentType 仅 jacket/pants/suit，与尺寸表 category top/bottom/set 不同',
+        'sampleType 仅 {proto:头样,pre_prod:产前样,bulk:船样,mass:大货,sales:销售样,photo:照片样}；误传 sampleNo 映射为 roundName',
+        'change_status 认 payload.id / payload.orderId / 顶层 id|orderId',
+        '导出 fileName 传路径也只取 basename，落盘系统临时目录/yindie-erp-exports'
     ],
     entryPoint: 'erp_workbench action=summary',
     resourceHint: '操作前先读 yindie://erp/usage-guide、yindie://erp/business-flow、yindie://erp/modules'
@@ -801,15 +832,19 @@ export const ERP_MCP_INSTRUCTIONS = `银蝶 ERP MCP（域工具 + action 模式
 
 【调用格式】选域工具（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 →（订单客户）order.customer_add → order.season_add → order.add(seasonId) → pi.add → order.link_pi →（面料 material.list/add）order.style_save(colors…+sizes.qty/cutQty?/actualQty?) → order.craft_schema → order.craft_save →（可选）order.color_card_save →（可选）order.sample_add 克隆轮次 →（尺寸表）order.size_chart_save（主款或克隆款 styleNo）→ order.change_status。到订单推进为止。
+【主链路】customer.add →（订单客户）order.customer_add → order.add(orderCustomerId) → pi.add(orderId+…)（入口=订单关联PI）→（面料 material.list/add）order.style_save(colors…+sizes.qty/cutQty?/actualQty?+colorCardJson?) → order.craft_schema → order.craft_save →（可选）order.color_card_save →（可选）order.sample_add 克隆轮次 →（尺寸表）order.size_chart_save（主款或克隆款 styleNo）→ order.change_status。到订单推进为止；不要再进生产单。
+
+【命名别混】页面款式操作列「生产单」按钮 = 工艺编辑/导出（craft_save、craft_export，qtyType=prod 只是数量口径名），要用。侧栏「制单中心」/ erp_production = PO 主档，不用。
+
+【色卡】选料只写 style_save.colors[].colorCardJson；备注 color_card_save（items:[]）；导出 color_card_export 只认 colorCardJson（无选料会拒）。craft_save 只影响前端哪些色卡列可填（onCard），不是导出数据源。
 
-【工艺】先 craft_schema 拿 fieldKey 与 fieldValueExample；craft_save 全量替换含商标位置；色卡选料写 style_save.colorCardJson；备注走 color_card_save；导出 craft_export(qtyType=prod|cut|actual)/color_card_export/size_chart_export/attachment_export，默认不写附件，archive=true 才归档。
+【工艺】对应页面「生产单」按钮。先 craft_schema 拿 fieldKey 与 fieldValueExample（含 checkbox+gateNone 的 radio:有）；craft_save 全量替换含商标位置；按 control 校验。导出 craft_export(qtyType=prod|cut|actual，仅单款；合并导出已去掉)/size_chart_export/attachment_export，默认不写附件，archive=true 才归档。
 
 【轮次/尺寸表】sample_add 的 styleId 只能是主款；返回后 sample_list.roundStyleId 为克隆款。style_list 主款含 roundStyles。尺寸表 size_chart_save 按 styleNo 写；历史 size_chart_logs；导出 size_chart_export。
 
 【物料】material.add（materialCode 手填；fabric 必填 color；lining 必填 composition）；面料色号行填 fabricMaterialId；删前 material.bound_orders。
 
-【制单·暂不用】前端「制单中心」菜单已隐藏；勿主动 production.create_from_order / check / submit_review / issue。API 仍保留，仅用户明确要求时再动。
+【制单中心·不用】erp_production 整模块停用；主链路不含它。勿主动 create_from_order / save_items / check / submit_review / issue。API 仅保留，用户点名再说。
 
 【权限】无权限 action 会报错；以 yindie://erp/modules 返回的 actions 为准。`;
 /** 合并工具用法资源 */
@@ -843,10 +878,6 @@ export const ERP_USAGE_GUIDE = {
                 'customer_add',
                 'customer_edit',
                 'customer_remove',
-                'season_list',
-                'season_add',
-                'season_edit',
-                'season_remove',
                 'list',
                 'get',
                 'add',
@@ -882,7 +913,7 @@ export const ERP_USAGE_GUIDE = {
                 'attachment_export',
                 'attachment_remove'
             ],
-            note: '建订单前 customer_list→season_list 取 seasonId；style_save 只传主款；sample_add 克隆轮次；尺寸表按主款/克隆款 styleNo；craft_export 可带 qtyType；导出类 archive=true 才写附件'
+            note: '建订单前 customer_list 取 orderCustomerId；style_save 只传主款；sample_add 克隆轮次；尺寸表按主款/克隆款 styleNo；craft_export 可带 qtyType；导出类 archive=true 才写附件'
         },
         erp_production: {
             actions: [
@@ -907,7 +938,7 @@ export const ERP_USAGE_GUIDE = {
         erp_task: { actions: ['list', 'get', 'add', 'edit', 'remove'] },
         erp_material: {
             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'
+            note: 'action 示例 material.add、price_snapshot.export、price_point.series；payload 见 payloadByEntity'
         },
         erp_supplier: { actions: ['list', 'get', 'add', 'edit', 'remove'] },
         erp_bid: {
@@ -936,6 +967,14 @@ export const ERP_USAGE_GUIDE = {
                 payload: { customerName: 'Y', customerType: 'trader' }
             }
         },
+        {
+            intent: '创建订单（无季度，直挂订单客户）',
+            call: {
+                tool: 'erp_order',
+                action: 'add',
+                payload: { orderNo: '26SB03', orderCustomerId: '字符串', priority: 'normal' }
+            }
+        },
         {
             intent: '录订单款式',
             call: {
@@ -963,7 +1002,7 @@ export const ERP_USAGE_GUIDE = {
             }
         },
         {
-            intent: '导出工艺单（裁剪单数量）',
+            intent: '导出工艺单（预裁单数量）',
             call: { tool: 'erp_order', action: 'craft_export', styleId: '字符串', qtyType: 'cut' }
         },
         {
@@ -1027,6 +1066,7 @@ export const ERP_USAGE_GUIDE = {
         '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,
+        'material.price_snapshot.export': READ_META.erp_material_price_snapshot_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

@@ -86,10 +86,6 @@ const DOMAIN_TEMPLATES = [
             customer_add: { oldName: 'erp_order_customer_add' },
             customer_edit: { oldName: 'erp_order_customer_edit' },
             customer_remove: { oldName: 'erp_order_customer_remove' },
-            season_list: { oldName: 'erp_order_season_list' },
-            season_add: { oldName: 'erp_order_season_add' },
-            season_edit: { oldName: 'erp_order_season_edit' },
-            season_remove: { oldName: 'erp_order_season_remove' },
             list: { oldName: 'erp_order_list' },
             get: { oldName: 'erp_order_get' },
             add: { oldName: 'erp_order_add' },
@@ -188,6 +184,7 @@ const DOMAIN_TEMPLATES = [
             price_snapshot: {
                 list: { oldName: 'erp_material_price_snapshot_list' },
                 get: { oldName: 'erp_material_price_snapshot_get' },
+                export: { oldName: 'erp_material_price_snapshot_export' },
                 add: { oldName: 'erp_material_price_snapshot_add' },
                 edit: { oldName: 'erp_material_price_snapshot_edit' },
                 remove: { oldName: 'erp_material_price_snapshot_remove' }
@@ -350,17 +347,24 @@ function inputSchemaFor(tpl, allowed) {
             ...base,
             orderNo: z.string().optional().describe('订单号'),
             orderId: optionalId.describe('订单 ID'),
-            styleId: optionalId.describe('款式 ID；craft_get/size_chart_logs/size_chart_export 必填'),
+            styleId: optionalId.describe('款式 ID；craft_get/size_chart_export 等；logs 可改用 orderId+styleNo'),
+            styleNo: z.string().optional().describe('款号；size_chart_logs 与 orderId 联用'),
             customerId: optionalId.describe('客户 ID'),
             brandId: optionalId.describe('品牌 ID'),
             bizLine: z.string().optional().describe('业务线 direct/trader'),
             orderStatus: z.string().optional().describe('订单状态'),
-            orderCustomerId: optionalId.describe('订单客户 ID（season_list 必填）'),
-            qtyType: z.string().optional().describe('craft_export：prod/cut/actual，默认 prod'),
+            orderCustomerId: optionalId.describe('订单客户 ID（list/add 筛建订单用）'),
+            qtyType: z
+                .string()
+                .optional()
+                .describe('craft_export：prod生产单/cut预裁单/actual实裁单（默认 prod；Excel 标题同此）'),
             sizeChartJson: z.string().optional().describe('size_chart_export：入库视图 JSON；可省略则靠 orderId+styleId 回查'),
-            fileName: z.string().optional().describe('导出类：仅文件名，落盘临时目录/yindie-erp-exports'),
+            fileName: z.string().optional().describe('导出类：仅文件名（传路径也取 basename）'),
             archive: z.boolean().optional().describe('导出类 action：true 归档到订单附件'),
-            ossId: optionalId.describe('OSS 文件 ID（attachment_export 必填）')
+            ossId: optionalId.describe('OSS 文件 ID（attachment_export 必填）'),
+            include: z.string().optional().describe('get：samples,shipments,timeline 逗号分隔'),
+            fields: z.string().optional().describe('get/style_list：返回字段白名单，逗号分隔'),
+            compact: z.boolean().optional().describe('craft_schema：true 省略 selectionGuide')
         };
     }
     if (tpl.name === 'erp_production') {
@@ -369,7 +373,8 @@ function inputSchemaFor(tpl, allowed) {
             productionNo: z.string().optional().describe('生产单号'),
             orderId: optionalId.describe('订单 ID'),
             styleId: optionalId.describe('款式 ID（craft_get 必填）'),
-            productionOrderId: optionalId.describe('生产单 ID')
+            productionOrderId: optionalId.describe('生产单 ID'),
+            compact: z.boolean().optional().describe('craft_schema：true 省略 selectionGuide')
         };
     }
     if (tpl.name === 'erp_task') {
@@ -398,7 +403,8 @@ function inputSchemaFor(tpl, allowed) {
             matchLevel: z.string().optional().describe('匹配度 A/B/C/D'),
             platform: z.string().optional().describe('渠道/平台'),
             riskLevel: z.string().optional().describe('风险级别 high/mid/low/info'),
-            status: z.string().optional().describe('状态 active/inactive')
+            status: z.string().optional().describe('状态 active/inactive'),
+            fileName: z.string().optional().describe('price_snapshot.export：落盘文件名')
         };
     }
     if (tpl.name === 'erp_supplier') {

package/dist/tools-write.js

@@ -1,11 +1,21 @@
-import { readFile } from 'node:fs/promises';
+import { access, readFile } from 'node:fs/promises';
 import { basename } from 'node:path';
+import { constants as fsConstants } from 'node:fs';
 import { z } from 'zod';
 import { idField, idsField, normalizeCraftSavePayload, normalizeSamplePayload, normalizeStyleSavePayload, parseIds, parsePayload } from './tool-helpers.js';
 import { buildCrudDescription, buildWorkflowDescription, ENTITY_META, payloadFor, WORKFLOW_META } from './tool-meta.js';
 /** 本地文件组装 multipart */
 async function buildOssUploadForm(filePath) {
+    try {
+        await access(filePath, fsConstants.R_OK);
+    }
+    catch {
+        throw new Error(`本地文件不可读：${filePath}`);
+    }
     const bytes = await readFile(filePath);
+    if (bytes.length === 0) {
+        throw new Error(`本地文件为空：${filePath}`);
+    }
     const form = new FormData();
     form.append('file', new Blob([bytes]), basename(filePath));
     return form;
@@ -26,7 +36,16 @@ function entityCrud(name, basePath, perm) {
             description: buildCrudDescription('edit', meta),
             permission: `${perm}:edit`,
             inputSchema: { payload: payloadFor(meta, 'edit') },
-            handler: (client, args) => client.put(basePath, parsePayload(args))
+            handler: (client, args) => {
+                const payload = parsePayload(args);
+                if (payload.id == null) {
+                    const topId = args.id ?? args.orderId;
+                    if (topId != null && topId !== '') {
+                        payload.id = String(topId);
+                    }
+                }
+                return client.put(basePath, payload);
+            }
         },
         {
             name: `${name}_remove`,
@@ -56,7 +75,6 @@ export const WRITE_TOOLS = [
     ...entityCrud('erp_pi', '/erp/pi', 'erp:pi'),
     ...entityCrud('erp_order', '/erp/order', 'erp:order'),
     ...entityCrud('erp_order_customer', '/erp/order/customer', 'erp:order'),
-    ...entityCrud('erp_order_season', '/erp/order/season', 'erp:order'),
     ...entityCrud('erp_task', '/erp/task', 'erp:task'),
     ...entityCrud('erp_material', '/erp/material', 'erp:material'),
     ...entityCrud('erp_material_category', '/erp/material/category', 'erp:material:category'),
@@ -72,6 +90,9 @@ export const WRITE_TOOLS = [
     workflowTool('erp_bid_cancel', 'erp:bid:edit', { id: idField.describe('招标 ID，不可取消 awarded') }, (client, args) => client.put(`/erp/bid/cancel/${args.id}`)),
     workflowTool('erp_order_change_status', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_change_status.payload) }, (client, args) => {
         const payload = parsePayload(args);
+        if (payload.id == null && payload.orderId != null) {
+            payload.id = payload.orderId;
+        }
         if (payload.id == null) {
             const topId = args.id ?? args.orderId;
             if (topId != null && topId !== '') {

package/dist/tools.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { idField } from './tool-helpers.js';
+import { idField, parseInclude, pickFields, resolveGetId } from './tool-helpers.js';
 import { CRAFT_SELECTION_GUIDE } from './craft/guide.js';
 import { buildReadDescription, ERP_BUSINESS_FLOW, READ_META } from './tool-meta.js';
 import { WRITE_TOOLS } from './tools-write.js';
@@ -34,7 +34,16 @@ export function hasPermission(permissions, required) {
     return permissions.includes(required);
 }
 /** 包装工艺 schema */
-function wrapCraftSchema(fields) {
+function wrapCraftSchema(fields, compact) {
+    if (compact) {
+        return {
+            fields,
+            craftValueJson: ERP_BUSINESS_FLOW.enums.craftValueJson,
+            craftModuleJacket: ERP_BUSINESS_FLOW.enums.craftModuleJacket,
+            craftModulePants: ERP_BUSINESS_FLOW.enums.craftModulePants,
+            note: 'compact=true 省略 selectionGuide；选项读 yindie://erp/craft-guide 或 compact=false'
+        };
+    }
     return {
         fields,
         craftValueJson: ERP_BUSINESS_FLOW.enums.craftValueJson,
@@ -215,7 +224,7 @@ const READ_TOOLS = [
         inputSchema: {
             ...pageShape,
             orderNo: z.string().optional().describe('订单号'),
-            seasonId: optionalId.describe('季度 ID，字符串'),
+            orderCustomerId: optionalId.describe('订单客户 ID，字符串'),
             customerId: optionalId.describe('客户 ID，字符串'),
             brandId: optionalId.describe('品牌 ID，字符串'),
             bizLine: z.string().optional().describe('业务线 direct/trader'),
@@ -224,7 +233,7 @@ const READ_TOOLS = [
         handler: (client, args) => client.get('/erp/order/list', {
             ...pageParams(args),
             orderNo: args.orderNo,
-            seasonId: asId(args.seasonId),
+            orderCustomerId: asId(args.orderCustomerId),
             customerId: asId(args.customerId),
             brandId: asId(args.brandId),
             bizLine: args.bizLine,
@@ -250,31 +259,52 @@ const READ_TOOLS = [
             orderStatus: args.orderStatus
         })
     },
-    {
-        name: 'erp_order_season_list',
-        description: '按订单客户查季度，创建订单前取 seasonId',
-        permission: 'erp:order:list',
-        inputSchema: {
-            orderCustomerId: idField.describe('订单客户 ID，字符串')
-        },
-        handler: (client, args) => client.get('/erp/order/season/list', { orderCustomerId: asId(args.orderCustomerId) })
-    },
     {
         name: 'erp_order_get',
-        description: '按 ID 查询订单详情',
+        description: '按 ID 查询订单详情；认顶层 id|orderId 或 payload.id|orderId；include=samples,shipments,timeline 追加聚合；fields 逗号裁剪返回字段',
         permission: 'erp:order:query',
         inputSchema: {
-            id: idField.describe('订单 ID，字符串')
+            id: optionalId.describe('订单 ID，字符串'),
+            include: z.string().optional().describe('追加聚合：samples,shipments,timeline 逗号分隔'),
+            fields: z.string().optional().describe('只返回这些字段，逗号分隔')
         },
-        handler: (client, args) => client.get(`/erp/order/${asId(args.id)}`)
+        handler: async (client, args) => {
+            const id = resolveGetId(args);
+            if (!id) {
+                throw new Error('需要 id（顶层 id|orderId 或 payload.id|orderId）');
+            }
+            const order = (await client.get(`/erp/order/${id}`));
+            const include = parseInclude(args.include);
+            const jobs = [];
+            if (include.has('samples')) {
+                jobs.push(client.get('/erp/order/sample/list', { orderId: id }).then((rows) => {
+                    order.samples = rows;
+                }));
+            }
+            if (include.has('shipments')) {
+                jobs.push(client.get('/erp/order/shipment/list', { orderId: id }).then((rows) => {
+                    order.shipments = rows;
+                }));
+            }
+            if (include.has('timeline')) {
+                jobs.push(client.get('/erp/order/timeline/list', { orderId: id }).then((rows) => {
+                    order.timeline = rows;
+                }));
+            }
+            if (jobs.length > 0) {
+                await Promise.all(jobs);
+            }
+            return pickFields(order, args.fields);
+        }
     },
     {
         name: 'erp_order_style_list',
-        description: '查询订单主款式树（含 colors/sizes/crafts/商标；轮次克隆挂在 roundStyles）；orderId 或 orderNo 二选一，ID 必须字符串',
+        description: '查询订单主款式树（含 colors/sizes/crafts/商标；轮次克隆挂在 roundStyles）；orderId 或 orderNo 二选一；fields 逗号裁剪',
         permission: 'erp:order:query',
         inputSchema: {
             orderId: optionalId.describe('订单 ID，字符串雪花 ID'),
-            orderNo: z.string().optional().describe('订单号，无 orderId 时用此解析')
+            orderNo: z.string().optional().describe('订单号，无 orderId 时用此解析'),
+            fields: z.string().optional().describe('只返回这些字段，逗号分隔（如 id,styleNo,colors）')
         },
         handler: async (client, args) => {
             let orderId = asId(args.orderId);
@@ -289,15 +319,18 @@ const READ_TOOLS = [
             if (!orderId) {
                 throw new Error('需要 orderId（字符串）或 orderNo');
             }
-            return client.get('/erp/order/style/list', { orderId });
+            const styles = await client.get('/erp/order/style/list', { orderId });
+            return pickFields(styles, args.fields);
         }
     },
     {
         name: 'erp_order_craft_schema',
-        description: '查询工艺字段定义 + 完整选择指南(selectionGuide：选项/怎么选/fieldValueExample)。写工艺前必调',
+        description: '查询工艺字段定义 + 选择指南。compact=true 省略 selectionGuide（体积大时用）；完整选项也可读 yindie://erp/craft-guide',
         permission: 'erp:order:query',
-        inputSchema: {},
-        handler: async (client) => wrapCraftSchema(await client.get('/erp/order/style/craft/schema'))
+        inputSchema: {
+            compact: z.boolean().optional().describe('true 时省略 selectionGuide，显著减小返回体')
+        },
+        handler: async (client, args) => wrapCraftSchema(await client.get('/erp/order/style/craft/schema'), args.compact === true)
     },
     {
         name: 'erp_order_style_craft_list',
@@ -310,31 +343,59 @@ const READ_TOOLS = [
     },
     {
         name: 'erp_order_style_craft_export',
-        description: '按 styleId 导出工艺单 Excel 到本机并返回落盘路径；qtyType=prod|cut|actual 取尺码数量；默认 preview 不写附件，archive=true 才归档',
+        description: '单款导出工艺单 Excel（合并导出已去掉，勿传 styleIds）；qtyType=prod|cut|actual；默认 preview，archive=true 才归档；fileName 只取 basename',
         permission: 'erp:order:query',
         inputSchema: {
-            styleId: idField.describe('款式 ID，字符串'),
-            qtyType: z.string().optional().describe('数量类型 prod生产单/cut裁剪单/actual实际单，默认 prod'),
+            styleId: idField.describe('款式 ID，字符串；仅单款'),
+            qtyType: z
+                .string()
+                .optional()
+                .describe('数量类型 prod生产单/cut预裁单/actual实裁单（默认 prod；Excel 标题同此文案）'),
             fileName: z
                 .string()
                 .optional()
-                .describe('仅文件名（忽略目录），默认 craft-<styleId>.xlsx，落盘临时目录/yindie-erp-exports'),
-            archive: z.boolean().optional().describe('true 时写入订单附件，需 erp:order:export 权限')
+                .describe('仅文件名（传路径也只取 basename），默认 craft-<styleId>-<qtyType>.xlsx'),
+            archive: z.boolean().optional().describe('true 时写入订单附件，需 erp:order:export 权限；失败直接报错')
         },
         handler: (client, args) => {
+            if (args.styleIds != null && args.styleIds !== '') {
+                throw new Error('工艺合并导出已去掉，请逐款传 styleId 调用 craft_export');
+            }
             const styleId = asId(args.styleId);
+            if (!styleId) {
+                throw new Error('需要 styleId');
+            }
             const qtyType = args.qtyType || 'prod';
-            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, qtyType } });
+            return client.download('POST', args.archive ? '/erp/order/style/craft/export-excel' : '/erp/order/style/craft/preview-excel', args.fileName ?? `craft-${styleId}-${qtyType}.xlsx`, { params: { styleId, qtyType } });
         }
     },
     {
         name: 'erp_order_style_size_chart_logs',
-        description: '按 styleId 查尺寸表变更记录（快照列表，含 sizeChartJson）；styleId 必填',
+        description: '查尺寸表变更记录；styleId，或 orderId+styleNo 解析款式',
         permission: 'erp:order:query',
         inputSchema: {
-            styleId: idField.describe('款式 ID，必填字符串（主款或轮次克隆）')
+            styleId: optionalId.describe('款式 ID（主款或轮次克隆）'),
+            orderId: optionalId.describe('订单 ID；与 styleNo 联用解析 styleId'),
+            styleNo: z.string().optional().describe('款号；与 orderId 联用')
         },
-        handler: (client, args) => client.get('/erp/order/style/size-chart/logs', { styleId: asId(args.styleId) })
+        handler: async (client, args) => {
+            let styleId = asId(args.styleId);
+            if (!styleId) {
+                const orderId = asId(args.orderId);
+                const styleNo = typeof args.styleNo === 'string' ? args.styleNo : undefined;
+                if (!orderId || !styleNo) {
+                    throw new Error('需要 styleId，或 orderId+styleNo');
+                }
+                const styles = (await client.get('/erp/order/style/list', { orderId }));
+                const hit = styles.find((s) => s.styleNo === styleNo) ||
+                    styles.flatMap((s) => s.roundStyles || []).find((s) => s.styleNo === styleNo);
+                styleId = asId(hit?.id);
+                if (!styleId) {
+                    throw new Error(`未找到款式：orderId=${orderId} styleNo=${styleNo}`);
+                }
+            }
+            return client.get('/erp/order/style/size-chart/logs', { styleId });
+        }
     },
     {
         name: 'erp_order_style_size_chart_export',
@@ -391,21 +452,32 @@ const READ_TOOLS = [
     },
     {
         name: 'erp_order_style_color_card_export',
-        description: '按 styleId 导出色卡 Excel 到本机并返回落盘路径；默认 preview 不写附件，archive=true 才归档到订单附件',
+        description: '单款导出色卡 Excel（与前端一致，勿传多款 styleIds）；默认 preview，archive=true 才归档；fileName 只取 basename',
         permission: 'erp:order:query',
         inputSchema: {
-            styleId: idField.describe('款式 ID，字符串'),
-            fileName: z.string().optional().describe('落盘文件名，默认 color-card-<styleId>.xlsx'),
+            styleId: idField.describe('款式 ID，字符串；仅单款'),
+            fileName: z.string().optional().describe('落盘文件名（传路径也只取 basename）'),
             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)] } })
+        handler: (client, args) => {
+            if (args.styleIds != null && args.styleIds !== '') {
+                throw new Error('色卡导出与前端一致仅支持单款，请传 styleId');
+            }
+            const styleId = asId(args.styleId);
+            if (!styleId) {
+                throw new Error('需要 styleId');
+            }
+            return client.download('POST', args.archive ? '/erp/order/style/color-card/export' : '/erp/order/style/color-card/preview', args.fileName ?? `color-card-${styleId}.xlsx`, { body: { styleIds: [styleId] } });
+        }
     },
     {
         name: 'erp_production_craft_schema',
-        description: '生产单工艺 schema + selectionGuide（同订单）',
+        description: '生产单工艺 schema + selectionGuide（同订单）；compact=true 省略 selectionGuide',
         permission: 'erp:production:query',
-        inputSchema: {},
-        handler: async (client) => wrapCraftSchema(await client.get('/erp/production/craft/schema'))
+        inputSchema: {
+            compact: z.boolean().optional().describe('true 时省略 selectionGuide')
+        },
+        handler: async (client, args) => wrapCraftSchema(await client.get('/erp/production/craft/schema'), args.compact === true)
     },
     {
         name: 'erp_production_craft_list',
@@ -562,12 +634,19 @@ const READ_TOOLS = [
     },
     {
         name: 'erp_material_bound_orders',
-        description: '查询引用该物料的订单（含款号/绑定来源），删除或停用物料前先查',
+        description: '查询引用该物料的订单（含款号/绑定来源），删除或停用物料前先查；认 materialId 或 id',
         permission: 'erp:material:query',
         inputSchema: {
-            id: idField.describe('物料 ID，字符串')
+            materialId: optionalId.describe('物料 ID，字符串（推荐）'),
+            id: optionalId.describe('同 materialId，兼容旧参')
         },
-        handler: (client, args) => client.get(`/erp/material/${asId(args.id)}/boundOrders`)
+        handler: (client, args) => {
+            const materialId = asId(args.materialId) ?? asId(args.id);
+            if (!materialId) {
+                throw new Error('bound_orders 请传 materialId（物料 ID）');
+            }
+            return client.get(`/erp/material/${materialId}/boundOrders`);
+        }
     },
     {
         name: 'erp_material_supplier_list',
@@ -612,6 +691,26 @@ const READ_TOOLS = [
         },
         handler: (client, args) => client.get(`/erp/material/price/snapshot/${asId(args.id)}`)
     },
+    {
+        name: 'erp_material_price_snapshot_export',
+        description: '导出材料比价快照 Excel（与前端材料比价列表导出一致）；可按品名/编码/品类/口径筛选',
+        permission: 'erp:material:price:export',
+        inputSchema: {
+            productName: z.string().optional().describe('品名'),
+            materialCode: z.string().optional().describe('物料编码'),
+            categoryName: z.string().optional().describe('品类'),
+            domain: z.string().optional().describe('比价口径 domestic/export'),
+            fileName: z.string().optional().describe('落盘文件名，默认 price-snapshot.xlsx')
+        },
+        handler: (client, args) => client.download('POST', '/erp/material/price/snapshot/export', args.fileName ?? 'price-snapshot.xlsx', {
+            params: {
+                productName: args.productName,
+                materialCode: args.materialCode,
+                categoryName: args.categoryName,
+                domain: args.domain
+            }
+        })
+    },
     {
         name: 'erp_material_price_quote_list',
         description: '分页查询比价明细列表',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yindie-erp-mcp",
-  "version": "2.0.6",
+  "version": "2.0.7",
   "description": "银蝶 ERP 独立 MCP 服务，通过 RuoYi API 提供查询与写操作能力",
   "type": "module",
   "main": "./dist/index.js",