@lingjingai/lj-awb-cli-pre 0.3.18 → 0.4.0

package/README.md

@@ -2,13 +2,13 @@
 
 `lj-awb` 是灵境 AWB / 动漫创作平台的命令行客户端。它把平台底层能力封装成稳定、可脚本化、Agent 友好的命令，并随包分发一套 `lj-awb` skill，方便 Codex、Claude 等 Agent 把自然语言任务编排成确定性的 CLI 调用。
 
-CLI 本身只负责平台调用、参数校验、精简输出和安全确认；自然语言理解、任务规划、项目产物写回由上层 Agent / skill 完成。
+CLI 本身只负责平台调用、参数校验、人类友好输出、机器可读输出和安全确认；自然语言理解、任务规划、项目产物写回由上层 Agent / skill 完成。
 
 ```text
 用户 / Agent / CI
   -> lj-awb
   -> 灵境 AWB / 动漫平台 API
-  -> compact text / JSON 结果
+  -> pretty / text / JSON / YAML / CSV 结果
 ```
 
 ## 能力概览
@@ -110,6 +110,7 @@ lj-awb account info
 ```bash
 lj-awb doctor
 lj-awb doctor --verify
+lj-awb schema --brief -f json
 lj-awb schema -f json
 lj-awb schema --domain create -f json
 lj-awb auth status
@@ -141,21 +142,22 @@ lj-awb create image ... --yes
 
 ## Agent 接入建议
 
-Agent 不应该靠记忆猜命令参数。进入任务前推荐先读取机器可读契约：
+Agent 不应该靠记忆猜命令参数。进入任务前先读轻量能力摘要；执行具体命令前再按需读取精确契约：
 
 ```bash
-lj-awb schema -f json
-lj-awb schema --domain create -f json
+lj-awb schema --brief -f json
 lj-awb schema --domain create --command video -f json
 ```
 
+只有做覆盖校验、生成脚本或调试 schema 本身时，才需要读取完整 `lj-awb schema -f json`。
+
 正式创作前推荐做一次体检：
 
 ```bash
 lj-awb doctor --verify
 ```
 
-`auth status` 只检查本地是否配置 access key；`auth verify` 会联网校验 key 是否远端有效。`doctor` 默认只做本地检查；追加 `--verify` 后会联网校验 access key、当前用户和项目组。`schema` 返回每个命令的 `options[].key`，Agent 应使用这些 key 生成 CLI 参数，而不是解析自然语言 help。
+`auth status` 只检查本地是否配置 access key；`auth verify` 会联网校验 key 是否远端有效。`doctor` 默认只做本地检查；追加 `--verify` 后会联网校验 access key、当前用户和项目组。精确 `schema` 返回每个命令的 `options[].key`，Agent 应使用这些 key 生成 CLI 参数，而不是解析自然语言 help。
 
 `schema` 还包含面向 Agent 的执行约束：
 
@@ -242,9 +244,11 @@ lj-awb create video \
   --yes
 ```
 
-## JSON 输出契约
+## 输出契约
+
+默认输出是 `pretty`：面向人类阅读的彩色标题、摘要区、自动换行表格和下一步建议。表格由 `cli-table3` 做终端渲染，不是 CSV；颜色由 `chalk` 渲染，设置 `NO_COLOR=1` 可关闭，`FORCE_COLOR=1` 或 `LINGJING_AWB_COLOR=1` 可强制开启。Agent / 脚本不要依赖默认 pretty 解析字段：需要稳定 envelope 时显式追加 `-f json` 或 `--json`；需要低 token 的紧凑 key-value 兼容输出时传 `-f text`；列表导出可用 `-f csv`，可读结构化输出可用 `-f yaml`。
 
-默认输出是 compact text，适合终端和 Agent 低 token 读取；复杂模型命令使用 `section:` + 缩进 `key=value` 的分区格式，避免 `params`、`resources`、`intents`、`next` 混在一屏里。只有需要完整嵌套结构、稳定 JSON envelope 或脚本严格解析时才追加 `-f json` 或 `--json`。`schema` 通常使用 JSON；`model options` 和 `model create-spec` 默认 text 先读，必要时再切 JSON。
+`schema` 通常使用 JSON；`model options` 和 `model create-spec` 面向人类时可直接读默认 pretty，Agent 做参数决策时建议使用 `-f text`，脚本严格解析或需要完整嵌套结构时再切 `-f json`。
 
 输出字段只保留后续动作不可替代的信息。默认不返回平台原始 `raw`、COS 签名细节、重复的首个结果字段；任务结果统一使用 `resultUrls` 表达。
 

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "@lingjingai/lj-awb-cli-pre",
-  "version": "0.3.18",
+  "version": "0.4.0",
   "description": "Lingjing AWB CLI monorepo with shared core, standalone CLI, and agent skills (pre-release build pointing to https://animeworkbench-pre.lingjingai.cn)",
   "license": "MIT",
   "type": "module",
   "bin": {
     "lj-awb": "packages/awb-cli/bin/lj-awb"
   },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "cli-table3": "^0.6.5"
+  },
   "engines": {
     "node": ">=20"
   },

package/packages/awb-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/awb-cli-bin",
-  "version": "0.3.18",
+  "version": "0.4.0",
   "description": "Standalone CLI for Lingjing AWB",
   "private": true,
   "license": "MIT",
@@ -13,6 +13,6 @@
     "README.md"
   ],
   "dependencies": {
-    "@lingjingai/awb-core": "0.3.18"
+    "@lingjingai/awb-core": "0.4.0"
   }
 }

package/packages/awb-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/awb-core",
-  "version": "0.3.18",
+  "version": "0.4.0",
   "description": "Shared core runtime for Lingjing AWB CLI",
   "license": "MIT",
   "type": "module",
@@ -17,5 +17,9 @@
   "files": [
     "src",
     "README.md"
-  ]
+  ],
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "cli-table3": "^0.6.5"
+  }
 }