yindie-erp-mcp 2.0.5 → 2.0.6

package/dist/client.js

@@ -1,6 +1,7 @@
 import { mkdir, writeFile } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { basename, join } from 'node:path';
+import { parseJsonSafe } from './tool-helpers.js';
 /** ERP API 客户端 */
 export class YindieClient {
     /** 后端根地址 */
@@ -86,7 +87,7 @@ export class YindieClient {
         const response = await fetch(url, init);
         const contentType = response.headers.get('content-type') ?? '';
         if (contentType.includes('application/json')) {
-            const result = (await response.json());
+            const result = (await parseJsonSafe(await response.text()));
             if (result.code === 401 && !retried) {
                 this.token = await this.relogin();
                 return this.download(method, path, fileName, options, true);
@@ -125,7 +126,7 @@ export class YindieClient {
             init.body = JSON.stringify(body);
         }
         const response = await fetch(url, init);
-        const result = (await response.json());
+        const result = (await parseJsonSafe(await response.text()));
         if (result.code === 401 && !retried) {
             this.token = await this.relogin();
             return this.request(method, path, body, params, true);
@@ -151,7 +152,7 @@ export class YindieClient {
         };
         const form = await formFactory();
         const response = await fetch(url, { method: 'POST', headers, body: form });
-        const result = (await response.json());
+        const result = (await parseJsonSafe(await response.text()));
         if (result.code === 401 && !retried) {
             this.token = await this.relogin();
             return this.requestForm(path, formFactory, true);

package/dist/tool-helpers.js

@@ -5,17 +5,81 @@ export const payloadField = z.string().describe('JSON 请求体，字段与后
 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']);
+/** ≥16 位数字字面量改成字符串，避免雪花 ID 精度丢失 */
+export function preserveSnowflakeIds(text) {
+    return text.replace(/([:\[,]\s*)(\d{16,})(\s*[,\]}])/g, '$1"$2"$3');
+}
+/** 解析保真后的 JSON */
+export function parseJsonSafe(text) {
+    return JSON.parse(preserveSnowflakeIds(text));
+}
+/** 校验对象内 id 类字段不为 number */
+function assertNoNumberIds(value, path = '') {
+    if (value == null || typeof value !== 'object') {
+        return;
+    }
+    if (Array.isArray(value)) {
+        value.forEach((item, i) => assertNoNumberIds(item, `${path}[${i}]`));
+        return;
+    }
+    for (const [key, child] of Object.entries(value)) {
+        const here = path ? `${path}.${key}` : key;
+        if (typeof child === 'number' && (key === 'id' || key === 'ids' || /Id$/.test(key))) {
+            throw new Error(`雪花 ID 必须字符串：${here}=${child}（勿用 JSON number）`);
+        }
+        assertNoNumberIds(child, here);
+    }
+}
 /** 解析 JSON 请求体 */
 export function parsePayload(args) {
     const raw = args.payload;
     if (typeof raw === 'string') {
-        return JSON.parse(raw);
+        const parsed = parseJsonSafe(raw);
+        assertNoNumberIds(parsed);
+        return parsed;
     }
     if (raw && typeof raw === 'object') {
+        assertNoNumberIds(raw);
         return raw;
     }
     throw new Error('payload 必须是 JSON 字符串');
 }
+/** 规整 style_save：自动包 styles，禁止空列表 */
+export function normalizeStyleSavePayload(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error('style_save payload 须为对象');
+    }
+    const input = raw;
+    let styles = input.styles;
+    if (!Array.isArray(styles)) {
+        if (input.styleNo != null || input.colors != null || input.styleName != null) {
+            const { orderId, ...rest } = input;
+            return { orderId, styles: [rest] };
+        }
+        throw new Error('style_save 须 payload.styles:[{...}]，勿把款式字段放顶层');
+    }
+    if (styles.length === 0) {
+        throw new Error('style_save 的 styles 不能为空数组');
+    }
+    return { ...input, styles };
+}
+/** 规整样衣写入：类型白名单 + sampleNo→roundName */
+export function normalizeSamplePayload(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error('样衣 payload 须为对象');
+    }
+    const payload = { ...raw };
+    if (payload.sampleType != null && !SAMPLE_TYPES.has(String(payload.sampleType))) {
+        throw new Error(`sampleType 仅允许 proto/pre_prod/bulk/mass，收到：${payload.sampleType}`);
+    }
+    if (payload.roundName == null && payload.sampleNo != null) {
+        payload.roundName = payload.sampleNo;
+        delete payload.sampleNo;
+    }
+    return payload;
+}
 /** 规整工艺保存入参 */
 export function normalizeCraftSavePayload(raw) {
     if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {

package/dist/tool-meta.js

@@ -110,14 +110,37 @@ export const ENTITY_META = {
         module: '订单管理',
         step: '业务流程第3步：创建订单',
         label: '订单',
-        prerequisite: '客户已创建；assigneeId 来自 erp_workbench action=merchandiser_options',
-        addRequired: 'orderNo, customerId, bizLine, assigneeId',
-        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 手填全库唯一可改；重复报订单号已存在',
+        prerequisite: '订单客户与季度已建立；先用 erp_order action=customer_list 找订单客户，再 action=season_list 取 seasonId',
+        addRequired: 'orderNo, seasonId',
+        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 手填全库唯一可改；重复报订单号已存在；客户/品牌/业务线由季度所属订单客户带出，勿传；跟单员只在订单客户维护，订单不再有跟单员',
         removeConstraint: '删除会级联清该单 PI、款式树（含工艺/商标位置/色卡）和生产单，订单号改为 _原ID 释放号码',
         next: 'erp_order_link_pi → erp_order_style_save → erp_order_change_status'
     },
+    erp_order_customer: {
+        module: '订单管理',
+        step: '业务流程第3步前置：订单客户建档，跟单员挂在这一层',
+        label: '订单客户',
+        prerequisite: '客户已建档；跟单员取自 erp_workbench action=merchandiser_options',
+        addRequired: 'customerId, bizLine, assigneeId',
+        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）'
+    },
     erp_task: {
         module: '任务协同',
         step: '订单跟进过程中创建待办',
@@ -197,13 +220,13 @@ export const ENTITY_META = {
         module: '生产管理',
         step: '手动新建生产单(通常用fromOrder)',
         label: '生产单',
-        prerequisite: '订单已存在',
+        prerequisite: '订单已存在；【暂不用】前端制单中心菜单已隐藏，常规业务勿新建/推进生产单',
         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: 'erp_production craft_save（可选）→ check → submit_review → issue；辅料工艺只读展示款式配置已选面料与色卡，一般不必 save_items'
+        next: '【暂不用】勿引导 create_from_order / check / issue；订单侧款式工艺色卡尺寸表即可'
     },
     erp_bid: {
         module: '招标管理',
@@ -225,17 +248,9 @@ export const WORKFLOW_META = {
         step: '推进订单生命周期',
         summary: '变更订单状态',
         prerequisite: '订单已创建',
-        payload: '{id, orderStatus, remark?}',
+        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',
-        next: 'quoted/pre_prod_confirmed/po_drafting 时 erp_production_create_from_order'
-    },
-    erp_order_assign: {
-        module: '订单管理',
-        step: '订单分派跟单员',
-        summary: '分派或变更跟单员',
-        prerequisite: '订单已创建；assigneeId 来自 erp_workbench action=merchandiser_options',
-        payload: '{id, assigneeId}',
-        next: 'erp_order_style_save'
+        next: '状态推进到此结束即可；【暂不用】勿再调 erp_production_create_from_order（制单中心已隐藏）'
     },
     erp_order_link_pi: {
         module: '订单管理',
@@ -257,11 +272,11 @@ export const WORKFLOW_META = {
     erp_order_style_save: {
         module: '订单管理',
         step: '录入款式明细',
-        summary: '保存订单款式及颜色尺码/色卡物料，成功后回查 styles（含 id 作 styleId）；页面配置确定即调本接口',
+        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}]}]}]}；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'
+        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 生成',
+        next: '从返回 styles[].id 取 styleId → craft_save；轮次尺寸表写 roundStyles[].styleNo；色卡备注 → color_card_save'
     },
     erp_order_style_color_card_save: {
         module: '订单管理',
@@ -306,24 +321,24 @@ export const WORKFLOW_META = {
         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 推进后再 erp_production_create_from_order'
+        next: 'erp_order action=craft_get 校验 → erp_order_change_status 推进即可；【暂不用】勿再调生产单'
     },
     erp_order_style_size_chart_save: {
         module: '订单管理',
         step: '写入尺寸表入库视图',
-        summary: '按 orderId+styleNo 写入款式 sizeChartJson（erpView）；幂等键含 source.sha256；确认后才调',
-        prerequisite: '款式已存在；payload 为入库视图 doc.erp，不是整包；用户已在会话确认',
-        payload: '{orderId:string, styleNo, sizeChartJson:erpView对象, confirmedBy:确认人ID, source?:mcp|ui}',
-        constraint: 'sha256 为空拒写；style_no 与入参不一致拒写；同键重试不写库不打时间线',
-        next: 'erp_oss_upload 拿 ossId → erp_order_attachment_add×3 留底 → erp_production_check'
+        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）',
+        next: '可选 size_chart_export / oss.upload+attachment_add 留底；查历史 size_chart_logs'
     },
     erp_production_craft_save: {
         module: '生产管理',
         step: '填写结构化工艺',
-        summary: '生产单草稿阶段保存款式工艺（同订单工艺模板与 JSON 存值）',
-        prerequisite: '生产单 poStatus=draft，款式已存在',
+        summary: '生产单草稿阶段保存款式工艺（同订单工艺模板与 JSON 存值）【暂不用】',
+        prerequisite: '生产单 poStatus=draft，款式已存在；常规流程勿用',
         payload: '同订单 craft_save 的 crafts/craftModule/labelPositions；生产页通常不传 processNote',
-        constraint: '同订单 craft_save：全量替换（含商标位置，漏传 labelPositions 会清空），返回写入条数',
+        constraint: '【暂不用】同订单 craft_save：全量替换（含商标位置，漏传 labelPositions 会清空），返回写入条数',
         next: 'erp_production action=craft_get 校验 → erp_production_check'
     },
     erp_oss_upload: {
@@ -355,19 +370,19 @@ export const WORKFLOW_META = {
     erp_order_sample_add: {
         module: '订单管理',
         step: '记录轮次',
-        summary: '新增订单轮次（状态固定 pending；页面 Tab「轮次」）',
-        prerequisite: '订单已创建',
-        payload: '{orderId, sampleType, styleId?, roundName?, sizeName?, colorName?, plannedFinishDate?, remark?}',
-        enums: 'sampleType(类型):proto打样/pre_prod产前样/bulk船样/mass大货；roundName 与 sampleType 独立',
-        constraint: '新建后状态为 pending，不可传 sampleStatus；list 回填 styleName'
+        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；尺寸表/工艺写克隆款'
     },
     erp_order_sample_edit: {
         module: '订单管理',
         step: '更新轮次信息',
-        summary: '修改轮次基础信息（不含状态）',
-        prerequisite: '轮次已存在',
-        payload: '{id, orderId, sampleType, styleId?, roundName?, sizeName?, colorName?, plannedFinishDate?, shipDate?, trackingNo?, courierCompany?, remark?}',
-        constraint: '不可通过 edit 改状态，状态走 sample_change_status'
+        summary: '修改轮次基础信息（不含状态）；换主款会重克隆',
+        prerequisite: '轮次已存在；styleId 须为主款',
+        payload: '{id, orderId, sampleType, styleId, roundName?, priority?, colorName?, plannedFinishDate?, shipDate?, trackingNo?, courierCompany?, remark?}；sampleNo→roundName',
+        constraint: 'MCP 校验 sampleType；不可 edit 改状态；改 styleId/roundName 会重建克隆款'
     },
     erp_order_sample_change_status: {
         module: '订单管理',
@@ -381,7 +396,7 @@ export const WORKFLOW_META = {
     erp_order_sample_remove: {
         module: '订单管理',
         step: '删除轮次',
-        summary: '删除订单轮次',
+        summary: '删除订单轮次及其克隆款式',
         prerequisite: '轮次已存在',
         payload: 'ids: 轮次ID，多个逗号分隔'
     },
@@ -411,11 +426,11 @@ export const WORKFLOW_META = {
     erp_production_create_from_order: {
         module: '生产管理',
         step: '从订单生成生产单草稿',
-        summary: '一键创建生产单',
-        prerequisite: '订单已存在、尚无生产单，且 orderStatus 为 quoted/pre_prod_confirmed/po_drafting',
+        summary: '一键创建生产单【暂不用：制单中心菜单已隐藏，勿主动调用】',
+        prerequisite: '订单已存在、尚无生产单，且 orderStatus 为 quoted/pre_prod_confirmed/po_drafting；常规流程勿用',
         payload: 'orderId: 订单ID',
-        constraint: '仅 quoted/pre_prod_confirmed/po_drafting 可调用；若当前为 quoted/pre_prod_confirmed 会自动改订单为 po_drafting；生产单号=订单号-PO；每单仅一条',
-        next: '完善交期等主档 → craft_save（可选）→ erp_production_check；辅料来自订单款式配置只读'
+        constraint: '【暂不用】前端制单中心已隐藏；仅 quoted/pre_prod_confirmed/po_drafting 可调用；若当前为 quoted/pre_prod_confirmed 会自动改订单为 po_drafting；生产单号=订单号-PO；每单仅一条',
+        next: '勿继续引导 check/submit_review/issue，除非用户明确要求'
     },
     erp_production_save_items: {
         module: '生产管理',
@@ -429,38 +444,38 @@ export const WORKFLOW_META = {
     erp_production_check: {
         module: '生产管理',
         step: '人工校验缺项',
-        summary: '执行生产单完整性校验（含交期、面料/色卡物料、尺寸表、工艺选项等）',
-        prerequisite: '生产单已存在',
+        summary: '执行生产单完整性校验【暂不用】',
+        prerequisite: '生产单已存在；常规勿用',
         payload: 'id: 生产单ID',
         returns: '校验分数、缺项列表(checkResult: pass/warning/fail)',
-        next: 'erp_production_submit_review'
+        next: '【暂不用】勿继续 submit_review'
     },
     erp_production_submit_review: {
         module: '生产管理',
         step: '提交审核',
-        summary: '生产单提交审核',
-        prerequisite: '生产单poStatus=draft',
+        summary: '生产单提交审核【暂不用】',
+        prerequisite: '生产单poStatus=draft；常规勿用',
         payload: 'id: 生产单ID',
         constraint: '提交后poStatus→reviewing',
-        next: 'erp_production_issue 或 erp_production_reject_review'
+        next: '【暂不用】'
     },
     erp_production_reject_review: {
         module: '生产管理',
         step: '审核退回',
-        summary: '生产单审核退回草稿',
-        prerequisite: '生产单poStatus=reviewing，需erp:production:review权限',
+        summary: '生产单审核退回草稿【暂不用】',
+        prerequisite: '生产单poStatus=reviewing，需erp:production:review权限；常规勿用',
         payload: 'id: 生产单ID',
         constraint: '退回后poStatus→draft',
-        next: '改主档/工艺后重新 check → submit_review'
+        next: '【暂不用】'
     },
     erp_production_issue: {
         module: '生产管理',
         step: '下发工厂',
-        summary: '生产单正式下发',
-        prerequisite: '生产单poStatus=reviewing，需erp:production:issue权限',
+        summary: '生产单正式下发【暂不用】',
+        prerequisite: '生产单poStatus=reviewing，需erp:production:issue权限；常规勿用',
         payload: 'id: 生产单ID',
         constraint: '下发后poStatus→issued，关联订单状态→po_issued',
-        next: '流程结束'
+        next: '【暂不用】'
     },
     erp_email_thread_link: {
         module: '邮件',
@@ -477,7 +492,7 @@ export const READ_META = {
         usage: '【入口】建议首先调用，获取待办任务、超期任务、缺项生产单、近期订单概览'
     },
     erp_merchandiser_options: {
-        usage: '返回跟单员角色用户列表；建客户/订单或 order.assign 前取 assigneeId（字符串）',
+        usage: '返回跟单员角色用户列表；建订单客户前取 assigneeId（字符串）',
         returns: '[{userId, userName, nickName}]'
     },
     erp_user_options: {
@@ -504,11 +519,19 @@ export const READ_META = {
         returns: '{filePath, size}，filePath 为本机绝对路径'
     },
     erp_order_list: {
-        usage: '订单状态见 erp_business_flow；可按 orderStatus/assigneeId/customerId/brandId/bizLine 筛选'
+        usage: '订单状态见 erp_business_flow；可按 orderStatus/customerId/brandId/bizLine/seasonId 筛选'
+    },
+    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: '查订单主档', returns: '订单基本信息' },
     erp_order_style_list: {
-        usage: '查订单款式→颜色→尺码→工艺→商标位置；入参 orderId(字符串) 或 orderNo；返回含 styleId，制单/写工艺前必查'
+        usage: '查主款树：colors/sizes(含qty/cutQty/actualQty)/crafts/商标；轮次克隆在 roundStyles（parentStyleId/sampleId/roundName）；入参 orderId 或 orderNo；写工艺/尺寸表前必查'
     },
     erp_order_craft_schema: {
         usage: '必读返回 selectionGuide：jacket/pants 每字段 options、howToSelect、fieldValueExample；再按示例拼 fieldValue JSON 字符串写入 craft_save；旁框键为 note'
@@ -521,7 +544,15 @@ export const READ_META = {
         returns: '[{garmentPart, fieldKey, titleCn, colorCardCode, materialCode, materialName, sort}]'
     },
     erp_order_style_craft_export: {
-        usage: '单款导出工艺单 xlsx 到本机；默认走 preview-excel 不写附件，archive=true 才走 export-excel 写订单附件',
+        usage: '单款导出工艺单 xlsx；qtyType=prod|cut|actual（默认 prod）；默认 preview 不写附件，archive=true 才归档',
+        returns: '{filePath, size}，filePath 为本机绝对路径'
+    },
+    erp_order_style_size_chart_logs: {
+        usage: 'styleId 必填；查尺寸表变更快照（sizeChartJson/source/sha256/operatorName）',
+        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 写附件',
         returns: '{filePath, size}，filePath 为本机绝对路径'
     },
     erp_order_style_color_card_export: {
@@ -540,11 +571,13 @@ export const READ_META = {
     },
     erp_order_timeline_list: { usage: '查订单状态变更、生产事件等跟进时间线' },
     erp_order_attachment_list: { usage: '查订单附件列表' },
-    erp_order_sample_list: { usage: '查订单轮次（含 styleId/styleName/roundName）；可不建轮次' },
+    erp_order_sample_list: {
+        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' },
+    erp_production_get: { usage: '【暂不用】查生产单主档、styles（含 colors.colorCardJson）及缺项；辅料展示读款式配置已选面料与色卡' },
+    erp_production_check_list: { usage: '【暂不用】查生产单历次校验记录及得分' },
     erp_task_list: { usage: '任务状态 pending/in_progress/completed/cancelled' },
     erp_task_get: { usage: '查任务详情' },
     erp_material_category_list: { usage: '查物料分类树，新建物料前先查 categoryId' },
@@ -576,24 +609,21 @@ export const READ_META = {
 };
 /** ERP 业务流程文档 */
 export const ERP_BUSINESS_FLOW = {
-    overview: '外贸服装ERP：客户建档 → PI形式发票 → 订单(款式/附件/跟单) → 生产单(校验/审核/下发)。物料/供应商为主数据，招标为物料询价，邮件/任务为协同手段。客户/供应商/分类/品牌/生产单/招标等编号后端发号；materialCode/订单号/款号手填（复制订单按年+缩写+序号发号）。',
+    overview: '外贸服装ERP：客户建档 → PI形式发票 → 订单(款式/附件/跟单)。【暂不用】制单中心菜单已隐藏，常规勿走生产单校验/审核/下发。物料/供应商为主数据，招标为物料询价，邮件/任务为协同手段。客户/供应商/分类/品牌/生产单/招标等编号后端发号；materialCode/订单号/款号手填（复制订单按年+缩写+序号发号）。',
     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=add(需 orderNo,customerId,bizLine,assigneeId，默认inquiry；复制订单号规则26SB01)',
+        '4. erp_workbench action=merchandiser_options 取跟单员 → erp_order action=customer_add 建订单客户 → action=season_add 建季度 → action=add(需 orderNo,seasonId，默认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 校验',
         '8. （可选）erp_order action=color_card_save 写色卡页脚备注（常规 {styleId,colorCardNote,items:[]}）；选料已在 style_save.colorCardJson',
-        '9. （可选）erp_order action=size_chart_save 写入尺寸表视图；erp_oss action=upload 拿 ossId 后 attachment_add×3 留底',
-        '10. erp_order action=change_status 按规则推进状态',
-        '11. erp_production action=create_from_order 生成生产单草稿(订单须 quoted/pre_prod_confirmed/po_drafting 且无生产单；成功后订单→po_drafting)',
-        '12. erp_production action=craft_save 补工艺（辅料工艺只读展示款式配置已选面料与色卡物料，不必 save_items 手录）',
-        '13. erp_production action=check 人工校验（含面料/色卡物料/sizeChart 缺项）',
-        '14. erp_production action=submit_review 提交审核',
-        '15. erp_production action=issue 下发(订单→po_issued)',
-        '16. erp_bid action=add 对物料发起明/暗标(materialId,qty,bidMode,openTime,closeTime)'
+        '9. （可选）erp_order action=sample_add 建轮次（自动克隆主款→roundStyleId）；尺寸表/工艺按轮次写克隆款',
+        '10. （可选）erp_order action=size_chart_save 写入尺寸表视图（主款或克隆款 styleNo）；size_chart_export 导出；size_chart_logs 查历史',
+        '11. erp_order action=change_status 按规则推进状态（主链路到此结束）',
+        '12. 【暂不用】erp_production create_from_order / check / submit_review / issue：制单中心已隐藏，勿主动调用',
+        '13. erp_bid action=add 对物料发起明/暗标(materialId,qty,bidMode,openTime,closeTime)'
     ],
     bidStatus: {
         default: 'draft',
@@ -732,19 +762,17 @@ export const ERP_BUSINESS_FLOW = {
     constraints: [
         '客户删除：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',
+        '【暂不用】制单中心菜单已隐藏：勿主动 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)生产单且订单仍在时不可删除；订单删除会连带清生产单',
         '工艺选项与怎么选见 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 导出/预览都是二进制：工艺单/色卡用 erp_order action=craft_export/color_card_export，PI 用 erp_pi action=export，均落本机返回 filePath',
+        'Excel 导出/预览都是二进制：工艺单 craft_export（qtyType=prod|cut|actual）、色卡 color_card_export、尺寸表 size_chart_export、PI export，均落本机返回 filePath',
+        '轮次 sample_add 会克隆主款；style_list 主款挂 roundStyles；尺寸表/工艺按轮次用 roundStyleId；style_save 只传主款',
         '物料删除：有绑定订单/生产单引用/比价快照时不可删；删前用 material.bound_orders 查引用',
         '物料新增：编码命中已删除记录时直接恢复原记录并覆盖写入，不报重复',
         'craft_save 全量替换：同 styleId 的 jacket+pants 必须一次写入；分次调用后一次会删前一次',
@@ -756,7 +784,11 @@ export const ERP_BUSINESS_FLOW = {
         '单据编号：customerCode/supplierCode/categoryCode/brandCode/supplierMaterialCode/poNo/bidNo 后端发号勿传；materialCode 手填必传；piNo/orderNo 手填必传（订单复制发26SB01）；styleNo 可省略则默认订单号-序号',
         '招标仅 draft 可改/可删(cancelled 可删)；collecting 可 close/cancel；closed 可 award/cancel；awarded 不可取消；collecting 不可直接 award',
         '招标 MCP 为内部接口，不含供应商门户 portal/login、portal/quote',
-        '所有雪花 ID 入参必须字符串，禁止 number（否则精度丢失导致静默空结果/挂错父对象）'
+        '所有雪花 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'
     ],
     entryPoint: 'erp_workbench action=summary',
     resourceHint: '操作前先读 yindie://erp/usage-guide、yindie://erp/business-flow、yindie://erp/modules'
@@ -769,13 +801,15 @@ 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 → 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。
+【主链路】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。到订单推进为止。
+
+【工艺】先 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，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 才归档。
+【轮次/尺寸表】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，前后端均校验；编码命中已删记录会恢复原记录）；选已有 material.list → 面料色号行填 colors[].fabricMaterialId（colorCode=color，colorName=materialName），色卡选料填 colorCardJson；删前 material.bound_orders 查引用。
+【物料】material.add（materialCode 手填；fabric 必填 color；lining 必填 composition）；面料色号行填 fabricMaterialId；删前 material.bound_orders。
 
-【制单】create_from_order（成功后订单强制 po_drafting）→ 补交期等 → check（校验面料/色卡物料）→ submit_review → issue；辅料工艺只读，来自订单 style_save 已选面料与 colorCardJson，一般不调 save_items。
+【制单·暂不用】前端「制单中心」菜单已隐藏；勿主动 production.create_from_order / check / submit_review / issue。API 仍保留，仅用户明确要求时再动。
 
 【权限】无权限 action 会报错；以 yindie://erp/modules 返回的 actions 为准。`;
 /** 合并工具用法资源 */
@@ -792,7 +826,7 @@ export const ERP_USAGE_GUIDE = {
     domains: {
         erp_workbench: {
             actions: ['summary', 'current_user', 'merchandiser_options', 'user_options'],
-            note: '入口，优先 summary；建单/分派前 merchandiser_options 取 assigneeId；任务负责人用 user_options'
+            note: '入口，优先 summary；建订单客户前 merchandiser_options 取 assigneeId；任务负责人用 user_options'
         },
         erp_customer: {
             actions: ['customer.*', 'contact.*', 'address.*', 'brand.*'],
@@ -805,13 +839,20 @@ export const ERP_USAGE_GUIDE = {
         },
         erp_order: {
             actions: [
+                'customer_list',
+                'customer_add',
+                'customer_edit',
+                'customer_remove',
+                'season_list',
+                'season_add',
+                'season_edit',
+                'season_remove',
                 'list',
                 'get',
                 'add',
                 'edit',
                 'remove',
                 'change_status',
-                'assign',
                 'link_pi',
                 'copy',
                 'style_list',
@@ -821,6 +862,8 @@ export const ERP_USAGE_GUIDE = {
                 'craft_save',
                 'craft_export',
                 'size_chart_save',
+                'size_chart_logs',
+                'size_chart_export',
                 'color_card_list',
                 'color_card_save',
                 'color_card_export',
@@ -839,7 +882,7 @@ export const ERP_USAGE_GUIDE = {
                 'attachment_export',
                 'attachment_remove'
             ],
-            note: 'style_save 成功后返回 styles 含 styleId；craft_save 需 styleId；craft_export/color_card_export/attachment_export 返回本机落盘路径，前两者 archive=true 才写订单附件'
+            note: '建订单前 customer_list→season_list 取 seasonId；style_save 只传主款；sample_add 克隆轮次；尺寸表按主款/克隆款 styleNo；craft_export 可带 qtyType；导出类 archive=true 才写附件'
         },
         erp_production: {
             actions: [
@@ -859,7 +902,7 @@ export const ERP_USAGE_GUIDE = {
                 'reject_review',
                 'issue'
             ],
-            note: 'create_from_order 用 orderId，成功后订单→po_drafting；issue 需 reviewing 且 issue 权限'
+            note: '【暂不用】制单中心菜单已隐藏，勿主动调用；create_from_order 用 orderId，成功后订单→po_drafting；issue 需 reviewing 且 issue 权限'
         },
         erp_task: { actions: ['list', 'get', 'add', 'edit', 'remove'] },
         erp_material: {
@@ -911,7 +954,7 @@ export const ERP_USAGE_GUIDE = {
                                     colorCode: '物料色号',
                                     colorName: '颜色名称（必填）',
                                     colorCardJson: '{"lining":{"materialCode":"LIN-01","materialName":"里布","titleCn":"里布"}}',
-                                    sizes: [{ sizeName: 'M', qty: 120 }]
+                                    sizes: [{ sizeName: 'M', qty: 120, cutQty: 125, actualQty: 118 }]
                                 }
                             ]
                         }
@@ -920,11 +963,19 @@ export const ERP_USAGE_GUIDE = {
             }
         },
         {
-            intent: '导出工艺单/色卡',
-            call: { tool: 'erp_order', action: 'craft_export', styleId: '字符串' }
+            intent: '导出工艺单（裁剪单数量）',
+            call: { tool: 'erp_order', action: 'craft_export', styleId: '字符串', qtyType: 'cut' }
+        },
+        {
+            intent: '导出尺寸表',
+            call: { tool: 'erp_order', action: 'size_chart_export', styleId: '字符串', orderId: '字符串' }
+        },
+        {
+            intent: '查尺寸表变更记录',
+            call: { tool: 'erp_order', action: 'size_chart_logs', styleId: '字符串' }
         },
         {
-            intent: '从订单生成生产单',
+            intent: '从订单生成生产单【暂不用：制单中心已隐藏】',
             call: { tool: 'erp_production', action: 'create_from_order', orderId: '字符串' }
         },
         {
@@ -963,7 +1014,6 @@ export const ERP_USAGE_GUIDE = {
     ])),
     payloadByWorkflow: {
         '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,
@@ -972,6 +1022,8 @@ export const ERP_USAGE_GUIDE = {
         '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.size_chart_logs': READ_META.erp_order_style_size_chart_logs,
+        'order.size_chart_export': READ_META.erp_order_style_size_chart_export,
         '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,

package/dist/tools-merged.js

@@ -82,13 +82,20 @@ const DOMAIN_TEMPLATES = [
         summary: '【订单管理】订单 CRUD、状态、款式工艺、轮次、附件',
         hasTarget: false,
         routes: {
+            customer_list: { oldName: 'erp_order_customer_list' },
+            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' },
             edit: { oldName: 'erp_order_edit' },
             remove: { oldName: 'erp_order_remove' },
             change_status: { oldName: 'erp_order_change_status' },
-            assign: { oldName: 'erp_order_assign' },
             link_pi: { oldName: 'erp_order_link_pi' },
             copy: { oldName: 'erp_order_copy' },
             style_list: { oldName: 'erp_order_style_list' },
@@ -98,6 +105,8 @@ const DOMAIN_TEMPLATES = [
             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' },
+            size_chart_logs: { oldName: 'erp_order_style_size_chart_logs' },
+            size_chart_export: { oldName: 'erp_order_style_size_chart_export' },
             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' },
@@ -119,7 +128,7 @@ const DOMAIN_TEMPLATES = [
     },
     {
         name: 'erp_production',
-        summary: '【生产管理】生产单 CRUD、工艺、校验审核下发；辅料只读来自订单款式配置',
+        summary: '【生产管理·暂不用】制单中心已隐藏；勿主动建单/校验/下发；辅料只读来自订单款式配置',
         hasTarget: false,
         routes: {
             list: { oldName: 'erp_production_list' },
@@ -341,13 +350,15 @@ function inputSchemaFor(tpl, allowed) {
             ...base,
             orderNo: z.string().optional().describe('订单号'),
             orderId: optionalId.describe('订单 ID'),
-            styleId: optionalId.describe('款式 ID（craft_get 必填）'),
+            styleId: optionalId.describe('款式 ID；craft_get/size_chart_logs/size_chart_export 必填'),
             customerId: optionalId.describe('客户 ID'),
             brandId: optionalId.describe('品牌 ID'),
             bizLine: z.string().optional().describe('业务线 direct/trader'),
             orderStatus: z.string().optional().describe('订单状态'),
-            assigneeId: optionalId.describe('跟单员 ID'),
-            fileName: z.string().optional().describe('导出类 action：落盘文件名'),
+            orderCustomerId: optionalId.describe('订单客户 ID（season_list 必填）'),
+            qtyType: z.string().optional().describe('craft_export：prod/cut/actual，默认 prod'),
+            sizeChartJson: z.string().optional().describe('size_chart_export：入库视图 JSON；可省略则靠 orderId+styleId 回查'),
+            fileName: z.string().optional().describe('导出类：仅文件名，落盘临时目录/yindie-erp-exports'),
             archive: z.boolean().optional().describe('导出类 action：true 归档到订单附件'),
             ossId: optionalId.describe('OSS 文件 ID（attachment_export 必填）')
         };

package/dist/tools-write.js

@@ -1,7 +1,7 @@
 import { readFile } from 'node:fs/promises';
 import { basename } from 'node:path';
 import { z } from 'zod';
-import { idField, idsField, normalizeCraftSavePayload, parseIds, parsePayload } from './tool-helpers.js';
+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) {
@@ -55,6 +55,8 @@ export const WRITE_TOOLS = [
     ...entityCrud('erp_customer_brand', '/erp/customer/brand', 'erp:customer'),
     ...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'),
@@ -68,12 +70,20 @@ export const WRITE_TOOLS = [
     workflowTool('erp_bid_close', 'erp:bid:edit', { id: idField.describe('招标 ID，需 collecting') }, (client, args) => client.put(`/erp/bid/close/${args.id}`)),
     workflowTool('erp_bid_award', 'erp:bid:edit', { payload: z.string().describe(WORKFLOW_META.erp_bid_award.payload) }, (client, args) => client.put('/erp/bid/award', parsePayload(args))),
     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) => client.put('/erp/order/status', parsePayload(args))),
-    workflowTool('erp_order_assign', 'erp:order:assign', { payload: z.string().describe(WORKFLOW_META.erp_order_assign.payload) }, (client, args) => client.put('/erp/order/assign', parsePayload(args))),
+    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) {
+            const topId = args.id ?? args.orderId;
+            if (topId != null && topId !== '') {
+                payload.id = String(topId);
+            }
+        }
+        return client.put('/erp/order/status', payload);
+    }),
     workflowTool('erp_order_link_pi', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_link_pi.payload) }, (client, args) => client.put('/erp/order/pi/link', parsePayload(args))),
     workflowTool('erp_order_copy', 'erp:order:add', { payload: z.string().describe(WORKFLOW_META.erp_order_copy.payload) }, (client, args) => client.post('/erp/order/copy', parsePayload(args))),
     workflowTool('erp_order_style_save', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_style_save.payload) }, async (client, args) => {
-        const payload = parsePayload(args);
+        const payload = normalizeStyleSavePayload(parsePayload(args));
         const result = await client.post('/erp/order/style/save', payload);
         const orderId = payload.orderId == null ? undefined : String(payload.orderId);
         if (!orderId) {
@@ -89,8 +99,8 @@ export const WRITE_TOOLS = [
     workflowTool('erp_order_style_size_chart_save', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_style_size_chart_save.payload) }, (client, args) => client.post('/erp/order/style/size-chart', parsePayload(args))),
     workflowTool('erp_order_style_color_card_save', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_style_color_card_save.payload) }, (client, args) => client.post('/erp/order/style/color-card/save', parsePayload(args))),
     workflowTool('erp_production_craft_save', 'erp:production:edit', { payload: z.string().describe(WORKFLOW_META.erp_production_craft_save.payload) }, (client, args) => client.post('/erp/production/craft/save', normalizeCraftSavePayload(parsePayload(args)))),
-    workflowTool('erp_order_sample_add', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_sample_add.payload) }, (client, args) => client.post('/erp/order/sample', parsePayload(args))),
-    workflowTool('erp_order_sample_edit', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_sample_edit.payload) }, (client, args) => client.put('/erp/order/sample', parsePayload(args))),
+    workflowTool('erp_order_sample_add', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_sample_add.payload) }, (client, args) => client.post('/erp/order/sample', normalizeSamplePayload(parsePayload(args)))),
+    workflowTool('erp_order_sample_edit', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_sample_edit.payload) }, (client, args) => client.put('/erp/order/sample', normalizeSamplePayload(parsePayload(args)))),
     workflowTool('erp_order_sample_change_status', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_sample_change_status.payload) }, (client, args) => client.put('/erp/order/sample/status', parsePayload(args))),
     workflowTool('erp_order_sample_remove', 'erp:order:remove', { ids: idsField }, (client, args) => client.delete(`/erp/order/sample/${parseIds(args)}`)),
     workflowTool('erp_order_shipment_add', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_shipment_add.payload) }, (client, args) => client.post('/erp/order/shipment', parsePayload(args))),

package/dist/tools.js

@@ -62,7 +62,7 @@ const READ_TOOLS = [
     },
     {
         name: 'erp_merchandiser_options',
-        description: '查询跟单员下拉选项（userId/userName/nickName），建单/分派前取 assigneeId',
+        description: '查询跟单员下拉选项（userId/userName/nickName），建订单客户前取 assigneeId',
         permission: null,
         inputSchema: {},
         handler: (client) => client.get('/erp/common/merchandiserOptions')
@@ -215,22 +215,50 @@ const READ_TOOLS = [
         inputSchema: {
             ...pageShape,
             orderNo: z.string().optional().describe('订单号'),
+            seasonId: optionalId.describe('季度 ID，字符串'),
             customerId: optionalId.describe('客户 ID，字符串'),
             brandId: optionalId.describe('品牌 ID，字符串'),
             bizLine: z.string().optional().describe('业务线 direct/trader'),
-            orderStatus: z.string().optional().describe('订单状态'),
-            assigneeId: optionalId.describe('跟单员 ID，字符串')
+            orderStatus: z.string().optional().describe('订单状态')
         },
         handler: (client, args) => client.get('/erp/order/list', {
             ...pageParams(args),
             orderNo: args.orderNo,
+            seasonId: asId(args.seasonId),
             customerId: asId(args.customerId),
             brandId: asId(args.brandId),
             bizLine: args.bizLine,
-            orderStatus: args.orderStatus,
-            assigneeId: asId(args.assigneeId)
+            orderStatus: args.orderStatus
         })
     },
+    {
+        name: 'erp_order_customer_list',
+        description: '分页查询订单客户，跟单员挂在这一层',
+        permission: 'erp:order:list',
+        inputSchema: {
+            ...pageShape,
+            customerId: optionalId.describe('客户 ID，字符串'),
+            bizLine: z.string().optional().describe('业务线 direct/trader'),
+            orderNo: z.string().optional().describe('订单号'),
+            orderStatus: z.string().optional().describe('订单状态')
+        },
+        handler: (client, args) => client.get('/erp/order/customer/list', {
+            ...pageParams(args),
+            customerId: asId(args.customerId),
+            bizLine: args.bizLine,
+            orderNo: args.orderNo,
+            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 查询订单详情',
@@ -242,7 +270,7 @@ const READ_TOOLS = [
     },
     {
         name: 'erp_order_style_list',
-        description: '查询订单款式及颜色尺码、结构化工艺、商标位置；orderId 或 orderNo 二选一，ID 必须字符串',
+        description: '查询订单主款式树（含 colors/sizes/crafts/商标；轮次克隆挂在 roundStyles）；orderId 或 orderNo 二选一，ID 必须字符串',
         permission: 'erp:order:query',
         inputSchema: {
             orderId: optionalId.describe('订单 ID，字符串雪花 ID'),
@@ -282,16 +310,74 @@ const READ_TOOLS = [
     },
     {
         name: 'erp_order_style_craft_export',
-        description: '按 styleId 导出工艺单 Excel 到本机并返回落盘路径；默认 preview 不写附件，archive=true 才归档到订单附件',
+        description: '按 styleId 导出工艺单 Excel 到本机并返回落盘路径；qtyType=prod|cut|actual 取尺码数量；默认 preview 不写附件，archive=true 才归档',
         permission: 'erp:order:query',
         inputSchema: {
             styleId: idField.describe('款式 ID，字符串'),
-            fileName: z.string().optional().describe('落盘文件名，默认 craft-<styleId>.xlsx'),
+            qtyType: z.string().optional().describe('数量类型 prod生产单/cut裁剪单/actual实际单，默认 prod'),
+            fileName: z
+                .string()
+                .optional()
+                .describe('仅文件名（忽略目录），默认 craft-<styleId>.xlsx，落盘临时目录/yindie-erp-exports'),
             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 } });
+            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 } });
+        }
+    },
+    {
+        name: 'erp_order_style_size_chart_logs',
+        description: '按 styleId 查尺寸表变更记录（快照列表，含 sizeChartJson）；styleId 必填',
+        permission: 'erp:order:query',
+        inputSchema: {
+            styleId: idField.describe('款式 ID，必填字符串（主款或轮次克隆）')
+        },
+        handler: (client, args) => client.get('/erp/order/style/size-chart/logs', { styleId: asId(args.styleId) })
+    },
+    {
+        name: 'erp_order_style_size_chart_export',
+        description: '导出尺寸表 Excel；styleId 必填；可传 sizeChartJson，或 orderId 从 style_list 回查；fileName 仅文件名（落盘临时目录）；archive=true 写附件',
+        permission: 'erp:order:query',
+        inputSchema: {
+            styleId: idField.describe('款式 ID，必填字符串'),
+            orderId: optionalId.describe('订单 ID；未传 sizeChartJson 时用于回查'),
+            sizeChartJson: z.string().optional().describe('入库视图 JSON 字符串；可省略则从 style_list 取'),
+            fileName: z
+                .string()
+                .optional()
+                .describe('仅文件名（忽略目录），落盘到系统临时目录/yindie-erp-exports'),
+            archive: z.boolean().optional().describe('true 时写入订单附件，需 erp:order:export 权限')
+        },
+        handler: async (client, args) => {
+            const styleId = asId(args.styleId);
+            if (!styleId) {
+                throw new Error('size_chart_export 须传 styleId（字符串）');
+            }
+            let view = undefined;
+            if (typeof args.sizeChartJson === 'string' && args.sizeChartJson) {
+                view = JSON.parse(args.sizeChartJson);
+            }
+            let parentCount = 0;
+            let roundCount = 0;
+            if (view == null) {
+                const orderId = asId(args.orderId);
+                if (!orderId) {
+                    throw new Error('缺少 sizeChartJson；或同时传 orderId 从 style_list 自动取');
+                }
+                const styles = (await client.get('/erp/order/style/list', { orderId }));
+                parentCount = styles.length;
+                roundCount = styles.reduce((n, s) => n + (s.roundStyles?.length || 0), 0);
+                const hit = styles.find((s) => asId(s.id) === styleId) ||
+                    styles.flatMap((s) => s.roundStyles || []).find((s) => asId(s.id) === styleId);
+                const raw = hit?.sizeChartJson;
+                view = typeof raw === 'string' ? JSON.parse(raw) : raw;
+            }
+            if (view == null) {
+                throw new Error(`未找到尺寸表视图（styleId=${styleId}，主款${parentCount}、轮次克隆${roundCount}）；请先 size_chart_save 或传入 sizeChartJson`);
+            }
+            return client.download('POST', args.archive ? '/erp/order/style/size-chart/export-excel' : '/erp/order/style/size-chart/preview-excel', args.fileName ?? `size-chart-${styleId}.xlsx`, { body: { styleId, sizeChartJson: view } });
         }
     },
     {
@@ -360,7 +446,7 @@ const READ_TOOLS = [
     },
     {
         name: 'erp_order_sample_list',
-        description: '查询订单轮次（可为空，可不建轮次）',
+        description: '查询订单轮次（含 styleId 主款、roundStyleId 克隆款、priority；可不建轮次）',
         permission: 'erp:order:query',
         inputSchema: {
             orderId: idField.describe('订单 ID，字符串')

package/package.json

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