@kevlns/art-workshop 0.2.1 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/AGENTS.md +26 -49
  2. package/README.md +31 -93
  3. package/art-workshop.mjs +70 -26
  4. package/docs/commands.md +913 -80
  5. package/docs/configuration.md +33 -139
  6. package/docs/core-guidance.md +15 -76
  7. package/docs/data-formats.md +15 -151
  8. package/docs/deployment.md +42 -0
  9. package/docs/model-architecture.md +52 -0
  10. package/docs/modes.md +15 -116
  11. package/docs/remote-models.md +42 -0
  12. package/docs/troubleshooting.md +31 -67
  13. package/lib/adapters/dashscope.mjs +234 -0
  14. package/lib/adapters/index.mjs +28 -0
  15. package/lib/agent.mjs +2 -2
  16. package/lib/analysis-worker.mjs +27 -0
  17. package/lib/analyze.mjs +29 -13
  18. package/lib/backends.mjs +350 -74
  19. package/lib/bl.mjs +3 -18
  20. package/lib/candidates.mjs +82 -0
  21. package/lib/comfyui.mjs +10 -8
  22. package/lib/contracts.d.ts +67 -0
  23. package/lib/core.mjs +24 -45
  24. package/lib/deployment-process.mjs +19 -0
  25. package/lib/deployment-source.mjs +24 -0
  26. package/lib/deployment-worker.mjs +86 -0
  27. package/lib/deployment.mjs +75 -0
  28. package/lib/design.mjs +5 -5
  29. package/lib/dimensions.mjs +22 -0
  30. package/lib/edit.mjs +6 -3
  31. package/lib/environments.mjs +67 -0
  32. package/lib/execution/remote.mjs +156 -0
  33. package/lib/executor.mjs +12 -24
  34. package/lib/generate.mjs +9 -6
  35. package/lib/generation-policy.mjs +198 -0
  36. package/lib/images.mjs +10 -0
  37. package/lib/lifecycle.mjs +40 -0
  38. package/lib/migration.mjs +154 -0
  39. package/lib/model-catalog.mjs +288 -0
  40. package/lib/model-registry.mjs +234 -0
  41. package/lib/plan.mjs +98 -28
  42. package/lib/project.mjs +13 -4
  43. package/lib/providers.mjs +27 -22
  44. package/lib/refs.mjs +10 -18
  45. package/lib/runtime.mjs +6 -4
  46. package/lib/service.mjs +45 -4
  47. package/lib/settings.mjs +2 -4
  48. package/lib/shared.mjs +10 -7
  49. package/lib/style-contract.mjs +19 -0
  50. package/lib/style-lifecycle.mjs +73 -0
  51. package/lib/task-references.mjs +37 -0
  52. package/lib/task-worker.mjs +225 -50
  53. package/lib/tasks.mjs +442 -63
  54. package/lib/templates.mjs +68 -0
  55. package/lib/transport/cli.mjs +69 -0
  56. package/lib/transport/http.mjs +82 -0
  57. package/lib/vision.mjs +46 -0
  58. package/lib/workflows.mjs +10 -1
  59. package/lib/workspace.mjs +211 -0
  60. package/package.json +9 -3
  61. package/rules/core-guidance.json +14 -13
  62. package/skills/art-workshop/SKILL.md +28 -53
  63. package/v-cli.plugin.json +1257 -143
  64. package/docs//351/227/256/351/242/230/346/212/245/345/221/212-2026-10-08.md +0 -29
package/v-cli.plugin.json CHANGED
@@ -3,14 +3,14 @@
3
3
  "package": "@kevlns/art-workshop",
4
4
  "command": "art",
5
5
  "bin": "art-workshop",
6
- "description": "美术工坊:风格分析与冻结、远程百炼和本地 ComfyUI 生图/编辑、配置环境检查、任务控制及人工验收。",
6
+ "description": "美术工坊:版本化风格/任务、参考管理、预演、后台执行、停止确认与定版。",
7
7
  "platforms": [
8
8
  "win32",
9
9
  "linux",
10
10
  "darwin"
11
11
  ],
12
12
  "runtime": {
13
- "node": ">=20",
13
+ "node": ">=20.9",
14
14
  "imageProvider": "bailian CLI or lazy ComfyUI backend; task lifecycle and shutdown"
15
15
  },
