@lark-apaas/miaoda-cli 0.1.0-alpha.ca2912e → 0.1.0-alpha.d98ea14

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

@@ -2,74 +2,191 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerDbCommands = registerDbCommands;
 const index_1 = require("../../../cli/handlers/db/index");
-const shared_1 = require("../../../cli/commands/shared");
 function registerDbCommands(program) {
     const dbCmd = program
         .command("db")
-        .description("数据操作：SQL 执行、表结构查询、数据导入导出");
+        .description("数据库操作：执行 SQL、查看表结构、批量导入与导出数据")
+        .usage("<command> [flags]");
     dbCmd.action(() => {
         dbCmd.outputHelp();
     });
+    dbCmd.addHelpText("after", `
+Examples:
+  $ miaoda db sql "SELECT * FROM users LIMIT 5"
+  $ miaoda db schema list
+  $ miaoda db schema get users
+  $ miaoda db data import users.csv
+  $ miaoda db data export users
+`);
     dbCmd
         .command("sql")
-        .description("执行任意 SQL（SELECT / DML / DDL / TCL / EXPLAIN）；query 省略时读 stdin")
-        .argument("[query]", "要执行的 SQL 语句；省略时从 stdin 读取")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--env <env>", "目标环境（main / dev）；不传由后端按多环境状态兜底")
+        .description("执行任意 PostgreSQL 语句（DDL / DML / SELECT 等）")
+        .usage("[query] [flags]")
+        .argument("[query]", "要执行的 SQL 语句；省略时从标准输入读取")
+        .option("--env <env>", "目标环境（main / dev），未指定时按应用的多环境配置自动选择")
         .action(async (query, opts) => {
         await (0, index_1.handleDbSql)(query, opts);
-    });
+    })
+        .addHelpText("after", `
+Notes:
+  - 单条语句影响或返回的数据行数上限为 1000；超出会被拒绝执行
+  - 多条语句以分号分隔；任一语句失败时响应中会标明失败语句的位置（statement_index）
+  - 支持手写 BEGIN / COMMIT / ROLLBACK 自定义事务边界；事务执行中报错时服务端会自动回滚
+
+Examples:
+  $ miaoda db sql "SELECT * FROM users LIMIT 3"
+  ✓ 3 rows
+
+  $ miaoda db sql "CREATE TABLE t(id int)"
+  ✓ Statement executed
+
+  $ miaoda db sql < migration.sql
+  ✓ 5 statements executed
+
+  # 报错：多语句中第 1 条失败
+  $ miaoda db sql "CREATE TABLE t(id int); SELECT * FROM no_such"
+  Error: TABLE_NOT_FOUND at statement 1
+    hint: Run \`miaoda db schema list\` to see existing tables.
+`);
     // schema 二级资源分组
     const schemaCmd = dbCmd
         .command("schema")
-        .description("表结构查询");
+        .description("查看表结构：列出所有表、查看单张表的字段与索引")
+        .usage("<command> [flags]");
     schemaCmd.action(() => {
         schemaCmd.outputHelp();
     });
+    schemaCmd.addHelpText("after", `
+Examples:
+  $ miaoda db schema list
+  $ miaoda db schema get users
+  $ miaoda db schema get users --ddl
+`);
     schemaCmd
         .command("list")
-        .description("列出应用所有表（rows / size / columns / updated_at）")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--env <env>", "目标环境（main / dev）；不传由后端按多环境状态兜底")
+        .description("列出当前应用的所有表，包含行数、占用大小、列数等概要信息")
+        .usage("[flags]")
+        .option("--env <env>", "目标环境（main / dev），未指定时按应用的多环境配置自动选择")
         .action(async (opts) => {
         await (0, index_1.handleDbSchemaList)(opts);
-    });
+    })
+        .addHelpText("after", `
+Notes:
+  - rows 与 size_bytes 由 PostgreSQL 统计信息估算得出，与实际值可能存在偏差
+
+Examples:
+  $ miaoda db schema list
+  name      rows  size_bytes  columns
+  users     120   65536       6
+  orders    5400  327680      9
+
+  $ miaoda db schema list --env main
+`);
     schemaCmd
         .command("get")
