@kevlns/art-workshop 0.4.2 → 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.
Files changed (68) hide show
  1. package/AGENTS.md +25 -105
  2. package/LICENSE +21 -21
  3. package/README.md +63 -63
  4. package/art-workshop.mjs +174 -167
  5. package/docs/commands.md +116 -8
  6. package/docs/configuration.md +82 -82
  7. package/docs/core-guidance.md +50 -50
  8. package/docs/data-formats.md +85 -79
  9. package/docs/deployment.md +32 -32
  10. package/docs/local-models/qwen-image-2.1.json +73 -73
  11. package/docs/local-models/qwen-image-2.1.md +33 -33
  12. package/docs/model-architecture.md +78 -78
  13. package/docs/modes.md +67 -67
  14. package/lib/agent.mjs +32 -47
  15. package/lib/analysis-worker.mjs +32 -29
  16. package/lib/analyze.mjs +85 -78
  17. package/lib/asset-profile.mjs +23 -0
  18. package/lib/candidates.mjs +103 -101
  19. package/lib/comfy-recovery.mjs +17 -17
  20. package/lib/conversation.mjs +77 -0
  21. package/lib/core.mjs +75 -89
  22. package/lib/deployment-guide.mjs +12 -12
  23. package/lib/design.mjs +29 -29
  24. package/lib/dimensions.mjs +22 -22
  25. package/lib/edit.mjs +41 -38
  26. package/lib/environment-operations.mjs +49 -49
  27. package/lib/environment-runtime.mjs +99 -99
  28. package/lib/environments.mjs +55 -55
  29. package/lib/errors.mjs +32 -0
  30. package/lib/executor.mjs +107 -107
  31. package/lib/generate.mjs +58 -59
  32. package/lib/heartbeat.mjs +16 -16
  33. package/lib/images.mjs +1 -1
  34. package/lib/lifecycle.mjs +53 -53
  35. package/lib/migration.mjs +154 -154
  36. package/lib/object-format.mjs +112 -0
  37. package/lib/presentation.mjs +18 -2
  38. package/lib/process-identity.mjs +14 -14
  39. package/lib/project.mjs +39 -39
  40. package/lib/prompt-structure.mjs +7 -3
  41. package/lib/refs.mjs +26 -26
  42. package/lib/runtime.mjs +25 -25
  43. package/lib/service.mjs +126 -126
  44. package/lib/settings.mjs +50 -50
  45. package/lib/shared.mjs +67 -66
  46. package/lib/style-bundle.mjs +85 -85
  47. package/lib/style-contract.mjs +74 -35
  48. package/lib/style-evidence.mjs +39 -0
  49. package/lib/style-lifecycle.mjs +125 -120
  50. package/lib/style-report.mjs +201 -0
  51. package/lib/style-review.mjs +14 -75
  52. package/lib/task-contract.mjs +93 -59
  53. package/lib/tasks.mjs +497 -495
  54. package/lib/templates.mjs +80 -70
  55. package/lib/vision.mjs +56 -46
  56. package/lib/workspace.mjs +292 -238
  57. package/package.json +3 -5
  58. package/rules/core-guidance.json +22 -22
  59. package/skills/art-workshop/SKILL.md +17 -112
  60. package/skills/art-workshop/references/conversation.md +11 -0
  61. package/skills/art-workshop/references/expression.md +27 -0
  62. package/skills/art-workshop/references/getty.md +76 -0
  63. package/skills/art-workshop/references/project.md +109 -0
  64. package/skills/art-workshop/references/style-discussion.md +27 -0
  65. package/skills/art-workshop/scripts/getty.py +269 -0
  66. package/v-cli.plugin.json +2747 -2491
  67. package/scripts/sync-skill.mjs +0 -6
  68. /package/{skills/art-workshop → adapters/codex}/agents/openai.yaml +0 -0
