@kevlns/art-workshop 0.3.5 → 0.3.7
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.
- package/AGENTS.md +40 -10
- package/LICENSE +1 -1
- package/README.md +40 -25
- package/art-workshop.mjs +1 -1
- package/docs/commands.md +81 -66
- package/docs/configuration.md +31 -9
- package/docs/core-guidance.md +22 -6
- package/docs/data-formats.md +30 -8
- package/docs/deployment.md +23 -5
- package/docs/documentation.md +24 -0
- package/docs/model-architecture.md +28 -6
- package/docs/modes.md +28 -10
- package/docs/remote-models.md +27 -5
- package/docs/troubleshooting.md +21 -7
- package/lib/edit.mjs +2 -2
- package/lib/generate.mjs +2 -2
- package/lib/task-references.mjs +3 -3
- package/lib/workspace.mjs +6 -3
- package/package.json +6 -5
- package/skills/art-workshop/SKILL.md +42 -10
- package/v-cli.plugin.json +6 -2
package/docs/commands.md
CHANGED
|
@@ -1,12 +1,16 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Vant 美术工坊命令参考
|
|
2
2
|
|
|
3
3
|
<!-- Generated by scripts/command-docs.mjs; edit v-cli.plugin.json. -->
|
|
4
4
|
|
|
5
|
+
## 定位
|
|
6
|
+
|
|
5
7
|
本文件由插件清单生成。`npm run docs:generate` 更新,`npm run docs:check` 检查漂移。
|
|
6
8
|
|
|
9
|
+
## 调用方式
|
|
10
|
+
|
|
7
11
|
`v-cli art` 路由到同一工具;直接调用可用 `art-workshop`。标识、路径占位符须替换为真实值。
|
|
8
12
|
|
|
9
|
-
|
|
13
|
+
### 全局选项
|
|
10
14
|
|
|
11
15
|
- `--config <file>`:外部本地配置文件
|
|
12
16
|
- `--workspace <dir>`:外部工程与任务根目录
|
|
@@ -24,7 +28,9 @@
|
|
|
24
28
|
|
|
25
29
|
前台运行也登记 taskId;后台启动成功仅表示收到执行身份。状态、停止确认和实际产物分别核对。详见 [任务控制](troubleshooting.md)、[模型架构](model-architecture.md) 和 [部署](deployment.md)。
|
|
26
30
|
|
|
27
|
-
##
|
|
31
|
+
## 参数与输出
|
|
32
|
+
|
|
33
|
+
### help
|
|
28
34
|
|
|
29
35
|
显示命令入口与 v-cli 发现方式
|
|
30
36
|
|
|
@@ -35,7 +41,7 @@ v-cli art help
|
|
|
35
41
|
|
|
36
42
|
- 无配置读取、目录初始化、网络或模型调用
|
|
37
43
|
|
|
38
|
-
|
|
44
|
+
### config path
|
|
39
45
|
|
|
40
46
|
显示本地配置文件路径
|
|
41
47
|
|
|
@@ -47,7 +53,7 @@ v-cli art config path
|
|
|
47
53
|
- 查询与预演不创建参考目录
|
|
48
54
|
- 无网络调用
|
|
49
55
|
|
|
50
|
-
|
|
56
|
+
### config show
|
|
51
57
|
|
|
52
58
|
显示生效的本地配置和外部资源路径
|
|
53
59
|
|
|
@@ -59,7 +65,7 @@ v-cli art config show
|
|
|
59
65
|
- 查询与预演不创建参考目录
|
|
60
66
|
- 无网络调用
|
|
61
67
|
|
|
62
|
-
|
|
68
|
+
### config init
|
|
63
69
|
|
|
64
70
|
配置不存在时创建本地模板;已存在时读取,不覆盖
|
|
65
71
|
|
|
@@ -72,7 +78,7 @@ v-cli art config init
|
|
|
72
78
|
- 无网络调用
|
|
73
79
|
- 写入外部本地配置
|
|
74
80
|
|
|
75
|
-
|
|
81
|
+
### refs guide
|
|
76
82
|
|
|
77
83
|
解释参考分类目录的用途与推荐图片样式
|
|
78
84
|
|
|
@@ -85,7 +91,7 @@ v-cli art refs guide [--project <id>]
|
|
|
85
91
|
- 查询与预演不创建参考目录
|
|
86
92
|
- 无网络调用
|
|
87
93
|
|
|
88
|
-
|
|
94
|
+
### agent index
|
|
89
95
|
|
|
90
96
|
发现模块、工程、核心、任务与随包 skill
|
|
91
97
|
|
|
@@ -97,7 +103,7 @@ v-cli art agent index
|
|
|
97
103
|
- 查询与预演不创建参考目录
|
|
98
104
|
- 无网络调用
|
|
99
105
|
|
|
100
|
-
|
|
106
|
+
### agent docs
|
|
101
107
|
|
|
102
108
|
输出全部随包模式、配置、工程、命令、诊断与核心指南
|
|
103
109
|
|
|
@@ -109,7 +115,7 @@ v-cli art agent docs
|
|
|
109
115
|
- 查询与预演不创建参考目录
|
|
110
116
|
- 无网络调用
|
|
111
117
|
|
|
112
|
-
|
|
118
|
+
### agent init
|
|
113
119
|
|
|
114
120
|
将随包 skill 同步到目标下已有 Agent 技能目录
|
|
115
121
|
|
|
@@ -124,7 +130,7 @@ v-cli art agent init [--directory <dir>] [--dry]
|
|
|
124
130
|
- 无网络调用
|
|
125
131
|
- 覆盖同名随包 skill 和 runtime.json,保留扩展文件
|
|
126
132
|
|
|
127
|
-
|
|
133
|
+
### list
|
|
128
134
|
|
|
129
135
|
列出外部工作目录中的工程
|
|
130
136
|
|
|
@@ -136,7 +142,7 @@ v-cli art list
|
|
|
136
142
|
- 查询与预演不创建参考目录
|
|
137
143
|
- 无网络调用
|
|
138
144
|
|
|
139
|
-
|
|
145
|
+
### style analyze
|
|
140
146
|
|
|
141
147
|
草稿风格后台分析
|
|
142
148
|
|
|
@@ -152,7 +158,7 @@ v-cli art style analyze
|
|
|
152
158
|
|
|
153
159
|
- dry 不联网、不写参考目录;执行创建运行身份和不可变参考证据;远程停止不确定时保留资源
|
|
154
160
|
|
|
155
|
-
|
|
161
|
+
### style validate
|
|
156
162
|
|
|
157
163
|
校验报告及核心规则的一致性
|
|
158
164
|
|
|
@@ -166,7 +172,7 @@ v-cli art style validate [--project <id>] [--report <file>]
|
|
|
166
172
|
- 查询与预演不创建参考目录
|
|
167
173
|
- 无网络调用
|
|
168
174
|
|
|
169
|
-
|
|
175
|
+
### style show
|
|
170
176
|
|
|
171
177
|
读取当前工程的指定冻结核心并验证完整性
|
|
172
178
|
|
|
@@ -180,7 +186,7 @@ v-cli art style show [--project <id>] [--core <id>]
|
|
|
180
186
|
- 查询与预演不创建参考目录
|
|
181
187
|
- 无网络调用
|
|
182
188
|
|
|
183
|
-
|
|
189
|
+
### generate show
|
|
184
190
|
|
|
185
191
|
读取文生图任务
|
|
186
192
|
|
|
@@ -194,7 +200,7 @@ v-cli art generate show [--project <id>] [--job <id>]
|
|
|
194
200
|
- 查询与预演不创建参考目录
|
|
195
201
|
- 无网络调用
|
|
196
202
|
|
|
197
|
-
|
|
203
|
+
### generate plan
|
|
198
204
|
|
|
199
205
|
编译文生图计划,明确来源及真实请求
|
|
200
206
|
|
|
@@ -212,7 +218,7 @@ v-cli art generate plan [--project <id>] [--job <id>] [--core <id>] [--out <file
|
|
|
212
218
|
- 无网络调用
|
|
213
219
|
- 指定 out 时写入外部计划文件
|
|
214
220
|
|
|
215
|
-
|
|
221
|
+
### generate run
|
|
216
222
|
|
|
217
223
|
执行或预演文生图计划
|
|
218
224
|
|
|
@@ -242,7 +248,7 @@ v-cli art generate run [--plan <file>] [--project <id>] [--job <id>] [--core <id
|
|
|
242
248
|
- 真实执行写入外部图片、manifest、任务状态和诊断
|
|
243
249
|
- dry 只展示请求,不启动或探测服务、不上传、不生成图片
|
|
244
250
|
|
|
245
|
-
|
|
251
|
+
### edit show
|
|
246
252
|
|
|
247
253
|
读取图编辑任务
|
|
248
254
|
|
|
@@ -256,7 +262,7 @@ v-cli art edit show [--project <id>] [--job <id>]
|
|
|
256
262
|
- 查询与预演不创建参考目录
|
|
257
263
|
- 无网络调用
|
|
258
264
|
|
|
259
|
-
|
|
265
|
+
### edit plan
|
|
260
266
|
|
|
261
267
|
编译图编辑计划,明确来源及真实请求
|
|
262
268
|
|
|
@@ -274,7 +280,7 @@ v-cli art edit plan [--project <id>] [--job <id>] [--core <id>] [--out <file>]
|
|
|
274
280
|
- 无网络调用
|
|
275
281
|
- 指定 out 时写入外部计划文件
|
|
276
282
|
|
|
277
|
-
|
|
283
|
+
### edit run
|
|
278
284
|
|
|
279
285
|
执行或预演图编辑计划
|
|
280
286
|
|
|
@@ -304,7 +310,7 @@ v-cli art edit run [--plan <file>] [--project <id>] [--job <id>] [--core <id>] [
|
|
|
304
310
|
- 真实执行写入外部图片、manifest、任务状态和诊断
|
|
305
311
|
- dry 只展示请求,不启动或探测服务、不上传、不生成图片
|
|
306
312
|
|
|
307
|
-
|
|
313
|
+
### check
|
|
308
314
|
|
|
309
315
|
核验运行计划、执行归属、产物与文件哈希;不进行人工评分
|
|
310
316
|
|
|
@@ -316,7 +322,7 @@ v-cli art check RUN
|
|
|
316
322
|
|
|
317
323
|
- 只读;不调用模型、不写入评分或定版记录
|
|
318
324
|
|
|
319
|
-
|
|
325
|
+
### compare
|
|
320
326
|
|
|
321
327
|
比较两份计划或执行记录的核心、执行配置和单体变更
|
|
322
328
|
|
|
@@ -330,7 +336,7 @@ v-cli art compare BEFORE AFTER
|
|
|
330
336
|
- 查询与预演不创建参考目录
|
|
331
337
|
- 无网络调用
|
|
332
338
|
|
|
333
|
-
|
|
339
|
+
### task list
|
|
334
340
|
|
|
335
341
|
列出任务状态
|
|
336
342
|
|
|
@@ -342,7 +348,7 @@ v-cli art task list
|
|
|
342
348
|
|
|
343
349
|
- 读取外部运行状态
|
|
344
350
|
|
|
345
|
-
|
|
351
|
+
### task status
|
|
346
352
|
|
|
347
353
|
查看单次任务及后端 prompt_id
|
|
348
354
|
|
|
@@ -354,7 +360,7 @@ v-cli art task status TASK
|
|
|
354
360
|
|
|
355
361
|
- 读取外部运行状态
|
|
356
362
|
|
|
357
|
-
|
|
363
|
+
### task wait
|
|
358
364
|
|
|
359
365
|
等待任务结束;超时不取消任务
|
|
360
366
|
|
|
@@ -367,7 +373,7 @@ v-cli art task wait TASK
|
|
|
367
373
|
|
|
368
374
|
- 读取外部运行状态
|
|
369
375
|
|
|
370
|
-
|
|
376
|
+
### task cancel
|
|
371
377
|
|
|
372
378
|
取消单次任务并等待停止
|
|
373
379
|
|
|
@@ -381,7 +387,7 @@ v-cli art task cancel TASK
|
|
|
381
387
|
- 按 prompt_id 中断本地任务
|
|
382
388
|
- 保留服务进程
|
|
383
389
|
|
|
384
|
-
|
|
390
|
+
### shutdown
|
|
385
391
|
|
|
386
392
|
停止当前工作区关联任务,核验共享队列和进程身份后关闭服务
|
|
387
393
|
|
|
@@ -395,7 +401,7 @@ v-cli art shutdown
|
|
|
395
401
|
- 核验进程身份后关闭服务
|
|
396
402
|
- 阻止 shutdown 期间的新任务
|
|
397
403
|
|
|
398
|
-
|
|
404
|
+
### config validate
|
|
399
405
|
|
|
400
406
|
校验配置和 API workflow 的结构、连接与参数绑定
|
|
401
407
|
|
|
@@ -407,7 +413,7 @@ v-cli art config validate
|
|
|
407
413
|
|
|
408
414
|
- 只读校验,不启动服务、不调用模型
|
|
409
415
|
|
|
410
|
-
|
|
416
|
+
### doctor
|
|
411
417
|
|
|
412
418
|
检测本地 ComfyUI 环境、节点与模型
|
|
413
419
|
|
|
@@ -422,7 +428,7 @@ v-cli art doctor
|
|
|
422
428
|
- --start 可启动并保留服务,写状态与日志;不采样
|
|
423
429
|
- 远程后端只校验配置,不检查认证或云端连通性
|
|
424
430
|
|
|
425
|
-
|
|
431
|
+
### workflow list
|
|
426
432
|
|
|
427
433
|
列出默认内置工作流及 API/UI 文件位置
|
|
428
434
|
|
|
@@ -433,7 +439,7 @@ v-cli art workflow list
|
|
|
433
439
|
|
|
434
440
|
- 读取随包工作流清单,不依赖合法用户配置、不补 refs、不调用模型
|
|
435
441
|
|
|
436
|
-
|
|
442
|
+
### style create
|
|
437
443
|
|
|
438
444
|
创建独立草稿对象
|
|
439
445
|
|
|
@@ -446,7 +452,7 @@ v-cli art style create
|
|
|
446
452
|
|
|
447
453
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
448
454
|
|
|
449
|
-
|
|
455
|
+
### style list
|
|
450
456
|
|
|
451
457
|
列出工程对象及任务展示状态
|
|
452
458
|
|
|
@@ -458,7 +464,7 @@ v-cli art style list
|
|
|
458
464
|
|
|
459
465
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
460
466
|
|
|
461
|
-
|
|
467
|
+
### style read
|
|
462
468
|
|
|
463
469
|
读取指定对象与版本
|
|
464
470
|
|
|
@@ -471,7 +477,7 @@ v-cli art style read
|
|
|
471
477
|
|
|
472
478
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
473
479
|
|
|
474
|
-
|
|
480
|
+
### style update
|
|
475
481
|
|
|
476
482
|
校验预期版本及空闲状态后更新对象
|
|
477
483
|
|
|
@@ -486,7 +492,7 @@ v-cli art style update
|
|
|
486
492
|
|
|
487
493
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
488
494
|
|
|
489
|
-
|
|
495
|
+
### style resolve
|
|
490
496
|
|
|
491
497
|
记录用户选择并修订风格方案;input 为 {issueId,optionId,note},不重新分析、不自动采用
|
|
492
498
|
|
|
@@ -501,7 +507,7 @@ v-cli art style resolve
|
|
|
501
507
|
|
|
502
508
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
503
509
|
|
|
504
|
-
|
|
510
|
+
### style derive
|
|
505
511
|
|
|
506
512
|
派生独立草稿,不继承执行、报告或定版
|
|
507
513
|
|
|
@@ -515,7 +521,7 @@ v-cli art style derive
|
|
|
515
521
|
|
|
516
522
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
517
523
|
|
|
518
|
-
|
|
524
|
+
### style discard
|
|
519
525
|
|
|
520
526
|
确认空闲后丢弃草稿并清理所属资源
|
|
521
527
|
|
|
@@ -529,7 +535,7 @@ v-cli art style discard
|
|
|
529
535
|
|
|
530
536
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
531
537
|
|
|
532
|
-
|
|
538
|
+
### job create
|
|
533
539
|
|
|
534
540
|
创建独立草稿对象
|
|
535
541
|
|
|
@@ -542,7 +548,7 @@ v-cli art job create
|
|
|
542
548
|
|
|
543
549
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
544
550
|
|
|
545
|
-
|
|
551
|
+
### job list
|
|
546
552
|
|
|
547
553
|
列出工程对象及任务展示状态
|
|
548
554
|
|
|
@@ -554,7 +560,7 @@ v-cli art job list
|
|
|
554
560
|
|
|
555
561
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
556
562
|
|
|
557
|
-
|
|
563
|
+
### job read
|
|
558
564
|
|
|
559
565
|
读取指定对象与版本
|
|
560
566
|
|
|
@@ -567,7 +573,7 @@ v-cli art job read
|
|
|
567
573
|
|
|
568
574
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
569
575
|
|
|
570
|
-
|
|
576
|
+
### job update
|
|
571
577
|
|
|
572
578
|
校验预期版本及空闲状态后更新对象
|
|
573
579
|
|
|
@@ -582,7 +588,7 @@ v-cli art job update
|
|
|
582
588
|
|
|
583
589
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
584
590
|
|
|
585
|
-
|
|
591
|
+
### job derive
|
|
586
592
|
|
|
587
593
|
派生独立草稿,不继承执行、报告或定版
|
|
588
594
|
|
|
@@ -596,7 +602,7 @@ v-cli art job derive
|
|
|
596
602
|
|
|
597
603
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
598
604
|
|
|
599
|
-
|
|
605
|
+
### job discard
|
|
600
606
|
|
|
601
607
|
确认空闲后丢弃草稿并清理所属资源
|
|
602
608
|
|
|
@@ -610,7 +616,7 @@ v-cli art job discard
|
|
|
610
616
|
|
|
611
617
|
- 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
|
|
612
618
|
|
|
613
|
-
|
|
619
|
+
### style adopt
|
|
614
620
|
|
|
615
621
|
采用当前有效报告并冻结
|
|
616
622
|
|
|
@@ -625,7 +631,7 @@ v-cli art style adopt
|
|
|
625
631
|
|
|
626
632
|
- 来源匹配且冲突已解决;采用事务可恢复,核心只写一次
|
|
627
633
|
|
|
628
|
-
|
|
634
|
+
### style recover
|
|
629
635
|
|
|
630
636
|
恢复已授权采用事务
|
|
631
637
|
|
|
@@ -638,7 +644,7 @@ v-cli art style recover
|
|
|
638
644
|
|
|
639
645
|
- 不重新调用模型;核验核心和事务身份后完成状态提交
|
|
640
646
|
|
|
641
|
-
|
|
647
|
+
### project init
|
|
642
648
|
|
|
643
649
|
新建版本 2 工程
|
|
644
650
|
|
|
@@ -651,7 +657,7 @@ v-cli art project init
|
|
|
651
657
|
|
|
652
658
|
- 工程存在拒绝覆写
|
|
653
659
|
|
|
654
|
-
|
|
660
|
+
### project upgrade
|
|
655
661
|
|
|
656
662
|
显式一次性工程升级
|
|
657
663
|
|
|
@@ -665,7 +671,7 @@ v-cli art project upgrade
|
|
|
665
671
|
|
|
666
672
|
- 备份和原子替换,失败回滚;不猜参考归属
|
|
667
673
|
|
|
668
|
-
|
|
674
|
+
### reference list
|
|
669
675
|
|
|
670
676
|
查看对象参考
|
|
671
677
|
|
|
@@ -679,7 +685,7 @@ v-cli art reference list
|
|
|
679
685
|
|
|
680
686
|
- 只读
|
|
681
687
|
|
|
682
|
-
|
|
688
|
+
### reference import
|
|
683
689
|
|
|
684
690
|
导入对象私有图片
|
|
685
691
|
|
|
@@ -695,10 +701,11 @@ v-cli art reference import
|
|
|
695
701
|
- `--category <name>`:四类静态参考之一
|
|
696
702
|
- `--purposes <list>`:逗号分隔动态用途
|
|
697
703
|
- `--note <text>`:参考说明
|
|
704
|
+
- `--item-id <id>`:所属出图对象标识;未指定为任务共用
|
|
698
705
|
|
|
699
706
|
- 校验图片、大小、路径;复制不修改原图;不支持直接参考时拒绝
|
|
700
707
|
|
|
701
|
-
|
|
708
|
+
### reference remove
|
|
702
709
|
|
|
703
710
|
移除参考关联
|
|
704
711
|
|
|
@@ -714,7 +721,7 @@ v-cli art reference remove
|
|
|
714
721
|
|
|
715
722
|
- 移除关联,保留历史证据资源
|
|
716
723
|
|
|
717
|
-
|
|
724
|
+
### candidate list
|
|
718
725
|
|
|
719
726
|
查看真实候选及完整性
|
|
720
727
|
|
|
@@ -728,7 +735,7 @@ v-cli art candidate list
|
|
|
728
735
|
|
|
729
736
|
- 只读;校验批次计划和候选身份
|
|
730
737
|
|
|
731
|
-
|
|
738
|
+
### candidate finalizations
|
|
732
739
|
|
|
733
740
|
查看资产定版
|
|
734
741
|
|
|
@@ -741,7 +748,7 @@ v-cli art candidate finalizations
|
|
|
741
748
|
|
|
742
749
|
- 只读
|
|
743
750
|
|
|
744
|
-
|
|
751
|
+
### candidate finalize
|
|
745
752
|
|
|
746
753
|
按资产定版候选
|
|
747
754
|
|
|
@@ -759,7 +766,7 @@ v-cli art candidate finalize
|
|
|
759
766
|
|
|
760
767
|
- 生成完成与哈希有效;重复幂等,替换保留历史
|
|
761
768
|
|
|
762
|
-
|
|
769
|
+
### candidate delete
|
|
763
770
|
|
|
764
771
|
删除候选及关联定版
|
|
765
772
|
|
|
@@ -777,7 +784,7 @@ v-cli art candidate delete
|
|
|
777
784
|
|
|
778
785
|
- 运行和引用检查;先持久化删除记录,再清理私有文件
|
|
779
786
|
|
|
780
|
-
|
|
787
|
+
### job analyze
|
|
781
788
|
|
|
782
789
|
分析任务动态参考,仅转写指定用途,不继承静态风格
|
|
783
790
|
|
|
@@ -793,7 +800,7 @@ v-cli art job analyze
|
|
|
793
800
|
|
|
794
801
|
- dry 不联网、不写参考目录;执行创建运行身份和不可变参考证据;远程停止不确定时保留资源
|
|
795
802
|
|
|
796
|
-
|
|
803
|
+
### task recover
|
|
797
804
|
|
|
798
805
|
仅从唯一原运行登记恢复身份;绝不重新执行
|
|
799
806
|
|
|
@@ -806,7 +813,7 @@ v-cli art task recover --project P --operation OPERATION
|
|
|
806
813
|
|
|
807
814
|
- 读取外部运行状态
|
|
808
815
|
|
|
809
|
-
|
|
816
|
+
### reference update
|
|
810
817
|
|
|
811
818
|
更新参考分类、任务用途与说明,版本校验并使分析失效
|
|
812
819
|
|
|
@@ -819,11 +826,11 @@ v-cli art reference update --project P --kind style --id ID --revision N --item
|
|
|
819
826
|
- `--id <id>`:对象身份
|
|
820
827
|
- `--revision <number>`:预期版本
|
|
821
828
|
- `--item <id>`:参考身份
|
|
822
|
-
- `--input <file>`:category/purposes/note/ignore
|
|
829
|
+
- `--input <file>`:category/purposes/itemId/note/ignore 的字段补丁;itemId 为 null 时任务共用
|
|
823
830
|
|
|
824
831
|
- 冻结风格只读;任务不允许静态分类;不修改用户原图;旧证据保留
|
|
825
832
|
|
|
826
|
-
|
|
833
|
+
### deployment plan
|
|
827
834
|
|
|
828
835
|
固定 Qwen 2.1 部署 plan
|
|
829
836
|
|
|
@@ -837,7 +844,7 @@ v-cli art deployment plan
|
|
|
837
844
|
|
|
838
845
|
- 只读检测与预案;不下载、不启动、不采样
|
|
839
846
|
|
|
840
|
-
|
|
847
|
+
### deployment start
|
|
841
848
|
|
|
842
849
|
固定 Qwen 2.1 部署 start
|
|
843
850
|
|
|
@@ -850,7 +857,7 @@ v-cli art deployment start
|
|
|
850
857
|
|
|
851
858
|
- 下载、源码安装、独立环境、模型哈希验证、生成及编辑采样;不覆写既有不匹配文件
|
|
852
859
|
|
|
853
|
-
|
|
860
|
+
### deployment status
|
|
854
861
|
|
|
855
862
|
固定 Qwen 2.1 部署 status
|
|
856
863
|
|
|
@@ -862,7 +869,7 @@ v-cli art deployment status
|
|
|
862
869
|
|
|
863
870
|
- 只查询原部署,不重复启动
|
|
864
871
|
|
|
865
|
-
|
|
872
|
+
### deployment cancel
|
|
866
873
|
|
|
867
874
|
固定 Qwen 2.1 部署 cancel
|
|
868
875
|
|
|
@@ -874,7 +881,7 @@ v-cli art deployment cancel
|
|
|
874
881
|
|
|
875
882
|
- 请求取消;仅停止已核验子进程与本部署采样,确认后释放安装占用
|
|
876
883
|
|
|
877
|
-
|
|
884
|
+
### deployment recover
|
|
878
885
|
|
|
879
886
|
查询唯一原部署回执,不重新执行
|
|
880
887
|
|
|
@@ -886,7 +893,7 @@ v-cli art deployment recover
|
|
|
886
893
|
|
|
887
894
|
- 只读;无法唯一核验时停止未知
|
|
888
895
|
|
|
889
|
-
|
|
896
|
+
### job template
|
|
890
897
|
|
|
891
898
|
只读返回工具权威的任务配置模板;生成任务使用已冻结核心的题材
|
|
892
899
|
|
|
@@ -900,7 +907,7 @@ v-cli art job template --project <id> --kind <generate|edit> [--core <id>]
|
|
|
900
907
|
|
|
901
908
|
- 只读返回模板;不创建任务或文件
|
|
902
909
|
|
|
903
|
-
|
|
910
|
+
### job from-candidate
|
|
904
911
|
|
|
905
912
|
将完整候选导入私有底图,创建独立编辑草稿,不运行
|
|
906
913
|
|
|
@@ -915,7 +922,7 @@ v-cli art job from-candidate --project <id> --id <task> --run <id> --candidate <
|
|
|
915
922
|
|
|
916
923
|
- 写入新的编辑草稿和私有底图;保留候选来源;不启动生成
|
|
917
924
|
|
|
918
|
-
|
|
925
|
+
### task resume
|
|
919
926
|
|
|
920
927
|
仅恢复原上游任务的查询和下载,绝不重新提交
|
|
921
928
|
|
|
@@ -928,3 +935,11 @@ v-cli art task resume TASK
|
|
|
928
935
|
- 写入原任务状态
|
|
929
936
|
- 查询原上游任务并下载已有产物
|
|
930
937
|
- 提交结果未知时拒绝恢复
|
|
938
|
+
|
|
939
|
+
## 结果验证
|
|
940
|
+
|
|
941
|
+
按任务身份、停止证据和实际产物核验;只读检查不证明真实出图。
|
|
942
|
+
|
|
943
|
+
## 参考资料
|
|
944
|
+
|
|
945
|
+
[使用说明](../README.md) · [文档规范](documentation.md)
|
package/docs/configuration.md
CHANGED
|
@@ -1,6 +1,16 @@
|
|
|
1
|
-
# 配置与存储
|
|
1
|
+
# Vant 配置与存储
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## 定位
|
|
4
|
+
|
|
5
|
+
配置与存储,适用于当前随包实现。
|
|
6
|
+
|
|
7
|
+
## 前置条件
|
|
8
|
+
|
|
9
|
+
先按包的环境要求准备工程与工具,使用实际配置和命令帮助核对目标。
|
|
10
|
+
|
|
11
|
+
## 字段与示例
|
|
12
|
+
|
|
13
|
+
### 配置入口
|
|
4
14
|
|
|
5
15
|
`config path/show/init/validate` 分别查询位置、生效配置、创建模板和校验。`config init` 不覆盖已有文件。查询、发现和预演不创建参考目录;`config validate` 不联网、不启动服务。
|
|
6
16
|
|
|
@@ -20,7 +30,7 @@
|
|
|
20
30
|
|
|
21
31
|
Vant 显式传入绑定,把工程对象、参考、批次及图片集中在工程 `.vant/art`。独立 CLI 默认 workspace 可以容纳多个工程,不自动绑定当前 Git 工程。普通输入、计划和报告相对路径以 workspace 为基准;`check RUN` 相对批次以 output 为基准。参考源文件建议提供绝对路径。
|
|
22
32
|
|
|
23
|
-
|
|
33
|
+
### 后端配置
|
|
24
34
|
|
|
25
35
|
远程 provider 为后端类别标识;执行协议来自 credentialReference.api,缺省 DashScope。协议必须已注册,型号必须在该协议目录中精确登记且支持所需模式。provider 名称不是权限或协议兼容性的证明。
|
|
26
36
|
|
|
@@ -43,18 +53,30 @@ Vant 显式传入绑定,把工程对象、参考、批次及图片集中在工
|
|
|
43
53
|
|
|
44
54
|
ComfyUI 后端使用 provider=comfyui,声明 model、endpoints,以及可选 workflow、bindings、options、launch。省略 workflow 使用随包固定方案;自定义工作流必须是 API JSON,bindings 指向真实节点输入。endpoints 只允许本机 HTTP 根地址。launch 明确 executable/cwd/args;工具以 argv 启动,不拼接 shell。详情见 [本地部署](deployment.md)。
|
|
45
55
|
|
|
46
|
-
|
|
56
|
+
### 认证与实例
|
|
47
57
|
|
|
48
|
-
Vant 系统模型配置统一保存 Provider
|
|
58
|
+
Vant 系统模型配置统一保存 Provider 实例及凭据,工程只引用实例身份、修订及不含密钥的连接信息。模板只负责预填新实例,不是可执行连接。模型目录发现、能力登记、启用与账号权限是不同事实。
|
|
49
59
|
|
|
50
|
-
远程图片由组织层通过 ART_IMAGE_CONNECTION(api/baseUrl)和 ART_IMAGE_KEY
|
|
60
|
+
远程图片由组织层通过 ART_IMAGE_CONNECTION(api/baseUrl)和 ART_IMAGE_KEY 注入内存;明确连接缺少密钥时拒绝,不能回退另一份密钥或站点。直接调用 DashScope 使用固定版本百炼核心库的既有认证来源。
|
|
51
61
|
|
|
52
62
|
视觉分析独立使用 ART_VISION_CONFIG 与 ART_VISION_KEY,支持 openai-completions、openai-responses、anthropic-messages、google-generative-ai。未注入连接时分析走百炼 CLI。不要把图片输出模型当作视觉分析模型;分析要求图片输入和文字输出。
|
|
53
63
|
|
|
54
64
|
凭据不进入工程、计划、运行回执、日志或命令行。Token Plan 与按量渠道保留各自实例地址和密钥,不跨渠道回退。配置校验不证明凭据有效、模型授权或实际出图。
|
|
55
65
|
|
|
56
|
-
|
|
66
|
+
### 状态与共享环境
|
|
67
|
+
|
|
68
|
+
对象变更锁和执行登记归 workspace/.runtime;更换配置文件不产生另一套占用。共享服务登记归用户数据根的 state/art-services,环境索引、接入日志和证据归 state/art-environments。安装根保存模型、程序与 vant.art.config.json,控制数据写入用户 .vant 数据目录。
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
## 执行边界
|
|
73
|
+
|
|
74
|
+
字段、路径与权限以当前 schema、运行时校验和明确授权为准;配置有效不等于外部服务已执行成功。
|
|
75
|
+
|
|
76
|
+
## 结果验证
|
|
77
|
+
|
|
78
|
+
结合原始错误、结构化结果和实际产物核验;测试与真实平台执行分别记录。
|
|
57
79
|
|
|
58
|
-
|
|
80
|
+
## 参考资料
|
|
59
81
|
|
|
60
|
-
|
|
82
|
+
[使用说明](../README.md)
|
package/docs/core-guidance.md
CHANGED
|
@@ -1,8 +1,18 @@
|
|
|
1
|
-
# 风格核心职责与问题决策
|
|
1
|
+
# Vant 风格核心职责与问题决策
|
|
2
|
+
|
|
3
|
+
## 定位
|
|
4
|
+
|
|
5
|
+
风格核心职责与问题决策,适用于当前随包实现。
|
|
6
|
+
|
|
7
|
+
## 前置条件
|
|
8
|
+
|
|
9
|
+
先按包的环境要求准备工程与工具,使用实际配置和命令帮助核对目标。
|
|
10
|
+
|
|
11
|
+
## 操作流程
|
|
2
12
|
|
|
3
13
|
风格定义如何绘制。主体轮廓、比例、部件、姿态、身份色、物理材质、光源、构图与资产尺寸由任务决定。
|
|
4
14
|
|
|
5
|
-
|
|
15
|
+
### 最终规范
|
|
6
16
|
|
|
7
17
|
报告和核心使用 schemaVersion=3,项目与对象存储版本仍为2。recommendation 只含 rules:每条具有稳定 id、scope、strength、instruction、when。
|
|
8
18
|
|
|
@@ -13,14 +23,20 @@
|
|
|
13
23
|
|
|
14
24
|
生成提示保留条件与强度。带条件的避免规则不会被展开为全局负面提示。最终核心只使用规则,不把聊天记录、问题解释或证据局限混入生成规范。
|
|
15
25
|
|
|
16
|
-
|
|
26
|
+
### 报告与取舍
|
|
17
27
|
|
|
18
28
|
summary 概述当前方案,observations 保存分类证据,notes 保存不影响执行的提醒。issues 只表达真正需要用户选择的矛盾,每项有稳定 id、question、reopenReason 与2至5个 options。选项含 id、label、remove 规则ID和 upsert 规则。
|
|
19
29
|
|
|
20
|
-
style resolve 校验 revision、报告来源和选项,记录 issueId、问题指纹、optionId、用户依据和时间。选择应用于候选规范,不改变原始模型响应;reviewHistory
|
|
30
|
+
style resolve 校验 revision、报告来源和选项,记录 issueId、问题指纹、optionId、用户依据和时间。选择应用于候选规范,不改变原始模型响应;reviewHistory 记录历次选择。覆盖已有决定涉及的规则时,相关已记录决定重新打开,不静默覆盖。采用要求当前来源匹配、所有问题已有有效决定;notes 非空仍可采用。
|
|
21
31
|
|
|
22
32
|
修改草稿或参考保留报告并标记需复核。复核提供上一版方案和决定;同一证据、问题与选项不变时保留决定,新证据或明确重新打开理由要求重新确认。逐图观察按内容和分类契约缓存,未改变的图不重复请求。
|
|
23
33
|
|
|
24
|
-
## 历史数据
|
|
25
34
|
|
|
26
|
-
|
|
35
|
+
|
|
36
|
+
## 结果验证
|
|
37
|
+
|
|
38
|
+
结合原始错误、结构化结果和实际产物核验;测试与真实平台执行分别记录。
|
|
39
|
+
|
|
40
|
+
## 参考资料
|
|
41
|
+
|
|
42
|
+
[使用说明](../README.md)
|