-        .description("查看单表结构（字段 / 索引 / DDL）")
-        .argument("<table>", "表名")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--ddl", "TTY 下强制输出完整 DDL 而非结构化概览")
-        .option("--env <env>", "目标环境（main / dev）；不传由后端按多环境状态兜底")
+        .description("查看单张表的字段、索引和建表语句，也可用来检测表是否存在")
+        .usage("<table> [flags]")
+        .argument("<table>", "表名（无需带 schema 前缀）")
+        .option("--ddl", "仅输出 CREATE TABLE 建表语句")
+        .option("--env <env>", "目标环境（main / dev），未指定时按应用的多环境配置自动选择")
         .action(async (table, opts) => {
         await (0, index_1.handleDbSchemaGet)(table, opts);
-    });
+    })
+        .addHelpText("after", `
+Notes:
+  - 检测表是否存在：成功返回（退出码 0）即为存在；错误码 TABLE_NOT_FOUND 即为不存在
+
+Examples:
+  $ miaoda db schema get users
+  CREATE TABLE users (
+    id uuid NOT NULL DEFAULT gen_random_uuid(),
+    ...
+  );
+
+  $ miaoda db schema get users --ddl
+  CREATE TABLE users ( ... );
+
+  # 报错：表不存在
+  $ miaoda db schema get no_such
+  Error: TABLE_NOT_FOUND
+    hint: Run \`miaoda db schema list\` to see all tables.
+`);
     // data 二级资源分组
     const dataCmd = dbCmd
         .command("data")
-        .description("数据导入 / 导出");
+        .description("批量导入与导出表数据")
+        .usage("<command> [flags]");
     dataCmd.action(() => {
         dataCmd.outputHelp();
     });
+    dataCmd.addHelpText("after", `
+Examples:
+  $ miaoda db data import users.csv
+  $ miaoda db data import data.json --table customers
+  $ miaoda db data export users
+  $ miaoda db data export users --format json
+`);
     dataCmd
         .command("import")
-        .description("从 CSV / JSON 文件导入数据（P0：≤ 1 MB / ≤ 5000 行，单事务原子）")
-        .argument("<file>", "本地文件路径")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--table <name>", "目标表名；省略时按文件名推断")
-        .option("--format <fmt>", "csv | json；省略时按文件扩展名推断")
+        .description("将本地 CSV / JSON 文件批量导入到指定表")
+        .usage("<file> [flags]")
+        .argument("<file>", "本地文件路径（CSV 或 JSON 格式）")
+        .option("--table <name>", "目标表名；未指定时按文件名（不含扩展名）推断")
+        .option("--format <fmt>", "文件格式 csv / json；未指定时按文件扩展名推断")
         .action(async (file, opts) => {
         await (0, index_1.handleDbDataImport)(file, opts);
-    });
+    })
+        .addHelpText("after", `
+Notes:
+  - CSV 文件首行需为列名表头，与目标表字段名一一对应
+  - JSON 文件需为对象数组，每个对象的 key 与目标表字段名一一对应
+  - 单次最多 5000 行 / 1 MB；超出请分批导入
+  - 整批原子写入：任意一行失败时全部回滚，响应中包含失败行号和原因
+
+Examples:
+  $ miaoda db data import users.csv
+  ✓ Imported 120 rows into 'users'
+
+  $ miaoda db data import data.json --table customers
+  ✓ Imported 240 rows into 'customers'
+
+  $ miaoda db data import dump --table orders --format csv
+  ✓ Imported 80 rows into 'orders'
+
+  # 报错：第 5 行格式错误，整批回滚
+  $ miaoda db data import broken.csv
+  Error: ROW_PARSE_FAILED at row 5
+    hint: Check column count and value types match the table schema.
+`);
     dataCmd
         .command("export")
-        .description("导出整表到 CSV / JSON（P0：≤ 1 MB / ≤ 5000 行）")
-        .argument("<table>", "表名")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--format <fmt>", "csv | json；默认 csv")
-        .option("-f, --file <path>", "输出文件路径；默认 <table>.<format>")
-        .option("--limit <n>", "最多导出行数（≤ 5000）")
+        .description("将指定表的数据导出为 CSV / JSON 文件")
+        .usage("<table> [flags]")
+        .argument("<table>", "表名（无需带 schema 前缀）")
+        .option("--format <fmt>", "导出格式 csv / json，默认 csv")
+        .option("-f, --file <path>", "输出文件路径，默认 <table>.<format>")
+        .option("--limit <n>", "最多导出行数（不超过 5000）")
         .action(async (table, opts) => {
         await (0, index_1.handleDbDataExport)(table, opts);
-    });
+    })
+        .addHelpText("after", `
+Notes:
+  - 单次最多导出 5000 行 / 1 MB；超出请使用 --limit 控制或分批导出
+  - 按表的物理存储顺序导出，无固定排序；如需固定顺序，请改用 miaoda db sql 加 ORDER BY 自行写出文件
+
+Examples:
+  $ miaoda db data export users
+  ✓ Exported 120 rows to ./users.csv
+
+  $ miaoda db data export users --format json
+  ✓ Exported 120 rows to ./users.json
+
+  $ miaoda db data export users -f /tmp/u.csv --limit 1000
+  ✓ Exported 1000 rows to /tmp/u.csv
+
+  # 报错：表不存在
+  $ miaoda db data export no_such
+  Error: TABLE_NOT_FOUND
+    hint: Run \`miaoda db schema list\` to see all tables.
+`);
 }

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

