@kevlns/art-workshop 0.5.0 → 0.5.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 +25 -109
- package/LICENSE +21 -21
- package/README.md +63 -63
- package/art-workshop.mjs +174 -168
- package/docs/commands.md +116 -8
- package/docs/configuration.md +82 -82
- package/docs/core-guidance.md +50 -50
- package/docs/data-formats.md +85 -85
- package/docs/deployment.md +32 -32
- package/docs/local-models/qwen-image-2.1.json +73 -73
- package/docs/local-models/qwen-image-2.1.md +33 -33
- package/docs/model-architecture.md +78 -78
- package/docs/modes.md +67 -67
- package/lib/agent.mjs +32 -47
- package/lib/analysis-worker.mjs +32 -29
- package/lib/analyze.mjs +85 -78
- package/lib/asset-profile.mjs +23 -21
- package/lib/candidates.mjs +103 -101
- package/lib/comfy-recovery.mjs +17 -17
- package/lib/conversation.mjs +77 -0
- package/lib/core.mjs +75 -89
- package/lib/deployment-guide.mjs +12 -12
- package/lib/design.mjs +29 -29
- package/lib/dimensions.mjs +22 -22
- package/lib/edit.mjs +41 -40
- package/lib/environment-operations.mjs +49 -49
- package/lib/environment-runtime.mjs +99 -99
- package/lib/environments.mjs +55 -55
- package/lib/errors.mjs +32 -0
- package/lib/executor.mjs +107 -107
- package/lib/generate.mjs +58 -57
- package/lib/heartbeat.mjs +16 -16
- package/lib/images.mjs +1 -1
- package/lib/lifecycle.mjs +53 -53
- package/lib/migration.mjs +154 -154
- package/lib/object-format.mjs +112 -0
- package/lib/process-identity.mjs +14 -14
- package/lib/project.mjs +39 -39
- package/lib/refs.mjs +26 -26
- package/lib/runtime.mjs +25 -25
- package/lib/service.mjs +126 -126
- package/lib/settings.mjs +50 -50
- package/lib/shared.mjs +67 -66
- package/lib/style-bundle.mjs +85 -85
- package/lib/style-contract.mjs +74 -35
- package/lib/style-evidence.mjs +39 -0
- package/lib/style-lifecycle.mjs +125 -120
- package/lib/style-report.mjs +201 -0
- package/lib/style-review.mjs +14 -75
- package/lib/task-contract.mjs +93 -91
- package/lib/tasks.mjs +497 -495
- package/lib/templates.mjs +80 -74
- package/lib/vision.mjs +56 -46
- package/lib/workspace.mjs +292 -238
- package/package.json +3 -5
- package/rules/core-guidance.json +22 -22
- package/skills/art-workshop/SKILL.md +17 -116
- package/skills/art-workshop/references/conversation.md +11 -0
- package/skills/art-workshop/references/expression.md +27 -0
- package/skills/art-workshop/references/getty.md +76 -0
- package/skills/art-workshop/references/project.md +109 -0
- package/skills/art-workshop/references/style-discussion.md +27 -0
- package/skills/art-workshop/scripts/getty.py +269 -0
- package/v-cli.plugin.json +2747 -2491
- package/scripts/sync-skill.mjs +0 -6
- /package/{skills/art-workshop → adapters/codex}/agents/openai.yaml +0 -0
|
@@ -1,73 +1,73 @@
|
|
|
1
|
-
{
|
|
2
|
-
"id": "qwen-image-2.1-Q4-cpu-text-v1",
|
|
3
|
-
"comfy": {
|
|
4
|
-
"repository": "https://github.com/Comfy-Org/ComfyUI",
|
|
5
|
-
"commit": "b0b743566f65daafc423b4fea8a2fbda94b3384a"
|
|
6
|
-
},
|
|
7
|
-
"plugin": {
|
|
8
|
-
"repository": "https://github.com/leejet/ComfyUI-GGUF",
|
|
9
|
-
"commit": "373048b8403a7820620065210a691263d4da0a61"
|
|
10
|
-
},
|
|
11
|
-
"models": [
|
|
12
|
-
{
|
|
13
|
-
"path": "diffusion_models/qwen-image-2.1-UC-Q4_K_M.gguf",
|
|
14
|
-
"bytes": 4604558112,
|
|
15
|
-
"url": "https://huggingface.co/abenzerps/Qwen-Image-2.1-Uncensored-GGUF/resolve/main/qwen-image-2.1-UC-Q4_K_M.gguf",
|
|
16
|
-
"sha256": "e79c8a009f2ecbdb6c70fd663d9aea9ee304a0d91f347e4169a756b8ad141b41"
|
|
17
|
-
},
|
|
18
|
-
{
|
|
19
|
-
"path": "text_encoders/qwen3vl_8b_int8_convrot.safetensors",
|
|
20
|
-
"bytes": 9350798360,
|
|
21
|
-
"url": "https://huggingface.co/Comfy-Org/Qwen-Image-2.1/resolve/main/text_encoders/qwen3vl_8b_int8_convrot.safetensors",
|
|
22
|
-
"sha256": "8bfd0f6e12abf2d2d697ecc888e5e90b0d6741d6708f05799f53afa560452e8f"
|
|
23
|
-
},
|
|
24
|
-
{
|
|
25
|
-
"path": "vae/qwen_image_2.1_vae_bf16.safetensors",
|
|
26
|
-
"bytes": 675509688,
|
|
27
|
-
"url": "https://huggingface.co/Comfy-Org/Qwen-Image-2.1/resolve/main/vae/qwen_image_2.1_vae_bf16.safetensors",
|
|
28
|
-
"sha256": "bb21f7473051e1ac368515dd3f2e15cd44d7a11748ee8823e1ddca3e4876b7c9"
|
|
29
|
-
}
|
|
30
|
-
],
|
|
31
|
-
"torch": "2.14.0",
|
|
32
|
-
"torchvision": "0.29.0",
|
|
33
|
-
"torchIndex": "https://download.pytorch.org/whl/cu130",
|
|
34
|
-
"gguf": "0.19.0",
|
|
35
|
-
"backend": {
|
|
36
|
-
"provider": "comfyui",
|
|
37
|
-
"model": "qwen-image-2.1-UC-Q4_K_M.gguf",
|
|
38
|
-
"workflow": "vant-builtin-qwen-image-2.1-Q4-8GB"
|
|
39
|
-
},
|
|
40
|
-
"pythonCandidates": [
|
|
41
|
-
"python_embeded/python.exe",
|
|
42
|
-
".venv/Scripts/python.exe"
|
|
43
|
-
],
|
|
44
|
-
"launchArgs": [
|
|
45
|
-
"-s",
|
|
46
|
-
"ComfyUI/main.py",
|
|
47
|
-
"--disable-dynamic-vram",
|
|
48
|
-
"--lowvram",
|
|
49
|
-
"--disable-auto-launch"
|
|
50
|
-
],
|
|
51
|
-
"requiredPaths": [
|
|
52
|
-
"ComfyUI/main.py",
|
|
53
|
-
"ComfyUI/custom_nodes/ComfyUI-GGUF"
|
|
54
|
-
],
|
|
55
|
-
"python": {
|
|
56
|
-
"min": [
|
|
57
|
-
3,
|
|
58
|
-
11
|
|
59
|
-
],
|
|
60
|
-
"maxExclusive": [
|
|
61
|
-
3,
|
|
62
|
-
13
|
|
63
|
-
],
|
|
64
|
-
"preferred": "3.12",
|
|
65
|
-
"windowsPortable": {
|
|
66
|
-
"url": "https://www.python.org/ftp/python/3.12.10/python-3.12.10-embed-amd64.zip",
|
|
67
|
-
"sha256": "4acbed6dd1c744b0376e3b1cf57ce906f9dc9e95e68824584c8099a63025a3c3",
|
|
68
|
-
"pipUrl": "https://bootstrap.pypa.io/get-pip.py",
|
|
69
|
-
"pipSha256": "f4448a01e3ab2914c65f4ca59d4cacba6b2dbde19a483fbac46587f8bbaff424",
|
|
70
|
-
"pipVersion": "26.1.2"
|
|
71
|
-
}
|
|
72
|
-
}
|
|
73
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"id": "qwen-image-2.1-Q4-cpu-text-v1",
|
|
3
|
+
"comfy": {
|
|
4
|
+
"repository": "https://github.com/Comfy-Org/ComfyUI",
|
|
5
|
+
"commit": "b0b743566f65daafc423b4fea8a2fbda94b3384a"
|
|
6
|
+
},
|
|
7
|
+
"plugin": {
|
|
8
|
+
"repository": "https://github.com/leejet/ComfyUI-GGUF",
|
|
9
|
+
"commit": "373048b8403a7820620065210a691263d4da0a61"
|
|
10
|
+
},
|
|
11
|
+
"models": [
|
|
12
|
+
{
|
|
13
|
+
"path": "diffusion_models/qwen-image-2.1-UC-Q4_K_M.gguf",
|
|
14
|
+
"bytes": 4604558112,
|
|
15
|
+
"url": "https://huggingface.co/abenzerps/Qwen-Image-2.1-Uncensored-GGUF/resolve/main/qwen-image-2.1-UC-Q4_K_M.gguf",
|
|
16
|
+
"sha256": "e79c8a009f2ecbdb6c70fd663d9aea9ee304a0d91f347e4169a756b8ad141b41"
|
|
17
|
+
},
|
|
18
|
+
{
|
|
19
|
+
"path": "text_encoders/qwen3vl_8b_int8_convrot.safetensors",
|
|
20
|
+
"bytes": 9350798360,
|
|
21
|
+
"url": "https://huggingface.co/Comfy-Org/Qwen-Image-2.1/resolve/main/text_encoders/qwen3vl_8b_int8_convrot.safetensors",
|
|
22
|
+
"sha256": "8bfd0f6e12abf2d2d697ecc888e5e90b0d6741d6708f05799f53afa560452e8f"
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
"path": "vae/qwen_image_2.1_vae_bf16.safetensors",
|
|
26
|
+
"bytes": 675509688,
|
|
27
|
+
"url": "https://huggingface.co/Comfy-Org/Qwen-Image-2.1/resolve/main/vae/qwen_image_2.1_vae_bf16.safetensors",
|
|
28
|
+
"sha256": "bb21f7473051e1ac368515dd3f2e15cd44d7a11748ee8823e1ddca3e4876b7c9"
|
|
29
|
+
}
|
|
30
|
+
],
|
|
31
|
+
"torch": "2.14.0",
|
|
32
|
+
"torchvision": "0.29.0",
|
|
33
|
+
"torchIndex": "https://download.pytorch.org/whl/cu130",
|
|
34
|
+
"gguf": "0.19.0",
|
|
35
|
+
"backend": {
|
|
36
|
+
"provider": "comfyui",
|
|
37
|
+
"model": "qwen-image-2.1-UC-Q4_K_M.gguf",
|
|
38
|
+
"workflow": "vant-builtin-qwen-image-2.1-Q4-8GB"
|
|
39
|
+
},
|
|
40
|
+
"pythonCandidates": [
|
|
41
|
+
"python_embeded/python.exe",
|
|
42
|
+
".venv/Scripts/python.exe"
|
|
43
|
+
],
|
|
44
|
+
"launchArgs": [
|
|
45
|
+
"-s",
|
|
46
|
+
"ComfyUI/main.py",
|
|
47
|
+
"--disable-dynamic-vram",
|
|
48
|
+
"--lowvram",
|
|
49
|
+
"--disable-auto-launch"
|
|
50
|
+
],
|
|
51
|
+
"requiredPaths": [
|
|
52
|
+
"ComfyUI/main.py",
|
|
53
|
+
"ComfyUI/custom_nodes/ComfyUI-GGUF"
|
|
54
|
+
],
|
|
55
|
+
"python": {
|
|
56
|
+
"min": [
|
|
57
|
+
3,
|
|
58
|
+
11
|
|
59
|
+
],
|
|
60
|
+
"maxExclusive": [
|
|
61
|
+
3,
|
|
62
|
+
13
|
|
63
|
+
],
|
|
64
|
+
"preferred": "3.12",
|
|
65
|
+
"windowsPortable": {
|
|
66
|
+
"url": "https://www.python.org/ftp/python/3.12.10/python-3.12.10-embed-amd64.zip",
|
|
67
|
+
"sha256": "4acbed6dd1c744b0376e3b1cf57ce906f9dc9e95e68824584c8099a63025a3c3",
|
|
68
|
+
"pipUrl": "https://bootstrap.pypa.io/get-pip.py",
|
|
69
|
+
"pipSha256": "f4448a01e3ab2914c65f4ca59d4cacba6b2dbde19a483fbac46587f8bbaff424",
|
|
70
|
+
"pipVersion": "26.1.2"
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
@@ -1,33 +1,33 @@
|
|
|
1
|
-
# Vant 本地图片模型部署指南
|
|
2
|
-
|
|
3
|
-
## 目标
|
|
4
|
-
|
|
5
|
-
在用户指定目录部署或复用 ComfyUI 环境,接入 Qwen Image 2.1 Q4 图片生成及编辑。模型文件、固定版本与校验值读取同目录 JSON 契约,不猜测版本。根据实际系统、显卡、磁盘和网络制定命令;执行前明确任务范围。
|
|
6
|
-
|
|
7
|
-
## 检测
|
|
8
|
-
|
|
9
|
-
先读取 art environment guide,检测系统、GPU/显存、驱动、内存、磁盘、Git、Python、下载工具、端口以及已有环境。优先复用用户指定目录或 art 环境索引;不全盘扫描。没有 Git 可选择发行包下载,不重复执行失败命令。用户已有源码、虚拟环境和模型不直接覆盖。
|
|
10
|
-
|
|
11
|
-
## 执行
|
|
12
|
-
|
|
13
|
-
使用 Pi 基础工具与 Harness 受管进程执行。创建动态工作流,节点为检查环境、准备运行时、安装依赖、下载模型、配置服务、验证能力。命令、错误和产物保存到任务记录。按实际反馈修正当前节点,成功节点不重复执行。
|
|
14
|
-
|
|
15
|
-
先执行 environment prepare --directory <目标目录> --guide <指南ID>,自动选择契约支持的 Python 版本、复用兼容环境或保留旧虚拟环境后创建新环境;不要直接使用系统默认 Python。Windows 未发现兼容版本时自动下载契约固定且校验哈希的 Python 便携包与 pip 引导脚本,仅安装到目标目录,不修改系统 Python。源码检出契约指定提交,依赖安装在该 Python 环境。按模型契约将文件下载到 ComfyUI/models 下,先写临时文件,校验 SHA256 后改为最终文件;保留有效文件并支持续传。网络失败时检查已有代理,仅在当前命令使用,不修改系统代理。不自行安装或更新全局 npm 工具。
|
|
16
|
-
|
|
17
|
-
低显存方案将文本编码器放在 CPU,服务使用 --disable-dynamic-vram --lowvram --disable-auto-launch。不要承诺显存一定充足。服务仅监听回环地址。端口占用时核对服务身份,不能将另一套环境误登记为当前目录。
|
|
18
|
-
|
|
19
|
-
## 验收
|
|
20
|
-
|
|
21
|
-
分别记录文件校验、服务连通、节点/工作流能力和真实采样。安装阶段用 environment inspect 检查文件大小、Python 版本和服务能力;最终登记统一完成 SHA256 验收,避免无变更反复扫描所有大文件。独立排障可使用 environment verify。真实生成和编辑通过 art 的计划及任务机制执行,保存原 taskId,不重复提交未知请求。只有实际图像及完成回执能够证明采样成功。
|
|
22
|
-
|
|
23
|
-
在 Vant 部署任务中,成功后由 Harness 唯一执行 environment register 完整核验并登记;动态脚本不登记。不在 Vant 中执行时,由调用方使用 environment register。能力验收不等于采样验证;缺少真实采样时明确展示。登记完成再更新 Vant 的本地环境设置。
|
|
24
|
-
|
|
25
|
-
## 取消与恢复
|
|
26
|
-
|
|
27
|
-
用户普通插话不终止工作流。工作流停止时等待本任务进程实际退出,保留已校验模型、已有用户文件与执行证据。只停止能够核验身份的本任务服务,不能杀全部 Python 或关闭用户原有服务。恢复时先读任务记录、检查原进程与文件;未知副作用先核实,不重跑整个安装。关闭部署窗口不取消任务。
|
|
28
|
-
|
|
29
|
-
## 版权
|
|
30
|
-
|
|
31
|
-
Copyright © 2026 Vant。
|
|
32
|
-
|
|
33
|
-
长时安装和下载节点设置 timeoutMs(不超过 86400000),保持进度日志和取消能力;使用断点续传,失败只修复当前步骤,不重新下载已校验文件。
|
|
1
|
+
# Vant 本地图片模型部署指南
|
|
2
|
+
|
|
3
|
+
## 目标
|
|
4
|
+
|
|
5
|
+
在用户指定目录部署或复用 ComfyUI 环境,接入 Qwen Image 2.1 Q4 图片生成及编辑。模型文件、固定版本与校验值读取同目录 JSON 契约,不猜测版本。根据实际系统、显卡、磁盘和网络制定命令;执行前明确任务范围。
|
|
6
|
+
|
|
7
|
+
## 检测
|
|
8
|
+
|
|
9
|
+
先读取 art environment guide,检测系统、GPU/显存、驱动、内存、磁盘、Git、Python、下载工具、端口以及已有环境。优先复用用户指定目录或 art 环境索引;不全盘扫描。没有 Git 可选择发行包下载,不重复执行失败命令。用户已有源码、虚拟环境和模型不直接覆盖。
|
|
10
|
+
|
|
11
|
+
## 执行
|
|
12
|
+
|
|
13
|
+
使用 Pi 基础工具与 Harness 受管进程执行。创建动态工作流,节点为检查环境、准备运行时、安装依赖、下载模型、配置服务、验证能力。命令、错误和产物保存到任务记录。按实际反馈修正当前节点,成功节点不重复执行。
|
|
14
|
+
|
|
15
|
+
先执行 environment prepare --directory <目标目录> --guide <指南ID>,自动选择契约支持的 Python 版本、复用兼容环境或保留旧虚拟环境后创建新环境;不要直接使用系统默认 Python。Windows 未发现兼容版本时自动下载契约固定且校验哈希的 Python 便携包与 pip 引导脚本,仅安装到目标目录,不修改系统 Python。源码检出契约指定提交,依赖安装在该 Python 环境。按模型契约将文件下载到 ComfyUI/models 下,先写临时文件,校验 SHA256 后改为最终文件;保留有效文件并支持续传。网络失败时检查已有代理,仅在当前命令使用,不修改系统代理。不自行安装或更新全局 npm 工具。
|
|
16
|
+
|
|
17
|
+
低显存方案将文本编码器放在 CPU,服务使用 --disable-dynamic-vram --lowvram --disable-auto-launch。不要承诺显存一定充足。服务仅监听回环地址。端口占用时核对服务身份,不能将另一套环境误登记为当前目录。
|
|
18
|
+
|
|
19
|
+
## 验收
|
|
20
|
+
|
|
21
|
+
分别记录文件校验、服务连通、节点/工作流能力和真实采样。安装阶段用 environment inspect 检查文件大小、Python 版本和服务能力;最终登记统一完成 SHA256 验收,避免无变更反复扫描所有大文件。独立排障可使用 environment verify。真实生成和编辑通过 art 的计划及任务机制执行,保存原 taskId,不重复提交未知请求。只有实际图像及完成回执能够证明采样成功。
|
|
22
|
+
|
|
23
|
+
在 Vant 部署任务中,成功后由 Harness 唯一执行 environment register 完整核验并登记;动态脚本不登记。不在 Vant 中执行时,由调用方使用 environment register。能力验收不等于采样验证;缺少真实采样时明确展示。登记完成再更新 Vant 的本地环境设置。
|
|
24
|
+
|
|
25
|
+
## 取消与恢复
|
|
26
|
+
|
|
27
|
+
用户普通插话不终止工作流。工作流停止时等待本任务进程实际退出,保留已校验模型、已有用户文件与执行证据。只停止能够核验身份的本任务服务,不能杀全部 Python 或关闭用户原有服务。恢复时先读任务记录、检查原进程与文件;未知副作用先核实,不重跑整个安装。关闭部署窗口不取消任务。
|
|
28
|
+
|
|
29
|
+
## 版权
|
|
30
|
+
|
|
31
|
+
Copyright © 2026 Vant。
|
|
32
|
+
|
|
33
|
+
长时安装和下载节点设置 timeoutMs(不超过 86400000),保持进度日志和取消能力;使用断点续传,失败只修复当前步骤,不重新下载已校验文件。
|
|
@@ -1,78 +1,78 @@
|
|
|
1
|
-
# Vant 模型与执行架构
|
|
2
|
-
|
|
3
|
-
## 定位
|
|
4
|
-
|
|
5
|
-
模型与执行架构,适用于当前随包实现。
|
|
6
|
-
|
|
7
|
-
## 前置条件
|
|
8
|
-
|
|
9
|
-
先按包的环境要求准备工程与工具,使用实际配置和命令帮助核对目标。
|
|
10
|
-
|
|
11
|
-
## 字段与示例
|
|
12
|
-
|
|
13
|
-
模型扩展不修改任务调度和界面判断。未知型号、未知协议、无效响应都明确失败;提交结果未知时禁止重复提交。
|
|
14
|
-
|
|
15
|
-
| 模块 | 职责 |
|
|
16
|
-
| --- | --- |
|
|
17
|
-
| `lib/model-catalog.mjs` | 模型型号、输入输出能力、参数规则、尺寸、协议操作和展示说明 |
|
|
18
|
-
| `lib/model-registry.mjs` | 启动时验证并索引定义;提供执行契约及统一资格判断 |
|
|
19
|
-
| `lib/generation-policy.mjs` | 校验、规范化请求、记录参数转换、冻结和复核执行契约 |
|
|
20
|
-
| `lib/adapters/` | 协议登记、准备输入、序列化、提交、查询、响应解析 |
|
|
21
|
-
| `lib/execution/remote.mjs` | 持久化回执后轮询、取消等待、恢复原任务、下载原结果 |
|
|
22
|
-
| `lib/transport/` | 有界 HTTP/JSON 与 CLI 子进程,不承载模型判断 |
|
|
23
|
-
|
|
24
|
-
界面与配置保存共用 `modelEligibility`。接口类型列表由适配器注册表提供;模型发现只补齐准确型号的声明能力,不推定账号权限或自动启用。
|
|
25
|
-
|
|
26
|
-
### 扩展规则
|
|
27
|
-
|
|
28
|
-
同协议新模型增加完整模型定义与契约测试。字段规则描述类型、默认值、范围或枚举及协议字段名;参数由模型契约声明。模型声明在启动时检查重复标识、必要限制和协议字段。
|
|
29
|
-
|
|
30
|
-
新协议实现 `prepare / submit / query`,通过 `createAdapterRegistry` 登记。同步提交返回完成结果;异步提交返回上游任务身份。界面、任务运行时不包含型号名称分支。输入文件限制由模型声明提供。
|
|
31
|
-
|
|
32
|
-
`art/model-contract-v1` 排除型号别名列表、展示说明、来源链接及 CLI 示例字段;这些文案变化不改变执行哈希。`art/image-request-v1` 保存规范化请求,`art/execution-contract-v1` 冻结逐项契约。请求参数、尺寸、转换策略或协议规则变化必须重新预演。没有当前执行契约的失效预案不能启动。
|
|
33
|
-
|
|
34
|
-
### 任务选择
|
|
35
|
-
|
|
36
|
-
视觉分析由当前对象 config.analysis 选择,生成由当前任务 config.generation 选择;聊天模型与执行模型独立。宿主只管理连接定义与凭据注入,不维护跨任务的默认模型。计划冻结所选后端、真实模型与连接身份;切换其他任务的模型不使当前任务的计划失效,当前任务选择或连接变化则重新编译。
|
|
37
|
-
|
|
38
|
-
### 生命周期
|
|
39
|
-
|
|
40
|
-
每个计划项分别保存 `remoteExecutions[inputHash]`,包括 schema=art/remote-receipt-v1、请求哈希、适配器及版本、服务地址、提交时间、上游任务 ID 和结果。回执不保存 API Key。
|
|
41
|
-
|
|
42
|
-
1. `prepare` 先检查凭据与输入,不发起生成。
|
|
43
|
-
2. 持久化 `dispatching` 后才能 POST。
|
|
44
|
-
3. 持久化 `accepted + taskId` 后才能查询。
|
|
45
|
-
4. 持久化 `completed + urls` 后才能下载。
|
|
46
|
-
5. 下载采用临时文件和排他发布,不覆盖已有不同内容的产物。
|
|
47
|
-
|
|
48
|
-
提交中断而无任务 ID 的运行保持未知,不能重发。取消等待不等于上游取消;适配器没有停止能力时保留任务身份和占用。
|
|
49
|
-
|
|
50
|
-
```sh
|
|
51
|
-
v-cli art task resume TASK
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
`task resume` 仅恢复原上游任务查询或原结果下载,不调用提交接口,也不补发尚未提交的项目。已有成功产物跳过;参数及请求身份不同、原工作进程仍活着、原提交结果未知均拒绝恢复。恢复沿用 taskId、manifest 和每项输入哈希。
|
|
55
|
-
|
|
56
|
-
上游已完成而本地下载失败时,恢复原运行取回结果,不能通过失败项重试再次付费生成。原运行查询入口 `task recover --operation` 仍只查登记,不隐式启动工作进程。
|
|
57
|
-
|
|
58
|
-
Vant 通过 `ART_IMAGE_CONNECTION` 和 `ART_IMAGE_KEY` 注入连接,不绑定厂商命名。单独使用 DashScope 时,适配器通过固定版本的百炼核心库读取既有 API Key 配置;明确注入连接后不回退到其他凭据或站点。
|
|
59
|
-
|
|
60
|
-
### 验证边界
|
|
61
|
-
|
|
62
|
-
单元与协议模拟验证声明扩展、统一筛选、严格响应和回执顺序;真实子进程测试验证工作进程丢失及取消后恢复,统计生成 POST 次数不增加。上述验证不等同于付费模型真实出图或已安装版本更新。
|
|
63
|
-
|
|
64
|
-
新模型至少覆盖合法请求、参数边界、模式和输入拒绝;新协议还需覆盖提交结果未知、持久化失败、按原身份恢复、取消及下载失败。HTTP 响应体、下载大小和时间有界;认证请求禁止重定向,下载不携带模型密钥。当前查询异常保留身份并停止等待,不自动重试查询或提交。
|
|
65
|
-
|
|
66
|
-
[适配目录](remote-models.md) · [任务控制](troubleshooting.md) · [配置](configuration.md)
|
|
67
|
-
|
|
68
|
-
## 执行边界
|
|
69
|
-
|
|
70
|
-
字段、路径与权限以当前 schema、运行时校验和明确授权为准;配置有效不等于外部服务已执行成功。
|
|
71
|
-
|
|
72
|
-
## 结果验证
|
|
73
|
-
|
|
74
|
-
结合原始错误、结构化结果和实际产物核验;测试与真实平台执行分别记录。
|
|
75
|
-
|
|
76
|
-
## 参考资料
|
|
77
|
-
|
|
78
|
-
[使用说明](../README.md)
|
|
1
|
+
# Vant 模型与执行架构
|
|
2
|
+
|
|
3
|
+
## 定位
|
|
4
|
+
|
|
5
|
+
模型与执行架构,适用于当前随包实现。
|
|
6
|
+
|
|
7
|
+
## 前置条件
|
|
8
|
+
|
|
9
|
+
先按包的环境要求准备工程与工具,使用实际配置和命令帮助核对目标。
|
|
10
|
+
|
|
11
|
+
## 字段与示例
|
|
12
|
+
|
|
13
|
+
模型扩展不修改任务调度和界面判断。未知型号、未知协议、无效响应都明确失败;提交结果未知时禁止重复提交。
|
|
14
|
+
|
|
15
|
+
| 模块 | 职责 |
|
|
16
|
+
| --- | --- |
|
|
17
|
+
| `lib/model-catalog.mjs` | 模型型号、输入输出能力、参数规则、尺寸、协议操作和展示说明 |
|
|
18
|
+
| `lib/model-registry.mjs` | 启动时验证并索引定义;提供执行契约及统一资格判断 |
|
|
19
|
+
| `lib/generation-policy.mjs` | 校验、规范化请求、记录参数转换、冻结和复核执行契约 |
|
|
20
|
+
| `lib/adapters/` | 协议登记、准备输入、序列化、提交、查询、响应解析 |
|
|
21
|
+
| `lib/execution/remote.mjs` | 持久化回执后轮询、取消等待、恢复原任务、下载原结果 |
|
|
22
|
+
| `lib/transport/` | 有界 HTTP/JSON 与 CLI 子进程,不承载模型判断 |
|
|
23
|
+
|
|
24
|
+
界面与配置保存共用 `modelEligibility`。接口类型列表由适配器注册表提供;模型发现只补齐准确型号的声明能力,不推定账号权限或自动启用。
|
|
25
|
+
|
|
26
|
+
### 扩展规则
|
|
27
|
+
|
|
28
|
+
同协议新模型增加完整模型定义与契约测试。字段规则描述类型、默认值、范围或枚举及协议字段名;参数由模型契约声明。模型声明在启动时检查重复标识、必要限制和协议字段。
|
|
29
|
+
|
|
30
|
+
新协议实现 `prepare / submit / query`,通过 `createAdapterRegistry` 登记。同步提交返回完成结果;异步提交返回上游任务身份。界面、任务运行时不包含型号名称分支。输入文件限制由模型声明提供。
|
|
31
|
+
|
|
32
|
+
`art/model-contract-v1` 排除型号别名列表、展示说明、来源链接及 CLI 示例字段;这些文案变化不改变执行哈希。`art/image-request-v1` 保存规范化请求,`art/execution-contract-v1` 冻结逐项契约。请求参数、尺寸、转换策略或协议规则变化必须重新预演。没有当前执行契约的失效预案不能启动。
|
|
33
|
+
|
|
34
|
+
### 任务选择
|
|
35
|
+
|
|
36
|
+
视觉分析由当前对象 config.analysis 选择,生成由当前任务 config.generation 选择;聊天模型与执行模型独立。宿主只管理连接定义与凭据注入,不维护跨任务的默认模型。计划冻结所选后端、真实模型与连接身份;切换其他任务的模型不使当前任务的计划失效,当前任务选择或连接变化则重新编译。
|
|
37
|
+
|
|
38
|
+
### 生命周期
|
|
39
|
+
|
|
40
|
+
每个计划项分别保存 `remoteExecutions[inputHash]`,包括 schema=art/remote-receipt-v1、请求哈希、适配器及版本、服务地址、提交时间、上游任务 ID 和结果。回执不保存 API Key。
|
|
41
|
+
|
|
42
|
+
1. `prepare` 先检查凭据与输入,不发起生成。
|
|
43
|
+
2. 持久化 `dispatching` 后才能 POST。
|
|
44
|
+
3. 持久化 `accepted + taskId` 后才能查询。
|
|
45
|
+
4. 持久化 `completed + urls` 后才能下载。
|
|
46
|
+
5. 下载采用临时文件和排他发布,不覆盖已有不同内容的产物。
|
|
47
|
+
|
|
48
|
+
提交中断而无任务 ID 的运行保持未知,不能重发。取消等待不等于上游取消;适配器没有停止能力时保留任务身份和占用。
|
|
49
|
+
|
|
50
|
+
```sh
|
|
51
|
+
v-cli art task resume TASK
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
`task resume` 仅恢复原上游任务查询或原结果下载,不调用提交接口,也不补发尚未提交的项目。已有成功产物跳过;参数及请求身份不同、原工作进程仍活着、原提交结果未知均拒绝恢复。恢复沿用 taskId、manifest 和每项输入哈希。
|
|
55
|
+
|
|
56
|
+
上游已完成而本地下载失败时,恢复原运行取回结果,不能通过失败项重试再次付费生成。原运行查询入口 `task recover --operation` 仍只查登记,不隐式启动工作进程。
|
|
57
|
+
|
|
58
|
+
Vant 通过 `ART_IMAGE_CONNECTION` 和 `ART_IMAGE_KEY` 注入连接,不绑定厂商命名。单独使用 DashScope 时,适配器通过固定版本的百炼核心库读取既有 API Key 配置;明确注入连接后不回退到其他凭据或站点。
|
|
59
|
+
|
|
60
|
+
### 验证边界
|
|
61
|
+
|
|
62
|
+
单元与协议模拟验证声明扩展、统一筛选、严格响应和回执顺序;真实子进程测试验证工作进程丢失及取消后恢复,统计生成 POST 次数不增加。上述验证不等同于付费模型真实出图或已安装版本更新。
|
|
63
|
+
|
|
64
|
+
新模型至少覆盖合法请求、参数边界、模式和输入拒绝;新协议还需覆盖提交结果未知、持久化失败、按原身份恢复、取消及下载失败。HTTP 响应体、下载大小和时间有界;认证请求禁止重定向,下载不携带模型密钥。当前查询异常保留身份并停止等待,不自动重试查询或提交。
|
|
65
|
+
|
|
66
|
+
[适配目录](remote-models.md) · [任务控制](troubleshooting.md) · [配置](configuration.md)
|
|
67
|
+
|
|
68
|
+
## 执行边界
|
|
69
|
+
|
|
70
|
+
字段、路径与权限以当前 schema、运行时校验和明确授权为准;配置有效不等于外部服务已执行成功。
|
|
71
|
+
|
|
72
|
+
## 结果验证
|
|
73
|
+
|
|
74
|
+
结合原始错误、结构化结果和实际产物核验;测试与真实平台执行分别记录。
|
|
75
|
+
|
|
76
|
+
## 参考资料
|
|
77
|
+
|
|
78
|
+
[使用说明](../README.md)
|
package/docs/modes.md
CHANGED
|
@@ -1,67 +1,67 @@
|
|
|
1
|
-
# Vant 模式与调用流程
|
|
2
|
-
|
|
3
|
-
## 定位
|
|
4
|
-
|
|
5
|
-
模式与调用流程,适用于当前随包实现。
|
|
6
|
-
|
|
7
|
-
## 前置条件
|
|
8
|
-
|
|
9
|
-
先按包的环境要求准备工程与工具,使用实际配置和命令帮助核对目标。
|
|
10
|
-
|
|
11
|
-
## 操作流程
|
|
12
|
-
|
|
13
|
-
### 风格分析与核心冻结
|
|
14
|
-
|
|
15
|
-
创建风格草稿,按 style、palette、rendering 分类导入专属参考。讨论澄清意图并回填草稿。style analyze --dry 只编译;实际 analyze 创建 taskId 与独立证据,逐图观察后生成风格报告。
|
|
16
|
-
|
|
17
|
-
报告含 summary、observations、recommendation、issues、notes、decisions 和 provenance。recommendation.rules 是可以独立使用的精炼规范,不含讨论过程。notes 不阻塞采用;issues 给出可执行选项。用户选择后通过 style resolve 记录决定,无需重新分析。style read 的 review.ready 为采用条件,不以聊天中的“可采用”作为事实。
|
|
18
|
-
|
|
19
|
-
已有规则可按明确要求通过 style revise 修订,沿用未改变的证据,不重复分析。派生当前版本的冻结风格时保留结构化规则与独立参考,并标记沿用原冻结证据;不继承核心、授权、执行与对话。
|
|
20
|
-
|
|
21
|
-
需要新增参考证据或分析复核时,复核复用未变化的图片观察并接收已有方案和决定。错误保留草稿和证据,本地完成后允许编辑;云端计算不确定性单独提示,见 [状态与恢复](troubleshooting.md)。
|
|
22
|
-
|
|
23
|
-
style adopt 冻结当前有效规则与决策证据,style recover 只恢复原已授权事务。正式风格只读,修改使用 derive。任务动态参考仍使用 job analyze,不替代静态风格。
|
|
24
|
-
|
|
25
|
-
### 远程文生图
|
|
26
|
-
|
|
27
|
-
选择已启用、目录可用、保存凭据且已适配的图片模型。先 generate show,再 generate plan 保存计划,run --plan --dry 核对请求,再按授权执行。生成 API 由协议适配器直接调用;CLI 示例仅为诊断,不是实际提交链路。
|
|
28
|
-
|
|
29
|
-
型号的生成/编辑模式、输入数量、尺寸、提示词与参数限制统一来自 [模型目录](remote-models.md)。不能把 URL+Key 或 image 标签视为已经适配;不能以注册型号推定账号权限。
|
|
30
|
-
|
|
31
|
-
生成提示词顺序为用途与主体、静态冻结风格、动态主体与关系、动态构图与背景、交付规格、必须可读特征及参考观察。风格的无条件抽象负向表达独立编译;有条件的排除完整保留在条件段。适配器根据模型能力保留独立负向参数或明确并入排除段。编辑提示分别列出修改与保留要求;同一范围可修改局部并保留其他特征,不按标签重叠直接判错。
|
|
32
|
-
|
|
33
|
-
透明输出通过 {type:"transparent"} 配置,计划绑定 PNG 处理契约;原图保留,候选使用校验后的透明 PNG。同色细节和半透明材质存在色键处理局限,不能承诺任意抠图质量。
|
|
34
|
-
|
|
35
|
-
### 本地内置文生图
|
|
36
|
-
|
|
37
|
-
ComfyUI 后端省略 workflow 时使用 Qwen Image 2.1 Q4 与 CPU 文本编码器。config validate 校验模板,doctor 检查服务、节点与模型;doctor --start 可启动并保留服务,不采样。plan/dry 不启动服务。内置工作流不证明模型文件、节点和显存已就绪。
|
|
38
|
-
|
|
39
|
-
### 本地自定义文生图
|
|
40
|
-
|
|
41
|
-
CLI 支持显式 API workflow 与 bindings,调用方负责节点、参数、输入图、数量、输出与生命周期适配。Vant 当前只开放已适配内置方案,不把任意工作流导入作为可运行选择。
|
|
42
|
-
|
|
43
|
-
### 远程图编辑
|
|
44
|
-
|
|
45
|
-
显式绑定 source 及哈希,声明 changes、preserve 和 mustRead。修改与保留不能冲突。默认保留原图风格;绑定目标 core 后由核心统一提供 style。必须使用支持 edit 的准确型号,不能套用文生图端点。
|
|
46
|
-
|
|
47
|
-
上传、提交、查询和下载使用冻结请求。上游身份保存在原运行,恢复仅查询原任务或取回原结果,不重新提交。
|
|
48
|
-
|
|
49
|
-
### 本地 Qwen 2.1 图编辑
|
|
50
|
-
|
|
51
|
-
使用适配后的 LoadImage.image、VAE 和图像编码器连接,底图上传后显式绑定。latent 输出尺寸与编码器 resolution 分开。服务可连接不等于真实编辑成功,验证需实际底图和输出。
|
|
52
|
-
|
|
53
|
-
### 生成与定版
|
|
54
|
-
|
|
55
|
-
前台和后台真实运行均登记 taskId。候选必须有可核验计划、运行身份和完整文件。check 仅做技术完整性检查,candidate finalize 记录用户选择;没有人工三维评分或「验收此图」阶段。
|
|
56
|
-
|
|
57
|
-
按资产定版,重复请求幂等;替换用 --replace 并保留历史。candidate delete 用 --confirm 明确影响,拒绝运行中或受引用文件。定版不会自动导入游戏或提交 Git。
|
|
58
|
-
|
|
59
|
-
空闲任务可更新配置后重新编译运行,原批次保留。派生任务独立建立身份,不继承报告、授权、执行或定版。[全部命令](commands.md) · [取消与恢复](troubleshooting.md)
|
|
60
|
-
|
|
61
|
-
## 结果验证
|
|
62
|
-
|
|
63
|
-
结合原始错误、结构化结果和实际产物核验;测试与真实平台执行分别记录。
|
|
64
|
-
|
|
65
|
-
## 参考资料
|
|
66
|
-
|
|
67
|
-
[使用说明](../README.md)
|
|
1
|
+
# Vant 模式与调用流程
|
|
2
|
+
|
|
3
|
+
## 定位
|
|
4
|
+
|
|
5
|
+
模式与调用流程,适用于当前随包实现。
|
|
6
|
+
|
|
7
|
+
## 前置条件
|
|
8
|
+
|
|
9
|
+
先按包的环境要求准备工程与工具,使用实际配置和命令帮助核对目标。
|
|
10
|
+
|
|
11
|
+
## 操作流程
|
|
12
|
+
|
|
13
|
+
### 风格分析与核心冻结
|
|
14
|
+
|
|
15
|
+
创建风格草稿,按 style、palette、rendering 分类导入专属参考。讨论澄清意图并回填草稿。style analyze --dry 只编译;实际 analyze 创建 taskId 与独立证据,逐图观察后生成风格报告。
|
|
16
|
+
|
|
17
|
+
报告含 summary、observations、recommendation、issues、notes、decisions 和 provenance。recommendation.rules 是可以独立使用的精炼规范,不含讨论过程。notes 不阻塞采用;issues 给出可执行选项。用户选择后通过 style resolve 记录决定,无需重新分析。style read 的 review.ready 为采用条件,不以聊天中的“可采用”作为事实。
|
|
18
|
+
|
|
19
|
+
已有规则可按明确要求通过 style revise 修订,沿用未改变的证据,不重复分析。派生当前版本的冻结风格时保留结构化规则与独立参考,并标记沿用原冻结证据;不继承核心、授权、执行与对话。
|
|
20
|
+
|
|
21
|
+
需要新增参考证据或分析复核时,复核复用未变化的图片观察并接收已有方案和决定。错误保留草稿和证据,本地完成后允许编辑;云端计算不确定性单独提示,见 [状态与恢复](troubleshooting.md)。
|
|
22
|
+
|
|
23
|
+
style adopt 冻结当前有效规则与决策证据,style recover 只恢复原已授权事务。正式风格只读,修改使用 derive。任务动态参考仍使用 job analyze,不替代静态风格。
|
|
24
|
+
|
|
25
|
+
### 远程文生图
|
|
26
|
+
|
|
27
|
+
选择已启用、目录可用、保存凭据且已适配的图片模型。先 generate show,再 generate plan 保存计划,run --plan --dry 核对请求,再按授权执行。生成 API 由协议适配器直接调用;CLI 示例仅为诊断,不是实际提交链路。
|
|
28
|
+
|
|
29
|
+
型号的生成/编辑模式、输入数量、尺寸、提示词与参数限制统一来自 [模型目录](remote-models.md)。不能把 URL+Key 或 image 标签视为已经适配;不能以注册型号推定账号权限。
|
|
30
|
+
|
|
31
|
+
生成提示词顺序为用途与主体、静态冻结风格、动态主体与关系、动态构图与背景、交付规格、必须可读特征及参考观察。风格的无条件抽象负向表达独立编译;有条件的排除完整保留在条件段。适配器根据模型能力保留独立负向参数或明确并入排除段。编辑提示分别列出修改与保留要求;同一范围可修改局部并保留其他特征,不按标签重叠直接判错。
|
|
32
|
+
|
|
33
|
+
透明输出通过 {type:"transparent"} 配置,计划绑定 PNG 处理契约;原图保留,候选使用校验后的透明 PNG。同色细节和半透明材质存在色键处理局限,不能承诺任意抠图质量。
|
|
34
|
+
|
|
35
|
+
### 本地内置文生图
|
|
36
|
+
|
|
37
|
+
ComfyUI 后端省略 workflow 时使用 Qwen Image 2.1 Q4 与 CPU 文本编码器。config validate 校验模板,doctor 检查服务、节点与模型;doctor --start 可启动并保留服务,不采样。plan/dry 不启动服务。内置工作流不证明模型文件、节点和显存已就绪。
|
|
38
|
+
|
|
39
|
+
### 本地自定义文生图
|
|
40
|
+
|
|
41
|
+
CLI 支持显式 API workflow 与 bindings,调用方负责节点、参数、输入图、数量、输出与生命周期适配。Vant 当前只开放已适配内置方案,不把任意工作流导入作为可运行选择。
|
|
42
|
+
|
|
43
|
+
### 远程图编辑
|
|
44
|
+
|
|
45
|
+
显式绑定 source 及哈希,声明 changes、preserve 和 mustRead。修改与保留不能冲突。默认保留原图风格;绑定目标 core 后由核心统一提供 style。必须使用支持 edit 的准确型号,不能套用文生图端点。
|
|
46
|
+
|
|
47
|
+
上传、提交、查询和下载使用冻结请求。上游身份保存在原运行,恢复仅查询原任务或取回原结果,不重新提交。
|
|
48
|
+
|
|
49
|
+
### 本地 Qwen 2.1 图编辑
|
|
50
|
+
|
|
51
|
+
使用适配后的 LoadImage.image、VAE 和图像编码器连接,底图上传后显式绑定。latent 输出尺寸与编码器 resolution 分开。服务可连接不等于真实编辑成功,验证需实际底图和输出。
|
|
52
|
+
|
|
53
|
+
### 生成与定版
|
|
54
|
+
|
|
55
|
+
前台和后台真实运行均登记 taskId。候选必须有可核验计划、运行身份和完整文件。check 仅做技术完整性检查,candidate finalize 记录用户选择;没有人工三维评分或「验收此图」阶段。
|
|
56
|
+
|
|
57
|
+
按资产定版,重复请求幂等;替换用 --replace 并保留历史。candidate delete 用 --confirm 明确影响,拒绝运行中或受引用文件。定版不会自动导入游戏或提交 Git。
|
|
58
|
+
|
|
59
|
+
空闲任务可更新配置后重新编译运行,原批次保留。派生任务独立建立身份,不继承报告、授权、执行或定版。[全部命令](commands.md) · [取消与恢复](troubleshooting.md)
|
|
60
|
+
|
|
61
|
+
## 结果验证
|
|
62
|
+
|
|
63
|
+
结合原始错误、结构化结果和实际产物核验;测试与真实平台执行分别记录。
|
|
64
|
+
|
|
65
|
+
## 参考资料
|
|
66
|
+
|
|
67
|
+
[使用说明](../README.md)
|
package/lib/agent.mjs
CHANGED
|
@@ -1,47 +1,32 @@
|
|
|
1
|
-
import {existsSync,lstatSync,statSync,readFileSync,mkdirSync,writeFileSync,readdirSync} from 'node:fs';
|
|
2
|
-
import {join,resolve,relative,isAbsolute,dirname} from 'node:path';
|
|
3
|
-
import {homedir} from 'node:os';
|
|
4
|
-
import {loadProject} from './project.mjs';
|
|
5
|
-
import {TOOL_ROOT as ROOT,loadSettings} from './settings.mjs';
|
|
6
|
-
import {hash} from './shared.mjs';
|
|
7
|
-
|
|
8
|
-
export
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
}
|
|
34
|
-
return result;
|
|
35
|
-
}
|
|
36
|
-
export function autoSync({root=ROOT,cwd=process.cwd(),home=homedir(),env=process.env}={}) {
|
|
37
|
-
const dirs=[...new Set([cwd,home].flatMap(base=>AGENT_DIRS.map(dir=>join(base,dir))))];
|
|
38
|
-
if(env.CODEX_HOME) dirs.push(join(env.CODEX_HOME,'skills'));
|
|
39
|
-
return syncSkill({root,skillDirs:dirs});
|
|
40
|
-
}
|
|
41
|
-
export function agentIndex(root=ROOT,workspace=loadSettings().paths.workspace) {
|
|
42
|
-
const commands=JSON.parse(readFileSync(join(root,'v-cli.plugin.json'),'utf8')).agent.commands;
|
|
43
|
-
const modules=['style','generate','edit','refs','agent'].map(name=>({name,actions:commands.filter(command=>command.path[0]===name&&command.path.length===2).map(command=>command.path[1])}));
|
|
44
|
-
return {tool:'art-workshop',displayName:'美术工坊',root,workspace,config:loadSettings().file,entry:join(root,'art-workshop.mjs'),skill:{name:'art-workshop',source:join(root,'skills','art-workshop','SKILL.md'),automaticDiscovery:true},modules,utilities:['environment','project','job','reference','candidate','list','check','compare','task','shutdown','doctor','workflow','config'],projects:(directory(join(workspace,'projects'))?readdirSync(join(workspace,'projects')):[]).filter(id=>directory(join(workspace,'projects',id))).map(id=>{const p=loadProject(id,workspace);return {id:p.id,cores:p.cores,defaultCore:p.defaultCore,jobs:readdirSync(join(workspace,'projects',id,'tasks')).filter(x=>existsSync(join(workspace,'projects',id,'tasks',x,'task.json')))};})};
|
|
45
|
-
}
|
|
46
|
-
export const GUIDE_FILES=['README.md','docs/modes.md','docs/configuration.md','docs/data-formats.md','docs/commands.md','docs/deployment.md','docs/troubleshooting.md','docs/remote-models.md','docs/model-architecture.md','docs/core-guidance.md'];
|
|
47
|
-
export function agentDocs(root=ROOT) {return GUIDE_FILES.map(file=>readFileSync(join(root,file),'utf8')).join('\n\n');}
|
|
1
|
+
import {existsSync,lstatSync,statSync,readFileSync,mkdirSync,writeFileSync,readdirSync} from 'node:fs';
|
|
2
|
+
import {join,resolve,relative,isAbsolute,dirname} from 'node:path';
|
|
3
|
+
import {homedir} from 'node:os';
|
|
4
|
+
import {loadProject} from './project.mjs';
|
|
5
|
+
import {TOOL_ROOT as ROOT,loadSettings} from './settings.mjs';
|
|
6
|
+
import {hash} from './shared.mjs';
|
|
7
|
+
|
|
8
|
+
export function exportSkill({directory,host,root=ROOT,dry=false}={}) {
|
|
9
|
+
if(!['codex','claude'].includes(host)||!directory)throw new Error('导出必须显式指定 host 和 directory');
|
|
10
|
+
const base=resolve(directory);if(!existsSync(base)||!statSync(base).isDirectory()||lstatSync(base).isSymbolicLink())throw new Error('导出目录必须是已有普通目录');
|
|
11
|
+
const source=join(root,'skills/art-workshop'),target=join(base,'art-workshop'),plan=[];
|
|
12
|
+
const walk=(from,to)=>{for(const e of readdirSync(from,{withFileTypes:true})){
|
|
13
|
+
if(e.name==='__pycache__'||e.name.endsWith('.pyc'))continue;
|
|
14
|
+
if(e.isSymbolicLink())throw new Error('导出来源不能包含链接');
|
|
15
|
+
const dest=join(to,e.name);if(existsSync(dest)&&(lstatSync(dest).isSymbolicLink()||e.isDirectory()!==statSync(dest).isDirectory()))throw new Error('导出目标类型冲突');
|
|
16
|
+
if(e.isDirectory())walk(join(from,e.name),dest);else plan.push([dest,readFileSync(join(from,e.name))]);
|
|
17
|
+
}};
|
|
18
|
+
if(existsSync(target)&&(!lstatSync(target).isDirectory()||lstatSync(target).isSymbolicLink()))throw new Error('导出目标不是普通目录');
|
|
19
|
+
walk(source,target);
|
|
20
|
+
if(host==='codex')walk(join(root,'adapters/codex'),target);
|
|
21
|
+
if(!dry)for(const [file,bytes]of plan){mkdirSync(dirname(file),{recursive:true});writeFileSync(file,bytes);}
|
|
22
|
+
return {skill:'art-workshop',host,target,dry,files:plan.length};
|
|
23
|
+
}
|
|
24
|
+
export function agentIndex(root=ROOT,workspace=loadSettings().paths.workspace) {
|
|
25
|
+
const commands=JSON.parse(readFileSync(join(root,'v-cli.plugin.json'),'utf8')).agent.commands;
|
|
26
|
+
const modules=['style','generate','edit','conversation','refs','agent'].map(name=>({name,actions:commands.filter(command=>command.path[0]===name&&command.path.length===2).map(command=>command.path[1])}));
|
|
27
|
+
return {tool:'art-workshop',displayName:'美术工坊',root,workspace,config:loadSettings().file,entry:join(root,'art-workshop.mjs'),skill:{name:'art-workshop',source:join(root,'skills','art-workshop','SKILL.md'),automaticDiscovery:true},modules,utilities:['environment','project','job','reference','candidate','list','check','compare','task','shutdown','doctor','workflow','config'],projects:(directory(join(workspace,'projects'))?readdirSync(join(workspace,'projects')):[]).filter(id=>directory(join(workspace,'projects',id))).map(id=>{const p=loadProject(id,workspace);return {id:p.id,cores:p.cores,defaultCore:p.defaultCore,jobs:readdirSync(join(workspace,'projects',id,'tasks')).filter(x=>existsSync(join(workspace,'projects',id,'tasks',x,'task.json')))};})};
|
|
28
|
+
}
|
|
29
|
+
export const GUIDE_FILES=['README.md','docs/modes.md','docs/configuration.md','docs/data-formats.md','docs/commands.md','docs/deployment.md','docs/troubleshooting.md','docs/remote-models.md','docs/model-architecture.md','docs/core-guidance.md'];
|
|
30
|
+
export function agentDocs(root=ROOT) {return readFileSync(join(root,'skills/art-workshop/SKILL.md'),'utf8');}
|
|
31
|
+
|
|
32
|
+
function directory(path){return existsSync(path)&&statSync(path).isDirectory();}
|