16
16
  "environment": [
@@ -24,7 +24,7 @@
24
24
  }
25
25
  ],
26
26
  "agent": {
27
- "whenToUse": "风格分析/冻结、远程或本地生图/编辑、工作流检测及任务管理。先 config show、agent index、config validate;远程核对百炼入口与认证,本地核对 workflow/doctor,具体任务先 plan 和 run --dry;按已有授权执行,任务失败读取 diagnostic,产物人工验收。",
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>",
@@ -94,7 +94,7 @@
94
94
  "1": "参数、配置、计划或执行失败"
95
95
  },
96
96
  "safety": [
97
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
97
+ "查询与预演不创建参考目录",
98
98
  "无网络调用"
99
99
  ]
100
100
  },
@@ -116,7 +116,7 @@
116
116
  "1": "参数、配置、计划或执行失败"
117
117
  },
118
118
  "safety": [
119
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
119
+ "查询与预演不创建参考目录",
120
120
  "无网络调用"
121
121
  ]
122
122
  },
@@ -138,7 +138,7 @@
138
138
  "1": "参数、配置、计划或执行失败"
139
139
  },
140
140
  "safety": [
141
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
141
+ "查询与预演不创建参考目录",
142
142
  "无网络调用",
143
143
  "写入外部本地配置"
144
144
  ]
@@ -166,7 +166,7 @@
166
166
  "1": "参数、配置、计划或执行失败"
167
167
  },
168
168
  "safety": [
169
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
169
+ "查询与预演不创建参考目录",
170
170
  "无网络调用"
171
171
  ]
172
172
  },
@@ -188,7 +188,7 @@
188
188
  "1": "参数、配置、计划或执行失败"
189
189
  },
190
190
  "safety": [
191
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
191
+ "查询与预演不创建参考目录",
192
192
  "无网络调用"
193
193
  ]
194
194
  },
@@ -210,7 +210,7 @@
210
210
  "1": "参数、配置、计划或执行失败"
211
211
  },
212
212
  "safety": [
213
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
213
+ "查询与预演不创建参考目录",
214
214
  "无网络调用"
215
215
  ]
216
216
  },
@@ -229,7 +229,7 @@
229
229
  },
230
230
  {
231
231
  "flags": "--dry",
232
- "description": "预演,不调用远程模型;仍补齐 refs 分类目录"
232
+ "description": "只读预演,不联网、不创建参考目录"
233
233
  }
234
234
  ],
235
235
  "output": {
@@ -241,7 +241,7 @@
241
241
  "1": "参数、配置、计划或执行失败"
242
242
  },
243
243
  "safety": [
244
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
244
+ "查询与预演不创建参考目录",
245
245
  "无网络调用",
246
246
  "覆盖同名随包 skill 和 runtime.json,保留扩展文件"
247
247
  ]
@@ -263,7 +263,7 @@
263
263
  "1": "参数、配置、计划或执行失败"
264
264
  },
265
265
  "safety": [
266
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
266
+ "查询与预演不创建参考目录",
267
267
  "无网络调用"
268
268
  ]
269
269
  },
@@ -272,40 +272,41 @@
272
272
  "style",
273
273
  "analyze"
274
274
  ],
275
- "usage": "art-workshop style analyze [--project <id>] [--input <file>] [--out <file>] [--dry]",
276
- "description": "通过具备视觉能力的模型生成风格报告与推荐配置",
275
+ "usage": "art-workshop style analyze",
276
+ "description": "草稿风格后台分析",
277
277
  "arguments": [],
278
278
  "options": [
279
279
  {
280
280
  "flags": "--project <id>",
281
- "description": "工程 ID;未指定时使用本地 defaultProject,不跨工程回退"
281
+ "description": "工程身份"
282
282
  },
283
283
  {
284
- "flags": "--input <file>",
285
- "description": "分析输入 JSON,引用图片按 refs 解析"
284
+ "flags": "--id <id>",
285
+ "description": "对象身份"
286
286
  },
287
287
  {
288
- "flags": "--out <file>",
289
- "description": "可选外部输出文件;相对路径基于 workspace"
288
+ "flags": "--revision <number>",
289
+ "description": "预期对象版本"
290
290
  },
291
291
  {
292
292
  "flags": "--dry",
293
- "description": "预演,不调用远程模型;仍补齐 refs 分类目录"
293
+ "description": "只读编译预演"
294
+ },
295
+ {
296
+ "flags": "--operation <id>",
297
+ "description": "分析启动前登记的稳定操作身份"
294
298
  }
295
299
  ],
