@lark-apaas/miaoda-cli 0.1.3-alpha.a25d692 → 0.1.3-alpha.b499e4d

package/dist/api/file/client.js

@@ -90,7 +90,20 @@ const BIZ_ERR_MAP = new Map(Object.entries({
         message: 'A file at this path already exists',
         hint: 'Rename the target or delete the existing file first (`miaoda file rm`).',
     },
+    // k_ec_000040：file-storage 上游引擎层连不上下游服务（依赖抖动 / 远端 RPC 失败）。
+    // 文案不向用户暴露内部 code，统一成 INTERNAL_API_ERROR + 重试引导。
+    k_ec_000040: {
+        code: 'INTERNAL_API_ERROR',
+        message: 'Service temporarily unavailable',
+        hint: 'Please retry the command. If it keeps failing, share the x-tt-logid (via --verbose) with the on-call team.',
+    },
 }));
+// k_ec_* 命名空间是 file-storage 引擎层通用错误（基础设施 / 上游 RPC），不是
+// 用户输入问题。无显式条目时统一兜底成 INTERNAL_API_ERROR + 重试 hint，避免
+// 暴露内部 code 给最终用户。
+function isEngineCommonError(code) {
+    return /^k_ec_\d+$/.test(code);
+}
 function ensureSuccess(body) {
     // 后端 envelope 字段历史遗留多种命名：
     //   - ErrorCode / error_code: 部分接口
@@ -106,6 +119,15 @@ function ensureSuccess(body) {
             next_actions: mapped.hint ? [mapped.hint] : undefined,
         });
     }
+    // k_ec_* 引擎层错误统一兜底：用户视角是"服务暂时不可用"，重试即可，
+    // 不要把 `File API error [k_ec_000xxx]: <内部翻译>` 这种半成品文案抛给用户。
+    if (isEngineCommonError(code)) {
+        throw new error_1.AppError('INTERNAL_API_ERROR', 'Service temporarily unavailable', {
+            next_actions: [
+                `Please retry the command. If it keeps failing, share the x-tt-logid (via --verbose) with the on-call team. (upstream code: ${code})`,
+            ],
+        });
+    }
     throw new error_1.AppError(`FILE_API_${code}`, `File API error [${code}]: ${backendMsg}`);
 }
 /** 从 HttpError 的 response 里尝试读 body，用于拿后端返的业务 ErrorCode。 */
@@ -130,6 +152,24 @@ async function mapHttpError(err, opts) {
         if (body) {
             const code = body.ErrorCode ?? body.error_code ?? '';
             if (code && code !== '0') {
+                const mapped = BIZ_ERR_MAP.get(code);
+                if (mapped) {
+                    const msg = body.ErrorMessage ??
+                        body.error_message ??
+                        body.Message ??
+                        mapped.message ??
+                        err.message;
+                    throw new error_1.AppError(mapped.code, mapped.message ?? msg, {
+                        next_actions: mapped.hint ? [mapped.hint] : undefined,
+                    });
+                }
+                if (isEngineCommonError(code)) {
+                    throw new error_1.AppError('INTERNAL_API_ERROR', 'Service temporarily unavailable', {
+                        next_actions: [
+                            `Please retry the command. If it keeps failing, share the x-tt-logid (via --verbose) with the on-call team. (upstream code: ${code})`,
+                        ],
+                    });
+                }
                 const msg = body.ErrorMessage ?? body.error_message ?? body.Message ?? err.message;
                 throw new error_1.AppError(`FILE_API_${code}`, `File API error [${code}]: ${msg}`);
             }

package/dist/cli/commands/file/index.js

@@ -212,9 +212,29 @@ Examples:
 `);
     fileCmd
         .command('quota')
-        .summary('查看文件存储用量与限额')
+        .summary('查看文件存储的用量与配额')
+        .description('查看文件存储的用量与配额。')
         .usage('[flags]')
         .action(async function () {
         await (0, index_1.handleFileQuota)(this.optsWithGlobals());
-    });
+    })
+        .addHelpText('after', `
+Examples:
+  $ miaoda file quota
+   Storage:  150 MB / 1 GB (15%)
+     Files:  42
+
+  # --json
+  $ miaoda file quota --json
+  {
+    "data": {
+      "storage_used_bytes": 157286400,
+      "storage_quota_bytes": 1073741824,
+      "usage_percent": 15,
+      "files": 42
+    },
+    "next_cursor": null,
+    "has_more": false
+  }
+`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.3-alpha.a25d692",
+  "version": "0.1.3-alpha.b499e4d",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {