assetsctl

资产阶段统一 CLI：本地真值的角色/场景/道具清单与提示词读写、表单优先的 plan/run 编排，外部生成命令以 recipe 数据注入（引擎绝不硬编码 lj-awb 命令）。

为 agent 而设计：selector × 动词、双模输出（--json / --format addr）、脱敏错误 + error_code + 语义退出码、三 surface（verb / do / patch）收口到同一个事务 op 引擎。

安装 / 构建

pnpm install
pnpm run build      # → dist/
pnpm test           # 53 tests

零运行时依赖。

命令速览

# 查询（复数名词）
assetsctl actors|locations|props [--in <sel>] --local
assetsctl states actor:lin_xia --local
assetsctl style | summary --local
assetsctl plan --local                      # 吐可编辑的生成表单（JSON）

# 写（动词）
assetsctl style-set --assets-worldview-type 现代 --visual-mode 国漫 --local
assetsctl init [--apply] --local            # 从 1_script 剧本脚手架资产
assetsctl add-actor lin_xia --name 林夏 --local
assetsctl prompt-set actor:lin_xia/default --gen-prompt "..." --local
assetsctl prompt-set --in actor:* --description "..." --apply --local   # sweep（默认 dry-run）

# 生成（recipe 驱动）
assetsctl gen   --in actor:* --apply --local       # 出图，NDJSON 流式
assetsctl voice --in actor:* --apply --local       # 音色
assetsctl run --plan form.json --apply --local     # 应用表单 + 一键生成
assetsctl recipe --schema image                    # 看占位符
assetsctl recipe validate recipes.json

# 事务
assetsctl do edits.txt --local      # 一行一动词，整段一个事务
assetsctl patch ops.json --local    # JSON ops；--schema 自省

架构（机制 vs 策略）

• assetsctl 拥有（代码）：本地真值（output/{actors,locations,props,style}.json）、selector/address、op 引擎、资产 step 拓扑（actor 的 face_view→three_view 依赖等）、调度器（并发/轮询/级联/写回/NDJSON）。
• 注入的数据（recipe）：出图/出视频/音色/上传怎么敲、参数、输出解析路径、状态词表 —— 由 agent 读 lj-awb skill 维护（recipes/default.json）。lj-awb 命令变了改 recipe，不改引擎代码。

唯一耦合点是稳定的占位符词汇（${prompt} ${model} ${ratio} ${ref.url} ${taskId} …）；recipe 把它们映射到当下 lj-awb 的 flag。job-runner.ts 是唯一 spawn 外部命令处，经 ASSETSCTL_CMD_BIN 可注入 mock。

环境变量

| 变量 | 用途 | |---|---| | ASSETSCTL_OUTPUT_MODE | local|remote（或用 --local/--remote） | | ASSETSCTL_OUTPUT_DIR | 覆盖 output 目录（默认 <workspace>/../output） | | ASSETSCTL_RECIPES | recipe 文件路径（默认 recipes/default.json） | | ASSETSCTL_CMD_BIN | 覆盖外部命令 argv[0]（测试注入 mock） | | ASSETSCTL_DEBUG=1 | 错误输出还原内部诊断 | | SANDBOX_PROJECT_GROUP_NO | 项目组（透传给 recipe 的 ${pg}） |

退出码

0 成功/有改动 · 64 用法错 · 66 输入不可用 · 70 运行时 · 78 写了但校验/生成需 agent 修复。