296
300
  "output": {
297
301
  "format": "json",
298
- "description": "通过具备视觉能力的模型生成风格报告与推荐配置"
302
+ "description": "草稿风格后台分析"
299
303
  },
300
304
  "exitCodes": {
301
- "0": "成功;验收状态以返回内容为准",
302
- "1": "参数、配置、计划或执行失败"
305
+ "0": "成功",
306
+ "1": "校验、版本冲突或执行失败"
303
307
  },
304
308
  "safety": [
305
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
306
- "非 dry 会调用远程模型并产生费用",
307
- "非 dry 可写入外部报告和分析缓存",
308
- "不自动冻结核心"
309
+ "dry 不联网、不写参考目录;执行创建运行身份和不可变参考证据;远程停止不确定时保留资源"
309
310
  ]
310
311
  },
311
312
  {
@@ -335,44 +336,7 @@
335
336
  "1": "参数、配置、计划或执行失败"
336
337
  },
337
338
  "safety": [
338
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
339
- "无网络调用"
340
- ]
341
- },
342
- {
343
- "path": [
344
- "style",
345
- "freeze"
346
- ],
347
- "usage": "art-workshop style freeze [--project <id>] [--report <file>] [--note <text>]",
348
- "description": "采用报告并冻结核心,将核心绑定到当前工程",
349
- "arguments": [],
350
- "options": [
351
- {
352
- "flags": "--project <id>",
353
- "description": "工程 ID;未指定时使用本地 defaultProject,不跨工程回退"
354
- },
355
- {
356
- "flags": "--report <file>",
357
- "description": "风格报告 JSON,相对路径基于 workspace"
358
- },
359
- {
360
- "flags": "--note <text>",
361
- "description": "冻结备注"
362
- }
363
- ],
364
- "output": {
365
- "format": "json",
366
- "description": "采用报告并冻结核心,将核心绑定到当前工程"
367
- },
368
- "exitCodes": {
369
- "0": "成功;验收状态以返回内容为准",
370
- "1": "参数、配置、计划或执行失败"
371
- },
372
- "safety": [
373
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
374
- "须有用户采用报告的授权",
375
- "写入外部工程核心和 project.json,拒绝覆写已有核心",
339
+ "查询与预演不创建参考目录",
376
340
  "无网络调用"
377
341
  ]
378
342
  },
@@ -403,7 +367,7 @@
403
367
  "1": "参数、配置、计划或执行失败"
404
368
  },
405
369
  "safety": [
406
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
370
+ "查询与预演不创建参考目录",
407
371
  "无网络调用"
408
372
  ]
409
373
  },
@@ -434,7 +398,7 @@
434
398
  "1": "参数、配置、计划或执行失败"
435
399
  },
436
400
  "safety": [
437
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
401
+ "查询与预演不创建参考目录",
438
402
  "无网络调用"
439
403
  ]
440
404
  },
@@ -477,7 +441,7 @@
477
441
  "1": "参数、配置、计划或执行失败"
478
442
  },
479
443
  "safety": [
480
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
444
+ "查询与预演不创建参考目录",
481
445
  "无网络调用",
482
446
  "指定 out 时写入外部计划文件"
483
447
  ]
@@ -529,7 +493,7 @@
529
493
  },
530
494
  {
531
495
  "flags": "--dry",
532
- "description": "预演所选请求;不联网、启动服务或上传,仍可补齐 refs 分类"
496
+ "description": "只读预演所选请求;不联网、不启动服务、不上传、不创建参考目录"
533
497
  },
534
498
  {
535
499
  "flags": "--backend <id>",
@@ -538,6 +502,18 @@
538
502
  {
539
503
  "flags": "--background",
540
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"
541
517
  }
542
518
  ],
