@lingjingai/lj-awb-cli-pre 0.3.15

package/skills/lj-awb/references/output-fields.md

@@ -0,0 +1,113 @@
+# 输出字段速查表
+
+只有以下场景需要展开 `-f json` 读结构化字段：脚本严格解析、模型 / 资源约束读取、批量结果汇总、错误恢复。其他场景默认读 compact text。
+
+通用 envelope：`{ status, data, meta, error? }`。任何命令失败时 `status='error'`，详见 [`error-codes.md`](error-codes.md)。
+
+下表按 `data.workflow.outputKind`（来自 `schema -f json`）列每类返回的**必报字段** vs **agent 内部用**。"可丢弃"是默认即可忽略、对话框里不要复述给用户的字段。
+
+## 认证与诊断
+
+| outputKind | 命令 | 必报给用户 | agent 内部用 | 可丢弃 |
+|------------|------|-----------|--------------|--------|
+| `environment_report` | `doctor` | `verified`、failed check 列表 | `checks[]` 每项 ok/details | 通过的 check 详情 |
+| `auth_status` | `auth status` / `auth verify` | `configured`、`verified`、`userName`、`groupName` | `accessKey`（脱敏）、`source` | `user` 原始嵌套 |
+| `auth_result` | `auth login` | `saved`、`verified`、`userName` | — | `auth` 嵌套 |
+| `command_schema` | `schema` | 不报给用户 | `commands[]` 的 `requiredOptions / requiredAnyOptions / safety / workflow` | 其他元信息 |
+
+## 账号与项目组
+
+| outputKind | 命令 | 必报给用户 | agent 内部用 | 可丢弃 |
+|------------|------|-----------|--------------|--------|
+| `account_summary` | `account info` | `userName`、`groupName`、`currentProjectGroupName`、`billingPointBalance` | `userId`、`groupId` | — |
+| `team_list` | `account teams` | `count` + 团队名 | `groupId` 用于 `account switch-team` | — |
+| `project_list` | `project list` | `projectGroupName`、`isSelected` | `projectGroupNo`（下游引用） | budget 详情 |
+| `project_summary` | `project use / create / update / current` | `projectGroupName`、`selected/created/updated`、`projectBudgetBalance` | `projectGroupNo` | `memberCount` |
+| `project_user_list` | `project users` | `count` | `userId` | — |
+
+## 积分
+
+| outputKind | 命令 | 必报给用户 | agent 内部用 | 可丢弃 |
+|------------|------|-----------|--------------|--------|
+| `credits_balance` | `credits balance` | `billingPointBalance`、`projectBudgetBalance`、`projectBudgetMax` | — | `currentProjectGroupNo` |
+| `credits_usage` | `credits usage` | `pointTotal`、`scannedTaskCount`、`buckets[]` 汇总 | `tasks[]`（若 `--include-tasks`） | sinceMs/untilMs 原值 |
+
+> 永远优先看 `billingPointBalance`（可扣积分）；`projectBudgetBalance` 是项目预算 / ROI 约束，不要混为一谈。
+
+## 模型
+
+| outputKind | 命令 | 必报给用户 | agent 内部用 | 可丢弃 |
+|------------|------|-----------|--------------|--------|
+| `model_list` | `model image-models` / `video-models` | 模型名、`modelGroupCode`、`taskQueueNum`（排队数） | `modelGroupCode`（下游 create 必填） | 完整 modelList 嵌套 |
+| `model_options` | `model options` | `params[].label/values/defaultValue`、`resources[]`、`constraints[]` | 全部字段（决定 create 入参） | — |
+| `model_create_spec` | `model create-spec` | `intents[]`、`requiredArgs`、`examples` | 全部 | — |
+| `model_input_guide` | `model input-guide` | `supportedIntents`、`promptParams`、`resourceUsages` | 全部 | — |
+
+## 文件上传
+
+| outputKind | 命令 | 必报给用户 | agent 内部用 | 可丢弃 |
+|------------|------|-----------|--------------|--------|
+| `upload_result` | `upload files` | 上传文件数、`uploads[].backendPath` | `backendPath`（喂给 `--resource <type>:<usage>=<backendPath>`） | `uploads[].url`、mimeType |
+
+## 生图 / 生视频
+
+| outputKind | 命令 | 必报给用户 | agent 内部用 | 可丢弃 |
+|------------|------|-----------|--------------|--------|
+| `fee_estimate` | `image fee` / `video fee` | `pointCost`、`billingPointBalance`、`billingPointRemainingAfter` | — | budget 嵌套 |
+| `task_submission` | `image create` / `video create` | `taskId`、`pointCost`、`billingPointRemainingAfter`、`nextCommand` | `taskId`、`taskType`（喂给 `task wait`） | uploads 数组、modelGroupCode |
+| `batch_task_submission` | `image create-batch` / `video create-batch` | 成功 / 失败计数、首条 `taskId` 用于追踪 | `tasks[]` 每条 taskId + status | localFiles 详情 |
+| `task_status` | `task wait` / `image status` / `video status` | `taskStatus`、`isTerminal`、`resultUrls`、`errorMessage` | `isTerminal`（false → 续 wait）、`timedOut` | `waitedMs`、`gmtCreate` |
+| `subtitle_task_submission` | `video subtitle-remove` | `submitted`、`remoteTaskId` | `remoteTaskId`、`publicId` | — |
+| `subtitle_task_status` | `video subtitle-status` | `status`、结果 URL | — | — |
+
+> `task_submission.nextCommand` 是平台给出的下一步建议命令（通常是 `task wait --task-id ...`）。看到就直接接着跑。
+
+## 任务台账
+
+| outputKind | 命令 | 必报给用户 | agent 内部用 | 可丢弃 |
+|------------|------|-----------|--------------|--------|
+| `task_list` | `task list` | `count` + 简明摘要 | 每条 `taskId/taskType/taskStatus`（用于决定 wait 哪几条） | gmtCreate |
+| `local_task_records` | `task records` | 待终态条数 | 每条 `taskId/taskType`（用于补 wait） | — |
+| `batch_task_status` | `task record-poll` | 终态计数、失败原因汇总 | 失败列表（用于 retry） | 完整 records |
+
+## 主体
+
+| outputKind | 命令 | 必报给用户 | agent 内部用 | 可丢弃 |
+|------------|------|-----------|--------------|--------|
+| `subject_list` | `subject list` | `count` + 主体名 | `externalId`（已有则免发布） | — |
+| `subject_publish_result` | `subject publish` | `elementId`、`status`、`nextRefSubject` | `elementId`（喂 `subject wait`） | `request` 嵌套 |
+| `subject_status` | `subject wait` | `status`、`externalId`、`nextRefSubject` | `externalId`（→ `--resource subject:reference:<key>=asset:<externalId>`） | `subject` 嵌套 |
+| `batch_subject_publish_result` | `subject publish-batch` | 成功 / 失败计数 | 每条 `elementId` | — |
+
+> 拿到 `nextRefSubject`（形如 `女主=<externalId>`）直接复制到 `video create --resource subject:reference:女主=asset:<externalId>` 即可，不要手拼。
+
+## 素材
+
+| outputKind | 命令 | 必报给用户 | agent 内部用 | 可丢弃 |
+|------------|------|-----------|--------------|--------|
+| `asset_match_list` | `asset match-actor` | 候选列表（名称 + 评分） | `assetId/groupId` | — |
+| `asset_group_list` | `asset groups` | `count` + 组名 | `groupId`（下游 register 必填） | — |
+| `asset_group_detail` | `asset group` | 组名、成员数 | `groupId` | — |
+| `asset_group_write_result` | `asset group-create / group-update` | `created/updated`、`groupId` | — | — |
+| `asset_register_result` | `asset register` | `registered`、`assetId`、`assetPath` | `assetId`（下游引用） | upload 嵌套 |
+
+## Artifact（产物 CRUD）
+
+| outputKind | 命令 | 必报给用户 | agent 内部用 | 可丢弃 |
+|------------|------|-----------|--------------|--------|
+| `artifact_list` | `* rows` / `* episodes` / `* scenes` / `* clips` / `* actors` / ... | `count` + 关键字段摘要 | `id / entityKey / episodeId / sceneId / clipId` | 全 row 嵌套 |
+| `artifact_record` | `* row` / `* episode` / `* scene` / `* clip` / `* actor` / ... | 关键标识 + 状态 | `id`（下游 update / delete 用） | 大段 description / payload |
+| `artifact_full` | `script get` / `asset get` / `video get` / `clip get` | 顶层 `id`、各子集合 `*.Count` | — | 整棵嵌套 |
+| `artifact_write_result` | `upsert-*` / `update-clip-urls` | 写入字段 + `id` | `id`（下游） | — |
+| `artifact_delete_result` | `delete-*` | `deleted`、`key`、级联 | — | — |
+| `artifact_import_result` | `* import` / `import-storyboard` / `upsert-batch` | `imported`、`rowCount/actorCount/...`、文件计数 | `rowsByKind`（用于断言） | `batch` 数组 |
+| `artifact_status_update` | `artifact clip update-status` | `updated`、`status` | — | messageCount |
+
+## Dry-run
+
+任何 `--dry-run` 命令返回 `data.dryRun=true`：
+- 必报：`action`、`request`（最终请求体摘要）、`localFileCount`、`assetCount`
+- agent 内部用：`results[]`（批量 dry-run 每条）
+- 可丢弃：完整 `request` 嵌套（已经在 compact summary 里）
+
+`--yes` 后再跑会换成对应的写入 outputKind（如 `task_submission` / `artifact_write_result`），字段语义见上表。

package/skills/lj-awb/scripts/resolve-lj-awb-cmd.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if command -v lj-awb >/dev/null 2>&1; then
+  printf 'lj-awb\n'
+  exit 0
+fi
+
+printf 'No usable lj-awb CLI found. Install `@lingjingai/lj-awb-cli` first.\n' >&2
+exit 1