yindie-erp-mcp 2.0.4 → 2.0.6

package/dist/client.js

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

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

package/dist/craft/template.js

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

package/dist/tool-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)) {