543
519
  "output": {
@@ -549,8 +525,8 @@
549
525
  "1": "参数、配置、计划或执行失败"
550
526
  },
551
527
  "safety": [
552
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
553
- "远程非 dry 通过百炼调用模型,可能产生费用,按已有任务授权执行",
528
+ "查询与预演不创建参考目录",
529
+ "远程非 dry 通过登记的协议适配器调用模型,可能产生费用,按已有任务授权执行",
554
530
  "本地非 dry 可启动任务和 ComfyUI 服务并采样,不调用百炼生图",
555
531
  "真实执行写入外部图片、manifest、任务状态和诊断",
556
532
  "dry 只展示请求,不启动或探测服务、不上传、不生成图片"
@@ -583,7 +559,7 @@
583
559
  "1": "参数、配置、计划或执行失败"
584
560
  },
585
561
  "safety": [
586
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
562
+ "查询与预演不创建参考目录",
587
563
  "无网络调用"
588
564
  ]
589
565
  },
@@ -626,7 +602,7 @@
626
602
  "1": "参数、配置、计划或执行失败"
627
603
  },
628
604
  "safety": [
629
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
605
+ "查询与预演不创建参考目录",
630
606
  "无网络调用",
631
607
  "指定 out 时写入外部计划文件"
632
608
  ]
@@ -678,7 +654,7 @@
678
654
  },
679
655
  {
680
656
  "flags": "--dry",
681
- "description": "预演所选请求;不联网、启动服务或上传,仍可补齐 refs 分类"
657
+ "description": "只读预演所选请求;不联网、不启动服务、不上传、不创建参考目录"
682
658
  },
683
659
  {
684
660
  "flags": "--backend <id>",
@@ -687,6 +663,18 @@
687
663
  {
688
664
  "flags": "--background",
689
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"
690
678
  }
691
679
  ],
692
680
  "output": {
@@ -698,8 +686,8 @@
698
686
  "1": "参数、配置、计划或执行失败"
699
687
  },
700
688
  "safety": [
701
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
702
- "远程非 dry 通过百炼调用模型,可能产生费用,按已有任务授权执行",
689
+ "查询与预演不创建参考目录",
690
+ "远程非 dry 通过登记的协议适配器调用模型,可能产生费用,按已有任务授权执行",
703
691
  "本地非 dry 可启动任务和 ComfyUI 服务并采样,不调用百炼生图",
704
692
  "真实执行写入外部图片、manifest、任务状态和诊断",
705
693
  "dry 只展示请求,不启动或探测服务、不上传、不生成图片"
@@ -709,45 +697,8 @@
709
697
  "path": [
710
698
  "check"
711
699
  ],
712
- "usage": "art-workshop check RUN [--review <file>] [--out <file>]",
713
- "description": "导出或汇总人工验收;不自动评价图片",
714
- "arguments": [
715
- {
716
- "name": "RUN",
717
- "description": "运行目录或 manifest 路径,按 output 解析",
718
- "required": true
719
- }
720
- ],
721
- "options": [
722
- {
723
- "flags": "--review <file>",
724
- "description": "人工 review JSON"
725
- },
726
- {
727
- "flags": "--out <file>",
728
- "description": "可选外部输出文件;相对路径基于 workspace"
729
- }
730
- ],
731
- "output": {
732
- "format": "json",
733
- "description": "导出或汇总人工验收;不自动评价图片"
734
- },
735
- "exitCodes": {
736
- "0": "成功;验收状态以返回内容为准",
737
- "1": "参数、配置、计划或执行失败"
738
- },
739
- "safety": [
740
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
741
- "无网络调用",
742
- "指定 out 时写入外部验收文件"
743
- ]
744
- },
745
- {
746
- "path": [
747
- "select"
748
- ],
749
- "usage": "art-workshop select RUN [--item <id>] [--variant <id>] [--review <file>] [--file <path>]",
750
- "description": "选择完整性有效且 content/style/asset 全部通过的唯一产物",
700
+ "usage": "art-workshop check RUN",
701
+ "description": "核验运行计划、执行归属、产物与文件哈希;不进行人工评分",
751
702
  "arguments": [
752
703
  {
753
704
  "name": "RUN",
@@ -755,36 +706,17 @@
755
706
  "required": true
756
707
  }
757
708
  ],
758
- "options": [
759
- {
760
- "flags": "--item <id>",
761
- "description": "必须指定单体"
762
- },
763
- {
764
- "flags": "--variant <id>",
765
- "description": "必须指定候选"
766
- },
767
- {
768
- "flags": "--review <file>",
769
- "description": "人工 review JSON"
770
- },
771
- {
772
- "flags": "--file <path>",
773
- "description": "选择记录内的图片文件"
774
- }
775
- ],
709
+ "options": [],
776
710
  "output": {
777
711
  "format": "json",
778
- "description": "选择完整性有效且 content/style/asset 全部通过的唯一产物"
712
+ "description": "核验运行计划、执行归属、产物与文件哈希;不进行人工评分"
779
713
  },
780
714
  "exitCodes": {
781
715
  "0": "成功;验收状态以返回内容为准",
782
716
  "1": "参数、配置、计划或执行失败"
783
717
  },
784
718
  "safety": [
785
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
786
- "无网络调用",
787
- "写回外部 manifest 的验收与选择记录"
719
+ "只读;不调用模型、不写入评分或定版记录"
788
720
  ]
789
721
  },
