@kevlns/art-workshop 0.5.1 → 0.6.0

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 (85) hide show
  1. package/AGENTS.md +25 -25
  2. package/LICENSE +21 -21
  3. package/README.md +65 -63
  4. package/art-workshop.mjs +219 -174
  5. package/docs/channels.md +49 -0
  6. package/docs/commands.md +2259 -22
  7. package/docs/configuration.md +90 -82
  8. package/docs/core-guidance.md +58 -50
  9. package/docs/data-formats.md +89 -85
  10. package/docs/deployment.md +32 -32
  11. package/docs/local-models/qwen-image-2.1.json +73 -73
  12. package/docs/local-models/qwen-image-2.1.md +33 -33
  13. package/docs/model-architecture.md +78 -78
  14. package/docs/modes.md +73 -67
  15. package/docs/release-0.6.0.md +9 -0
  16. package/lib/agent.mjs +32 -32
  17. package/lib/analysis-worker.mjs +36 -32
  18. package/lib/analyze.mjs +85 -85
  19. package/lib/asset-profile.mjs +23 -23
  20. package/lib/backends.mjs +2 -0
  21. package/lib/candidates.mjs +104 -103
  22. package/lib/channel-operation.mjs +84 -0
  23. package/lib/comfy-recovery.mjs +17 -17
  24. package/lib/conversation.mjs +77 -77
  25. package/lib/core.mjs +104 -75
  26. package/lib/deployment-guide.mjs +12 -12
  27. package/lib/design.mjs +29 -29
  28. package/lib/dimensions.mjs +22 -22
  29. package/lib/edit.mjs +43 -41
  30. package/lib/environment-operations.mjs +49 -49
  31. package/lib/environment-runtime.mjs +99 -99
  32. package/lib/environments.mjs +55 -55
  33. package/lib/executor.mjs +107 -107
  34. package/lib/generate.mjs +60 -58
  35. package/lib/generation-policy.mjs +1 -1
  36. package/lib/heartbeat.mjs +16 -16
  37. package/lib/images.mjs +1 -1
  38. package/lib/lifecycle.mjs +53 -53
  39. package/lib/migration.mjs +154 -154
  40. package/lib/object-format.mjs +1 -1
  41. package/lib/process-identity.mjs +22 -14
  42. package/lib/project.mjs +39 -39
  43. package/lib/prompt-structure.mjs +3 -3
  44. package/lib/refs.mjs +26 -26
  45. package/lib/runtime.mjs +25 -25
  46. package/lib/service.mjs +155 -126
  47. package/lib/settings.mjs +50 -50
  48. package/lib/shared.mjs +67 -67
  49. package/lib/style-bundle.mjs +98 -85
  50. package/lib/style-contract.mjs +74 -74
  51. package/lib/style-lifecycle.mjs +124 -125
  52. package/lib/style-review.mjs +14 -14
  53. package/lib/style-samples.mjs +92 -0
  54. package/lib/task-contract.mjs +94 -93
  55. package/lib/tasks.mjs +497 -497
  56. package/lib/templates.mjs +80 -80
  57. package/lib/video/PROVENANCE.json +63 -0
  58. package/lib/video/atomic.mjs +32 -0
  59. package/lib/video/channel.mjs +70 -0
  60. package/lib/video/contract-local-media.mjs +42 -0
  61. package/lib/video/contract-story.mjs +213 -0
  62. package/lib/video/contract-video.mjs +117 -0
  63. package/lib/video/contracts.mjs +3 -0
  64. package/lib/video/h3.mjs +232 -0
  65. package/lib/video/local-runtime.mjs +20 -0
  66. package/lib/video/media.mjs +223 -0
  67. package/lib/video/models.mjs +336 -0
  68. package/lib/video/path.mjs +18 -0
  69. package/lib/video/process.mjs +15 -0
  70. package/lib/video/resource.mjs +15 -0
  71. package/lib/video/service.mjs +731 -0
  72. package/lib/video/workflow.mjs +571 -0
  73. package/lib/video.mjs +12 -0
  74. package/lib/vision.mjs +56 -56
  75. package/lib/worker-process.mjs +6 -6
  76. package/lib/workspace.mjs +305 -292
  77. package/package.json +8 -3
  78. package/rules/core-guidance.json +22 -22
  79. package/skills/art-workshop/SKILL.md +19 -17
  80. package/skills/art-workshop/references/conversation.md +11 -11
  81. package/skills/art-workshop/references/expression.md +27 -27
  82. package/skills/art-workshop/references/project.md +119 -109
  83. package/skills/art-workshop/references/style-discussion.md +7 -3
  84. package/skills/art-workshop/references/video.md +13 -0
  85. package/v-cli.plugin.json +7240 -2747
