@kevlns/art-workshop 0.1.3 → 0.2.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.
- package/AGENTS.md +60 -12
- package/README.md +72 -112
- package/art-workshop.mjs +35 -9
- package/docs/commands.md +82 -0
- package/docs/configuration.md +166 -0
- package/docs/core-guidance.md +80 -13
- package/docs/data-formats.md +167 -0
- package/docs/modes.md +140 -0
- package/docs/troubleshooting.md +84 -0
- package/docs//351/227/256/351/242/230/346/212/245/345/221/212-2026-10-08.md +29 -0
- package/lib/agent.mjs +3 -2
- package/lib/backends.mjs +89 -0
- package/lib/comfyui.mjs +62 -0
- package/lib/diagnostics.mjs +83 -0
- package/lib/providers.mjs +25 -0
- package/lib/runtime.mjs +23 -0
- package/lib/service.mjs +96 -0
- package/lib/settings.mjs +3 -2
- package/lib/shared.mjs +12 -2
- package/lib/task-worker.mjs +58 -0
- package/lib/tasks.mjs +81 -0
- package/lib/workflows.mjs +19 -0
- package/package.json +7 -5
- package/skills/art-workshop/SKILL.md +51 -24
- package/v-cli.plugin.json +250 -15
- package/workflows/vant-builtin-qwen-image-2.1-Q4-8GB.api.json +116 -0
- package/workflows/vant-builtin-qwen-image-2.1-Q4-8GB.json +648 -0
package/v-cli.plugin.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"package": "@kevlns/art-workshop",
|
|
4
4
|
"command": "art",
|
|
5
5
|
"bin": "art-workshop",
|
|
6
|
-
"description": "
|
|
6
|
+
"description": "美术工坊:风格分析与冻结、远程百炼和本地 ComfyUI 生图/编辑、配置环境检查、任务控制及人工验收。",
|
|
7
7
|
"platforms": [
|
|
8
8
|
"win32",
|
|
9
9
|
"linux",
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
],
|
|
12
12
|
"runtime": {
|
|
13
13
|
"node": ">=20",
|
|
14
|
-
"imageProvider": "
|
|
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": "
|
|
27
|
+
"whenToUse": "风格分析/冻结、远程或本地生图/编辑、工作流检测及任务管理。先 config show、agent index、config validate;远程核对百炼入口与认证,本地核对 workflow/doctor,具体任务先 plan 和 run --dry;按已有授权执行,任务失败读取 diagnostic,产物人工验收。",
|
|
28
28
|
"globalOptions": [
|
|
29
29
|
{
|
|
30
30
|
"flags": "--config <file>",
|
|
@@ -73,8 +73,7 @@
|
|
|
73
73
|
"1": "参数、配置、计划或执行失败"
|
|
74
74
|
},
|
|
75
75
|
"safety": [
|
|
76
|
-
"
|
|
77
|
-
"无网络调用"
|
|
76
|
+
"无配置读取、目录初始化、网络或模型调用"
|
|
78
77
|
]
|
|
79
78
|
},
|
|
80
79
|
{
|
|
@@ -199,12 +198,12 @@
|
|
|
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": "成功;验收状态以返回内容为准",
|
|
@@ -463,6 +462,10 @@
|
|
|
463
462
|
{
|
|
464
463
|
"flags": "--out <file>",
|
|
465
464
|
"description": "可选外部输出文件;相对路径基于 workspace"
|
|
465
|
+
},
|
|
466
|
+
{
|
|
467
|
+
"flags": "--backend <id>",
|
|
468
|
+
"description": "新计划选择配置中的远程/本地后端 ID;冻结计划不能覆盖"
|
|
466
469
|
}
|
|
467
470
|
],
|
|
468
471
|
"output": {
|
|
@@ -526,7 +529,15 @@
|
|
|
526
529
|
},
|
|
527
530
|
{
|
|
528
531
|
"flags": "--dry",
|
|
529
|
-
"description": "
|
|
532
|
+
"description": "预演所选请求;不联网、启动服务或上传,仍可补齐 refs 分类"
|
|
533
|
+
},
|
|
534
|
+
{
|
|
535
|
+
"flags": "--backend <id>",
|
|
536
|
+
"description": "选择统一配置中的后端;冻结计划不允许覆盖"
|
|
537
|
+
},
|
|
538
|
+
{
|
|
539
|
+
"flags": "--background",
|
|
540
|
+
"description": "后台执行并返回 taskId"
|
|
530
541
|
}
|
|
531
542
|
],
|
|
532
543
|
"output": {
|
|
@@ -539,9 +550,10 @@
|
|
|
539
550
|
},
|
|
540
551
|
"safety": [
|
|
541
552
|
"配置生效时补齐外部 refs 分类目录,不覆盖素材",
|
|
542
|
-
"
|
|
543
|
-
"
|
|
544
|
-
"
|
|
553
|
+
"远程非 dry 通过百炼调用模型,可能产生费用,按已有任务授权执行",
|
|
554
|
+
"本地非 dry 可启动任务和 ComfyUI 服务并采样,不调用百炼生图",
|
|
555
|
+
"真实执行写入外部图片、manifest、任务状态和诊断",
|
|
556
|
+
"dry 只展示请求,不启动或探测服务、不上传、不生成图片"
|
|
545
557
|
]
|
|
546
558
|
},
|
|
547
559
|
{
|
|
@@ -599,6 +611,10 @@
|
|
|
599
611
|
{
|
|
600
612
|
"flags": "--out <file>",
|
|
601
613
|
"description": "可选外部输出文件;相对路径基于 workspace"
|
|
614
|
+
},
|
|
615
|
+
{
|
|
616
|
+
"flags": "--backend <id>",
|
|
617
|
+
"description": "新计划选择配置中的远程/本地后端 ID;冻结计划不能覆盖"
|
|
602
618
|
}
|
|
603
619
|
],
|
|
604
620
|
"output": {
|
|
@@ -662,7 +678,15 @@
|
|
|
662
678
|
},
|
|
663
679
|
{
|
|
664
680
|
"flags": "--dry",
|
|
665
|
-
"description": "
|
|
681
|
+
"description": "预演所选请求;不联网、启动服务或上传,仍可补齐 refs 分类"
|
|
682
|
+
},
|
|
683
|
+
{
|
|
684
|
+
"flags": "--backend <id>",
|
|
685
|
+
"description": "选择统一配置中的后端;冻结计划不允许覆盖"
|
|
686
|
+
},
|
|
687
|
+
{
|
|
688
|
+
"flags": "--background",
|
|
689
|
+
"description": "后台执行并返回 taskId"
|
|
666
690
|
}
|
|
667
691
|
],
|
|
668
692
|
"output": {
|
|
@@ -675,9 +699,10 @@
|
|
|
675
699
|
},
|
|
676
700
|
"safety": [
|
|
677
701
|
"配置生效时补齐外部 refs 分类目录,不覆盖素材",
|
|
678
|
-
"
|
|
679
|
-
"
|
|
680
|
-
"
|
|
702
|
+
"远程非 dry 通过百炼调用模型,可能产生费用,按已有任务授权执行",
|
|
703
|
+
"本地非 dry 可启动任务和 ComfyUI 服务并采样,不调用百炼生图",
|
|
704
|
+
"真实执行写入外部图片、manifest、任务状态和诊断",
|
|
705
|
+
"dry 只展示请求,不启动或探测服务、不上传、不生成图片"
|
|
681
706
|
]
|
|
682
707
|
},
|
|
683
708
|
{
|
|
@@ -793,6 +818,216 @@
|
|
|
793
818
|
"配置生效时补齐外部 refs 分类目录,不覆盖素材",
|
|
794
819
|
"无网络调用"
|
|
795
820
|
]
|
|
821
|
+
},
|
|
822
|
+
{
|
|
823
|
+
"path": [
|
|
824
|
+
"task",
|
|
825
|
+
"list"
|
|
826
|
+
],
|
|
827
|
+
"usage": "art-workshop task list",
|
|
828
|
+
"description": "列出任务状态",
|
|
829
|
+
"arguments": [],
|
|
830
|
+
"options": [],
|
|
831
|
+
"output": {
|
|
832
|
+
"format": "json",
|
|
833
|
+
"description": "列出任务状态"
|
|
834
|
+
},
|
|
835
|
+
"exitCodes": {
|
|
836
|
+
"0": "成功",
|
|
837
|
+
"1": "失败;未确认停止时保留服务并报告"
|
|
838
|
+
},
|
|
839
|
+
"safety": [
|
|
840
|
+
"读取外部运行状态"
|
|
841
|
+
]
|
|
842
|
+
},
|
|
843
|
+
{
|
|
844
|
+
"path": [
|
|
845
|
+
"task",
|
|
846
|
+
"status"
|
|
847
|
+
],
|
|
848
|
+
"usage": "art-workshop task status TASK",
|
|
849
|
+
"description": "查看单次任务及后端 prompt_id",
|
|
850
|
+
"arguments": [
|
|
851
|
+
{
|
|
852
|
+
"name": "TASK",
|
|
853
|
+
"required": true,
|
|
854
|
+
"description": "art 任务 ID"
|
|
855
|
+
}
|
|
856
|
+
],
|
|
857
|
+
"options": [],
|
|
858
|
+
"output": {
|
|
859
|
+
"format": "json",
|
|
860
|
+
"description": "查看单次任务及后端 prompt_id"
|
|
861
|
+
},
|
|
862
|
+
"exitCodes": {
|
|
863
|
+
"0": "成功",
|
|
864
|
+
"1": "失败;未确认停止时保留服务并报告"
|
|
865
|
+
},
|
|
866
|
+
"safety": [
|
|
867
|
+
"读取外部运行状态"
|
|
868
|
+
]
|
|
869
|
+
},
|
|
870
|
+
{
|
|
871
|
+
"path": [
|
|
872
|
+
"task",
|
|
873
|
+
"wait"
|
|
874
|
+
],
|
|
875
|
+
"usage": "art-workshop task wait TASK",
|
|
876
|
+
"description": "等待任务结束;超时不取消任务",
|
|
877
|
+
"arguments": [
|
|
878
|
+
{
|
|
879
|
+
"name": "TASK",
|
|
880
|
+
"required": true,
|
|
881
|
+
"description": "art 任务 ID"
|
|
882
|
+
}
|
|
883
|
+
],
|
|
884
|
+
"options": [
|
|
885
|
+
{
|
|
886
|
+
"flags": "--timeout <seconds>",
|
|
887
|
+
"description": "等待秒数,默认 3600"
|
|
888
|
+
}
|
|
889
|
+
],
|
|
890
|
+
"output": {
|
|
891
|
+
"format": "json",
|
|
892
|
+
"description": "等待任务结束;超时不取消任务"
|
|
893
|
+
},
|
|
894
|
+
"exitCodes": {
|
|
895
|
+
"0": "成功",
|
|
896
|
+
"1": "失败;未确认停止时保留服务并报告"
|
|
897
|
+
},
|
|
898
|
+
"safety": [
|
|
899
|
+
"读取外部运行状态"
|
|
900
|
+
]
|
|
901
|
+
},
|
|
902
|
+
{
|
|
903
|
+
"path": [
|
|
904
|
+
"task",
|
|
905
|
+
"cancel"
|
|
906
|
+
],
|
|
907
|
+
"usage": "art-workshop task cancel TASK",
|
|
908
|
+
"description": "取消单次任务并等待停止",
|
|
909
|
+
"arguments": [
|
|
910
|
+
{
|
|
911
|
+
"name": "TASK",
|
|
912
|
+
"required": true,
|
|
913
|
+
"description": "art 任务 ID"
|
|
914
|
+
}
|
|
915
|
+
],
|
|
916
|
+
"options": [],
|
|
917
|
+
"output": {
|
|
918
|
+
"format": "json",
|
|
919
|
+
"description": "取消单次任务并等待停止"
|
|
920
|
+
},
|
|
921
|
+
"exitCodes": {
|
|
922
|
+
"0": "成功",
|
|
923
|
+
"1": "失败;未确认停止时保留服务并报告"
|
|
924
|
+
},
|
|
925
|
+
"safety": [
|
|
926
|
+
"取消单个任务",
|
|
927
|
+
"按 prompt_id 中断本地任务",
|
|
928
|
+
"保留服务进程"
|
|
929
|
+
]
|
|
930
|
+
},
|
|
931
|
+
{
|
|
932
|
+
"path": [
|
|
933
|
+
"shutdown"
|
|
934
|
+
],
|
|
935
|
+
"usage": "art-workshop shutdown",
|
|
936
|
+
"description": "停止所有任务、清空本地队列并关闭服务",
|
|
937
|
+
"arguments": [],
|
|
938
|
+
"options": [],
|
|
939
|
+
"output": {
|
|
940
|
+
"format": "json",
|
|
941
|
+
"description": "停止所有任务、清空本地队列并关闭服务"
|
|
942
|
+
},
|
|
943
|
+
"exitCodes": {
|
|
944
|
+
"0": "成功",
|
|
945
|
+
"1": "失败;未确认停止时保留服务并报告"
|
|
946
|
+
},
|
|
947
|
+
"safety": [
|
|
948
|
+
"停止配置范围内所有任务",
|
|
949
|
+
"清空 ComfyUI 队列并中断执行",
|
|
950
|
+
"核验进程身份后关闭服务",
|
|
951
|
+
"阻止 shutdown 期间的新任务"
|
|
952
|
+
]
|
|
953
|
+
},
|
|
954
|
+
{
|
|
955
|
+
"path": [
|
|
956
|
+
"config",
|
|
957
|
+
"validate"
|
|
958
|
+
],
|
|
959
|
+
"usage": "art-workshop config validate",
|
|
960
|
+
"description": "校验配置和 API workflow 的结构、连接与参数绑定",
|
|
961
|
+
"arguments": [],
|
|
962
|
+
"options": [
|
|
963
|
+
{
|
|
964
|
+
"flags": "--backend <id>",
|
|
965
|
+
"description": "仅检查指定后端"
|
|
966
|
+
}
|
|
967
|
+
],
|
|
968
|
+
"output": {
|
|
969
|
+
"format": "json",
|
|
970
|
+
"description": "校验配置和 API workflow 的结构、连接与参数绑定"
|
|
971
|
+
},
|
|
972
|
+
"exitCodes": {
|
|
973
|
+
"0": "检查通过",
|
|
974
|
+
"1": "检查失败"
|
|
975
|
+
},
|
|
976
|
+
"safety": [
|
|
977
|
+
"只读校验,不启动服务、不调用模型"
|
|
978
|
+
]
|
|
979
|
+
},
|
|
980
|
+
{
|
|
981
|
+
"path": [
|
|
982
|
+
"doctor"
|
|
983
|
+
],
|
|
984
|
+
"usage": "art-workshop doctor",
|
|
985
|
+
"description": "检测本地 ComfyUI 环境、节点与模型",
|
|
986
|
+
"arguments": [],
|
|
987
|
+
"options": [
|
|
988
|
+
{
|
|
989
|
+
"flags": "--backend <id>",
|
|
990
|
+
"description": "仅检查指定后端"
|
|
991
|
+
},
|
|
992
|
+
{
|
|
993
|
+
"flags": "--start",
|
|
994
|
+
"description": "无可用服务时按配置启动;不采样,检查后服务保留"
|
|
995
|
+
}
|
|
996
|
+
],
|
|
997
|
+
"output": {
|
|
998
|
+
"format": "json",
|
|
999
|
+
"description": "检测本地 ComfyUI 环境、节点与模型"
|
|
1000
|
+
},
|
|
1001
|
+
"exitCodes": {
|
|
1002
|
+
"0": "检查通过",
|
|
1003
|
+
"1": "检查失败"
|
|
1004
|
+
},
|
|
1005
|
+
"safety": [
|
|
1006
|
+
"默认读取本地环境,不启动、不采样、不补齐 refs",
|
|
1007
|
+
"--start 可启动并保留服务,写状态与日志;不采样",
|
|
1008
|
+
"远程后端只校验配置,不检查认证或云端连通性"
|
|
1009
|
+
]
|
|
1010
|
+
},
|
|
1011
|
+
{
|
|
1012
|
+
"path": [
|
|
1013
|
+
"workflow",
|
|
1014
|
+
"list"
|
|
1015
|
+
],
|
|
1016
|
+
"usage": "art-workshop workflow list",
|
|
1017
|
+
"description": "列出默认内置工作流及 API/UI 文件位置",
|
|
1018
|
+
"arguments": [],
|
|
1019
|
+
"options": [],
|
|
1020
|
+
"output": {
|
|
1021
|
+
"format": "json",
|
|
1022
|
+
"description": "列出默认内置工作流及 API/UI 文件位置"
|
|
1023
|
+
},
|
|
1024
|
+
"exitCodes": {
|
|
1025
|
+
"0": "检查通过",
|
|
1026
|
+
"1": "检查失败"
|
|
1027
|
+
},
|
|
1028
|
+
"safety": [
|
|
1029
|
+
"读取随包工作流清单,不依赖合法用户配置、不补 refs、不调用模型"
|
|
1030
|
+
]
|
|
796
1031
|
}
|
|
797
1032
|
]
|
|
798
1033
|
}
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
{
|
|
2
|
+
"1": {
|
|
3
|
+
"class_type": "UnetLoaderGGUF",
|
|
4
|
+
"inputs": {
|
|
5
|
+
"unet_name": "qwen-image-2.1-UC-Q4_K_M.gguf"
|
|
6
|
+
},
|
|
7
|
+
"_meta": {
|
|
8
|
+
"title": "加载 Qwen Q4 生图模型"
|
|
9
|
+
}
|
|
10
|
+
},
|
|
11
|
+
"2": {
|
|
12
|
+
"class_type": "CLIPLoader",
|
|
13
|
+
"inputs": {
|
|
14
|
+
"clip_name": "qwen3vl_8b_int8_convrot.safetensors",
|
|
15
|
+
"type": "qwen_image",
|
|
16
|
+
"device": "cpu"
|
|
17
|
+
},
|
|
18
|
+
"_meta": {
|
|
19
|
+
"title": "在 CPU 加载文字编码器"
|
|
20
|
+
}
|
|
21
|
+
},
|
|
22
|
+
"3": {
|
|
23
|
+
"class_type": "VAELoader",
|
|
24
|
+
"inputs": {
|
|
25
|
+
"vae_name": "qwen_image_2.1_vae_bf16.safetensors"
|
|
26
|
+
},
|
|
27
|
+
"_meta": {
|
|
28
|
+
"title": "加载图像解码模型 VAE"
|
|
29
|
+
}
|
|
30
|
+
},
|
|
31
|
+
"4": {
|
|
32
|
+
"class_type": "TextEncodeQwenImage21",
|
|
33
|
+
"inputs": {
|
|
34
|
+
"clip": [
|
|
35
|
+
"2",
|
|
36
|
+
0
|
|
37
|
+
],
|
|
38
|
+
"prompt": "",
|
|
39
|
+
"negative_prompt": "",
|
|
40
|
+
"resolution": 1024
|
|
41
|
+
},
|
|
42
|
+
"_meta": {
|
|
43
|
+
"title": "编码提示词与参考图"
|
|
44
|
+
}
|
|
45
|
+
},
|
|
46
|
+
"5": {
|
|
47
|
+
"class_type": "EmptyLatentImage",
|
|
48
|
+
"inputs": {
|
|
49
|
+
"width": 512,
|
|
50
|
+
"height": 512,
|
|
51
|
+
"batch_size": 1
|
|
52
|
+
},
|
|
53
|
+
"_meta": {
|
|
54
|
+
"title": "设置输出画布尺寸"
|
|
55
|
+
}
|
|
56
|
+
},
|
|
57
|
+
"6": {
|
|
58
|
+
"class_type": "KSampler",
|
|
59
|
+
"inputs": {
|
|
60
|
+
"model": [
|
|
61
|
+
"1",
|
|
62
|
+
0
|
|
63
|
+
],
|
|
64
|
+
"positive": [
|
|
65
|
+
"4",
|
|
66
|
+
0
|
|
67
|
+
],
|
|
68
|
+
"negative": [
|
|
69
|
+
"4",
|
|
70
|
+
1
|
|
71
|
+
],
|
|
72
|
+
"latent_image": [
|
|
73
|
+
"5",
|
|
74
|
+
0
|
|
75
|
+
],
|
|
76
|
+
"seed": 123456,
|
|
77
|
+
"steps": 25,
|
|
78
|
+
"cfg": 1,
|
|
79
|
+
"sampler_name": "euler",
|
|
80
|
+
"scheduler": "simple",
|
|
81
|
+
"denoise": 1
|
|
82
|
+
},
|
|
83
|
+
"_meta": {
|
|
84
|
+
"title": "采样生成图像潜空间"
|
|
85
|
+
}
|
|
86
|
+
},
|
|
87
|
+
"7": {
|
|
88
|
+
"class_type": "VAEDecode",
|
|
89
|
+
"inputs": {
|
|
90
|
+
"samples": [
|
|
91
|
+
"6",
|
|
92
|
+
0
|
|
93
|
+
],
|
|
94
|
+
"vae": [
|
|
95
|
+
"3",
|
|
96
|
+
0
|
|
97
|
+
]
|
|
98
|
+
},
|
|
99
|
+
"_meta": {
|
|
100
|
+
"title": "将潜空间解码为图片"
|
|
101
|
+
}
|
|
102
|
+
},
|
|
103
|
+
"8": {
|
|
104
|
+
"class_type": "SaveImage",
|
|
105
|
+
"inputs": {
|
|
106
|
+
"images": [
|
|
107
|
+
"7",
|
|
108
|
+
0
|
|
109
|
+
],
|
|
110
|
+
"filename_prefix": "Qwen_Image_2_1"
|
|
111
|
+
},
|
|
112
|
+
"_meta": {
|
|
113
|
+
"title": "保存生成图片"
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
}
|