790
722
  {
@@ -815,7 +747,7 @@
815
747
  "1": "参数、配置、计划或执行失败"
816
748
  },
817
749
  "safety": [
818
- "配置生效时补齐外部 refs 分类目录,不覆盖素材",
750
+ "查询与预演不创建参考目录",
819
751
  "无网络调用"
820
752
  ]
821
753
  },
@@ -827,7 +759,12 @@
827
759
  "usage": "art-workshop task list",
828
760
  "description": "列出任务状态",
829
761
  "arguments": [],
830
- "options": [],
762
+ "options": [
763
+ {
764
+ "flags": "--project <id>",
765
+ "description": "仅列出指定工程运行"
766
+ }
767
+ ],
831
768
  "output": {
832
769
  "format": "json",
833
770
  "description": "列出任务状态"
@@ -933,12 +870,12 @@
933
870
  "shutdown"
934
871
  ],
935
872
  "usage": "art-workshop shutdown",
936
- "description": "停止所有任务、清空本地队列并关闭服务",
873
+ "description": "停止当前工作区关联任务,核验共享队列和进程身份后关闭服务",
937
874
  "arguments": [],
938
875
  "options": [],
939
876
  "output": {
940
877
  "format": "json",
941
- "description": "停止所有任务、清空本地队列并关闭服务"
878
+ "description": "停止当前工作区关联任务,核验共享队列和进程身份后关闭服务"
942
879
  },
943
880
  "exitCodes": {
944
881
  "0": "成功",
@@ -946,7 +883,7 @@
946
883
  },
947
884
  "safety": [
948
885
  "停止配置范围内所有任务",
949
- "清空 ComfyUI 队列并中断执行",
886
+ "只取消关联任务;共享队列仍有其他任务时保留服务",
950
887
  "核验进程身份后关闭服务",
951
888
  "阻止 shutdown 期间的新任务"
952
889
  ]
@@ -1028,6 +965,1183 @@
1028
965
  "safety": [
1029
966
  "读取随包工作流清单,不依赖合法用户配置、不补 refs、不调用模型"
1030
967
  ]
968
+ },
969
+ {
970
+ "path": [
971
+ "style",
972
+ "create"
973
+ ],
974
+ "usage": "art-workshop style create",
975
+ "description": "创建独立草稿对象",
976
+ "arguments": [],
977
+ "options": [
978
+ {
979
+ "flags": "--project <id>",
980
+ "description": "工程身份"
981
+ },
982
+ {
983
+ "flags": "--input <file>",
984
+ "description": "结构化配置文件"
985
+ }
986
+ ],
987
+ "output": {
988
+ "format": "json",
989
+ "description": "创建独立草稿对象"
990
+ },
991
+ "exitCodes": {
992
+ "0": "成功",
993
+ "1": "校验、版本冲突或执行失败"
994
+ },
995
+ "safety": [
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
+ "提交结果未知时拒绝恢复"
2144
+ ]
1031
2145
  }
1032
2146
  ]
1033
2147
  }