package/AGENTS.md CHANGED
@@ -1,25 +1,25 @@
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。
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,65 @@
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、微信及其组件归各自权利人所有,第三方组件适用各自许可。
1
+ # Vant 美术工坊
2
+
3
+ `@kevlns/art-workshop`
4
+
5
+ ## 功能
6
+
7
+ 同一个工具包提供两个独立二级通道:`image` 管理项目风格、参考图、图片生成、编辑与定版;`video` 管理剧本、镜头、视频生成、成片合成与精修。图片支持本地 ComfyUI 与远程图片模型,视频使用已配置的本机 ComfyUI 和 FFmpeg。
8
+
9
+ ## 环境要求
10
+
11
+ 图片通道需要 Node.js 20.9 及以上;视频通道需要 Node.js 22.13 及以上及 SQLite 支持。本地生成还需工具检测通过的 Python、显卡驱动与 ComfyUI 环境;视频合成和取帧需要 FFmpeg / ffprobe。
12
+
13
+ ## 安装
14
+
15
+ ```sh
16
+ npm install -g @kevlns/art-workshop
17
+ ```
18
+
19
+ ## 快速开始
20
+
21
+ ```sh
22
+ art-workshop image config show
23
+ art-workshop image config validate
24
+ art-workshop image agent index
25
+ ```
26
+
27
+ ## 使用说明
28
+
29
+ ### 使用流程
30
+
31
+ 图片命令以 `art-workshop image` 或 `v-cli art image` 开头;原有不带 `image` 的图片命令继续兼容。视频以 `art-workshop video` 或 `v-cli art video` 开头,`--workspace` 明确指定工程根目录,不复用图片对象工作区。两条通道的模型配置、任务身份和状态分别保存。完整调用、SDK 和失败模式见 [图片与视频通道](docs/channels.md)。
32
+
33
+ 1. 创建 schemaVersion 2 工程和风格,按关注点导入分析参考;直接填写并保存规则,也可先分析再保存建议。规则随时增删修改,保存有效规则即生效。
34
+ 2. 用 `style sample-job` 创建仅规则打样任务,--count 可指定每个主体生成 1~4 张候选,配置模型、编译预案并按任务授权生成。用户认可候选后用 `style sample-select` 完成样张定版并加入当前风格的运行时参考;不合适时修改规则重新打样。
35
+ 3. 用 `job template` 创建实际任务,填写需求,选择 `styleReferenceMode` 为 `approved`(运行时参考)或 `text-only`(仅规则)。动态参考先 `job analyze`;编辑底图单独绑定。
36
+ 4. 编译 `generate plan` 或 `edit plan`,保存并用 `run --plan ... --dry` 核对模型、尺寸、候选数、样张输入和参数转换,再按任务授权执行。
37
+ 5. 保存执行 taskId;前台和后台都登记运行。查询原身份,不因超时或重启重复提交。`check` 核验产物,`candidate finalize` 定版;替换需 `--replace`,删除需 `--confirm`,均保留事实记录。
38
+
39
+ 风格按当前 revision 保存,不要求派生或重新采用;历史核心快照和批次保留,规则或样张变化后重新编译预案。原始分主题参考用于分析,不自动整图上传。运行时参考与规则哈希绑定,过期样张不作为当前规则的视觉依据;后端不支持图片输入时明确报错,可选择仅规则模式。任务空闲后可按原身份更新配置。job discard 归档任务,job restore 按当前版本恢复;配置、收藏与历史图片保留。任务列表默认按执行中、待定版、草稿、已定版排序;运行状态与停止证据分别判断,不能只看终态释放占用。
40
+
41
+ ### 后端与数据归属
42
+
43
+ 本地为 ComfyUI 内置 Qwen Image 2.1 Q4、CPU 文本编码器方案,支持生成和显式底图编辑。自定义 API workflow 需要明确 bindings 与完整适配,不能把任意导入工作流视为可执行。
44
+
45
+ 远程图片通过工具登记的协议适配器直接调用,目前登记 DashScope。模型、参数与支持状态由 art 内部登记表维护,Vant 读取同一目录,不复制型号判断。分析使用独立视觉模型连接;未注入视觉连接时使用百炼 CLI。Token Plan 是渠道,DashScope 是协议,不能据协议擅自替换实例地址和凭据。
46
+
47
+ 应用数据根默认 `~/.vant`,可由 `VANT_HOME` 覆盖。工具配置为 `~/.vant/tools/art-workshop/config.json`;Vant 将工程美术数据绑定至工程 `.vant/art`。共享模型环境默认 `~/.vant/art-env`,控制状态与日志归用户数据根;安装根保存环境标记 `vant.art.config.json`。
48
+
49
+ ## 开发与验证
50
+
51
+ ```sh
52
+ npm ci
53
+ npm run check
54
+ npm run test:package
55
+ ```
56
+
57
+ 命令返回、结构校验、模拟测试与外部平台实际运行分别核验。发布版本和依赖以随包 `package.json` 为准。
58
+
59
+ ## 文档
60
+
61
+ [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)
62
+
63
+ ## 许可与版权
64
+
65
+ 本工具采用 [MIT 许可](LICENSE)。Copyright © 2026 Vant。Vant 为工具集品牌;Figma、Unity、Steam、微信及其组件归各自权利人所有,第三方组件适用各自许可。