@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
package/v-cli.plugin.json CHANGED
@@ -3,15 +3,15 @@
3
3
  "package": "@kevlns/art-workshop",
4
4
  "command": "art",
5
5
  "bin": "art-workshop",
6
- "description": "美术工坊:多工程风格分析与核心冻结、统一风格文生图及图编辑,支持计划预演与人工验收。",
6
+ "description": "美术工坊:版本化风格/任务、参考管理、预演、后台执行、停止确认与定版。",
7
7
  "platforms": [
8
8
  "win32",
9
9
  "linux",
10
10
  "darwin"
11
11
  ],
12
12
  "runtime": {
13
- "node": ">=20",
14
- "imageProvider": "bl CLI for remote analysis/generation"
13
+ "node": ">=20.9",
14
+ "imageProvider": "bailian CLI or lazy ComfyUI backend; task lifecycle and shutdown"
15
15
  },
16
16
  "environment": [
17
17
  {
@@ -24,7 +24,7 @@
24
24
  }
25
25
  ],
26
26
  "agent": {
27
- "whenToUse": "视觉风格分析与冻结、基于正确工程核心生成统一风格图片、按修改与保留计划编辑现有图片,或查看 refs 分类、预演与验收。先 config show 和 agent index 选择工程,远程分析及生图须有任务授权。",
27
+ "whenToUse": "先读取对象和版本,编译并预演后在授权范围后台执行。风格分析有独立运行身份,采用检查报告来源;任务空闲才可编辑,停止未确认保留资源。生成完成仅做技术完整性校验,用户定版,不要求人工三维评分。",
28
28
  "globalOptions": [
29
29
  {
30
30
  "flags": "--config <file>",
@@ -36,7 +36,7 @@
36
36
  },
37
37
  {
38
38
  "flags": "--output-dir <dir>",
39
- "description": "外部产物目录,默认系统下载目录/image.g"
39
+ "description": "产物根目录;默认与 workspace 相同,Vant 显式绑定工程 .vant/art"
40
40
  },
41
41
  {
42
42
  "flags": "--refs-dir <dir>",
@@ -73,8 +73,7 @@
73
73
  "1": "参数、配置、计划或执行失败"
74
74
  },
75
75
  "safety": [
76
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
77
- "无网络调用"
76
+ "无配置读取、目录初始化、网络或模型调用"
78
77
  ]
79
78
  },
80
79
  {
@@ -95,7 +94,7 @@
95
94
  "1": "参数、配置、计划或执行失败"
96
95
  },
97
96
  "safety": [
98
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
97
+ "查询与预演不创建参考目录",
99
98
  "无网络调用"
100
99
  ]
101
100
  },
@@ -117,7 +116,7 @@
117
116
  "1": "参数、配置、计划或执行失败"
118
117
  },
119
118
  "safety": [
120
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
119
+ "查询与预演不创建参考目录",
121
120
  "无网络调用"
122
121
  ]
123
122
  },
@@ -139,7 +138,7 @@
139
138
  "1": "参数、配置、计划或执行失败"
140
139
  },
141
140
  "safety": [
142
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
141
+ "查询与预演不创建参考目录",
143
142
  "无网络调用",
144
143
  "写入外部本地配置"
145
144
  ]
@@ -167,7 +166,7 @@
167
166
  "1": "参数、配置、计划或执行失败"
168
167
  },
169
168
  "safety": [
170
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
169
+ "查询与预演不创建参考目录",
171
170
  "无网络调用"
172
171
  ]
173
172
  },
@@ -189,7 +188,7 @@
189
188
  "1": "参数、配置、计划或执行失败"
190
189
  },
191
190
  "safety": [
192
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
191
+ "查询与预演不创建参考目录",
193
192
  "无网络调用"
194
193
  ]
195
194
  },
@@ -199,19 +198,19 @@
199
198
  "docs"
200
199
  ],
201
200
  "usage": "art-workshop agent docs",
202
- "description": "输出完整使用规范与核心冻结指导",
201
+ "description": "输出全部随包模式、配置、工程、命令、诊断与核心指南",
203
202
  "arguments": [],
204
203
  "options": [],
205
204
  "output": {
206
205
  "format": "text",
207
- "description": "输出完整使用规范与核心冻结指导"
206
+ "description": "输出全部随包模式、配置、工程、命令、诊断与核心指南"
208
207
  },
209
208
  "exitCodes": {
210
209
  "0": "成功;验收状态以返回内容为准",
211
210
  "1": "参数、配置、计划或执行失败"
212
211
  },
213
212
  "safety": [
214
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
213
+ "查询与预演不创建参考目录",
215
214
  "无网络调用"
216
215
  ]
217
216
  },
@@ -230,7 +229,7 @@
230
229
  },
231
230
  {
232
231
  "flags": "--dry",
233
- "description": "预演,不调用远程模型;仍补齐 refs 分类目录"
232
+ "description": "只读预演,不联网、不创建参考目录"
234
233
  }
235
234
  ],
236
235
  "output": {
@@ -242,7 +241,7 @@
242
241
  "1": "参数、配置、计划或执行失败"
243
242
  },
244
243
  "safety": [
245
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
244
+ "查询与预演不创建参考目录",
246
245
  "无网络调用",
247
246
  "覆盖同名随包 skill 和 runtime.json,保留扩展文件"
248
247
  ]
@@ -264,7 +263,7 @@
264
263
  "1": "参数、配置、计划或执行失败"
265
264
  },
266
265
  "safety": [
267
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
266
+ "查询与预演不创建参考目录",
268
267
  "无网络调用"
269
268
  ]
270
269
  },
@@ -273,40 +272,41 @@
273
272
  "style",
274
273
  "analyze"
275
274
  ],
276
- "usage": "art-workshop style analyze [--project <id>] [--input <file>] [--out <file>] [--dry]",
277
- "description": "通过具备视觉能力的模型生成风格报告与推荐配置",
275
+ "usage": "art-workshop style analyze",
276
+ "description": "草稿风格后台分析",
278
277
  "arguments": [],
279
278
  "options": [
280
279
  {
281
280
  "flags": "--project <id>",
282
- "description": "工程 ID;未指定时使用本地 defaultProject,不跨工程回退"
281
+ "description": "工程身份"
283
282
  },
284
283
  {
285
- "flags": "--input <file>",
286
- "description": "分析输入 JSON,引用图片按 refs 解析"
284
+ "flags": "--id <id>",
285
+ "description": "对象身份"
287
286
  },
288
287
  {
289
- "flags": "--out <file>",
290
- "description": "可选外部输出文件;相对路径基于 workspace"
288
+ "flags": "--revision <number>",
289
+ "description": "预期对象版本"
291
290
  },
292
291
  {
293
292
  "flags": "--dry",
294
- "description": "预演,不调用远程模型;仍补齐 refs 分类目录"
293
+ "description": "只读编译预演"
294
+ },
295
+ {
296
+ "flags": "--operation <id>",
297
+ "description": "分析启动前登记的稳定操作身份"
295
298
  }
296
299
  ],
297
300
  "output": {
298
301
  "format": "json",
299
- "description": "通过具备视觉能力的模型生成风格报告与推荐配置"
302
+ "description": "草稿风格后台分析"
300
303
  },
301
304
  "exitCodes": {
302
- "0": "成功;验收状态以返回内容为准",
303
- "1": "参数、配置、计划或执行失败"
305
+ "0": "成功",
306
+ "1": "校验、版本冲突或执行失败"
304
307
  },
305
308
  "safety": [
306
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
307
- "非 dry 会调用远程模型并产生费用",
308
- "非 dry 可写入外部报告和分析缓存",
309
- "不自动冻结核心"
309
+ "dry 不联网、不写参考目录;执行创建运行身份和不可变参考证据;远程停止不确定时保留资源"
310
310
  ]
311
311
  },
312
312
  {
@@ -336,44 +336,7 @@
336
336
  "1": "参数、配置、计划或执行失败"
337
337
  },