@@ -2,66 +2,178 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerFileCommands = registerFileCommands;
 const index_1 = require("../../../cli/handlers/file/index");
-const shared_1 = require("../../../cli/commands/shared");
+const error_1 = require("../../../utils/error");
+/**
+ * commander option 校验器：把 --limit <n> 解析成正整数（≥1）。
+ * 默认值（如 "50"）会先经过这里被规范化成 number。
+ * 非整数 / 负数 / 0 抛 AppError("ARGS_INVALID")，由 main.ts 的全局 catch
+ * 走 emitError，同时 process.exitCode 由 commander 自然为 1。
+ */
+function parsePositiveInt(raw) {
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n < 1) {
+        throw new error_1.AppError("ARGS_INVALID", `--limit must be a positive integer (got '${raw}')`);
+    }
+    return n;
+}
 function registerFileCommands(program) {
     const fileCmd = program
         .command("file")
-        .description("文件操作：上传、下载、删除、查询");
+        .description("文件操作:上传、下载、删除、查询")
+        .usage("<command> [flags]");
     fileCmd.action(() => {
         fileCmd.outputHelp();
     });
+    fileCmd.addHelpText("after", `
+Examples:
+  $ miaoda file ls
+  $ miaoda file stat report.pdf
+  $ miaoda file cp report.pdf /uploads/
+  $ miaoda file cp /uploads/report.pdf .
+  $ miaoda file sign report.pdf
+  $ miaoda file rm a.txt b.txt -y
+`);
     fileCmd
         .command("ls")
-        .description("列出应用下的文件")
-        .argument("[query]", "可选筛选值：形似 /path、包含 / 或 16+位 fileKey 时按 path 精确匹配；否则按 file_name 精确匹配")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--path <path>", "按 path 精确匹配（跳过自动识别）")
-        .option("--name <name>", "按 file_name 精确匹配（跳过自动识别）")
-        .option("--type <mime>", "按 MIME 类型过滤（精确匹配）")
-        .option("--size-gt <size>", "大小大于，支持 B/KB/MB/GB")
-        .option("--size-lt <size>", "大小小于")
-        .option("--uploaded-since <time>", "上传时间晚于（ISO 8601）")
-        .option("--limit <n>", "返回条数上限", "50")
-        .option("--cursor <token>", "分页游标")
-        .option("--all", "自动翻页聚合全部结果")
+        .description("列出应用下的文件，可按名称、路径、MIME 类型、大小、上传时间筛选")
+        .usage("[query] [flags]")
+        .argument("[query]", "筛选值：以 / 开头视为路径精确匹配，否则按文件名精确匹配")
+        .option("--path <path>", "按路径精确匹配")
+        .option("--name <name>", "按文件名精确匹配")
+        .option("--type <mime>", "按 MIME 类型筛选（如 image/png）")
+        .option("--size-gt <size>", "文件大小下限（支持 B / KB / MB / GB）")
+        .option("--size-lt <size>", "文件大小上限（支持 B / KB / MB / GB）")
+        .option("--uploaded-since <time>", "上传时间下限（晚于该时间），支持：相对时间 1h / 2d / 1w；日期 YYYY-MM-DD；ISO 8601 如 2026-04-01T10:00:00Z")
+        .option("--uploaded-until <time>", "上传时间上限（早于该时间），支持：相对时间 1h / 2d / 1w；日期 YYYY-MM-DD；ISO 8601 如 2026-04-01T10:00:00Z")
+        .option("--limit <n>", "单次返回上限（正整数,默认 50）", parsePositiveInt, 50)
+        .option("--cursor <token>", "分页游标，从上次响应的 next_cursor 取值")
+        .option("--all", "自动翻页返回全部结果")
         .action(async (query, opts) => {
         await (0, index_1.handleFileLs)({ ...opts, query });
-    });
+    })
+        .addHelpText("after", `
+Notes:
+  - 默认按上传时间倒序展示
+  - --all 会自动翻页拉取全部结果，文件较多时耗时较长，建议先用筛选条件缩小范围
+
+Examples:
+  $ miaoda file ls
+  path                       size      uploaded_at
+  /uploads/report.pdf        1.2 MB    2026-04-20 10:00
+  /uploads/photo.png         800 KB    2026-04-21 14:30
+
+  $ miaoda file ls report.pdf
+  $ miaoda file ls --type image/png --size-gt 1MB
+  $ miaoda file ls --uploaded-since 1d           # 24 小时内上传
+  $ miaoda file ls --uploaded-since 2026-04-01 --uploaded-until 2026-04-30   # 4 月内上传
+`);
     fileCmd
         .command("stat")