package/AGENTS.md CHANGED
@@ -1,105 +1,25 @@
1
- # Vant 美术工坊 Agent 规范
2
-
3
- ## 定位
4
-
5
- 管理项目风格、参考图、图片生成、编辑和定版。支持本地 ComfyUI 与远程图片模型。
6
-
7
- ## 调用流程
8
-
9
- ```sh
10
- art-workshop config show
11
- art-workshop config validate
12
- art-workshop agent index
13
- ```
14
-
15
- 首次调用前读取本规范,使用命令帮助或插件清单核对参数和执行范围。
16
-
17
- ## 调用规范
18
-
19
- 用户既有授权与偏好持续有效;查询和预演不授权生成或采用。规范与实时参数通过 v-cli agent docs art 和 v-cli agent describe art --json 获取。
20
-
21
- ### 对象与参考
22
-
23
- 任务参考只提取 purposes 指定且未被 ignore 排除的特征。用途范围外、用户已明确覆盖的背景和绘制差异不构成阻塞;conflicts 仅列范围内不可调和要求,uncertainties 仅列影响执行的关键缺失,两者为非空字符串数组,无问题用 []。不得删除用户参考或清空报告来绕过分析;应明确参考范围后重新分析,真正的未决取舍再交用户决定。
24
-
25
- 工程对象使用 schemaVersion 2;读写前核实工程配置和当前 revision。
26
- 风格和任务都有稳定 id 与 revision。UI、聊天和 CLI 共用对象;写入、派生与清理提交预期 revision,冲突重新读取。正式风格只读,改动创建派生风格;派生不继承核心、批次、授权与对话。当前版本冻结风格派生时保留结构化规则和独立参考,报告明确标记沿用原冻结证据;不伪造新的分析。
27
- 风格静态参考只有 style、palette、rendering,只分析媒介、描绘、明暗、描边、笔触和色彩关系。具体造型、比例、结构、部件、身份色、材质与光源属于任务。任务动态参考只有 subject、composition、pose、identity-color、surface、scene-light、text;编辑底图另列。导入复制原图,不修改用户文件。未适配直接参考时拒绝,不隐式上传风格图片。
28
-
29
- ### 风格生命周期
30
-
31
- 草稿可含 rules,每条为 id/scope/strength/instruction/when,avoid 可另填 negative 字符串数组。按媒介、描边、明暗、高光、笔触、刻画、配色整理,主题不必填满。required 必须遵守、default 默认倾向、avoid 必须避免;“默认少用”使用 default,不升级为禁止。条件保留在 when。风格负向只表达跨主体复用的抽象绘制语言,不排除具体主体、部件、身份色、物体纹理、材质或资产规格。negative 直接描述被排除的视觉特征,不加否定前缀;instruction 为同一规则的阅读说明,条件和例外写入 when。无条件且明确填写的 negative 编译为独立负向表达,条件规则连同排除表达保留在正向条件段;未填写 negative 的文字约束保留原文,不机械转换。支持负向参数的模型直接传递,不支持时由适配器并入排除段,不丢弃、不截断。
32
- 已有证据的规则编辑可用 style revise --project ID --id STYLE --revision N --input FILE,输入 {rules,summary,note};这是用户修订方案,沿用未改变的参考,记录原报告和用户依据,不调用模型、不自动采用。参考或分析配置变化、未决问题、旧职责版本仍需对应处理。用户明确授权后 adopt 冻结新身份,旧核心与历史任务快照保留。
33
-
34
- style create/read/update/derive/discard 管理草稿。style analyze --dry 只读编译,不联网、启动服务或创建参考目录。实际 analyze 创建 taskId 与独立参考证据;task status/wait/cancel 控制执行,recover 查原登记,resume 仅按已记录的上游身份恢复查询与取回,不重新提交。
35
- 报告绑定源配置、参考与模型。更新配置保留报告并标记需复核,旧证据不变。报告 recommendation.rules 是精炼独立成稿,规则含主题、强度和适用条件,不包含迭代描述。issues 仅列需用户取舍的矛盾,notes 保留不阻塞采用的证据局限。style resolve --input {issueId,optionId,note} 记录明确选择并修订有效方案,不重新分析;以 style read 的 review.ready 判断采用条件。复核沿用证据与决定,新证据才重新打开问题。style adopt 校验来源匹配和所有问题已决定,用户采用后冻结。采用中断通过 style recover 完成已授权事务,不能重新冻结另一份核心。
36
- 退出风格配置先继续编辑、保存草稿或放弃;分析停止未确认时不能清理。
37
-
38
- ### 计划与执行
39
-
40
- 动态需求自由文本不设字数上限:意图、外观、颜色、动作、效果与关系、场景说明、编辑指令和可读特征均完整保存与编译,不为通过校验删减或截断。必填项仍检查非空、类型和占位符;标识符、模型名称、采样器等结构字段保留各自契约。
41
-
42
- 风格与任务用 config.analysis{provider,model} 保存独立视觉分析实例;任务另用 config.generation{backend,remote?,options?} 保存生成后端,remote 为 {provider,model}。本地采样参数通过任务 generation.options 保存:steps 为 1~10000 整数,cfg 为 0~100 数值,sampler/scheduler 为 ComfyUI 支持的名称。新任务的本地推荐值为 steps=25、cfg=3、sampler=euler、scheduler=simple;内置工作流采用同一默认值,确保普通 CFG 负向分支参与引导。显式配置(含 cfg=0/1)保留,旧批次不改写。省略沿用后端或工作流默认值,远程后端不接受这些参数。使用 job update(v-cli art.job-update)更新任务后重新 plan,核对 backend.options 和 dry 请求的采样节点;不要通过独立 CLI config.json 或宿主管理的工程 settings.json 调整当前任务。聊天模型不改写执行选择。CLI plan 优先使用显式 --backend,其次任务 backend,再按独立工具的本地配置选择;任务绑定后端时使用其真实模型,不能被旧 execution.model 覆盖。宿主按实例注入凭据,不在对象或预案写入密钥;修改选择使原方案失效。
43
-
44
- 先读取实际 job,再 generate/edit plan 和 run --plan --dry,展示有效核心、设计尺寸、预留缩放、请求与实际像素、模型后端、候选数量和编辑底图。后端尺寸由工具统一解析,超限或未对齐选最近合法尺寸,保留设计基准并明确实际值;不承诺显存或自动缩放导出。
45
- 授权覆盖方案后使用 run --background;前台同样创建执行身份。配置、核心、规格、参考、底图和后端变化拒绝失效方案,重新编译。重启查 taskId,不重复提交。不自动换模型或重跑成功项。
46
- 每个任务只能有一个未停止确认的执行;编辑、派生、归档、恢复与运行共用状态检查。切页面不取消。
47
- job discard 归档已停止的任务,草稿、待定版和已定版均可归档。按 revision 将任务标记为 discarded(归档存储状态),保留配置、参考、私有底图、运行、输出、收藏和定版历史;活跃列表、收藏及作品暂不显示。job restore 按同一身份和当前 revision 恢复到活跃列表,收藏与作品重新显示,不重新生成。归档与恢复均检查停止确认和版本,重复操作幂等;恢复后原方案需按当前版本重新编译。风格 discard 仍为草稿放弃,不参与任务归档。
48
-
49
- ### 取消、异常和关闭
50
-
51
- 本地 ComfyUI 按资产及采样序号持久化 prompt ID。工作进程丢失后使用 task resume 或 Vant 原批次恢复入口,沿用原身份查询与取回,不重新上传或提交生图;未提交项不补发。Windows 心跳写入暂时失败记录诊断并重试,不能导致定时器异常退出;关键状态写入仍严格校验。
52
-
53
- 任务状态与停止证据分开。queued/running/cancelling 仍占用资源;unknown 或 stopConfirmed=false 保留资源。failed/cancelled 也不能单凭状态释放资源;dispatching/accepted 远程回执尚未结清时继续占用。工作进程丢失标记 unknown,不推测停止。
54
- task cancel 只取消指定运行,保留服务。生成任务远程取消只停止本地客户端,上游停止未知如实报告,不允许清理。只读分析有 finishedAt、已知终态且工作进程已退出,无生成计划与回执时释放本地占用;云端计算与计费停止未知独立保留,不自动重发。没有完成证据的进程丢失仍保持 unknown。shutdown 阻止提交、停止关联任务、核验共享队列和进程身份后关闭本地服务,不清空共享队列;有其他任务或停止未确认时保留服务。不得广泛杀所有 Python。
55
-
56
- ### 生成与定版
57
-
58
- 透明背景使用 `{type:"transparent"}`:生成任务设置 composition.background,编辑任务设置 changes 中 background 的 value。预案记录 PNG 输出处理版本并参与哈希;含完全透明区域的原生 alpha 保留,接近不透明的 alpha 噪声不视为透明背景。否则从边缘核实约定洋红底色,容许模型色偏,仅处理与外边界连通的底色及混合边缘。原图保留,候选使用处理后的 PNG;缺少合格背景或可见主体则报错,不伪称透明成功。纯色去背景可能影响与外部底色连通的同色细节,不能承诺任意半透明材质的抠图质量。
59
-
60
- 编辑 target 是范围名称,允许 outline 等具体范围;同一范围可修改局部并保留其他特征,不能仅按标签重叠判矛盾。配置和预案仍校验字段、引用、版本及核心风格归属。
61
-
62
- 只有生成与定版两个产品阶段。check 验证计划、执行身份、文件哈希和完成事实;不要求人工 content/style/asset 评分。candidate finalize 按资产选定候选,并把图片复制到美术仓库 VantArtForge。导出名称可空,空名称使用 vant-gen-任务-资产-批次。同一候选且同一导出名重复操作幂等;替换已有定版需要明确 replace,保留历史。导出文件名不能包含路径。
63
- 候选 editable 与 accepted 分开:已停止批次中保留的有效图片可作为编辑底图,输出处理失败不阻止继续编辑;已记录的哈希不匹配、文件缺失或已删除则拒绝。job from-candidate 验证图片可解码后复制为独立编辑草稿的私有底图并记录来源,不改变原批次失败事实,也不授权定版或启动生成。
64
- candidate favorite 使用 --value true/false 收藏或取消收藏,candidate favorites 查看工程收藏。收藏记录独立保存在工程 favorites.json,绑定源任务、批次和图片身份,不修改需求版本、执行或定版状态;可收藏有效的失败保留图。列表隐藏已删除、丢失或所属任务已归档的图片,源任务改名即时反映。
65
- candidate delete 先确认影响,拒绝运行中或被计划/底图引用的候选;先记删除事实,清理所属文件,并取消关联定版。定版不自动导入游戏或提交 Git。
66
-
67
- ### 验证和技能
68
-
69
- 本地先 config validate、doctor、plan/dry,再按授权真实生成与编辑。配置有效、服务可连接与真实出图是不同证据。远程核对实际认证和模型入口;凭证不得写入项目、计划、日志或命令行。
70
- 随包 skills/art-workshop 是技能源;通过 agent init 或 skill:sync 同步,保留项目扩展。查询和预演不自动同步。源码/单测/mock 不能代替真实模型、图像、桌面与安装验证。
71
-
72
- 任务动态参考先 `job analyze`,缺失、过期或职责越界的观察不能进入生成预案。分析与生成共用任务占用与停止确认。启动回执丢失只能 `task recover --project P --operation ID` 查询唯一原登记;没有唯一证据时保持未知,不能重发生成。
73
-
74
- 模型、参数及支持状态只在 art 工具 model-catalog/model-registry 内维护,界面与 v-cli 不复制型号判断。远程图片由已注册协议适配器直接调用;视觉分析连接独立,未注入时使用百炼 CLI。Token Plan 是渠道,DashScope 是协议,不跨站点回退凭据。
75
-
76
- 远端上游身份持久化后才能轮询。`task resume TASK` 只恢复原身份查询与取回,不重发生成;无回执或仍处于 dispatching 的提交保持未知。界面与保存共用 modelEligibility,展示字段不进入执行契约。
77
-
78
- 风格报告和核心使用 schemaVersion=3,只表达绘制语言,不限定主体题材。低刻画密度不删任务结构,干净笔触不禁止物体纹理,高光画法不统一物理材质。
79
-
80
- 任务草稿允许内容尚未完成,但拒绝编译器不支持的字段。生成任务的字段正本为 lib/task-contract.mjs;effect 使用 id/kind/target/color/relation/count,不支持 description。先读当前对象,完整保留未修改字段,按当前 revision 保存;保存成功后仍需编译预案,不能声称已生成图片。任务编译错误依据执行回执修正,不猜测风格或尺寸问题。
81
-
82
- 任务参考可通过 reference import --item-id <对象标识> 绑定单个出图对象;未绑定的参考为任务共用。生成与编辑只采纳共用参考和当前对象参考的观察。reference update 的 itemId 可改绑对象,null 表示任务共用。
83
-
84
- `v-cli capability coverage --json` 核对结构化调用覆盖。参考导入的 `--item-id` 指定当前任务出图对象,省略表示任务共用;工具校验对象身份。
85
-
86
- ### 本地环境部署
87
-
88
- 使用 environment guide 获取部署指南与契约,environment inspect 读取机器环境。Pi 通过基础工具和动态工作流完成安装、下载、修正与采样;environment verify 独立校验文件、服务和节点,environment register 验收后登记。任务授权、进程、互斥与恢复交由 Harness。不得把模型回复或服务连通当作真实出图。unregister 仅解除登记,不删除模型或停止外部服务。按 --guide 选择随包方案,模型事实和启动参数只由 art 维护。
89
-
90
- ### 共享冻结风格
91
-
92
- 用户要求共享时使用 style export --project ID --id STYLE --out FILE.style.json,收集冻结核心和必要参考,不复制运行记录或设置。style sources --input DIRS.json 只读列出多个来源,单个来源不可用时报告并继续,重复身份内容冲突按来源明确选择。style import --project TARGET --file FILE.style.json 导入固定快照,保留来源身份、版本及核心哈希;不重新分析、采用或随来源更新。导入的冻结对象只读,改动使用 style derive。输出文件不覆盖已有版本。
93
-
94
-
95
- ## 结果验证
96
-
97
- 核对原始错误、任务身份、停止状态及实际产物。只报告已经完成的验证,模拟测试与真实执行分别说明。
98
-
99
- ## 参考资料
100
-
101
- [使用说明](README.md) · [文档规范](docs/documentation.md) · v-cli.plugin.json
102
-
103
- ## 许可与版权
104
-
105
- MIT。Copyright © 2026 Vant。
1
+ # Vant 美术工坊开发规范
2
+
3
+ ## 定位
4
+
5
+ 本文件仅指导维护 art-workshop 仓库。运行时技能正本为 skills/art-workshop/SKILL.md;命令机器契约为 v-cli.plugin.json。
6
+
7
+ ## 调用流程
8
+
9
+ 修改前读取相关源文件与 package.json 中的检查命令,保留已有工作区改动。
10
+
11
+ ## 调用规范
12
+
13
+ 技能正文与 references 独立维护,不从本文件生成运行规范。修改命令时同步机器清单及生成的命令文档。宿主配置和状态使用 VANT_HOME(默认 ~/.vant),项目数据保留在工程 .vant;安装不扫描其他 Agent 目录。外部宿主仅显式适配。
14
+
15
+ ## 结果验证
16
+
17
+ 运行 package.json 中与改动相关的检查;区分单测、真实后端、界面和安装验证。不得将模拟结果报告为真实生图或发布成功。
18
+
19
+ ## 参考资料
20
+
21
+ [使用说明](README.md) · [运行技能](skills/art-workshop/SKILL.md)
22
+
23
+ ## 许可与版权
24
+
25
+ MIT。Copyright © 2026 Vant。
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright © 2026 Vant
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright © 2026 Vant
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,63 +1,63 @@
1
- # Vant 美术工坊
2
-
3
- `@kevlns/art-workshop`
4
-
5
- ## 功能
6
-
7
- 管理项目风格、参考图、图片生成、编辑和定版。支持本地 ComfyUI 与远程图片模型。
8
-
9
- ## 环境要求
10
-
11
- Node.js 20 及以上;本地生成还需工具检测通过的 Python、显卡驱动与 ComfyUI 环境。
12
-
13
- ## 安装
14
-
15
- ```sh
16
- npm install -g @kevlns/art-workshop
17
- ```
18
-
19
- ## 快速开始
20
-
21
- ```sh
22
- art-workshop config show
23
- art-workshop config validate
24
- art-workshop agent index
25
- ```
26
-
27
- ## 使用说明
28
-
29
- ### 使用流程
30
-
31
- 1. 创建 schemaVersion 2 工程和风格草稿,导入对象专属参考;分析预演后按授权运行,审阅报告并采用为冻结核心。
32
- 2. 用 `job template` 获取任务模板,填写实际需求后创建任务。动态参考先 `job analyze`;编辑底图单独绑定。
33
- 3. 编译 `generate plan` 或 `edit plan`,保存并用 `run --plan ... --dry` 核对模型、尺寸、候选数、输入和参数转换。
34
- 4. 按任务授权执行,保存 taskId;前台和后台都登记运行。查询原身份,不因超时或重启重复提交。
35
- 5. `check` 核验产物,`candidate finalize` 定版。替换需 `--replace`,删除需 `--confirm`,均保留事实记录。
36
-
37
- 正式风格只读,修改需派生。任务空闲后可按原身份更新配置,历史批次不覆写。job discard 归档任务,job restore 按当前版本恢复;配置、收藏与历史图片保留。任务列表默认按执行中、待定版、草稿、已定版排序;运行状态与停止证据分别判断,不能只看终态释放占用。
38
-
39
- ### 后端与数据归属
40
-
41
- 本地为 ComfyUI 内置 Qwen Image 2.1 Q4、CPU 文本编码器方案,支持生成和显式底图编辑。自定义 API workflow 需要明确 bindings 与完整适配,不能把任意导入工作流视为可执行。
42
-
43
- 远程图片通过工具登记的协议适配器直接调用,目前登记 DashScope。模型、参数与支持状态由 art 内部登记表维护,Vant 读取同一目录,不复制型号判断。分析使用独立视觉模型连接;未注入视觉连接时使用百炼 CLI。Token Plan 是渠道,DashScope 是协议,不能据协议擅自替换实例地址和凭据。
44
-
45
- 应用数据根默认 `~/.vant`,可由 `VANT_HOME` 覆盖。工具配置为 `~/.vant/tools/art-workshop/config.json`;Vant 将工程美术数据绑定至工程 `.vant/art`。共享模型环境默认 `~/.vant/art-env`,控制状态与日志归用户数据根;安装根保存环境标记 `vant.art.config.json`。
46
-
47
- ## 开发与验证
48
-
49
- ```sh
50
- npm ci
51
- npm run check
52
- npm run test:package
53
- ```
54
-
55
- 命令返回、结构校验、模拟测试与外部平台实际运行分别核验。发布版本和依赖以随包 `package.json` 为准。
56
-
57
- ## 文档
58
-
59
- [Agent 调用规范](AGENTS.md) · [文档规范](docs/documentation.md) · [art 命令参考](docs/commands.md) · [配置与存储](docs/configuration.md) · [风格核心职责与问题决策](docs/core-guidance.md) · [art 工程与输入结构](docs/data-formats.md) · [本地环境检测与部署](docs/deployment.md) · [模型与执行架构](docs/model-architecture.md) · [模式与调用流程](docs/modes.md) · [远程图片适配与筛选](docs/remote-models.md) · [任务控制与诊断](docs/troubleshooting.md)
60
-
61
- ## 许可与版权
62
-
63
- 本工具采用 [MIT 许可](LICENSE)。Copyright © 2026 Vant。Vant 为工具集品牌;Figma、Unity、Steam、微信及其组件归各自权利人所有,第三方组件适用各自许可。
1
+ # Vant 美术工坊
2
+
3
+ `@kevlns/art-workshop`
4
+
5
+ ## 功能
6
+
7
+ 管理项目风格、参考图、图片生成、编辑和定版。支持本地 ComfyUI 与远程图片模型。
8
+
9
+ ## 环境要求
10
+
11
+ Node.js 20 及以上;本地生成还需工具检测通过的 Python、显卡驱动与 ComfyUI 环境。
12
+
13
+ ## 安装
14
+
15
+ ```sh
16
+ npm install -g @kevlns/art-workshop
17
+ ```
18
+
19
+ ## 快速开始
20
+
21
+ ```sh
22
+ art-workshop config show
23
+ art-workshop config validate
24
+ art-workshop agent index
25
+ ```
26
+
27
+ ## 使用说明
28
+
29
+ ### 使用流程
30
+
31
+ 1. 创建 schemaVersion 2 工程和风格草稿,导入对象专属参考;分析预演后按授权运行,审阅报告并采用为冻结核心。
32
+ 2. 用 `job template` 获取任务模板,填写实际需求后创建任务。动态参考先 `job analyze`;编辑底图单独绑定。
33
+ 3. 编译 `generate plan` 或 `edit plan`,保存并用 `run --plan ... --dry` 核对模型、尺寸、候选数、输入和参数转换。
34
+ 4. 按任务授权执行,保存 taskId;前台和后台都登记运行。查询原身份,不因超时或重启重复提交。
35
+ 5. `check` 核验产物,`candidate finalize` 定版。替换需 `--replace`,删除需 `--confirm`,均保留事实记录。
36
+
37
+ 正式风格只读,修改需派生。任务空闲后可按原身份更新配置,历史批次不覆写。job discard 归档任务,job restore 按当前版本恢复;配置、收藏与历史图片保留。任务列表默认按执行中、待定版、草稿、已定版排序;运行状态与停止证据分别判断,不能只看终态释放占用。
38
+
39
+ ### 后端与数据归属
40
+
41
+ 本地为 ComfyUI 内置 Qwen Image 2.1 Q4、CPU 文本编码器方案,支持生成和显式底图编辑。自定义 API workflow 需要明确 bindings 与完整适配,不能把任意导入工作流视为可执行。
42
+
43
+ 远程图片通过工具登记的协议适配器直接调用,目前登记 DashScope。模型、参数与支持状态由 art 内部登记表维护,Vant 读取同一目录,不复制型号判断。分析使用独立视觉模型连接;未注入视觉连接时使用百炼 CLI。Token Plan 是渠道,DashScope 是协议,不能据协议擅自替换实例地址和凭据。
44
+
45
+ 应用数据根默认 `~/.vant`,可由 `VANT_HOME` 覆盖。工具配置为 `~/.vant/tools/art-workshop/config.json`;Vant 将工程美术数据绑定至工程 `.vant/art`。共享模型环境默认 `~/.vant/art-env`,控制状态与日志归用户数据根;安装根保存环境标记 `vant.art.config.json`。
46
+
47
+ ## 开发与验证
48
+
49
+ ```sh
50
+ npm ci
51
+ npm run check
52
+ npm run test:package
53
+ ```
54
+
55
+ 命令返回、结构校验、模拟测试与外部平台实际运行分别核验。发布版本和依赖以随包 `package.json` 为准。
56
+
57
+ ## 文档
58
+
59
+ [Agent 调用规范](skills/art-workshop/SKILL.md) · [文档规范](docs/documentation.md) · [art 命令参考](docs/commands.md) · [配置与存储](docs/configuration.md) · [风格核心职责与问题决策](docs/core-guidance.md) · [art 工程与输入结构](docs/data-formats.md) · [本地环境检测与部署](docs/deployment.md) · [模型与执行架构](docs/model-architecture.md) · [模式与调用流程](docs/modes.md) · [远程图片适配与筛选](docs/remote-models.md) · [任务控制与诊断](docs/troubleshooting.md)
60
+
61
+ ## 许可与版权
62
+
63
+ 本工具采用 [MIT 许可](LICENSE)。Copyright © 2026 Vant。Vant 为工具集品牌;Figma、Unity、Steam、微信及其组件归各自权利人所有,第三方组件适用各自许可。