@lark-apaas/miaoda-cli 0.1.2 → 0.1.3-alpha.09899c4

package/dist/api/file/client.js

@@ -20,9 +20,9 @@ function traceHttp(method, url, start, response, err) {
     try {
         const cost = Date.now() - start;
         const status = response?.status ?? 0;
-        const logid = response?.headers?.get?.("x-tt-logid") ?? "-";
+        const logid = response?.headers?.get?.('x-tt-logid') ?? '-';
         if (err !== undefined) {
-            const errMsg = err instanceof Error ? err.message : typeof err === "string" ? err : JSON.stringify(err);
+            const errMsg = err instanceof Error ? err.message : typeof err === 'string' ? err : JSON.stringify(err);
             (0, logger_1.debug)(`http ${method} ${url} ${String(status)} cost=${String(cost)}ms x-tt-logid=${logid} err=${errMsg}`);
             return;
         }
@@ -51,7 +51,7 @@ async function getDefaultBucketId(appId) {
     ensureSuccess(body);
     const bucketId = body.data?.app_runtime_extra?.bucket?.default_bucket_id;
     if (!bucketId) {
-        throw new error_1.AppError("BUCKET_NOT_FOUND", `No default bucket for app '${appId}'`);
+        throw new error_1.AppError('BUCKET_NOT_FOUND', `No default bucket for app '${appId}'`);
     }
     bucketCache.set(appId, bucketId);
     return bucketId;
@@ -81,31 +81,53 @@ function resetBucketCache() {
  */
 const BIZ_ERR_MAP = new Map(Object.entries({
     k_img_ec_000034: {
-        code: "FILE_NOT_FOUND",
-        message: "File does not exist",
-        hint: "Run `miaoda file ls` to see available files.",
+        code: 'FILE_NOT_FOUND',
+        message: 'File does not exist',
+        hint: 'Run `miaoda file ls` to see available files.',
     },
     k_img_ec_000035: {
-        code: "FILE_ALREADY_EXISTS",
-        message: "A file at this path already exists",
-        hint: "Rename the target or delete the existing file first (`miaoda file rm`).",
+        code: 'FILE_ALREADY_EXISTS',
+        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: 部分接口
     //   - status_code: delete / sign / head / preUpload 等新接口
-    const code = body.ErrorCode ?? body.error_code ?? body.status_code ?? "0";
-    if (code === "0" || code === "")
+    const code = body.ErrorCode ?? body.error_code ?? body.status_code ?? '0';
+    if (code === '0' || code === '')
         return;
     // 错误 message 字段同样散：ErrorMessage / error_message / error_msg / Message
-    const backendMsg = body.ErrorMessage ?? body.error_message ?? body.error_msg ?? body.Message ?? "unknown error";
+    const backendMsg = body.ErrorMessage ?? body.error_message ?? body.error_msg ?? body.Message ?? 'unknown error';
     const mapped = BIZ_ERR_MAP.get(code);
     if (mapped) {
         throw new error_1.AppError(mapped.code, mapped.message ?? backendMsg, {
             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。 */
@@ -128,22 +150,40 @@ async function mapHttpError(err, opts) {
         const body = await extractBody(err.response);
         // 1. 先看后端业务 ErrorCode（优先级最高）
         if (body) {
-            const code = body.ErrorCode ?? body.error_code ?? "";
-            if (code && code !== "0") {
+            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}`);
             }
         }
         // 2. 404 常见情况 —— 路径不存在，映射到业务语义
         if (status === 404 && opts.notFoundCode) {
-            throw new error_1.AppError(opts.notFoundCode, opts.notFoundMessage ?? "resource not found", {
+            throw new error_1.AppError(opts.notFoundCode, opts.notFoundMessage ?? 'resource not found', {
                 next_actions: opts.notFoundHint ? [opts.notFoundHint] : undefined,
             });
         }
         // 3. 兜底：保留原始 status 的 HttpError（给上层看到真实状态码）
-        const ctx = opts.errorContext ?? "HTTP request failed";
-        const statusText = err.response?.statusText ?? "";
-        throw new error_1.HttpError(status, err.config.url ?? "", `${ctx}: ${String(status)} ${statusText}`.trim());
+        const ctx = opts.errorContext ?? 'HTTP request failed';
+        const statusText = err.response?.statusText ?? '';
+        throw new error_1.HttpError(status, err.config.url ?? '', `${ctx}: ${String(status)} ${statusText}`.trim());
     }
     throw err;
 }
@@ -156,11 +196,11 @@ async function doGet(url, opts = {}, client = (0, http_1.getHttpClient)()) {
     const start = Date.now();
     try {
         const response = await client.get(url);
-        traceHttp("GET", url, start, response);
+        traceHttp('GET', url, start, response);
         return (await response.json());
     }
     catch (err) {
-        traceHttp("GET", url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        traceHttp('GET', url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
         await mapHttpError(err, opts);
         throw err; // 不可达，mapHttpError 必定 throw
     }
@@ -170,11 +210,11 @@ async function doPost(url, body, opts = {}, client = (0, http_1.getHttpClient)()
     const start = Date.now();
     try {
         const response = await client.post(url, body);
-        traceHttp("POST", url, start, response);
+        traceHttp('POST', url, start, response);
         return (await response.json());
     }
     catch (err) {
-        traceHttp("POST", url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        traceHttp('POST', url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
         await mapHttpError(err, opts);
         throw err;
     }

package/dist/api/file/detect.js

@@ -41,9 +41,9 @@ const BACKEND_KEY_PATTERN = /^\d{16,}(?:\.[a-zA-Z0-9]{1,10}){0,2}$/;
 function looksLikePath(input) {
     if (!input)
         return false;
-    if (input.startsWith("/"))
+    if (input.startsWith('/'))
         return true;
-    if (input.includes("/"))
+    if (input.includes('/'))
         return true;
     return BACKEND_KEY_PATTERN.test(input);
 }
@@ -52,5 +52,5 @@ function looksLikePath(input) {
  * 便于从 auto-detected 的 "abc123...xyz.txt" 回到统一的 `/abc123...xyz.txt`。
  */
 function toAbsolutePath(input) {
-    return input.startsWith("/") ? input : `/${input}`;
+    return input.startsWith('/') ? input : `/${input}`;
 }

package/dist/api/file/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toAbsolutePath = exports.looksLikePath = exports.resetBucketCache = exports.getDefaultBucketId = exports.parseTimeFilterMs = exports.resolveInputs = exports.deleteFiles = exports.downloadFile = exports.signDownload = exports.uploadFile = exports.statFile = exports.listFiles = void 0;
+exports.toAbsolutePath = exports.looksLikePath = exports.resetBucketCache = exports.getDefaultBucketId = exports.getStorageQuota = exports.parseTimeFilterMs = exports.resolveInputs = exports.deleteFiles = exports.downloadFile = exports.signDownload = exports.uploadFile = exports.statFile = exports.listFiles = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "listFiles", { enumerable: true, get: function () { return api_1.listFiles; } });
 Object.defineProperty(exports, "statFile", { enumerable: true, get: function () { return api_1.statFile; } });
@@ -10,6 +10,7 @@ Object.defineProperty(exports, "downloadFile", { enumerable: true, get: function
 Object.defineProperty(exports, "deleteFiles", { enumerable: true, get: function () { return api_1.deleteFiles; } });
 Object.defineProperty(exports, "resolveInputs", { enumerable: true, get: function () { return api_1.resolveInputs; } });
 Object.defineProperty(exports, "parseTimeFilterMs", { enumerable: true, get: function () { return api_1.parseTimeFilterMs; } });
+Object.defineProperty(exports, "getStorageQuota", { enumerable: true, get: function () { return api_1.getStorageQuota; } });
 var client_1 = require("./client");
 Object.defineProperty(exports, "getDefaultBucketId", { enumerable: true, get: function () { return client_1.getDefaultBucketId; } });
 Object.defineProperty(exports, "resetBucketCache", { enumerable: true, get: function () { return client_1.resetBucketCache; } });

package/dist/api/file/parsers.js

@@ -3,12 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseAttachment = parseAttachment;
 exports.parseHead = parseHead;
 /** 安全读取字符串字段（空字符串回退为默认值） */
-function str(value, fallback = "") {
-    return typeof value === "string" && value.length > 0 ? value : fallback;
+function str(value, fallback = '') {
+    return typeof value === 'string' && value.length > 0 ? value : fallback;
 }
 /** 安全读取数字字段（非正值回退到 0） */
 function int(value) {
-    if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
+    if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {
         return Math.trunc(value);
     }
     return 0;
@@ -26,7 +26,7 @@ function readSize(meta) {
 function toDisplayPath(p) {
     if (!p)
         return p;
-    return p.startsWith("/") ? p : `/${p}`;
+    return p.startsWith('/') ? p : `/${p}`;
 }
 /** 将后端 attachment 结构映射为 CLI FileInfo（用于 ls） */
 function parseAttachment(att) {
@@ -41,8 +41,9 @@ function parseAttachment(att) {
     const downloadUrl = str(att.downloadURL);
     if (downloadUrl)
         info.download_url = downloadUrl;
-    // uploaded_by 从 createdBy.name 映射（后端返 {userID, name, email, ...}，空代表匿名）
-    const uploader = str(att.createdBy?.name);
+    // uploaded_by 输出 {id, name} 对象：后端 createdBy: {userID, name, email, ...}，
+    // 任一非空都建对象；JSON 用对象、pretty 渲染只取 name。
+    const uploader = toUploaderRef(att.createdBy);
     if (uploader)
         info.uploaded_by = uploader;
     return info;
@@ -61,8 +62,18 @@ function parseHead(data, filePath) {
     const downloadUrl = str(outer.downloadURL);
     if (downloadUrl)
         info.download_url = downloadUrl;
-    const uploader = str(outer.createdBy?.name);
+    const uploader = toUploaderRef(outer.createdBy);
     if (uploader)
         info.uploaded_by = uploader;
     return info;
 }
+/** 把后端 UserRef 归一成 CLI 暴露的 {id, name}；id / name 全空时返 undefined 略过字段。 */
+function toUploaderRef(user) {
+    if (!user)
+        return undefined;
+    const id = str(user.userID);
+    const name = str(user.name);
+    if (id === '' && name === '')
+        return undefined;
+    return { id, name };
+}

package/dist/api/index.js

@@ -33,10 +33,16 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.db = exports.file = exports.plugin = void 0;
+exports.deploy = exports.app = exports.observability = exports.db = exports.file = exports.plugin = void 0;
 const _plugin = __importStar(require("../api/plugin/index"));
 const _file = __importStar(require("../api/file/index"));
 const _db = __importStar(require("../api/db/index"));
+const _observability = __importStar(require("../api/observability/index"));
+const _app = __importStar(require("../api/app/index"));
+const _deploy = __importStar(require("../api/deploy/index"));
 exports.plugin = { ..._plugin };
 exports.file = { ..._file };
 exports.db = { ..._db };
+exports.observability = { ..._observability };
+exports.app = { ..._app };
+exports.deploy = { ..._deploy };

package/dist/api/observability/api.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchLogs = searchLogs;
+exports.searchTraces = searchTraces;
+exports.getTraces = getTraces;
+exports.queryMetricsData = queryMetricsData;
+exports.queryAnalyticsData = queryAnalyticsData;
+const http_1 = require("../../utils/http");
+const DEFAULT_ERR_CODE = 'INTERNAL_OB_ERROR';
+// ── 日志 ──
+async function searchLogs(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/logs/search`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: 'Failed to search logs',
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+// ── 链路 ──
+async function searchTraces(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/traces/search`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: 'Failed to search traces',
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+async function getTraces(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/traces/${encodeURIComponent(req.traceID)}`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: 'Failed to get trace',
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+// ── 监控指标 ──
+async function queryMetricsData(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/metrics/data/query`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: 'Failed to query metrics',
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+// ── 运营指标 ──
+//
+// 走 BAM v1.0.122 起的批量端点 CLIBatchQueryAnalyticsData：
+//   - 路径 /analytics/data/batch_query（旧版 /analytics/data/query 已废弃）
+//   - 支持 metricTypes 数组，单次拉多个指标
+async function queryAnalyticsData(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/analytics/data/batch_query`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: 'Failed to query analytics',
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}

package/dist/api/observability/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusCode = exports.SpanKind = exports.WordOperator = exports.spanSchema = exports.logItemSchema = exports.queryAnalyticsData = exports.queryMetricsData = exports.getTraces = exports.searchTraces = exports.searchLogs = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "searchLogs", { enumerable: true, get: function () { return api_1.searchLogs; } });
+Object.defineProperty(exports, "searchTraces", { enumerable: true, get: function () { return api_1.searchTraces; } });
+Object.defineProperty(exports, "getTraces", { enumerable: true, get: function () { return api_1.getTraces; } });
+Object.defineProperty(exports, "queryMetricsData", { enumerable: true, get: function () { return api_1.queryMetricsData; } });
+Object.defineProperty(exports, "queryAnalyticsData", { enumerable: true, get: function () { return api_1.queryAnalyticsData; } });
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "logItemSchema", { enumerable: true, get: function () { return schemas_1.logItemSchema; } });
+Object.defineProperty(exports, "spanSchema", { enumerable: true, get: function () { return schemas_1.spanSchema; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "WordOperator", { enumerable: true, get: function () { return types_1.WordOperator; } });
+Object.defineProperty(exports, "SpanKind", { enumerable: true, get: function () { return types_1.SpanKind; } });
+Object.defineProperty(exports, "StatusCode", { enumerable: true, get: function () { return types_1.StatusCode; } });

package/dist/api/observability/schemas.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spanSchema = exports.logItemSchema = void 0;
+const output_1 = require("../../utils/output");
+/** LogItem 渲染契约（log search） */
+exports.logItemSchema = {
+    columns: [
+        { key: 'timestampNs', label: 'time', format: output_1.fmt.ns('yyyy-MM-dd HH:mm:ss.SSS') },
+        {
+            key: 'module',
+            derive: (row) => {
+                return row.attributes?.module;
+            },
+        },
+        {
+            key: 'user-id',
+            derive: (row) => {
+                return row.attributes?.user_id;
+            },
+        },
+        { key: 'severityText', label: 'severity-text' },
+        {
+            key: 'duration',
+            format: output_1.fmt.durationMs(),
+            derive: (row) => {
+                return row.attributes?.duration_ms;
+            },
+        },
+        { key: 'traceID', label: 'trace-id' },
+        { key: 'id', label: 'log-id' },
+        { key: 'body' },
+    ],
+    strict: true,
+};
+/** Span 渲染契约（trace list / trace get 复用）。
+ *  duration 是 client-derived（BAM 只给 start/end，没有原生 durationNs 字段）。 */
+exports.spanSchema = {
+    columns: [
+        { key: 'startTimeUnixNano', label: 'start-time', format: output_1.fmt.ns('yyyy-MM-dd HH:mm:ss.SSS') },
+        { key: 'name', label: 'root-span' },
+        {
+            key: 'user-id',
+            derive: (row) => {
+                return row.attributes?.user_id;
+            },
+        },
+        {
+            key: 'duration',
+            label: 'duration',
+            format: output_1.fmt.durationMs(),
+            derive: (row) => {
+                return row.attributes?.duration_ms;
+            },
+        },
+        { key: 'traceID', label: 'trace-id' },
+    ],
+    strict: true,
+};
+// metric / analytics 都改用 BAM v1.0.123 起的合并响应（points: {timestamp, values}），
+// pretty 渲染走 handler 内 pivot 后的临时 schema；不再导出固定 schema。

package/dist/api/observability/types.js

@@ -0,0 +1,27 @@
+"use strict";
+// ── 通用结构 ──
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusCode = exports.SpanKind = exports.WordOperator = void 0;
+/** 模糊搜索词运算符（对应后端 WordOperator） */
+var WordOperator;
+(function (WordOperator) {
+    WordOperator[WordOperator["AND"] = 0] = "AND";
+    WordOperator[WordOperator["OR"] = 1] = "OR";
+})(WordOperator || (exports.WordOperator = WordOperator = {}));
+/** OpenTelemetry SpanKind（BAM 透传） */
+var SpanKind;
+(function (SpanKind) {
+    SpanKind[SpanKind["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    SpanKind[SpanKind["INTERNAL"] = 1] = "INTERNAL";
+    SpanKind[SpanKind["SERVER"] = 2] = "SERVER";
+    SpanKind[SpanKind["CLIENT"] = 3] = "CLIENT";
+    SpanKind[SpanKind["PRODUCER"] = 4] = "PRODUCER";
+    SpanKind[SpanKind["CONSUMER"] = 5] = "CONSUMER";
+})(SpanKind || (exports.SpanKind = SpanKind = {}));
+/** Span 状态码（BAM 透传） */
+var StatusCode;
+(function (StatusCode) {
+    StatusCode[StatusCode["UNSET"] = 0] = "UNSET";
+    StatusCode[StatusCode["OK"] = 1] = "OK";
+    StatusCode[StatusCode["ERROR"] = 2] = "ERROR";
+})(StatusCode || (exports.StatusCode = StatusCode = {}));

package/dist/api/plugin/api.js

@@ -23,23 +23,23 @@ const node_path_1 = __importDefault(require("node:path"));
 // ── Plugin Version API ──
 async function getPluginVersions(keys, latestOnly = true) {
     const client = (0, http_1.getRuntimeHttpClient)();
-    const response = await client.post(`/api/v1/studio/innerapi/plugins/-/versions/batch_get?keys=${keys.join(",")}&latest_only=${String(latestOnly)}`);
+    const response = await client.post(`/api/v1/studio/innerapi/plugins/-/versions/batch_get?keys=${keys.join(',')}&latest_only=${String(latestOnly)}`);
     if (!response.ok) {
         throw new error_1.HttpError(response.status, response.url, `Failed to get plugin versions: ${String(response.status)} ${response.statusText}`);
     }
     const result = (await response.json());
-    if (result.status_code !== "0") {
-        throw new error_1.AppError("INTERNAL_API_ERROR", `API error: ${result.message ?? "unknown"}`);
+    if (result.status_code !== '0') {
+        throw new error_1.AppError('INTERNAL_API_ERROR', `API error: ${result.message ?? 'unknown'}`);
     }
     return result.data.pluginVersions;
 }
 async function getPluginVersion(pluginKey, requestedVersion) {
-    const isLatest = requestedVersion === "latest";
+    const isLatest = requestedVersion === 'latest';
     const versions = await getPluginVersions([pluginKey], isLatest);
     const pluginVersions = versions[pluginKey];
     if (!pluginVersions || pluginVersions.length === 0) {
-        throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin not found: ${pluginKey}`, {
-            next_actions: ["检查包名拼写，或确认该插件已在插件市场发布"],
+        throw new error_1.AppError('PLUGIN_NOT_FOUND', `Plugin not found: ${pluginKey}`, {
+            next_actions: ['检查包名拼写，或确认该插件已在插件市场发布'],
         });
     }
     if (isLatest) {
@@ -47,7 +47,7 @@ async function getPluginVersion(pluginKey, requestedVersion) {
     }
     const targetVersion = pluginVersions.find((v) => v.version === requestedVersion);
     if (!targetVersion) {
-        throw new error_1.AppError("VERSION_NOT_FOUND", `Version ${requestedVersion} not found for plugin ${pluginKey}`, { next_actions: [`可用版本：${pluginVersions.map((v) => v.version).join(", ")}`] });
+        throw new error_1.AppError('VERSION_NOT_FOUND', `Version ${requestedVersion} not found for plugin ${pluginKey}`, { next_actions: [`可用版本：${pluginVersions.map((v) => v.version).join(', ')}`] });
     }
     return targetVersion;
 }
@@ -55,8 +55,8 @@ async function getPluginVersion(pluginKey, requestedVersion) {
 function parsePluginKey(key) {
     const match = /^(@[^/]+)\/(.+)$/.exec(key);
     if (!match) {
-        throw new error_1.AppError("INVALID_PLUGIN_KEY", `Invalid plugin key format: ${key}`, {
-            next_actions: ["插件 key 必须形如 @scope/name"],
+        throw new error_1.AppError('INVALID_PLUGIN_KEY', `Invalid plugin key format: ${key}`, {
+            next_actions: ['插件 key 必须形如 @scope/name'],
         });
     }
     return { scope: match[1], name: match[2] };
@@ -91,15 +91,15 @@ async function withRetry(operation, description, maxRetries = MAX_RETRIES) {
         catch (error) {
             lastError = error instanceof Error ? error : new Error(String(error));
             if (attempt < maxRetries) {
-                (0, logger_1.log)("plugin", `${description} failed, retrying (${String(attempt + 1)}/${String(maxRetries)})...`);
+                (0, logger_1.log)('plugin', `${description} failed, retrying (${String(attempt + 1)}/${String(maxRetries)})...`);
             }
         }
     }
     throw (lastError ??
-        new error_1.AppError("INTERNAL_RETRY_EXHAUSTED", `${description} failed after ${String(maxRetries)} retries`, { retryable: true, next_actions: ["检查网络后重试，--verbose 可查看重试日志"] }));
+        new error_1.AppError('INTERNAL_RETRY_EXHAUSTED', `${description} failed after ${String(maxRetries)} retries`, { retryable: true, next_actions: ['检查网络后重试，--verbose 可查看重试日志'] }));
 }
 /** 插件缓存目录 */
-const PLUGIN_CACHE_DIR = "node_modules/.cache/miaoda-cli/plugins";
+const PLUGIN_CACHE_DIR = 'node_modules/.cache/miaoda-cli/plugins';
 function getPluginCacheDir() {
     return node_path_1.default.join(process.cwd(), PLUGIN_CACHE_DIR);
 }
@@ -111,18 +111,18 @@ function ensureCacheDir() {
 }
 function getTempFilePath(pluginKey, version) {
     ensureCacheDir();
-    const safeKey = pluginKey.replace(/[/@]/g, "_");
+    const safeKey = pluginKey.replace(/[/@]/g, '_');
     const filename = `${safeKey}@${version}.tgz`;
     return node_path_1.default.join(getPluginCacheDir(), filename);
 }
 async function downloadPlugin(pluginKey, requestedVersion) {
     const pluginInfo = await getPluginVersion(pluginKey, requestedVersion);
     let tgzBuffer;
-    if (pluginInfo.downloadApproach === "inner") {
-        tgzBuffer = await withRetry(() => downloadFromInner(pluginKey, pluginInfo.version), "Download");
+    if (pluginInfo.downloadApproach === 'inner') {
+        tgzBuffer = await withRetry(() => downloadFromInner(pluginKey, pluginInfo.version), 'Download');
     }
     else {
-        tgzBuffer = await withRetry(() => downloadFromPublic(pluginInfo.downloadURL), "Download");
+        tgzBuffer = await withRetry(() => downloadFromPublic(pluginInfo.downloadURL), 'Download');
     }
     const tgzPath = getTempFilePath(pluginKey, pluginInfo.version);
     node_fs_1.default.writeFileSync(tgzPath, tgzBuffer);
@@ -135,7 +135,7 @@ async function downloadPlugin(pluginKey, requestedVersion) {
 // ── Cache ──
 function getCachePath(pluginKey, version) {
     ensureCacheDir();
-    const safeKey = pluginKey.replace(/[/@]/g, "_");
+    const safeKey = pluginKey.replace(/[/@]/g, '_');
     const filename = `${safeKey}@${version}.tgz`;
     return node_path_1.default.join(getPluginCacheDir(), filename);
 }
@@ -151,13 +151,13 @@ function listCachedPlugins() {
     const files = node_fs_1.default.readdirSync(cacheDir);
     const result = [];
     for (const file of files) {
-        if (!file.endsWith(".tgz"))
+        if (!file.endsWith('.tgz'))
             continue;
         const match = /^(.+)@(.+)\.tgz$/.exec(file);
         if (!match)
             continue;
         const [, rawName, version] = match;
-        const name = rawName.replace(/^_/, "@").replace(/_/, "/");
+        const name = rawName.replace(/^_/, '@').replace(/_/, '/');
         const filePath = node_path_1.default.join(cacheDir, file);
         const stat = node_fs_1.default.statSync(filePath);
         result.push({ name, version, filePath, size: stat.size, mtime: stat.mtime });
@@ -172,7 +172,7 @@ function cleanAllCache() {
     const files = node_fs_1.default.readdirSync(cacheDir);
     let count = 0;
     for (const file of files) {
-        if (file.endsWith(".tgz")) {
+        if (file.endsWith('.tgz')) {
             node_fs_1.default.unlinkSync(node_path_1.default.join(cacheDir, file));
             count++;
         }
@@ -184,7 +184,7 @@ function cleanPluginCache(pluginKey, version) {
     if (!node_fs_1.default.existsSync(cacheDir)) {
         return 0;
     }
-    const safeKey = pluginKey.replace(/[/@]/g, "_");
+    const safeKey = pluginKey.replace(/[/@]/g, '_');
     const files = node_fs_1.default.readdirSync(cacheDir);
     let count = 0;
     for (const file of files) {
@@ -195,7 +195,7 @@ function cleanPluginCache(pluginKey, version) {
             }
         }
         else {
-            if (file.startsWith(`${safeKey}@`) && file.endsWith(".tgz")) {
+            if (file.startsWith(`${safeKey}@`) && file.endsWith('.tgz')) {
                 node_fs_1.default.unlinkSync(node_path_1.default.join(cacheDir, file));
                 count++;
             }
@@ -209,29 +209,29 @@ async function reportEvents(events) {
         return true;
     try {
         const client = (0, http_1.getRuntimeHttpClient)();
-        const response = await client.post("/api/v1/studio/innerapi/resource_events", { events });
+        const response = await client.post('/api/v1/studio/innerapi/resource_events', { events });
         if (!response.ok) {
-            (0, logger_1.log)("telemetry", `Failed to report events: ${String(response.status)} ${response.statusText}`);
+            (0, logger_1.log)('telemetry', `Failed to report events: ${String(response.status)} ${response.statusText}`);
             return false;
         }
         const result = (await response.json());
-        if (result.status_code !== "0") {
-            (0, logger_1.log)("telemetry", `API error: ${result.message ?? "unknown"}`);
+        if (result.status_code !== '0') {
+            (0, logger_1.log)('telemetry', `API error: ${result.message ?? 'unknown'}`);
             return false;
         }
         return true;
     }
     catch (error) {
-        (0, logger_1.log)("telemetry", `Failed to report events: ${error instanceof Error ? error.message : String(error)}`);
+        (0, logger_1.log)('telemetry', `Failed to report events: ${error instanceof Error ? error.message : String(error)}`);
         return false;
     }
 }
 async function reportInstallEvent(pluginKey, version) {
     await reportEvents([
         {
-            resourceType: "plugin",
+            resourceType: 'plugin',
             resourceKey: pluginKey,
-            eventType: "install",
+            eventType: 'install',
             details: { version },
         },
     ]);
@@ -239,9 +239,9 @@ async function reportInstallEvent(pluginKey, version) {
 async function reportCreateInstanceEvent(pluginKey, version) {
     await reportEvents([
         {
-            resourceType: "plugin",
+            resourceType: 'plugin',
             resourceKey: pluginKey,
-            eventType: "create_instance",
+            eventType: 'create_instance',
             details: { version },
         },
     ]);