@kevlns/art-workshop 0.5.2 → 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.
Files changed (53) hide show
  1. package/README.md +13 -11
  2. package/art-workshop.mjs +50 -10
  3. package/docs/channels.md +49 -0
  4. package/docs/commands.md +2158 -91
  5. package/docs/configuration.md +8 -0
  6. package/docs/core-guidance.md +12 -4
  7. package/docs/data-formats.md +10 -6
  8. package/docs/local-models/qwen-image-2.1.json +1 -1
  9. package/docs/modes.md +12 -6
  10. package/docs/release-0.6.0.md +9 -0
  11. package/lib/analysis-worker.mjs +9 -5
  12. package/lib/backends.mjs +2 -0
  13. package/lib/candidates.mjs +2 -1
  14. package/lib/channel-operation.mjs +84 -0
  15. package/lib/core.mjs +33 -2
  16. package/lib/edit.mjs +5 -3
  17. package/lib/generate.mjs +5 -3
  18. package/lib/generation-policy.mjs +1 -1
  19. package/lib/object-format.mjs +2 -2
  20. package/lib/prompt-structure.mjs +3 -3
  21. package/lib/service.mjs +21 -0
  22. package/lib/style-bundle.mjs +19 -6
  23. package/lib/style-contract.mjs +3 -3
  24. package/lib/style-lifecycle.mjs +7 -73
  25. package/lib/style-report.mjs +1 -1
  26. package/lib/style-samples.mjs +94 -0
  27. package/lib/task-contract.mjs +2 -1
  28. package/lib/templates.mjs +1 -1
  29. package/lib/video/PROVENANCE.json +63 -0
  30. package/lib/video/atomic.mjs +32 -0
  31. package/lib/video/channel.mjs +70 -0
  32. package/lib/video/contract-local-media.mjs +42 -0
  33. package/lib/video/contract-story.mjs +213 -0
  34. package/lib/video/contract-video.mjs +117 -0
  35. package/lib/video/contracts.mjs +3 -0
  36. package/lib/video/h3.mjs +232 -0
  37. package/lib/video/local-runtime.mjs +20 -0
  38. package/lib/video/media.mjs +223 -0
  39. package/lib/video/models.mjs +336 -0
  40. package/lib/video/path.mjs +18 -0
  41. package/lib/video/process.mjs +15 -0
  42. package/lib/video/resource.mjs +15 -0
  43. package/lib/video/service.mjs +731 -0
  44. package/lib/video/workflow.mjs +571 -0
  45. package/lib/video.mjs +12 -0
  46. package/lib/workspace.mjs +35 -21
  47. package/package.json +8 -3
  48. package/rules/core-guidance.json +1 -1
  49. package/skills/art-workshop/SKILL.md +4 -2
  50. package/skills/art-workshop/references/project.md +18 -9
  51. package/skills/art-workshop/references/style-discussion.md +8 -6
  52. package/skills/art-workshop/references/video.md +13 -0
  53. package/v-cli.plugin.json +4380 -276
package/docs/commands.md CHANGED
@@ -22,11 +22,17 @@
22
22
 
23
23
  ## 执行约束
24
24
 
25
- 相对计划、输入和报告路径以 workspace 为基准;运行批次以 output 为基准。参考导入的源文件建议使用绝对路径。查询与预演不初始化参考目录。
25
+ `image` 与 `video` 是独立二级通道。图片可使用 `v-cli art image ...`,旧图片根命令与原 `art.*` 能力身份保留。新 SDK 暴露 `art.image-*` 和 `art.video-*`;已安装旧版 v-cli 不会自动获得新能力。
26
26
 
27
- 冻结计划不能覆盖 project/job/core/backend/explore。`--all-variants` 与 `--variant` 互斥。`--retry-run` 只用于原计划的明确失败项,不能混用 dry/item/variant/offset/limit。远程恢复只用 `task resume`,不会补发未提交项。
27
+ 图片的相对计划、输入和报告路径以 workspace 为基准;运行批次以 output 为基准。参考导入的源文件建议使用绝对路径。查询与预演不初始化参考目录。
28
28
 
29
- 前台运行也登记 taskId;后台启动成功仅表示收到执行身份。状态、停止确认和实际产物分别核对。详见 [任务控制](troubleshooting.md)、[模型架构](model-architecture.md) 和 [部署](deployment.md)。
29
+ 视频的 `--workspace` 必须指向工程根目录,数据在 `.vant/video`、设置在 `.vant/config/video.json`;不能传图片工坊存储子目录。`--input` 只能读取该工程内的 JSON 对象文件。先读取 `video describe` 中的业务 schema,保留真实 revision/expectedRevision 与稳定 requestId。
30
+
31
+ 所有视频写命令必须传 `--operation`。非 video-UUID 的上层身份会稳定映射成 video-UUID,并在回执保留 originOperationId。同身份同请求只重读回执;未知结果与未决指纹使用 DSH/CLI 共享目录阻止换入口重投。`video execution status --operation <id>` 只读核对原回执;`submitted` 只证明提交身份,不证明视频已完成。
32
+
33
+ 冻结图片计划不能覆盖 project/job/core/backend/explore。`--all-variants` 与 `--variant` 互斥。`--retry-run` 只用于原计划的明确失败项,不能混用 dry/item/variant/offset/limit。图片远程恢复只用 `task resume`,不会补发未提交项。
34
+
35
+ 前台图片运行也登记 taskId;后台启动成功仅表示收到执行身份。状态、停止确认和实际产物分别核对。详见 [任务控制](troubleshooting.md)、[模型架构](model-architecture.md) 和 [部署](deployment.md)。
30
36
 
31
37
  ## 参数与输出
32
38
 
@@ -38,6 +44,8 @@
38
44
  v-cli art help
39
45
  ```
40
46
 
47
+ 结构化能力:`art.help`。
48
+
41
49
 
42
50
  - 无配置读取、目录初始化、网络或模型调用
43
51
 
@@ -49,6 +57,8 @@ v-cli art help
49
57
  v-cli art config path
50
58
  ```
51
59
 
60
+ 结构化能力:`art.config-path`。
61
+
52
62
 
53
63
  - 查询与预演不创建参考目录
54
64
  - 无网络调用
@@ -61,6 +71,8 @@ v-cli art config path
61
71
  v-cli art config show
62
72
  ```
63
73
 
74
+ 结构化能力:`art.config-show`。
75
+
64
76
 
65
77
  - 查询与预演不创建参考目录
66
78
  - 无网络调用
@@ -73,6 +85,8 @@ v-cli art config show
73
85
  v-cli art config init
74
86
  ```
75
87
 
88
+ 结构化能力:`art.config-init`。
89
+
76
90
 
77
91
  - 查询与预演不创建参考目录
78
92
  - 无网络调用
@@ -86,6 +100,8 @@ v-cli art config init
86
100
  v-cli art refs guide [--project <id>]
87
101
  ```
88
102
 
103
+ 结构化能力:`art.refs-guide`。
104
+
89
105
  - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
90
106
 
91
107
  - 查询与预演不创建参考目录
@@ -99,6 +115,8 @@ v-cli art refs guide [--project <id>]
99
115
  v-cli art agent index
100
116
  ```
101
117
 
118
+ 结构化能力:`art.agent-index`。
119
+
102
120
 
103
121
  - 查询与预演不创建参考目录
104
122
  - 无网络调用
@@ -111,6 +129,8 @@ v-cli art agent index
111
129
  v-cli art agent docs
112
130
  ```
113
131
 
132
+ 结构化能力:`art.agent-docs`。
133
+
114
134
 
115
135
  - 查询与预演不创建参考目录
116
136
  - 无网络调用
@@ -123,6 +143,8 @@ v-cli art agent docs
123
143
  v-cli art agent export --host codex --directory <DIR> [--dry]
124
144
  ```
125
145
 
146
+ 结构化能力:`art.agent-export`。
147
+
126
148
  - `--host <HOST>`:目标宿主 codex 或 claude
127
149
  - `--directory <DIR>`:明确指定导出目录
128
150
  - `--dry`:仅预演
@@ -137,36 +159,8 @@ v-cli art agent export --host codex --directory <DIR> [--dry]
137
159
  v-cli art list
138
160
  ```
139
161
 
162
+ 结构化能力:`art.list`。
140
163
 
141
- - 查询与预演不创建参考目录
142
- - 无网络调用
143
-
144
- ### style analyze
145
-
146
- 草稿风格后台分析
147
-
148
- ```sh
149
- v-cli art style analyze
150
- ```
151
-
152
- - `--project <id>`:工程身份
153
- - `--id <id>`:对象身份
154
- - `--revision <number>`:预期对象版本
155
- - `--dry`:只读编译预演
156
- - `--operation <id>`:分析启动前登记的稳定操作身份
157
-
158
- - dry 不联网、不写参考目录;执行创建运行身份和不可变参考证据;远程停止不确定时保留资源
159
-
160
- ### style validate
161
-
162
- 校验报告及核心规则的一致性
163
-
164
- ```sh
165
- v-cli art style validate [--project <id>] [--report <file>]
166
- ```
167
-
168
- - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
169
- - `--report <file>`:风格报告 JSON,相对路径基于 workspace
170
164
 
171
165
  - 查询与预演不创建参考目录
172
166
  - 无网络调用
@@ -179,6 +173,8 @@ v-cli art style validate [--project <id>] [--report <file>]
179
173
  v-cli art style show [--project <id>] [--core <id>]
180
174
  ```
181
175
 
176
+ 结构化能力:`art.style-show`。
177
+
182
178
  - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
183
179
  - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
184
180
 
@@ -193,6 +189,8 @@ v-cli art style show [--project <id>] [--core <id>]
193
189
  v-cli art generate show [--project <id>] [--job <id>]
194
190
  ```
195
191
 
192
+ 结构化能力:`art.generate-show`。
193
+
196
194
  - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
197
195
  - `--job <id>`:工程内任务 ID
198
196
 
@@ -207,6 +205,8 @@ v-cli art generate show [--project <id>] [--job <id>]
207
205
  v-cli art generate plan [--project <id>] [--job <id>] [--core <id>] [--out <file>]
208
206
  ```
209
207
 
208
+ 结构化能力:`art.generate-plan`。
209
+
210
210
  - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
211
211
  - `--job <id>`:工程内任务 ID
212
212
  - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