338
338
  "safety": [
339
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
340
- "无网络调用"
341
- ]
342
- },
343
- {
344
- "path": [
345
- "style",
346
- "freeze"
347
- ],
348
- "usage": "art-workshop style freeze [--project <id>] [--report <file>] [--note <text>]",
349
- "description": "采用报告并冻结核心,将核心绑定到当前工程",
350
- "arguments": [],
351
- "options": [
352
- {
353
- "flags": "--project <id>",
354
- "description": "工程 ID;未指定时使用本地 defaultProject,不跨工程回退"
355
- },
356
- {
357
- "flags": "--report <file>",
358
- "description": "风格报告 JSON,相对路径基于 workspace"
359
- },
360
- {
361
- "flags": "--note <text>",
362
- "description": "冻结备注"
363
- }
364
- ],
365
- "output": {
366
- "format": "json",
367
- "description": "采用报告并冻结核心,将核心绑定到当前工程"
368
- },
369
- "exitCodes": {
370
- "0": "成功;验收状态以返回内容为准",
371
- "1": "参数、配置、计划或执行失败"
372
- },
373
- "safety": [
374
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
375
- "须有用户采用报告的授权",
376
- "写入外部工程核心和 project.json,拒绝覆写已有核心",
339
+ "查询与预演不创建参考目录",
377
340
  "无网络调用"
378
341
  ]
379
342
  },
@@ -404,7 +367,7 @@
404
367
  "1": "参数、配置、计划或执行失败"
405
368
  },
406
369
  "safety": [
407
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
370
+ "查询与预演不创建参考目录",
408
371
  "无网络调用"
409
372
  ]
410
373
  },
@@ -435,7 +398,7 @@
435
398
  "1": "参数、配置、计划或执行失败"
436
399
  },
437
400
  "safety": [
438
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
401
+ "查询与预演不创建参考目录",
439
402
  "无网络调用"
440
403
  ]
441
404
  },
@@ -463,6 +426,10 @@
463
426
  {
464
427
  "flags": "--out <file>",
465
428
  "description": "可选外部输出文件;相对路径基于 workspace"
429
+ },
430
+ {
431
+ "flags": "--backend <id>",
432
+ "description": "新计划选择配置中的远程/本地后端 ID;冻结计划不能覆盖"
466
433
  }
467
434
  ],
468
435
  "output": {
@@ -474,7 +441,7 @@
474
441
  "1": "参数、配置、计划或执行失败"
475
442
  },
476
443
  "safety": [
477
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
444
+ "查询与预演不创建参考目录",
478
445
  "无网络调用",
479
446
  "指定 out 时写入外部计划文件"
480
447
  ]
@@ -526,7 +493,27 @@
526
493
  },
527
494
  {
528
495
  "flags": "--dry",
529
- "description": "预演,不调用远程模型;仍补齐 refs 分类目录"
496
+ "description": "只读预演所选请求;不联网、不启动服务、不上传、不创建参考目录"
497
+ },
498
+ {
499
+ "flags": "--backend <id>",
500
+ "description": "选择统一配置中的后端;冻结计划不允许覆盖"
501
+ },
502
+ {
503
+ "flags": "--background",
504
+ "description": "后台执行并返回 taskId"
505
+ },
506
+ {
507
+ "flags": "--all-variants",
508
+ "description": "执行冻结预案中的全部构图候选;不能与 --variant 同用"
509
+ },
510
+ {
511
+ "flags": "--retry-run <id>",
512
+ "description": "原批次停止已确认后,仅重试明确失败项;成功项不重做"
513
+ },
514
+ {
515
+ "flags": "--operation <id>",
516
+ "description": "启动前持久化的稳定操作身份;丢失回执时按原身份 recover"
530
517
  }
531
518
  ],
532
519
  "output": {
@@ -538,10 +525,11 @@
538
525
  "1": "参数、配置、计划或执行失败"
539
526
  },
540
527
  "safety": [
541
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
542
- "非 dry 调用远程模型并产生费用,需任务授权",
543
- "真实执行写入外部图片及 manifest",
544
- "预演展示请求,不生成图片"
528
+ "查询与预演不创建参考目录",
529
+ "远程非 dry 通过登记的协议适配器调用模型,可能产生费用,按已有任务授权执行",
530
+ "本地非 dry 可启动任务和 ComfyUI 服务并采样,不调用百炼生图",
531
+ "真实执行写入外部图片、manifest、任务状态和诊断",
532
+ "dry 只展示请求,不启动或探测服务、不上传、不生成图片"
545
533
  ]
546
534
  },
547
535
  {
@@ -571,7 +559,7 @@
571
559
  "1": "参数、配置、计划或执行失败"
572
560
  },
573
561
  "safety": [
574
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
562
+ "查询与预演不创建参考目录",
575
563
  "无网络调用"
576
564
  ]
577
565
  },
@@ -599,6 +587,10 @@
599
587
  {
600
588
  "flags": "--out <file>",
601
589
  "description": "可选外部输出文件;相对路径基于 workspace"
590
+ },
591
+ {
592
+ "flags": "--backend <id>",
593
+ "description": "新计划选择配置中的远程/本地后端 ID;冻结计划不能覆盖"
602
594
  }
603
595
  ],
604
596
  "output": {
@@ -610,7 +602,7 @@
610
602
  "1": "参数、配置、计划或执行失败"
611
603
  },
612
604
  "safety": [
613
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
605
+ "查询与预演不创建参考目录",
614
606
  "无网络调用",
615
607
  "指定 out 时写入外部计划文件"
616
608
  ]
@@ -662,7 +654,27 @@
662
654
  },
663
655
  {
664
656
  "flags": "--dry",
665
- "description": "预演,不调用远程模型;仍补齐 refs 分类目录"
657
+ "description": "只读预演所选请求;不联网、不启动服务、不上传、不创建参考目录"
658
+ },
659
+ {
660
+ "flags": "--backend <id>",
661
+ "description": "选择统一配置中的后端;冻结计划不允许覆盖"
662
+ },
663
+ {
664
+ "flags": "--background",
665
+ "description": "后台执行并返回 taskId"
666
+ },
667
+ {
668
+ "flags": "--all-variants",
669
+ "description": "执行冻结预案中的全部构图候选;不能与 --variant 同用"
670
+ },
671
+ {
672
+ "flags": "--retry-run <id>",
673
+ "description": "原批次停止已确认后,仅重试明确失败项;成功项不重做"
674
+ },
675
+ {
676
+ "flags": "--operation <id>",
677
+ "description": "启动前持久化的稳定操作身份;丢失回执时按原身份 recover"
666
678
  }
667
679
  ],
668
680
  "output": {
@@ -674,18 +686,19 @@
674
686
  "1": "参数、配置、计划或执行失败"
675
687
  },
676
688
  "safety": [
677
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
678
- "非 dry 调用远程模型并产生费用,需任务授权",
679
- "真实执行写入外部图片及 manifest",
680
- "预演展示请求,不生成图片"
689
+ "查询与预演不创建参考目录",
690
+ "远程非 dry 通过登记的协议适配器调用模型,可能产生费用,按已有任务授权执行",
691
+ "本地非 dry 可启动任务和 ComfyUI 服务并采样,不调用百炼生图",
692
+ "真实执行写入外部图片、manifest、任务状态和诊断",
693
+ "dry 只展示请求,不启动或探测服务、不上传、不生成图片"
681
694
  ]
682
695
  },
