@cnbcool/cnb-api-generate 2.7.6 → 2.7.7

package/built/utils/flatten-tool-options.js

@@ -84,9 +84,12 @@ function flattenToolOptions(toolInfo) {
                 ? (0, clean_array_desc_1.cleanArrayDesc)((0, trim_summary_1.trimSummary)(prop.description || ''))
                 : (0, trim_summary_1.trimSummary)(prop.description || '');
             const arrayHint = isArray ? ' (可多次传入)' : '';
+            const fileRefHint = !isArray && prop.type === 'string' && key === 'body'
+                ? ' (支持 @file 引用)'
+                : '';
             const desc = isRequired
-                ? `[必填] ${rawDesc}${arrayHint}`
-                : `${rawDesc}${arrayHint}`;
+                ? `[必填] ${rawDesc}${arrayHint}${fileRefHint}`
+                : `${rawDesc}${arrayHint}${fileRefHint}`;
             const opt = {
                 optKey,
                 valuePlaceholder,

package/client/lib/format-params.ts

@@ -1,5 +1,5 @@
 import { helpData } from './help-data';
-import { tryParseJSON } from './parsers';
+import { tryParseJSON, tryReadFileRef } from './parsers';
 import { buildNestedFieldMap } from '../utils/build-nested-field-map';
 import type { NestedFieldMapping } from '../utils/build-nested-field-map';
 import { restoreOriginalKeys } from '../utils/restore-original-keys';
@@ -182,7 +182,8 @@ export function formatParams(
         } else if (bodyProps[key].type === 'string') {
           // schema 定义为 string 类型时，保持原始字符串，不做 JSON 解析
           // 避免纯数字字符串（如 "123"）被转为 number
-          formatted.data[key] = value;
+          // 支持 @file 语法：从文件读取长文本内容（避免 shell 长参数截断）
+          formatted.data[key] = tryReadFileRef(value as string);
         } else {
           formatted.data[key] = tryParseJSON(value as string);
         }

package/client/lib/parsers.ts

@@ -22,6 +22,10 @@ export function tryParseJSON(str: string | boolean | undefined): any {
 
 /**
  * 尝试从文件引用或 stdin 读取内容（类似 curl 的 @file / @- 语法）
+ *
+ * 注意：一旦用户显式使用 @ 前缀，就表示其意图是读取文件/stdin。
+ * 此时若文件不存在或读取失败，应直接报错退出，避免把 "@/path/xxx"
+ * 字面量当作正文发送出去导致数据错误。
  */
 export function tryReadFileRef(str: string | boolean | undefined) {
   if (typeof str !== 'string' || !str.startsWith('@')) return str;
@@ -33,17 +37,23 @@ export function tryReadFileRef(str: string | boolean | undefined) {
     try {
       return fs.readFileSync(0, 'utf8').trim();
     } catch (e) {
-      console.error('从 stdin 读取失败:', e.message);
-      return str;
+      console.error(`从 stdin 读取失败: ${e.message}`);
+      process.exit(1);
     }
   }
 
   // @/path/to/file 表示从文件读取
-  if (fs.existsSync(ref)) {
-    return fs.readFileSync(ref, 'utf8').trim();
+  if (!fs.existsSync(ref)) {
+    console.error(`文件不存在: ${ref}`);
+    process.exit(1);
   }
 
-  return str;
+  try {
+    return fs.readFileSync(ref, 'utf8').trim();
+  } catch (e) {
+    console.error(`读取文件失败: ${ref} - ${e.message}`);
+    process.exit(1);
+  }
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnbcool/cnb-api-generate",
-  "version": "2.7.6",
+  "version": "2.7.7",
   "main": "./built/index.js",
   "module": "./src/index.ts",
   "types": "./src/index.ts",