@kevlns/art-workshop 0.1.3 → 0.3.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 (61) hide show
  1. package/AGENTS.md +33 -12
  2. package/README.md +33 -135
  3. package/art-workshop.mjs +95 -25
  4. package/docs/commands.md +915 -0
  5. package/docs/configuration.md +60 -0
  6. package/docs/core-guidance.md +80 -13
  7. package/docs/data-formats.md +29 -0
  8. package/docs/deployment.md +40 -0
  9. package/docs/model-architecture.md +52 -0
  10. package/docs/modes.md +39 -0
  11. package/docs/remote-models.md +42 -0
  12. package/docs/troubleshooting.md +46 -0
  13. package/lib/adapters/dashscope.mjs +234 -0
  14. package/lib/adapters/index.mjs +28 -0
  15. package/lib/agent.mjs +3 -2
  16. package/lib/analysis-worker.mjs +25 -0
  17. package/lib/analyze.mjs +8 -8
  18. package/lib/backends.mjs +365 -0
  19. package/lib/bl.mjs +3 -18
  20. package/lib/candidates.mjs +82 -0
  21. package/lib/comfyui.mjs +64 -0
  22. package/lib/contracts.d.ts +67 -0
  23. package/lib/deployment-worker.mjs +97 -0
  24. package/lib/deployment.mjs +72 -0
  25. package/lib/design.mjs +5 -5
  26. package/lib/diagnostics.mjs +83 -0
  27. package/lib/dimensions.mjs +22 -0
  28. package/lib/edit.mjs +6 -3
  29. package/lib/environments.mjs +67 -0
  30. package/lib/execution/remote.mjs +156 -0
  31. package/lib/executor.mjs +10 -24
  32. package/lib/generate.mjs +9 -5
  33. package/lib/generation-policy.mjs +198 -0
  34. package/lib/images.mjs +10 -0
  35. package/lib/lifecycle.mjs +40 -0
  36. package/lib/migration.mjs +154 -0
  37. package/lib/model-catalog.mjs +288 -0
  38. package/lib/model-registry.mjs +234 -0
  39. package/lib/plan.mjs +98 -28
  40. package/lib/project.mjs +13 -4
  41. package/lib/providers.mjs +30 -0
  42. package/lib/refs.mjs +12 -16
  43. package/lib/runtime.mjs +25 -0
  44. package/lib/service.mjs +137 -0
  45. package/lib/settings.mjs +5 -6
  46. package/lib/shared.mjs +12 -2
  47. package/lib/style-lifecycle.mjs +72 -0
  48. package/lib/task-references.mjs +35 -0
  49. package/lib/task-worker.mjs +233 -0
  50. package/lib/tasks.mjs +458 -0
  51. package/lib/templates.mjs +69 -0
  52. package/lib/transport/cli.mjs +69 -0
  53. package/lib/transport/http.mjs +82 -0
  54. package/lib/vision.mjs +46 -0
  55. package/lib/workflows.mjs +28 -0
  56. package/lib/workspace.mjs +190 -0
  57. package/package.json +14 -6
  58. package/skills/art-workshop/SKILL.md +27 -27
  59. package/v-cli.plugin.json +1484 -135
  60. package/workflows/vant-builtin-qwen-image-2.1-Q4-8GB.api.json +116 -0
  61. package/workflows/vant-builtin-qwen-image-2.1-Q4-8GB.json +648 -0
