@lingjingai/lj-awb-cli-pre 0.4.6 → 0.4.8

package/skills/lj-awb/modules/artifact/asset.md

@@ -1,64 +0,0 @@
-# Artifact · Asset 子域
-
-资产分三类：角色 (`actor`) / 道具 (`prop`) / 场景 (`location`)，每类都有"主体"和"状态"两级——主体描述资产本身，状态描述某个时刻的造型 / 状态 / 镜头。
-
-所有命令都要求 `--project-id <projectId>`（项目 ID，不是项目组编号）。回到 [`../artifact.md`](../artifact.md) 看完整域概览和导入工作流。
-
-## 查询
-
-| 命令 | 用途 |
-|------|------|
-| `lj-awb artifact asset get --project-id <id>` | 查询完整资产产物（含三类全部） |
-| `lj-awb artifact asset actors --project-id <id> --include-states true` | 查询角色列表 |
-| `lj-awb artifact asset actor --project-id <id> --actor-key act_001` | 查询单个角色 |
-| `lj-awb artifact asset props --project-id <id>` | 查询道具列表 |
-| `lj-awb artifact asset prop --project-id <id> --prop-key prop_001` | 查询单个道具 |
-| `lj-awb artifact asset locations --project-id <id>` | 查询场景列表 |
-| `lj-awb artifact asset location --project-id <id> --location-key loc_001` | 查询单个场景 |
-
-## 主体写入 / 删除
-
-```bash
-lj-awb artifact asset upsert-actor --project-id <id> --input-file actor.json --dry-run
-lj-awb artifact asset upsert-prop --project-id <id> --input-file prop.json --dry-run
-lj-awb artifact asset upsert-location --project-id <id> --input-file location.json --dry-run
-
-lj-awb artifact asset delete-actor --project-id <id> --actor-key act_001 --dry-run
-lj-awb artifact asset delete-prop --project-id <id> --prop-key prop_001 --dry-run
-lj-awb artifact asset delete-location --project-id <id> --location-key loc_001 --dry-run
-```
-
-删除主体会级联删除该主体下的所有状态。**删主体和删状态是两个不同操作，用户说"撤回 / 删掉"时先确认是哪一种。**
-
-## 状态写入 / 删除
-
-```bash
-lj-awb artifact asset upsert-actor-state --project-id <id> --actor-key act_001 --input-file state.json --dry-run
-lj-awb artifact asset upsert-prop-state --project-id <id> --prop-key prop_001 --input-file state.json --dry-run
-lj-awb artifact asset upsert-location-state --project-id <id> --location-key loc_001 --input-file state.json --dry-run
-
-lj-awb artifact asset delete-actor-state --project-id <id> --actor-key act_001 --state-key state_001 --dry-run
-lj-awb artifact asset delete-prop-state --project-id <id> --prop-key prop_001 --state-key state_001 --dry-run
-lj-awb artifact asset delete-location-state --project-id <id> --location-key loc_001 --state-key state_001 --dry-run
-```
-
-## 批量导入
-
-```bash
-lj-awb artifact asset import --project-id <id> --input-dir 2_asset/output --dry-run
-```
-
-`asset import` 在 `--input-dir` 下查找 `actors/actors.json`、`props/props.json`、`locations/locations.json`，也兼容扁平的 `actors.json` / `props.json` / `locations.json`；缺哪类资产就跳过哪类，不会报错。
-
-## 规则
-
-- 单条 body 使用 AWB 接口的 camelCase 字段；不要在 body 里传 `id`、`projectId`、`createdAt`、`updatedAt`、`isDeleted` 等审计字段。
-- 写入 / 删除都是逻辑写入，但仍需 `--dry-run` 预览 + `--yes` 确认两步走。
-- 不确定参数时先读精确 schema，例如 `lj-awb schema --domain artifact --command "asset upsert-actor" -f json`。
-- 输出字段速查见 [`../../references/output-fields.md`](../../references/output-fields.md) 的"Artifact"小节。
-
-## 下一步
-
-- `asset import` 完成 → 接 [`video.md`](video.md) 导入视频集 / 场 / clip。
-- 想给角色加一种新造型 → 用 `upsert-actor-state` 而不是 `upsert-actor`（避免覆盖主体描述）。
-- 不要把这里的 `actor` / `prop` / `location` 和 [`../asset.md`](../asset.md) 的素材库（"加白"用）混为一谈：这里是剧本结构里的资产，那里是平台素材库。

