@kevlns/art-workshop 0.5.2 → 0.6.0

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