intonear-erp-cli 0.2.1 → 0.2.4

package/dist/bin.js

@@ -14520,7 +14520,7 @@ function date4(params) {
 config(en_default());
 
 // ../../packages/contracts/dist/agent-context.js
-var erpDomainModelVersion = "2026-09-02";
+var erpDomainModelVersion = "2026-09-03";
 var erpCompletenessRulesVersion = "2026-09-01";
 var erpDomainTopics = [
   {
@@ -14536,12 +14536,12 @@ var erpDomainTopics = [
   {
     topic: "BUSINESS_CODE_SYSTEM",
     title: "\u4E1A\u52A1\u7F16\u7801\u4F53\u7CFB",
-    summary: "PR\u3001PS\u3001PK\u3001UM \u4E1A\u52A1\u7F16\u7801\u4E0E\u6570\u636E\u5E93\u5185\u90E8 ID \u7684\u533A\u522B\u3002"
+    summary: "PR\u3001PS\u3001PK\u3001MANUAL \u4E1A\u52A1\u7F16\u7801\u4E0E\u6570\u636E\u5E93\u5185\u90E8 ID \u7684\u533A\u522B\u3002"
   },
   {
     topic: "FILES",
     title: "\u6587\u4EF6\u4E0E\u4EA7\u54C1\u8D44\u6599",
-    summary: "FileAsset\u3001\u4E0D\u53EF\u53D8 FileVersion\u3001\u4EA7\u54C1\u56FE\u7247\u5F52\u5C5E\u548C\u5F53\u524D\u4E0A\u4F20\u80FD\u529B\u3002"
+    summary: "FileAsset\u3001\u4E0D\u53EF\u53D8 FileVersion\u3001\u4EA7\u54C1\u56FE\u7247\u4E0E\u7528\u6237\u8BF4\u660E\u4E66\u7684\u5F53\u524D\u4E0A\u4F20\u80FD\u529B\u3002"
   },
   {
     topic: "DEVELOPMENT_WORK_LIST",
@@ -14587,16 +14587,18 @@ var overviewContent = {
     readOnly: false,
     available: [
       "\u641C\u7D22 Product\u3001ProductSpec\u3001Pack \u4E3B\u6570\u636E\u5173\u7CFB",
-      "\u6309\u5B8C\u6574 PR\u3001PS\u3001PK \u4E1A\u52A1\u7F16\u7801\u8BFB\u53D6\u4E3B\u6570\u636E\u5173\u7CFB",
+      "\u6309\u5B8C\u6574 PR\u3001PS\u3001PK\u3001MANUAL \u4E1A\u52A1\u7F16\u7801\u8BFB\u53D6\u4E3B\u6570\u636E",
       "\u5206\u9875\u67E5\u8BE2\u5F00\u53D1\u5DE5\u4F5C\u6E05\u5355",
       "\u8BFB\u53D6\u5F00\u53D1\u5DE5\u4F5C\u6E05\u5355\u53CA\u5B9E\u65F6\u8D44\u6599\u5B8C\u6574\u5EA6",
       "\u5206\u9875\u8BFB\u53D6\u5F00\u53D1\u5DE5\u4F5C\u6E05\u5355\u64CD\u4F5C\u8BB0\u5F55",
       "\u521B\u5EFA\u53CA\u66F4\u65B0 Product\u3001ProductSpec\u3001Pack",
       "\u7EF4\u62A4 ProductSpec\u2014Pack \u6620\u5C04",
       "\u521B\u5EFA\u5F00\u53D1\u5DE5\u4F5C\u6E05\u5355\u5E76\u6267\u884C\u539F\u5B50\u8BED\u4E49\u547D\u4EE4",
-      "\u4E3A ProductSpec \u4E0A\u4F20\u5E76\u5173\u8054\u4EA7\u54C1\u56FE\u7247"
+      "\u4E3A Product \u4E0A\u4F20\u5E76\u5173\u8054\u4EA7\u54C1\u56FE\u7247",
+      "\u4E3A UserManual \u4E0A\u4F20\u5E76\u8BBE\u7F6E\u5F53\u524D PDF",
+      "CLI \u53EF\u8BFB\u53D6\u5E76\u7EF4\u62A4 ProductSpec\u2014UserManual \u9002\u7528\u5173\u7CFB"
     ],
-    unavailable: ["\u91C7\u8D2D\u67E5\u8BE2", "\u7269\u6D41\u67E5\u8BE2", "\u8BA2\u5355\u67E5\u8BE2", "Agent \u7528\u6237\u8BF4\u660E\u4E66\u4E0E\u5176\u4ED6\u8D44\u6599\u9644\u4EF6\u7EF4\u62A4"]
+    unavailable: ["\u91C7\u8D2D\u67E5\u8BE2", "\u7269\u6D41\u67E5\u8BE2", "\u8BA2\u5355\u67E5\u8BE2", "\u4F9B\u5E94\u5546\u3001\u5C01\u6837\u4E0E Pack \u8D44\u6599\u9644\u4EF6\u7EF4\u62A4"]
   },
   permissionSemantics: {
     enforced: "\u8C03\u7528\u8EAB\u4EFD\u5FC5\u987B\u901A\u8FC7\u8BA4\u8BC1\u4E14 resource \u5339\u914D MCP\uFF1B\u6BCF\u4E2A\u5DE5\u5177\u5206\u522B\u6821\u9A8C erp:read \u6216 erp:write\u3002",
@@ -14604,7 +14606,7 @@ var overviewContent = {
     failures: "\u8BA4\u8BC1\u3001scope \u6216 resource \u5931\u8D25\u5728 HTTP \u5C42\u62D2\u7EDD\uFF1B\u7CBE\u786E\u67E5\u8BE2\u65E0\u7ED3\u679C\u53EA\u8FD4\u56DE\u901A\u7528 NOT_FOUND\u3002"
   },
   routing: [
-    "\u5DF2\u77E5\u5B8C\u6574 PR\u3001PS\u3001PK \u4E1A\u52A1\u7F16\u7801\u65F6\u4F7F\u7528\u7CBE\u786E\u4E3B\u6570\u636E\u67E5\u8BE2\u3002",
+    "\u5DF2\u77E5\u5B8C\u6574 PR\u3001PS\u3001PK \u4E1A\u52A1\u7F16\u7801\u65F6\u4F7F\u7528\u4EA7\u54C1\u4E3B\u6570\u636E\u7CBE\u786E\u67E5\u8BE2\uFF1B\u5DF2\u77E5\u5B8C\u6574 ManualCode \u65F6\u8BFB\u53D6 UserManual\u3002",
     "\u53EA\u6709\u540D\u79F0\u6216 Supplier \u65F6\u4F7F\u7528\u4EA7\u54C1\u4E3B\u6570\u636E\u641C\u7D22\uFF1B\u5F53\u524D\u641C\u7D22\u4E0D\u652F\u6301\u90E8\u5206 PR\u3001PS\u3001PK \u7F16\u7801\u3002",
     "\u8D44\u6599\u5B8C\u6574\u5EA6\u4EE5\u5F00\u53D1\u5DE5\u4F5C\u6E05\u5355\u8BE6\u60C5\u4E2D\u7684\u5B9E\u65F6\u8BA1\u7B97\u7ED3\u679C\u4E3A\u51C6\uFF0C\u4E0D\u6309\u5B57\u6BB5\u6570\u91CF\u81EA\u884C\u63A8\u7B97\u3002",
     "\u53EA\u9009\u62E9 MCP tools/list \u6216 CLI list \u5B9E\u9645\u5217\u51FA\u7684\u80FD\u529B\u3002",
@@ -14618,13 +14620,13 @@ var productMasterDataContent = {
       entityType: "PRODUCT",
       name: "Product",
       businessIdentity: "ProductCode\uFF08PR \u4E1A\u52A1\u7F16\u7801\uFF09",
-      definition: "\u9762\u5411\u7528\u6237\u7684\u4EA7\u54C1\u65CF\uFF0C\u4FDD\u5B58\u4EA7\u54C1\u540D\u79F0\u3002"
+      definition: "\u9762\u5411\u7528\u6237\u7684\u9500\u552E SKU \u53D8\u4F53\uFF0C\u4FDD\u5B58\u540D\u79F0\u3001\u54C1\u724C\u3001\u989C\u8272\u3001\u76EE\u6807\u5E02\u573A\u548C\u987E\u5BA2\u53EF\u89C1\u5C3A\u5BF8\u3002"
     },
     {
       entityType: "PRODUCT_SPEC",
       name: "ProductSpec",
       businessIdentity: "ProductSpecCode\uFF08PS \u4E1A\u52A1\u7F16\u7801\uFF09",
-      definition: "Product \u7684\u5177\u4F53\u53EF\u552E\u4E0E\u5185\u90E8\u5B9E\u73B0\u89C4\u683C\u3002"
+      definition: "\u987E\u5BA2\u4E0D\u611F\u77E5\u7684\u5185\u90E8\u5B9E\u73B0\u65B9\u6848\uFF1B\u540C\u4E00 Product \u4E0B\u53EA\u5141\u8BB8\u7EC6\u5FAE\u7ED3\u6784\u6216\u4F9B\u5E94\u5B9E\u73B0\u5DEE\u5F02\u3002"
     },
     {
       entityType: "PACK",
@@ -14635,7 +14637,7 @@ var productMasterDataContent = {
     {
       entityType: "USER_MANUAL",
       name: "UserManual",
-      businessIdentity: "ManualCode\uFF08UM \u4E1A\u52A1\u7F16\u7801\uFF09",
+      businessIdentity: "ManualCode\uFF08MANUAL \u4E1A\u52A1\u7F16\u7801\uFF09",
       definition: "\u53EF\u88AB\u591A\u4E2A ProductSpec \u590D\u7528\u7684\u5BA2\u6237\u7EC4\u88C5\u3001\u4F7F\u7528\u6216\u5B89\u5168\u8BF4\u660E\u8D44\u6599\u3002"
     },
     {
@@ -14673,6 +14675,7 @@ var productMasterDataContent = {
   ],
   rules: [
     "Product\u3001ProductSpec\u3001Pack \u548C UserManual \u521B\u5EFA\u540E\u7ACB\u5373\u53EF\u7528\uFF0C\u4E0D\u8BBE\u751F\u547D\u5468\u671F\u72B6\u6001\u3002",
+    "\u54C1\u724C\u3001\u989C\u8272\u6216\u987E\u5BA2\u53EF\u89C1\u5C3A\u5BF8\u53D8\u5316\u5C5E\u4E8E\u65B0\u7684 Product\uFF1BProductSpec \u4E0D\u62E5\u6709\u8FD9\u4E9B\u9500\u552E\u8EAB\u4EFD\u5B57\u6BB5\u3002",
     "\u8D44\u6599\u5B8C\u6574\u5EA6\u53EA\u63D0\u793A\u5F85\u8865\u8D44\u6599\uFF0C\u4E0D\u963B\u65AD\u4EA7\u54C1\u4E3B\u6570\u636E\u67E5\u8BE2\u6216\u4F7F\u7528\u3002",
     "\u4E1A\u52A1\u7F16\u7801\u53EA\u6807\u8BC6\u5BF9\u8C61\u7C7B\u578B\u548C\u8EAB\u4EFD\uFF0C\u4E0D\u627F\u8F7D\u54C1\u7C7B\u3001\u4F9B\u5E94\u5546\u3001\u6E20\u9053\u6216\u7248\u672C\u542B\u4E49\u3002"
   ]
@@ -14703,9 +14706,10 @@ var businessCodeSystemContent = {
     {
       entity: "UserManual",
       field: "ManualCode",
-      prefix: "UM",
-      pattern: "^UM\\d{5,}$",
-      example: "UM00001"
+      prefix: "MANUAL",
+      pattern: "^MANUAL\\d{3,}$",
+      example: "MANUAL001",
+      acceptedLegacyPattern: "^UM\\d{5,}$"
     }
   ],
   rules: [
@@ -14732,7 +14736,7 @@ var developmentWorkListContent = {
     "\u5DE5\u4F5C\u6E05\u5355\u4E0D\u62E5\u6709\u4EA7\u54C1\u4E3B\u6570\u636E\uFF0C\u4E0D\u6539\u53D8 Product\u3001ProductSpec \u6216 Pack \u7684\u53EF\u7528\u6027\u3002",
     "\u5DE5\u4F5C\u6E05\u5355\u6CA1\u6709\u63D0\u4EA4\u3001\u64A4\u56DE\u3001\u8BC4\u5BA1\u3001\u8FDB\u5EA6\u6216\u9501\u5B9A\u72B6\u6001\u3002",
     "\u5DE5\u4F5C\u6E05\u5355\u8BE6\u60C5\u8FD4\u56DE\u6210\u5458\u5BF9\u5E94\u4E3B\u6570\u636E\u7684\u5B9E\u65F6\u6295\u5F71\uFF0C\u800C\u4E0D\u662F\u5386\u53F2\u5FEB\u7167\u3002",
-    "\u5B9E\u65F6\u5B8C\u6574\u5EA6\u53EA\u8BA1\u7B97\u5DE5\u4F5C\u6E05\u5355\u4E2D\u663E\u5F0F\u5305\u542B\u7684 ProductSpec\u3002"
+    "\u5B9E\u65F6\u5B8C\u6574\u5EA6\u53EA\u8BA1\u7B97\u5DE5\u4F5C\u6E05\u5355\u4E2D\u663E\u5F0F\u5305\u542B\u7684 Product \u4E0E ProductSpec\u3002"
   ]
 };
 var filesContent = {
@@ -14747,22 +14751,32 @@ var filesContent = {
     }
   ],
   productImages: {
-    owner: "ProductSpec",
-    relationship: "\u4E00\u4E2A ProductSpec \u53EF\u5173\u8054\u591A\u5F20\u4EA7\u54C1\u56FE\u7247\uFF1B\u540C\u4E00 FileVersion \u4E0D\u91CD\u590D\u5173\u8054\u3002",
+    owner: "Product",
+    relationship: "\u4E00\u4E2A Product \u53EF\u5173\u8054\u591A\u5F20\u4EA7\u54C1\u56FE\u7247\uFF1B\u540C\u4E00 FileVersion \u4E0D\u91CD\u590D\u5173\u8054\u3002",
     acceptedTypes: ["JPG", "JPEG", "PNG", "WEBP"],
     maxSizeBytes: 50 * 1024 * 1024,
-    effect: "\u65B0\u589E\u56FE\u7247\u4F1A\u5F71\u54CD\u5305\u542B\u8BE5 ProductSpec \u7684\u5F00\u53D1\u5DE5\u4F5C\u6E05\u5355\u5B9E\u65F6\u5B8C\u6574\u5EA6\u3002"
+    effect: "\u65B0\u589E\u56FE\u7247\u4F1A\u5F71\u54CD\u663E\u5F0F\u5305\u542B\u8BE5 Product \u7684\u5F00\u53D1\u5DE5\u4F5C\u6E05\u5355\u5B9E\u65F6\u5B8C\u6574\u5EA6\u3002"
   },
-  agentCapability: "\u5F53\u524D Agent \u53EA\u5F00\u653E\u65B0\u589E ProductSpec \u4EA7\u54C1\u56FE\u7247\uFF1B\u7528\u6237\u8BF4\u660E\u4E66\u3001\u4F9B\u5E94\u5546\u8D44\u6599\u3001\u5C01\u6837\u8D44\u6599\u548C Pack \u6587\u4EF6\u7B49\u5F85\u5404\u81EA\u9886\u57DF\u5DE5\u5177\u5F00\u653E\u540E\u4F7F\u7528\u3002"
+  userManuals: {
+    owner: "UserManual",
+    relationship: "\u4E00\u4E2A UserManual \u7EF4\u62A4\u4E00\u4E2A\u5F53\u524D PDF FileVersion\uFF0C\u5E76\u53EF\u88AB\u591A\u4E2A ProductSpec \u590D\u7528\u3002",
+    acceptedTypes: ["PDF"],
+    maxSizeBytes: 50 * 1024 * 1024,
+    effect: "\u66F4\u65B0\u5F53\u524D PDF \u4F1A\u5F71\u54CD\u5173\u8054\u8BE5 UserManual \u7684 ProductSpec \u5B9E\u65F6\u5B8C\u6574\u5EA6\u3002"
+  },
+  agentCapability: "\u5F53\u524D MCP \u4E0E CLI \u5F00\u653E Product \u4EA7\u54C1\u56FE\u7247\u53CA UserManual \u5F53\u524D PDF \u4E0A\u4F20\uFF1BCLI \u53E6\u5F00\u653E ProductSpec\u2014UserManual \u9002\u7528\u5173\u7CFB\u8BFB\u53D6\u4E0E\u7EF4\u62A4\u3002"
 };
 var completenessRulesContent = {
   projectionType: "REALTIME_NON_BLOCKING",
   rulesVersion: erpCompletenessRulesVersion,
   completeMeaning: "complete=true \u4EC5\u8868\u793A\u5F53\u524D\u6CA1\u6709\u8D44\u6599\u5F85\u8865\u63D0\u793A\uFF0C\u4E0D\u8868\u793A\u5DF2\u6279\u51C6\u6216\u9501\u5B9A\u3002",
-  evaluatedEntity: "\u5DE5\u4F5C\u6E05\u5355\u4E2D\u663E\u5F0F\u5305\u542B\u7684 ProductSpec",
+  evaluatedEntity: "\u5DE5\u4F5C\u6E05\u5355\u4E2D\u663E\u5F0F\u5305\u542B\u7684 Product \u4E0E ProductSpec",
   checks: [
     { code: "MISSING_PACK_MAPPING", condition: "\u672A\u5173\u8054\u4EFB\u4F55 Pack" },
-    { code: "MINIMUM_PRODUCT_IMAGES_NOT_MET", condition: "\u6709\u6548\u4EA7\u54C1\u56FE\u7247\u5C11\u4E8E 3 \u5F20" },
+    {
+      code: "MINIMUM_PRODUCT_IMAGES_NOT_MET",
+      condition: "\u663E\u5F0F\u5305\u542B\u7684 Product \u6709\u6548\u4EA7\u54C1\u56FE\u7247\u5C11\u4E8E 3 \u5F20"
+    },
     { code: "MISSING_PRODUCT_SPEC_USER_MANUAL", condition: "\u672A\u5173\u8054\u4EFB\u4F55 UserManual" },
     {
       code: "USER_MANUAL_FILE_MISSING",
@@ -14825,12 +14839,22 @@ var changelogContent = {
   entries: [
     {
       version: erpDomainModelVersion,
+      releasedAt: "2026-09-03",
+      compatibility: "ADDITIVE",
+      changes: [
+        "MCP \u4E0E CLI \u589E\u52A0 UserManual \u7CBE\u786E\u8BFB\u53D6\u4E0E\u5F53\u524D PDF \u4E0A\u4F20\u80FD\u529B\u3002",
+        "CLI \u589E\u52A0 ProductSpec\u2014UserManual \u9002\u7528\u5173\u7CFB\u8BFB\u53D6\u3001\u5173\u8054\u4E0E\u89E3\u7ED1\u80FD\u529B\u3002",
+        "UserManual \u65B0\u7F16\u7801\u6539\u4E3A MANUAL \u52A0\u81F3\u5C11\u4E09\u4F4D\u6570\u5B57\uFF1B\u65E2\u6709 UM \u7F16\u7801\u7EE7\u7EED\u6709\u6548\u3002"
+      ]
+    },
+    {
+      version: "2026-09-02",
       releasedAt: "2026-09-02",
       compatibility: "ADDITIVE",
       changes: [
         "CLI \u4E0E MCP \u5F00\u653E\u9996\u6279\u4EA7\u54C1\u4E3B\u6570\u636E\u548C\u5F00\u53D1\u5DE5\u4F5C\u6E05\u5355\u5199\u64CD\u4F5C\u3002",
         "\u589E\u52A0 erp:write\u3001\u4E50\u89C2\u5E76\u53D1\u3001\u5E42\u7B49\u952E\u548C\u7834\u574F\u6027\u64CD\u4F5C\u8BED\u4E49\u3002",
-        "MCP \u4E0E CLI \u589E\u52A0 ProductSpec \u4EA7\u54C1\u56FE\u7247\u4E0A\u4F20\u80FD\u529B\u548C\u6587\u4EF6\u9886\u57DF\u4E3B\u9898\u3002"
+        "MCP \u4E0E CLI \u589E\u52A0 Product \u4EA7\u54C1\u56FE\u7247\u4E0A\u4F20\u80FD\u529B\u548C\u6587\u4EF6\u9886\u57DF\u4E3B\u9898\u3002"
       ]
     },
     {
@@ -14894,6 +14918,7 @@ var codeSchema = (prefix, description) => external_exports.string().trim().toUpp
 var productCodeSchema = codeSchema("PR", "\u5B8C\u6574 ProductCode\uFF08PR \u4E1A\u52A1\u7F16\u7801\uFF09\uFF1APR \u5F00\u5934\uFF0C\u7528\u4E8E\u6807\u8BC6 Product\uFF1B\u4E0D\u662F\u6570\u636E\u5E93\u5185\u90E8 ID \u6216\u6E20\u9053 SKU\u3002");
 var productSpecCodeSchema = codeSchema("PS", "\u5B8C\u6574 ProductSpecCode\uFF08PS \u4E1A\u52A1\u7F16\u7801\uFF09\uFF1APS \u5F00\u5934\uFF0C\u7528\u4E8E\u6807\u8BC6 ProductSpec\uFF1B\u4E0D\u662F\u6570\u636E\u5E93\u5185\u90E8 ID \u6216\u6E20\u9053 SKU\u3002");
 var packCodeSchema = codeSchema("PK", "\u5B8C\u6574 PackCode\uFF08PK \u4E1A\u52A1\u7F16\u7801\uFF09\uFF1APK \u5F00\u5934\uFF0C\u7528\u4E8E\u6807\u8BC6 Pack\uFF1B\u4E0D\u662F\u6570\u636E\u5E93\u5185\u90E8 ID \u6216\u6E20\u9053 SKU\u3002");
+var manualCodeSchema = external_exports.string().trim().toUpperCase().regex(/^(?:MANUAL\d{3,}|UM\d{5,})$/).max(32).describe("\u5B8C\u6574 ManualCode\uFF1A\u65B0\u7F16\u7801\u4EE5 MANUAL \u5F00\u5934\u5E76\u5E26\u81F3\u5C11 3 \u4F4D\u6570\u5B57\uFF1B\u65E2\u6709 UM \u7F16\u7801\u7EE7\u7EED\u6709\u6548\u3002\u7528\u4E8E\u6807\u8BC6 UserManual\u3002");
 var internalIdSchema = external_exports.number().int().describe("\u6570\u636E\u5E93\u5185\u90E8\u6807\u8BC6\uFF0C\u4EC5\u7528\u4E8E\u5173\u8054\u5F53\u524D\u8FD4\u56DE\u7ED3\u6784\uFF1B\u4E0D\u662F PR\u3001PS\u3001PK \u7B49\u4E1A\u52A1\u7F16\u7801\u3002");
 var timestampSchema = external_exports.iso.datetime().describe("ISO 8601 UTC \u65F6\u95F4\u6233\u3002");
 var nullableCentimeterSchema = external_exports.number().finite().nullable().describe("\u5C3A\u5BF8\uFF0C\u5355\u4F4D cm\uFF1Bnull \u8868\u793A\u7CFB\u7EDF\u6CA1\u6709\u5DF2\u8BB0\u5F55\u503C\uFF0C\u5F53\u524D\u4E0D\u7EC6\u5206\u5177\u4F53\u7A7A\u503C\u539F\u56E0\u3002");
@@ -14902,6 +14927,14 @@ var productSummarySchema = external_exports.object({
   id: internalIdSchema,
   productCode: productCodeSchema,
   name: external_exports.string(),
+  brand: external_exports.string().nullable(),
+  color: external_exports.string().nullable(),
+  salesMarketCodes: external_exports.array(external_exports.string()),
+  lengthCm: nullableCentimeterSchema,
+  widthCm: nullableCentimeterSchema,
+  fixedHeightCm: nullableCentimeterSchema,
+  minHeightCm: nullableCentimeterSchema,
+  maxHeightCm: nullableCentimeterSchema,
   version: external_exports.number().int(),
   createdAt: timestampSchema,
   updatedAt: timestampSchema
@@ -14922,19 +14955,13 @@ var productSpecSummarySchema = external_exports.object({
   productSpecCode: productSpecCodeSchema,
   productId: internalIdSchema,
   specName: external_exports.string(),
-  brand: external_exports.string().nullable(),
-  color: external_exports.string().nullable(),
-  salesMarketCodes: external_exports.array(external_exports.string()),
-  lengthCm: nullableCentimeterSchema,
-  widthCm: nullableCentimeterSchema,
-  fixedHeightCm: nullableCentimeterSchema,
-  minHeightCm: nullableCentimeterSchema,
-  maxHeightCm: nullableCentimeterSchema,
   netWeightKg: nullableKilogramSchema,
   categorySpec: external_exports.unknown().nullable(),
   categorySpecSchema: external_exports.string().nullable(),
   version: external_exports.number().int(),
   createdAt: timestampSchema,
+  accessUrl: external_exports.string().url().optional(),
+  accessExpiresAt: timestampSchema.optional(),
   updatedAt: timestampSchema,
   sealedSampleConclusion: sealedSampleConclusionSchema,
   packMappings: external_exports.array(external_exports.object({
@@ -14967,9 +14994,28 @@ var packSummarySchema = external_exports.object({
   createdAt: timestampSchema,
   updatedAt: timestampSchema
 }).strict();
+var productImageSchema = external_exports.object({
+  id: external_exports.number().int(),
+  fileVersionId: external_exports.number().int(),
+  fileName: external_exports.string(),
+  mediaType: external_exports.string(),
+  sizeBytes: external_exports.number().int().nullable(),
+  version: external_exports.number().int(),
+  createdAt: timestampSchema,
+  accessUrl: external_exports.string().url().optional(),
+  accessExpiresAt: timestampSchema.optional()
+}).strict();
+var productImagesResponseSchema = external_exports.object({
+  productCode: productCodeSchema,
+  productVersion: external_exports.number().int(),
+  images: external_exports.array(productImageSchema)
+}).strict();
+var productSearchSummarySchema = productSummarySchema.extend({
+  listImage: productImageSchema.nullable().describe("\u4EA7\u54C1\u5217\u8868\u5C55\u793A\u7684\u9996\u5F20\u5173\u8054\u56FE\u7247\uFF1Bnull \u8868\u793A\u5F53\u524D\u6CA1\u6709\u4EA7\u54C1\u56FE\u7247\u3002")
+}).strict();
 var searchProductsResponseSchema = external_exports.object({
   query: external_exports.string(),
-  products: external_exports.array(productSummarySchema),
+  products: external_exports.array(productSearchSummarySchema),
   productSpecs: external_exports.array(productSpecSummarySchema),
   packs: external_exports.array(packSummarySchema),
   supplierGroups: external_exports.array(external_exports.object({
@@ -15080,18 +15126,20 @@ var getPackOperation = defineReadOperation({
 });
 var initialProductSpecInputSchema = external_exports.object({
   specName: external_exports.string().trim().min(1).max(255).optional().describe("\u9996\u4E2A ProductSpec \u7684\u663E\u793A\u540D\u79F0\uFF1B\u7701\u7565\u65F6\u4F7F\u7528 Product \u540D\u79F0\u3002"),
-  brand: external_exports.enum(["intoNear", "intoNir"]).optional().describe("\u53D7\u63A7\u54C1\u724C\u679A\u4E3E\u3002"),
-  color: external_exports.string().trim().min(1).max(120).optional().describe("\u989C\u8272\u63CF\u8FF0\u3002"),
-  salesMarketCodes: external_exports.array(external_exports.enum(["\u7F8E\u56FD", "\u5370\u5EA6", "\u6B27\u76DF", "\u82F1\u56FD"])).min(1).max(4).optional().describe("\u9500\u552E\u5E02\u573A\u4E2D\u6587\u679A\u4E3E\u96C6\u5408\u3002"),
-  lengthCm: external_exports.number().finite().positive().nullable().optional().describe("\u957F\u5EA6\uFF0C\u5355\u4F4D cm\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
-  widthCm: external_exports.number().finite().positive().nullable().optional().describe("\u5BBD\u5EA6\uFF0C\u5355\u4F4D cm\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
-  fixedHeightCm: external_exports.number().finite().positive().nullable().optional().describe("\u56FA\u5B9A\u9AD8\u5EA6\uFF0C\u5355\u4F4D cm\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
-  minHeightCm: external_exports.number().finite().positive().nullable().optional().describe("\u6700\u5C0F\u9AD8\u5EA6\uFF0C\u5355\u4F4D cm\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
-  maxHeightCm: external_exports.number().finite().positive().nullable().optional().describe("\u6700\u5927\u9AD8\u5EA6\uFF0C\u5355\u4F4D cm\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
-  netWeightKg: external_exports.number().finite().positive().nullable().optional().describe("\u51C0\u91CD\uFF0C\u5355\u4F4D kg\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002")
+  netWeightKg: external_exports.number().finite().positive().nullable().optional().describe("\u51C0\u91CD\uFF0C\u5355\u4F4D kg\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
+  categorySpec: external_exports.unknown().nullable().optional().describe("\u987E\u5BA2\u4E0D\u611F\u77E5\u7684\u5185\u90E8\u54C1\u7C7B\u89C4\u683C\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
+  categorySpecSchema: external_exports.string().trim().min(1).max(120).nullable().optional().describe("categorySpec \u4F7F\u7528\u7684\u7ED3\u6784\u7248\u672C\u6807\u8BC6\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002")
 }).strict();
 var createProductInputSchema = external_exports.object({
   name: external_exports.string().trim().min(1).max(255).describe("Product \u9762\u5411\u7528\u6237\u663E\u793A\u7684\u540D\u79F0\u3002"),
+  brand: external_exports.enum(["intoNear", "intoNir"]).optional().describe("\u53D7\u63A7\u54C1\u724C\u679A\u4E3E\u3002"),
+  color: external_exports.string().trim().min(1).max(120).optional().describe("\u989C\u8272\u63CF\u8FF0\u3002"),
+  salesMarketCodes: external_exports.array(external_exports.enum(["\u7F8E\u56FD", "\u5370\u5EA6", "\u6B27\u76DF", "\u82F1\u56FD"])).min(1).max(4).optional().describe("Product \u7684\u76EE\u6807\u9500\u552E\u5E02\u573A\u4E2D\u6587\u679A\u4E3E\u96C6\u5408\u3002"),
+  lengthCm: external_exports.number().finite().positive().nullable().optional(),
+  widthCm: external_exports.number().finite().positive().nullable().optional(),
+  fixedHeightCm: external_exports.number().finite().positive().nullable().optional(),
+  minHeightCm: external_exports.number().finite().positive().nullable().optional(),
+  maxHeightCm: external_exports.number().finite().positive().nullable().optional(),
   initialSpec: initialProductSpecInputSchema.optional().describe("\u53EF\u9009\u7684\u9996\u4E2A ProductSpec \u5B57\u6BB5\uFF1B\u7CFB\u7EDF\u59CB\u7EC8\u4F1A\u540C\u65F6\u521B\u5EFA\u9996\u4E2A ProductSpec\u3002")
 }).strict();
 var createProductResponseSchema = external_exports.object({ product: productSummarySchema, productSpec: productSpecRecordSchema }).strict();
@@ -15100,7 +15148,7 @@ var createProductOperation = defineWriteOperation({
   method: "POST",
   path: "/api/v1/products",
   summary: "\u521B\u5EFA Product \u53CA\u9996\u4E2A ProductSpec",
-  description: "\u521B\u5EFA\u4E00\u4E2A Product\uFF0C\u5E76\u7531\u7CFB\u7EDF\u751F\u6210\u4E0D\u53EF\u53D8 PR \u4E1A\u52A1\u7F16\u7801\uFF1B\u540C\u4E00\u4E8B\u52A1\u5185\u59CB\u7EC8\u521B\u5EFA\u9996\u4E2A ProductSpec \u5E76\u751F\u6210 PS \u4E1A\u52A1\u7F16\u7801\u3002\u9002\u7528\u4E8E\u65B0\u5EFA\u4EA7\u54C1\u65CF\uFF0C\u4E0D\u9002\u7528\u4E8E\u7ED9\u73B0\u6709 Product \u589E\u52A0\u89C4\u683C\u3002\u5199\u64CD\u4F5C\uFF0C\u8981\u6C42\u5F53\u524D\u5458\u5DE5\u6388\u6743 erp:write\u3002",
+  description: "\u521B\u5EFA\u4E00\u4E2A\u9762\u5411\u7528\u6237\u7684\u9500\u552E SKU \u53D8\u4F53 Product\uFF0C\u5E76\u7531\u7CFB\u7EDF\u751F\u6210\u4E0D\u53EF\u53D8 PR \u4E1A\u52A1\u7F16\u7801\uFF1B\u540C\u4E00\u4E8B\u52A1\u5185\u521B\u5EFA\u9996\u4E2A\u5185\u90E8\u5B9E\u73B0 ProductSpec \u5E76\u751F\u6210 PS \u4E1A\u52A1\u7F16\u7801\u3002\u989C\u8272\u3001\u5C3A\u5BF8\u7B49\u7528\u6237\u53EF\u611F\u77E5\u5DEE\u5F02\u5E94\u521B\u5EFA\u65B0\u7684 Product\u3002\u5199\u64CD\u4F5C\uFF0C\u8981\u6C42\u5F53\u524D\u5458\u5DE5\u6388\u6743 erp:write\u3002",
   scope: "erp:write",
   agent: { exposed: true, readOnly: false, destructive: false, idempotent: false },
   request: { body: createProductInputSchema },
@@ -15108,16 +15156,18 @@ var createProductOperation = defineWriteOperation({
   cli: { path: ["products", "create"] }
 });
 var atLeastOneField = (value) => Object.values(value).some((item) => item !== void 0);
-var updateProductInputSchema = external_exports.object({ name: external_exports.string().trim().min(1).max(255).optional() }).strict().refine(atLeastOneField, "\u81F3\u5C11\u9700\u8981\u4E00\u4E2A\u53EF\u7F16\u8F91\u7684 Product \u5B57\u6BB5\u3002");
+var updateProductInputSchema = external_exports.object({
+  name: external_exports.string().trim().min(1).max(255).optional(),
+  brand: external_exports.enum(["intoNear", "intoNir"]).optional(),
+  color: external_exports.string().trim().min(1).max(120).optional(),
+  salesMarketCodes: external_exports.array(external_exports.enum(["\u7F8E\u56FD", "\u5370\u5EA6", "\u6B27\u76DF", "\u82F1\u56FD"])).min(1).max(4).optional(),
+  lengthCm: external_exports.number().finite().positive().nullable().optional(),
+  widthCm: external_exports.number().finite().positive().nullable().optional(),
+  fixedHeightCm: external_exports.number().finite().positive().nullable().optional(),
+  minHeightCm: external_exports.number().finite().positive().nullable().optional(),
+  maxHeightCm: external_exports.number().finite().positive().nullable().optional()
+}).strict().refine(atLeastOneField, "\u81F3\u5C11\u9700\u8981\u4E00\u4E2A\u53EF\u7F16\u8F91\u7684 Product \u5B57\u6BB5\u3002");
 var updateProductSpecInputSchema = external_exports.object({
-  brand: external_exports.enum(["intoNear", "intoNir"]).optional().describe("\u53D7\u63A7\u54C1\u724C\u679A\u4E3E\u3002"),
-  color: external_exports.string().trim().min(1).max(120).optional().describe("\u989C\u8272\u63CF\u8FF0\u3002"),
-  salesMarketCodes: external_exports.array(external_exports.enum(["\u7F8E\u56FD", "\u5370\u5EA6", "\u6B27\u76DF", "\u82F1\u56FD"])).min(1).max(4).optional().describe("\u9500\u552E\u5E02\u573A\u4E2D\u6587\u679A\u4E3E\u96C6\u5408\u3002"),
-  lengthCm: external_exports.number().finite().positive().nullable().optional().describe("\u957F\u5EA6\uFF0C\u5355\u4F4D cm\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
-  widthCm: external_exports.number().finite().positive().nullable().optional().describe("\u5BBD\u5EA6\uFF0C\u5355\u4F4D cm\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
-  fixedHeightCm: external_exports.number().finite().positive().nullable().optional().describe("\u56FA\u5B9A\u9AD8\u5EA6\uFF0C\u5355\u4F4D cm\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
-  minHeightCm: external_exports.number().finite().positive().nullable().optional().describe("\u6700\u5C0F\u9AD8\u5EA6\uFF0C\u5355\u4F4D cm\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
-  maxHeightCm: external_exports.number().finite().positive().nullable().optional().describe("\u6700\u5927\u9AD8\u5EA6\uFF0C\u5355\u4F4D cm\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
   netWeightKg: external_exports.number().finite().positive().nullable().optional().describe("\u51C0\u91CD\uFF0C\u5355\u4F4D kg\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
   categorySpec: external_exports.unknown().nullable().optional().describe("\u7531 categorySpecSchema \u6807\u8BC6\u7ED3\u6784\u7684\u54C1\u7C7B\u89C4\u683C\u5BF9\u8C61\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002"),
   categorySpecSchema: external_exports.string().trim().min(1).max(120).nullable().optional().describe("categorySpec \u4F7F\u7528\u7684\u7ED3\u6784\u7248\u672C\u6807\u8BC6\uFF1Bnull \u8868\u793A\u6E05\u7A7A\u3002")
@@ -15162,19 +15212,58 @@ var deleteMappingResponseSchema = external_exports.object({
   productSpecCode: productSpecCodeSchema,
   packCode: packCodeSchema
 }).strict();
-var productSpecImageSchema = external_exports.object({
-  fileVersionId: internalIdSchema,
-  fileName: external_exports.string().describe("\u9762\u5411\u7528\u6237\u663E\u793A\u7684\u539F\u59CB\u6587\u4EF6\u540D\u3002"),
-  mediaType: external_exports.enum(["image/jpeg", "image/png", "image/webp"]).describe("\u670D\u52A1\u7AEF\u6821\u9A8C\u540E\u7684\u56FE\u7247\u5A92\u4F53\u7C7B\u578B\u3002"),
-  sizeBytes: external_exports.number().int().nonnegative().nullable().describe("\u6587\u4EF6\u5927\u5C0F\uFF0C\u5355\u4F4D byte\uFF1Bnull \u8868\u793A\u5386\u53F2\u6587\u4EF6\u672A\u8BB0\u5F55\u5927\u5C0F\u3002"),
-  version: external_exports.number().int().positive().describe("\u4E0D\u53EF\u53D8 FileVersion \u7684\u7248\u672C\u53F7\u3002"),
+var addProductImageResponseSchema = external_exports.object({
+  productCode: productCodeSchema,
+  productVersion: external_exports.number().int().positive(),
+  image: productImageSchema,
+  images: external_exports.array(productImageSchema).describe("\u5B8C\u6210\u672C\u6B21\u64CD\u4F5C\u540E\uFF0C\u8BE5 Product \u5F53\u524D\u5173\u8054\u7684\u5168\u90E8\u4EA7\u54C1\u56FE\u7247\u3002")
+}).strict();
+var userManualFileSchema = external_exports.object({
+  id: external_exports.number().int().positive(),
+  fileAssetId: external_exports.number().int().positive(),
+  fileName: external_exports.string(),
+  mediaType: external_exports.literal("application/pdf"),
+  sizeBytes: external_exports.number().int().nullable(),
+  version: external_exports.number().int().positive(),
   createdAt: timestampSchema
 }).strict();
-var addProductSpecImageResponseSchema = external_exports.object({
+var userManualSchema = external_exports.object({
+  manualCode: manualCodeSchema,
+  name: external_exports.string(),
+  version: external_exports.number().int().positive(),
+  currentFile: userManualFileSchema.nullable()
+}).strict();
+var productSpecUserManualsResponseSchema = external_exports.object({
   productSpecCode: productSpecCodeSchema,
-  image: productSpecImageSchema,
-  images: external_exports.array(productSpecImageSchema).describe("\u5B8C\u6210\u672C\u6B21\u64CD\u4F5C\u540E\uFF0C\u8BE5 ProductSpec \u5F53\u524D\u5173\u8054\u7684\u5168\u90E8\u4EA7\u54C1\u56FE\u7247\u3002")
+  productSpecVersion: external_exports.number().int().positive(),
+  manuals: external_exports.array(userManualSchema)
 }).strict();
+var getUserManualOperation = defineReadOperation({
+  operationId: "getUserManual",
+  method: "GET",
+  path: "/api/v1/user-manuals/{manualCode}",
+  summary: "\u6309 ManualCode \u8BFB\u53D6 UserManual",
+  description: "\u6839\u636E\u5B8C\u6574 ManualCode \u8BFB\u53D6 UserManual \u540D\u79F0\u3001\u6700\u65B0 version \u4E0E\u5F53\u524D PDF \u5143\u6570\u636E\u3002\u4E0A\u4F20\u524D\u5FC5\u987B\u5148\u8BFB\u53D6\u6700\u65B0 version\uFF1B\u4E0D\u53EF\u7528\u4E8E\u540D\u79F0\u6216\u4E0D\u5B8C\u6574\u7F16\u7801\u641C\u7D22\u3002\u65E2\u6709 UM \u7F16\u7801\u7EE7\u7EED\u53EF\u8BFB\u3002\u53EA\u8BFB\u5E76\u8981\u6C42 erp:read\uFF1B\u4E0D\u5B58\u5728\u65F6\u8FD4\u56DE NOT_FOUND\u3002",
+  scope: "erp:read",
+  agentReadOnly: true,
+  agent: { exposed: true, readOnly: true, destructive: false, idempotent: true },
+  request: { path: external_exports.object({ manualCode: manualCodeSchema }).strict() },
+  response: { data: userManualSchema },
+  cli: { path: ["user-manuals", "get"] }
+});
+var listProductSpecUserManualsOperation = defineReadOperation({
+  operationId: "listProductSpecUserManuals",
+  method: "GET",
+  path: "/api/v1/product-specs/{productSpecCode}/user-manuals",
+  summary: "\u8BFB\u53D6 ProductSpec \u7684\u9002\u7528\u8BF4\u660E\u4E66",
+  description: "\u6839\u636E\u5B8C\u6574 ProductSpecCode \u8BFB\u53D6\u5F53\u524D\u9002\u7528\u7684\u5168\u90E8 UserManual\uFF0C\u5E76\u8FD4\u56DE\u5173\u8054\u6216\u89E3\u7ED1\u6240\u9700\u7684\u6700\u65B0 ProductSpec version\u3002\u53EA\u8BFB\u5E76\u8981\u6C42 erp:read\uFF1BProductSpec \u4E0D\u5B58\u5728\u65F6\u8FD4\u56DE NOT_FOUND\u3002",
+  scope: "erp:read",
+  agentReadOnly: true,
+  agent: { exposed: true, readOnly: true, destructive: false, idempotent: true },
+  request: { path: productSpecPathSchema },
+  response: { data: productSpecUserManualsResponseSchema },
+  cli: { path: ["product-specs", "list-user-manuals"] }
+});
 var writeAgent = {
   exposed: true,
   readOnly: false,
@@ -15287,17 +15376,17 @@ var deleteProductSpecPackMappingOperation = defineWriteOperation({
   response: { data: deleteMappingResponseSchema },
   cli: { path: ["product-specs", "remove-pack"] }
 });
-var addProductSpecImageOperation = defineWriteOperation({
-  operationId: "addProductSpecImage",
+var addProductImageOperation = defineWriteOperation({
+  operationId: "addProductImage",
   method: "POST",
-  path: "/api/v1/product-specs/{productSpecCode}/images/upload",
-  summary: "\u4E3A ProductSpec \u4E0A\u4F20\u5E76\u5173\u8054\u4EA7\u54C1\u56FE\u7247",
-  description: "\u628A\u4E00\u5F20 JPG\u3001JPEG\u3001PNG \u6216 WEBP \u56FE\u7247\u4E0A\u4F20\u4E3A\u4E0D\u53EF\u53D8 FileVersion\uFF0C\u5E76\u5173\u8054\u5230\u5B8C\u6574 PS \u4E1A\u52A1\u7F16\u7801\u6807\u8BC6\u7684 ProductSpec\u3002\u9002\u7528\u4E8E\u65B0\u589E\u4EA7\u54C1\u5C55\u793A\u56FE\u7247\uFF1B\u4E0D\u9002\u7528\u4E8E\u8BF4\u660E\u4E66\u3001\u4F9B\u5E94\u5546\u8D44\u6599\u3001\u5C01\u6837\u8D44\u6599\u6216 Pack \u6587\u4EF6\u3002\u5355\u6587\u4EF6\u6700\u5927 50 MiB\uFF0C\u540C\u4E00\u903B\u8F91\u8BF7\u6C42\u91CD\u8BD5\u5FC5\u987B\u590D\u7528 idempotencyKey\u3002\u5199\u64CD\u4F5C\uFF0C\u8981\u6C42\u5F53\u524D\u5458\u5DE5\u6388\u6743 erp:write\u3002",
+  path: "/api/v1/products/{productCode}/images/upload",
+  summary: "\u4E3A Product \u4E0A\u4F20\u5E76\u5173\u8054\u4EA7\u54C1\u56FE\u7247",
+  description: "\u628A\u4E00\u5F20 JPG\u3001JPEG\u3001PNG \u6216 WEBP \u56FE\u7247\u4E0A\u4F20\u4E3A\u4E0D\u53EF\u53D8 FileVersion\uFF0C\u5E76\u5173\u8054\u5230\u5B8C\u6574 PR \u4E1A\u52A1\u7F16\u7801\u6807\u8BC6\u7684 Product\u3002\u4F7F\u7528\u6700\u65B0 Product version\uFF1B\u540C\u4E00\u903B\u8F91\u8BF7\u6C42\u91CD\u8BD5\u5FC5\u987B\u590D\u7528 idempotencyKey\u3002\u5199\u64CD\u4F5C\uFF0C\u8981\u6C42\u5F53\u524D\u5458\u5DE5\u6388\u6743 erp:write\u3002",
   scope: "erp:write",
   agent: { exposed: true, readOnly: false, destructive: false, idempotent: true },
   request: {
-    path: productSpecPathSchema,
-    headers: idempotencyKeyHeadersSchema,
+    path: productPathSchema,
+    headers: commandHeadersSchema,
     file: {
       parameterName: "file",
       maxSizeBytes: 50 * 1024 * 1024,
@@ -15306,15 +15395,68 @@ var addProductSpecImageOperation = defineWriteOperation({
       description: "\u8981\u65B0\u589E\u7684\u4EA7\u54C1\u56FE\u7247\u6587\u4EF6\u3002CLI \u4F7F\u7528\u672C\u5730\u6587\u4EF6\u8DEF\u5F84\uFF1BMCP \u4F7F\u7528\u5BA2\u6237\u7AEF\u63D0\u4F9B\u7684\u4E34\u65F6\u6587\u4EF6\u5F15\u7528\u3002"
     }
   },
-  response: { data: addProductSpecImageResponseSchema, status: 201 },
-  cli: { path: ["product-specs", "add-image"] }
+  response: { data: addProductImageResponseSchema, status: 201 },
+  cli: { path: ["products", "add-image"] }
+});
+var uploadUserManualOperation = defineWriteOperation({
+  operationId: "uploadUserManual",
+  method: "POST",
+  path: "/api/v1/user-manuals/{manualCode}/upload",
+  summary: "\u4E3A UserManual \u4E0A\u4F20\u5F53\u524D PDF",
+  description: "\u628A PDF \u4E0A\u4F20\u4E3A\u4E0D\u53EF\u53D8 FileVersion\uFF0C\u5E76\u8BBE\u4E3A\u5B8C\u6574 ManualCode \u6807\u8BC6\u7684 UserManual \u5F53\u524D\u6587\u4EF6\u3002\u4F7F\u7528\u6700\u65B0 UserManual version\uFF1B\u540C\u4E00\u903B\u8F91\u8BF7\u6C42\u91CD\u8BD5\u5FC5\u987B\u590D\u7528 idempotencyKey\u3002\u5199\u64CD\u4F5C\uFF0C\u8981\u6C42\u5F53\u524D\u5458\u5DE5\u6388\u6743 erp:write\u3002",
+  scope: "erp:write",
+  agent: { exposed: true, readOnly: false, destructive: false, idempotent: true },
+  request: {
+    path: external_exports.object({ manualCode: manualCodeSchema }).strict(),
+    headers: commandHeadersSchema,
+    file: {
+      parameterName: "file",
+      maxSizeBytes: 50 * 1024 * 1024,
+      allowedMediaTypes: ["application/pdf"],
+      allowedExtensions: ["pdf"],
+      description: "\u8981\u8BBE\u4E3A UserManual \u5F53\u524D\u6587\u4EF6\u7684 PDF\u3002CLI \u4F7F\u7528\u672C\u5730\u6587\u4EF6\u8DEF\u5F84\uFF1BMCP \u4F7F\u7528\u5BA2\u6237\u7AEF\u63D0\u4F9B\u7684\u4E34\u65F6\u6587\u4EF6\u5F15\u7528\u3002"
+    }
+  },
+  response: { data: userManualSchema, status: 201 },
+  cli: { path: ["user-manuals", "upload"] }
+});
+var attachProductSpecUserManualOperation = defineWriteOperation({
+  operationId: "attachProductSpecUserManual",
+  method: "POST",
+  path: "/api/v1/product-specs/{productSpecCode}/user-manuals",
+  summary: "\u5173\u8054 ProductSpec \u4E0E UserManual",
+  description: "\u628A\u5DF2\u5B58\u5728\u7684\u5B8C\u6574 ManualCode \u5173\u8054\u5230 ProductSpec\u3002expectedVersion \u5FC5\u987B\u662F ProductSpec \u7684\u6700\u65B0 version\uFF1B\u91CD\u590D\u5173\u8054\u8FD4\u56DE DUPLICATE_USER_MANUAL\u3002\u5199\u64CD\u4F5C\uFF0C\u8981\u6C42 erp:write\u3002",
+  scope: "erp:write",
+  agent: writeAgent,
+  request: {
+    path: productSpecPathSchema,
+    headers: expectedVersionHeadersSchema,
+    body: external_exports.object({ manualCode: manualCodeSchema }).strict()
+  },
+  response: { data: productSpecUserManualsResponseSchema, status: 201 },
+  cli: { path: ["product-specs", "add-user-manual"] }
+});
+var productSpecUserManualPathSchema = productSpecPathSchema.extend({ manualCode: manualCodeSchema }).strict();
+var detachProductSpecUserManualOperation = defineWriteOperation({
+  operationId: "detachProductSpecUserManual",
+  method: "DELETE",
+  path: "/api/v1/product-specs/{productSpecCode}/user-manuals/{manualCode}",
+  summary: "\u89E3\u7ED1 ProductSpec \u4E0E UserManual",
+  description: "\u5220\u9664 ProductSpec \u4E0E UserManual \u7684\u9002\u7528\u5173\u7CFB\uFF0C\u4E0D\u5220\u9664 UserManual \u6216\u5176 PDF\u3002expectedVersion \u5FC5\u987B\u662F ProductSpec \u7684\u6700\u65B0 version\uFF1B\u6267\u884C\u524D\u5E94\u53D6\u5F97\u7528\u6237\u660E\u786E\u610F\u56FE\u3002\u7834\u574F\u6027\u5199\u64CD\u4F5C\uFF0C\u8981\u6C42 erp:write\u3002",
+  scope: "erp:write",
+  agent: destructiveWriteAgent,
+  request: {
+    path: productSpecUserManualPathSchema,
+    headers: expectedVersionHeadersSchema
+  },
+  response: { data: productSpecUserManualsResponseSchema },
+  cli: { path: ["product-specs", "remove-user-manual"] }
 });
 
 // ../../packages/contracts/dist/work-lists/index.js
 var timestampSchema2 = external_exports.iso.datetime().describe("ISO 8601 UTC \u65F6\u95F4\u6233\u3002");
 var workListInternalIdSchema = external_exports.number().int().describe("DevelopmentWorkList \u5DE5\u4F5C\u6E05\u5355\u5185\u90E8\u6807\u8BC6\uFF1B\u4E0D\u662F PR\u3001PS\u3001PK \u4E1A\u52A1\u7F16\u7801\u3002");
 var productInternalIdSchema = external_exports.number().int().describe("\u6570\u636E\u5E93\u5185\u90E8\u5173\u8054\u6807\u8BC6\uFF1B\u4E0D\u662F PR\u3001PS\u3001PK \u4E1A\u52A1\u7F16\u7801\u3002");
-var nullableCentimeterSchema2 = external_exports.number().nullable().describe("\u5C3A\u5BF8\uFF0C\u5355\u4F4D cm\uFF1Bnull \u8868\u793A\u7CFB\u7EDF\u6CA1\u6709\u5DF2\u8BB0\u5F55\u503C\uFF0C\u5F53\u524D\u4E0D\u7EC6\u5206\u5177\u4F53\u7A7A\u503C\u539F\u56E0\u3002");
 var nullableKilogramSchema2 = external_exports.number().nullable().describe("\u91CD\u91CF\uFF0C\u5355\u4F4D kg\uFF1Bnull \u8868\u793A\u7CFB\u7EDF\u6CA1\u6709\u5DF2\u8BB0\u5F55\u503C\uFF0C\u5F53\u524D\u4E0D\u7EC6\u5206\u5177\u4F53\u7A7A\u503C\u539F\u56E0\u3002");
 var workListIdSchema = external_exports.coerce.number().int().positive().describe("\u5F00\u53D1\u5DE5\u4F5C\u6E05\u5355\u7684\u5185\u90E8\u6B63\u6574\u6570\u6807\u8BC6\uFF0C\u7531\u5217\u8868\u67E5\u8BE2\u8FD4\u56DE\uFF1B\u4E0D\u662F PR\u3001PS\u3001PK \u4E1A\u52A1\u7F16\u7801\u3002");
 var batchIdPathSchema = external_exports.object({ batchId: workListIdSchema }).strict();
@@ -15359,14 +15501,6 @@ var workListSpecContentSchema = external_exports.object({
   productId: productInternalIdSchema,
   productCode: productCodeSchema,
   specName: external_exports.string(),
-  brand: external_exports.string().nullable(),
-  color: external_exports.string().nullable(),
-  salesMarketCodes: external_exports.array(external_exports.string()),
-  lengthCm: nullableCentimeterSchema2,
-  widthCm: nullableCentimeterSchema2,
-  fixedHeightCm: nullableCentimeterSchema2,
-  minHeightCm: nullableCentimeterSchema2,
-  maxHeightCm: nullableCentimeterSchema2,
   netWeightKg: nullableKilogramSchema2,
   categorySpec: external_exports.unknown().nullable(),
   categorySpecSchema: external_exports.string().nullable(),
@@ -15441,7 +15575,7 @@ var getDevelopmentWorkListOperation = defineReadOperation({
   method: "GET",
   path: "/api/v1/dev-batches/{batchId}",
   summary: "\u8BFB\u53D6\u5F00\u53D1\u5DE5\u4F5C\u6E05\u5355\u53CA\u5B9E\u65F6\u5B8C\u6574\u5EA6",
-  description: "\u6839\u636E\u5217\u8868\u8FD4\u56DE\u7684\u5DE5\u4F5C\u6E05\u5355\u5185\u90E8 ID\uFF0C\u8BFB\u53D6\u6210\u5458\u4E3B\u6570\u636E\u5B9E\u65F6\u6295\u5F71\u53CA\u5B9E\u65F6\u3001\u975E\u963B\u65AD\u8D44\u6599\u5B8C\u6574\u5EA6\u3002\u5DE5\u4F5C\u6E05\u5355\u4E0D\u62E5\u6709\u4EA7\u54C1\u4E3B\u6570\u636E\uFF1B\u5B8C\u6574\u5EA6\u53EA\u8BA1\u7B97\u663E\u5F0F\u5305\u542B\u7684 ProductSpec\uFF0C\u6A21\u578B\u4E0D\u5F97\u81EA\u884C\u63A8\u7B97\u3002\u53EA\u8BFB\u5E76\u8981\u6C42 erp:read\u3002",
+  description: "\u6839\u636E\u5217\u8868\u8FD4\u56DE\u7684\u5DE5\u4F5C\u6E05\u5355\u5185\u90E8 ID\uFF0C\u8BFB\u53D6\u6210\u5458\u4E3B\u6570\u636E\u5B9E\u65F6\u6295\u5F71\u53CA\u5B9E\u65F6\u3001\u975E\u963B\u65AD\u8D44\u6599\u5B8C\u6574\u5EA6\u3002\u5DE5\u4F5C\u6E05\u5355\u4E0D\u62E5\u6709\u4EA7\u54C1\u4E3B\u6570\u636E\uFF1B\u5B8C\u6574\u5EA6\u53EA\u8BA1\u7B97\u663E\u5F0F\u5305\u542B\u7684 Product \u548C ProductSpec\uFF0C\u6A21\u578B\u4E0D\u5F97\u81EA\u884C\u63A8\u7B97\u3002\u53EA\u8BFB\u5E76\u8981\u6C42 erp:read\u3002",
   scope: "erp:read",
   agentReadOnly: true,
   agent: { exposed: true, readOnly: true, destructive: false, idempotent: true },
@@ -15467,15 +15601,12 @@ var scopeCommandBase = (type, payload) => external_exports.object({ type: extern
 var editableSpecFields = initialProductSpecInputSchema.omit({ specName: true });
 var developmentWorkListCommandSchema = external_exports.discriminatedUnion("type", [
   scopeCommandBase("RENAME_TOPIC", external_exports.object({ title: external_exports.string().trim().min(1).max(160) }).strict()),
-  scopeCommandBase("CREATE_PRODUCT", external_exports.object({
-    name: external_exports.string().trim().min(1).max(255),
-    initialSpec: initialProductSpecInputSchema.optional()
-  }).strict()),
+  scopeCommandBase("CREATE_PRODUCT", createProductInputSchema),
   scopeCommandBase("UPDATE_PRODUCT", external_exports.object({
     productCode: productCodeSchema,
     expectedVersion: external_exports.number().int().positive(),
-    name: external_exports.string().trim().min(1).max(255)
-  }).strict()),
+    ...updateProductInputSchema.shape
+  }).strict().refine((value) => Object.entries(value).some(([key, item]) => !["productCode", "expectedVersion"].includes(key) && item !== void 0), "\u81F3\u5C11\u9700\u8981\u4E00\u4E2A\u53EF\u7F16\u8F91\u7684 Product \u5B57\u6BB5\u3002")),
   scopeCommandBase("ADD_PRODUCT_SPEC", initialProductSpecInputSchema.extend({ productCode: productCodeSchema, specName: external_exports.string().trim().min(1).max(255) }).strict()),
   scopeCommandBase("UPDATE_PRODUCT_SPEC", editableSpecFields.extend({
     productSpecCode: productSpecCodeSchema,
@@ -15558,12 +15689,17 @@ var erpReadOperations = [
   getProductOperation,
   getProductSpecOperation,
   getPackOperation,
+  getUserManualOperation,
+  listProductSpecUserManualsOperation,
   listDevelopmentWorkListsOperation,
   getDevelopmentWorkListOperation,
   listWorkListActivityOperation
 ];
 var erpWriteOperations = [
-  addProductSpecImageOperation,
+  addProductImageOperation,
+  uploadUserManualOperation,
+  attachProductSpecUserManualOperation,
+  detachProductSpecUserManualOperation,
   createProductOperation,
   updateProductOperation,
   updateProductSpecOperation,
@@ -15634,6 +15770,7 @@ var searchProductMasterDataTool = {
 \u9002\u7528\uFF1A\u4E0D\u77E5\u9053\u5B8C\u6574\u4E1A\u52A1\u7F16\u7801\uFF0C\u53EA\u6709 Product \u540D\u79F0\u3001ProductSpec \u89C4\u683C\u540D\u3001Pack \u540D\u79F0\u3001Supplier \u7F16\u7801\u6216\u540D\u79F0\uFF1B\u9700\u8981\u4ECE\u591A\u4E2A\u5019\u9009\u4E2D\u786E\u8BA4\u76EE\u6807\u3002
 \u4E0D\u9002\u7528\uFF1A\u5DF2\u7ECF\u63D0\u4F9B\u5B8C\u6574 PR\u3001PS\u3001PK \u4E1A\u52A1\u7F16\u7801\uFF0C\u6B64\u65F6\u4F7F\u7528 get_product_master_data\u3002\u5F53\u524D\u4E0D\u652F\u6301\u90E8\u5206\u4E1A\u52A1\u7F16\u7801\u5339\u914D\u3002
 
+Product\uFF08PR\uFF09\u662F\u9500\u552E SKU \u53D8\u4F53\uFF1BProductSpec\uFF08PS\uFF09\u662F\u987E\u5BA2\u4E0D\u611F\u77E5\u7684\u5185\u90E8\u5B9E\u73B0\u65B9\u6848\uFF1BPack\uFF08PK\uFF09\u662F\u4EA4\u4ED8\u5305\u88F9\u3002
 \u8FD4\u56DE\u5019\u9009 matches\u3001\u76F8\u5173 Product/ProductSpec/Pack\u3001\u5E26 quantity \u7684 ProductSpec\u2014Pack \u6620\u5C04\u53CA\u5206\u9875\u6E38\u6807\u3002\u591A\u4E2A\u5019\u9009\u90FD\u53EF\u80FD\u6709\u6548\uFF0C\u4E0D\u8981\u9ED8\u8BA4\u7B2C\u4E00\u6761\u5C31\u662F\u76EE\u6807\uFF1B\u7A7A\u5019\u9009\u662F SUCCESS\uFF0C\u8868\u793A\u5F53\u524D\u8BFB\u53D6\u8303\u56F4\u5185\u6CA1\u6709\u5339\u914D\u7ED3\u679C\uFF1B\u975E\u6CD5\u53C2\u6570\u8FD4\u56DE INVALID_ARGUMENT\u3002
 \u8BE5\u5DE5\u5177\u53EA\u8BFB\uFF0C\u4F7F\u7528\u5F53\u524D\u8C03\u7528\u8EAB\u4EFD\u5E76\u8981\u6C42 erp:read\u3002`,
   scope: "erp:read",
@@ -15648,7 +15785,7 @@ var getProductMasterDataTool = {
 PR \u662F ProductCode\uFF0CPS \u662F ProductSpecCode\uFF0CPK \u662F PackCode\uFF1B\u5B83\u4EEC\u662F\u4E1A\u52A1\u7F16\u7801\uFF0C\u4E0D\u662F\u6570\u636E\u5E93\u5185\u90E8 ID \u6216\u6E20\u9053 SKU\u3002
 \u9002\u7528\uFF1A\u7528\u6237\u5DF2\u7ECF\u63D0\u4F9B\u5B8C\u6574\u4E1A\u52A1\u7F16\u7801\u3002\u4E0D\u53EF\u7528\u4E8E\u540D\u79F0\u3001Supplier \u6216\u4E0D\u5B8C\u6574\u7F16\u7801\u641C\u7D22\uFF0C\u6B64\u65F6\u4F7F\u7528 search_product_master_data\u3002
 
-PR \u8FD4\u56DE Product \u53CA\u5176 ProductSpec\u3001Pack \u5173\u7CFB\uFF1BPS \u8FD4\u56DE\u6240\u5C5E Product\u3001\u76EE\u6807 ProductSpec \u53CA Pack\uFF1BPK \u8FD4\u56DE\u76EE\u6807 Pack \u53CA\u5F15\u7528\u5B83\u7684 ProductSpec\u3001Product\u3002\u975E\u6CD5\u7F16\u7801\u8FD4\u56DE INVALID_ARGUMENT\uFF1B\u5F53\u524D\u8BFB\u53D6\u8303\u56F4\u5185\u4E0D\u5B58\u5728\u65F6\u8FD4\u56DE\u4E0D\u6CC4\u9732\u989D\u5916\u5B58\u5728\u6027\u7684 NOT_FOUND\uFF0C\u4E0D\u8FD4\u56DE\u7A7A\u5173\u7CFB\u5192\u5145\u6210\u529F\u3002
+PR \u8FD4\u56DE\u54C1\u724C\u3001\u989C\u8272\u3001\u76EE\u6807\u9500\u552E\u5E02\u573A\u3001\u987E\u5BA2\u53EF\u89C1\u5C3A\u5BF8\u53CA\u5176 ProductSpec\u3001Pack \u5173\u7CFB\uFF1BPS \u8FD4\u56DE\u987E\u5BA2\u4E0D\u611F\u77E5\u7684\u5185\u90E8\u5B9E\u73B0\u8D44\u6599\u4E0E Pack \u6620\u5C04\uFF1BPK \u8FD4\u56DE\u76EE\u6807 Pack \u53CA\u5F15\u7528\u5B83\u7684 ProductSpec\u3001Product\u3002\u4EA7\u54C1\u56FE\u7247\u7531\u72EC\u7ACB Product \u56FE\u7247\u8D44\u6E90\u7EF4\u62A4\u3002\u975E\u6CD5\u7F16\u7801\u8FD4\u56DE INVALID_ARGUMENT\uFF1B\u5F53\u524D\u8BFB\u53D6\u8303\u56F4\u5185\u4E0D\u5B58\u5728\u65F6\u8FD4\u56DE\u4E0D\u6CC4\u9732\u989D\u5916\u5B58\u5728\u6027\u7684 NOT_FOUND\u3002
 \u8BE5\u5DE5\u5177\u53EA\u8BFB\uFF0C\u4F7F\u7528\u5F53\u524D\u8C03\u7528\u8EAB\u4EFD\u5E76\u8981\u6C42 erp:read\u3002`,
   scope: "erp:read",
   annotations: readOnlyAnnotations,
@@ -15657,6 +15794,14 @@ PR \u8FD4\u56DE Product \u53CA\u5176 ProductSpec\u3001Pack \u5173\u7CFB\uFF1BPS
   }).strict(),
   output: output(external_exports.union([getProductResponseSchema, getProductSpecResponseSchema, getPackResponseSchema]), true)
 };
+var getUserManualTool = {
+  name: "get_user_manual",
+  description: "\u6839\u636E\u5B8C\u6574 ManualCode \u8BFB\u53D6\u4E00\u4E2A UserManual \u7684\u540D\u79F0\u3001\u6700\u65B0 version \u4E0E\u5F53\u524D PDF \u5143\u6570\u636E\u3002\u65B0\u7F16\u7801\u4F7F\u7528 MANUAL \u524D\u7F00\uFF0C\u65E2\u6709 UM \u7F16\u7801\u7EE7\u7EED\u6709\u6548\u3002\u8BF4\u660E\u4E66\u4E0A\u4F20\u524D\u4F7F\u7528\u8BE5\u5DE5\u5177\u53D6\u5F97 expectedVersion\uFF1B\u4E0D\u53EF\u7528\u4E8E\u540D\u79F0\u6216\u4E0D\u5B8C\u6574\u7F16\u7801\u641C\u7D22\u3002\u53EA\u8BFB\uFF0C\u4F7F\u7528\u5F53\u524D\u8C03\u7528\u8EAB\u4EFD\u5E76\u8981\u6C42 erp:read\u3002",
+  scope: "erp:read",
+  annotations: readOnlyAnnotations,
+  input: getUserManualOperation.request.path,
+  output: output(userManualSchema, true)
+};
 var listDevelopmentWorkListsTool = {
   name: "list_development_work_lists",
   description: `\u6309\u66F4\u65B0\u65F6\u95F4\u4ECE\u65B0\u5230\u65E7\u5206\u9875\u67E5\u8BE2 DevelopmentWorkList\uFF08\u5B9E\u73B0\u540D DevBatch\uFF09\u3002
@@ -15728,27 +15873,46 @@ var chatGptFileInputSchema = external_exports.object({
   mime_type: external_exports.string().trim().min(1).max(255).optional().describe("\u5BA2\u6237\u7AEF\u58F0\u660E\u7684 MIME \u7C7B\u578B\u3002"),
   file_name: external_exports.string().trim().min(1).max(255).optional().describe("\u7528\u6237\u4E0A\u4F20\u65F6\u7684\u539F\u59CB\u6587\u4EF6\u540D\u3002")
 }).strict();
-var addProductSpecImageTool = {
-  name: "add_product_spec_image",
-  description: `\u4E3A\u4E00\u4E2A ProductSpec \u4E0A\u4F20\u5E76\u5173\u8054\u4E00\u5F20\u4EA7\u54C1\u56FE\u7247\u3002
+var addProductImageTool = {
+  name: "add_product_image",
+  description: `\u4E3A\u4E00\u4E2A Product \u4E0A\u4F20\u5E76\u5173\u8054\u4E00\u5F20\u4EA7\u54C1\u56FE\u7247\u3002
 
-\u9002\u7528\uFF1A\u7528\u6237\u5DF2\u660E\u786E\u76EE\u6807 PS \u4E1A\u52A1\u7F16\u7801\uFF0C\u5E76\u5728\u5F53\u524D\u5BF9\u8BDD\u4E2D\u9644\u52A0\u4E86\u4E00\u5F20 JPG\u3001JPEG\u3001PNG \u6216 WEBP \u56FE\u7247\u3002
-\u4E0D\u9002\u7528\uFF1A\u7528\u6237\u8BF4\u660E\u4E66\u3001\u4F9B\u5E94\u5546\u89C4\u683C\u4E66\u6216\u56FE\u7EB8\u3001\u5C01\u6837\u8D44\u6599\u3001Pack \u6587\u4EF6\uFF1B\u8FD9\u4E9B\u8D44\u6599\u5FC5\u987B\u4F7F\u7528\u5404\u81EA\u7684\u9886\u57DF\u5DE5\u5177\u3002\u4E5F\u4E0D\u53EF\u53EA\u51ED\u540D\u79F0\u731C\u6D4B ProductSpec\uFF0C\u5E94\u5148\u641C\u7D22\u5E76\u786E\u8BA4\u5B8C\u6574 PS \u7F16\u7801\u3002
+\u9002\u7528\uFF1A\u7528\u6237\u5DF2\u660E\u786E\u76EE\u6807 PR \u4E1A\u52A1\u7F16\u7801\uFF0C\u5E76\u5728\u5F53\u524D\u5BF9\u8BDD\u4E2D\u9644\u52A0\u4E86\u4E00\u5F20 JPG\u3001JPEG\u3001PNG \u6216 WEBP \u56FE\u7247\u3002
+\u4E0D\u9002\u7528\uFF1A\u7528\u6237\u8BF4\u660E\u4E66\u3001\u4F9B\u5E94\u5546\u89C4\u683C\u4E66\u6216\u56FE\u7EB8\u3001\u5C01\u6837\u8D44\u6599\u3001Pack \u6587\u4EF6\uFF1B\u8FD9\u4E9B\u8D44\u6599\u5FC5\u987B\u4F7F\u7528\u5404\u81EA\u7684\u9886\u57DF\u5DE5\u5177\u3002\u4E5F\u4E0D\u53EF\u53EA\u51ED\u540D\u79F0\u731C\u6D4B Product\uFF0C\u5E94\u5148\u641C\u7D22\u5E76\u786E\u8BA4\u5B8C\u6574 PR \u7F16\u7801\u3002
 
-\u8BE5\u5DE5\u5177\u628A\u6587\u4EF6\u4E0A\u4F20\u4E3A\u4E0D\u53EF\u53D8 FileVersion\uFF0C\u5E76\u5173\u8054\u5230 ProductSpec \u4EA7\u54C1\u56FE\u7247\u96C6\u5408\u3002\u5355\u6587\u4EF6\u6700\u5927 50 MiB\uFF1B\u540C\u4E00\u903B\u8F91\u8BF7\u6C42\u91CD\u8BD5\u5FC5\u987B\u590D\u7528 idempotencyKey\u3002\u5199\u64CD\u4F5C\uFF0C\u8981\u6C42\u5F53\u524D\u5458\u5DE5\u6388\u6743 erp:write\u3002`,
+\u8BE5\u5DE5\u5177\u628A\u6587\u4EF6\u4E0A\u4F20\u4E3A\u4E0D\u53EF\u53D8 FileVersion\uFF0C\u5E76\u5173\u8054\u5230 Product \u4EA7\u54C1\u56FE\u7247\u96C6\u5408\u3002\u5FC5\u987B\u63D0\u4F9B\u6700\u65B0 Product version\uFF1B\u5355\u6587\u4EF6\u6700\u5927 50 MiB\uFF1B\u540C\u4E00\u903B\u8F91\u8BF7\u6C42\u91CD\u8BD5\u5FC5\u987B\u590D\u7528 idempotencyKey\u3002\u5199\u64CD\u4F5C\uFF0C\u8981\u6C42\u5F53\u524D\u5458\u5DE5\u6388\u6743 erp:write\u3002`,
   scope: "erp:write",
   annotations: { ...writeAnnotations, idempotentHint: true },
   meta: { "openai/fileParams": ["file"] },
   input: external_exports.object({
-    productSpecCode: productSpecCodeSchema,
+    productCode: productCodeSchema,
+    expectedVersion: expectedVersionInputSchema,
+    idempotencyKey: idempotencyKeyInputSchema,
+    file: chatGptFileInputSchema
+  }).strict(),
+  output: output(addProductImageResponseSchema, false)
+};
+var uploadUserManualTool = {
+  name: "upload_user_manual",
+  description: `\u4E3A\u4E00\u4E2A UserManual \u4E0A\u4F20\u5E76\u8BBE\u7F6E\u5F53\u524D PDF \u6587\u4EF6\u3002
+
+\u9002\u7528\uFF1A\u7528\u6237\u5DF2\u660E\u786E\u76EE\u6807 ManualCode\uFF0C\u5E76\u5728\u5F53\u524D\u5BF9\u8BDD\u4E2D\u9644\u52A0\u4E86\u4E00\u4EFD PDF \u8BF4\u660E\u4E66\u3002\u76EE\u6807 UserManual \u5FC5\u987B\u5DF2\u7ECF\u5B58\u5728\uFF1B\u6587\u4EF6\u4E0A\u4F20\u540E\u4FDD\u5B58\u4E3A\u4E0D\u53EF\u53D8 FileVersion\uFF0C\u5E76\u6210\u4E3A\u8BE5\u8BF4\u660E\u4E66\u7684\u5F53\u524D\u6587\u4EF6\u3002
+
+\u5982\u6587\u4EF6\u5DF2\u5C5E\u4E8E\u67D0\u4EFD\u8BF4\u660E\u4E66\uFF0C\u5DE5\u5177\u4F1A\u8FD4\u56DE\u5DF2\u6709 ManualCode\uFF0C\u5E94\u76F4\u63A5\u590D\u7528\u8BE5\u8BF4\u660E\u4E66\u3002\u5FC5\u987B\u63D0\u4F9B\u6700\u65B0 UserManual version\uFF1B\u5355\u6587\u4EF6\u6700\u5927 50 MiB\uFF1B\u540C\u4E00\u903B\u8F91\u8BF7\u6C42\u91CD\u8BD5\u5FC5\u987B\u590D\u7528 idempotencyKey\u3002\u5199\u64CD\u4F5C\uFF0C\u8981\u6C42\u5F53\u524D\u5458\u5DE5\u6388\u6743 erp:write\u3002`,
+  scope: "erp:write",
+  annotations: { ...writeAnnotations, idempotentHint: true },
+  meta: { "openai/fileParams": ["file"] },
+  input: external_exports.object({
+    manualCode: uploadUserManualOperation.request.path.shape.manualCode,
+    expectedVersion: expectedVersionInputSchema,
     idempotencyKey: idempotencyKeyInputSchema,
     file: chatGptFileInputSchema
   }).strict(),
-  output: output(addProductSpecImageResponseSchema, false)
+  output: output(userManualSchema, false)
 };
 var createProductTool = {
   name: "create_product",
-  description: "\u521B\u5EFA Product \u53CA\u5176\u9996\u4E2A ProductSpec\uFF0C\u7CFB\u7EDF\u751F\u6210\u4E0D\u53EF\u53D8 PR\u3001PS \u4E1A\u52A1\u7F16\u7801\u3002\u9002\u7528\uFF1A\u7528\u6237\u660E\u786E\u8981\u521B\u5EFA\u65B0\u7684\u4EA7\u54C1\u65CF\u3002\u4E0D\u9002\u7528\uFF1A\u7ED9\u73B0\u6709 Product \u589E\u52A0\u89C4\u683C\uFF1B\u5E94\u4F7F\u7528\u5F00\u53D1\u5DE5\u4F5C\u6E05\u5355\u8BED\u4E49\u547D\u4EE4\u3002\u8BE5\u5DE5\u5177\u4F1A\u5199\u5165\u4E1A\u52A1\u6570\u636E\uFF0C\u8981\u6C42\u5F53\u524D\u5458\u5DE5\u6388\u6743 erp:write\uFF1B\u521B\u5EFA\u524D\u5E94\u786E\u8BA4\u540D\u79F0\u548C\u9996\u4E2A\u89C4\u683C\u5B57\u6BB5\u3002",
+  description: "\u521B\u5EFA\u9500\u552E SKU \u53D8\u4F53 Product \u53CA\u5176\u9996\u4E2A\u5185\u90E8\u5B9E\u73B0 ProductSpec\uFF0C\u7CFB\u7EDF\u751F\u6210\u4E0D\u53EF\u53D8 PR\u3001PS \u4E1A\u52A1\u7F16\u7801\u3002\u989C\u8272\u3001\u5C3A\u5BF8\u7B49\u7528\u6237\u53EF\u611F\u77E5\u5DEE\u5F02\u5E94\u521B\u5EFA\u65B0\u7684 Product\uFF1B\u7ED9\u73B0\u6709 Product \u589E\u52A0\u987E\u5BA2\u4E0D\u611F\u77E5\u7684\u5185\u90E8\u5B9E\u73B0\u5E94\u4F7F\u7528\u5F00\u53D1\u5DE5\u4F5C\u6E05\u5355\u8BED\u4E49\u547D\u4EE4\u3002\u5199\u64CD\u4F5C\u8981\u6C42\u5F53\u524D\u5458\u5DE5\u6388\u6743 erp:write\u3002",
   scope: "erp:write",
   annotations: writeAnnotations,
   input: createProductInputSchema,
@@ -15888,6 +16052,15 @@ var CLIENT_ID = "erp-cli";
 var SCOPE = "openid erp:read erp:write offline_access";
 var DEFAULT_LOOPBACK_PORT = 53682;
 var CALLBACK_TIMEOUT_MS = 18e4;
+var ErpAuthorizationError = class extends Error {
+  constructor(oauthError, oauthMessage) {
+    super(oauthMessage ?? oauthError);
+    this.oauthError = oauthError;
+    this.oauthMessage = oauthMessage;
+    this.name = "ErpAuthorizationError";
+  }
+  code = "ERP_AUTHORIZATION_FAILED";
+};
 function base64Url(value) {
   return Buffer.from(value).toString("base64url");
 }
@@ -16006,9 +16179,16 @@ async function loginWithBrowser(dependencies) {
     throw error51;
   }
   const callback = await callbackPromise;
+  if (callback.searchParams.get("state") !== state) throw new Error("ERP_AUTH_INVALID_CALLBACK");
+  const oauthError = callback.searchParams.get("error");
+  if (oauthError) {
+    throw new ErpAuthorizationError(
+      oauthError,
+      callback.searchParams.get("error_description") ?? void 0
+    );
+  }
   const code = callback.searchParams.get("code");
-  if (!code || callback.searchParams.get("state") !== state)
-    throw new Error("ERP_AUTH_INVALID_CALLBACK");
+  if (!code) throw new Error("ERP_AUTH_INVALID_CALLBACK");
   const response = await dependencies.fetch(`${origin}/auth/token`, {
     method: "POST",
     headers: { accept: "application/json", "content-type": "application/x-www-form-urlencoded" },
@@ -16176,6 +16356,7 @@ async function createMultipartBody(values, file2) {
   return body;
 }
 function mediaTypeForExtension(extension) {
+  if (extension === "pdf") return "application/pdf";
   if (extension === "jpg" || extension === "jpeg") return "image/jpeg";
   if (extension === "png") return "image/png";
   if (extension === "webp") return "image/webp";
@@ -16378,16 +16559,23 @@ async function runCli(args2, dependencies) {
         return 0;
       }
     } catch (error51) {
-      dependencies.stderr(
-        `${JSON.stringify({ error: error51 instanceof Error ? error51.message : "AUTH_FAILED" })}
-`
-      );
+      const payload = error51 instanceof ErpAuthorizationError ? {
+        error: error51.code,
+        oauthError: error51.oauthError,
+        ...error51.oauthMessage ? { message: error51.oauthMessage } : {}
+      } : { error: error51 instanceof Error ? error51.message : "AUTH_FAILED" };
+      dependencies.stderr(`${JSON.stringify(payload)}
+`);
       return 1;
     }
     dependencies.stderr(`${JSON.stringify({ error: "UNKNOWN_AUTH_COMMAND" })}
 `);
     return 1;
   }
+  if (args2.length === 2 && args2[0] === "call" && args2[1] === "--help") {
+    dependencies.stdout(callHelp());
+    return 0;
+  }
   if (args2[0] === "list") {
     const operations2 = Object.values(dependencies.operations).filter(isCallableAgentOperation).sort((left, right) => left.operationId.localeCompare(right.operationId)).map(
       ({
@@ -16443,6 +16631,13 @@ async function runCli(args2, dependencies) {
 `);
     return 0;
   }
+  if (args2.length === 2 && args2[1] === "--help") {
+    const help2 = commandGroupHelp(args2[0] ?? "", dependencies.operations);
+    if (help2) {
+      dependencies.stdout(help2);
+      return 0;
+    }
+  }
   if (args2[0] === "call") {
     const operation = args2[1] ? dependencies.operations[args2[1]] : void 0;
     if (!operation || !isCallableAgentOperation(operation)) {
@@ -16511,6 +16706,37 @@ async function runCli(args2, dependencies) {
 `);
   return 1;
 }
+function callHelp() {
+  return `intoNear ERP CLI \xB7 call
+
+\u7528\u6CD5\uFF1A
+  intonear-erp-cli call <operationId> [--\u53C2\u6570 \u503C]
+
+\u5148\u8FD0\u884C intonear-erp-cli list \u53D1\u73B0 operationId\uFF0C\u518D\u8FD0\u884C
+intonear-erp-cli describe <operationId> \u67E5\u770B\u5B8C\u6574\u53C2\u6570\u5951\u7EA6\u3002
+JSON \u8BF7\u6C42\u4F53\u4F7F\u7528 --body\uFF0C\u6587\u4EF6\u4F7F\u7528 --file\u3002
+`;
+}
+function commandGroupHelp(group, operations2) {
+  const commands = Object.values(operations2).filter(isCallableAgentOperation).flatMap((operation) => {
+    const [candidateGroup, subcommand] = operation.command?.split(" ") ?? [];
+    return candidateGroup === group && subcommand ? [{ operation, subcommand }] : [];
+  }).sort((left, right) => left.subcommand.localeCompare(right.subcommand));
+  if (commands.length === 0) return void 0;
+  const commandLines = commands.map(
+    ({ operation, subcommand }) => `  ${subcommand.padEnd(16)} ${operation.summary ?? operation.operationId}`
+  ).join("\n");
+  return `intoNear ERP CLI \xB7 ${group}
+
+\u7528\u6CD5\uFF1A
+  intonear-erp-cli ${group} <\u5B50\u547D\u4EE4> [...]
+
+\u5B50\u547D\u4EE4\uFF1A
+${commandLines}
+
+\u8FD0\u884C intonear-erp-cli describe <operationId> \u67E5\u770B\u5B8C\u6574\u53C2\u6570\u5951\u7EA6\u3002
+`;
+}
 function parseDomainArguments(operation, args2) {
   const pathNames = operation.request.path ? Object.keys(operation.request.path.shape) : [];
   const values = {};
@@ -16670,7 +16896,7 @@ function createCredentialStore(path = defaultCredentialPath(), options = {}) {
 // package.json
 var package_default = {
   name: "intonear-erp-cli",
-  version: "0.2.1",
+  version: "0.2.4",
   description: "intoNear ERP \u6E10\u8FDB\u5F0F\u8BFB\u5199\u547D\u4EE4\u884C\u5BA2\u6237\u7AEF",
   type: "module",
   bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intonear-erp-cli",
-  "version": "0.2.1",
+  "version": "0.2.4",
   "description": "intoNear ERP 渐进式读写命令行客户端",
   "type": "module",
   "bin": {