beeftv 命令行基础使用

ln -sf '/Applications/BeefTV.app/Contents/MacOS/cli/beeftv' /usr/local/bin/beeftv
beeftv --help

beeftv: runtime_not_found: 未发现运行中的 BeefTV 工作区。请先打开 BeefTV；若使用自定义目录，请检查 BEEFTV_DATA_DIR；独立服务请显式设置 BEEFTV_BASE_URL

export BEEFTV_BASE_URL=http://127.0.0.1:8080/api

export BEEFTV_DATA_DIR=<工作区数据目录>
export BEEFTV_CLIENT_ID=client-xxxxxxxxxxxxxxxx
export BEEFTV_CLIENT_TOKEN=<连接配置里给出的 token>

# 登记需要 owner 凭据；外部客户端凭据不能登记或吊销客户端
beeftv client register --label "批量脚本" --kind other --mode read-only

beeftv: forbidden: 缺少可信身份：需要已登记的客户端凭据、owner 凭据或受信任的桌面界面

beeftv ops                 # 操作清单：ID、读写、作用域、说明
beeftv ops --read-only     # 只看只读操作
beeftv ops --json          # 机器可读，含每个操作的 JSON 参数结构
beeftv business discover   # 已挂载的业务 REST 接口清单，含 path/query/body 结构

beeftv canvas search --query "末日" --page 1 --page-size 10
beeftv canvas get --canvas <canvasId> --json
beeftv asset list --kind image --page-size 20 --json
beeftv asset get --asset <assetId> --json
beeftv task get --task <taskId> --json

{"op":"canvas.search","replayed":false,"result":{"projects":[{"id":"cli-doc-canvas","title":"CLI 文档验证画布","revision":1,"nodeCount":0}],"page":1,"pageSize":5,"total":1,"hasMore":false},"caller":"external"}

rev=$(beeftv canvas get --canvas "$CANVAS" --json \
  | python3 -c 'import json,sys;print(json.load(sys.stdin)["result"]["canvas"]["revision"])')
beeftv canvas nodes create --canvas "$CANVAS" --expected-revision "$rev" \
  --node "镜头1:image:水塔配给点，清晨薄雾" --op-id batch-shots-1

rev=$(beeftv canvas get --canvas "$CANVAS" --json | jq -r '.result.canvas.revision')

beeftv: stale_revision: 云端画布已有更新，已停止覆盖；请保留本地草稿并加载最新版本

# 改标题：用刚读到的 revision
beeftv canvas node update --canvas "$CANVAS" --node "$NODE" --expected-revision "$rev" \
  --title "镜头1（已确认）" --prompt "水塔配给点，清晨薄雾，广角" --op-id batch-shot1-title

# 连边：上一次写入已经让 revision 前进，所以重新读一次
rev=$(beeftv canvas get --canvas "$CANVAS" --json | jq -r '.result.canvas.revision')
beeftv canvas edge create --canvas "$CANVAS" --from "$IMG_NODE" --to "$VIDEO_NODE" \
  --expected-revision "$rev" --op-id batch-shot1-edge

beeftv: operation_id_reused_with_different_payload: 同一操作 ID 已用于不同的请求内容；请换用新的操作 ID

# beeftv canvas nodes create / node update / edge create 缺 --op-id
beeftv: missing_flag: --canvas/--op-id/--expected-revision/--node 必填

# beeftv ops call 缺幂等键
beeftv: missing_op_id: 写操作必须提供 opId 作为幂等键

beeftv ops call canvas.node.move --operation-id batch-move-1 \
  --params '{"canvasId":"<canvasId>","expectedRevision":6,"nodeId":"<nodeId>","position":{"x":1400,"y":260}}'

beeftv ops call canvas.script.rows.append --operation-id batch-rows-1 \
  --params '{"canvasId":"<canvasId>","nodeId":"<scriptNodeId>","expectedRevision":7,"rows":[{"narrativeIntent":"开场建立环境","dialogue":"（风声）","durationSeconds":6,"imageGenerationPrompt":"黄昏的水塔剪影，广角"}]}'

#!/usr/bin/env bash
set -euo pipefail
CANVAS=<canvasId>
# 新批次换一个新值；续跑时传入与上次相同的值，才能复用同一个幂等键
BATCH=${BATCH:-batch-$(date +%Y%m%d-%H%M%S)}
PLAN="plan-$BATCH.jsonl"   # 已发送过的原请求：opId 与当时的 expectedRevision
DONE="done-$BATCH.jsonl"   # 已成功的项
touch "$PLAN" "$DONE"
failed=0

# 重试必须复用首次的原 revision，否则服务端按「同一操作 ID 换内容」拒绝
planned_revision() {
  grep -o "{\"opId\":\"$1\"[^}]*}" "$PLAN" 2>/dev/null | sed -n 's/.*"expectedRevision":\([0-9]*\).*/\1/p' | head -1 || true
}

i=0
while IFS= read -r prompt; do
  [ -z "$prompt" ] && continue
  i=$((i + 1))
  opid="$BATCH-$i"
  if grep -q "{\"opId\":\"$opid\"" "$DONE"; then continue; fi
  rev=$(planned_revision "$opid")
  if [ -z "$rev" ]; then
    rev=$(beeftv canvas get --canvas "$CANVAS" --json | jq -r '.result.canvas.revision')
    printf '{"opId":"%s","expectedRevision":%s}\n' "$opid" "$rev" >> "$PLAN"
  fi
  if beeftv canvas nodes create --canvas "$CANVAS" --expected-revision "$rev" \
       --node "镜头$i:image:$prompt" --op-id "$opid" --json > last.json 2> last.err; then
    python3 -c "import json;d=json.load(open('last.json'));n=d['result']['created'][0];print(json.dumps({'opId':'$opid','nodeId':n['id'],'title':n['title']},ensure_ascii=False,separators=(',',':')))" >> "$DONE"
  else
    echo "失败：$opid $(cat last.err)" >&2
    failed=$((failed + 1))
  fi
done < shots.txt

[ "$failed" -eq 0 ] || { echo "本次有 $failed 个镜头写入失败" >&2; exit 1; }

{"opId":"fb2-batch-1-1","nodeId":"node-dmf8m0pus7c8-b384577949","title":"镜头1"}

beeftv business upload --file ./ref.png --target resource

beeftv mcp serve                       # 画布、素材、媒体、技能操作 + 底层接口的两个入口
beeftv mcp serve --read-only           # 只暴露只读工具
beeftv mcp serve --all-business-tools  # 把每个底层业务接口单独列成工具

beeftv mcp serve: 40 个工具，base=http://127.0.0.1:<动态端口>/api（运行中的桌面工作区），client=client-xxxxxxxx

beeftv skills help
beeftv skills search 分镜 --target beeftv
beeftv skills show <skillId> --release <releaseId>
beeftv skills fetch <skillId> --release <releaseId> --output ./skills
beeftv diagnostics analyze --file ./diagnostics.zip

beeftv: diagnostics_bundle_invalid: 诊断包损坏或格式不受支持，需要 schema 3 诊断包