package/skills/lj-awb/modules/artifact/clip.md

@@ -1,65 +0,0 @@
-# Artifact · Clip 子域
-
-剪辑阶段把一个视频集打包成一行宽表产物。和 [`video 子域`](video.md) 不同的是，clip 域里每行只对应一集（不是一个镜头）。
-
-所有命令都要求 `--project-id <projectId>`（项目 ID，不是项目组编号）。回到 [`../artifact.md`](../artifact.md) 看完整域概览和导入工作流。
-
-## ID 矩阵（重要）
-
-clip 子域同时存在两种 ID，搞错会导致命令报参数错或读到错数据：
-
-| 命令 | 用哪个 ID 定位 | 说明 |
-|------|----------------|------|
-| `clip get` | 不需要定位 ID | 返回项目下所有剪辑产物 |
-| `clip episodes` | 不需要定位 ID | 列出项目所有剪辑产物 |
-| `clip episode` | `--video-episode-id <数字>` | 数字主键，由 `upsert-episode` 或 `artifact video episode` 返回的 `id` 字段提供 |
-| `clip episode-by-id` | `--episode-id ep_001` | 业务键（ep_001 等） |
-| `clip upsert-episode` | 不需要定位 ID | body 内含 `videoEpisodeId`，作为本次写入的目标 |
-| `clip upsert-batch` | 不需要定位 ID | body 是数组，每项含 `videoEpisodeId` |
-| `clip update-status` | `--video-episode-id <数字>` | 必须先查到主键 |
-| `clip delete-episode` | `--video-episode-id <数字>` | 必须先查到主键 |
-
-要从业务键拿到数字主键，最常见的链路是：
-
-```bash
-lj-awb artifact video episode --project-id <id> --episode-id ep_001 -f json
-# 取响应 .data.id 作为 video-episode-id
-```
-
-## 查询
-
-| 命令 | 用途 |
-|------|------|
-| `lj-awb artifact clip get --project-id <id>` | 查询项目完整剪辑产物 |
-| `lj-awb artifact clip episodes --project-id <id>` | 查询剪辑产物列表 |
-| `lj-awb artifact clip episode --project-id <id> --video-episode-id 101` | 按主键查询单集 |
-| `lj-awb artifact clip episode-by-id --project-id <id> --episode-id ep_001` | 按业务键查询单集 |
-
-## 写入 / 状态 / 删除
-
-```bash
-lj-awb artifact clip upsert-episode --project-id <id> --input-file clip-output.json --dry-run
-lj-awb artifact clip upsert-batch --project-id <id> --input-file clip-batch.json --dry-run
-
-lj-awb artifact clip update-status \
-  --project-id <id> \
-  --video-episode-id 101 \
-  --status music_success \
-  --messages-json '[{"level":"info","step":"music","message":"配乐完成"}]' \
-  --dry-run
-
-lj-awb artifact clip delete-episode --project-id <id> --video-episode-id 101 --dry-run
-```
-
-## 规则
-
-- 单条 body 使用 AWB 接口的 camelCase 字段；不要在 body 里传 `id`、`projectId`、`createdAt`、`updatedAt`、`isDeleted` 等审计字段。
-- 写入 / 删除都是逻辑写入，但仍需 `--dry-run` 预览 + `--yes` 确认两步走。
-- 不确定参数时先读精确 schema，例如 `lj-awb schema --domain artifact --command "clip upsert-episode" -f json`。
-- 输出字段速查见 [`../../references/output-fields.md`](../../references/output-fields.md) 的"Artifact"小节。
-
-## 下一步
-
-- 想拿到数字主键 `videoEpisodeId` → 先跑 `artifact video episode --project-id <id> --episode-id ep_001 -f json`，取 `.data.id`。
-- 配乐 / 字幕烧录等阶段汇报 → `update-status --video-episode-id <id> --status <state> --messages-json '[...]'`，不要 upsert 整行。
-- 整集失败要回滚 → `delete-episode --video-episode-id <id> --yes`，然后重新 `upsert-episode`。

package/skills/lj-awb/modules/artifact/script.md

@@ -1,37 +0,0 @@
-# Artifact · Script 子域
-
-剧本最终产物按 `rowKind` 分行存储：`document / asset / state / speaker / episode / scene / action`。`document` 是根记录，其余行通过 `entityKey` 和 `parentKey` 串联。
-
-所有命令都要求 `--project-id <projectId>`（项目 ID，不是项目组编号）。回到 [`../artifact.md`](../artifact.md) 看完整域概览和导入工作流。
-
-## 查询
-
-| 命令 | 用途 |
-|------|------|
-| `lj-awb artifact script get --project-id <id>` | 查询完整剧本产物（含所有行） |
-| `lj-awb artifact script document --project-id <id>` | 仅查询 document 根记录 |
-| `lj-awb artifact script rows --project-id <id> --row-kind scene` | 查询某种 rowKind 的所有行 |
-| `lj-awb artifact script row --project-id <id> --row-kind action --entity-key "ep_001/scn_001#0"` | 查询单行 |
-| `lj-awb artifact script children --project-id <id> --parent-key scn_001 --row-kind action` | 按 parentKey 查询子节点 |
-
-## 写入 / 删除
-
-```bash
-lj-awb artifact script upsert-row --project-id <id> --input-file row.json --dry-run
-lj-awb artifact script delete-row --project-id <id> --row-kind action --entity-key "ep_001/scn_001#0" --dry-run
-lj-awb artifact script import --project-id <id> --input-file script.json --dry-run
-```
-
-`script import` 会把 `script.json` 拆成 document / asset / state / speaker / episode / scene / action 行批量导入。
-
-## 规则
-
-- 单条 body 使用 AWB 接口的 camelCase 字段；不要在 body 里传内部审计字段（`id`、`projectId`、`createdAt`、`updatedAt`、`isDeleted`），CLI 会自动注入或忽略。
-- 写入 / 删除都是逻辑写入（不真删数据），但仍需 `--dry-run` 预览 + `--yes` 确认两步走。
-- 不确定参数时先读精确 schema，例如 `lj-awb schema --domain artifact --command "script import" -f json`。
-- 输出字段速查见 [`../../references/output-fields.md`](../../references/output-fields.md) 的"Artifact"小节。
-
-## 下一步
-
-- `script import` 完成 → 接 [`asset.md`](asset.md) 导入角色 / 道具 / 场景。
-- 查到某行需要修改 → 用 `upsert-row --input-file <一条 row.json>` 单条更新，不必重新跑 `import`。

package/skills/lj-awb/modules/artifact/video.md