683
696
  {
684
697
  "path": [
685
698
  "check"
686
699
  ],
687
- "usage": "art-workshop check RUN [--review <file>] [--out <file>]",
688
- "description": "导出或汇总人工验收;不自动评价图片",
700
+ "usage": "art-workshop check RUN",
701
+ "description": "核验运行计划、执行归属、产物与文件哈希;不进行人工评分",
689
702
  "arguments": [
690
703
  {
691
704
  "name": "RUN",
@@ -693,105 +706,1441 @@
693
706
  "required": true
694
707
  }
695
708
  ],
696
- "options": [
709
+ "options": [],
710
+ "output": {
711
+ "format": "json",
712
+ "description": "核验运行计划、执行归属、产物与文件哈希;不进行人工评分"
713
+ },
714
+ "exitCodes": {
715
+ "0": "成功;验收状态以返回内容为准",
716
+ "1": "参数、配置、计划或执行失败"
717
+ },
718
+ "safety": [
719
+ "只读;不调用模型、不写入评分或定版记录"
720
+ ]
721
+ },
722
+ {
723
+ "path": [
724
+ "compare"
725
+ ],
726
+ "usage": "art-workshop compare BEFORE AFTER",
727
+ "description": "比较两份计划或执行记录的核心、执行配置和单体变更",
728
+ "arguments": [
697
729
  {
698
- "flags": "--review <file>",
699
- "description": "人工 review JSON"
730
+ "name": "BEFORE",
731
+ "description": "前一份计划/执行记录 JSON,按 workspace 解析",
732
+ "required": true
700
733
  },
701
734
  {
702
- "flags": "--out <file>",
703
- "description": "可选外部输出文件;相对路径基于 workspace"
735
+ "name": "AFTER",
736
+ "description": "后一份计划/执行记录 JSON,按 workspace 解析",
737
+ "required": true
704
738
  }
705
739
  ],
740
+ "options": [],
706
741
  "output": {
707
742
  "format": "json",
708
- "description": "导出或汇总人工验收;不自动评价图片"
743
+ "description": "比较两份计划或执行记录的核心、执行配置和单体变更"
709
744
  },
710
745
  "exitCodes": {
711
746
  "0": "成功;验收状态以返回内容为准",
712
747
  "1": "参数、配置、计划或执行失败"
713
748
  },
714
749
  "safety": [
715
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
716
- "无网络调用",
717
- "指定 out 时写入外部验收文件"
750
+ "查询与预演不创建参考目录",
751
+ "无网络调用"
752
+ ]
753
+ },
754
+ {
755
+ "path": [
756
+ "task",
757
+ "list"
758
+ ],
759
+ "usage": "art-workshop task list",
760
+ "description": "列出任务状态",
761
+ "arguments": [],
762
+ "options": [
763
+ {
764
+ "flags": "--project <id>",
765
+ "description": "仅列出指定工程运行"
766
+ }
767
+ ],
768
+ "output": {
769
+ "format": "json",
770
+ "description": "列出任务状态"
771
+ },
772
+ "exitCodes": {
773
+ "0": "成功",
774
+ "1": "失败;未确认停止时保留服务并报告"
775
+ },
776
+ "safety": [
777
+ "读取外部运行状态"
718
778
  ]
719
779
  },
720
780
  {
721
781
  "path": [
722
- "select"
782
+ "task",
783
+ "status"
723
784
  ],
724
- "usage": "art-workshop select RUN [--item <id>] [--variant <id>] [--review <file>] [--file <path>]",
725
- "description": "选择完整性有效且 content/style/asset 全部通过的唯一产物",
785
+ "usage": "art-workshop task status TASK",
786
+ "description": "查看单次任务及后端 prompt_id",
726
787
  "arguments": [
727
788
  {
728
- "name": "RUN",
729
- "description": "运行目录或 manifest 路径,按 output 解析",
730
- "required": true
789
+ "name": "TASK",
790
+ "required": true,
791
+ "description": "art 任务 ID"
792
+ }
793
+ ],
794
+ "options": [],
795
+ "output": {
796
+ "format": "json",
797
+ "description": "查看单次任务及后端 prompt_id"
798
+ },
799
+ "exitCodes": {
800
+ "0": "成功",
801
+ "1": "失败;未确认停止时保留服务并报告"
802
+ },
803
+ "safety": [
804
+ "读取外部运行状态"
805
+ ]
806
+ },
807
+ {
808
+ "path": [
809
+ "task",
810
+ "wait"
811
+ ],
812
+ "usage": "art-workshop task wait TASK",
813
+ "description": "等待任务结束;超时不取消任务",
814
+ "arguments": [
815
+ {
816
+ "name": "TASK",
817
+ "required": true,
818
+ "description": "art 任务 ID"
731
819
  }
732
820
  ],
733
821
  "options": [
734
822
  {
735
- "flags": "--item <id>",
736
- "description": "必须指定单体"
737
- },
823
+ "flags": "--timeout <seconds>",
824
+ "description": "等待秒数,默认 3600"
825
+ }
826
+ ],
827
+ "output": {
828
+ "format": "json",
829
+ "description": "等待任务结束;超时不取消任务"
830
+ },
831
+ "exitCodes": {
832
+ "0": "成功",
833
+ "1": "失败;未确认停止时保留服务并报告"
834
+ },
835
+ "safety": [
836
+ "读取外部运行状态"
837
+ ]
838
+ },
839
+ {
840
+ "path": [
841
+ "task",
842
+ "cancel"
843
+ ],
844
+ "usage": "art-workshop task cancel TASK",
845
+ "description": "取消单次任务并等待停止",
846
+ "arguments": [
738
847
  {
739
- "flags": "--variant <id>",
740
- "description": "必须指定候选"
741
- },
848
+ "name": "TASK",
849
+ "required": true,
850
+ "description": "art 任务 ID"
851
+ }
852
+ ],
853
+ "options": [],
854
+ "output": {
855
+ "format": "json",
856
+ "description": "取消单次任务并等待停止"
857
+ },
858
+ "exitCodes": {
859
+ "0": "成功",
860
+ "1": "失败;未确认停止时保留服务并报告"
861
+ },
862
+ "safety": [
863
+ "取消单个任务",
864
+ "按 prompt_id 中断本地任务",
865
+ "保留服务进程"
866
+ ]
867
+ },
868
+ {
869
+ "path": [
870
+ "shutdown"
871
+ ],
872
+ "usage": "art-workshop shutdown",
873
+ "description": "停止当前工作区关联任务,核验共享队列和进程身份后关闭服务",
874
+ "arguments": [],
875
+ "options": [],
876
+ "output": {
877
+ "format": "json",
878
+ "description": "停止当前工作区关联任务,核验共享队列和进程身份后关闭服务"
879
+ },
880
+ "exitCodes": {
881
+ "0": "成功",
882
+ "1": "失败;未确认停止时保留服务并报告"
883
+ },
884
+ "safety": [
885
+ "停止配置范围内所有任务",
886
+ "只取消关联任务;共享队列仍有其他任务时保留服务",
887
+ "核验进程身份后关闭服务",
888
+ "阻止 shutdown 期间的新任务"
889
+ ]
890
+ },
891
+ {
892
+ "path": [
893
+ "config",
894
+ "validate"
895
+ ],
896
+ "usage": "art-workshop config validate",
897
+ "description": "校验配置和 API workflow 的结构、连接与参数绑定",
898
+ "arguments": [],
899
+ "options": [
900
+ {
901
+ "flags": "--backend <id>",
902
+ "description": "仅检查指定后端"
903
+ }
904
+ ],
905
+ "output": {
906
+ "format": "json",
907
+ "description": "校验配置和 API workflow 的结构、连接与参数绑定"
908
+ },
909
+ "exitCodes": {
910
+ "0": "检查通过",
911
+ "1": "检查失败"
912
+ },
913
+ "safety": [
914
+ "只读校验,不启动服务、不调用模型"
915
+ ]
916
+ },
917
+ {
918
+ "path": [
919
+ "doctor"
920
+ ],
921
+ "usage": "art-workshop doctor",
922
+ "description": "检测本地 ComfyUI 环境、节点与模型",
923
+ "arguments": [],
924
+ "options": [
742
925
  {
743
- "flags": "--review <file>",
744
- "description": "人工 review JSON"
926
+ "flags": "--backend <id>",
927
+ "description": "仅检查指定后端"
745
928
  },
746
929
  {
747
- "flags": "--file <path>",
748
- "description": "选择记录内的图片文件"
930
+ "flags": "--start",
931
+ "description": "无可用服务时按配置启动;不采样,检查后服务保留"
749
932
  }
750
933
  ],
751
934
  "output": {
752
935
  "format": "json",
753
- "description": "选择完整性有效且 content/style/asset 全部通过的唯一产物"
936
+ "description": "检测本地 ComfyUI 环境、节点与模型"
754
937
  },
755
938
  "exitCodes": {
756
- "0": "成功;验收状态以返回内容为准",
757
- "1": "参数、配置、计划或执行失败"
939
+ "0": "检查通过",
940
+ "1": "检查失败"
758
941
  },
759
942
  "safety": [
760
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
761
- "无网络调用",
762
- "写回外部 manifest 的验收与选择记录"
943
+ "默认读取本地环境,不启动、不采样、不补齐 refs",
944
+ "--start 可启动并保留服务,写状态与日志;不采样",
945
+ "远程后端只校验配置,不检查认证或云端连通性"
763
946
  ]
764
947
  },
