@lark-apaas/miaoda-cli 0.1.3-alpha.70f9b2d → 0.1.3-alpha.848d934

package/dist/api/db/api.js

@@ -436,7 +436,9 @@ async function listAuditLog(opts) {
     }
     const client = (0, http_1.getHttpClient)();
     const url = (0, client_1.buildInnerUrl)(opts.appId, '/db/audit/log', {
-        tables: opts.tables.join(','),
+        // IDL `Tables list<string>` 走重复 query key（?tables=A&tables=B）—— join(',')
+        // 会让 Hertz/Kitex 网关绑成 ["A,B"] 单元素切片，命中单表错误分支报错文案错乱。
+        tables: opts.tables,
         since: opts.since,
         until: opts.until,
         limit: opts.limit !== undefined ? String(opts.limit) : undefined,

package/dist/api/db/client.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SQLSTATE_MAP = void 0;
+exports.SQLSTATE_MAP = exports.ENV_CTX_TYPO = void 0;
 exports.traceHttp = traceHttp;
 exports.ensureInnerSuccess = ensureInnerSuccess;
 exports.mapDataloomBizError = mapDataloomBizError;
@@ -71,7 +71,8 @@ function ensureInnerSuccess(body) {
  *
  * 优先级：
  *   1. k_dl_1300002 + SQLSTATE 透传     → SQLSTATE_MAP
- *   2. k_dl_1600000 + "Invalid DB Branch" → MULTI_ENV_NOT_INITIALIZED
+ *   2. k_dl_1600000 + "Invalid DB Branch" → UNKNOWN_ENV_VALUE 占位（mapDbHttpError
+ *      会用用户实际 --env 值通过 decorateEnvError 重写）
  *   3. BIZ_ERR_MAP 命中 → 语义 code（可能带 hint）
  *   4. 兜底 DB_API_<code>
  *
@@ -102,51 +103,70 @@ function mapDataloomBizError(code, rawMessage) {
     }
     return new error_1.AppError(`DB_API_${code}`, message);
 }
+/**
+ * typo / CLI vocab violation 路径用：state 未知，列双 env 让用户在 dev/online 之间选，
+ * 不引导 init（init 不会创建 typo 出来的分支）。
+ */
+exports.ENV_CTX_TYPO = {
+    available: ['dev', 'online'],
+    suggestInit: false,
+};
 /**
  * 统一构造"--env 值不可用"错误。两类入口共用：
  *   - CLI vocab 校验（_env.ts validateEnv）：用户传 dev/main/online 以外值
  *   - backend state 错（decorateEnvError）：vocab 合法但 db 实际状态对不上
- * 两者用户角度都是「这个 env 不存在」，文案统一避免在两种失败之间困惑。
  *
- * `available` 推断逻辑：dev 不可用 → 主分支仍在，列 main/online；online/main 不可用
- * → 罕见，列 dev 占位。不去查 backend，保持纯函数性。
+ * `available` 跟 `suggestInit` 由调用方按错误码归类传入；user-facing 不展示 `main`
+ * 内部别名，统一用 `online`。
  */
-function buildUnknownEnvError(env) {
-    const available = env === 'dev' ? 'main, online' : 'dev';
+function buildUnknownEnvError(env, ctx = exports.ENV_CTX_TYPO) {
+    const hints = [
+        `--env must match an existing database branch. Available: ${ctx.available.join(', ')}.`,
+    ];
+    if (ctx.suggestInit) {
+        hints.push(`Run \`miaoda db migration init\` before using '${env}'.`);
+    }
     return new error_1.AppError('UNKNOWN_ENV_VALUE', `Unknown --env value '${env}'`, {
-        next_actions: [
-            `--env must match an existing database branch. Available: ${available}.`,
-            `Run \`miaoda db migration init\` before using '${env}'.`,
-        ],
+        next_actions: hints,
     });
 }
 /**
- * 把 backend env 相关错误统一重写成 UNKNOWN_ENV_VALUE 文案。
+ * 把 backend env 相关错误统一重写成 UNKNOWN_ENV_VALUE 文案，按错误码做 state 推断：
  *
- * 命中条件：
- *   - UNKNOWN_ENV_VALUE：上面 mapDataloomBizError 对 k_dl_1600000 的封装，env 占位
- *     用 server 返回的分支名，这里改写成用户实际传入的 --env 值
- *   - DB_API_k_dl_1300039：dataloom requireExpertMultiEnv 抛 Multi-env not initialized
- *   - DB_API_k_dl_000007 + "db branch not found"：pg connection 层 ErrParamsInvalid
+ *   - DB_API_k_dl_1300033（非专家应用）→ 单 env (online)，不建议 init
+ *   - DB_API_k_dl_1300039（专家未 init）→ 单 env (online)，建议 init
+ *   - DB_API_k_dl_000007 + "db branch not found"（pg connection 兜底）→ 单 env，建议 init
+ *   - UNKNOWN_ENV_VALUE（mapDataloomBizError 对 k_dl_1600000 的占位）→ typo path
  *
- * env 未传时不改写：避免把 backend 兜底文案（"Multi-env is not initialized"）改成
- * 以 `Unknown --env value ''` 这种空字符串错误。
+ * env 未传时不改写：避免把 backend 兜底文案（如 "Multi-env is not initialized"）
+ * 改成 `Unknown --env value ''` 这种空字符串错误。
  */
 function decorateEnvError(err, env) {
     if (env === undefined || env === '')
         return err;
-    if (!isEnvNotFoundError(err))
+    const ctx = classifyEnvError(err);
+    if (!ctx)
         return err;
-    return buildUnknownEnvError(env);
+    return buildUnknownEnvError(env, ctx);
 }
-function isEnvNotFoundError(err) {
-    if (err.code === 'UNKNOWN_ENV_VALUE')
-        return true;
-    if (err.code === 'DB_API_k_dl_1300039')
-        return true;
-    if (err.code === 'DB_API_k_dl_000007' && /db branch not found/i.test(err.message))
-        return true;
-    return false;
+function classifyEnvError(err) {
+    if (err.code === 'DB_API_k_dl_1300033') {
+        // 非专家应用：init 也会被同一 guard 拒掉，建议 init 是误导
+        return { available: ['online'], suggestInit: false };
+    }
+    if (err.code === 'DB_API_k_dl_1300039') {
+        // 专家未 init：init 会创建 dev 分支
+        return { available: ['online'], suggestInit: true };
+    }
+    if (err.code === 'DB_API_k_dl_000007' && /db branch not found/i.test(err.message)) {
+        // pg connection 层 ErrParamsInvalid：大概率 pre-init；建议 init（非专家会被 init 路径拦）
+        return { available: ['online'], suggestInit: true };
+    }
+    if (err.code === 'UNKNOWN_ENV_VALUE') {
+        // mapDataloomBizError 对 k_dl_1600000 的占位：typo path，state 未知，列双 env
+        return exports.ENV_CTX_TYPO;
+    }
+    return null;
 }
 /**
  * 剥掉 PG 透传错误的 "ERROR:" 前缀：CLI 输出本身就会前缀 "Error:"，
@@ -255,12 +275,25 @@ function buildInnerUrl(appId, path, query) {
     let url = `/v1/dataloom/app/${encodeURIComponent(appId)}${normalized}`;
     if (query) {
         const usp = new URLSearchParams();
-        for (const [k, v] of Object.entries(query)) {
-            if (v === undefined || v === '')
+        for (const [k, rawV] of Object.entries(query)) {
+            if (rawV === undefined)
+                continue;
+            // 数组值 → 重复 key 编码（?k=v1&k=v2）。IDL 里 list<string> 类型经
+            // Hertz/Kitex HTTP→Thrift 网关绑定 slice 字段需要重复 key；如果改成
+            // join(',') 单串，后端会拿到 ["v1,v2"] 单元素切片而非 ["v1","v2"]。
+            if (typeof rawV !== 'string') {
+                for (const item of rawV) {
+                    if (item === '')
+                        continue;
+                    usp.append(k, item);
+                }
+                continue;
+            }
+            if (rawV === '')
                 continue;
             // dbBranch 兼容用户视角的 `online` 别名 → 后端实际 dbBranch 名为 `main`，
             // 这里集中归一，避免每个 API 函数各自处理。其他值（dev / 自定义分支）原样透传。
-            const norm = k === 'dbBranch' && v === 'online' ? 'main' : v;
+            const norm = k === 'dbBranch' && rawV === 'online' ? 'main' : rawV;
             usp.append(k, norm);
         }
         const qs = usp.toString();

package/dist/cli/handlers/db/recovery.js

@@ -203,20 +203,17 @@ async function runRecoveryPreview(appId, ts, rawTarget) {
 }
 // ── helpers ──
 /**
- * 把用户传入的 recovery target 格式化成 spinner / 日志展示用的紧凑字符串：
- *   - 相对值（30s / 5m / 2h / 3d / 1w）→ 原样 + " ago"，如 "20m ago"
- *   - 绝对值 → 解析后用本地时区重新格式化成 ISO 8601 with offset，如
- *     "2026-05-20T22:32:00+08:00"
- *   - 解析失败 → 原样返回兜底
+ * 把用户传入的 recovery target 解析成本地时区的 ISO 8601 字符串，
+ * 如 "2026-05-20T22:32:00+08:00"。无论用户传相对值（30m / 2h / 3d）还是绝对值，
+ * 都统一展示成"具体几点"，让用户一眼看清楚"目标恢复点是我本地几点"——
+ * "30m ago"这种相对描述虽然原样直观，但跟 backend dataloom 收到的实际时间点没有
+ * 显式对照，遇到长 poll 时间过去后会让人怀疑"算的到底是哪个点"。
  *
- * 不直接用 normalizeTimestamp 的 UTC 字符串：UTC 'Z' 后缀对用户读时间不直观，
- * 本地时区带 offset 让用户一眼看清楚"目标恢复点是我本地几点"。
+ * 不用 UTC 'Z' 后缀：用户读时间不直观；带 +/-HH:MM offset 一眼即懂时差。
+ * 解析失败 → 原样返回兜底，避免 spinner 渲染崩。
  */
 function formatRecoveryTargetForDisplay(rawInput) {
     const trimmed = rawInput.trim();
-    if (/^\d+[smhdw]$/i.test(trimmed)) {
-        return `${trimmed} ago`;
-    }
     let ms;
     try {
         ms = (0, time_1.parseTimeToMs)(trimmed);

package/package.json

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