@uzooai/anime-ai-cli 0.5.0 → 0.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/skills/uzoo-anime-cli/SKILL.md +10 -4
- package/.agents/skills/uzoo-anime-cli/references/agreement-workflow.md +0 -10
- package/.agents/skills/uzoo-anime-cli/references/commands.md +8 -16
- package/.agents/skills/uzoo-anime-cli/references/generation-workflow.md +3 -13
- package/.agents/skills/uzoo-anime-cli/references/image-tools-workflow.md +5 -27
- package/.agents/skills/uzoo-anime-cli/references/interaction-workflow.md +1 -1
- package/.agents/skills/uzoo-anime-cli/references/material-graph-workflow.md +7 -17
- package/.agents/skills/uzoo-anime-cli/references/node-capabilities.md +19 -50
- package/.agents/skills/uzoo-anime-cli/references/node-workflow.md +3 -7
- package/.agents/skills/uzoo-anime-cli/references/remake-workflow.md +1 -1
- package/.agents/skills/uzoo-anime-cli/references/repaint-workflow.md +7 -294
- package/.agents/skills/uzoo-anime-cli/references/seedance-review-workflow.md +1 -5
- package/.agents/skills/uzoo-anime-cli/references/video-tools-workflow.md +3 -7
- package/CHANGELOG.md +9 -85
- package/README.md +27 -219
- package/docs/Agent/346/216/245/345/205/245/344/270/216/347/211/210/346/234/254/346/233/264/346/226/260.md +41 -0
- package/package.json +11 -13
- package/src/cli.js +5 -0
- package/src/group-membership.js +0 -1
- package/src/install.js +237 -0
- package/assets/README.md +0 -4
- package/docs/CLI/345/275/223/345/211/215/350/214/203/345/233/264/344/270/216/346/234/254/345/234/260/346/211/223/345/214/205-20261103.md +0 -134
- package/docs/CLI/346/216/210/346/235/203/346/216/245/345/217/243/344/270/216/344/273/244/347/211/214/350/207/252/345/212/250/345/210/267/346/226/260/350/256/276/350/256/241.md +0 -540
- package/docs/CLI/347/274/272/345/217/243/346/240/270/345/257/271/344/270/216/346/224/266/345/260/276-20261105.md +0 -65
- package/docs/CLI/347/275/221/351/241/265/344/277/235/345/255/230/350/212/202/347/202/271/347/274/272/345/244/261/344/272/244/346/216/245.md +0 -52
- package/docs/M0-M5/345/256/236/346/226/275/344/270/216/351/252/214/346/224/266.md +0 -89
- package/docs/npm/347/272/277/344/270/212/345/217/221/345/270/203/344/270/216/345/256/211/350/243/205/344/275/277/347/224/250.md +0 -151
- package/docs//344/270/213/350/275/275/346/216/245/345/217/243/351/200/202/351/205/215/344/270/216/351/252/214/346/224/266.md +0 -107
- package/docs//344/270/232/345/212/241/350/203/275/345/212/233/350/241/245/345/205/250/344/270/216Skill/347/273/223/346/236/204/350/247/204/345/210/222.md +0 -311
- package/docs//345/205/250/345/261/200/351/231/204/344/273/266/350/265/204/346/272/220/345/234/260/345/235/200/344/270/216/346/250/241/345/236/213/350/257/273/345/217/226/345/267/256/345/274/202.md +0 -47
- package/docs//345/206/205/351/203/250Windows/345/256/211/350/243/205/344/270/216/345/215/207/347/272/247/351/252/214/346/224/266/346/270/205/345/215/225.md +0 -34
- package/docs//345/233/276/347/211/207/346/212/240/345/233/276/346/216/245/345/205/245/344/270/216/351/252/214/346/224/266-20261104.md +0 -110
- package/docs//345/274/200/345/217/221/350/256/241/345/210/222.md +0 -127
- package/docs//345/274/202/346/255/245/346/212/240/345/233/276CLI/346/235/203/351/231/220/344/272/244/346/216/245-20261105.md +0 -50
- package/docs//345/274/202/346/255/245/346/212/240/345/233/276/347/234/237/345/256/236/351/252/214/346/224/266-20261105.md +0 -44
- package/docs//346/226/260/344/274/232/350/257/235/344/273/273/345/212/241/344/272/244/344/273/243-/351/230/266/346/256/2652A.md +0 -79
- package/docs//346/226/260/351/203/250/347/275/262/347/224/273/345/270/203/345/206/262/347/252/201/351/252/214/346/224/266-20261102.md +0 -61
- package/docs//346/231/256/351/200/232/346/265/217/350/247/210/345/231/250/347/231/273/345/275/225.md +0 -53
- package/docs//346/255/243/345/274/217/347/253/231/345/210/207/346/215/242/344/270/216/351/252/214/346/224/266-20261104.md +0 -90
- package/docs//347/224/273/345/270/203CLI/344/270/213/344/270/200/351/230/266/346/256/265/345/274/200/345/217/221/350/256/241/345/210/222.md +0 -136
- package/docs//347/224/273/345/270/203CLI/351/235/236/350/275/254/347/273/230/345/256/214/345/226/204/350/256/241/345/210/222.md +0 -183
- package/docs//347/224/273/345/270/203/350/203/275/345/212/233/345/245/221/347/272/246/346/240/270/345/257/271.md +0 -59
- package/docs//347/234/237/345/256/236/344/270/232/345/212/241/346/216/245/345/205/245/344/270/216/346/265/213/350/257/225.md +0 -1004
- package/docs//347/264/240/346/235/220/345/205/245/345/272/223/344/270/216/347/224/273/345/270/203/344/277/235/345/255/230/351/227/256/351/242/230/345/256/232/344/275/215.md +0 -52
- package/docs//351/230/266/346/256/2653B/351/252/214/346/224/266/344/272/244/346/216/245.md +0 -44
- package/docs//351/230/266/346/256/265/344/270/200/351/252/214/346/224/266.md +0 -60
- package/docs//351/235/236/350/275/254/347/273/230/346/214/201/347/273/255/345/256/214/345/226/204/344/270/216/351/252/214/346/224/266-20261103.md +0 -76
- package/docs//351/235/236/350/275/254/347/273/230/347/254/254/344/272/214/346/211/271/345/256/236/346/226/275/344/270/216/351/252/214/346/224/266.md +0 -39
- package/docs//351/235/236/350/275/254/347/273/230/350/241/245/345/205/205/346/235/241/344/273/266/351/252/214/346/224/266-20261103.md +0 -113
- package/docs//351/235/236/350/275/254/347/273/230/351/246/226/346/211/271/345/256/236/346/226/275/344/270/216/351/252/214/346/224/266.md +0 -71
- package/examples/real-business/image-request.template.json +0 -7
- package/examples/real-business/node-patch.template.json +0 -11
- package/scripts/check-package-resources.mjs +0 -56
- package/scripts/check-release.mjs +0 -19
- package/scripts/pack-local.mjs +0 -33
- package/scripts/release-policy.mjs +0 -22
|
@@ -5,13 +5,19 @@ description: Use Uzoo Anime CLI for canvas and node operations, material upload
|
|
|
5
5
|
|
|
6
6
|
# Uzoo Anime CLI
|
|
7
7
|
|
|
8
|
-
Video repaint
|
|
8
|
+
Video repaint is paused. Use retained commands only when explicitly asked to inspect or download an existing result or diagnose an existing failure. Do not submit a new task or write to a canvas as part of that inspection. Segment remake is separate.
|
|
9
9
|
|
|
10
10
|
Historical video repaint scope was the canvas workflow only. The separate 视频转绘 page and its standalone generation-preparation/material-selection flow are not integrated and are not planned for implementation now. Shared API helpers or historical upload tests do not establish page support.
|
|
11
11
|
|
|
12
|
-
Use `uzoo-anime --version` for the installed version and `uzoo-anime skill path` to locate this bundled skill; both are local and need no login. npm installation or upgrading does not register or update a separately copied host skill automatically.
|
|
12
|
+
Use `uzoo-anime --version` for the installed version and `uzoo-anime skill path` to locate this bundled skill; both are local and need no login. Plain npm installation or upgrading does not register or update a separately copied host skill. The optional `install` command can install the CLI and its matching skill into user-selected local hosts; use `install --help` or `install --dry-run` for discovery. Do not invoke installation automatically for a creative task.
|
|
13
13
|
|
|
14
|
-
Use the installed `uzoo-anime` command
|
|
14
|
+
Use the installed `uzoo-anime` command. Read only the references needed for the task.
|
|
15
|
+
|
|
16
|
+
## Check for updates
|
|
17
|
+
|
|
18
|
+
On first actual use in a conversation, read `uzoo-anime --version` and, unless the user opts out or an operation is already in progress, query the public stable version with `npm view @uzooai/anime-ai-cli@latest version --json --registry=https://registry.npmjs.org/ --fetch-retries=0 --fetch-timeout=5000`. Compare as semantic versions. Do this at most once per conversation unless asked to check again. If the query fails or there is no newer stable version, continue normally without blocking the user's task.
|
|
19
|
+
|
|
20
|
+
If a newer stable version exists, show the installed and available versions and let the user choose to keep using the current version or update. Use a host choice card when available. No answer is not consent. Before any installation, confirm the exact version and whether to update only the CLI or also the selected Agent Skills. Use the confirmed version in the npm command; never switch channels or overwrite a modified Skill without the user's decision. If an operation is active or its outcome is unknown, finish or reconcile it first. After updating, verify the CLI version and, if selected, the host Skill; keep the same profile and operation records.
|
|
15
21
|
|
|
16
22
|
| Task | Reference |
|
|
17
23
|
|---|---|
|
|
@@ -80,4 +86,4 @@ For background image matting, follow [the local worker workflow](references/imag
|
|
|
80
86
|
|
|
81
87
|
For the new server-side matting job API, use [the asynchronous job workflow](references/image-tools-workflow.md#服务端异步抠图任务). Persist the received job_id in the original operation; matting-get queries the server, while matting-status remains local. Do not replay a submission whose response lost the job ID. Legacy local-worker operations keep their original recovery path.
|
|
82
88
|
|
|
83
|
-
|
|
89
|
+
For asynchronous matting, recover with the original job and operation. Never resubmit when acceptance is unknown.
|
|
@@ -39,13 +39,3 @@
|
|
|
39
39
|
## 明确拒绝与未知响应
|
|
40
40
|
|
|
41
41
|
签署接口明确业务2001或HTTP401/403拒绝时,页面显示安全错误并终止等待,CLI报AGREEMENT_REJECTED、agreement_rejected,保留实际api_code及HTTP/request_id,不冒充4401或签署成功。请求未知仍只读GET,不自动重POST。聊天表示已签不能替代服务端agreed;本人点击被拒绝时记录交接,不反复要求用户点击。无余额/团队不自动充值、入队或切付款方。
|
|
42
|
-
|
|
43
|
-
## 真实签署复核更新(2026-11-03)
|
|
44
|
-
|
|
45
|
-
已完成受控未签账号由本人操作CLI阅读页,签署POST recorded=true/agreed=true,CLI核验和独立后续GET均为当前v2已签;此前服务端2001失败记录保留为历史。该实测证明协议独立签署链路,不扩大为收费生成原operation续接通过。普通浏览器阅读页可由CLI自身打开,Agent不需要借助Windows UI自动化代操作签署。
|
|
46
|
-
|
|
47
|
-
## 2026-11-04 新协议v3真实续接通过
|
|
48
|
-
|
|
49
|
-
猫猫队实际v3未签状态下,CLI先持久化blocked_agreement(无生成POST/远端任务);本人阅读签署后,通过原recover复核账号、请求及报价,以原operation和同一幂等键提交一次,任务2078完成、实际16 OO,回填/下载/完整解码通过;再次recover无新提交。此项更新v2独立签署后“尚缺收费原任务续接”的历史状态。未向生成接口故意跳过前检制造4401;并发版本变化的服务端4401分支仍为模拟覆盖。正文版本更新必须重读当前服务端状态,不能把本次v3已签当作未来版本同意。
|
|
50
|
-
|
|
51
|
-
2026-11-05收尾核对:2026-11-04已有v3真实CLI前检blocked_agreement→本人签署→原operation/请求hash/幂等键保持→唯一任务2078完成、实际16 OO及交付证据。不能再列为整条真实续接缺失;并发协议变化使服务端实际生成POST返回4401仍仅模拟,不与前检混淆。
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# CLI 命令契约
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**范围**:转绘暂停。只在用户明确要求查询/下载原结果或排障时使用旧命令,不提交新任务或自动恢复画布写入。
|
|
4
4
|
|
|
5
|
-
安装后使用 `uzoo-anime
|
|
5
|
+
安装后使用 `uzoo-anime`,需要 Node.js 22+。创建画布与异常恢复见 [画布流程](canvas-workflow.md)。
|
|
6
6
|
|
|
7
7
|
业务命令支持 `--profile NAME --format json|table --request-timeout MS`。本地`--version`/`-v`仅单独输出版本;`version`和`skill path`只接受--format,不读凭据、不锁profile、不联网。默认 JSON,失败在 stderr 输出 `{ "error": { "code", "message" } }`,退出码非零。查询输出保留 API 原有字段;列表通常为 `items` 和 `next_cursor`,翻页时传回游标。无通用业务重试,扣费提交不会自动重试。
|
|
8
8
|
|
|
@@ -151,7 +151,7 @@ material save/save-recover --yes、video clip --yes、video clip-recover、video
|
|
|
151
151
|
|
|
152
152
|
## 图片抠图
|
|
153
153
|
|
|
154
|
-
|
|
154
|
+
`image matting-submit NAME [--yes]`提交已预览的异步任务;原 matting-get 查状态,完成后原 matting-recover --yes 取回并落图。matting-status 是本地快照。见[异步流程](image-tools-workflow.md#服务端异步抠图任务)。
|
|
155
155
|
|
|
156
156
|
`image matting-start NAME [--yes]`:先有同operation预览,确认后独立后台仅缓存PNG;`image matting-status NAME`:本地/离线只读状态,不取凭据、不争profile锁。后台operation的matting-get同为本地查询;matting-recover [--yes]仍需联网核验,确认后恢复落图。重复启动/未知响应不重POST。详见[后台流程](image-tools-workflow.md#抠图独立后台执行与本地查询)。
|
|
157
157
|
|
|
@@ -167,7 +167,7 @@ material save/save-recover --yes、video clip --yes、video clip-recover、video
|
|
|
167
167
|
|
|
168
168
|
## 转绘任务素材与全局附件
|
|
169
169
|
|
|
170
|
-
|
|
170
|
+
转绘仅限[原运行只读查询](repaint-workflow.md#原运行只读查询)和原结果下载;不使用旧附件或处理命令继续生成。
|
|
171
171
|
|
|
172
172
|
DELIVERY_ATTACHMENT_ADDRESS_UNUSABLE是CLI预检错误(退出2),不是后端任务失败码。预览仍返回有效费用分项及submission_available=false,不能仅凭退出0执行收费;真实处理地址阻止时不再上传、不猜公网域名。附件超额按每段每次一口价,单段估价交叉核验实时pricing和job/billing-estimate,规则与恢复见上述指南。
|
|
173
173
|
|
|
@@ -179,13 +179,11 @@ DELIVERY_ATTACHMENT_ADDRESS_UNUSABLE是CLI预检错误(退出2),不是后
|
|
|
179
179
|
- 新说明取消团队素材及转绘下载白名单;访问仍由业务端按归属、活跃成员、公开/私有任务、完成与下架状态判断,不能把获取链接成功当作后续传输必然成功。code2001不单独证明白名单问题;核对当前服务版本、账号和原任务可见性,禁止改用缓存result.url绕过业务拒绝。原expires_at=null不代表永久有效。引用不能续期时通过同一有权限的业务入口重新获取,不重新生成。
|
|
180
180
|
- 素材空间专属原文件下载已接material download;服务端命名按实际响应交付,读取Content-Disposition不是设置服务端名称;当前不支持格式转换,没有相应CLI参数或预览命令。旧前端素材下载尚无新命名/格式控件,不将后端可接收的format自动扩成CLI选项。服务端转换依赖服务器FFmpeg,与CLI本机截帧/裁剪的按需依赖不同;不得因此要求用户安装本机工具。转换失败不自动改下原文件或重试转码。
|
|
181
181
|
|
|
182
|
-
维护/部署差异与真实验收见项目docs/下载接口适配与验收.md;安装用户按本节和当前命令输出操作,无需源码仓库。说明更新不证明所连接服务已部署新版。
|
|
183
|
-
|
|
184
182
|
## 普通分组重命名
|
|
185
183
|
|
|
186
184
|
graph rename-group --input rename.json 默认只读预览,不写画布;输入doc_id、space、团队时team_uid、group_id、name。预览返回原名称、新名称和expected_version。用户已明确重命名目标与名称时沿用授权,否则先展示影响收集选择。将expected_version加入同一输入,执行graph rename-group --input rename.json --yes。
|
|
187
185
|
|
|
188
|
-
|
|
186
|
+
只修改指定普通组的名称。相同名称不写入。冲突或保存结果不明,先用 canvas get 核对,不重放。
|
|
189
187
|
|
|
190
188
|
组重命名会在预览前检查完整画布/分组结构;保存后另行GET确认当前目标组名,成功返回rename_verified=true。读回失败或不一致时明确报告未确认/内容变化,不自动重放保存;保留服务端当前版本。
|
|
191
189
|
|
|
@@ -193,7 +191,7 @@ graph rename-group --input rename.json 默认只读预览,不写画布;输
|
|
|
193
191
|
|
|
194
192
|
uzoo-anime graph ungroup --input ungroup.json 默认预览;输入doc_id、space、团队时team_uid、group_id,可选expected_version。展示被移除组与membership_changes(其他组active/exited成员前后变化);用户确认具体范围后将预览expected_version写回输入,加--yes执行。已有明确任务授权沿用,不重复询问。
|
|
195
193
|
|
|
196
|
-
|
|
194
|
+
拆组只删除普通组元数据,保留节点、位置、连线和引用。版本变化、冲突或结果未知,先用 canvas get 核对,不重放。
|
|
197
195
|
|
|
198
196
|
## 普通断线
|
|
199
197
|
|
|
@@ -209,8 +207,6 @@ node copy --input copy.json 默认只读预览;输入doc_id、space、团队te
|
|
|
209
207
|
|
|
210
208
|
仅普通文本节点,保留文本/配置;原上游与持久参考合并为新节点持久引用,外部节点ID保持,不复制连线/分组、不触发生成。进行中任务、派生和媒体节点拒绝;非完成状态清理运行任务绑定。前端媒体复制还有来源历史协议,不能把本命令称为全节点复制。版本冲突或读回失败停止,先查固定新ID,不自动重放。
|
|
211
209
|
|
|
212
|
-
真实新代理验收:原独立测试画布36→37版,复制CLI断线验收到cli-text-copy-20261102,9节点,其他节点/边/meta保持;网页重开待验。
|
|
213
|
-
|
|
214
210
|
## 普通节点删除
|
|
215
211
|
|
|
216
212
|
node delete --input delete.json 默认只读预览;输入doc_id、space、团队team_uid、node_ids,实际执行增加预览expected_version并传--yes。展示节点列表、removed_edge_ids、group_changes、retained_references及mode_changes,用户明确授权具体删除范围后执行。不能把笼统开发请求当作删除业务节点的授权。
|
|
@@ -225,8 +221,6 @@ node copy-batch --input copies.json 默认只读预览,输入doc_id、space、
|
|
|
225
221
|
|
|
226
222
|
限普通文本,继承上游/持久引用,不复制边或组。批内引用ID与稳定提示词标记同时映射到新ID,保留手动@@标记;外部引用不变。相较当前本地前端仅映射references的实现,CLI额外同步prompt中的稳定标记,避免副本中引用对象与提示词不一致;预览显示prompt前后。原节点保持;媒体来源历史和跨画布复制未接入。
|
|
227
223
|
|
|
228
|
-
真实服务测试44→45版10节点,复制两个原测试文本,原内容保持;批内引用重映射有模拟覆盖,本次真实两源无引用,不能扩大为真实跨节点引用验收。网页重开待验。
|
|
229
|
-
|
|
230
224
|
## 媒体复制、分组编辑与样片转正片补充
|
|
231
225
|
|
|
232
226
|
- `node copy --input FILE [--yes]`:同画布普通文本/图片视频生成及三类素材;`node copy-batch`:copies数组1–100项,支持混合类型和批内引用重映射。预览/expected_version/一次CAS;派生或进行中成员停止。
|
|
@@ -243,8 +237,6 @@ node copy-batch --input copies.json 默认只读预览,输入doc_id、space、
|
|
|
243
237
|
|
|
244
238
|
新节点last_task_id为空,source_task_id和copied_generation_history仅表示来源,不能查询成新节点自己的任务。来源历史保存原任务的模式、时间和原提示词,不将新增节点的无素材默认模式误称为原任务模式。`history-add-get NAME`/`history-add-recover NAME`仅查询原operation和服务端节点;保存未知、冲突均不重发PUT。add_verified核验原新增节点,canvas_preserved/source_unchanged另报当前快照与原保存基线的差异;后续合法编辑其他节点不会自动否认原新增。新节点被改/删则停止,不自动覆盖或重建。
|
|
245
239
|
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
## 正式站CLI授权关闭
|
|
240
|
+
## 服务未开放 CLI 授权
|
|
249
241
|
|
|
250
|
-
|
|
242
|
+
授权接口返回 cli_auth_disabled 时,说明所连服务没有开放 CLI 授权。使用服务支持的正常网页登录,不复制网页令牌或其他服务的凭据。
|
|
@@ -43,8 +43,6 @@ CLI 按当前前端普通节点及请求构造器已使用的字段维护生成
|
|
|
43
43
|
- Seedance 视频的比例/分辨率按前端放在顶层;图片和其他视频模型按前端放入 extra。prepare 不补用户协议同意;active 审核可生成 reference_canvas_task_ids,素材引用与保存的审核不一致时停止。
|
|
44
44
|
- 当前前端普通图片运行路径以入边判断模式,但参考列表可包含断线保留素材,因此可能出现有 reference_image_urls 而模式为 text2image。CLI 保留该差异并展示实际请求;这不是对服务端能成功执行该组合的保证。需要图生图时先核对实际模型和合法连线,不静默更换模式或丢弃参考。
|
|
45
45
|
|
|
46
|
-
上述行为通过真实前端 codec、节点 payload 和请求构造器的对照用例,不代表所有模型和真实生成已验收。节点设置来源按前端持久化协议,不以接受某个 extra 字段就宣称支持全部业务流程。
|
|
47
|
-
|
|
48
46
|
## 视频协议前置检查
|
|
49
47
|
|
|
50
48
|
Seedance 首次使用或协议更新时,按 [协议签署与继续原任务](agreement-workflow.md) 查询当前 required/agreed/version。HTTP 200 + code 4401 表示《统一协议》中《Seedance2.0模型使用承诺书》待签署,是生成前置条件,不是生成任务失败。
|
|
@@ -71,8 +69,6 @@ operation 绑定 API 地址、账号与请求摘要;绑定不匹配时停止
|
|
|
71
69
|
4. 用户明确选择并了解覆盖范围后,沿用同一输入和 operation 加 `--yes`。既有明确选择不重复确认。多人协作时协调暂停同画布编辑,CLI 再读最新快照并按版本仅保存一次;目标节点、历史内容或归属变化立即停止。进行中任务不得切换。切换不提交生成、不扣新的生成费、不另存素材库;历史签名引用改变时可能匿名流式读取原媒体作大小/SHA-256比对,不导出文件或绕过权限。
|
|
72
70
|
5. 检查 state=applied、selection_verified=true,读回 task_id、结果及历史配置。用 `generation history-get NAME` 或 `generation history-recover NAME` 核验原选择;两者仅查询服务/画布并更新本地核验状态,不重发画布 PUT。保存响应丢失或 CAS 冲突时返回 NODE_HISTORY_SAVE_PENDING(退出4),仍查询原 operation。canvas_changed 或 selection_verified=false 时保留当前内容,不自动恢复、重建或换键覆盖;新的选择需重新预览并获得相应授权。不能只凭退出0判定选择仍在画布上。
|
|
73
71
|
|
|
74
|
-
普通视频历史切换并恢复已完成真实验收;普通图片已完成真实切换与恢复,并在2026-11-03完成网页采用旧项/保存重开/恢复2071再次重开;不新增付费生成。
|
|
75
|
-
|
|
76
72
|
## 下载原文件
|
|
77
73
|
|
|
78
74
|
`generation download TASK_ID --output FILE [--sha256 HEX]`先请求原任务业务下载入口,再匿名读取返回的完整url。支持最多5次307引用续期,不向文件地址发送登录凭据;HTTP200中的错误JSON、HTML、不完整流及非预期206/202都停止,不留下最终文件。filename/format不是该业务入口的参数;任务没有文件时从get读取文本结果。下载拒绝不等于生成失败,不重新生成或改用缓存媒体地址绕过;详细边界见[下载与文件凭证](commands.md#下载与文件凭证)。
|
|
@@ -115,9 +111,9 @@ CLI先一次CAS创建带extra.draft_finalize(parent_node_id/parent_task_id)的
|
|
|
115
111
|
|
|
116
112
|
提交未知只查询专属输出节点的任务列表并核对doc/node/父任务,唯一匹配才认领;未找到或歧义保持未知,不重POST、不换operation、不删除派生节点。后端可能在幂等查询前校验样片有效期/权益,不能靠重提交恢复。保存未知先读固定节点和来源线,不重放;节点删除/改绑后停止,不重建。模拟恢复与前端待处理/完成资产编解码通过;任务1989并非真实样片;后续已获当次授权并完成2072样片→2073正片的真实CLI闭环及网页重开/完整播放。
|
|
117
113
|
|
|
118
|
-
##
|
|
114
|
+
## 来源历史
|
|
119
115
|
|
|
120
|
-
|
|
116
|
+
普通复制节点的 `generation history` 另列 copied_history,且 copied_history_selectable=false。来源历史不属于副本的远端任务,不能作为副本自己的 history-select。
|
|
121
117
|
|
|
122
118
|
普通图片prepare及直接estimate/submit均只支持数值image_count=1,多张/零张/字符串数量在预估前拒绝。当前部署图片设置只有比例/清晰度,高级设置为自动识别引用;未找到数量控件及多结果保存/历史/入库完整契约。目录上限或底层image_count字段不等于多张生成已接入。
|
|
123
119
|
|
|
@@ -135,7 +131,7 @@ CLI先一次CAS创建带extra.draft_finalize(parent_node_id/parent_task_id)的
|
|
|
135
131
|
|
|
136
132
|
## 样片认可后再渲染正片的交互顺序
|
|
137
133
|
|
|
138
|
-
|
|
134
|
+
样片先以较低画质验证内容。交付后等用户认可,再用 draft prepare 核对父任务、有效期与继承参数,单独展示正片报价。认可样片不等于授权正片扣费。正片完成后核对父子关联、实际费用和独立结果节点。
|
|
139
135
|
|
|
140
136
|
## 将普通历史结果添加为新节点
|
|
141
137
|
|
|
@@ -144,9 +140,3 @@ CLI先一次CAS创建带extra.draft_finalize(parent_node_id/parent_task_id)的
|
|
|
144
140
|
确认来源和新节点位置后,同输入/operation加 `--yes`:重新验证账号、服务、完整预览快照与历史身份,一次CAS追加节点并独立GET读回。预览后任何画布变化均停止,重新预览核对;显式expected_version也必须匹配。不暂时切换原节点,不新生成、上传、入库,不复制边/组。原节点不变;新节点只带成品、历史模型/配置和去除自动素材准备段的提示词,引用列表为空,不继承审核授权、轮询/提交状态或样片可转正片状态。提示词中留下的@编号不表示请求恢复了输入素材,重新生成前须重新prepare配置。
|
|
145
141
|
|
|
146
142
|
新节点last_task_id为空,source_task_id和copied_generation_history仅表示来源,不能查询成新节点自己的任务。来源历史保存原任务的模式、时间和原提示词,不将新增节点的无素材默认模式误称为原任务模式。`history-add-get NAME`/`history-add-recover NAME`仅查询原operation和服务端节点;保存未知、冲突均不重发PUT。add_verified核验原新增节点,canvas_preserved/source_unchanged另报当前快照与原保存基线的差异;后续合法编辑其他节点不会自动否认原新增。新节点被改/删则停止,不自动覆盖或重建。
|
|
147
|
-
|
|
148
|
-
2026-11-03:图片1986与视频2069各新增一次真实通过,网页显示/保存重开通过,视频完整播放通过;没有新生成费。原图片两条历史采用1986、离开重开、恢复2071再次重开及独立服务端读回通过。2073正片网页1440×1440、4.064秒完整播放、无解码错误;CLI父子任务/费用核验见原记录。
|
|
149
|
-
|
|
150
|
-
## 2026-11-04 新协议v3真实续接通过
|
|
151
|
-
|
|
152
|
-
猫猫队实际v3未签状态下,CLI先持久化blocked_agreement(无生成POST/远端任务);本人阅读签署后,通过原recover复核账号、请求及报价,以原operation和同一幂等键提交一次,任务2078完成、实际16 OO,回填/下载/完整解码通过;再次recover无新提交。此项更新v2独立签署后“尚缺收费原任务续接”的历史状态。未向生成接口故意跳过前检制造4401;并发版本变化的服务端4401分支仍为模拟覆盖。正文版本更新必须重读当前服务端状态,不能把本次v3已签当作未来版本同意。
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
用户决定、方案与费用确认统一遵循 [交互流程](interaction-workflow.md):沿用已明确选择,缺项优先用卡片收集,等待回复后继续原任务;本路线的执行、签署与恢复边界仍按下文,不扩展功能。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
用于普通图片生成或素材节点中已完成的静态 PNG/JPEG。操作前核对实际空间、节点和原任务。
|
|
6
6
|
|
|
7
7
|
## 依赖与输入
|
|
8
8
|
|
|
@@ -43,7 +43,7 @@ UTF-8 crop.json(团队示例,个人移除 team_uid):
|
|
|
43
43
|
|
|
44
44
|
## 图片标注
|
|
45
45
|
|
|
46
|
-
|
|
46
|
+
支持矩形、椭圆、线条、画笔点列与单行文字。不支持旋转文字。坐标使用原图像素,按数组顺序合成,不重新生成图片。
|
|
47
47
|
|
|
48
48
|
### 依赖和输入选择
|
|
49
49
|
|
|
@@ -104,25 +104,9 @@ UTF-8 annotations.json示例(团队;个人移除team_uid;ID替换为本次
|
|
|
104
104
|
|
|
105
105
|
保存未知/CAS冲突只读核对固定结果及来源线,不重PUT;被删、改绑、改名或缺来源线时保留当前画布、不重建。网页补默认字段、精简JSON或调整位置尺寸不会误报失败:canvas_verified核对稳定成品引用、身份、文件名大小及来源关系;canvas_exactly_matches另报是否逐字段相等。原operation不能改绑服务/账号。
|
|
106
106
|
|
|
107
|
-
2026-11-04正式站原图7738真实免费执行、透明PNG、CAS落图、原结果GET/缓存核验及用户确认网页保存重开通过。42组完整模拟及实际前端factory/codec重开对照通过;无引用的未知提交服务端查回仍未接入。详见包内docs/图片抠图接入与验收-20261104.md。
|
|
108
|
-
|
|
109
107
|
## 图片抠图只读预检
|
|
110
108
|
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
## 2026-11-03 用户确认的抠图部署边界
|
|
114
|
-
|
|
115
|
-
用户明确当前抠图为免费服务,但开发部署没有抠图服务,只有正式部署才有;这更新前述待核价历史记录。本轮不调用开发服务POST探测、不切换正式服务,也不再将收费报价作为该免费服务的当前阻塞。正式部署验收仍需核对真实入口、免费约束、结果引用、透明通道、原结果查询与未知提交恢复;有图片返回不等于完整闭环。不自动安装推理依赖或把模型目录当作可用部署。
|
|
116
|
-
|
|
117
|
-
2026-11-03正式站补验:用户指定https://uzooai.com,使用独立本地加密profile准备本人网页登录授权;实际创建授权请求返回2110/cli_auth_disabled,未打开有效授权页、未取得正式站令牌。用户选择暂不启用,停止该路线,不导入开发站凭据、不探测推理POST。开发源码不能证明正式版协议,执行与原结果查询/未知恢复仍未接入;这不否定正式站网页抠图可用或免费。
|
|
118
|
-
|
|
119
|
-
## 2026-11-04 正式站接入更新
|
|
120
|
-
|
|
121
|
-
当前用户指定实际服务为https://uzooai.com,使用独立uzooai-online profile。用户启用授权后本人正常登录/授权及账号读回成功,历史2110/cli_auth_disabled阻塞已解除。正式站实际账号/团队与开发站不同,操作前重新查询并绑定实际对象,不迁移旧operation的服务地址。抠图已接入单次免费执行及已知原结果/缓存恢复,正式站真实处理和用户确认网页重开通过;未知响应无结果引用时仍无法服务端查回,不重发。免费处理不以余额0判不可用。
|
|
122
|
-
|
|
123
|
-
## 同步响应、节点回填与3秒复查
|
|
124
|
-
|
|
125
|
-
当前未变更接口是POST等待完成返回PNG/结果头,前端收到后更新结果节点并保存;可选后端内部排队仍返回原HTTP响应,不等于后台直接回填画布。页面processing/0→completed/100也不等于有实时进度查询接口。用户提供常见执行约3秒(不含排队),可作为已知节点的首次只读复查建议间隔;未出结果仍保留等待,不按3秒判失败。CLI/前端仍收到响应并完成保存,或者保存结果未知时,可读固定结果节点核验;原处理响应丢失且没有结果引用时,画布尚无可回填PNG,单靠等3秒读画布不能恢复。不新增请求绑定字段或重POST来掩盖此限制。
|
|
109
|
+
原预检入口保持,具体执行与恢复见上节。
|
|
126
110
|
|
|
127
111
|
## 抠图独立后台执行与本地查询
|
|
128
112
|
|
|
@@ -145,7 +129,7 @@ result_ready后按交互流程确认画布关闭/离开保存(本连续任
|
|
|
145
129
|
|
|
146
130
|
## 服务端异步抠图任务
|
|
147
131
|
|
|
148
|
-
|
|
132
|
+
POST /matting/jobs 提交后返回 HTTP 202 和 job_id。GET /matting/jobs/{job_id} 仅提交者可查;状态包括 queued、processing、succeeded、failed、cancelled,成功时核对结果引用和实际费用。
|
|
149
133
|
|
|
150
134
|
优先使用服务端job可让已接收任务在CLI/Agent退出后继续执行,不再需要本地worker持有原PNG连接:
|
|
151
135
|
|
|
@@ -166,10 +150,4 @@ matting-get联网查询原job并保存本地状态,不写画布、不下载PNG
|
|
|
166
150
|
|
|
167
151
|
提交响应真正丢失且未拿到job_id时,当前说明没有提供幂等提交/按请求键找回契约,仍为submission_unknown,不重POST,也不认领最新同源job。新增查询只解决已知job_id后的恢复,不能将旧同步未知operation自动转换为新任务。
|
|
168
152
|
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
2026-11-05用户随后决定等待其通知后端修复更新,并说明仓库后端不是最新版:本异步真实补验暂停等待,不自动轮询/拉取/重提;旧快照中的函数权限键只作交接参考,不能作为最新实现或部署证明。收到通知后重查实际契约/权限及旧未知请求副作用,再按原operation恢复;画布写入另需当时有效的关闭确认。
|
|
172
|
-
|
|
173
|
-
## 2026-11-05 异步路线实际验收更新
|
|
174
|
-
|
|
175
|
-
用户已通知权限修复并确认旧请求经服务端核验未入队,且重新确认画布关闭;此前等待决定已解除。正式站一次新关联operation确认202并保留job_id,提交进程退出后新CLI进程查询同job成功、实际credit_cost=0;原recover取回透明PNG并一次CAS、重复恢复不重放通过。用户确认本次结果显示正常、保存重开后结果和来源线仍在;随后服务端只读核验通过,网页规范化不要求全JSON相等。旧同步/本地后台记录继续原路径,不篡改旧未知记录。无job_id的未知提交仍不能自动重发;已确认未执行后如需新提交,应保留旧诊断、明确记录关联与核验来源。仓库旧权限键仅作历史参考,实际权限以当前部署正常CLI响应核对。详见包内docs/异步抠图真实验收-20261105.md;真实排队/失败/跨账号等仍未专项验证。
|
|
153
|
+
若部署拒绝 CLI 调用,保留原错误与 operation,不能用网页令牌绕过,也不能把接口权限错误误当成生成协议未签。
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
|
|
14
14
|
## 画布标签关闭确认
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
在 CLI 写画布之前,先通过卡片确认目标画布的网页标签已关闭且离开保存完成。网页可能保留旧内容,后续自动保存会覆盖 CLI 结果;停止编辑或退回工作台不足以代替关闭标签。
|
|
17
17
|
|
|
18
18
|
- 对已有画布的节点/连线/配置修改、上传绑定、历史切换、工具产物落图和生成结果回填,在首次执行前确认。`generation wait`、sync/recover等可能写回画布的命令同样适用;不能按命令名将其视作纯查询。
|
|
19
19
|
- 卡片写明目标画布,询问“是否已关闭该画布的所有相关网页标签(包括其他窗口/设备,并协调其他编辑者)并等待离开保存完成,且在CLI完成前保持关闭?”可选“已关闭并完成保存”“尚未关闭,先等待”。未明确回复不执行依赖的画布操作,可继续独立只读工作;不自动关闭用户页面。
|
|
@@ -50,16 +50,12 @@
|
|
|
50
50
|
|
|
51
51
|
核对准备的提示词、参考素材、模型、比例/分辨率/时长和数量,再按 [生成流程](generation-workflow.md) 预估 → 展示实际钱包与费用 → 当次明确确认 → 提交一次(带 --expected-cost 当次确认数值)→ 查询/恢复 → generation wait 自动回填或 generation sync 恢复 → 结果读回和交付。连线、上传或确认上一任务都不构成下一次扣费授权。
|
|
52
52
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
视频任务 completed 后还需核验实际音轨与时长等参数。模型目录中的 generate_audio 不能直接当作用户可切换的请求参数:当前 Seedance 执行适配读取管理端模型配置,未读取请求 extra.generate_audio;前端普通视频节点也没有该开关。此前测试自行写入 extra.generate_audio=false 后仍有声音,说明 CLI 当时错误地把配置字段当作已支持的请求覆盖,不能据此报告“后端无声参数未兑现”。在明确的请求契约和实际链路验收前,CLI 不承诺无声生成、不自行添加该字段;用户需要无声成片时先说明当前能力缺口,再明确可行处理方式,不自动重做收费任务。
|
|
53
|
+
完成视频任务后核验实际音轨与时长。模型配置不代表存在用户可用的音轨开关,不自行新增请求字段。
|
|
56
54
|
|
|
57
55
|
## 已有节点结果直接存素材库
|
|
58
56
|
|
|
59
57
|
这是用户主动发起的独立操作,与生成结果回填画布分开。前端需要点击保存到素材库、选择目标空间/目录再提交;当前没有生成后自动入库。用户只要求生成、剪辑、审核、查询或恢复时,到相应结果核验即止,不顺手入库。用户要求入库或测试入库后,空间可沿用已确认选择,目标目录须由用户指定或明确委托选择;名称/内容看似适合“角色”,或只有一个目录,都不能代替该选择。用户可指定目录名称,由 Agent 查询真实 ID,不要求其手填 ID;既有明确选择不重复问。
|
|
60
58
|
|
|
61
|
-
实现与模拟/前端契约已通过;真实单图片入库已按原请求/幂等键恢复成功,库中查询及真实 PNG 读取通过。曾遇到的 code 5000 保留为历史,当前不能继续标成入库不可用;本次产物的重新导入和网页人工验收仍待验证。遇到异常按下述恢复,不用下载重传绕过问题,也不重新生成。
|
|
62
|
-
|
|
63
59
|
业务错误先执行 service status 检查后端连接与真实就绪状态,再核对原目录/操作;连接恢复后只按原请求和幂等键恢复,不能仅凭健康就断定业务成功。历史上 ready 正常也曾遇到 code 5000;用户反馈素材上传受限制,后续原键恢复成功,但未取得服务端堆栈,不将具体根因写成已独立确认。
|
|
64
60
|
|
|
65
61
|
1. 读取源画布,核对已确认空间;普通图片/视频或素材节点须有关联的真实已完成任务,当前 file_ref 与任务输出一致。当前只支持同画布、同个人/团队空间;缺少任务关联、音频、派生节点或跨空间停止,不猜 task ID。
|
|
@@ -74,29 +70,23 @@
|
|
|
74
70
|
|
|
75
71
|
## 下载接口边界
|
|
76
72
|
|
|
77
|
-
|
|
73
|
+
CLI 的 material download 交付原文件,不开放请求自定义文件名或格式转换。
|
|
78
74
|
|
|
79
75
|
## 素材原文件下载
|
|
80
76
|
|
|
81
77
|
用户指定素材和空间后,`material download ASSET_ID --space personal --output FILE`;团队改为`--space team --team-uid UID`,可带`--sha256 HEX`核验。先通过真实目录和素材详情核验归属,再GET素材专属download入口,不传filename/format;只接受返回的original链接,匿名读取完整url并支持受限307续期。结果包含本地绝对路径、字节/摘要、asset_id、format及可选服务端filename,不输出file_ref或签名URL。output决定本地文件名,不修改素材名称。
|
|
82
78
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
2026-10-31补验:复用先前已入库图片重新导入画布,在525版核验原图与素材摘要相同且其他节点不变,没有重复入库或上传。随后网页打开保存后新导入节点与两帧一起缺失;因此仅CLI导入保存通过,网页重开保留未通过。来源/结果缺失按当前内容保留,不自动再导入或重建,见下述协作规则。
|
|
79
|
+
业务入口拒绝时保留原错误,不因 list/get 仍有 URL 就直连,也不切换到画布生成下载、下载后重传或重新入库。
|
|
86
80
|
|
|
87
81
|
## CLI与网页交替使用的停止条件
|
|
88
82
|
|
|
89
83
|
发现CLI成功保存的新节点/线在后续网页保存中缺失,先停止同画布写入,保存两端版本和原operation;不能通过反复PUT把节点补回。网页回工作台后再只读核验服务端与原媒体任务。即使CAS保存成功,也不能保证另一客户端不把旧内容用后续版本覆盖;需核对实际部署的冲突处理和自动保存。未核验原因前不归责具体成员,也不把刷新或暂停编辑当作根因已修复。原任务产物保留不等于节点仍在;恢复可因来源变化停止。
|
|
90
84
|
|
|
91
|
-
## 2026-11-02连接恢复与素材下载复验通过
|
|
92
|
-
|
|
93
|
-
2026-11-02 13:14(Asia/Shanghai)续测:原stage3b-test服务live/ready均HTTP200/code0,database/redis均ok;直连192.168.30.196:8208及经192.168.30.108:5174、127.0.0.1:5174的live探针均正常。沿用猫猫队素材107,通过现有material download专属入口成功获取original并完成匿名文件下载,1503859字节,SHA-256为760560e81026b08eef61287913c767ac3cc004d9d436b50ee1cb585a00513c90;本地重算摘要及PNG签名/尺寸检查通过。产物位于忽略目录.local/non-repaint-plan-20261031/material-107-20261102-recheck.png。本条原素材的CLI准入及文件交付已验证,不扩大为全部素材/账号/格式转换验证。先前502/ETIMEDOUT与2001保留为历史证据;当前恢复不能证明此前故障原因。未改配置或前后端、未写画布、上传、入库或提交生成。
|
|
94
|
-
|
|
95
85
|
## 普通分组重命名
|
|
96
86
|
|
|
97
87
|
graph rename-group --input rename.json 默认只读预览,不写画布;输入doc_id、space、团队时team_uid、group_id、name。预览返回原名称、新名称和expected_version。用户已明确重命名目标与名称时沿用授权,否则先展示影响收集选择。将expected_version加入同一输入,执行graph rename-group --input rename.json --yes。
|
|
98
88
|
|
|
99
|
-
|
|
89
|
+
仅修改指定普通组的名称。相同名称不写入。冲突或结果未知时先读取原画布,不重放。
|
|
100
90
|
|
|
101
91
|
组重命名会在预览前检查完整画布/分组结构;保存后另行GET确认当前目标组名,成功返回rename_verified=true。读回失败或不一致时明确报告未确认/内容变化,不自动重放保存;保留服务端当前版本。
|
|
102
92
|
|
|
@@ -104,7 +94,7 @@ graph rename-group --input rename.json 默认只读预览,不写画布;输
|
|
|
104
94
|
|
|
105
95
|
uzoo-anime graph ungroup --input ungroup.json 默认预览;输入doc_id、space、团队时team_uid、group_id,可选expected_version。展示被移除组与membership_changes(其他组active/exited成员前后变化);用户确认具体范围后将预览expected_version写回输入,加--yes执行。已有明确任务授权沿用,不重复询问。
|
|
106
96
|
|
|
107
|
-
|
|
97
|
+
拆组保留节点、位置、连线和引用。只同步已知成员关系,不吸收从未属于组的节点。涉及派生组、冲突或读回不一致时停止。
|
|
108
98
|
|
|
109
99
|
## 普通断线
|
|
110
100
|
|
|
@@ -112,12 +102,12 @@ graph disconnect --input disconnect.json 默认只读预览;输入doc_id、spa
|
|
|
112
102
|
|
|
113
103
|
仅删除指定普通边;还有同源同目标连线时保留引用。最后一条断开后同步清理有效持久引用及已有存储位置;手动@@{ref:ID}移除,自动@{ref:ID}还原名称。按剩余拓扑、保留持久参考和当前模型调整生成模式,不静默换模型。系统线、派生流程和不支持的配置协议停止;原生成/审核结果保留,断线不是取消远程任务。保存前版本变化或CAS冲突停止,结果未知/读回不一致不自动重放,先canvas get。
|
|
114
104
|
|
|
115
|
-
|
|
105
|
+
断线后用 prepare 核对实际请求和 reference_mapping,确认保留的素材引用与提示词仍一致。
|
|
116
106
|
|
|
117
107
|
## 普通分组移动、组框调整与组内重排
|
|
118
108
|
|
|
119
109
|
`graph move-group|resize-group|layout-group --input FILE`默认预览,公共字段为doc_id/space/team_uid/group_id,执行必须带本次expected_version及--yes。move-group传position(绝对x/y),整体平移组框和当前成员;已退出成员不跟随。resize-group传size(width≥120、height≥72),可选position,只改组框,不缩放节点或媒体。layout-group传layout=horizontal/vertical/grid,按现有位置和节点尺寸重排已有成员、调整组框。
|
|
120
110
|
|
|
121
|
-
|
|
111
|
+
预览核对节点位置、组框和成员变化。只同步已知成员关系;涉及派生组或节点时停止。一次保存并读回,冲突或结果未知时不重放。
|
|
122
112
|
|
|
123
113
|
断线后的模式计算还包含未被删除的持久参考,避免只看剩余边落成纯文本模式、随后网页又改回组合参考。@标记清理仅针对断开源;持久参考仍会进入prepare请求。“未采用素材”的文字说明不移除请求数组。图片/视频/音频混合prepare和断线、保留图片引用后的模式稳定已真实核验,无额外生成。
|
|
@@ -1,10 +1,8 @@
|
|
|
1
1
|
# 节点用途、素材工具与 CLI 接入状态
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
转绘暂停。CLI 仍可按用户明确授权查询、下载原结果或排障。单片段重拍是独立功能。
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
当前表格已按2026-11-05收尾核对更新;下方带日期的历史补充不覆盖本表。主线真实通过与未覆盖组合分别声明,不以历史“待验”重新开启已完成任务。
|
|
5
|
+
下表用于判断网页操作能否通过 CLI 完成。以命令帮助、实际服务和专用流程为准。
|
|
8
6
|
|
|
9
7
|
## 普通节点的用途
|
|
10
8
|
|
|
@@ -25,21 +23,21 @@
|
|
|
25
23
|
|
|
26
24
|
| 功能 | 网页用途与操作 | 结果与原图关系 | 当前 CLI |
|
|
27
25
|
|---|---|---|---|
|
|
28
|
-
| 裁剪 |
|
|
29
|
-
| 标注 |
|
|
30
|
-
| 抠图 | 固定general
|
|
31
|
-
| Seedance 审核 |
|
|
26
|
+
| 裁剪 | 按原图像素选区 | 新素材及来源线 | 已接矩形或最大居中比例,需 FFmpeg/FFprobe,限静态 PNG/JPEG |
|
|
27
|
+
| 标注 | 绘制形状或文字 | 新图片或素材节点及来源线 | 已接像素坐标指令,需 FFmpeg 的相应渲染能力 |
|
|
28
|
+
| 抠图 | 固定 general 去背景 | 透明 PNG 素材及来源线 | 支持同步、本地后台与服务端异步,按原 operation 查询与恢复 |
|
|
29
|
+
| Seedance 审核 | 审核图片或下游引用 | 保存审核状态和关联 | 支持显式当前/上游审核、查询和恢复 |
|
|
32
30
|
|
|
33
31
|
## 视频有素材后的工具
|
|
34
32
|
|
|
35
33
|
| 功能 | 网页用途与操作 | 产出 | 当前 CLI |
|
|
36
34
|
|---|---|---|---|
|
|
37
|
-
| 剪辑 |
|
|
38
|
-
| 截帧 |
|
|
39
|
-
| 片段重拍 |
|
|
40
|
-
| 转绘 |
|
|
41
|
-
| Seedance 审核 |
|
|
42
|
-
| 去字幕 |
|
|
35
|
+
| 剪辑 | 按起止时间截取 | 新视频素材及来源线 | 限同画布已完成任务 |
|
|
36
|
+
| 截帧 | 按时间取帧 | 每帧生成素材及来源线 | 需 FFmpeg/FFprobe,一次 1–3 帧 |
|
|
37
|
+
| 片段重拍 | 选片段、模型及提示词 | 独立视频结果及任务关联 | 支持单源视频,不支持附加参考或批量重拍 |
|
|
38
|
+
| 转绘 | 原分段及派生节点 | 原任务结果 | 暂停;仅按授权[查询或下载原结果](repaint-workflow.md) |
|
|
39
|
+
| Seedance 审核 | 审核当前视频或下游参考 | 保存审核关联 | 支持显式审核;任意子集、跨画布及完整自动审核编排未接入 |
|
|
40
|
+
| 去字幕 | 框选字幕区域处理 | 新视频素材 | CLI 未接入 |
|
|
43
41
|
|
|
44
42
|
转绘已接入步骤、命令及待完善路线以 [视频分段流程](repaint-workflow.md) 为准。派生节点由处理流程创建,不等于必须执行前端代码;CLI 自行编排时也要保存等效节点、连线、任务与结果,不能只调用单个接口就宣称完成流程。
|
|
45
43
|
|
|
@@ -51,45 +49,16 @@
|
|
|
51
49
|
|
|
52
50
|
- 用户已明确产品规则:用于 Seedance 视频生成的含人脸素材,真人与动漫都需要审核;不能以动漫形象为由跳过。不据此声称前端具备自动识别人脸的逻辑;源码中的审核流程收集图片/视频引用并提交审核。
|
|
53
51
|
- 用户签署《统一协议》与素材通过 Seedance 审核是两件事。协议命令只解决账号/版本签署,不代表任何素材已审核。
|
|
54
|
-
-
|
|
52
|
+
- review start/get/wait/recover 支持同画布普通节点的当前及上游图片/视频审核。需要真实完成任务,且素材引用匹配;只复用真实 Active 任务关联。
|
|
55
53
|
- enable_asset_review 传输字段对应后端生成内审核,与独立 review 操作不同;前端自动审核交互尚未全部等效。签协议、节点创建、传输字段、出现审核标记均不代表真实审核通过,不能手写 active/assetUri 或伪造任务。
|
|
56
54
|
|
|
57
55
|
## 其他前端流程差异
|
|
58
56
|
|
|
59
57
|
| 网页功能 | CLI 当前边界 |
|
|
60
58
|
|---|---|
|
|
61
|
-
|
|
|
62
|
-
| Seedance 样片转正片 |
|
|
63
|
-
|
|
|
64
|
-
|
|
|
65
|
-
| 下载和预览 |
|
|
66
|
-
| 分组与画布编辑 |
|
|
67
|
-
|
|
68
|
-
前端功能说明不能直接充当安装用户可执行的 CLI 指南。能执行的步骤链接到真实命令参考;未接入项仅说明用途、缺口与所需产出,后续按用户选择的实际路线补全与验收。CLI 已通过部分前端协议检查,不代表所有前端参数默认值、素材处理和流程都已等效。
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
以下多段记录已冻结,不作为当前验收队列:多段逐项调度已接`repaint sequence/sequence-get/sequence-next/sequence-recover`,复用既有单段反推、最终提示词和视频,逐项预估确认,未知不重发。本地两段与三类子步骤验证通过;真实多段仍待验。当前画布没有核对到产品批量/整片拼接入口,不使用独立页批量接口,额外参考继续未接入。均匀间隔不保证段数:每段至少4秒,6.385秒素材实际只生成一段。
|
|
72
|
-
|
|
73
|
-
## 2026-11-03能力状态补充(历史记录)
|
|
74
|
-
|
|
75
|
-
媒体复制为普通文本、图片/视频生成和三类素材的同画布单个/1–100批量;复制结果和来源历史不认领原生成任务。分组移动、组框调整、组内三种排列已接;缩放只改变组框,不缩放媒体。普通复杂媒体断线会把保留的持久参考纳入模式计算。此前各节“仅文本”“媒体未接”“改名/删除网页待验”为历史阶段,当前范围见[node流程](node-workflow.md#当前普通节点复制2026-11-03)和[组编辑](material-graph-workflow.md#普通分组移动组框调整与组内重排)。
|
|
76
|
-
|
|
77
|
-
图片多张、音频生成、CLI跨会话撤销重做、额外重拍模式、ZIP/预览/断点下载不因候选名单接入。图片无已核数量入口;音频无有效可选生成模型/完整提交协议;网页撤销是内存历史,未提供可与CLI共享的历史事务;当前素材批量下载为逐文件,不是ZIP。新增能力需要实际入口、完整费用/保存/恢复契约。抠图有真实入口,但用户已确认免费,正式站CLI授权当前关闭;原结果查询和未知提交恢复未接,继续仅预检,不以POST探测可用性。
|
|
78
|
-
|
|
79
|
-
## 2026-11-03补充条件(历史记录)
|
|
80
|
-
|
|
81
|
-
普通图片数量以实际节点控件为准,当前单张;同节点多任务历史已真实切换及恢复,网页仍待验。抠图用户确认为免费,但开发部署无服务,正式部署可用性/结果查询与未知恢复待核;不POST探测或切换服务。当前无格式转换能力,下载读取实际响应文件名,每次从原业务接口取新链接。
|
|
82
|
-
|
|
83
|
-
## 2026-11-03 当前补验
|
|
84
|
-
|
|
85
|
-
普通图片/视频已接入history-add(输出为独立普通节点、来源历史与自有任务分离),模拟/前端codec/真实服务及网页重开通过;原图片两历史采用/恢复/重开通过,2073正片网页完整播放通过。抠图免费;此前正式站CLI授权关闭已解除,2026-11-04单次执行、透明PNG、已知结果恢复和用户确认网页重开真实通过;无引用的未知提交仍无法查回。详见[历史添加流程](generation-workflow.md#将普通历史结果添加为新节点)。
|
|
86
|
-
|
|
87
|
-
## 2026-11-04 正式站接入更新
|
|
88
|
-
|
|
89
|
-
当前用户指定实际服务为https://uzooai.com,使用独立uzooai-online profile。用户启用授权后本人正常登录/授权及账号读回成功,历史2110/cli_auth_disabled阻塞已解除。正式站实际账号/团队与开发站不同,操作前重新查询并绑定实际对象,不迁移旧operation的服务地址。抠图已接入单次免费执行及已知原结果/缓存恢复,正式站真实处理和用户确认网页重开通过;未知响应无结果引用时仍无法服务端查回,不重发。免费处理不以余额0判不可用。
|
|
90
|
-
|
|
91
|
-
## 2026-11-05 收尾范围
|
|
92
|
-
|
|
93
|
-
图片历史网页切换/恢复、历史新增图片/视频、样片2072转正片2073、协议v3前检阻断→本人签署→原operation任务2078、异步抠图和用户网页重开均有真实证据,不再当作缺失主线。2078交付大小元数据最后记录仍不一致,需服务端与原服务原任务复核,不能跨服务按数字ID查询。素材107非成员拒绝已通过;更多私有/下架/自然过期下载、三类媒体实际收费生成、来源历史元数据修正后的新副本、更多审核/抠图失败组合仍属具体覆盖边界。格式转换/多图/音频生成/共享undo等缺契约的能力不自动扩入范围。
|
|
94
|
-
|
|
95
|
-
2026-11-05用户随后明确:正式站为已验开发版直接部署,本次收尾不要求同版全量重测;真实边界专项先不处理,保留限制即可。2078仅是旧任务大小元数据交接,不是本轮发现下载又失败;后续不因清单自行补生成/边界测试。npm发布仍需独立发布身份、scope权限和当次明确授权。
|
|
59
|
+
| 持久参考、断线与 @ 标记 | prepare 合并有效引用、分离文本上下文,复用实际审核关联 |
|
|
60
|
+
| Seedance 样片转正片 | 支持独立报价、继承父样片、结果节点和原任务恢复 |
|
|
61
|
+
| 结果入库 | 支持同空间普通图片/视频及有任务关联的素材;不自动入库 |
|
|
62
|
+
| 历史 | 支持普通图片/视频选用历史或添加为独立节点;来源历史不成为副本自己的任务 |
|
|
63
|
+
| 下载和预览 | 支持原生成结果及素材空间原文件下载;不支持请求改名、格式转换或通用媒体预览 |
|
|
64
|
+
| 分组与画布编辑 | 支持普通节点复制、删除、断线及分组;缩放只改组框,不缩放组内媒体 |
|
|
@@ -31,7 +31,7 @@ CLI 业务命令直接通过 HTTP 调用后端,不加载网页或执行前端
|
|
|
31
31
|
|
|
32
32
|
当前视频转绘由网页负责流程编排:先在本地画布创建带源节点/连线的分段详情并安排保存,再调用分析 API 取得任务 ID;轮询任务更新详情;确认方案并等待切片完成后,再根据后端任务/片段数据创建分段、提示词、结果节点及分组/连线并保存。后端返回任务与业务结果,不会仅因传了画布绑定 ID 就自动创建整条派生节点链。
|
|
33
33
|
|
|
34
|
-
|
|
34
|
+
转绘暂停。仅按[原任务查询与下载](repaint-workflow.md)处理明确授权的原结果;通用 node add/update 不能创建派生节点。
|
|
35
35
|
|
|
36
36
|
## 执行顺序
|
|
37
37
|
|
|
@@ -67,8 +67,6 @@ node copy --input copy.json 默认只读预览;输入doc_id、space、团队te
|
|
|
67
67
|
|
|
68
68
|
仅普通文本节点,保留文本/配置;原上游与持久参考合并为新节点持久引用,外部节点ID保持,不复制连线/分组、不触发生成。进行中任务、派生和媒体节点拒绝;非完成状态清理运行任务绑定。前端媒体复制还有来源历史协议,不能把本命令称为全节点复制。版本冲突或读回失败停止,先查固定新ID,不自动重放。
|
|
69
69
|
|
|
70
|
-
真实新代理验收:原独立测试画布36→37版,复制CLI断线验收到cli-text-copy-20261102,9节点,其他节点/边/meta保持;网页重开待验。
|
|
71
|
-
|
|
72
70
|
## 普通节点删除
|
|
73
71
|
|
|
74
72
|
node delete --input delete.json 默认只读预览;输入doc_id、space、团队team_uid、node_ids,实际执行增加预览expected_version并传--yes。展示节点列表、removed_edge_ids、group_changes、retained_references及mode_changes,用户明确授权具体删除范围后执行。不能把笼统开发请求当作删除业务节点的授权。
|
|
@@ -83,12 +81,10 @@ node copy-batch --input copies.json 默认只读预览,输入doc_id、space、
|
|
|
83
81
|
|
|
84
82
|
限普通文本,继承上游/持久引用,不复制边或组。批内引用ID与稳定提示词标记同时映射到新ID,保留手动@@标记;外部引用不变。相较当前本地前端仅映射references的实现,CLI额外同步prompt中的稳定标记,避免副本中引用对象与提示词不一致;预览显示prompt前后。原节点保持;媒体来源历史和跨画布复制未接入。
|
|
85
83
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
## 当前普通节点复制(2026-11-03)
|
|
84
|
+
## 当前普通节点复制
|
|
89
85
|
|
|
90
86
|
以下范围更新此前“仅文本/媒体待接”的历史记录。`node copy`支持普通文本、图片/视频生成节点及图片/视频/音频素材;`node copy-batch`支持同画布1–100项混合批次。保持现有输入字段:doc_id、space、团队team_uid、node_id/new_node_id/position;批量使用copies数组。默认预览;执行须将本次预览expected_version写回输入并加--yes。一个批次仅一次CAS保存及完整读回,任一成员不支持则整批停止;不复制边和组。
|
|
91
87
|
|
|
92
88
|
生成结果副本保留成品、真实文件引用、审核和持久参考,将当前结果加入extra.copied_generation_history;extra.source_task_id只标来源。清除副本自身last_task_id、结果内task_id与轮询/提交状态,不能把原任务认领为副本的生成任务。素材副本保留原上传任务关联。进行中节点及转绘/重拍/正片等派生节点不能复制;不同配置协议未核对时停止。批内持久引用、审核映射键及稳定@{ref:ID}/@@{ref:ID}一起映射,外部引用保持。预览报告来源任务和复制历史数;保存未知不重放,先按固定副本ID读取。
|
|
93
89
|
|
|
94
|
-
|
|
90
|
+
复制使用同画布来源任务并验证文件。来源历史与副本自身任务分开;入库是独立的 material save 操作。
|