@@ -1,65 +0,0 @@
-# Artifact · Video 子域
-
-视频最终产物三级结构：集 (`episode`) → 场 (`scene`) → 镜头 (`clip`)。`import-storyboard` 把 `epXXX_storyboard.json` 拆成 episode + scenes + clips 一次导入；`episodeId` 优先取 JSON 字段，否则从 `ep001_storyboard.json` 文件名推断。
-
-所有命令都要求 `--project-id <projectId>`（项目 ID，不是项目组编号）。回到 [`../artifact.md`](../artifact.md) 看完整域概览和导入工作流。
-
-## 查询
-
-| 命令 | 用途 |
-|------|------|
-| `lj-awb artifact video get --project-id <id>` | 查询完整视频产物（含全部 episodes/scenes/clips） |
-| `lj-awb artifact video episodes --project-id <id>` | 查询视频集列表 |
-| `lj-awb artifact video episode --project-id <id> --episode-id ep_001` | 查询单集 |
-| `lj-awb artifact video scenes --project-id <id> --episode-id ep_001` | 查询某集下的场列表 |
-| `lj-awb artifact video scene --project-id <id> --episode-id ep_001 --scene-id scn_001` | 查询单场 |
-| `lj-awb artifact video clips --project-id <id> --episode-id ep_001 --scene-id scn_001` | 查询某场下的 clip 列表 |
-| `lj-awb artifact video clip --project-id <id> --episode-id ep_001 --scene-id scn_001 --clip-id clip_001` | 查询单个 clip |
-
-## 写入 / 回写 / 删除
-
-```bash
-lj-awb artifact video upsert-episode --project-id <id> --input-file episode.json --dry-run
-lj-awb artifact video upsert-scene --project-id <id> --episode-id ep_001 --input-file scene.json --dry-run
-lj-awb artifact video upsert-clip --project-id <id> --episode-id ep_001 --scene-id scn_001 --input-file clip.json --dry-run
-
-lj-awb artifact video delete-episode --project-id <id> --episode-id ep_001 --dry-run
-lj-awb artifact video delete-scene --project-id <id> --episode-id ep_001 --scene-id scn_001 --dry-run
-lj-awb artifact video delete-clip --project-id <id> --episode-id ep_001 --scene-id scn_001 --clip-id clip_001 --dry-run
-```
-
-删除 episode 会级联 scenes/clips；删除 scene 会级联 clips。
-
-视频生成完成后只回写 clip 链接（不覆盖 prompt / duration / payload）：
-
-```bash
-lj-awb artifact video update-clip-urls \
-  --project-id <id> \
-  --episode-id ep_001 \
-  --scene-id scn_001 \
-  --clip-id clip_001 \
-  --video-urls-json '["https://example.com/a.mp4"]' \
-  --dry-run
-```
-
-## 批量导入
-
-```bash
-lj-awb artifact video import-storyboard --project-id <id> --input-file ep001_storyboard.json --dry-run
-```
-
-批量 storyboard 需要逐个 episode 文件执行 `import-storyboard`。
-
-## 规则
-
-- 单条 body 使用 AWB 接口的 camelCase 字段；不要在 body 里传 `id`、`projectId`、`createdAt`、`updatedAt`、`isDeleted` 等审计字段。
-- `upsert-episode` 返回的 `id` 是数字主键，下游 [`clip 子域`](clip.md) 的 `--video-episode-id` 必须用这个值，不是 `ep_001` 业务键。
-- 写入 / 删除都是逻辑写入，但仍需 `--dry-run` 预览 + `--yes` 确认两步走。
-- 不确定参数时先读精确 schema，例如 `lj-awb schema --domain artifact --command "video upsert-episode" -f json`。
-- 输出字段速查见 [`../../references/output-fields.md`](../../references/output-fields.md) 的"Artifact"小节。
-
-## 下一步
-
-- `import-storyboard` 完成 → 进 [`clip.md`](clip.md) 处理剪辑阶段（clip 子域用的 `videoEpisodeId` 就是这里 `upsert-episode` 返回的 `id` 数字主键）。
-- 视频任务终态拿到 `resultUrls` → `update-clip-urls --project-id ... --episode-id ... --scene-id ... --clip-id ... --video-urls-json '[...]'`，只回写链接，不动 prompt / duration。
-- 想看完整三级结构 → `artifact video get --project-id <id>`；只看某集 → `episode` / `scenes` / `clips`。

package/skills/lj-awb/modules/artifact.md