-        .description("查看指定文件的元数据")
-        .argument("<file>", "path 或 file_name：自动识别（见 ls 命令说明）")
-        .addOption((0, shared_1.appIdOption)())
+        .description("查看文件元数据；获取下载链接请使用 miaoda file sign")
+        .usage("<file> [flags]")
+        .argument("<file>", "文件的路径或文件名（自动识别）")
         .action(async (file, opts) => {
         await (0, index_1.handleFileStat)(file, opts);
-    });
+    })
+        .addHelpText("after", `
+Notes:
+  - 仅返回元数据，不包含下载链接；如需分享或下载请使用 miaoda file sign 生成临时链接
+
+Examples:
+  $ miaoda file stat report.pdf
+  path:        /uploads/report.pdf
+  size:        1.2 MB
+  type:        application/pdf
+  uploaded_at: 2026-04-20 10:00
+
+  $ miaoda file stat /uploads/report.pdf
+
+  # 报错：文件不存在
+  $ miaoda file stat no_such.pdf
+  Error: FILE_NOT_FOUND
+    hint: Run \`miaoda file ls\` to see available files.
+`);
     fileCmd
         .command("cp")
-        .description("上传或下载文件（方向由 src/dst 自动判断）")
-        .argument("<src>", "源：本地路径 或 远程 /path / file_name")
-        .argument("<dst>", "目标：本地路径 或 远程路径")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--rename <name>", "上传后使用的新文件名")
+        .description("上传或下载文件，根据源和目标自动判断方向")
+        .usage("<src> <dst> [flags]")
+        .argument("<src>", "源：本地文件路径或远程文件路径 / 文件名")
+        .argument("<dst>", "目标：本地路径或远程路径")
+        .option("--rename <name>", "上传后在远端使用的新文件名")
         .action(async (src, dst, opts) => {
         await (0, index_1.handleFileCp)(src, dst, opts);
-    });
+    })
+        .addHelpText("after", `
+Notes:
+  - 源是本地存在的文件时，执行上传
+  - 源不是本地文件、目标是本地路径时，执行下载
+
+Examples:
+  $ miaoda file cp ./report.pdf /uploads/
+  ✓ Uploaded report.pdf → /uploads/report.pdf
+
+  $ miaoda file cp ./report.pdf /uploads/ --rename r.pdf
+  ✓ Uploaded report.pdf → /uploads/r.pdf
+
+  $ miaoda file cp /uploads/report.pdf .
+  ✓ Downloaded /uploads/report.pdf → ./report.pdf
+
+  # 报错：源文件不存在
+  $ miaoda file cp ./missing.pdf /uploads/
+  Error: FILE_NOT_FOUND
+    hint: Verify the source path exists locally.
+`);
     fileCmd
         .command("rm")