@@ -0,0 +1,915 @@
1
+ # art 命令参考
2
+
3
+ <!-- Generated by scripts/command-docs.mjs; edit v-cli.plugin.json. -->
4
+
5
+ 本文件由插件清单生成。`npm run docs:generate` 更新,`npm run docs:check` 检查漂移。
6
+
7
+ `v-cli art` 路由到同一工具;直接调用可用 `art-workshop`。标识、路径占位符须替换为真实值。
8
+
9
+ ## 全局选项
10
+
11
+ - `--config <file>`:外部本地配置文件
12
+ - `--workspace <dir>`:外部工程与任务根目录
13
+ - `--output-dir <dir>`:产物根目录;默认与 workspace 相同,Vant 显式绑定工程 .vant/art
14
+ - `--refs-dir <dir>`:外部参考图目录
15
+ - `--cache-dir <dir>`:外部缓存目录
16
+ - `-V, --version`:单独使用,显示工具版本
17
+ - `-h, --help`:单独使用,显示入口帮助
18
+
19
+ ## 执行约束
20
+
21
+ 相对计划、输入和报告路径以 workspace 为基准;运行批次以 output 为基准。参考导入的源文件建议使用绝对路径。查询与预演不初始化参考目录。
22
+
23
+ 冻结计划不能覆盖 project/job/core/backend/explore。`--all-variants` 与 `--variant` 互斥。`--retry-run` 只用于原计划的明确失败项,不能混用 dry/item/variant/offset/limit。远程恢复只用 `task resume`,不会补发未提交项。
24
+
25
+ 前台运行也登记 taskId;后台启动成功仅表示收到执行身份。状态、停止确认和实际产物分别核对。详见 [任务控制](troubleshooting.md)、[模型架构](model-architecture.md) 和 [部署](deployment.md)。
26
+
27
+ ## help
28
+
29
+ 显示命令入口与 v-cli 发现方式
30
+
31
+ ```sh
32
+ v-cli art help
33
+ ```
34
+
35
+
36
+ - 无配置读取、目录初始化、网络或模型调用
37
+
38
+ ## config path
39
+
40
+ 显示本地配置文件路径
41
+
42
+ ```sh
43
+ v-cli art config path
44
+ ```
45
+
46
+
47
+ - 查询与预演不创建参考目录
48
+ - 无网络调用
49
+
50
+ ## config show
51
+
52
+ 显示生效的本地配置和外部资源路径
53
+
54
+ ```sh
55
+ v-cli art config show
56
+ ```
57
+
58
+
59
+ - 查询与预演不创建参考目录
60
+ - 无网络调用
61
+
62
+ ## config init
63
+
64
+ 配置不存在时创建本地模板;已存在时读取,不覆盖
65
+
66
+ ```sh
67
+ v-cli art config init
68
+ ```
69
+
70
+
71
+ - 查询与预演不创建参考目录
72
+ - 无网络调用
73
+ - 写入外部本地配置
74
+
75
+ ## refs guide
76
+
77
+ 解释参考分类目录的用途与推荐图片样式
78
+
79
+ ```sh
80
+ v-cli art refs guide [--project <id>]
81
+ ```
82
+
83
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
84
+
85
+ - 查询与预演不创建参考目录
86
+ - 无网络调用
87
+
88
+ ## agent index
89
+
90
+ 发现模块、工程、核心、任务与随包 skill
91
+
92
+ ```sh
93
+ v-cli art agent index
94
+ ```
95
+
96
+
97
+ - 查询与预演不创建参考目录
98
+ - 无网络调用
99
+
100
+ ## agent docs
101
+
102
+ 输出全部随包模式、配置、工程、命令、诊断与核心指南
103
+
104
+ ```sh
105
+ v-cli art agent docs
106
+ ```
107
+
108
+
109
+ - 查询与预演不创建参考目录
110
+ - 无网络调用
111
+
112
+ ## agent init
113
+
114
+ 将随包 skill 同步到目标下已有 Agent 技能目录
115
+
116
+ ```sh
117
+ v-cli art agent init [--directory <dir>] [--dry]
118
+ ```
119
+
120
+ - `--directory <dir>`:同步目标根目录,默认 cwd
121
+ - `--dry`:只读预演,不联网、不创建参考目录
122
+
123
+ - 查询与预演不创建参考目录
124
+ - 无网络调用
125
+ - 覆盖同名随包 skill 和 runtime.json,保留扩展文件
126
+
127
+ ## list
128
+
129
+ 列出外部工作目录中的工程
130
+
131
+ ```sh
132
+ v-cli art list
133
+ ```
134
+
135
+
136
+ - 查询与预演不创建参考目录
137
+ - 无网络调用
138
+
139
+ ## style analyze
140
+
141
+ 草稿风格后台分析
142
+
143
+ ```sh
144
+ v-cli art style analyze
145
+ ```
146
+
147
+ - `--project <id>`:工程身份
148
+ - `--id <id>`:对象身份
149
+ - `--revision <number>`:预期对象版本
150
+ - `--dry`:只读编译预演
151
+ - `--operation <id>`:分析启动前登记的稳定操作身份
152
+
153
+ - dry 不联网、不写参考目录;执行创建运行身份和不可变参考证据;远程停止不确定时保留资源
154
+
155
+ ## style validate
156
+
157
+ 校验报告及核心规则的一致性
158
+
159
+ ```sh
160
+ v-cli art style validate [--project <id>] [--report <file>]
161
+ ```
162
+
163
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
164
+ - `--report <file>`:风格报告 JSON,相对路径基于 workspace
165
+
166
+ - 查询与预演不创建参考目录
167
+ - 无网络调用
168
+
169
+ ## style show
170
+
171
+ 读取当前工程的指定冻结核心并验证完整性
172
+
173
+ ```sh
174
+ v-cli art style show [--project <id>] [--core <id>]
175
+ ```
176
+
177
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
178
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
179
+
180
+ - 查询与预演不创建参考目录
181
+ - 无网络调用
182
+
183
+ ## generate show
184
+
185
+ 读取文生图任务
186
+
187
+ ```sh
188
+ v-cli art generate show [--project <id>] [--job <id>]
189
+ ```
190
+
191
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
192
+ - `--job <id>`:工程内任务 ID
193
+
194
+ - 查询与预演不创建参考目录
195
+ - 无网络调用
196
+
197
+ ## generate plan
198
+
199
+ 编译文生图计划,明确来源及真实请求
200
+
201
+ ```sh
202
+ v-cli art generate plan [--project <id>] [--job <id>] [--core <id>] [--out <file>]
203
+ ```
204
+
205
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
206
+ - `--job <id>`:工程内任务 ID
207
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
208
+ - `--out <file>`:可选外部输出文件;相对路径基于 workspace
209
+ - `--backend <id>`:新计划选择配置中的远程/本地后端 ID;冻结计划不能覆盖
210
+
211
+ - 查询与预演不创建参考目录
212
+ - 无网络调用
213
+ - 指定 out 时写入外部计划文件
214
+
215
+ ## generate run
216
+
217
+ 执行或预演文生图计划
218
+
219
+ ```sh
220
+ v-cli art generate run [--plan <file>] [--project <id>] [--job <id>] [--core <id>] [--item <id>] [--variant <id>] [--explore] [--offset <n>] [--limit <n>] [--dry]
221
+ ```
222
+
223
+ - `--plan <file>`:冻结计划文件;不能同时指定 project/job/core/explore
224
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
225
+ - `--job <id>`:工程内任务 ID
226
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
227
+ - `--item <id>`:选择单体
228
+ - `--variant <id>`:选择候选,默认 base
229
+ - `--explore`:执行全部候选;仅在从任务编译时使用
230
+ - `--offset <n>`:选择起始偏移,默认 0
231
+ - `--limit <n>`:执行数量上限
232
+ - `--dry`:只读预演所选请求;不联网、不启动服务、不上传、不创建参考目录
233
+ - `--backend <id>`:选择统一配置中的后端;冻结计划不允许覆盖
234
+ - `--background`:后台执行并返回 taskId
235
+ - `--all-variants`:执行冻结预案中的全部构图候选;不能与 --variant 同用
236
+ - `--retry-run <id>`:原批次停止已确认后,仅重试明确失败项;成功项不重做
237
+ - `--operation <id>`:启动前持久化的稳定操作身份;丢失回执时按原身份 recover
238
+
239
+ - 查询与预演不创建参考目录
240
+ - 远程非 dry 通过登记的协议适配器调用模型,可能产生费用,按已有任务授权执行
241
+ - 本地非 dry 可启动任务和 ComfyUI 服务并采样,不调用百炼生图
242
+ - 真实执行写入外部图片、manifest、任务状态和诊断
243
+ - dry 只展示请求,不启动或探测服务、不上传、不生成图片
244
+
245
+ ## edit show
246
+
247
+ 读取图编辑任务
248
+
249
+ ```sh
250
+ v-cli art edit show [--project <id>] [--job <id>]
251
+ ```
252
+
253
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
254
+ - `--job <id>`:工程内任务 ID
255
+
256
+ - 查询与预演不创建参考目录
257
+ - 无网络调用
258
+
259
+ ## edit plan
260
+
261
+ 编译图编辑计划,明确来源及真实请求
262
+
263
+ ```sh
264
+ v-cli art edit plan [--project <id>] [--job <id>] [--core <id>] [--out <file>]
265
+ ```
266
+
267
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
268
+ - `--job <id>`:工程内任务 ID
269
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
270
+ - `--out <file>`:可选外部输出文件;相对路径基于 workspace
271
+ - `--backend <id>`:新计划选择配置中的远程/本地后端 ID;冻结计划不能覆盖
272
+
273
+ - 查询与预演不创建参考目录
274
+ - 无网络调用
275
+ - 指定 out 时写入外部计划文件
276
+
277
+ ## edit run
278
+
279
+ 执行或预演图编辑计划
280
+
281
+ ```sh
282
+ v-cli art edit run [--plan <file>] [--project <id>] [--job <id>] [--core <id>] [--item <id>] [--variant <id>] [--explore] [--offset <n>] [--limit <n>] [--dry]
283
+ ```
284
+
285
+ - `--plan <file>`:冻结计划文件;不能同时指定 project/job/core/explore
286
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
287
+ - `--job <id>`:工程内任务 ID
288
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
289
+ - `--item <id>`:选择单体
290
+ - `--variant <id>`:选择候选,默认 base
291
+ - `--explore`:执行全部候选;仅在从任务编译时使用
292
+ - `--offset <n>`:选择起始偏移,默认 0
293
+ - `--limit <n>`:执行数量上限
294
+ - `--dry`:只读预演所选请求;不联网、不启动服务、不上传、不创建参考目录
295
+ - `--backend <id>`:选择统一配置中的后端;冻结计划不允许覆盖
296
+ - `--background`:后台执行并返回 taskId
297
+ - `--all-variants`:执行冻结预案中的全部构图候选;不能与 --variant 同用
298
+ - `--retry-run <id>`:原批次停止已确认后,仅重试明确失败项;成功项不重做
299
+ - `--operation <id>`:启动前持久化的稳定操作身份;丢失回执时按原身份 recover
300
+
301
+ - 查询与预演不创建参考目录
302
+ - 远程非 dry 通过登记的协议适配器调用模型,可能产生费用,按已有任务授权执行
303
+ - 本地非 dry 可启动任务和 ComfyUI 服务并采样,不调用百炼生图
304
+ - 真实执行写入外部图片、manifest、任务状态和诊断
305
+ - dry 只展示请求,不启动或探测服务、不上传、不生成图片
306
+
307
+ ## check
308
+
309
+ 核验运行计划、执行归属、产物与文件哈希;不进行人工评分
310
+
311
+ ```sh
312
+ v-cli art check RUN
313
+ ```
314
+
315
+ - 位置参数 `RUN`:运行目录或 manifest 路径,按 output 解析(必填)
316
+
317
+ - 只读;不调用模型、不写入评分或定版记录
318
+
319
+ ## compare
320
+
321
+ 比较两份计划或执行记录的核心、执行配置和单体变更
322
+
323
+ ```sh
324
+ v-cli art compare BEFORE AFTER
325
+ ```
326
+
327
+ - 位置参数 `BEFORE`:前一份计划/执行记录 JSON,按 workspace 解析(必填)
328
+ - 位置参数 `AFTER`:后一份计划/执行记录 JSON,按 workspace 解析(必填)
329
+
330
+ - 查询与预演不创建参考目录
331
+ - 无网络调用
332
+
333
+ ## task list
334
+
335
+ 列出任务状态
336
+
337
+ ```sh
338
+ v-cli art task list
339
+ ```
340
+
341
+ - `--project <id>`:仅列出指定工程运行
342
+
343
+ - 读取外部运行状态
344
+
345
+ ## task status
346
+
347
+ 查看单次任务及后端 prompt_id
348
+
349
+ ```sh
350
+ v-cli art task status TASK
351
+ ```
352
+
353
+ - 位置参数 `TASK`:art 任务 ID(必填)
354
+
355
+ - 读取外部运行状态
356
+
357
+ ## task wait
358
+
359
+ 等待任务结束;超时不取消任务
360
+
361
+ ```sh
362
+ v-cli art task wait TASK
363
+ ```
364
+
365
+ - 位置参数 `TASK`:art 任务 ID(必填)
366
+ - `--timeout <seconds>`:等待秒数,默认 3600
367
+
368
+ - 读取外部运行状态
369
+
370
+ ## task cancel
371
+
372
+ 取消单次任务并等待停止
373
+
374
+ ```sh
375
+ v-cli art task cancel TASK
376
+ ```
377
+
378
+ - 位置参数 `TASK`:art 任务 ID(必填)
379
+
380
+ - 取消单个任务
381
+ - 按 prompt_id 中断本地任务
382
+ - 保留服务进程
383
+
384
+ ## shutdown
385
+
386
+ 停止当前工作区关联任务,核验共享队列和进程身份后关闭服务
387
+
388
+ ```sh
389
+ v-cli art shutdown
390
+ ```
391
+
392
+
393
+ - 停止配置范围内所有任务
394
+ - 只取消关联任务;共享队列仍有其他任务时保留服务
395
+ - 核验进程身份后关闭服务
396
+ - 阻止 shutdown 期间的新任务
397
+
398
+ ## config validate
399
+
400
+ 校验配置和 API workflow 的结构、连接与参数绑定
401
+
402
+ ```sh
403
+ v-cli art config validate
404
+ ```
405
+
406
+ - `--backend <id>`:仅检查指定后端
407
+
408
+ - 只读校验,不启动服务、不调用模型
409
+
410
+ ## doctor
411
+
412
+ 检测本地 ComfyUI 环境、节点与模型
413
+
414
+ ```sh
415
+ v-cli art doctor
416
+ ```
417
+
418
+ - `--backend <id>`:仅检查指定后端
419
+ - `--start`:无可用服务时按配置启动;不采样,检查后服务保留
420
+
421
+ - 默认读取本地环境,不启动、不采样、不补齐 refs
422
+ - --start 可启动并保留服务,写状态与日志;不采样
423
+ - 远程后端只校验配置,不检查认证或云端连通性
424
+
425
+ ## workflow list
426
+
427
+ 列出默认内置工作流及 API/UI 文件位置
428
+
429
+ ```sh
430
+ v-cli art workflow list
431
+ ```
432
+
433
+
434
+ - 读取随包工作流清单,不依赖合法用户配置、不补 refs、不调用模型
435
+
436
+ ## style create
437
+
438
+ 创建独立草稿对象
439
+
440
+ ```sh
441
+ v-cli art style create
442
+ ```
443
+
444
+ - `--project <id>`:工程身份
445
+ - `--input <file>`:结构化配置文件
446
+
447
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
448
+
449
+ ## style list
450
+
451
+ 列出工程对象及任务展示状态
452
+
453
+ ```sh
454
+ v-cli art style list
455
+ ```
456
+
457
+ - `--project <id>`:工程身份
458
+
459
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
460
+
461
+ ## style read
462
+
463
+ 读取指定对象与版本
464
+
465
+ ```sh
466
+ v-cli art style read
467
+ ```
468
+
469
+ - `--project <id>`:工程身份
470
+ - `--id <id>`:对象身份
471
+
472
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
473
+
474
+ ## style update
475
+
476
+ 校验预期版本及空闲状态后更新对象
477
+
478
+ ```sh
479
+ v-cli art style update
480
+ ```
481
+
482
+ - `--project <id>`:工程身份
483
+ - `--id <id>`:对象身份
484
+ - `--revision <number>`:预期对象版本
485
+ - `--input <file>`:结构化配置文件
486
+
487
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
488
+
489
+ ## style derive
490
+
491
+ 派生独立草稿,不继承执行、报告或定版
492
+
493
+ ```sh
494
+ v-cli art style derive
495
+ ```
496
+
497
+ - `--project <id>`:工程身份
498
+ - `--id <id>`:对象身份
499
+ - `--revision <number>`:预期对象版本
500
+
501
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
502
+
503
+ ## style discard
504
+
505
+ 确认空闲后丢弃草稿并清理所属资源
506
+
507
+ ```sh
508
+ v-cli art style discard
509
+ ```
510
+
511
+ - `--project <id>`:工程身份
512
+ - `--id <id>`:对象身份
513
+ - `--revision <number>`:预期对象版本
514
+
515
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
516
+
517
+ ## job create
518
+
519
+ 创建独立草稿对象
520
+
521
+ ```sh
522
+ v-cli art job create
523
+ ```
524
+
525
+ - `--project <id>`:工程身份
526
+ - `--input <file>`:结构化配置文件
527
+
528
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
529
+
530
+ ## job list
531
+
532
+ 列出工程对象及任务展示状态
533
+
534
+ ```sh
535
+ v-cli art job list
536
+ ```
537
+
538
+ - `--project <id>`:工程身份
539
+
540
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
541
+
542
+ ## job read
543
+
544
+ 读取指定对象与版本
545
+
546
+ ```sh
547
+ v-cli art job read
548
+ ```
549
+
550
+ - `--project <id>`:工程身份
551
+ - `--id <id>`:对象身份
552
+
553
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
554
+
555
+ ## job update
556
+
557
+ 校验预期版本及空闲状态后更新对象
558
+
559
+ ```sh
560
+ v-cli art job update
561
+ ```
562
+
563
+ - `--project <id>`:工程身份
564
+ - `--id <id>`:对象身份
565
+ - `--revision <number>`:预期对象版本
566
+ - `--input <file>`:结构化配置文件
567
+
568
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
569
+
570
+ ## job derive
571
+
572
+ 派生独立草稿,不继承执行、报告或定版
573
+
574
+ ```sh
575
+ v-cli art job derive
576
+ ```
577
+
578
+ - `--project <id>`:工程身份
579
+ - `--id <id>`:对象身份
580
+ - `--revision <number>`:预期对象版本
581
+
582
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
583
+
584
+ ## job discard
585
+
586
+ 确认空闲后丢弃草稿并清理所属资源
587
+
588
+ ```sh
589
+ v-cli art job discard
590
+ ```
591
+
592
+ - `--project <id>`:工程身份
593
+ - `--id <id>`:对象身份
594
+ - `--revision <number>`:预期对象版本
595
+
596
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
597
+
598
+ ## style adopt
599
+
600
+ 采用当前有效报告并冻结
601
+
602
+ ```sh
603
+ v-cli art style adopt
604
+ ```
605
+
606
+ - `--project <id>`:工程身份
607
+ - `--id <id>`:对象身份
608
+ - `--revision <number>`:预期对象版本
609
+ - `--note <text>`:采用说明
610
+
611
+ - 来源匹配且冲突已解决;采用事务可恢复,核心只写一次
612
+
613
+ ## style recover
614
+
615
+ 恢复已授权采用事务
616
+
617
+ ```sh
618
+ v-cli art style recover
619
+ ```
620
+
621
+ - `--project <id>`:工程身份
622
+ - `--id <id>`:对象身份
623
+
624
+ - 不重新调用模型;核验核心和事务身份后完成状态提交
625
+
626
+ ## project init
627
+
628
+ 新建版本 2 工程
629
+
630
+ ```sh
631
+ v-cli art project init
632
+ ```
633
+
634
+ - `--project <id>`:工程身份
635
+ - `--input <file>`:结构化配置文件
636
+
637
+ - 工程存在拒绝覆写
638
+
639
+ ## project upgrade
640
+
641
+ 显式一次性工程升级
642
+
643
+ ```sh
644
+ v-cli art project upgrade
645
+ ```
646
+
647
+ - `--project <id>`:工程身份
648
+ - `--dry`:预检
649
+ - `--mapping <file>`:旧共享参考的明确归属映射
650
+
651
+ - 备份和原子替换,失败回滚;不猜参考归属
652
+
653
+ ## reference list
654
+
655
+ 查看对象参考
656
+
657
+ ```sh
658
+ v-cli art reference list
659
+ ```
660
+
661
+ - `--project <id>`:工程身份
662
+ - `--kind <style|task>`:对象粒度
663
+ - `--id <id>`:对象身份
664
+
665
+ - 只读
666
+
667
+ ## reference import
668
+
669
+ 导入对象私有图片
670
+
671
+ ```sh
672
+ v-cli art reference import
673
+ ```
674
+
675
+ - `--project <id>`:工程身份
676
+ - `--kind <style|task>`:对象粒度
677
+ - `--id <id>`:对象身份
678
+ - `--revision <number>`:预期对象版本
679
+ - `--source <file>`:用户原图
680
+ - `--category <name>`:四类静态参考之一
681
+ - `--purposes <list>`:逗号分隔动态用途
682
+ - `--note <text>`:参考说明
683
+
684
+ - 校验图片、大小、路径;复制不修改原图;不支持直接参考时拒绝
685
+
686
+ ## reference remove
687
+
688
+ 移除参考关联
689
+
690
+ ```sh
691
+ v-cli art reference remove
692
+ ```
693
+
694
+ - `--project <id>`:工程身份
695
+ - `--kind <style|task>`:对象粒度
696
+ - `--id <id>`:对象身份
697
+ - `--revision <number>`:预期对象版本
698
+ - `--item <id>`:参考身份
699
+
700
+ - 移除关联,保留历史证据资源
701
+
702
+ ## candidate list
703
+
704
+ 查看真实候选及完整性
705
+
706
+ ```sh
707
+ v-cli art candidate list
708
+ ```
709
+
710
+ - `--project <id>`:工程身份
711
+ - `--job <id>`:配置任务身份
712
+ - `--run <id>`:执行批次身份
713
+
714
+ - 只读;校验批次计划和候选身份
715
+
716
+ ## candidate finalizations
717
+
718
+ 查看资产定版
719
+
720
+ ```sh
721
+ v-cli art candidate finalizations
722
+ ```
723
+
724
+ - `--project <id>`:工程身份
725
+ - `--job <id>`:配置任务身份
726
+
727
+ - 只读
728
+
729
+ ## candidate finalize
730
+
731
+ 按资产定版候选
732
+
733
+ ```sh
734
+ v-cli art candidate finalize
735
+ ```
736
+
737
+ - `--project <id>`:工程身份
738
+ - `--job <id>`:配置任务身份
739
+ - `--run <id>`:执行批次身份
740
+ - `--revision <number>`:预期对象版本
741
+ - `--candidate <id>`:候选身份
742
+ - `--actor <text>`:操作者
743
+ - `--replace`:明确替换已有定版
744
+
745
+ - 生成完成与哈希有效;重复幂等,替换保留历史
746
+
747
+ ## candidate delete
748
+
749
+ 删除候选及关联定版
750
+
751
+ ```sh
752
+ v-cli art candidate delete
753
+ ```
754
+
755
+ - `--project <id>`:工程身份
756
+ - `--job <id>`:配置任务身份
757
+ - `--run <id>`:执行批次身份
758
+ - `--revision <number>`:预期对象版本
759
+ - `--candidate <id>`:候选身份
760
+ - `--actor <text>`:操作者
761
+ - `--confirm`:明确确认删除影响
762
+
763
+ - 运行和引用检查;先持久化删除记录,再清理私有文件
764
+
765
+ ## job analyze
766
+
767
+ 分析任务动态参考,仅转写指定用途,不继承静态风格
768
+
769
+ ```sh
770
+ v-cli art job analyze
771
+ ```
772
+
773
+ - `--project <id>`:工程身份
774
+ - `--id <id>`:对象身份
775
+ - `--revision <number>`:预期对象版本
776
+ - `--dry`:只读编译预演
777
+ - `--operation <id>`:分析启动前登记的稳定操作身份
778
+
779
+ - dry 不联网、不写参考目录;执行创建运行身份和不可变参考证据;远程停止不确定时保留资源
780
+
781
+ ## task recover
782
+
783
+ 仅从唯一原运行登记恢复身份;绝不重新执行
784
+
785
+ ```sh
786
+ v-cli art task recover --project P --operation OPERATION
787
+ ```
788
+
789
+ - `--project <id>`:原工程身份
790
+ - `--operation <id>`:启动前持久化的原操作身份
791
+
792
+ - 读取外部运行状态
793
+
794
+ ## reference update
795
+
796
+ 更新参考分类、任务用途与说明,版本校验并使分析失效
797
+
798
+ ```sh
799
+ v-cli art reference update --project P --kind style --id ID --revision N --item REF --input PATCH.json
800
+ ```
801
+
802
+ - `--project <id>`:工程身份
803
+ - `--kind <kind>`:style 或 task
804
+ - `--id <id>`:对象身份
805
+ - `--revision <number>`:预期版本
806
+ - `--item <id>`:参考身份
807
+ - `--input <file>`:category/purposes/note/ignore 的字段补丁
808
+
809
+ - 冻结风格只读;任务不允许静态分类;不修改用户原图;旧证据保留
810
+
811
+ ## deployment plan
812
+
813
+ 固定 Qwen 2.1 部署 plan
814
+
815
+ ```sh
816
+ v-cli art deployment plan
817
+ ```
818
+
819
+ - `--directory <dir>`:本机部署根目录
820
+ - `--endpoint <url>`:本机 ComfyUI 地址
821
+ - `--out <file>`:保存不可变预案
822
+
823
+ - 只读检测与预案;不下载、不启动、不采样
824
+
825
+ ## deployment start
826
+
827
+ 固定 Qwen 2.1 部署 start
828
+
829
+ ```sh
830
+ v-cli art deployment start
831
+ ```
832
+
833
+ - `--plan <file>`:实际冻结部署预案
834
+ - `--operation <id>`:稳定操作身份
835
+
836
+ - 下载、源码安装、独立环境、模型哈希验证、生成及编辑采样;不覆写既有不匹配文件
837
+
838
+ ## deployment status
839
+
840
+ 固定 Qwen 2.1 部署 status
841
+
842
+ ```sh
843
+ v-cli art deployment status
844
+ ```
845
+
846
+ - `--id <id>`:原部署身份
847
+
848
+ - 只查询原部署,不重复启动
849
+
850
+ ## deployment cancel
851
+
852
+ 固定 Qwen 2.1 部署 cancel
853
+
854
+ ```sh
855
+ v-cli art deployment cancel
856
+ ```
857
+
858
+ - `--id <id>`:原部署身份
859
+
860
+ - 请求取消;仅停止已核验子进程与本部署采样,确认后释放安装占用
861
+
862
+ ## deployment recover
863
+
864
+ 查询唯一原部署回执,不重新执行
865
+
866
+ ```sh
867
+ v-cli art deployment recover
868
+ ```
869
+
870
+ - `--operation <id>`:启动前登记的稳定身份
871
+
872
+ - 只读;无法唯一核验时停止未知
873
+
874
+ ## job template
875
+
876
+ 只读返回工具权威的任务配置模板;生成任务使用已冻结核心的题材
877
+
878
+ ```sh
879
+ v-cli art job template --project <id> --kind <generate|edit> [--core <id>]
880
+ ```
881
+
882
+ - `--project <id>`:工程身份
883
+ - `--kind <generate|edit>`:任务类型
884
+ - `--core <id>`:生成任务的冻结核心身份
885
+
886
+ - 只读返回模板;不创建任务或文件
887
+
888
+ ## job from-candidate
889
+
890
+ 将完整候选导入私有底图,创建独立编辑草稿,不运行
891
+
892
+ ```sh
893
+ v-cli art job from-candidate --project <id> --id <task> --run <id> --candidate <id>
894
+ ```
895
+
896
+ - `--project <id>`:工程身份
897
+ - `--id <task>`:源任务身份
898
+ - `--run <id>`:真实批次
899
+ - `--candidate <id>`:完整候选身份
900
+
901
+ - 写入新的编辑草稿和私有底图;保留候选来源;不启动生成
902
+
903
+ ## task resume
904
+
905
+ 仅恢复原上游任务的查询和下载,绝不重新提交
906
+
907
+ ```sh
908
+ v-cli art task resume TASK
909
+ ```
910
+
911
+ - 位置参数 `TASK`:art 任务 ID(必填)
912
+
913
+ - 写入原任务状态
914
+ - 查询原上游任务并下载已有产物
915
+ - 提交结果未知时拒绝恢复