@@ -1,65 +0,0 @@
-# Artifact Module
-
-artifact 模块用于把沙箱 / 本地流水线产出的最终 JSON 写入 AWB 数据库化产物，也可直接查询或单条 CRUD。写入都是云端动作，必须先 dry-run，再经用户确认后追加 `--yes`。
-
-artifact 下有四个子域，结构和 `lj-awb artifact -h` 一致。按用户意图选子域，不要把所有命令塞进一个流程：
-
-| 子域 | 处理的内容 | 入口 |
-|------|------------|------|
-| `artifact script` | 剧本 document / asset / state / speaker / episode / scene / action 行 | [`artifact/script.md`](artifact/script.md) |
-| `artifact asset` | 角色 / 道具 / 场景 及各自状态 | [`artifact/asset.md`](artifact/asset.md) |
-| `artifact video` | 视频集 / 场 / clip 三级最终产物 | [`artifact/video.md`](artifact/video.md) |
-| `artifact clip` | 剪辑宽表（按集组织） | [`artifact/clip.md`](artifact/clip.md) |
-
-## 项目 ID
-
-所有 artifact 命令都需要 `--project-id <projectId>`。沙箱环境通常从环境变量读取：
-
-```bash
-PROJECT_ID="${SANDBOX_PROJECT_ID:?missing SANDBOX_PROJECT_ID}"
-```
-
-`--project-id` 是项目本身的标识，和 `--project-group-no`（项目组编号，用于积分 / 创作类命令）不是同一个概念，不要混用。
-
-## 标准导入工作流
-
-完整流水线推荐顺序：script → asset → video → clip。每步独立，前一步不强依赖后一步，但 clip 的 `videoEpisodeId` 来自 video 阶段返回的主键。
-
-```bash
-lj-awb artifact script import \
-  --project-id "$PROJECT_ID" \
-  --input-file 1_script/output/script.json \
-  --dry-run
-
-lj-awb artifact asset import \
-  --project-id "$PROJECT_ID" \
-  --input-dir 2_asset/output \
-  --dry-run
-
-lj-awb artifact video import-storyboard \
-  --project-id "$PROJECT_ID" \
-  --input-file 3_footage/output/ep001/ep001_storyboard.json \
-  --dry-run
-
-lj-awb artifact clip upsert-episode \
-  --project-id "$PROJECT_ID" \
-  --input-file 4_clip/output/ep001_clip_output.json \
-  --dry-run
-```
-
-用户确认后，把对应命令的 `--dry-run` 替换为 `--yes`。批量 storyboard 逐 episode 调用；批量 clip 用 `artifact clip upsert-batch`。
-
-## 通用规则
-
-- 不确定命令参数时先读 `lj-awb schema --domain artifact -f json`，再回到对应子域文件。
-- 写入 / 删除全部是逻辑写入（不真删数据），但仍需 `--dry-run` 预览 + `--yes` 确认两步走。
-- 单条 body 使用 AWB 接口的 camelCase 字段；不要在 body 里传内部审计字段（`id`、`projectId`、`createdAt`、`updatedAt`、`isDeleted`），CLI 会自动注入或忽略。
-- 用户说"存一下 / 写到 AWB / 同步上去"但没指明哪类产物时，先确认是 script / asset / video / clip 哪个子域，再走对应子域文件，不要默认选一个开干。
-- 用户说"删掉某条 / 撤回"涉及 asset 子域时，先确认是删主体还是删状态（删主体会级联删状态）。
-- 输出字段速查见 [`../references/output-fields.md`](../references/output-fields.md) 的"Artifact"小节；写入失败 / argument_error 见 [`../references/error-codes.md`](../references/error-codes.md)。
-
-## 下一步
-
-- 整条流水线：[script.md](artifact/script.md) → [asset.md](artifact/asset.md) → [video.md](artifact/video.md) → [clip.md](artifact/clip.md)，按顺序导入。
-- 视频任务结果回写产物：拿到 `task wait` 的 `resultUrls` → `artifact video update-clip-urls --project-id <id> --episode-id <ep> --scene-id <scn> --clip-id <clip> --video-urls-json '[...]'`。
-- 剪辑阶段状态汇报：`artifact clip update-status --video-episode-id <数字主键> --status <state> --messages-json '[...]'`。