-        .description("删除一个或多个文件（best-effort）")
-        .argument("[paths...]", "path 或 file_name：形似 /path、含 / 或 16+位 fileKey 时按 path 精确删除，其余按 file_name 查找后删除")
-        .addOption((0, shared_1.appIdOption)())
-        .option("-n, --name <name>", "强制按 file_name 查找后删除（跳过自动识别）；可重复指定；多匹配报 AMBIGUOUS_FILE_NAME", (value, prev) => [...(prev ?? []), value])
-        .option("-y, --yes", "跳过交互确认")
+        .description("批量删除文件，单条失败不影响其他文件")
+        .usage("[paths...] [flags]")
+        .argument("[paths...]", "要删除的文件，每项可填路径或文件名（自动识别）")
+        .option("-n, --name <name>", "按文件名删除（可重复指定）", (value, prev) => [...(prev ?? []), value])
+        .option("-y, --yes", "跳过交互确认；非交互场景必加")
         .action(async (paths, opts) => {
         await (0, index_1.handleFileRm)(paths, opts);
-    });
+    })
+        .addHelpText("after", `
+Notes:
+  - 删除后无法恢复，请确认目标文件正确再执行
+  - 单次最多 100 个；超出请分批删除
+  - 单条失败不会影响整体执行；响应中会列出每条文件的成功 / 失败状态
+
+Examples:
+  $ miaoda file rm /uploads/a.pdf /uploads/b.pdf -y
+  ✓ Deleted 2 files
+
+  $ miaoda file rm a.pdf b.pdf -y
+  ✓ Deleted 2 files
+
+  $ miaoda file rm -n a.pdf -n b.pdf -y
+  ✓ Deleted 2 files
+`);
     fileCmd
         .command("sign")
-        .description("生成文件临时下载链接")
-        .argument("<file>", "path 或 file_name：自动识别（见 ls 命令说明）")
-        .addOption((0, shared_1.appIdOption)())
-        .option("--expires <duration>", "过期时长（默认 7d，最长 30d）")
+        .description("为文件生成可分享的临时下载链接")
+        .usage("<file> [flags]")
+        .argument("<file>", "文件的路径或文件名")
+        .option("--expires <duration>", "链接有效期，支持 30m / 24h / 7d 等单位（默认 7d，最长 30d）")
         .action(async (file, opts) => {
         await (0, index_1.handleFileSign)(file, opts);
-    });
+    })
+        .addHelpText("after", `
+Notes:
+  - 链接生成后立即生效
+  - 有效期最长 30 天，超过会被拒绝；不传 --expires 默认 7 天
+  - 链接持有者即可下载文件，请仅分享给信任的对象
+
+Examples:
+  $ miaoda file sign report.pdf
+  https://...?expires=...    (valid 7d)
+
+  $ miaoda file sign report.pdf --expires 30m
+  $ miaoda file sign report.pdf --expires 24h
+
+  # 报错：文件不存在
+  $ miaoda file sign no_such.pdf
+  Error: FILE_NOT_FOUND
+    hint: Run \`miaoda file ls\` to see available files.
+`);
 }

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