765
948
  {
766
949
  "path": [
767
- "compare"
950
+ "workflow",
951
+ "list"
768
952
  ],
769
- "usage": "art-workshop compare BEFORE AFTER",
770
- "description": "比较两份计划或执行记录的核心、执行配置和单体变更",
771
- "arguments": [
953
+ "usage": "art-workshop workflow list",
954
+ "description": "列出默认内置工作流及 API/UI 文件位置",
955
+ "arguments": [],
956
+ "options": [],
957
+ "output": {
958
+ "format": "json",
959
+ "description": "列出默认内置工作流及 API/UI 文件位置"
960
+ },
961
+ "exitCodes": {
962
+ "0": "检查通过",
963
+ "1": "检查失败"
964
+ },
965
+ "safety": [
966
+ "读取随包工作流清单,不依赖合法用户配置、不补 refs、不调用模型"
967
+ ]
968
+ },
969
+ {
970
+ "path": [
971
+ "style",
972
+ "create"
973
+ ],
974
+ "usage": "art-workshop style create",
975
+ "description": "创建独立草稿对象",
976
+ "arguments": [],
977
+ "options": [
772
978
  {
773
- "name": "BEFORE",
774
- "description": "前一份计划/执行记录 JSON,按 workspace 解析",
775
- "required": true
979
+ "flags": "--project <id>",
980
+ "description": "工程身份"
776
981
  },
777
982
  {
778
- "name": "AFTER",
779
- "description": "后一份计划/执行记录 JSON,按 workspace 解析",
780
- "required": true
983
+ "flags": "--input <file>",
984
+ "description": "结构化配置文件"
781
985
  }
782
986
  ],
783
- "options": [],
784
987
  "output": {
785
988
  "format": "json",
786
- "description": "比较两份计划或执行记录的核心、执行配置和单体变更"
989
+ "description": "创建独立草稿对象"
787
990
  },
788
991
  "exitCodes": {
789
- "0": "成功;验收状态以返回内容为准",
790
- "1": "参数、配置、计划或执行失败"
992
+ "0": "成功",
993
+ "1": "校验、版本冲突或执行失败"
791
994
  },
792
995
  "safety": [
793
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
794
- "无网络调用"
996
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
997
+ ]
998
+ },
999
+ {
1000
+ "path": [
1001
+ "style",
1002
+ "list"
1003
+ ],
1004
+ "usage": "art-workshop style list",
1005
+ "description": "列出工程对象及任务展示状态",
1006
+ "arguments": [],
1007
+ "options": [
1008
+ {
1009
+ "flags": "--project <id>",
1010
+ "description": "工程身份"
1011
+ }
1012
+ ],
1013
+ "output": {
1014
+ "format": "json",
1015
+ "description": "列出工程对象及任务展示状态"
1016
+ },
1017
+ "exitCodes": {
1018
+ "0": "成功",
1019
+ "1": "校验、版本冲突或执行失败"
1020
+ },
1021
+ "safety": [
1022
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
1023
+ ]
1024
+ },
1025
+ {
1026
+ "path": [
1027
+ "style",
1028
+ "read"
1029
+ ],
1030
+ "usage": "art-workshop style read",
1031
+ "description": "读取指定对象与版本",
1032
+ "arguments": [],
1033
+ "options": [
1034
+ {
1035
+ "flags": "--project <id>",
1036
+ "description": "工程身份"
1037
+ },
1038
+ {
1039
+ "flags": "--id <id>",
1040
+ "description": "对象身份"
1041
+ }
1042
+ ],
1043
+ "output": {
1044
+ "format": "json",
1045
+ "description": "读取指定对象与版本"
1046
+ },
1047
+ "exitCodes": {
1048
+ "0": "成功",
1049
+ "1": "校验、版本冲突或执行失败"
1050
+ },
1051
+ "safety": [
1052
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
1053
+ ]
1054
+ },
1055
+ {
1056
+ "path": [
1057
+ "style",
1058
+ "update"
1059
+ ],
1060
+ "usage": "art-workshop style update",
1061
+ "description": "校验预期版本及空闲状态后更新对象",
1062
+ "arguments": [],
1063
+ "options": [
1064
+ {
1065
+ "flags": "--project <id>",
1066
+ "description": "工程身份"
1067
+ },
1068
+ {
1069
+ "flags": "--id <id>",
1070
+ "description": "对象身份"
1071
+ },
1072
+ {
1073
+ "flags": "--revision <number>",
1074
+ "description": "预期对象版本"
1075
+ },
1076
+ {
1077
+ "flags": "--input <file>",
1078
+ "description": "结构化配置文件"
1079
+ }
1080
+ ],
1081
+ "output": {
1082
+ "format": "json",
1083
+ "description": "校验预期版本及空闲状态后更新对象"
1084
+ },
1085
+ "exitCodes": {
1086
+ "0": "成功",
1087
+ "1": "校验、版本冲突或执行失败"
1088
+ },
1089
+ "safety": [
1090
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
1091
+ ]
1092
+ },
1093
+ {
1094
+ "path": [
1095
+ "style",
1096
+ "derive"
1097
+ ],
1098
+ "usage": "art-workshop style derive",
1099
+ "description": "派生独立草稿,不继承执行、报告或定版",
1100
+ "arguments": [],
1101
+ "options": [
1102
+ {
1103
+ "flags": "--project <id>",
1104
+ "description": "工程身份"
1105
+ },
1106
+ {
1107
+ "flags": "--id <id>",
1108
+ "description": "对象身份"
1109
+ },
1110
+ {
1111
+ "flags": "--revision <number>",
1112
+ "description": "预期对象版本"
1113
+ }
1114
+ ],
1115
+ "output": {
1116
+ "format": "json",
1117
+ "description": "派生独立草稿,不继承执行、报告或定版"
1118
+ },
1119
+ "exitCodes": {
1120
+ "0": "成功",
1121
+ "1": "校验、版本冲突或执行失败"
1122
+ },
1123
+ "safety": [
1124
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
1125
+ ]
1126
+ },
1127
+ {
1128
+ "path": [
1129
+ "style",
1130
+ "discard"
1131
+ ],
1132
+ "usage": "art-workshop style discard",
1133
+ "description": "确认空闲后丢弃草稿并清理所属资源",
1134
+ "arguments": [],
1135
+ "options": [
1136
+ {
1137
+ "flags": "--project <id>",
1138
+ "description": "工程身份"
1139
+ },
1140
+ {
1141
+ "flags": "--id <id>",
1142
+ "description": "对象身份"
1143
+ },
1144
+ {
1145
+ "flags": "--revision <number>",
1146
+ "description": "预期对象版本"
1147
+ }
1148
+ ],
1149
+ "output": {
1150
+ "format": "json",
1151
+ "description": "确认空闲后丢弃草稿并清理所属资源"
1152
+ },
1153
+ "exitCodes": {
1154
+ "0": "成功",
1155
+ "1": "校验、版本冲突或执行失败"
1156
+ },
1157
+ "safety": [
1158
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
1159
+ ]
1160
+ },
1161
+ {
1162
+ "path": [
1163
+ "job",
1164
+ "create"
1165
+ ],
1166
+ "usage": "art-workshop job create",
1167
+ "description": "创建独立草稿对象",
1168
+ "arguments": [],
1169
+ "options": [
1170
+ {
1171
+ "flags": "--project <id>",
1172
+ "description": "工程身份"
1173
+ },
1174
+ {
1175
+ "flags": "--input <file>",
1176
+ "description": "结构化配置文件"
1177
+ }
1178
+ ],
1179
+ "output": {
1180
+ "format": "json",
1181
+ "description": "创建独立草稿对象"
1182
+ },
1183
+ "exitCodes": {
1184
+ "0": "成功",
1185
+ "1": "校验、版本冲突或执行失败"
1186
+ },
1187
+ "safety": [
1188
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
1189
+ ]
1190
+ },
1191
+ {
1192
+ "path": [
1193
+ "job",
1194
+ "list"
1195
+ ],
1196
+ "usage": "art-workshop job list",
1197
+ "description": "列出工程对象及任务展示状态",
1198
+ "arguments": [],
1199
+ "options": [
1200
+ {
1201
+ "flags": "--project <id>",
1202
+ "description": "工程身份"
1203
+ }
1204
+ ],
1205
+ "output": {
1206
+ "format": "json",
1207
+ "description": "列出工程对象及任务展示状态"
1208
+ },
1209
+ "exitCodes": {
1210
+ "0": "成功",
1211
+ "1": "校验、版本冲突或执行失败"
1212
+ },
1213
+ "safety": [
1214
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
1215
+ ]
1216
+ },
1217
+ {
1218
+ "path": [
1219
+ "job",
1220
+ "read"
1221
+ ],
1222
+ "usage": "art-workshop job read",
1223
+ "description": "读取指定对象与版本",
1224
+ "arguments": [],
1225
+ "options": [
1226
+ {
1227
+ "flags": "--project <id>",
1228
+ "description": "工程身份"
1229
+ },
1230
+ {
1231
+ "flags": "--id <id>",
1232
+ "description": "对象身份"
1233
+ }
1234
+ ],
1235
+ "output": {
1236
+ "format": "json",
1237
+ "description": "读取指定对象与版本"
1238
+ },
1239
+ "exitCodes": {
1240
+ "0": "成功",
1241
+ "1": "校验、版本冲突或执行失败"
1242
+ },
1243
+ "safety": [
1244
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
1245
+ ]
1246
+ },
1247
+ {
1248
+ "path": [
1249
+ "job",
1250
+ "update"
1251
+ ],
1252
+ "usage": "art-workshop job update",
1253
+ "description": "校验预期版本及空闲状态后更新对象",
1254
+ "arguments": [],
1255
+ "options": [
1256
+ {
1257
+ "flags": "--project <id>",
1258
+ "description": "工程身份"
1259
+ },
1260
+ {
1261
+ "flags": "--id <id>",
1262
+ "description": "对象身份"
1263
+ },
1264
+ {
1265
+ "flags": "--revision <number>",
1266
+ "description": "预期对象版本"
1267
+ },
1268
+ {
1269
+ "flags": "--input <file>",
1270
+ "description": "结构化配置文件"
1271
+ }
1272
+ ],
1273
+ "output": {
1274
+ "format": "json",
1275
+ "description": "校验预期版本及空闲状态后更新对象"
1276
+ },
1277
+ "exitCodes": {
1278
+ "0": "成功",
1279
+ "1": "校验、版本冲突或执行失败"
1280
+ },
1281
+ "safety": [
1282
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
1283
+ ]
1284
+ },
1285
+ {
1286
+ "path": [
1287
+ "job",
1288
+ "derive"
1289
+ ],
1290
+ "usage": "art-workshop job derive",
1291
+ "description": "派生独立草稿,不继承执行、报告或定版",
1292
+ "arguments": [],
1293
+ "options": [
1294
+ {
1295
+ "flags": "--project <id>",
1296
+ "description": "工程身份"
1297
+ },
1298
+ {
1299
+ "flags": "--id <id>",
1300
+ "description": "对象身份"
1301
+ },
1302
+ {
1303
+ "flags": "--revision <number>",
1304
+ "description": "预期对象版本"
1305
+ }
1306
+ ],
1307
+ "output": {
1308
+ "format": "json",
1309
+ "description": "派生独立草稿,不继承执行、报告或定版"
1310
+ },
1311
+ "exitCodes": {
1312
+ "0": "成功",
1313
+ "1": "校验、版本冲突或执行失败"
1314
+ },
1315
+ "safety": [
1316
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
1317
+ ]
1318
+ },
1319
+ {
1320
+ "path": [
1321
+ "job",
1322
+ "discard"
1323
+ ],
1324
+ "usage": "art-workshop job discard",
1325
+ "description": "确认空闲后丢弃草稿并清理所属资源",
1326
+ "arguments": [],
1327
+ "options": [
1328
+ {
1329
+ "flags": "--project <id>",
1330
+ "description": "工程身份"
1331
+ },
1332
+ {
1333
+ "flags": "--id <id>",
1334
+ "description": "对象身份"
1335
+ },
1336
+ {
1337
+ "flags": "--revision <number>",
1338
+ "description": "预期对象版本"
1339
+ }
1340
+ ],
1341
+ "output": {
1342
+ "format": "json",
1343
+ "description": "确认空闲后丢弃草稿并清理所属资源"
1344
+ },
1345
+ "exitCodes": {
1346
+ "0": "成功",
1347
+ "1": "校验、版本冲突或执行失败"
1348
+ },
1349
+ "safety": [
1350
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
1351
+ ]
1352
+ },
1353
+ {
1354
+ "path": [
1355
+ "style",
1356
+ "adopt"
1357
+ ],
1358
+ "usage": "art-workshop style adopt",
1359
+ "description": "采用当前有效报告并冻结",
1360
+ "arguments": [],
1361
+ "options": [
1362
+ {
1363
+ "flags": "--project <id>",
1364
+ "description": "工程身份"
1365
+ },
1366
+ {
1367
+ "flags": "--id <id>",
1368
+ "description": "对象身份"
1369
+ },
1370
+ {
1371
+ "flags": "--revision <number>",
1372
+ "description": "预期对象版本"
1373
+ },
1374
+ {
1375
+ "flags": "--note <text>",
1376
+ "description": "采用说明"
1377
+ }
1378
+ ],
1379
+ "output": {
1380
+ "format": "json",
1381
+ "description": "采用当前有效报告并冻结"
1382
+ },
1383
+ "exitCodes": {
1384
+ "0": "成功",
1385
+ "1": "校验、版本冲突或执行失败"
1386
+ },
1387
+ "safety": [
1388
+ "来源匹配且冲突已解决;采用事务可恢复,核心只写一次"
1389
+ ]
1390
+ },
1391
+ {
1392
+ "path": [
1393
+ "style",
1394
+ "recover"
1395
+ ],
1396
+ "usage": "art-workshop style recover",
1397
+ "description": "恢复已授权采用事务",
1398
+ "arguments": [],
1399
+ "options": [
1400
+ {
1401
+ "flags": "--project <id>",
1402
+ "description": "工程身份"
1403
+ },
1404
+ {
1405
+ "flags": "--id <id>",
1406
+ "description": "对象身份"
1407
+ }
1408
+ ],
1409
+ "output": {
1410
+ "format": "json",
1411
+ "description": "恢复已授权采用事务"
1412
+ },
1413
+ "exitCodes": {
1414
+ "0": "成功",
1415
+ "1": "校验、版本冲突或执行失败"
1416
+ },
1417
+ "safety": [
1418
+ "不重新调用模型;核验核心和事务身份后完成状态提交"
1419
+ ]
1420
+ },
1421
+ {
1422
+ "path": [
1423
+ "project",
1424
+ "init"
1425
+ ],
1426
+ "usage": "art-workshop project init",
1427
+ "description": "新建版本 2 工程",
1428
+ "arguments": [],
1429
+ "options": [
1430
+ {
1431
+ "flags": "--project <id>",
1432
+ "description": "工程身份"
1433
+ },
1434
+ {
1435
+ "flags": "--input <file>",
1436
+ "description": "结构化配置文件"
1437
+ }
1438
+ ],
1439
+ "output": {
1440
+ "format": "json",
1441
+ "description": "新建版本 2 工程"
1442
+ },
1443
+ "exitCodes": {
1444
+ "0": "成功",
1445
+ "1": "校验、版本冲突或执行失败"
1446
+ },
1447
+ "safety": [
1448
+ "工程存在拒绝覆写"
1449
+ ]
1450
+ },
1451
+ {
1452
+ "path": [
1453
+ "project",
1454
+ "upgrade"
1455
+ ],
1456
+ "usage": "art-workshop project upgrade",
1457
+ "description": "显式一次性工程升级",
1458
+ "arguments": [],
1459
+ "options": [
1460
+ {
1461
+ "flags": "--project <id>",
1462
+ "description": "工程身份"
1463
+ },
1464
+ {
1465
+ "flags": "--dry",
1466
+ "description": "预检"
1467
+ },
1468
+ {
1469
+ "flags": "--mapping <file>",
1470
+ "description": "旧共享参考的明确归属映射"
1471
+ }
1472
+ ],
1473
+ "output": {
1474
+ "format": "json",
1475
+ "description": "显式一次性工程升级"
1476
+ },
1477
+ "exitCodes": {
1478
+ "0": "成功",
1479
+ "1": "校验、版本冲突或执行失败"
1480
+ },
1481
+ "safety": [
1482
+ "备份和原子替换,失败回滚;不猜参考归属"
1483
+ ]
1484
+ },
1485
+ {
1486
+ "path": [
1487
+ "reference",
1488
+ "list"
1489
+ ],
1490
+ "usage": "art-workshop reference list",
1491
+ "description": "查看对象参考",
1492
+ "arguments": [],
1493
+ "options": [
1494
+ {
1495
+ "flags": "--project <id>",
1496
+ "description": "工程身份"
1497
+ },
1498
+ {
1499
+ "flags": "--kind <style|task>",
1500
+ "description": "对象粒度"
1501
+ },
1502
+ {
1503
+ "flags": "--id <id>",
1504
+ "description": "对象身份"
1505
+ }
1506
+ ],
1507
+ "output": {
1508
+ "format": "json",
1509
+ "description": "查看对象参考"
1510
+ },
1511
+ "exitCodes": {
1512
+ "0": "成功",
1513
+ "1": "校验、版本冲突或执行失败"
1514
+ },
1515
+ "safety": [
1516
+ "只读"
1517
+ ]
1518
+ },
1519
+ {
1520
+ "path": [
1521
+ "reference",
1522
+ "import"
1523
+ ],
1524
+ "usage": "art-workshop reference import",
1525
+ "description": "导入对象私有图片",
1526
+ "arguments": [],
1527
+ "options": [
1528
+ {
1529
+ "flags": "--project <id>",
1530
+ "description": "工程身份"
1531
+ },
1532
+ {
1533
+ "flags": "--kind <style|task>",
1534
+ "description": "对象粒度"
1535
+ },
1536
+ {
1537
+ "flags": "--id <id>",
1538
+ "description": "对象身份"
1539
+ },
1540
+ {
1541
+ "flags": "--revision <number>",
1542
+ "description": "预期对象版本"
1543
+ },
1544
+ {
1545
+ "flags": "--source <file>",
1546
+ "description": "用户原图"
1547
+ },
1548
+ {
1549
+ "flags": "--category <name>",
1550
+ "description": "四类静态参考之一"
1551
+ },
1552
+ {
1553
+ "flags": "--purposes <list>",
1554
+ "description": "逗号分隔动态用途"
1555
+ },
1556
+ {
1557
+ "flags": "--note <text>",
1558
+ "description": "参考说明"
1559
+ }
1560
+ ],
1561
+ "output": {
1562
+ "format": "json",
1563
+ "description": "导入对象私有图片"
1564
+ },
1565
+ "exitCodes": {
1566
+ "0": "成功",
1567
+ "1": "校验、版本冲突或执行失败"
1568
+ },
1569
+ "safety": [
1570
+ "校验图片、大小、路径;复制不修改原图;不支持直接参考时拒绝"
1571
+ ]
1572
+ },
1573
+ {
1574
+ "path": [
1575
+ "reference",
1576
+ "remove"
1577
+ ],
1578
+ "usage": "art-workshop reference remove",
1579
+ "description": "移除参考关联",
1580
+ "arguments": [],
1581
+ "options": [
1582
+ {
1583
+ "flags": "--project <id>",
1584
+ "description": "工程身份"
1585
+ },
1586
+ {
1587
+ "flags": "--kind <style|task>",
1588
+ "description": "对象粒度"
1589
+ },
1590
+ {
1591
+ "flags": "--id <id>",
1592
+ "description": "对象身份"
1593
+ },
1594
+ {
1595
+ "flags": "--revision <number>",
1596
+ "description": "预期对象版本"
1597
+ },
1598
+ {
1599
+ "flags": "--item <id>",
1600
+ "description": "参考身份"
1601
+ }
1602
+ ],
1603
+ "output": {
1604
+ "format": "json",
1605
+ "description": "移除参考关联"
1606
+ },
1607
+ "exitCodes": {
1608
+ "0": "成功",
1609
+ "1": "校验、版本冲突或执行失败"
1610
+ },
1611
+ "safety": [
1612
+ "移除关联,保留历史证据资源"
1613
+ ]
1614
+ },
1615
+ {
1616
+ "path": [
1617
+ "candidate",
1618
+ "list"
1619
+ ],
1620
+ "usage": "art-workshop candidate list",
1621
+ "description": "查看真实候选及完整性",
1622
+ "arguments": [],
1623
+ "options": [
1624
+ {
1625
+ "flags": "--project <id>",
1626
+ "description": "工程身份"
1627
+ },
1628
+ {
1629
+ "flags": "--job <id>",
1630
+ "description": "配置任务身份"
1631
+ },
1632
+ {
1633
+ "flags": "--run <id>",
1634
+ "description": "执行批次身份"
1635
+ }
1636
+ ],
1637
+ "output": {
1638
+ "format": "json",
1639
+ "description": "查看真实候选及完整性"
1640
+ },
1641
+ "exitCodes": {
1642
+ "0": "成功",
1643
+ "1": "校验、版本冲突或执行失败"
1644
+ },
1645
+ "safety": [
1646
+ "只读;校验批次计划和候选身份"
1647
+ ]
1648
+ },
1649
+ {
1650
+ "path": [
1651
+ "candidate",
1652
+ "finalizations"
1653
+ ],
1654
+ "usage": "art-workshop candidate finalizations",
1655
+ "description": "查看资产定版",
1656
+ "arguments": [],
1657
+ "options": [
1658
+ {
1659
+ "flags": "--project <id>",
1660
+ "description": "工程身份"
1661
+ },
1662
+ {
1663
+ "flags": "--job <id>",
1664
+ "description": "配置任务身份"
1665
+ }
1666
+ ],
1667
+ "output": {
1668
+ "format": "json",
1669
+ "description": "查看资产定版"
1670
+ },
1671
+ "exitCodes": {
1672
+ "0": "成功",
1673
+ "1": "校验、版本冲突或执行失败"
1674
+ },
1675
+ "safety": [
1676
+ "只读"
1677
+ ]
1678
+ },
1679
+ {
1680
+ "path": [
1681
+ "candidate",
1682
+ "finalize"
1683
+ ],
1684
+ "usage": "art-workshop candidate finalize",
1685
+ "description": "按资产定版候选",
1686
+ "arguments": [],
1687
+ "options": [
1688
+ {
1689
+ "flags": "--project <id>",
1690
+ "description": "工程身份"
1691
+ },
1692
+ {
1693
+ "flags": "--job <id>",
1694
+ "description": "配置任务身份"
1695
+ },
1696
+ {
1697
+ "flags": "--run <id>",
1698
+ "description": "执行批次身份"
1699
+ },
1700
+ {
1701
+ "flags": "--revision <number>",
1702
+ "description": "预期对象版本"
1703
+ },
1704
+ {
1705
+ "flags": "--candidate <id>",
1706
+ "description": "候选身份"
1707
+ },
1708
+ {
1709
+ "flags": "--actor <text>",
1710
+ "description": "操作者"
1711
+ },
1712
+ {
1713
+ "flags": "--replace",
1714
+ "description": "明确替换已有定版"
1715
+ }
1716
+ ],
1717
+ "output": {
1718
+ "format": "json",
1719
+ "description": "按资产定版候选"
1720
+ },
1721
+ "exitCodes": {
1722
+ "0": "成功",
1723
+ "1": "校验、版本冲突或执行失败"
1724
+ },
1725
+ "safety": [
1726
+ "生成完成与哈希有效;重复幂等,替换保留历史"
1727
+ ]
1728
+ },
1729
+ {
1730
+ "path": [
1731
+ "candidate",
1732
+ "delete"
1733
+ ],
1734
+ "usage": "art-workshop candidate delete",
1735
+ "description": "删除候选及关联定版",
1736
+ "arguments": [],
1737
+ "options": [
1738
+ {
1739
+ "flags": "--project <id>",
1740
+ "description": "工程身份"
1741
+ },
1742
+ {
1743
+ "flags": "--job <id>",
1744
+ "description": "配置任务身份"
1745
+ },
1746
+ {
1747
+ "flags": "--run <id>",
1748
+ "description": "执行批次身份"
1749
+ },
1750
+ {
1751
+ "flags": "--revision <number>",
1752
+ "description": "预期对象版本"
1753
+ },
1754
+ {
1755
+ "flags": "--candidate <id>",
1756
+ "description": "候选身份"
1757
+ },
1758
+ {
1759
+ "flags": "--actor <text>",
1760
+ "description": "操作者"
1761
+ },
1762
+ {
1763
+ "flags": "--confirm",
1764
+ "description": "明确确认删除影响"
1765
+ }
1766
+ ],
1767
+ "output": {
1768
+ "format": "json",
1769
+ "description": "删除候选及关联定版"
1770
+ },
1771
+ "exitCodes": {
1772
+ "0": "成功",
1773
+ "1": "校验、版本冲突或执行失败"
1774
+ },
1775
+ "safety": [
1776
+ "运行和引用检查;先持久化删除记录,再清理私有文件"
1777
+ ]
1778
+ },
1779
+ {
1780
+ "path": [
1781
+ "job",
1782
+ "analyze"
1783
+ ],
1784
+ "usage": "art-workshop job analyze",
1785
+ "description": "分析任务动态参考,仅转写指定用途,不继承静态风格",
1786
+ "arguments": [],
1787
+ "options": [
1788
+ {
1789
+ "flags": "--project <id>",
1790
+ "description": "工程身份"
1791
+ },
1792
+ {
1793
+ "flags": "--id <id>",
1794
+ "description": "对象身份"
1795
+ },
1796
+ {
1797
+ "flags": "--revision <number>",
1798
+ "description": "预期对象版本"
1799
+ },
1800
+ {
1801
+ "flags": "--dry",
1802
+ "description": "只读编译预演"
1803
+ },
1804
+ {
1805
+ "flags": "--operation <id>",
1806
+ "description": "分析启动前登记的稳定操作身份"
1807
+ }
1808
+ ],
1809
+ "output": {
1810
+ "format": "json",
1811
+ "description": "分析任务动态参考,仅转写指定用途,不继承静态风格"
1812
+ },
1813
+ "exitCodes": {
1814
+ "0": "成功",
1815
+ "1": "校验、版本冲突或执行失败"
1816
+ },
1817
+ "safety": [
1818
+ "dry 不联网、不写参考目录;执行创建运行身份和不可变参考证据;远程停止不确定时保留资源"
1819
+ ]
1820
+ },
1821
+ {
1822
+ "path": [
1823
+ "task",
1824
+ "recover"
1825
+ ],
1826
+ "usage": "art-workshop task recover --project P --operation OPERATION",
1827
+ "description": "仅从唯一原运行登记恢复身份;绝不重新执行",
1828
+ "arguments": [],
1829
+ "options": [
1830
+ {
1831
+ "name": "project",
1832
+ "flags": "--project <id>",
1833
+ "type": "string",
1834
+ "required": true,
1835
+ "description": "原工程身份"
1836
+ },
1837
+ {
1838
+ "name": "operation",
1839
+ "flags": "--operation <id>",
1840
+ "type": "string",
1841
+ "required": true,
1842
+ "description": "启动前持久化的原操作身份"
1843
+ }
1844
+ ],
1845
+ "output": {
1846
+ "format": "json",
1847
+ "description": "仅从唯一原运行登记恢复身份;绝不重新执行"
1848
+ },
1849
+ "exitCodes": {
1850
+ "0": "成功",
1851
+ "1": "失败;未确认停止时保留服务并报告"
1852
+ },
1853
+ "safety": [
1854
+ "读取外部运行状态"
1855
+ ]
1856
+ },
1857
+ {
1858
+ "path": [
1859
+ "reference",
1860
+ "update"
1861
+ ],
1862
+ "usage": "art-workshop reference update --project P --kind style --id ID --revision N --item REF --input PATCH.json",
1863
+ "description": "更新参考分类、任务用途与说明,版本校验并使分析失效",
1864
+ "arguments": [],
1865
+ "options": [
1866
+ {
1867
+ "flags": "--project <id>",
1868
+ "description": "工程身份"
1869
+ },
1870
+ {
1871
+ "flags": "--kind <kind>",
1872
+ "description": "style 或 task"
1873
+ },
1874
+ {
1875
+ "flags": "--id <id>",
1876
+ "description": "对象身份"
1877
+ },
1878
+ {
1879
+ "flags": "--revision <number>",
1880
+ "description": "预期版本"
1881
+ },
1882
+ {
1883
+ "flags": "--item <id>",
1884
+ "description": "参考身份"
1885
+ },
1886
+ {
1887
+ "flags": "--input <file>",
1888
+ "description": "category/purposes/note/ignore 的字段补丁"
1889
+ }
1890
+ ],
1891
+ "output": {
1892
+ "format": "json",
1893
+ "description": "更新参考分类、任务用途与说明,版本校验并使分析失效"
1894
+ },
1895
+ "exitCodes": {
1896
+ "0": "成功",
1897
+ "1": "校验、占用或版本冲突"
1898
+ },
1899
+ "safety": [
1900
+ "冻结风格只读;任务不允许静态分类;不修改用户原图;旧证据保留"
1901
+ ]
1902
+ },
1903
+ {
1904
+ "path": [
1905
+ "deployment",
1906
+ "plan"
1907
+ ],
1908
+ "description": "固定 Qwen 2.1 部署 plan",
1909
+ "options": [
1910
+ {
1911
+ "flags": "--directory <dir>",
1912
+ "description": "本机部署根目录"
1913
+ },
1914
+ {
1915
+ "flags": "--endpoint <url>",
1916
+ "description": "本机 ComfyUI 地址"
1917
+ },
1918
+ {
1919
+ "flags": "--out <file>",
1920
+ "description": "保存不可变预案"
1921
+ }
1922
+ ],
1923
+ "output": {
1924
+ "format": "json",
1925
+ "description": "固定 Qwen 2.1 部署 plan"
1926
+ },
1927
+ "safety": [
1928
+ "只读检测与预案;不下载、不启动、不采样"
1929
+ ],
1930
+ "usage": "art-workshop deployment plan",
1931
+ "arguments": [],
1932
+ "exitCodes": {
1933
+ "0": "成功",
1934
+ "1": "校验、占用或执行失败;未确认停止不释放资源"
1935
+ }
1936
+ },
1937
+ {
1938
+ "path": [
1939
+ "deployment",
1940
+ "start"
1941
+ ],
1942
+ "description": "固定 Qwen 2.1 部署 start",
1943
+ "options": [
1944
+ {
1945
+ "flags": "--plan <file>",
1946
+ "description": "实际冻结部署预案"
1947
+ },
1948
+ {
1949
+ "flags": "--operation <id>",
1950
+ "description": "稳定操作身份"
1951
+ }
1952
+ ],
1953
+ "output": {
1954
+ "format": "json",
1955
+ "description": "固定 Qwen 2.1 部署 start"
1956
+ },
1957
+ "safety": [
1958
+ "下载、源码安装、独立环境、模型哈希验证、生成及编辑采样;不覆写既有不匹配文件"
1959
+ ],
1960
+ "usage": "art-workshop deployment start",
1961
+ "arguments": [],
1962
+ "exitCodes": {
1963
+ "0": "成功",
1964
+ "1": "校验、占用或执行失败;未确认停止不释放资源"
1965
+ }
1966
+ },
1967
+ {
1968
+ "path": [
1969
+ "deployment",
1970
+ "status"
1971
+ ],
1972
+ "description": "固定 Qwen 2.1 部署 status",
1973
+ "options": [
1974
+ {
1975
+ "flags": "--id <id>",
1976
+ "description": "原部署身份"
1977
+ }
1978
+ ],
1979
+ "output": {
1980
+ "format": "json",
1981
+ "description": "固定 Qwen 2.1 部署 status"
1982
+ },
1983
+ "safety": [
1984
+ "只查询原部署,不重复启动"
1985
+ ],
1986
+ "usage": "art-workshop deployment status",
1987
+ "arguments": [],
1988
+ "exitCodes": {
1989
+ "0": "成功",
1990
+ "1": "校验、占用或执行失败;未确认停止不释放资源"
1991
+ }
1992
+ },
1993
+ {
1994
+ "path": [
1995
+ "deployment",
1996
+ "cancel"
1997
+ ],
1998
+ "description": "固定 Qwen 2.1 部署 cancel",
1999
+ "options": [
2000
+ {
2001
+ "flags": "--id <id>",
2002
+ "description": "原部署身份"
2003
+ }
2004
+ ],
2005
+ "output": {
2006
+ "format": "json",
2007
+ "description": "固定 Qwen 2.1 部署 cancel"
2008
+ },
2009
+ "safety": [
2010
+ "请求取消;仅停止已核验子进程与本部署采样,确认后释放安装占用"
2011
+ ],
2012
+ "usage": "art-workshop deployment cancel",
2013
+ "arguments": [],
2014
+ "exitCodes": {
2015
+ "0": "成功",
2016
+ "1": "校验、占用或执行失败;未确认停止不释放资源"
2017
+ }
2018
+ },
2019
+ {
2020
+ "path": [
2021
+ "deployment",
2022
+ "recover"
2023
+ ],
2024
+ "description": "查询唯一原部署回执,不重新执行",
2025
+ "options": [
2026
+ {
2027
+ "flags": "--operation <id>",
2028
+ "description": "启动前登记的稳定身份"
2029
+ }
2030
+ ],
2031
+ "output": {
2032
+ "format": "json",
2033
+ "description": "查询唯一原部署回执,不重新执行"
2034
+ },
2035
+ "safety": [
2036
+ "只读;无法唯一核验时停止未知"
2037
+ ],
2038
+ "usage": "art-workshop deployment recover",
2039
+ "arguments": [],
2040
+ "exitCodes": {
2041
+ "0": "成功",
2042
+ "1": "校验、占用或执行失败;未确认停止不释放资源"
2043
+ }
2044
+ },
2045
+ {
2046
+ "path": [
2047
+ "job",
2048
+ "template"
2049
+ ],
2050
+ "usage": "v-cli art job template --project <id> --kind <generate|edit> [--core <id>]",
2051
+ "description": "只读返回工具权威的任务配置模板;生成任务使用已冻结核心的题材",
2052
+ "arguments": [],
2053
+ "options": [
2054
+ {
2055
+ "flags": "--project <id>",
2056
+ "description": "工程身份"
2057
+ },
2058
+ {
2059
+ "flags": "--kind <generate|edit>",
2060
+ "description": "任务类型"
2061
+ },
2062
+ {
2063
+ "flags": "--core <id>",
2064
+ "description": "生成任务的冻结核心身份"
2065
+ }
2066
+ ],
2067
+ "output": {
2068
+ "format": "json",
2069
+ "description": "只读返回工具权威的任务配置模板;生成任务使用已冻结核心的题材"
2070
+ },
2071
+ "exitCodes": {
2072
+ "0": "成功",
2073
+ "1": "校验、版本冲突或执行失败"
2074
+ },
2075
+ "safety": [
2076
+ "只读返回模板;不创建任务或文件"
2077
+ ]
2078
+ },
2079
+ {
2080
+ "path": [
2081
+ "job",
2082
+ "from-candidate"
2083
+ ],
2084
+ "usage": "v-cli art job from-candidate --project <id> --id <task> --run <id> --candidate <id>",
2085
+ "description": "将完整候选导入私有底图,创建独立编辑草稿,不运行",
2086
+ "arguments": [],
2087
+ "options": [
2088
+ {
2089
+ "flags": "--project <id>",
2090
+ "description": "工程身份"
2091
+ },
2092
+ {
2093
+ "flags": "--id <task>",
2094
+ "description": "源任务身份"
2095
+ },
2096
+ {
2097
+ "flags": "--run <id>",
2098
+ "description": "真实批次"
2099
+ },
2100
+ {
2101
+ "flags": "--candidate <id>",
2102
+ "description": "完整候选身份"
2103
+ }
2104
+ ],
2105
+ "output": {
2106
+ "format": "json",
2107
+ "description": "将完整候选导入私有底图,创建独立编辑草稿,不运行"
2108
+ },
2109
+ "exitCodes": {
2110
+ "0": "成功",
2111
+ "1": "校验、版本冲突或执行失败"
2112
+ },
2113
+ "safety": [
2114
+ "写入新的编辑草稿和私有底图;保留候选来源;不启动生成"
2115
+ ]
2116
+ },
2117
+ {
2118
+ "path": [
2119
+ "task",
2120
+ "resume"
2121
+ ],
2122
+ "usage": "art-workshop task resume TASK",
2123
+ "description": "仅恢复原上游任务的查询和下载,绝不重新提交",
2124
+ "arguments": [
2125
+ {
2126
+ "name": "TASK",
2127
+ "required": true,
2128
+ "description": "art 任务 ID"
2129
+ }
2130
+ ],
2131
+ "options": [],
2132
+ "output": {
2133
+ "format": "json",
2134
+ "description": "仅恢复原上游任务的查询和下载,绝不重新提交"
2135
+ },
2136
+ "exitCodes": {
2137
+ "0": "成功",
2138
+ "1": "失败;未确认停止时保留服务并报告"
2139
+ },
2140
+ "safety": [
2141
+ "写入原任务状态",
2142
+ "查询原上游任务并下载已有产物",
2143
+ "提交结果未知时拒绝恢复"
795
2144
  ]
796
2145
  }
797
2146
  ]