@kevlns/art-workshop 0.3.6 → 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/docs/commands.md CHANGED
@@ -1,12 +1,16 @@
1
- # art 命令参考
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
- ## help
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
- ## config path
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
- ## config show
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
- ## config init
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
- ## refs guide
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
- ## agent index
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
- ## agent docs
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
- ## agent init
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
- ## list
133
+ ### list
128
134
 
129
135
  列出外部工作目录中的工程
130
136
 
@@ -136,7 +142,7 @@ v-cli art list
136
142
  - 查询与预演不创建参考目录
137
143
  - 无网络调用
138
144
 
139
- ## style analyze
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
- ## style validate
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
- ## style show
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
- ## generate show
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
- ## generate plan
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
- ## generate run
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
- ## edit show
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
- ## edit plan
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
- ## edit run
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
- ## check
313
+ ### check
308
314
 
309
315
  核验运行计划、执行归属、产物与文件哈希;不进行人工评分
310
316
 
@@ -316,7 +322,7 @@ v-cli art check RUN
316
322
 
317
323
  - 只读;不调用模型、不写入评分或定版记录
318
324
 
319
- ## compare
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
- ## task list
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
- ## task status
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
- ## task wait
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
- ## task cancel
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
- ## shutdown
390
+ ### shutdown
385
391
 
386
392
  停止当前工作区关联任务,核验共享队列和进程身份后关闭服务
387
393
 
@@ -395,7 +401,7 @@ v-cli art shutdown
395
401
  - 核验进程身份后关闭服务
396
402
  - 阻止 shutdown 期间的新任务
397
403
 
398
- ## config validate
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
- ## doctor
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
- ## workflow list
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
- ## style create
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
- ## style list
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
- ## style read
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
- ## style update
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
- ## style resolve
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
- ## style derive
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
- ## style discard
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
- ## job create
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
- ## job list
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
- ## job read
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
- ## job update
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
- ## job derive
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
- ## job discard
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
- ## style adopt
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
- ## style recover
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
- ## project init
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
- ## project upgrade
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
- ## reference list
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
- ## reference import
688
+ ### reference import
683
689
 
684
690
  导入对象私有图片
685
691
 
@@ -699,7 +705,7 @@ v-cli art reference import
699
705
 
700
706
  - 校验图片、大小、路径;复制不修改原图;不支持直接参考时拒绝
701
707
 
702
- ## reference remove
708
+ ### reference remove
703
709
 
704
710
  移除参考关联
705
711
 
@@ -715,7 +721,7 @@ v-cli art reference remove
715
721
 
716
722
  - 移除关联,保留历史证据资源
717
723
 
718
- ## candidate list
724
+ ### candidate list
719
725
 
720
726
  查看真实候选及完整性
721
727
 
@@ -729,7 +735,7 @@ v-cli art candidate list
729
735
 
730
736
  - 只读;校验批次计划和候选身份
731
737
 
732
- ## candidate finalizations
738
+ ### candidate finalizations
733
739
 
734
740
  查看资产定版
735
741
 
@@ -742,7 +748,7 @@ v-cli art candidate finalizations
742
748
 
743
749
  - 只读
744
750
 
745
- ## candidate finalize
751
+ ### candidate finalize
746
752
 
747
753
  按资产定版候选
748
754
 
@@ -760,7 +766,7 @@ v-cli art candidate finalize
760
766
 
761
767
  - 生成完成与哈希有效;重复幂等,替换保留历史
762
768
 
763
- ## candidate delete
769
+ ### candidate delete
764
770
 
765
771
  删除候选及关联定版
766
772
 
@@ -778,7 +784,7 @@ v-cli art candidate delete
778
784
 
779
785
  - 运行和引用检查;先持久化删除记录,再清理私有文件
780
786
 
781
- ## job analyze
787
+ ### job analyze
782
788
 
783
789
  分析任务动态参考,仅转写指定用途,不继承静态风格
784
790
 
@@ -794,7 +800,7 @@ v-cli art job analyze
794
800
 
795
801
  - dry 不联网、不写参考目录;执行创建运行身份和不可变参考证据;远程停止不确定时保留资源
796
802
 
797
- ## task recover
803
+ ### task recover
798
804
 
799
805
  仅从唯一原运行登记恢复身份;绝不重新执行
800
806
 
@@ -807,7 +813,7 @@ v-cli art task recover --project P --operation OPERATION
807
813
 
808
814
  - 读取外部运行状态