@@ -5,7 +5,8 @@ const index_1 = require("../../../cli/handlers/plugin/index");
 function registerPluginCommands(program) {
     const pluginCmd = program
         .command("plugin")
-        .description("插件管理：安装/更新/移除插件包，查询 capability 实例");
+        .description("插件管理：安装/更新/移除插件包，查询 capability 实例")
+        .usage("<command> [flags]");
     pluginCmd.action(() => {
         pluginCmd.outputHelp();
     });

package/dist/cli/commands/shared.js

@@ -1,18 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.appIdOption = appIdOption;
 exports.softRequiredOption = softRequiredOption;
 exports.resolveAppId = resolveAppId;
 exports.withHelp = withHelp;
 exports.failArgs = failArgs;
 const commander_1 = require("commander");
 const error_1 = require("../../utils/error");
-/** --app-id option，需要应用上下文的命令自行 .addOption(appIdOption())。
- * Commander 的 .env() 只接受单个变量名，第二个兜底 `app_id` 在 resolveAppId 里手动检查。
- */
-function appIdOption() {
-    return new commander_1.Option("--app-id <id>", "指定目标应用").env("MIAODA_APP_ID");
-}
 /**
  * soft-required: Commander 类型上 optional，runtime 校验必填。
  */
@@ -20,15 +13,16 @@ function softRequiredOption(name, desc) {
     return new commander_1.Option(name, desc);
 }
 /**
- * 解析 appId，优先级：CLI flag > MIAODA_APP_ID > app_id > 抛错。
- * app_id 是部分外部沙箱环境注入应用 ID 的别名，作为兜底兼容（小写下划线形态）。
+ * 解析 appId，从环境变量 MIAODA_APP_ID 或 app_id（小写下划线，部分外部沙箱注入）读取。
+ * 缺失时抛 APP_ID_MISSING，由全局 catch 处理。
+ *
+ * opts 里仍保留 appId（可选），用于测试 / 高级场景显式注入；正常 CLI 不暴露此 flag。
  */
 function resolveAppId(opts) {
     const id = opts.appId ?? process.env.MIAODA_APP_ID ?? process.env.app_id;
     if (!id) {
         throw new error_1.AppError("APP_ID_MISSING", "未指定应用", {
             next_actions: [
-                "传入 --app-id <id>",
                 "设置 export MIAODA_APP_ID=<id>",
             ],
         });

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

@@ -82,15 +82,15 @@ async function handleDbDataImport(file, opts) {
             data: {
                 file,
                 table: result.tableName,
-                rows: result.rows,
+                rows: result.recordCount,
             },
         });
         return;
     }
     const tty = (0, render_1.isStdoutTty)();
     (0, output_1.emit)(tty
-        ? `✓ Imported ${file} → table '${result.tableName}' (${String(result.rows)} rows)`
-        : `OK Imported ${file} -> table '${result.tableName}' (${String(result.rows)} rows)`);
+        ? `✓ Imported ${file} → table '${result.tableName}' (${String(result.recordCount)} rows)`
+        : `OK Imported ${file} -> table '${result.tableName}' (${String(result.recordCount)} rows)`);
 }
 async function handleDbDataExport(table, opts) {
     const appId = (0, shared_1.resolveAppId)(opts);
@@ -110,7 +110,8 @@ async function handleDbDataExport(table, opts) {
         throw new error_1.AppError("EXPORT_SIZE_EXCEEDED", `Export exceeds 1 MB limit (body is ${String(result.body.length)} bytes)`, { next_actions: [`Filter the table with "miaoda db sql" (e.g. WHERE/LIMIT) and export smaller subsets.`] });
     }
     await fs.writeFile(outputPath, result.body);
-    const rows = countRows(result.body, format);
+    // 优先信任后端 X-Miaoda-Record-Count header；header 缺失时再用 body 行数兜底
+    const rows = result.recordCount ?? countRows(result.body, format);
     if ((0, output_1.isJsonMode)()) {
         (0, output_1.emit)({
             data: {

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

@@ -55,14 +55,14 @@ async function handleDbSchemaList(opts) {
         return;
     }
     const tty = (0, render_1.isStdoutTty)();
-    // PRD 对齐：TTY 表头用 `size`（友好格式），non-TTY 用 `size_bytes`（原始整数）
+    // PRD 对齐：TTY 表头用 `size`（友好格式），non-TTY 用 `size_bytes`（原始整数）。
+    // updated_at 暂时不展示——PG pg_catalog 不存真实表时间，详见 renderDetail 注释。
     const headers = [
         "name",
         "description",
         "estimated_row_count",
         tty ? "size" : "size_bytes",
         "columns",
-        "updated_at",
     ];
     const rows = tables.map((t) => [
         t.name,
@@ -70,7 +70,6 @@ async function handleDbSchemaList(opts) {
         t.estimated_row_count === null ? "—" : String(t.estimated_row_count),
         t.size_bytes === null ? "—" : (tty ? (0, render_1.formatSize)(t.size_bytes) : String(t.size_bytes)),
         String(t.columns),
-        (0, render_1.formatTime)(t.updated_at, tty),
     ]);
     (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
 }
@@ -123,7 +122,10 @@ async function handleDbSchemaGet(table, opts) {
 function renderDetail(d, tty) {
     const systemFields = d.columns.filter((c) => c.name.startsWith("_"));
     const userFields = d.columns.filter((c) => !c.name.startsWith("_"));
-    // PRD 的 header 布局：Name / Description / Columns(含"+ N system") / Estimated Rows / Size / Created / Updated
+    // header 布局：Name / Description / Columns(含"+ N system") / Estimated Rows / Size。
+    // 不展示 Created / Updated：PG pg_catalog 不存表创建时间，dataloom 用 OID
+    // 构造的伪时间戳（baseTime=2020-01-01 + OID 秒偏移），仅保排序意义、绝对值
+    // 误导性强，先去掉。后续如果接 ddl_change_log 取真实时间再加回。
     const header = [
         ["Name", d.name],
         ["Description", d.description ?? "—"],
@@ -135,8 +137,6 @@ function renderDetail(d, tty) {
         ],
         ["Estimated Rows", d.estimated_row_count === null ? "—" : String(d.estimated_row_count)],
         ["Size", d.size_bytes === null ? "—" : (0, render_1.formatSize)(d.size_bytes)],
-        ["Created", (0, render_1.formatTime)(d.created_at, tty)],
-        ["Updated", (0, render_1.formatTime)(d.updated_at, tty)],
     ];
     const colHeaders = ["column", "type", "nullable", "default", "comment"];
     const colRows = userFields.map((c) => [