@@ -225,6 +225,8 @@ v-cli art generate plan [--project <id>] [--job <id>] [--core <id>] [--out <file
225
225
  v-cli art generate run [--plan <file>] [--project <id>] [--job <id>] [--core <id>] [--item <id>] [--variant <id>] [--explore] [--offset <n>] [--limit <n>] [--dry]
226
226
  ```
227
227
 
228
+ 结构化能力:`art.generate-start`。
229
+
228
230
  - `--plan <file>`:冻结计划文件;不能同时指定 project/job/core/explore
229
231
  - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
230
232
  - `--job <id>`:工程内任务 ID
@@ -255,6 +257,8 @@ v-cli art generate run [--plan <file>] [--project <id>] [--job <id>] [--core <id
255
257
  v-cli art edit show [--project <id>] [--job <id>]
256
258
  ```
257
259
 
260
+ 结构化能力:`art.edit-show`。
261
+
258
262
  - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
259
263
  - `--job <id>`:工程内任务 ID
260
264
 
@@ -269,6 +273,8 @@ v-cli art edit show [--project <id>] [--job <id>]
269
273
  v-cli art edit plan [--project <id>] [--job <id>] [--core <id>] [--out <file>]
270
274
  ```
271
275
 
276
+ 结构化能力:`art.edit-plan`。
277
+
272
278
  - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
273
279
  - `--job <id>`:工程内任务 ID
274
280
  - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
@@ -287,6 +293,8 @@ v-cli art edit plan [--project <id>] [--job <id>] [--core <id>] [--out <file>]
287
293
  v-cli art edit run [--plan <file>] [--project <id>] [--job <id>] [--core <id>] [--item <id>] [--variant <id>] [--explore] [--offset <n>] [--limit <n>] [--dry]
288
294
  ```
289
295
 
296
+ 结构化能力:`art.edit-start`。
297
+
290
298
  - `--plan <file>`:冻结计划文件;不能同时指定 project/job/core/explore
291
299
  - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
292
300
  - `--job <id>`:工程内任务 ID
@@ -317,6 +325,8 @@ v-cli art edit run [--plan <file>] [--project <id>] [--job <id>] [--core <id>] [
317
325
  v-cli art check RUN
318
326
  ```
319
327
 
328
+ 结构化能力:`art.check`。
329
+
320
330
  - 位置参数 `RUN`:运行目录或 manifest 路径,按 output 解析(必填)
321
331
 
322
332
  - 只读;不调用模型、不写入评分或定版记录
@@ -329,6 +339,8 @@ v-cli art check RUN
329
339
  v-cli art compare BEFORE AFTER
330
340
  ```
331
341
 
342
+ 结构化能力:`art.compare`。
343
+
332
344
  - 位置参数 `BEFORE`:前一份计划/执行记录 JSON,按 workspace 解析(必填)
333
345
  - 位置参数 `AFTER`:后一份计划/执行记录 JSON,按 workspace 解析(必填)
334
346
 
@@ -343,6 +355,8 @@ v-cli art compare BEFORE AFTER
343
355
  v-cli art task list
344
356
  ```
345
357
 
358
+ 结构化能力:`art.run-list`。
359
+
346
360
  - `--project <id>`:仅列出指定工程运行
347
361
 
348
362
  - 读取外部运行状态
@@ -355,6 +369,8 @@ v-cli art task list
355
369
  v-cli art task status TASK
356
370
  ```
357
371
 
372
+ 结构化能力:`art.run-status`。
373
+
358
374
  - 位置参数 `TASK`:art 任务 ID(必填)
359
375
 
360
376
  - 读取外部运行状态
@@ -367,6 +383,8 @@ v-cli art task status TASK
367
383
  v-cli art task wait TASK
368
384
  ```
369
385
 
386
+ 结构化能力:`art.run-wait`。
387
+
370
388
  - 位置参数 `TASK`:art 任务 ID(必填)
371
389
  - `--timeout <seconds>`:等待秒数,默认 3600
372
390
 
@@ -380,6 +398,8 @@ v-cli art task wait TASK
380
398
  v-cli art task cancel TASK
381
399
  ```
382
400
 
401
+ 结构化能力:`art.run-cancel`。
402
+
383
403
  - 位置参数 `TASK`:art 任务 ID(必填)
384
404
 
385
405
  - 取消单个任务
@@ -394,6 +414,8 @@ v-cli art task cancel TASK
394
414
  v-cli art shutdown
395
415
  ```
396
416
 
417
+ 结构化能力:`art.shutdown`。
418
+
397
419
 
398
420
  - 停止配置范围内所有任务
399
421
  - 只取消关联任务;共享队列仍有其他任务时保留服务
@@ -408,6 +430,8 @@ v-cli art shutdown
408
430
  v-cli art config validate
409
431
  ```
410
432
 
433
+ 结构化能力:`art.config-validate`。
434
+
411
435
  - `--backend <id>`:仅检查指定后端
412
436
 
413
437
  - 只读校验,不启动服务、不调用模型
@@ -420,6 +444,8 @@ v-cli art config validate
420
444
  v-cli art doctor
421
445
  ```
422
446
 
447
+ 结构化能力:`art.doctor`。
448
+
423
449
  - `--backend <id>`:仅检查指定后端
424
450
  - `--start`:无可用服务时按配置启动;不采样,检查后服务保留
425
451
 
@@ -435,6 +461,8 @@ v-cli art doctor
435
461
  v-cli art workflow list
436
462
  ```
437
463
 
464
+ 结构化能力:`art.workflow-list`。
465
+
438
466
 
439
467
  - 读取随包工作流清单,不依赖合法用户配置、不补 refs、不调用模型
440
468
 
@@ -446,10 +474,12 @@ v-cli art workflow list
446
474
  v-cli art style create
447
475
  ```
448
476
 
477
+ 结构化能力:`art.style-create`。
478
+
449
479
  - `--project <id>`:工程身份
450
480
  - `--input <file>`:结构化配置文件
451
481
 
452
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
482
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
453
483
 
454
484
  ### style list
455
485
 
@@ -459,9 +489,11 @@ v-cli art style create
459
489
  v-cli art style list
460
490
  ```
461
491
 
492
+ 结构化能力:`art.style-list`。
493
+
462
494
  - `--project <id>`:工程身份
463
495
 
464
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
496
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
465
497
 
466
498
  ### style read
467
499
 
@@ -471,55 +503,29 @@ v-cli art style list
471
503
  v-cli art style read
472
504
  ```
473
505
 
506
+ 结构化能力:`art.style-read`。
507
+
474
508
  - `--project <id>`:工程身份
475
509
  - `--id <id>`:对象身份
476
510
 
477
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
511
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
478
512
 
479
513
  ### style update
480
514
 
481
- 校验预期版本及空闲状态后更新对象
515
+ 保存风格名称、规则与配置;已保存风格可随时修改,更新当前执行版本并保留历史快照
482
516
 
483
517
  ```sh
484
518
  v-cli art style update
485
519
  ```
486
520
 
487
- - `--project <id>`:工程身份
488
- - `--id <id>`:对象身份
489
- - `--revision <number>`:预期对象版本
490
- - `--input <file>`:结构化配置文件
491
-
492
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
493
-
494
- ### style resolve
495
-
496
- 记录用户选择并修订风格方案;input 为 {issueId,optionId,note},不重新分析、不自动采用
497
-
498
- ```sh
499
- v-cli art style resolve
500
- ```
521
+ 结构化能力:`art.style-update`。
501
522
 
502
523
  - `--project <id>`:工程身份
503
524
  - `--id <id>`:对象身份
504
525
  - `--revision <number>`:预期对象版本
505
526
  - `--input <file>`:结构化配置文件
506
527
 
507
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
508
-
509
- ### style revise
510
-
511
- 按用户要求修订完整规则方案;input 为 {rules,summary,note},沿用未变化的参考证据,不调用模型或自动冻结
512
-
513
- ```sh
514
- v-cli art style revise
515
- ```
516
-
517
- - `--project <id>`:工程身份
518
- - `--id <id>`:对象身份
519
- - `--revision <number>`:预期对象版本
520
- - `--input <file>`:JSON {rules,summary,note};rules 为完整规则数组,每条 id/scope/strength/instruction/when,avoid 可含 negative 抽象排除表达数组
521
-
522
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
528
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
523
529
 
524
530
  ### style derive
525
531
 
@@ -529,11 +535,13 @@ v-cli art style revise
529
535
  v-cli art style derive
530
536
  ```
531
537
 
538
+ 结构化能力:`art.style-derive`。
539
+
532
540
  - `--project <id>`:工程身份
533
541
  - `--id <id>`:对象身份
534
542
  - `--revision <number>`:预期对象版本
535
543
 
536
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
544
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
537
545
 
538
546
  ### style discard
539
547
 
@@ -543,11 +551,13 @@ v-cli art style derive
543
551
  v-cli art style discard
544
552
  ```
545
553
 
554
+ 结构化能力:`art.style-discard`。
555
+
546
556
  - `--project <id>`:工程身份
547
557
  - `--id <id>`:对象身份
548
558
  - `--revision <number>`:预期对象版本
549
559
 
550
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
560
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
551
561
 
552
562
  ### job create
553
563
 
@@ -557,10 +567,12 @@ v-cli art style discard
557
567
  v-cli art job create
558
568
  ```
559
569
 
570
+ 结构化能力:`art.job-create`。
571
+
560
572
  - `--project <id>`:工程身份
561
573
  - `--input <file>`:结构化配置文件
562
574
 
563
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
575
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
564
576
 
565
577
  ### job list
566
578
 
@@ -570,9 +582,11 @@ v-cli art job create
570
582
  v-cli art job list
571
583
  ```
572
584
 
585
+ 结构化能力:`art.job-list`。
586
+
573
587
  - `--project <id>`:工程身份
574
588
 
575
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
589
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
576
590
 
577
591
  ### job read
578
592
 
@@ -582,10 +596,12 @@ v-cli art job list
582
596
  v-cli art job read
583
597
  ```
584
598
 
599
+ 结构化能力:`art.job-read`。
600
+
585
601
  - `--project <id>`:工程身份
586
602
  - `--id <id>`:对象身份
587
603
 
588
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
604
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
589
605
 
590
606
  ### job update
591
607
 
@@ -595,12 +611,14 @@ v-cli art job read
595
611
  v-cli art job update
596
612
  ```
597
613
 
614
+ 结构化能力:`art.job-update`。
615
+
598
616
  - `--project <id>`:工程身份
599
617
  - `--id <id>`:对象身份
600
618
  - `--revision <number>`:预期对象版本
601
619
  - `--input <file>`:结构化配置文件
602
620
 
603
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
621
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
604
622
 
605
623
  ### job derive
606
624
 
@@ -610,11 +628,13 @@ v-cli art job update
610
628
  v-cli art job derive
611
629
  ```
612
630
 
631
+ 结构化能力:`art.job-derive`。
632
+
613
633
  - `--project <id>`:工程身份
614
634
  - `--id <id>`:对象身份
615
635
  - `--revision <number>`:预期对象版本
616
636
 
617
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
637
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
618
638
 
619
639
  ### job discard
620
640
 
@@ -624,6 +644,8 @@ v-cli art job derive
624
644
  v-cli art job discard
625
645
  ```
626
646
 
647
+ 结构化能力:`art.job-discard`。
648
+
627
649
  - `--project <id>`:工程身份
628
650
  - `--id <id>`:对象身份
629
651
  - `--revision <number>`:预期对象版本
@@ -638,26 +660,13 @@ v-cli art job discard
638
660
  v-cli art job restore
639
661
  ```
640
662
 
641
- - `--project <id>`:工程身份
642
- - `--id <id>`:对象身份
643
- - `--revision <number>`:预期对象版本
644
-
645
- - 验证 revision、任务归属和停止确认;归档和恢复均保留原配置、收藏与所有历史文件,不自动执行
646
-
647
- ### style adopt
648
-
649
- 采用当前有效报告并冻结
650
-
651
- ```sh
652
- v-cli art style adopt
653
- ```
663
+ 结构化能力:`art.job-restore`。
654
664
 
655
665
  - `--project <id>`:工程身份
656
666
  - `--id <id>`:对象身份
657
667
  - `--revision <number>`:预期对象版本
658
- - `--note <text>`:采用说明
659
668
 
660
- - 来源匹配且冲突已解决;采用事务可恢复,核心只写一次
669
+ - 验证 revision、任务归属和停止确认;归档和恢复均保留原配置、收藏与所有历史文件,不自动执行
661
670
 
662
671
  ### style recover
663
672
 
@@ -667,6 +676,8 @@ v-cli art style adopt
667
676
  v-cli art style recover
668
677
  ```
669
678
 
679
+ 结构化能力:`art.style-recover`。
680
+
670
681
  - `--project <id>`:工程身份
671
682
  - `--id <id>`:对象身份
672
683
 
@@ -680,6 +691,8 @@ v-cli art style recover
680
691
  v-cli art project init
681
692
  ```
682
693
 
694
+ 结构化能力:`art.project-init`。
695
+
683
696
  - `--project <id>`:工程身份
684
697
  - `--input <file>`:结构化配置文件
685
698
 
@@ -693,6 +706,8 @@ v-cli art project init
693
706
  v-cli art project upgrade
694
707
  ```
695
708
 
709
+ 结构化能力:`art.project-upgrade`。
710
+
696
711
  - `--project <id>`:工程身份
697
712
  - `--dry`:预检
698
713
  - `--mapping <file>`:旧共享参考的明确归属映射
@@ -707,6 +722,8 @@ v-cli art project upgrade
707
722
  v-cli art reference list
708
723
  ```
709
724
 
725
+ 结构化能力:`art.reference-list`。
726
+
710
727
  - `--project <id>`:工程身份
711
728
  - `--kind <style|task>`:对象粒度
712
729
  - `--id <id>`:对象身份
@@ -721,6 +738,8 @@ v-cli art reference list
721
738
  v-cli art reference import
722
739
  ```
723
740
 
741
+ 结构化能力:`art.reference-import`。
742
+
724
743
  - `--project <id>`:工程身份
725
744
  - `--kind <style|task>`:对象粒度
726
745
  - `--id <id>`:对象身份
@@ -741,6 +760,8 @@ v-cli art reference import
741
760
  v-cli art reference remove
742
761
  ```
743
762
 
763
+ 结构化能力:`art.reference-remove`。
764
+
744
765
  - `--project <id>`:工程身份
745
766
  - `--kind <style|task>`:对象粒度
746
767
  - `--id <id>`:对象身份
@@ -757,6 +778,8 @@ v-cli art reference remove
757
778
  v-cli art candidate list
758
779
  ```
759
780
 
781
+ 结构化能力:`art.candidate-list`。
782
+
760
783
  - `--project <id>`:工程身份
761
784
  - `--job <id>`:配置任务身份
762
785
  - `--run <id>`:执行批次身份
@@ -771,6 +794,8 @@ v-cli art candidate list
771
794
  v-cli art candidate favorites --project <id>
772
795
  ```
773
796
 
797
+ 结构化能力:`art.candidate-favorites`。
798
+
774
799
  - `--project <id>`:工程身份
775
800
 
776
801
  - 只读;忽略已删除的图片和已归档的任务
@@ -783,6 +808,8 @@ v-cli art candidate favorites --project <id>
783
808
  v-cli art candidate favorite --project <id> --job <id> --run <id> --candidate <id> --value <true|false>
784
809
  ```
785
810
 
811
+ 结构化能力:`art.candidate-favorite`。
812
+
786
813
  - `--project <id>`:工程身份
787
814
  - `--job <id>`:源任务身份
788
815
  - `--run <id>`:源批次身份
@@ -799,6 +826,8 @@ v-cli art candidate favorite --project <id> --job <id> --run <id> --candidate <i
799
826
  v-cli art candidate finalizations
800
827
  ```
801
828
 
829
+ 结构化能力:`art.candidate-finalizations`。
830
+
802
831
  - `--project <id>`:工程身份
803
832
  - `--job <id>`:配置任务身份
804
833
 
@@ -812,6 +841,8 @@ v-cli art candidate finalizations
812
841
  v-cli art candidate finalize
813
842
  ```
814
843
 
844
+ 结构化能力:`art.candidate-finalize`。
845
+
815
846
  - `--project <id>`:工程身份
816
847
  - `--job <id>`:配置任务身份
817
848
  - `--run <id>`:执行批次身份
@@ -831,6 +862,8 @@ v-cli art candidate finalize
831
862
  v-cli art candidate delete
832
863
  ```
833
864
 
865
+ 结构化能力:`art.candidate-delete`。
866
+
834
867
  - `--project <id>`:工程身份
835
868
  - `--job <id>`:配置任务身份
836
869
  - `--run <id>`:执行批次身份
@@ -849,6 +882,8 @@ v-cli art candidate delete
849
882
  v-cli art job analyze
850
883
  ```
851
884
 
885
+ 结构化能力:`art.job-analyze`。
886
+
852
887
  - `--project <id>`:工程身份
853
888
  - `--id <id>`:对象身份
854
889
  - `--revision <number>`:预期对象版本
@@ -865,6 +900,8 @@ v-cli art job analyze
865
900
  v-cli art task recover --project P --operation OPERATION
866
901
  ```
867
902
 
903
+ 结构化能力:`art.run-recover`。
904
+
868
905
  - `--project <id>`:原工程身份
869
906
  - `--operation <id>`:启动前持久化的原操作身份
870
907
 
@@ -878,6 +915,8 @@ v-cli art task recover --project P --operation OPERATION
878
915
  v-cli art reference update --project P --kind style --id ID --revision N --item REF --input PATCH.json
879
916
  ```
880
917
 
918
+ 结构化能力:`art.reference-update`。
919
+
881
920
  - `--project <id>`:工程身份
882
921
  - `--kind <kind>`:style 或 task
883
922
  - `--id <id>`:对象身份
@@ -885,7 +924,7 @@ v-cli art reference update --project P --kind style --id ID --revision N --item
885
924
  - `--item <id>`:参考身份
886
925
  - `--input <file>`:category/purposes/itemId/note/ignore 的字段补丁;itemId 为 null 时任务共用
887
926
 
888
- - 冻结风格只读;任务不允许静态分类;不修改用户原图;旧证据保留
927
+ - 风格规则可编辑保存;任务不允许静态分类;不修改用户原图;旧证据保留
889
928
 
890
929
  ### job template
891
930
 
@@ -895,6 +934,8 @@ v-cli art reference update --project P --kind style --id ID --revision N --item
895
934
  v-cli art job template --project <id> --kind <generate|edit> [--core <id>]
896
935
  ```
897
936
 
937
+ 结构化能力:`art.job-template`。
938
+
898
939
  - `--project <id>`:工程身份
899
940
  - `--kind <generate|edit>`:任务类型
900
941
  - `--core <id>`:生成任务的冻结核心身份
@@ -909,6 +950,8 @@ v-cli art job template --project <id> --kind <generate|edit> [--core <id>]
909
950
  v-cli art job from-candidate --project <id> --id <task> --run <id> --candidate <id>
910
951
  ```
911
952
 
953
+ 结构化能力:`art.job-from-candidate`。
954
+
912
955
  - `--project <id>`:工程身份
913
956
  - `--id <task>`:源任务身份
914
957
  - `--run <id>`:真实批次
@@ -924,6 +967,8 @@ v-cli art job from-candidate --project <id> --id <task> --run <id> --candidate <
924
967
  v-cli art task resume TASK
925
968
  ```
926
969
 
970
+ 结构化能力:`art.run-resume`。
971
+
927
972
  - 位置参数 `TASK`:art 任务 ID(必填)
928
973
 
929
974
  - 写入原任务状态
@@ -938,6 +983,8 @@ v-cli art task resume TASK
938
983
  v-cli art environment guide
939
984
  ```
940
985
 
986
+ 结构化能力:`art.environment-guide`。
987
+
941
988
  - `--guide <id>`:部署指南标识;省略使用环境登记或推荐方案
942
989
 
943
990
  - 不执行安装、下载或采样;register 重新验收后登记,unregister 不删除安装文件或停止服务
@@ -950,6 +997,8 @@ v-cli art environment guide
950
997
  v-cli art environment list
951
998
  ```
952
999
 
1000
+ 结构化能力:`art.environment-list`。
1001
+
953
1002
 
954
1003
  - 不执行安装、下载或采样;register 重新验收后登记,unregister 不删除安装文件或停止服务
955
1004
 
@@ -961,6 +1010,8 @@ v-cli art environment list
961
1010
  v-cli art environment prepare
962
1011
  ```
963
1012
 
1013
+ 结构化能力:`art.environment-prepare`。
1014
+
964
1015
  - `--directory <value>`:本机环境根目录
965
1016
  - `--endpoint <value>`:本机 HTTP 服务根地址
966
1017
  - `--guide <id>`:部署指南标识;省略使用环境登记或推荐方案
@@ -975,6 +1026,8 @@ v-cli art environment prepare
975
1026
  v-cli art environment inspect
976
1027
  ```
977
1028
 
1029
+ 结构化能力:`art.environment-inspect`。
1030
+
978
1031
  - `--directory <value>`:本机环境根目录
979
1032
  - `--endpoint <value>`:本机 HTTP 服务根地址
980
1033
  - `--guide <id>`:部署指南标识;省略使用环境登记或推荐方案
@@ -989,6 +1042,8 @@ v-cli art environment inspect
989
1042
  v-cli art environment verify
990
1043
  ```
991
1044
 
1045
+ 结构化能力:`art.environment-verify`。
1046
+
992
1047
  - `--directory <value>`:本机环境根目录
993
1048
  - `--endpoint <value>`:本机 HTTP 服务根地址
994
1049
  - `--guide <id>`:部署指南标识;省略使用环境登记或推荐方案
@@ -1003,6 +1058,8 @@ v-cli art environment verify
1003
1058
  v-cli art environment register
1004
1059
  ```
1005
1060
 
1061
+ 结构化能力:`art.environment-register`。
1062
+
1006
1063
  - `--directory <value>`:本机环境根目录
1007
1064
  - `--endpoint <value>`:本机 HTTP 服务根地址
1008
1065
  - `--guide <id>`:部署指南标识;省略使用环境登记或推荐方案
@@ -1017,6 +1074,8 @@ v-cli art environment register
1017
1074
  v-cli art environment unregister
1018
1075
  ```
1019
1076
 
1077
+ 结构化能力:`art.environment-unregister`。
1078
+
1020
1079
  - `--directory <value>`:本机环境根目录
1021
1080
 
1022
1081
  - 不执行安装、下载或采样;register 重新验收后登记,unregister 不删除安装文件或停止服务
@@ -1029,6 +1088,8 @@ v-cli art environment unregister
1029
1088
  v-cli art style export
1030
1089
  ```
1031
1090
 
1091
+ 结构化能力:`art.style-export`。
1092
+
1032
1093
  - `--project <value>`:工程身份
1033
1094
  - `--id <value>`:冻结风格身份
1034
1095
  - `--out <value>`:风格包输出文件
@@ -1043,6 +1104,8 @@ v-cli art style export
1043
1104
  v-cli art style import
1044
1105
  ```
1045
1106
 
1107
+ 结构化能力:`art.style-import`。
1108
+
1046
1109
  - `--project <value>`:目标工程
1047
1110
  - `--file <value>`:风格包文件
1048
1111
 
@@ -1056,6 +1119,8 @@ v-cli art style import
1056
1119
  v-cli art style sources
1057
1120
  ```
1058
1121
 
1122
+ 结构化能力:`art.style-sources`。
1123
+
1059
1124
  - `--input <value>`:来源目录列表 JSON 文件
1060
1125
 
1061
1126
  - 冻结风格包只读;不覆盖已有文件;修改请派生草稿;只导出明确引用的参考图片
@@ -1068,6 +1133,8 @@ v-cli art style sources
1068
1133
  v-cli art conversation start --config <path> --input <path>
1069
1134
  ```
1070
1135
 
1136
+ 结构化能力:`art.conversation-start`。
1137
+
1071
1138
  - `--config <path>`:隔离配置路径
1072
1139
  - `--input <path>`:结构化会话请求 JSON
1073
1140
 
@@ -1083,6 +1150,8 @@ v-cli art conversation start --config <path> --input <path>
1083
1150
  v-cli art conversation status --config <path> --session <id> --request <id>
1084
1151
  ```
1085
1152
 
1153
+ 结构化能力:`art.conversation-status`。
1154
+
1086
1155
  - `--config <path>`:隔离配置路径
1087
1156
  - `--session <id>`:会话身份
1088
1157
  - `--request <id>`:原请求身份
@@ -1099,6 +1168,8 @@ v-cli art conversation status --config <path> --session <id> --request <id>
1099
1168
  v-cli art conversation cancel --config <path> --session <id> --request <id>
1100
1169
  ```
1101
1170
 
1171
+ 结构化能力:`art.conversation-cancel`。
1172
+
1102
1173
  - `--config <path>`:隔离配置路径
1103
1174
  - `--session <id>`:会话身份
1104
1175
  - `--request <id>`:原请求身份
@@ -1115,6 +1186,8 @@ v-cli art conversation cancel --config <path> --session <id> --request <id>
1115
1186
  v-cli art conversation resume --config <path> --session <id> --request <id>
1116
1187
  ```
1117
1188
 
1189
+ 结构化能力:`art.conversation-resume`。
1190
+
1118
1191
  - `--config <path>`:隔离配置路径
1119
1192
  - `--session <id>`:会话身份
1120
1193
  - `--request <id>`:原请求身份
@@ -1131,6 +1204,8 @@ v-cli art conversation resume --config <path> --session <id> --request <id>
1131
1204
  v-cli art conversation close --config <path> --session <id> --request <id>
1132
1205
  ```
1133
1206
 
1207
+ 结构化能力:`art.conversation-close`。
1208
+
1134
1209
  - `--config <path>`:隔离配置路径
1135
1210
  - `--session <id>`:会话身份
1136
1211
  - `--request <id>`:原请求身份
@@ -1147,12 +1222,14 @@ v-cli art conversation close --config <path> --session <id> --request <id>
1147
1222
  v-cli art style migration-complete
1148
1223
  ```
1149
1224
 
1225
+ 结构化能力:`art.style-migration-complete`。
1226
+
1150
1227
  - `--project <id>`:工程身份
1151
1228
  - `--id <id>`:对象身份
1152
1229
  - `--revision <number>`:预期对象版本
1153
1230
  - `--input <file>`:JSON {rules,summary,note};rules 为完整规则数组,每条 id/scope/strength/instruction/when,avoid 可含 negative 抽象排除表达数组
1154
1231
 
1155
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
1232
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1156
1233
 
1157
1234
  ### job migration-complete
1158
1235
 
@@ -1162,12 +1239,2002 @@ v-cli art style migration-complete
1162
1239
  v-cli art job migration-complete
1163
1240
  ```
1164
1241
 
1242
+ 结构化能力:`art.job-migration-complete`。
1243
+
1165
1244
  - `--project <id>`:工程身份
1166
1245
  - `--id <id>`:对象身份
1167
1246
  - `--revision <number>`:预期对象版本
1168
1247
  - `--input <file>`:JSON {rules,summary,note};rules 为完整规则数组,每条 id/scope/strength/instruction/when,avoid 可含 negative 抽象排除表达数组
1169
1248
 
1170
- - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
1249
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1250
+
1251
+ ### image help
1252
+
1253
+ 显示命令入口与 v-cli 发现方式
1254
+
1255
+ ```sh
1256
+ v-cli art image help
1257
+ ```
1258
+
1259
+ 结构化能力:`art.image-help`。
1260
+
1261
+
1262
+ - 无配置读取、目录初始化、网络或模型调用
1263
+
1264
+ ### image config path
1265
+
1266
+ 显示本地配置文件路径
1267
+
1268
+ ```sh
1269
+ v-cli art image config path
1270
+ ```
1271
+
1272
+ 结构化能力:`art.image-config-path`。
1273
+
1274
+
1275
+ - 查询与预演不创建参考目录
1276
+ - 无网络调用
1277
+
1278
+ ### image config show
1279
+
1280
+ 显示生效的本地配置和外部资源路径
1281
+
1282
+ ```sh
1283
+ v-cli art image config show
1284
+ ```
1285
+
1286
+ 结构化能力:`art.image-config-show`。
1287
+
1288
+
1289
+ - 查询与预演不创建参考目录
1290
+ - 无网络调用
1291
+
1292
+ ### image config init
1293
+
1294
+ 配置不存在时创建本地模板;已存在时读取,不覆盖
1295
+
1296
+ ```sh
1297
+ v-cli art image config init
1298
+ ```
1299
+
1300
+ 结构化能力:`art.image-config-init`。
1301
+
1302
+
1303
+ - 查询与预演不创建参考目录
1304
+ - 无网络调用
1305
+ - 写入外部本地配置
1306
+
1307
+ ### image refs guide
1308
+
1309
+ 解释参考分类目录的用途与推荐图片样式
1310
+
1311
+ ```sh
1312
+ v-cli art image refs guide [--project <id>]
1313
+ ```
1314
+
1315
+ 结构化能力:`art.image-refs-guide`。
1316
+
1317
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
1318
+
1319
+ - 查询与预演不创建参考目录
1320
+ - 无网络调用
1321
+
1322
+ ### image agent index
1323
+
1324
+ 发现模块、工程、核心、任务与随包 skill
1325
+
1326
+ ```sh
1327
+ v-cli art image agent index
1328
+ ```
1329
+
1330
+ 结构化能力:`art.image-agent-index`。
1331
+
1332
+
1333
+ - 查询与预演不创建参考目录
1334
+ - 无网络调用
1335
+
1336
+ ### image agent docs
1337
+
1338
+ 输出全部随包模式、配置、工程、命令、诊断与核心指南
1339
+
1340
+ ```sh
1341
+ v-cli art image agent docs
1342
+ ```
1343
+
1344
+ 结构化能力:`art.image-agent-docs`。
1345
+
1346
+
1347
+ - 查询与预演不创建参考目录
1348
+ - 无网络调用
1349
+
1350
+ ### image agent export
1351
+
1352
+ 显式导出技能到指定宿主目录;默认安装不导出
1353
+
1354
+ ```sh
1355
+ v-cli art image agent export --host codex --directory <DIR> [--dry]
1356
+ ```
1357
+
1358
+ 结构化能力:`art.image-agent-export`。
1359
+
1360
+ - `--host <HOST>`:目标宿主 codex 或 claude
1361
+ - `--directory <DIR>`:明确指定导出目录
1362
+ - `--dry`:仅预演
1363
+
1364
+ - 仅显式请求时导出,不扫描用户目录,不生成安装绝对路径回执
1365
+
1366
+ ### image list
1367
+
1368
+ 列出外部工作目录中的工程
1369
+
1370
+ ```sh
1371
+ v-cli art image list
1372
+ ```
1373
+
1374
+ 结构化能力:`art.image-list`。
1375
+
1376
+
1377
+ - 查询与预演不创建参考目录
1378
+ - 无网络调用
1379
+
1380
+ ### image style show
1381
+
1382
+ 读取当前工程的指定冻结核心并验证完整性
1383
+
1384
+ ```sh
1385
+ v-cli art image style show [--project <id>] [--core <id>]
1386
+ ```
1387
+
1388
+ 结构化能力:`art.image-style-show`。
1389
+
1390
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
1391
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
1392
+
1393
+ - 查询与预演不创建参考目录
1394
+ - 无网络调用
1395
+
1396
+ ### image generate show
1397
+
1398
+ 读取文生图任务
1399
+
1400
+ ```sh
1401
+ v-cli art image generate show [--project <id>] [--job <id>]
1402
+ ```
1403
+
1404
+ 结构化能力:`art.image-generate-show`。
1405
+
1406
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
1407
+ - `--job <id>`:工程内任务 ID
1408
+
1409
+ - 查询与预演不创建参考目录
1410
+ - 无网络调用
1411
+
1412
+ ### image generate plan
1413
+
1414
+ 编译文生图计划,明确来源及真实请求
1415
+
1416
+ ```sh
1417
+ v-cli art image generate plan [--project <id>] [--job <id>] [--core <id>] [--out <file>]
1418
+ ```
1419
+
1420
+ 结构化能力:`art.image-generate-plan`。
1421
+
1422
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
1423
+ - `--job <id>`:工程内任务 ID
1424
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
1425
+ - `--out <file>`:可选外部输出文件;相对路径基于 workspace
1426
+ - `--backend <id>`:新计划选择配置中的远程/本地后端 ID;冻结计划不能覆盖
1427
+
1428
+ - 查询与预演不创建参考目录
1429
+ - 无网络调用
1430
+ - 指定 out 时写入外部计划文件
1431
+
1432
+ ### image generate run
1433
+
1434
+ 执行或预演文生图计划
1435
+
1436
+ ```sh
1437
+ v-cli art image generate run [--plan <file>] [--project <id>] [--job <id>] [--core <id>] [--item <id>] [--variant <id>] [--explore] [--offset <n>] [--limit <n>] [--dry]
1438
+ ```
1439
+
1440
+ 结构化能力:`art.image-generate-start`。
1441
+
1442
+ - `--plan <file>`:冻结计划文件;不能同时指定 project/job/core/explore
1443
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
1444
+ - `--job <id>`:工程内任务 ID
1445
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
1446
+ - `--item <id>`:选择单体
1447
+ - `--variant <id>`:选择候选,默认 base
1448
+ - `--explore`:执行全部候选;仅在从任务编译时使用
1449
+ - `--offset <n>`:选择起始偏移,默认 0
1450
+ - `--limit <n>`:执行数量上限
1451
+ - `--dry`:只读预演所选请求;不联网、不启动服务、不上传、不创建参考目录
1452
+ - `--backend <id>`:选择统一配置中的后端;冻结计划不允许覆盖
1453
+ - `--background`:后台执行并返回 taskId
1454
+ - `--all-variants`:执行冻结预案中的全部构图候选;不能与 --variant 同用
1455
+ - `--retry-run <id>`:原批次停止已确认后,仅重试明确失败项;成功项不重做
1456
+ - `--operation <id>`:启动前持久化的稳定操作身份;丢失回执时按原身份 recover
1457
+
1458
+ - 查询与预演不创建参考目录
1459
+ - 远程非 dry 通过登记的协议适配器调用模型,可能产生费用,按已有任务授权执行
1460
+ - 本地非 dry 可启动任务和 ComfyUI 服务并采样,不调用百炼生图
1461
+ - 真实执行写入外部图片、manifest、任务状态和诊断
1462
+ - dry 只展示请求,不启动或探测服务、不上传、不生成图片
1463
+
1464
+ ### image edit show
1465
+
1466
+ 读取图编辑任务
1467
+
1468
+ ```sh
1469
+ v-cli art image edit show [--project <id>] [--job <id>]
1470
+ ```
1471
+
1472
+ 结构化能力:`art.image-edit-show`。
1473
+
1474
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
1475
+ - `--job <id>`:工程内任务 ID
1476
+
1477
+ - 查询与预演不创建参考目录
1478
+ - 无网络调用
1479
+
1480
+ ### image edit plan
1481
+
1482
+ 编译图编辑计划,明确来源及真实请求
1483
+
1484
+ ```sh
1485
+ v-cli art image edit plan [--project <id>] [--job <id>] [--core <id>] [--out <file>]
1486
+ ```
1487
+
1488
+ 结构化能力:`art.image-edit-plan`。
1489
+
1490
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
1491
+ - `--job <id>`:工程内任务 ID
1492
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
1493
+ - `--out <file>`:可选外部输出文件;相对路径基于 workspace
1494
+ - `--backend <id>`:新计划选择配置中的远程/本地后端 ID;冻结计划不能覆盖
1495
+
1496
+ - 查询与预演不创建参考目录
1497
+ - 无网络调用
1498
+ - 指定 out 时写入外部计划文件
1499
+
1500
+ ### image edit run
1501
+
1502
+ 执行或预演图编辑计划
1503
+
1504
+ ```sh
1505
+ v-cli art image edit run [--plan <file>] [--project <id>] [--job <id>] [--core <id>] [--item <id>] [--variant <id>] [--explore] [--offset <n>] [--limit <n>] [--dry]
1506
+ ```
1507
+
1508
+ 结构化能力:`art.image-edit-start`。
1509
+
1510
+ - `--plan <file>`:冻结计划文件;不能同时指定 project/job/core/explore
1511
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
1512
+ - `--job <id>`:工程内任务 ID
1513
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
1514
+ - `--item <id>`:选择单体
1515
+ - `--variant <id>`:选择候选,默认 base
1516
+ - `--explore`:执行全部候选;仅在从任务编译时使用
1517
+ - `--offset <n>`:选择起始偏移,默认 0
1518
+ - `--limit <n>`:执行数量上限
1519
+ - `--dry`:只读预演所选请求;不联网、不启动服务、不上传、不创建参考目录
1520
+ - `--backend <id>`:选择统一配置中的后端;冻结计划不允许覆盖
1521
+ - `--background`:后台执行并返回 taskId
1522
+ - `--all-variants`:执行冻结预案中的全部构图候选;不能与 --variant 同用
1523
+ - `--retry-run <id>`:原批次停止已确认后,仅重试明确失败项;成功项不重做
1524
+ - `--operation <id>`:启动前持久化的稳定操作身份;丢失回执时按原身份 recover
1525
+
1526
+ - 查询与预演不创建参考目录
1527
+ - 远程非 dry 通过登记的协议适配器调用模型,可能产生费用,按已有任务授权执行
1528
+ - 本地非 dry 可启动任务和 ComfyUI 服务并采样,不调用百炼生图
1529
+ - 真实执行写入外部图片、manifest、任务状态和诊断
1530
+ - dry 只展示请求,不启动或探测服务、不上传、不生成图片
1531
+
1532
+ ### image check
1533
+
1534
+ 核验运行计划、执行归属、产物与文件哈希;不进行人工评分
1535
+
1536
+ ```sh
1537
+ v-cli art image check RUN
1538
+ ```
1539
+
1540
+ 结构化能力:`art.image-check`。
1541
+
1542
+ - 位置参数 `RUN`:运行目录或 manifest 路径,按 output 解析(必填)
1543
+
1544
+ - 只读;不调用模型、不写入评分或定版记录
1545
+
1546
+ ### image compare
1547
+
1548
+ 比较两份计划或执行记录的核心、执行配置和单体变更
1549
+
1550
+ ```sh
1551
+ v-cli art image compare BEFORE AFTER
1552
+ ```
1553
+
1554
+ 结构化能力:`art.image-compare`。
1555
+
1556
+ - 位置参数 `BEFORE`:前一份计划/执行记录 JSON,按 workspace 解析(必填)
1557
+ - 位置参数 `AFTER`:后一份计划/执行记录 JSON,按 workspace 解析(必填)
1558
+
1559
+ - 查询与预演不创建参考目录
1560
+ - 无网络调用
1561
+
1562
+ ### image task list
1563
+
1564
+ 列出任务状态
1565
+
1566
+ ```sh
1567
+ v-cli art image task list
1568
+ ```
1569
+
1570
+ 结构化能力:`art.image-run-list`。
1571
+
1572
+ - `--project <id>`:仅列出指定工程运行
1573
+
1574
+ - 读取外部运行状态
1575
+
1576
+ ### image task status
1577
+
1578
+ 查看单次任务及后端 prompt_id
1579
+
1580
+ ```sh
1581
+ v-cli art image task status TASK
1582
+ ```
1583
+
1584
+ 结构化能力:`art.image-run-status`。
1585
+
1586
+ - 位置参数 `TASK`:art 任务 ID(必填)
1587
+
1588
+ - 读取外部运行状态
1589
+
1590
+ ### image task wait
1591
+
1592
+ 等待任务结束;超时不取消任务
1593
+
1594
+ ```sh
1595
+ v-cli art image task wait TASK
1596
+ ```
1597
+
1598
+ 结构化能力:`art.image-run-wait`。
1599
+
1600
+ - 位置参数 `TASK`:art 任务 ID(必填)
1601
+ - `--timeout <seconds>`:等待秒数,默认 3600
1602
+
1603
+ - 读取外部运行状态
1604
+
1605
+ ### image task cancel
1606
+
1607
+ 取消单次任务并等待停止
1608
+
1609
+ ```sh
1610
+ v-cli art image task cancel TASK
1611
+ ```
1612
+
1613
+ 结构化能力:`art.image-run-cancel`。
1614
+
1615
+ - 位置参数 `TASK`:art 任务 ID(必填)
1616
+
1617
+ - 取消单个任务
1618
+ - 按 prompt_id 中断本地任务
1619
+ - 保留服务进程
1620
+
1621
+ ### image shutdown
1622
+
1623
+ 停止当前工作区关联任务,核验共享队列和进程身份后关闭服务
1624
+
1625
+ ```sh
1626
+ v-cli art image shutdown
1627
+ ```
1628
+
1629
+ 结构化能力:`art.image-shutdown`。
1630
+
1631
+
1632
+ - 停止配置范围内所有任务
1633
+ - 只取消关联任务;共享队列仍有其他任务时保留服务
1634
+ - 核验进程身份后关闭服务
1635
+ - 阻止 shutdown 期间的新任务
1636
+
1637
+ ### image config validate
1638
+
1639
+ 校验配置和 API workflow 的结构、连接与参数绑定
1640
+
1641
+ ```sh
1642
+ v-cli art image config validate
1643
+ ```
1644
+
1645
+ 结构化能力:`art.image-config-validate`。
1646
+
1647
+ - `--backend <id>`:仅检查指定后端
1648
+
1649
+ - 只读校验,不启动服务、不调用模型
1650
+
1651
+ ### image doctor
1652
+
1653
+ 检测本地 ComfyUI 环境、节点与模型
1654
+
1655
+ ```sh
1656
+ v-cli art image doctor
1657
+ ```
1658
+
1659
+ 结构化能力:`art.image-doctor`。
1660
+
1661
+ - `--backend <id>`:仅检查指定后端
1662
+ - `--start`:无可用服务时按配置启动;不采样,检查后服务保留
1663
+
1664
+ - 默认读取本地环境,不启动、不采样、不补齐 refs
1665
+ - --start 可启动并保留服务,写状态与日志;不采样
1666
+ - 远程后端只校验配置,不检查认证或云端连通性
1667
+
1668
+ ### image workflow list
1669
+
1670
+ 列出默认内置工作流及 API/UI 文件位置
1671
+
1672
+ ```sh
1673
+ v-cli art image workflow list
1674
+ ```
1675
+
1676
+ 结构化能力:`art.image-workflow-list`。
1677
+
1678
+
1679
+ - 读取随包工作流清单,不依赖合法用户配置、不补 refs、不调用模型
1680
+
1681
+ ### image style create
1682
+
1683
+ 创建独立草稿对象
1684
+
1685
+ ```sh
1686
+ v-cli art image style create
1687
+ ```
1688
+
1689
+ 结构化能力:`art.image-style-create`。
1690
+
1691
+ - `--project <id>`:工程身份
1692
+ - `--input <file>`:结构化配置文件
1693
+
1694
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1695
+
1696
+ ### image style list
1697
+
1698
+ 列出工程对象及任务展示状态
1699
+
1700
+ ```sh
1701
+ v-cli art image style list
1702
+ ```
1703
+
1704
+ 结构化能力:`art.image-style-list`。
1705
+
1706
+ - `--project <id>`:工程身份
1707
+
1708
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1709
+
1710
+ ### image style read
1711
+
1712
+ 读取指定对象与版本
1713
+
1714
+ ```sh
1715
+ v-cli art image style read
1716
+ ```
1717
+
1718
+ 结构化能力:`art.image-style-read`。
1719
+
1720
+ - `--project <id>`:工程身份
1721
+ - `--id <id>`:对象身份
1722
+
1723
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1724
+
1725
+ ### image style update
1726
+
1727
+ 校验预期版本及空闲状态后更新对象
1728
+
1729
+ ```sh
1730
+ v-cli art image style update
1731
+ ```
1732
+
1733
+ 结构化能力:`art.image-style-update`。
1734
+
1735
+ - `--project <id>`:工程身份
1736
+ - `--id <id>`:对象身份
1737
+ - `--revision <number>`:预期对象版本
1738
+ - `--input <file>`:结构化配置文件
1739
+
1740
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1741
+
1742
+ ### image style derive
1743
+
1744
+ 派生独立草稿,保留结构化规则与独立参考;当前冻结证据标记沿用,不继承核心、执行或授权
1745
+
1746
+ ```sh
1747
+ v-cli art image style derive
1748
+ ```
1749
+
1750
+ 结构化能力:`art.image-style-derive`。
1751
+
1752
+ - `--project <id>`:工程身份
1753
+ - `--id <id>`:对象身份
1754
+ - `--revision <number>`:预期对象版本
1755
+
1756
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1757
+
1758
+ ### image style discard
1759
+
1760
+ 确认空闲后丢弃草稿并清理所属资源
1761
+
1762
+ ```sh
1763
+ v-cli art image style discard
1764
+ ```
1765
+
1766
+ 结构化能力:`art.image-style-discard`。
1767
+
1768
+ - `--project <id>`:工程身份
1769
+ - `--id <id>`:对象身份
1770
+ - `--revision <number>`:预期对象版本
1771
+
1772
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1773
+
1774
+ ### image job create
1775
+
1776
+ 创建独立草稿对象
1777
+
1778
+ ```sh
1779
+ v-cli art image job create
1780
+ ```
1781
+
1782
+ 结构化能力:`art.image-job-create`。
1783
+
1784
+ - `--project <id>`:工程身份
1785
+ - `--input <file>`:结构化配置文件
1786
+
1787
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1788
+
1789
+ ### image job list
1790
+
1791
+ 列出工程对象及任务展示状态
1792
+
1793
+ ```sh
1794
+ v-cli art image job list
1795
+ ```
1796
+
1797
+ 结构化能力:`art.image-job-list`。
1798
+
1799
+ - `--project <id>`:工程身份
1800
+
1801
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1802
+
1803
+ ### image job read
1804
+
1805
+ 读取指定对象与版本
1806
+
1807
+ ```sh
1808
+ v-cli art image job read
1809
+ ```
1810
+
1811
+ 结构化能力:`art.image-job-read`。
1812
+
1813
+ - `--project <id>`:工程身份
1814
+ - `--id <id>`:对象身份
1815
+
1816
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1817
+
1818
+ ### image job update
1819
+
1820
+ 校验预期版本及空闲状态后更新对象
1821
+
1822
+ ```sh
1823
+ v-cli art image job update
1824
+ ```
1825
+
1826
+ 结构化能力:`art.image-job-update`。
1827
+
1828
+ - `--project <id>`:工程身份
1829
+ - `--id <id>`:对象身份
1830
+ - `--revision <number>`:预期对象版本
1831
+ - `--input <file>`:结构化配置文件
1832
+
1833
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1834
+
1835
+ ### image job derive
1836
+
1837
+ 派生独立草稿,不继承执行、报告或定版
1838
+
1839
+ ```sh
1840
+ v-cli art image job derive
1841
+ ```
1842
+
1843
+ 结构化能力:`art.image-job-derive`。
1844
+
1845
+ - `--project <id>`:工程身份
1846
+ - `--id <id>`:对象身份
1847
+ - `--revision <number>`:预期对象版本
1848
+
1849
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
1850
+
1851
+ ### image job discard
1852
+
1853
+ 归档已停止的任务,保留配置、参考、收藏、图片与执行历史;可恢复到活跃列表
1854
+
1855
+ ```sh
1856
+ v-cli art image job discard
1857
+ ```
1858
+
1859
+ 结构化能力:`art.image-job-discard`。
1860
+
1861
+ - `--project <id>`:工程身份
1862
+ - `--id <id>`:对象身份
1863
+ - `--revision <number>`:预期对象版本
1864
+
1865
+ - 验证 revision、任务归属和停止确认;归档和恢复均保留原配置、收藏与所有历史文件,不自动执行
1866
+
1867
+ ### image job restore
1868
+
1869
+ 恢复已归档任务到活跃列表,保留原身份、配置与历史;不重新执行
1870
+
1871
+ ```sh
1872
+ v-cli art image job restore
1873
+ ```
1874
+
1875
+ 结构化能力:`art.image-job-restore`。
1876
+
1877
+ - `--project <id>`:工程身份
1878
+ - `--id <id>`:对象身份
1879
+ - `--revision <number>`:预期对象版本
1880
+
1881
+ - 验证 revision、任务归属和停止确认;归档和恢复均保留原配置、收藏与所有历史文件,不自动执行
1882
+
1883
+ ### image style recover
1884
+
1885
+ 恢复已授权采用事务
1886
+
1887
+ ```sh
1888
+ v-cli art image style recover
1889
+ ```
1890
+
1891
+ 结构化能力:`art.image-style-recover`。
1892
+
1893
+ - `--project <id>`:工程身份
1894
+ - `--id <id>`:对象身份
1895
+
1896
+ - 不重新调用模型;核验核心和事务身份后完成状态提交
1897
+
1898
+ ### image project init
1899
+
1900
+ 新建版本 2 工程
1901
+
1902
+ ```sh
1903
+ v-cli art image project init
1904
+ ```
1905
+
1906
+ 结构化能力:`art.image-project-init`。
1907
+
1908
+ - `--project <id>`:工程身份
1909
+ - `--input <file>`:结构化配置文件
1910
+
1911
+ - 工程存在拒绝覆写
1912
+
1913
+ ### image project upgrade
1914
+
1915
+ 显式一次性工程升级
1916
+
1917
+ ```sh
1918
+ v-cli art image project upgrade
1919
+ ```
1920
+
1921
+ 结构化能力:`art.image-project-upgrade`。
1922
+
1923
+ - `--project <id>`:工程身份
1924
+ - `--dry`:预检
1925
+ - `--mapping <file>`:旧共享参考的明确归属映射
1926
+
1927
+ - 备份和原子替换,失败回滚;不猜参考归属
1928
+
1929
+ ### image reference list
1930
+
1931
+ 查看对象参考
1932
+
1933
+ ```sh
1934
+ v-cli art image reference list
1935
+ ```
1936
+
1937
+ 结构化能力:`art.image-reference-list`。
1938
+
1939
+ - `--project <id>`:工程身份
1940
+ - `--kind <style|task>`:对象粒度
1941
+ - `--id <id>`:对象身份
1942
+
1943
+ - 只读
1944
+
1945
+ ### image reference import
1946
+
1947
+ 导入对象私有图片
1948
+
1949
+ ```sh
1950
+ v-cli art image reference import
1951
+ ```
1952
+
1953
+ 结构化能力:`art.image-reference-import`。
1954
+
1955
+ - `--project <id>`:工程身份
1956
+ - `--kind <style|task>`:对象粒度
1957
+ - `--id <id>`:对象身份
1958
+ - `--revision <number>`:预期对象版本
1959
+ - `--source <file>`:用户原图
1960
+ - `--category <name>`:四类静态参考之一
1961
+ - `--purposes <list>`:逗号分隔动态用途
1962
+ - `--note <text>`:参考说明
1963
+ - `--item-id <id>`:所属出图对象标识;未指定为任务共用
1964
+
1965
+ - 校验图片、大小、路径;复制不修改原图;不支持直接参考时拒绝
1966
+
1967
+ ### image reference remove
1968
+
1969
+ 移除参考关联
1970
+
1971
+ ```sh
1972
+ v-cli art image reference remove
1973
+ ```
1974
+
1975
+ 结构化能力:`art.image-reference-remove`。
1976
+
1977
+ - `--project <id>`:工程身份
1978
+ - `--kind <style|task>`:对象粒度
1979
+ - `--id <id>`:对象身份
1980
+ - `--revision <number>`:预期对象版本
1981
+ - `--item <id>`:参考身份
1982
+
1983
+ - 移除关联,保留历史证据资源
1984
+
1985
+ ### image candidate list
1986
+
1987
+ 查看真实候选及完整性
1988
+
1989
+ ```sh
1990
+ v-cli art image candidate list
1991
+ ```
1992
+
1993
+ 结构化能力:`art.image-candidate-list`。
1994
+
1995
+ - `--project <id>`:工程身份
1996
+ - `--job <id>`:配置任务身份
1997
+ - `--run <id>`:执行批次身份
1998
+
1999
+ - 只读;校验批次计划和候选身份
2000
+
2001
+ ### image candidate favorites
2002
+
2003
+ 网格收藏夹的数据来源,列出工程中仍可用的收藏图片及源任务身份
2004
+
2005
+ ```sh
2006
+ v-cli art image candidate favorites --project <id>
2007
+ ```
2008
+
2009
+ 结构化能力:`art.image-candidate-favorites`。
2010
+
2011
+ - `--project <id>`:工程身份
2012
+
2013
+ - 只读;忽略已删除的图片和已归档的任务
2014
+
2015
+ ### image candidate favorite
2016
+
2017
+ 设置图片收藏状态,不修改任务需求、版本、定版或运行状态
2018
+
2019
+ ```sh
2020
+ v-cli art image candidate favorite --project <id> --job <id> --run <id> --candidate <id> --value <true|false>
2021
+ ```
2022
+
2023
+ 结构化能力:`art.image-candidate-favorite`。
2024
+
2025
+ - `--project <id>`:工程身份
2026
+ - `--job <id>`:源任务身份
2027
+ - `--run <id>`:源批次身份
2028
+ - `--candidate <id>`:图片候选身份
2029
+ - `--value <true|false>`:true 收藏,false 取消收藏
2030
+
2031
+ - 仅修改工程收藏记录;重复操作幂等,不启动分析或生成
2032
+
2033
+ ### image candidate finalizations
2034
+
2035
+ 查看资产定版
2036
+
2037
+ ```sh
2038
+ v-cli art image candidate finalizations
2039
+ ```
2040
+
2041
+ 结构化能力:`art.image-candidate-finalizations`。
2042
+
2043
+ - `--project <id>`:工程身份
2044
+ - `--job <id>`:配置任务身份
2045
+
2046
+ - 只读
2047
+
2048
+ ### image candidate finalize
2049
+
2050
+ 按资产定版候选
2051
+
2052
+ ```sh
2053
+ v-cli art image candidate finalize
2054
+ ```
2055
+
2056
+ 结构化能力:`art.image-candidate-finalize`。
2057
+
2058
+ - `--project <id>`:工程身份
2059
+ - `--job <id>`:配置任务身份
2060
+ - `--run <id>`:执行批次身份
2061
+ - `--revision <number>`:预期对象版本
2062
+ - `--candidate <id>`:候选身份
2063
+ - `--actor <text>`:操作者
2064
+ - `--name <text>`:导出文件名;留空时使用 vant-gen-任务-资产-批次
2065
+ - `--replace`:明确替换已有定版
2066
+
2067
+ - 生成完成与哈希有效;重复幂等,替换保留历史
2068
+
2069
+ ### image candidate delete
2070
+
2071
+ 删除候选及关联定版
2072
+
2073
+ ```sh
2074
+ v-cli art image candidate delete
2075
+ ```
2076
+
2077
+ 结构化能力:`art.image-candidate-delete`。
2078
+
2079
+ - `--project <id>`:工程身份
2080
+ - `--job <id>`:配置任务身份
2081
+ - `--run <id>`:执行批次身份
2082
+ - `--revision <number>`:预期对象版本
2083
+ - `--candidate <id>`:候选身份
2084
+ - `--actor <text>`:操作者
2085
+ - `--confirm`:明确确认删除影响
2086
+
2087
+ - 运行和引用检查;先持久化删除记录,再清理私有文件
2088
+
2089
+ ### image job analyze
2090
+
2091
+ 分析任务动态参考,仅转写指定用途,不继承静态风格
2092
+
2093
+ ```sh
2094
+ v-cli art image job analyze
2095
+ ```
2096
+
2097
+ 结构化能力:`art.image-job-analyze`。
2098
+
2099
+ - `--project <id>`:工程身份
2100
+ - `--id <id>`:对象身份
2101
+ - `--revision <number>`:预期对象版本
2102
+ - `--dry`:只读编译预演
2103
+ - `--operation <id>`:分析启动前登记的稳定操作身份
2104
+
2105
+ - dry 不联网、不写参考目录;执行创建运行身份和不可变参考证据;远程停止不确定时保留资源
2106
+
2107
+ ### image task recover
2108
+
2109
+ 仅从唯一原运行登记恢复身份;绝不重新执行
2110
+
2111
+ ```sh
2112
+ v-cli art image task recover --project P --operation OPERATION
2113
+ ```
2114
+
2115
+ 结构化能力:`art.image-run-recover`。
2116
+
2117
+ - `--project <id>`:原工程身份
2118
+ - `--operation <id>`:启动前持久化的原操作身份
2119
+
2120
+ - 读取外部运行状态
2121
+
2122
+ ### image reference update
2123
+
2124
+ 更新参考分类、任务用途与说明,版本校验并使分析失效
2125
+
2126
+ ```sh
2127
+ v-cli art image reference update --project P --kind style --id ID --revision N --item REF --input PATCH.json
2128
+ ```
2129
+
2130
+ 结构化能力:`art.image-reference-update`。
2131
+
2132
+ - `--project <id>`:工程身份
2133
+ - `--kind <kind>`:style 或 task
2134
+ - `--id <id>`:对象身份
2135
+ - `--revision <number>`:预期版本
2136
+ - `--item <id>`:参考身份
2137
+ - `--input <file>`:category/purposes/itemId/note/ignore 的字段补丁;itemId 为 null 时任务共用
2138
+
2139
+ - 风格规则可编辑保存;任务不允许静态分类;不修改用户原图;旧证据保留
2140
+
2141
+ ### image job template
2142
+
2143
+ 只读返回工具权威的任务配置模板;生成任务使用已冻结核心的题材
2144
+
2145
+ ```sh
2146
+ v-cli art job template --project <id> --kind <generate|edit> [--core <id>]
2147
+ ```
2148
+
2149
+ 结构化能力:`art.image-job-template`。
2150
+
2151
+ - `--project <id>`:工程身份
2152
+ - `--kind <generate|edit>`:任务类型
2153
+ - `--core <id>`:生成任务的冻结核心身份
2154
+
2155
+ - 只读返回模板;不创建任务或文件
2156
+
2157
+ ### image job from-candidate
2158
+
2159
+ 将已停止批次中的可用图片导入私有底图,创建独立编辑草稿,不要求定版通过、不运行
2160
+
2161
+ ```sh
2162
+ v-cli art job from-candidate --project <id> --id <task> --run <id> --candidate <id>
2163
+ ```
2164
+
2165
+ 结构化能力:`art.image-job-from-candidate`。
2166
+
2167
+ - `--project <id>`:工程身份
2168
+ - `--id <task>`:源任务身份
2169
+ - `--run <id>`:真实批次
2170
+ - `--candidate <id>`:可用图片的候选身份
2171
+
2172
+ - 写入新的编辑草稿和私有底图;保留候选来源;不启动生成
2173
+
2174
+ ### image task resume
2175
+
2176
+ 仅恢复原上游任务的查询和下载,绝不重新提交
2177
+
2178
+ ```sh
2179
+ v-cli art image task resume TASK
2180
+ ```
2181
+
2182
+ 结构化能力:`art.image-run-resume`。
2183
+
2184
+ - 位置参数 `TASK`:art 任务 ID(必填)
2185
+
2186
+ - 写入原任务状态
2187
+ - 查询原上游任务并下载已有产物
2188
+ - 提交结果未知时拒绝恢复
2189
+
2190
+ ### image environment guide
2191
+
2192
+ 本地环境部署指南
2193
+
2194
+ ```sh
2195
+ v-cli art image environment guide
2196
+ ```
2197
+
2198
+ 结构化能力:`art.image-environment-guide`。
2199
+
2200
+ - `--guide <id>`:部署指南标识;省略使用环境登记或推荐方案
2201
+
2202
+ - 不执行安装、下载或采样;register 重新验收后登记,unregister 不删除安装文件或停止服务
2203
+
2204
+ ### image environment list
2205
+
2206
+ 本地环境目录发现
2207
+
2208
+ ```sh
2209
+ v-cli art image environment list
2210
+ ```
2211
+
2212
+ 结构化能力:`art.image-environment-list`。
2213
+
2214
+
2215
+ - 不执行安装、下载或采样;register 重新验收后登记,unregister 不删除安装文件或停止服务
2216
+
2217
+ ### image environment prepare
2218
+
2219
+ 自动准备兼容 Python 运行时,保留已有环境
2220
+
2221
+ ```sh
2222
+ v-cli art image environment prepare
2223
+ ```
2224
+
2225
+ 结构化能力:`art.image-environment-prepare`。
2226
+
2227
+ - `--directory <value>`:本机环境根目录
2228
+ - `--endpoint <value>`:本机 HTTP 服务根地址
2229
+ - `--guide <id>`:部署指南标识;省略使用环境登记或推荐方案
2230
+
2231
+ - 仅在目标目录创建运行时;复用兼容 Python,不兼容虚拟环境先改名保留,不修改全局 Python
2232
+
2233
+ ### image environment inspect
2234
+
2235
+ 本地环境只读检测
2236
+
2237
+ ```sh
2238
+ v-cli art image environment inspect
2239
+ ```
2240
+
2241
+ 结构化能力:`art.image-environment-inspect`。
2242
+
2243
+ - `--directory <value>`:本机环境根目录
2244
+ - `--endpoint <value>`:本机 HTTP 服务根地址
2245
+ - `--guide <id>`:部署指南标识;省略使用环境登记或推荐方案
2246
+
2247
+ - 不执行安装、下载或采样;register 重新验收后登记,unregister 不删除安装文件或停止服务
2248
+
2249
+ ### image environment verify
2250
+
2251
+ 本地环境确定性验收
2252
+
2253
+ ```sh
2254
+ v-cli art image environment verify
2255
+ ```
2256
+
2257
+ 结构化能力:`art.image-environment-verify`。
2258
+
2259
+ - `--directory <value>`:本机环境根目录
2260
+ - `--endpoint <value>`:本机 HTTP 服务根地址
2261
+ - `--guide <id>`:部署指南标识;省略使用环境登记或推荐方案
2262
+
2263
+ - 不执行安装、下载或采样;register 重新验收后登记,unregister 不删除安装文件或停止服务
2264
+
2265
+ ### image environment register
2266
+
2267
+ 本地环境验收并登记
2268
+
2269
+ ```sh
2270
+ v-cli art image environment register
2271
+ ```
2272
+
2273
+ 结构化能力:`art.image-environment-register`。
2274
+
2275
+ - `--directory <value>`:本机环境根目录
2276
+ - `--endpoint <value>`:本机 HTTP 服务根地址
2277
+ - `--guide <id>`:部署指南标识;省略使用环境登记或推荐方案
2278
+
2279
+ - 不执行安装、下载或采样;register 重新验收后登记,unregister 不删除安装文件或停止服务
2280
+
2281
+ ### image environment unregister
2282
+
2283
+ 本地环境解除登记
2284
+
2285
+ ```sh
2286
+ v-cli art image environment unregister
2287
+ ```
2288
+
2289
+ 结构化能力:`art.image-environment-unregister`。
2290
+
2291
+ - `--directory <value>`:本机环境根目录
2292
+
2293
+ - 不执行安装、下载或采样;register 重新验收后登记,unregister 不删除安装文件或停止服务
2294
+
2295
+ ### image style export
2296
+
2297
+ 导出冻结风格及必要参考,不复制运行状态
2298
+
2299
+ ```sh
2300
+ v-cli art image style export
2301
+ ```
2302
+
2303
+ 结构化能力:`art.image-style-export`。
2304
+
2305
+ - `--project <value>`:工程身份
2306
+ - `--id <value>`:冻结风格身份
2307
+ - `--out <value>`:风格包输出文件
2308
+
2309
+ - 冻结风格包只读;不覆盖已有文件;修改请派生草稿;只导出明确引用的参考图片
2310
+
2311
+ ### image style import
2312
+
2313
+ 导入固定版本的共享冻结风格,保留原身份和版本
2314
+
2315
+ ```sh
2316
+ v-cli art image style import
2317
+ ```
2318
+
2319
+ 结构化能力:`art.image-style-import`。
2320
+
2321
+ - `--project <value>`:目标工程
2322
+ - `--file <value>`:风格包文件
2323
+
2324
+ - 冻结风格包只读;不覆盖已有文件;修改请派生草稿;只导出明确引用的参考图片
2325
+
2326
+ ### image style sources
2327
+
2328
+ 只读列出多个冻结风格来源并报告不可用目录和身份冲突
2329
+
2330
+ ```sh
2331
+ v-cli art image style sources
2332
+ ```
2333
+
2334
+ 结构化能力:`art.image-style-sources`。
2335
+
2336
+ - `--input <value>`:来源目录列表 JSON 文件
2337
+
2338
+ - 冻结风格包只读;不覆盖已有文件;修改请派生草稿;只导出明确引用的参考图片
2339
+
2340
+ ### image conversation start
2341
+
2342
+ 编译并幂等提交会话出图,不创建项目任务
2343
+
2344
+ ```sh
2345
+ v-cli art image conversation start --config <path> --input <path>
2346
+ ```
2347
+
2348
+ 结构化能力:`art.image-conversation-start`。
2349
+
2350
+ - `--config <path>`:隔离配置路径
2351
+ - `--input <path>`:结构化会话请求 JSON
2352
+
2353
+ - bounded
2354
+ - idempotent
2355
+ - no-job-create
2356
+
2357
+ ### image conversation status
2358
+
2359
+ 查询原运行与真实产物
2360
+
2361
+ ```sh
2362
+ v-cli art image conversation status --config <path> --session <id> --request <id>
2363
+ ```
2364
+
2365
+ 结构化能力:`art.image-conversation-status`。
2366
+
2367
+ - `--config <path>`:隔离配置路径
2368
+ - `--session <id>`:会话身份
2369
+ - `--request <id>`:原请求身份
2370
+
2371
+ - bounded
2372
+ - idempotent
2373
+ - no-job-create
2374
+
2375
+ ### image conversation cancel
2376
+
2377
+ 取消原运行
2378
+
2379
+ ```sh
2380
+ v-cli art image conversation cancel --config <path> --session <id> --request <id>
2381
+ ```
2382
+
2383
+ 结构化能力:`art.image-conversation-cancel`。
2384
+
2385
+ - `--config <path>`:隔离配置路径
2386
+ - `--session <id>`:会话身份
2387
+ - `--request <id>`:原请求身份
2388
+
2389
+ - bounded
2390
+ - idempotent
2391
+ - no-job-create
2392
+
2393
+ ### image conversation resume
2394
+
2395
+ 仅恢复原上游身份,不重新提交
2396
+
2397
+ ```sh
2398
+ v-cli art image conversation resume --config <path> --session <id> --request <id>
2399
+ ```
2400
+
2401
+ 结构化能力:`art.image-conversation-resume`。
2402
+
2403
+ - `--config <path>`:隔离配置路径
2404
+ - `--session <id>`:会话身份
2405
+ - `--request <id>`:原请求身份
2406
+
2407
+ - bounded
2408
+ - idempotent
2409
+ - no-job-create
2410
+
2411
+ ### image conversation close
2412
+
2413
+ 宿主退出时停止本请求的worker,保留外部共享服务
2414
+
2415
+ ```sh
2416
+ v-cli art image conversation close --config <path> --session <id> --request <id>
2417
+ ```
2418
+
2419
+ 结构化能力:`art.image-conversation-close`。
2420
+
2421
+ - `--config <path>`:隔离配置路径
2422
+ - `--session <id>`:会话身份
2423
+ - `--request <id>`:原请求身份
2424
+
2425
+ - bounded
2426
+ - idempotent
2427
+ - no-job-create
2428
+
2429
+ ### image style migration-complete
2430
+
2431
+ 校验当前迁移草稿并完成配置迁移;input 为 {note},不分析、不生成或定版
2432
+
2433
+ ```sh
2434
+ v-cli art image style migration-complete
2435
+ ```
2436
+
2437
+ 结构化能力:`art.image-style-migration-complete`。
2438
+
2439
+ - `--project <id>`:工程身份
2440
+ - `--id <id>`:对象身份
2441
+ - `--revision <number>`:预期对象版本
2442
+ - `--input <file>`:JSON {rules,summary,note};rules 为完整规则数组,每条 id/scope/strength/instruction/when,avoid 可含 negative 抽象排除表达数组
2443
+
2444
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
2445
+
2446
+ ### image job migration-complete
2447
+
2448
+ 校验当前迁移草稿并完成配置迁移;input 为 {note},不分析、不生成或定版
2449
+
2450
+ ```sh
2451
+ v-cli art image job migration-complete
2452
+ ```
2453
+
2454
+ 结构化能力:`art.image-job-migration-complete`。
2455
+
2456
+ - `--project <id>`:工程身份
2457
+ - `--id <id>`:对象身份
2458
+ - `--revision <number>`:预期对象版本
2459
+ - `--input <file>`:JSON {rules,summary,note};rules 为完整规则数组,每条 id/scope/strength/instruction/when,avoid 可含 negative 抽象排除表达数组
2460
+
2461
+ - 查询不写入;修改验证 revision、归属和停止确认;风格规则保存即更新,历史执行保留快照
2462
+
2463
+ ### video describe
2464
+
2465
+ 读取视频业务与输入契约
2466
+
2467
+ ```sh
2468
+ v-cli art video describe [--input <file>]
2469
+ ```
2470
+
2471
+ 结构化能力:`art.video-describe`。
2472
+
2473
+ - `--input <file>`:可选;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2474
+
2475
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
2476
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2477
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2478
+
2479
+ ### video snapshot
2480
+
2481
+ 读取视频项目快照
2482
+
2483
+ ```sh
2484
+ v-cli art video snapshot [--input <file>]
2485
+ ```
2486
+
2487
+ 结构化能力:`art.video-snapshot`。
2488
+
2489
+ - `--input <file>`:可选;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2490
+
2491
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
2492
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2493
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2494
+
2495
+ ### video settings get
2496
+
2497
+ 读取视频设置及CAS版本
2498
+
2499
+ ```sh
2500
+ v-cli art video settings get [--input <file>]
2501
+ ```
2502
+
2503
+ 结构化能力:`art.video-settings-get`。
2504
+
2505
+ - `--input <file>`:可选;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2506
+
2507
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
2508
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2509
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2510
+
2511
+ ### video settings save
2512
+
2513
+ 按expectedRevision保存视频设置
2514
+
2515
+ ```sh
2516
+ v-cli art video settings save --input <file> --operation <id>
2517
+ ```
2518
+
2519
+ 结构化能力:`art.video-settings-save`。
2520
+
2521
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2522
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2523
+
2524
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2525
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2526
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2527
+
2528
+ ### video settings presets h3
2529
+
2530
+ 读取H3视频模型预设
2531
+
2532
+ ```sh
2533
+ v-cli art video settings presets h3 [--input <file>]
2534
+ ```
2535
+
2536
+ 结构化能力:`art.video-settings-presets-h3`。
2537
+
2538
+ - `--input <file>`:可选;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2539
+
2540
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
2541
+ - 不提交远端模型生成
2542
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2543
+
2544
+ ### video runtime status
2545
+
2546
+ 核对本地视频运行时状态
2547
+
2548
+ ```sh
2549
+ v-cli art video runtime status [--input <file>]
2550
+ ```
2551
+
2552
+ 结构化能力:`art.video-runtime-status`。
2553
+
2554
+ - `--input <file>`:可选;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2555
+
2556
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
2557
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2558
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2559
+
2560
+ ### video runtime start
2561
+
2562
+ 显式启动本地视频运行时
2563
+
2564
+ ```sh
2565
+ v-cli art video runtime start [--input <file>] --operation <id>
2566
+ ```
2567
+
2568
+ 结构化能力:`art.video-runtime-start`。
2569
+
2570
+ - `--input <file>`:可选;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2571
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2572
+
2573
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2574
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2575
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2576
+
2577
+ ### video runtime stop
2578
+
2579
+ 核对所有权后显式停止本地视频运行时
2580
+
2581
+ ```sh
2582
+ v-cli art video runtime stop [--input <file>] --operation <id>
2583
+ ```
2584
+
2585
+ 结构化能力:`art.video-runtime-stop`。
2586
+
2587
+ - `--input <file>`:可选;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2588
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2589
+
2590
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2591
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2592
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2593
+
2594
+ ### video task list
2595
+
2596
+ 视频通道 task list;输入由video describe公布的业务契约校验
2597
+
2598
+ ```sh
2599
+ v-cli art video task list [--input <file>]
2600
+ ```
2601
+
2602
+ 结构化能力:`art.video-task-list`。
2603
+
2604
+ - `--input <file>`:可选;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2605
+
2606
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
2607
+ - 不提交远端模型生成
2608
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2609
+
2610
+ ### video task read
2611
+
2612
+ 视频通道 task read;输入由video describe公布的业务契约校验
2613
+
2614
+ ```sh
2615
+ v-cli art video task read --input <file>
2616
+ ```
2617
+
2618
+ 结构化能力:`art.video-task-read`。
2619
+
2620
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2621
+
2622
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
2623
+ - 不提交远端模型生成
2624
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2625
+
2626
+ ### video task create
2627
+
2628
+ 视频通道 task create;输入由video describe公布的业务契约校验
2629
+
2630
+ ```sh
2631
+ v-cli art video task create --input <file> --operation <id>
2632
+ ```
2633
+
2634
+ 结构化能力:`art.video-task-create`。
2635
+
2636
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2637
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2638
+
2639
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2640
+ - 不提交远端模型生成
2641
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2642
+
2643
+ ### video task rename
2644
+
2645
+ 视频通道 task rename;输入由video describe公布的业务契约校验
2646
+
2647
+ ```sh
2648
+ v-cli art video task rename --input <file> --operation <id>
2649
+ ```
2650
+
2651
+ 结构化能力:`art.video-task-rename`。
2652
+
2653
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2654
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2655
+
2656
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2657
+ - 不提交远端模型生成
2658
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2659
+
2660
+ ### video task archive
2661
+
2662
+ 视频通道 task archive;输入由video describe公布的业务契约校验
2663
+
2664
+ ```sh
2665
+ v-cli art video task archive --input <file> --operation <id>
2666
+ ```
2667
+
2668
+ 结构化能力:`art.video-task-archive`。
2669
+
2670
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2671
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2672
+
2673
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2674
+ - 不提交远端模型生成
2675
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2676
+
2677
+ ### video operation create
2678
+
2679
+ 视频通道 operation create;输入由video describe公布的业务契约校验
2680
+
2681
+ ```sh
2682
+ v-cli art video operation create --input <file> --operation <id>
2683
+ ```
2684
+
2685
+ 结构化能力:`art.video-operation-create`。
2686
+
2687
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2688
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2689
+
2690
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2691
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2692
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2693
+
2694
+ ### video operation update
2695
+
2696
+ 视频通道 operation update;输入由video describe公布的业务契约校验
2697
+
2698
+ ```sh
2699
+ v-cli art video operation update --input <file> --operation <id>
2700
+ ```
2701
+
2702
+ 结构化能力:`art.video-operation-update`。
2703
+
2704
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2705
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2706
+
2707
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2708
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2709
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2710
+
2711
+ ### video operation rename
2712
+
2713
+ 视频通道 operation rename;输入由video describe公布的业务契约校验
2714
+
2715
+ ```sh
2716
+ v-cli art video operation rename --input <file> --operation <id>
2717
+ ```
2718
+
2719
+ 结构化能力:`art.video-operation-rename`。
2720
+
2721
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2722
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2723
+
2724
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2725
+ - 不提交远端模型生成
2726
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2727
+
2728
+ ### video operation derive
2729
+
2730
+ 视频通道 operation derive;输入由video describe公布的业务契约校验
2731
+
2732
+ ```sh
2733
+ v-cli art video operation derive --input <file> --operation <id>
2734
+ ```
2735
+
2736
+ 结构化能力:`art.video-operation-derive`。
2737
+
2738
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2739
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2740
+
2741
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2742
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2743
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2744
+
2745
+ ### video operation validate
2746
+
2747
+ 视频通道 operation validate;输入由video describe公布的业务契约校验
2748
+
2749
+ ```sh
2750
+ v-cli art video operation validate --input <file>
2751
+ ```
2752
+
2753
+ 结构化能力:`art.video-operation-validate`。
2754
+
2755
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2756
+
2757
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
2758
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2759
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2760
+
2761
+ ### video operation run
2762
+
2763
+ 视频通道 operation run;输入由video describe公布的业务契约校验
2764
+
2765
+ ```sh
2766
+ v-cli art video operation run --input <file> --operation <id>
2767
+ ```
2768
+
2769
+ 结构化能力:`art.video-operation-run`。
2770
+
2771
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2772
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2773
+
2774
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2775
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2776
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2777
+
2778
+ ### video operation resume
2779
+
2780
+ 视频通道 operation resume;输入由video describe公布的业务契约校验
2781
+
2782
+ ```sh
2783
+ v-cli art video operation resume --input <file> --operation <id>
2784
+ ```
2785
+
2786
+ 结构化能力:`art.video-operation-resume`。
2787
+
2788
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2789
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2790
+
2791
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2792
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2793
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2794
+
2795
+ ### video operation cancel
2796
+
2797
+ 视频通道 operation cancel;输入由video describe公布的业务契约校验
2798
+
2799
+ ```sh
2800
+ v-cli art video operation cancel --input <file> --operation <id>
2801
+ ```
2802
+
2803
+ 结构化能力:`art.video-operation-cancel`。
2804
+
2805
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2806
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2807
+
2808
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2809
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2810
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2811
+
2812
+ ### video operation accept
2813
+
2814
+ 视频通道 operation accept;输入由video describe公布的业务契约校验
2815
+
2816
+ ```sh
2817
+ v-cli art video operation accept --input <file> --operation <id>
2818
+ ```
2819
+
2820
+ 结构化能力:`art.video-operation-accept`。
2821
+
2822
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2823
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2824
+
2825
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2826
+ - 不提交远端模型生成
2827
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2828
+
2829
+ ### video operation bind
2830
+
2831
+ 视频通道 operation bind;输入由video describe公布的业务契约校验
2832
+
2833
+ ```sh
2834
+ v-cli art video operation bind --input <file> --operation <id>
2835
+ ```
2836
+
2837
+ 结构化能力:`art.video-operation-bind`。
2838
+
2839
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2840
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2841
+
2842
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2843
+ - 不提交远端模型生成
2844
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2845
+
2846
+ ### video script read
2847
+
2848
+ 视频通道 script read;输入由video describe公布的业务契约校验
2849
+
2850
+ ```sh
2851
+ v-cli art video script read --input <file>
2852
+ ```
2853
+
2854
+ 结构化能力:`art.video-script-read`。
2855
+
2856
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2857
+
2858
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
2859
+ - 不提交远端模型生成
2860
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2861
+
2862
+ ### video script update
2863
+
2864
+ 视频通道 script update;输入由video describe公布的业务契约校验
2865
+
2866
+ ```sh
2867
+ v-cli art video script update --input <file> --operation <id>
2868
+ ```
2869
+
2870
+ 结构化能力:`art.video-script-update`。
2871
+
2872
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2873
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2874
+
2875
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2876
+ - 不提交远端模型生成
2877
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2878
+
2879
+ ### video script plan
2880
+
2881
+ 视频通道 script plan;输入由video describe公布的业务契约校验
2882
+
2883
+ ```sh
2884
+ v-cli art video script plan --input <file>
2885
+ ```
2886
+
2887
+ 结构化能力:`art.video-script-plan`。
2888
+
2889
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2890
+
2891
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
2892
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2893
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2894
+
2895
+ ### video script apply
2896
+
2897
+ 视频通道 script apply;输入由video describe公布的业务契约校验
2898
+
2899
+ ```sh
2900
+ v-cli art video script apply --input <file> --operation <id>
2901
+ ```
2902
+
2903
+ 结构化能力:`art.video-script-apply`。
2904
+
2905
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2906
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2907
+
2908
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2909
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2910
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2911
+
2912
+ ### video film compose
2913
+
2914
+ 视频通道 film compose;输入由video describe公布的业务契约校验
2915
+
2916
+ ```sh
2917
+ v-cli art video film compose --input <file> --operation <id>
2918
+ ```
2919
+
2920
+ 结构化能力:`art.video-film-compose`。
2921
+
2922
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2923
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2924
+
2925
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2926
+ - 不提交远端模型生成
2927
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2928
+
2929
+ ### video film refine
2930
+
2931
+ 视频通道 film refine;输入由video describe公布的业务契约校验
2932
+
2933
+ ```sh
2934
+ v-cli art video film refine --input <file> --operation <id>
2935
+ ```
2936
+
2937
+ 结构化能力:`art.video-film-refine`。
2938
+
2939
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2940
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2941
+
2942
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2943
+ - 可访问本机ComfyUI;启动与生成仍仅发生在显式对应动作
2944
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2945
+
2946
+ ### video film preview
2947
+
2948
+ 视频通道 film preview;输入由video describe公布的业务契约校验
2949
+
2950
+ ```sh
2951
+ v-cli art video film preview --input <file> --operation <id>
2952
+ ```
2953
+
2954
+ 结构化能力:`art.video-film-preview`。
2955
+
2956
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2957
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2958
+
2959
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2960
+ - 不提交远端模型生成
2961
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2962
+
2963
+ ### video film adopt
2964
+
2965
+ 视频通道 film adopt;输入由video describe公布的业务契约校验
2966
+
2967
+ ```sh
2968
+ v-cli art video film adopt --input <file> --operation <id>
2969
+ ```
2970
+
2971
+ 结构化能力:`art.video-film-adopt`。
2972
+
2973
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2974
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2975
+
2976
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2977
+ - 不提交远端模型生成
2978
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2979
+
2980
+ ### video film undo
2981
+
2982
+ 视频通道 film undo;输入由video describe公布的业务契约校验
2983
+
2984
+ ```sh
2985
+ v-cli art video film undo --input <file> --operation <id>
2986
+ ```
2987
+
2988
+ 结构化能力:`art.video-film-undo`。
2989
+
2990
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
2991
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
2992
+
2993
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
2994
+ - 不提交远端模型生成
2995
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
2996
+
2997
+ ### video material list
2998
+
2999
+ 视频通道 material list;输入由video describe公布的业务契约校验
3000
+
3001
+ ```sh
3002
+ v-cli art video material list [--input <file>]
3003
+ ```
3004
+
3005
+ 结构化能力:`art.video-material-list`。
3006
+
3007
+ - `--input <file>`:可选;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
3008
+
3009
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
3010
+ - 不提交远端模型生成
3011
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
3012
+
3013
+ ### video material import
3014
+
3015
+ 视频通道 material import;输入由video describe公布的业务契约校验
3016
+
3017
+ ```sh
3018
+ v-cli art video material import --input <file> --operation <id>
3019
+ ```
3020
+
3021
+ 结构化能力:`art.video-material-import`。
3022
+
3023
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
3024
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
3025
+
3026
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
3027
+ - 不提交远端模型生成
3028
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
3029
+
3030
+ ### video material import-file
3031
+
3032
+ 视频通道 material import-file;输入由video describe公布的业务契约校验
3033
+
3034
+ ```sh
3035
+ v-cli art video material import-file --input <file> --operation <id>
3036
+ ```
3037
+
3038
+ 结构化能力:`art.video-material-import-file`。
3039
+
3040
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
3041
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
3042
+
3043
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
3044
+ - 不提交远端模型生成
3045
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
3046
+
3047
+ ### video material upload
3048
+
3049
+ 视频通道 material upload;输入由video describe公布的业务契约校验
3050
+
3051
+ ```sh
3052
+ v-cli art video material upload --input <file> --operation <id>
3053
+ ```
3054
+
3055
+ 结构化能力:`art.video-material-upload`。
3056
+
3057
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
3058
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
3059
+
3060
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
3061
+ - 不提交远端模型生成
3062
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
3063
+
3064
+ ### video material hide
3065
+
3066
+ 视频通道 material hide;输入由video describe公布的业务契约校验
3067
+
3068
+ ```sh
3069
+ v-cli art video material hide --input <file> --operation <id>
3070
+ ```
3071
+
3072
+ 结构化能力:`art.video-material-hide`。
3073
+
3074
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
3075
+ - `--operation <id>`:必填;稳定操作身份。先持久化原意图,重复同ID只核对原回执,unknown不换ID重投
3076
+
3077
+ - 写入与人工授权对应的稳定操作身份,按项目CAS与共享SQLite资源锁执行;失败或回执丢失保留原意图
3078
+ - 不提交远端模型生成
3079
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
3080
+
3081
+ ### video image
3082
+
3083
+ 视频通道 image;输入由video describe公布的业务契约校验
3084
+
3085
+ ```sh
3086
+ v-cli art video image --input <file>
3087
+ ```
3088
+
3089
+ 结构化能力:`art.video-image`。
3090
+
3091
+ - `--input <file>`:必填;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
3092
+
3093
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
3094
+ - 不提交远端模型生成
3095
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
3096
+
3097
+ ### video media status
3098
+
3099
+ 视频通道 media status;输入由video describe公布的业务契约校验
3100
+
3101
+ ```sh
3102
+ v-cli art video media status [--input <file>]
3103
+ ```
3104
+
3105
+ 结构化能力:`art.video-media-status`。
3106
+
3107
+ - `--input <file>`:可选;工程内JSON对象文件,原样传递业务输入;CAS revision/expectedRevision 与 requestId 不由CLI补造
3108
+
3109
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
3110
+ - 不提交远端模型生成
3111
+ - 状态、提交身份与实际媒体产物分别核对;JSON返回不证明视频产出成功
3112
+
3113
+ ### video execution status
3114
+
3115
+ 核对原CLI/宿主视频意图及回执
3116
+
3117
+ ```sh
3118
+ v-cli art video execution status --operation <id>
3119
+ ```
3120
+
3121
+ 结构化能力:`art.video-execution-status`。
3122
+
3123
+ - `--operation <id>`:必填;原CLI操作身份或返回的video-UUID,只核对原回执
3124
+
3125
+ - 只读查询,不登记业务写入意图;可能执行本地媒体/进程检查
3126
+ - 不提交远端模型生成
3127
+ - 读取DSH与CLI共享的请求、回执目录;executing按unknown核对
3128
+
3129
+ ### style sample-job
3130
+
3131
+ 创建仅使用当前文字规则的样张任务;count 为每个主题候选数(1~4),不自动生成
3132
+
3133
+ ```sh
3134
+ v-cli art style sample-job --project ID --id STYLE --revision N
3135
+ ```
3136
+
3137
+ 结构化能力:`art.style-sample-job`。
3138
+
3139
+ - `--project <id>`:工程身份
3140
+ - `--id <id>`:风格身份
3141
+ - `--revision <number>`:预期风格版本
3142
+ - `--name <name>`:任务名称(可选)
3143
+ - `--count <number>`:每个主题候选数,1~4;三个主题共 3 × count 张,默认 1
3144
+
3145
+ - 保存或建任务不发起生成;版本冲突重新读取;样张仅作绘制语言参考,不能保证隔离无关特征
3146
+
3147
+ ### style sample-select
3148
+
3149
+ 样张定版:将有效候选自动加入当前风格运行时参考;按图片内容哈希去重,重复操作不新增
3150
+
3151
+ ```sh
3152
+ v-cli art style sample-select --project ID --id STYLE --revision N --job VALUE --run VALUE --candidate VALUE
3153
+ ```
3154
+
3155
+ 结构化能力:`art.style-sample-select`。
3156
+
3157
+ - `--project <id>`:工程身份
3158
+ - `--id <id>`:风格身份
3159
+ - `--revision <number>`:预期风格版本
3160
+ - `--job <id>`:源任务
3161
+ - `--run <id>`:源运行
3162
+ - `--candidate <id>`:候选身份
3163
+ - `--note <text>`:样张说明(可选)
3164
+
3165
+ - 保存或建任务不发起生成;版本冲突重新读取;样张仅作绘制语言参考,不能保证隔离无关特征
3166
+
3167
+ ### style sample-remove
3168
+
3169
+ 取消样张定版并移除当前运行时参考;保留历史计划依赖的图片文件
3170
+
3171
+ ```sh
3172
+ v-cli art style sample-remove --project ID --id STYLE --revision N --sample VALUE
3173
+ ```
3174
+
3175
+ 结构化能力:`art.style-sample-remove`。
3176
+
3177
+ - `--project <id>`:工程身份
3178
+ - `--id <id>`:风格身份
3179
+ - `--revision <number>`:预期风格版本
3180
+ - `--sample <id>`:样张身份
3181
+
3182
+ - 保存或建任务不发起生成;版本冲突重新读取;样张仅作绘制语言参考,不能保证隔离无关特征
3183
+
3184
+ ### image style sample-job
3185
+
3186
+ 创建仅使用当前文字规则的样张任务;count 为每个主题候选数(1~4),不自动生成
3187
+
3188
+ ```sh
3189
+ v-cli art image style sample-job --project ID --id STYLE --revision N
3190
+ ```
3191
+
3192
+ 结构化能力:`art.image-style-sample-job`。
3193
+
3194
+ - `--project <id>`:工程身份
3195
+ - `--id <id>`:风格身份
3196
+ - `--revision <number>`:预期风格版本
3197
+ - `--name <name>`:任务名称(可选)
3198
+ - `--count <number>`:每个主题候选数,1~4;三个主题共 3 × count 张,默认 1
3199
+
3200
+ - 保存或建任务不发起生成;版本冲突重新读取;样张仅作绘制语言参考,不能保证隔离无关特征
3201
+
3202
+ ### image style sample-select
3203
+
3204
+ 样张定版:将有效候选自动加入当前风格运行时参考;按图片内容哈希去重,重复操作不新增
3205
+
3206
+ ```sh
3207
+ v-cli art image style sample-select --project ID --id STYLE --revision N --job VALUE --run VALUE --candidate VALUE
3208
+ ```
3209
+
3210
+ 结构化能力:`art.image-style-sample-select`。
3211
+
3212
+ - `--project <id>`:工程身份
3213
+ - `--id <id>`:风格身份
3214
+ - `--revision <number>`:预期风格版本
3215
+ - `--job <id>`:源任务
3216
+ - `--run <id>`:源运行
3217
+ - `--candidate <id>`:候选身份
3218
+ - `--note <text>`:样张说明(可选)
3219
+
3220
+ - 保存或建任务不发起生成;版本冲突重新读取;样张仅作绘制语言参考,不能保证隔离无关特征
3221
+
3222
+ ### image style sample-remove
3223
+
3224
+ 取消样张定版并移除当前运行时参考;保留历史计划依赖的图片文件
3225
+
3226
+ ```sh
3227
+ v-cli art image style sample-remove --project ID --id STYLE --revision N --sample VALUE
3228
+ ```
3229
+
3230
+ 结构化能力:`art.image-style-sample-remove`。
3231
+
3232
+ - `--project <id>`:工程身份
3233
+ - `--id <id>`:风格身份
3234
+ - `--revision <number>`:预期风格版本
3235
+ - `--sample <id>`:样张身份
3236
+
3237
+ - 保存或建任务不发起生成;版本冲突重新读取;样张仅作绘制语言参考,不能保证隔离无关特征
1171
3238
 
1172
3239
  ## 结果验证
1173
3240