809
815
 
810
- ## reference update
816
+ ### reference update
811
817
 
812
818
  更新参考分类、任务用途与说明,版本校验并使分析失效
813
819
 
@@ -824,7 +830,7 @@ v-cli art reference update --project P --kind style --id ID --revision N --item
824
830
 
825
831
  - 冻结风格只读;任务不允许静态分类;不修改用户原图;旧证据保留
826
832
 
827
- ## deployment plan
833
+ ### deployment plan
828
834
 
829
835
  固定 Qwen 2.1 部署 plan
830
836
 
@@ -838,7 +844,7 @@ v-cli art deployment plan
838
844
 
839
845
  - 只读检测与预案;不下载、不启动、不采样
840
846
 
841
- ## deployment start
847
+ ### deployment start
842
848
 
843
849
  固定 Qwen 2.1 部署 start
844
850
 
@@ -851,7 +857,7 @@ v-cli art deployment start
851
857
 
852
858
  - 下载、源码安装、独立环境、模型哈希验证、生成及编辑采样;不覆写既有不匹配文件
853
859
 
854
- ## deployment status
860
+ ### deployment status
855
861
 
856
862
  固定 Qwen 2.1 部署 status
857
863
 
@@ -863,7 +869,7 @@ v-cli art deployment status
863
869
 
864
870
  - 只查询原部署,不重复启动
865
871
 
866
- ## deployment cancel
872
+ ### deployment cancel
867
873
 
868
874
  固定 Qwen 2.1 部署 cancel
869
875
 
@@ -875,7 +881,7 @@ v-cli art deployment cancel
875
881
 
876
882
  - 请求取消;仅停止已核验子进程与本部署采样,确认后释放安装占用
877
883
 
878
- ## deployment recover
884
+ ### deployment recover
879
885
 
880
886
  查询唯一原部署回执,不重新执行
881
887
 
@@ -887,7 +893,7 @@ v-cli art deployment recover
887
893
 
888
894
  - 只读;无法唯一核验时停止未知
889
895
 
890
- ## job template
896
+ ### job template
891
897
 
892
898
  只读返回工具权威的任务配置模板;生成任务使用已冻结核心的题材
893
899
 
@@ -901,7 +907,7 @@ v-cli art job template --project <id> --kind <generate|edit> [--core <id>]
901
907
 
902
908
  - 只读返回模板;不创建任务或文件
903
909
 
904
- ## job from-candidate
910
+ ### job from-candidate
905
911
 
906
912
  将完整候选导入私有底图,创建独立编辑草稿,不运行
907
913
 
@@ -916,7 +922,7 @@ v-cli art job from-candidate --project <id> --id <task> --run <id> --candidate <
916
922
 
917
923
  - 写入新的编辑草稿和私有底图;保留候选来源;不启动生成
918
924
 
919
- ## task resume
925
+ ### task resume
920
926
 
921
927
  仅恢复原上游任务的查询和下载,绝不重新提交
922
928
 
@@ -929,3 +935,11 @@ v-cli art task resume TASK
929
935
  - 写入原任务状态
930
936
  - 查询原上游任务并下载已有产物
931
937
  - 提交结果未知时拒绝恢复
938
+
939
+ ## 结果验证
940
+
941
+ 按任务身份、停止证据和实际产物核验;只读检查不证明真实出图。
942
+
943
+ ## 参考资料
944
+
945
+ [使用说明](../README.md) · [文档规范](documentation.md)
@@ -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 注入内存;明确连接缺少密钥时拒绝,不能回退另一份密钥或站点。独立 DashScope 使用固定版本百炼核心库的既有认证来源。
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
- 对象变更锁和执行登记归 workspace/.runtime;更换配置文件不产生另一套占用。共享服务登记归用户数据根的 state/art-services,环境索引、接入日志和证据归 state/art-environments。安装根保存模型、程序与 vant.art.config.json,不再新建 .vant-art 控制目录。
80
+ ## 参考资料
59
81
 
60
- 旧工程仅通过显式 project upgrade 备份转换;旧用户目录或环境状态不能靠文档重命名完成迁移。迁移与异常边界见 [数据结构](data-formats.md) 和 [诊断](troubleshooting.md)。
82
+ [使用说明](../README.md)
@@ -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 记录历次选择。覆盖已有决定涉及的规则时,相关旧决定重新打开,不静默覆盖。采用要求当前来源匹配、所有问题已有有效决定;notes 非空仍可采用。
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)