@kevlns/art-workshop 0.2.1 → 0.3.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 (58) hide show
  1. package/AGENTS.md +24 -51
  2. package/README.md +31 -93
  3. package/art-workshop.mjs +69 -25
  4. package/docs/commands.md +913 -80
  5. package/docs/configuration.md +33 -139
  6. package/docs/core-guidance.md +7 -7
  7. package/docs/data-formats.md +14 -152
  8. package/docs/deployment.md +40 -0
  9. package/docs/model-architecture.md +52 -0
  10. package/docs/modes.md +15 -116
  11. package/docs/remote-models.md +42 -0
  12. package/docs/troubleshooting.md +30 -68
  13. package/lib/adapters/dashscope.mjs +234 -0
  14. package/lib/adapters/index.mjs +28 -0
  15. package/lib/agent.mjs +2 -2
  16. package/lib/analysis-worker.mjs +25 -0
  17. package/lib/analyze.mjs +8 -8
  18. package/lib/backends.mjs +350 -74
  19. package/lib/bl.mjs +3 -18
  20. package/lib/candidates.mjs +82 -0
  21. package/lib/comfyui.mjs +10 -8
  22. package/lib/contracts.d.ts +67 -0
  23. package/lib/deployment-worker.mjs +97 -0
  24. package/lib/deployment.mjs +72 -0
  25. package/lib/design.mjs +5 -5
  26. package/lib/dimensions.mjs +22 -0
  27. package/lib/edit.mjs +6 -3
  28. package/lib/environments.mjs +67 -0
  29. package/lib/execution/remote.mjs +156 -0
  30. package/lib/executor.mjs +10 -24
  31. package/lib/generate.mjs +9 -5
  32. package/lib/generation-policy.mjs +198 -0
  33. package/lib/images.mjs +10 -0
  34. package/lib/lifecycle.mjs +40 -0
  35. package/lib/migration.mjs +154 -0
  36. package/lib/model-catalog.mjs +288 -0
  37. package/lib/model-registry.mjs +234 -0
  38. package/lib/plan.mjs +98 -28
  39. package/lib/project.mjs +13 -4
  40. package/lib/providers.mjs +27 -22
  41. package/lib/refs.mjs +12 -16
  42. package/lib/runtime.mjs +6 -4
  43. package/lib/service.mjs +45 -4
  44. package/lib/settings.mjs +2 -4
  45. package/lib/style-lifecycle.mjs +72 -0
  46. package/lib/task-references.mjs +35 -0
  47. package/lib/task-worker.mjs +225 -50
  48. package/lib/tasks.mjs +440 -63
  49. package/lib/templates.mjs +69 -0
  50. package/lib/transport/cli.mjs +69 -0
  51. package/lib/transport/http.mjs +82 -0
  52. package/lib/vision.mjs +46 -0
  53. package/lib/workflows.mjs +10 -1
  54. package/lib/workspace.mjs +190 -0
  55. package/package.json +9 -3
  56. package/skills/art-workshop/SKILL.md +27 -54
  57. package/v-cli.plugin.json +1257 -143
  58. package/docs//351/227/256/351/242/230/346/212/245/345/221/212-2026-10-08.md +0 -29
package/docs/commands.md CHANGED
@@ -1,82 +1,915 @@
1
1
  # art 命令参考
2
2
 
3
- 所有 art 命令均可通过 v-cli art 调用。本页按 0.2.1 协议整理;实际完整参数先运行 v-cli agent describe art --json。CLI 查询和检查主要输出 JSON,不需要额外 --json;--json 属于 v-cli agent 的发现命令。--version 与 --help 单独使用。
4
-
5
- ## 公共目录参数
6
-
7
- --config FILE、--workspace DIR、--output-dir DIR、--refs-dir DIR、--cache-dir DIR 临时选择用户配置和目录。路径基准见 configuration.md。配置未声明字段或参数重复时拒绝,不用兼容入口代替。
8
-
9
- ## 命令与检查规范
10
-
11
- | 命令 | 必需身份或文件 | 主要选项与调用要求 |
12
- |---|---|---|
13
- | help / --help | 无 | 只显示入口,不读取配置 |
14
- | --version | 无 | 只显示版本,不读取配置 |
15
- | config path | 无 | 返回配置路径;配置需能解析 |
16
- | config show | 无 | 返回生效路径、后端及默认项 |
17
- | config init | 无 | 创建默认文件;已有不覆盖 |
18
- | config validate | 无 | --backend ID 可限定;校验全局配置与模板,失败退出 1 |
19
- | doctor | 无 | --backend ID 可限定;--start 可启动本地服务,不采样 |
20
- | workflow list | 无 | 返回内置名称和 API/UI 路径;不依赖用户配置合法性 |
21
- | refs guide | 无 | --project P 可选,--refs-dir 可覆盖;显示实际分类与 scope |
22
- | list | 无 | 列出外部工程,不是旧风格包列表 |
23
- | agent index | 无 | 返回工程、核心、任务、模块、入口与外部路径 |
24
- | agent docs | 无 | 输出随包完整指南 |
25
- | agent init | 无 | --directory DIR 指定已存在目录;--dry 预览同步 |
26
- | style analyze | --project P、--input FILE | --out REPORT、--dry;非 dry 可调用远程分析 |
27
- | style validate | --project P、--report REPORT | 校验报告、推荐核心、冲突及不确定项 |
28
- | style freeze | --project P、--report REPORT | --note TEXT;用户采用后冻结,不覆盖已有核心 |
29
- | style show | --project P、--core CORE | 读取并核对冻结身份与哈希 |
30
- | generate show | --project P、--job J | 展示源任务,不是编译后的最终请求 |
31
- | generate plan | --project P、--job J | --core CORE、--backend ID、--out PLAN |
32
- | generate run | --plan PLAN,或 --project P、--job J | 选择、预演及后台参数见下文 |
33
- | edit show | --project P、--job J | 展示底图与修改、保留要求 |
34
- | edit plan | --project P、--job J | --core CORE、--backend ID、--out PLAN;核对 source 哈希 |
35
- | edit run | --plan PLAN,或 --project P、--job J | 编辑适配器须支持原图;与 generate 同一任务机制 |
36
- | task list | 无 | 当前配置范围内运行记录;不等于所有 ComfyUI 浏览器任务 |
37
- | task status | TASK | 状态、日志、manifest、diagnostic;失联任务可被标记 lost |
38
- | task wait | TASK | --timeout SECONDS,默认 3600;超时不取消任务 |
39
- | task cancel | TASK | 请求停止并等待最多 60 秒;保留服务 |
40
- | shutdown | 无 | 停止当前范围全部任务、清空关联后端队列、关闭服务 |
41
- | check | RUN,或 --file RUN | --out REVIEW、--review REVIEW;汇总完整性和人工审查 |
42
- | select | RUN、--item ITEM、--variant VARIANT | --review REVIEW、--file IMAGE;必须选唯一且全通过的图片 |
43
- | compare | PLAN_A PLAN_B | 比较计划/manifest 的计划快照,不分析图片 |
44
-
45
- 省略 --project 时可使用 defaultProject,但示例推荐显式指定。TASK/RUN/PLAN 等均为占位符,替换后再运行。
46
-
47
- ## run 的两种来源
48
-
49
- ```powershell
50
- # 根据当前来源重新编译,可以选后端。
51
- v-cli art generate run --project P --job J --backend local-qwen --item ITEM --dry
52
- # 使用冻结计划,只选执行项,不调整来源。
53
- v-cli art generate run --plan .cache/local-plan.json --item ITEM --variant base --background
54
- ```
55
-
56
- 使用 --plan 时禁止 --project、--job、--core、--backend、--explore。允许 --item、--variant、--offset、--limit、--dry、--background,以及公共路径覆盖。新来源调用可加 --explore 执行全部 variants;默认只选 base。--variant 为单一候选 ID;--limit/--offset 按 item ID 计数,limit 为正整数,offset 为非负整数。
57
-
58
- --dry 显示请求,不创建 task、上传原图、联网或采样。--background 返回 taskId;前台创建同样任务并等待。run 不支持用 --timeout 改等待或采样时间,应单独使用 task wait 或修改后端 timeoutSeconds 后重新 plan。
59
-
60
- ## 退出码和产物
61
-
62
- config validate/doctor 检查通过为 0,失败为 1;远程 doctor 的 0 只代表配置检查。后台 run 的 0 只表示成功提交工作进程,任务结果看 task status/wait。前台 run 和 task wait 遇到非 succeeded 终态返回 1;等待超时也返回错误,但后台任务继续。task status 是查询,failed 状态并不意味着查询命令本身失败;task cancel 返回取消后的记录,也可能返回已完成终态,应检查 status/unsettled。
63
-
64
- 检查或编译失败不产生图片。实际任务文件位于配置旁 .runtime,生成目录在 output。取消或失败可能留下已生成图片与 manifest,不能把文件存在当作验收通过。
65
-
66
- ## 副作用范围
67
-
68
- | 操作 | 网络、进程与写入 |
69
- |---|---|
70
- | help/version/workflow list | 无服务启动、模型请求或 refs 初始化 |
71
- | config validate | 读取配置和模板,不探测 HTTP、不补 refs |
72
- | doctor | HTTP 环境查询;默认不启动、不采样、不补 refs |
73
- | doctor --start | 可写服务状态/日志并启动;检查后服务保留 |
74
- | 普通查询、plan、run --dry | 可补齐外部 refs 分类;plan --out 写计划;不调用生图服务 |
75
- | style analyze | 非 dry 可远程调用、写缓存/报告;不自动冻结 |
76
- | style freeze | 写核心和 project.json;需采用报告;可同步 skill |
77
- | 非 dry run | 启动任务进程、保存产物;本地可懒启动和采样,远程可产生费用;可同步 skill |
78
- | task status/list/wait | 读状态;发现死 worker 时可写 lost;普通 CLI 仍可能补 refs |
79
- | task cancel/shutdown | 请求取消,按范围操作队列或进程,写状态;shutdown 范围更广 |
80
- | check/select/agent init | 检查或写审查、选择、技能文件;不调用模型 |
81
-
82
- --dry 不是所有命令的通用零副作用开关,只在明确支持的 analyze/run/agent init 中有意义。不要把命令未使用的参数当作模式切换。
3
+ <!-- Generated by scripts/command-docs.mjs; edit v-cli.plugin.json. -->
4
+
5
+ 本文件由插件清单生成。`npm run docs:generate` 更新,`npm run docs:check` 检查漂移。
6
+
7
+ `v-cli art` 路由到同一工具;直接调用可用 `art-workshop`。标识、路径占位符须替换为真实值。
8
+
9
+ ## 全局选项
10
+
11
+ - `--config <file>`:外部本地配置文件
12
+ - `--workspace <dir>`:外部工程与任务根目录
13
+ - `--output-dir <dir>`:产物根目录;默认与 workspace 相同,Vant 显式绑定工程 .vant/art
14
+ - `--refs-dir <dir>`:外部参考图目录
15
+ - `--cache-dir <dir>`:外部缓存目录
16
+ - `-V, --version`:单独使用,显示工具版本
17
+ - `-h, --help`:单独使用,显示入口帮助
18
+
19
+ ## 执行约束
20
+
21
+ 相对计划、输入和报告路径以 workspace 为基准;运行批次以 output 为基准。参考导入的源文件建议使用绝对路径。查询与预演不初始化参考目录。
22
+
23
+ 冻结计划不能覆盖 project/job/core/backend/explore。`--all-variants` 与 `--variant` 互斥。`--retry-run` 只用于原计划的明确失败项,不能混用 dry/item/variant/offset/limit。远程恢复只用 `task resume`,不会补发未提交项。
24
+
25
+ 前台运行也登记 taskId;后台启动成功仅表示收到执行身份。状态、停止确认和实际产物分别核对。详见 [任务控制](troubleshooting.md)、[模型架构](model-architecture.md) 和 [部署](deployment.md)。
26
+
27
+ ## help
28
+
29
+ 显示命令入口与 v-cli 发现方式
30
+
31
+ ```sh
32
+ v-cli art help
33
+ ```
34
+
35
+
36
+ - 无配置读取、目录初始化、网络或模型调用
37
+
38
+ ## config path
39
+
40
+ 显示本地配置文件路径
41
+
42
+ ```sh
43
+ v-cli art config path
44
+ ```
45
+
46
+
47
+ - 查询与预演不创建参考目录
48
+ - 无网络调用
49
+
50
+ ## config show
51
+
52
+ 显示生效的本地配置和外部资源路径
53
+
54
+ ```sh
55
+ v-cli art config show
56
+ ```
57
+
58
+
59
+ - 查询与预演不创建参考目录
60
+ - 无网络调用
61
+
62
+ ## config init
63
+
64
+ 配置不存在时创建本地模板;已存在时读取,不覆盖
65
+
66
+ ```sh
67
+ v-cli art config init
68
+ ```
69
+
70
+
71
+ - 查询与预演不创建参考目录
72
+ - 无网络调用
73
+ - 写入外部本地配置
74
+
75
+ ## refs guide
76
+
77
+ 解释参考分类目录的用途与推荐图片样式
78
+
79
+ ```sh
80
+ v-cli art refs guide [--project <id>]
81
+ ```
82
+
83
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
84
+
85
+ - 查询与预演不创建参考目录
86
+ - 无网络调用
87
+
88
+ ## agent index
89
+
90
+ 发现模块、工程、核心、任务与随包 skill
91
+
92
+ ```sh
93
+ v-cli art agent index
94
+ ```
95
+
96
+
97
+ - 查询与预演不创建参考目录
98
+ - 无网络调用
99
+
100
+ ## agent docs
101
+
102
+ 输出全部随包模式、配置、工程、命令、诊断与核心指南
103
+
104
+ ```sh
105
+ v-cli art agent docs
106
+ ```
107
+
108
+
109
+ - 查询与预演不创建参考目录
110
+ - 无网络调用
111
+
112
+ ## agent init
113
+
114
+ 将随包 skill 同步到目标下已有 Agent 技能目录
115
+
116
+ ```sh
117
+ v-cli art agent init [--directory <dir>] [--dry]
118
+ ```
119
+
120
+ - `--directory <dir>`:同步目标根目录,默认 cwd
121
+ - `--dry`:只读预演,不联网、不创建参考目录
122
+
123
+ - 查询与预演不创建参考目录
124
+ - 无网络调用
125
+ - 覆盖同名随包 skill 和 runtime.json,保留扩展文件
126
+
127
+ ## list
128
+
129
+ 列出外部工作目录中的工程
130
+
131
+ ```sh
132
+ v-cli art list
133
+ ```
134
+
135
+
136
+ - 查询与预演不创建参考目录
137
+ - 无网络调用
138
+
139
+ ## style analyze
140
+
141
+ 草稿风格后台分析
142
+
143
+ ```sh
144
+ v-cli art style analyze
145
+ ```
146
+
147
+ - `--project <id>`:工程身份
148
+ - `--id <id>`:对象身份
149
+ - `--revision <number>`:预期对象版本
150
+ - `--dry`:只读编译预演
151
+ - `--operation <id>`:分析启动前登记的稳定操作身份
152
+
153
+ - dry 不联网、不写参考目录;执行创建运行身份和不可变参考证据;远程停止不确定时保留资源
154
+
155
+ ## style validate
156
+
157
+ 校验报告及核心规则的一致性
158
+
159
+ ```sh
160
+ v-cli art style validate [--project <id>] [--report <file>]
161
+ ```
162
+
163
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
164
+ - `--report <file>`:风格报告 JSON,相对路径基于 workspace
165
+
166
+ - 查询与预演不创建参考目录
167
+ - 无网络调用
168
+
169
+ ## style show
170
+
171
+ 读取当前工程的指定冻结核心并验证完整性
172
+
173
+ ```sh
174
+ v-cli art style show [--project <id>] [--core <id>]
175
+ ```
176
+
177
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
178
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
179
+
180
+ - 查询与预演不创建参考目录
181
+ - 无网络调用
182
+
183
+ ## generate show
184
+
185
+ 读取文生图任务
186
+
187
+ ```sh
188
+ v-cli art generate show [--project <id>] [--job <id>]
189
+ ```
190
+
191
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
192
+ - `--job <id>`:工程内任务 ID
193
+
194
+ - 查询与预演不创建参考目录
195
+ - 无网络调用
196
+
197
+ ## generate plan
198
+
199
+ 编译文生图计划,明确来源及真实请求
200
+
201
+ ```sh
202
+ v-cli art generate plan [--project <id>] [--job <id>] [--core <id>] [--out <file>]
203
+ ```
204
+
205
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
206
+ - `--job <id>`:工程内任务 ID
207
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
208
+ - `--out <file>`:可选外部输出文件;相对路径基于 workspace
209
+ - `--backend <id>`:新计划选择配置中的远程/本地后端 ID;冻结计划不能覆盖
210
+
211
+ - 查询与预演不创建参考目录
212
+ - 无网络调用
213
+ - 指定 out 时写入外部计划文件
214
+
215
+ ## generate run
216
+
217
+ 执行或预演文生图计划
218
+
219
+ ```sh
220
+ v-cli art generate run [--plan <file>] [--project <id>] [--job <id>] [--core <id>] [--item <id>] [--variant <id>] [--explore] [--offset <n>] [--limit <n>] [--dry]
221
+ ```
222
+
223
+ - `--plan <file>`:冻结计划文件;不能同时指定 project/job/core/explore
224
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
225
+ - `--job <id>`:工程内任务 ID
226
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
227
+ - `--item <id>`:选择单体
228
+ - `--variant <id>`:选择候选,默认 base
229
+ - `--explore`:执行全部候选;仅在从任务编译时使用
230
+ - `--offset <n>`:选择起始偏移,默认 0
231
+ - `--limit <n>`:执行数量上限
232
+ - `--dry`:只读预演所选请求;不联网、不启动服务、不上传、不创建参考目录
233
+ - `--backend <id>`:选择统一配置中的后端;冻结计划不允许覆盖
234
+ - `--background`:后台执行并返回 taskId
235
+ - `--all-variants`:执行冻结预案中的全部构图候选;不能与 --variant 同用
236
+ - `--retry-run <id>`:原批次停止已确认后,仅重试明确失败项;成功项不重做
237
+ - `--operation <id>`:启动前持久化的稳定操作身份;丢失回执时按原身份 recover
238
+
239
+ - 查询与预演不创建参考目录
240
+ - 远程非 dry 通过登记的协议适配器调用模型,可能产生费用,按已有任务授权执行
241
+ - 本地非 dry 可启动任务和 ComfyUI 服务并采样,不调用百炼生图
242
+ - 真实执行写入外部图片、manifest、任务状态和诊断
243
+ - dry 只展示请求,不启动或探测服务、不上传、不生成图片
244
+
245
+ ## edit show
246
+
247
+ 读取图编辑任务
248
+
249
+ ```sh
250
+ v-cli art edit show [--project <id>] [--job <id>]
251
+ ```
252
+
253
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
254
+ - `--job <id>`:工程内任务 ID
255
+
256
+ - 查询与预演不创建参考目录
257
+ - 无网络调用
258
+
259
+ ## edit plan
260
+
261
+ 编译图编辑计划,明确来源及真实请求
262
+
263
+ ```sh
264
+ v-cli art edit plan [--project <id>] [--job <id>] [--core <id>] [--out <file>]
265
+ ```
266
+
267
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
268
+ - `--job <id>`:工程内任务 ID
269
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
270
+ - `--out <file>`:可选外部输出文件;相对路径基于 workspace
271
+ - `--backend <id>`:新计划选择配置中的远程/本地后端 ID;冻结计划不能覆盖
272
+
273
+ - 查询与预演不创建参考目录
274
+ - 无网络调用
275
+ - 指定 out 时写入外部计划文件
276
+
277
+ ## edit run
278
+
279
+ 执行或预演图编辑计划
280
+
281
+ ```sh
282
+ v-cli art edit run [--plan <file>] [--project <id>] [--job <id>] [--core <id>] [--item <id>] [--variant <id>] [--explore] [--offset <n>] [--limit <n>] [--dry]
283
+ ```
284
+
285
+ - `--plan <file>`:冻结计划文件;不能同时指定 project/job/core/explore
286
+ - `--project <id>`:工程 ID;未指定时使用本地 defaultProject,不跨工程回退
287
+ - `--job <id>`:工程内任务 ID
288
+ - `--core <id>`:工程内冻结核心 ID;显式选择与任务绑定冲突时拒绝执行
289
+ - `--item <id>`:选择单体
290
+ - `--variant <id>`:选择候选,默认 base
291
+ - `--explore`:执行全部候选;仅在从任务编译时使用
292
+ - `--offset <n>`:选择起始偏移,默认 0
293
+ - `--limit <n>`:执行数量上限
294
+ - `--dry`:只读预演所选请求;不联网、不启动服务、不上传、不创建参考目录
295
+ - `--backend <id>`:选择统一配置中的后端;冻结计划不允许覆盖
296
+ - `--background`:后台执行并返回 taskId
297
+ - `--all-variants`:执行冻结预案中的全部构图候选;不能与 --variant 同用
298
+ - `--retry-run <id>`:原批次停止已确认后,仅重试明确失败项;成功项不重做
299
+ - `--operation <id>`:启动前持久化的稳定操作身份;丢失回执时按原身份 recover
300
+
301
+ - 查询与预演不创建参考目录
302
+ - 远程非 dry 通过登记的协议适配器调用模型,可能产生费用,按已有任务授权执行
303
+ - 本地非 dry 可启动任务和 ComfyUI 服务并采样,不调用百炼生图
304
+ - 真实执行写入外部图片、manifest、任务状态和诊断
305
+ - dry 只展示请求,不启动或探测服务、不上传、不生成图片
306
+
307
+ ## check
308
+
309
+ 核验运行计划、执行归属、产物与文件哈希;不进行人工评分
310
+
311
+ ```sh
312
+ v-cli art check RUN
313
+ ```
314
+
315
+ - 位置参数 `RUN`:运行目录或 manifest 路径,按 output 解析(必填)
316
+
317
+ - 只读;不调用模型、不写入评分或定版记录
318
+
319
+ ## compare
320
+
321
+ 比较两份计划或执行记录的核心、执行配置和单体变更
322
+
323
+ ```sh
324
+ v-cli art compare BEFORE AFTER
325
+ ```
326
+
327
+ - 位置参数 `BEFORE`:前一份计划/执行记录 JSON,按 workspace 解析(必填)
328
+ - 位置参数 `AFTER`:后一份计划/执行记录 JSON,按 workspace 解析(必填)
329
+
330
+ - 查询与预演不创建参考目录
331
+ - 无网络调用
332
+
333
+ ## task list
334
+
335
+ 列出任务状态
336
+
337
+ ```sh
338
+ v-cli art task list
339
+ ```
340
+
341
+ - `--project <id>`:仅列出指定工程运行
342
+
343
+ - 读取外部运行状态
344
+
345
+ ## task status
346
+
347
+ 查看单次任务及后端 prompt_id
348
+
349
+ ```sh
350
+ v-cli art task status TASK
351
+ ```
352
+
353
+ - 位置参数 `TASK`:art 任务 ID(必填)
354
+
355
+ - 读取外部运行状态
356
+
357
+ ## task wait
358
+
359
+ 等待任务结束;超时不取消任务
360
+
361
+ ```sh
362
+ v-cli art task wait TASK
363
+ ```
364
+
365
+ - 位置参数 `TASK`:art 任务 ID(必填)
366
+ - `--timeout <seconds>`:等待秒数,默认 3600
367
+
368
+ - 读取外部运行状态
369
+
370
+ ## task cancel
371
+
372
+ 取消单次任务并等待停止
373
+
374
+ ```sh
375
+ v-cli art task cancel TASK
376
+ ```
377
+
378
+ - 位置参数 `TASK`:art 任务 ID(必填)
379
+
380
+ - 取消单个任务
381
+ - 按 prompt_id 中断本地任务
382
+ - 保留服务进程
383
+
384
+ ## shutdown
385
+
386
+ 停止当前工作区关联任务,核验共享队列和进程身份后关闭服务
387
+
388
+ ```sh
389
+ v-cli art shutdown
390
+ ```
391
+
392
+
393
+ - 停止配置范围内所有任务
394
+ - 只取消关联任务;共享队列仍有其他任务时保留服务
395
+ - 核验进程身份后关闭服务
396
+ - 阻止 shutdown 期间的新任务
397
+
398
+ ## config validate
399
+
400
+ 校验配置和 API workflow 的结构、连接与参数绑定
401
+
402
+ ```sh
403
+ v-cli art config validate
404
+ ```
405
+
406
+ - `--backend <id>`:仅检查指定后端
407
+
408
+ - 只读校验,不启动服务、不调用模型
409
+
410
+ ## doctor
411
+
412
+ 检测本地 ComfyUI 环境、节点与模型
413
+
414
+ ```sh
415
+ v-cli art doctor
416
+ ```
417
+
418
+ - `--backend <id>`:仅检查指定后端
419
+ - `--start`:无可用服务时按配置启动;不采样,检查后服务保留
420
+
421
+ - 默认读取本地环境,不启动、不采样、不补齐 refs
422
+ - --start 可启动并保留服务,写状态与日志;不采样
423
+ - 远程后端只校验配置,不检查认证或云端连通性
424
+
425
+ ## workflow list
426
+
427
+ 列出默认内置工作流及 API/UI 文件位置
428
+
429
+ ```sh
430
+ v-cli art workflow list
431
+ ```
432
+
433
+
434
+ - 读取随包工作流清单,不依赖合法用户配置、不补 refs、不调用模型
435
+
436
+ ## style create
437
+
438
+ 创建独立草稿对象
439
+
440
+ ```sh
441
+ v-cli art style create
442
+ ```
443
+
444
+ - `--project <id>`:工程身份
445
+ - `--input <file>`:结构化配置文件
446
+
447
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
448
+
449
+ ## style list
450
+
451
+ 列出工程对象及任务展示状态
452
+
453
+ ```sh
454
+ v-cli art style list
455
+ ```
456
+
457
+ - `--project <id>`:工程身份
458
+
459
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
460
+
461
+ ## style read
462
+
463
+ 读取指定对象与版本
464
+
465
+ ```sh
466
+ v-cli art style read
467
+ ```
468
+
469
+ - `--project <id>`:工程身份
470
+ - `--id <id>`:对象身份
471
+
472
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
473
+
474
+ ## style update
475
+
476
+ 校验预期版本及空闲状态后更新对象
477
+
478
+ ```sh
479
+ v-cli art style update
480
+ ```
481
+
482
+ - `--project <id>`:工程身份
483
+ - `--id <id>`:对象身份
484
+ - `--revision <number>`:预期对象版本
485
+ - `--input <file>`:结构化配置文件
486
+
487
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
488
+
489
+ ## style derive
490
+
491
+ 派生独立草稿,不继承执行、报告或定版
492
+
493
+ ```sh
494
+ v-cli art style derive
495
+ ```
496
+
497
+ - `--project <id>`:工程身份
498
+ - `--id <id>`:对象身份
499
+ - `--revision <number>`:预期对象版本
500
+
501
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
502
+
503
+ ## style discard
504
+
505
+ 确认空闲后丢弃草稿并清理所属资源
506
+
507
+ ```sh
508
+ v-cli art style discard
509
+ ```
510
+
511
+ - `--project <id>`:工程身份
512
+ - `--id <id>`:对象身份
513
+ - `--revision <number>`:预期对象版本
514
+
515
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
516
+
517
+ ## job create
518
+
519
+ 创建独立草稿对象
520
+
521
+ ```sh
522
+ v-cli art job create
523
+ ```
524
+
525
+ - `--project <id>`:工程身份
526
+ - `--input <file>`:结构化配置文件
527
+
528
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
529
+
530
+ ## job list
531
+
532
+ 列出工程对象及任务展示状态
533
+
534
+ ```sh
535
+ v-cli art job list
536
+ ```
537
+
538
+ - `--project <id>`:工程身份
539
+
540
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
541
+
542
+ ## job read
543
+
544
+ 读取指定对象与版本
545
+
546
+ ```sh
547
+ v-cli art job read
548
+ ```
549
+
550
+ - `--project <id>`:工程身份
551
+ - `--id <id>`:对象身份
552
+
553
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
554
+
555
+ ## job update
556
+
557
+ 校验预期版本及空闲状态后更新对象
558
+
559
+ ```sh
560
+ v-cli art job update
561
+ ```
562
+
563
+ - `--project <id>`:工程身份
564
+ - `--id <id>`:对象身份
565
+ - `--revision <number>`:预期对象版本
566
+ - `--input <file>`:结构化配置文件
567
+
568
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
569
+
570
+ ## job derive
571
+
572
+ 派生独立草稿,不继承执行、报告或定版
573
+
574
+ ```sh
575
+ v-cli art job derive
576
+ ```
577
+
578
+ - `--project <id>`:工程身份
579
+ - `--id <id>`:对象身份
580
+ - `--revision <number>`:预期对象版本
581
+
582
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
583
+
584
+ ## job discard
585
+
586
+ 确认空闲后丢弃草稿并清理所属资源
587
+
588
+ ```sh
589
+ v-cli art job discard
590
+ ```
591
+
592
+ - `--project <id>`:工程身份
593
+ - `--id <id>`:对象身份
594
+ - `--revision <number>`:预期对象版本
595
+
596
+ - 查询不写入;修改验证 revision、归属和停止确认;冻结风格只读
597
+
598
+ ## style adopt
599
+
600
+ 采用当前有效报告并冻结
601
+
602
+ ```sh
603
+ v-cli art style adopt
604
+ ```
605
+
606
+ - `--project <id>`:工程身份
607
+ - `--id <id>`:对象身份
608
+ - `--revision <number>`:预期对象版本
609
+ - `--note <text>`:采用说明
610
+
611
+ - 来源匹配且冲突已解决;采用事务可恢复,核心只写一次
612
+
613
+ ## style recover
614
+
615
+ 恢复已授权采用事务
616
+
617
+ ```sh
618
+ v-cli art style recover
619
+ ```
620
+
621
+ - `--project <id>`:工程身份
622
+ - `--id <id>`:对象身份
623
+
624
+ - 不重新调用模型;核验核心和事务身份后完成状态提交
625
+
626
+ ## project init
627
+
628
+ 新建版本 2 工程
629
+
630
+ ```sh
631
+ v-cli art project init
632
+ ```
633
+
634
+ - `--project <id>`:工程身份
635
+ - `--input <file>`:结构化配置文件
636
+
637
+ - 工程存在拒绝覆写
638
+
639
+ ## project upgrade
640
+
641
+ 显式一次性工程升级
642
+
643
+ ```sh
644
+ v-cli art project upgrade
645
+ ```
646
+
647
+ - `--project <id>`:工程身份
648
+ - `--dry`:预检
649
+ - `--mapping <file>`:旧共享参考的明确归属映射
650
+
651
+ - 备份和原子替换,失败回滚;不猜参考归属
652
+
653
+ ## reference list
654
+
655
+ 查看对象参考
656
+
657
+ ```sh
658
+ v-cli art reference list
659
+ ```
660
+
661
+ - `--project <id>`:工程身份
662
+ - `--kind <style|task>`:对象粒度
663
+ - `--id <id>`:对象身份
664
+
665
+ - 只读
666
+
667
+ ## reference import
668
+
669
+ 导入对象私有图片
670
+
671
+ ```sh
672
+ v-cli art reference import
673
+ ```
674
+
675
+ - `--project <id>`:工程身份
676
+ - `--kind <style|task>`:对象粒度
677
+ - `--id <id>`:对象身份
678
+ - `--revision <number>`:预期对象版本
679
+ - `--source <file>`:用户原图
680
+ - `--category <name>`:四类静态参考之一
681
+ - `--purposes <list>`:逗号分隔动态用途
682
+ - `--note <text>`:参考说明
683
+
684
+ - 校验图片、大小、路径;复制不修改原图;不支持直接参考时拒绝
685
+
686
+ ## reference remove
687
+
688
+ 移除参考关联
689
+
690
+ ```sh
691
+ v-cli art reference remove
692
+ ```
693
+
694
+ - `--project <id>`:工程身份
695
+ - `--kind <style|task>`:对象粒度
696
+ - `--id <id>`:对象身份
697
+ - `--revision <number>`:预期对象版本
698
+ - `--item <id>`:参考身份
699
+
700
+ - 移除关联,保留历史证据资源
701
+
702
+ ## candidate list
703
+
704
+ 查看真实候选及完整性
705
+
706
+ ```sh
707
+ v-cli art candidate list
708
+ ```
709
+
710
+ - `--project <id>`:工程身份
711
+ - `--job <id>`:配置任务身份
712
+ - `--run <id>`:执行批次身份
713
+
714
+ - 只读;校验批次计划和候选身份
715
+
716
+ ## candidate finalizations
717
+
718
+ 查看资产定版
719
+
720
+ ```sh
721
+ v-cli art candidate finalizations
722
+ ```
723
+
724
+ - `--project <id>`:工程身份
725
+ - `--job <id>`:配置任务身份
726
+
727
+ - 只读
728
+
729
+ ## candidate finalize
730
+
731
+ 按资产定版候选
732
+
733
+ ```sh
734
+ v-cli art candidate finalize
735
+ ```
736
+
737
+ - `--project <id>`:工程身份
738
+ - `--job <id>`:配置任务身份
739
+ - `--run <id>`:执行批次身份
740
+ - `--revision <number>`:预期对象版本
741
+ - `--candidate <id>`:候选身份
742
+ - `--actor <text>`:操作者
743
+ - `--replace`:明确替换已有定版
744
+
745
+ - 生成完成与哈希有效;重复幂等,替换保留历史
746
+
747
+ ## candidate delete
748
+
749
+ 删除候选及关联定版
750
+
751
+ ```sh
752
+ v-cli art candidate delete
753
+ ```
754
+
755
+ - `--project <id>`:工程身份
756
+ - `--job <id>`:配置任务身份
757
+ - `--run <id>`:执行批次身份
758
+ - `--revision <number>`:预期对象版本
759
+ - `--candidate <id>`:候选身份
760
+ - `--actor <text>`:操作者
761
+ - `--confirm`:明确确认删除影响
762
+
763
+ - 运行和引用检查;先持久化删除记录,再清理私有文件
764
+
765
+ ## job analyze
766
+
767
+ 分析任务动态参考,仅转写指定用途,不继承静态风格
768
+
769
+ ```sh
770
+ v-cli art job analyze
771
+ ```
772
+
773
+ - `--project <id>`:工程身份
774
+ - `--id <id>`:对象身份
775
+ - `--revision <number>`:预期对象版本
776
+ - `--dry`:只读编译预演
777
+ - `--operation <id>`:分析启动前登记的稳定操作身份
778
+
779
+ - dry 不联网、不写参考目录;执行创建运行身份和不可变参考证据;远程停止不确定时保留资源
780
+
781
+ ## task recover
782
+
783
+ 仅从唯一原运行登记恢复身份;绝不重新执行
784
+
785
+ ```sh
786
+ v-cli art task recover --project P --operation OPERATION
787
+ ```
788
+
789
+ - `--project <id>`:原工程身份
790
+ - `--operation <id>`:启动前持久化的原操作身份
791
+
792
+ - 读取外部运行状态
793
+
794
+ ## reference update
795
+
796
+ 更新参考分类、任务用途与说明,版本校验并使分析失效
797
+
798
+ ```sh
799
+ v-cli art reference update --project P --kind style --id ID --revision N --item REF --input PATCH.json
800
+ ```
801
+
802
+ - `--project <id>`:工程身份
803
+ - `--kind <kind>`:style 或 task
804
+ - `--id <id>`:对象身份
805
+ - `--revision <number>`:预期版本
806
+ - `--item <id>`:参考身份
807
+ - `--input <file>`:category/purposes/note/ignore 的字段补丁
808
+
809
+ - 冻结风格只读;任务不允许静态分类;不修改用户原图;旧证据保留
810
+
811
+ ## deployment plan
812
+
813
+ 固定 Qwen 2.1 部署 plan
814
+
815
+ ```sh
816
+ v-cli art deployment plan
817
+ ```
818
+
819
+ - `--directory <dir>`:本机部署根目录
820
+ - `--endpoint <url>`:本机 ComfyUI 地址
821
+ - `--out <file>`:保存不可变预案
822
+
823
+ - 只读检测与预案;不下载、不启动、不采样
824
+
825
+ ## deployment start
826
+
827
+ 固定 Qwen 2.1 部署 start
828
+
829
+ ```sh
830
+ v-cli art deployment start
831
+ ```
832
+
833
+ - `--plan <file>`:实际冻结部署预案
834
+ - `--operation <id>`:稳定操作身份
835
+
836
+ - 下载、源码安装、独立环境、模型哈希验证、生成及编辑采样;不覆写既有不匹配文件
837
+
838
+ ## deployment status
839
+
840
+ 固定 Qwen 2.1 部署 status
841
+
842
+ ```sh
843
+ v-cli art deployment status
844
+ ```
845
+
846
+ - `--id <id>`:原部署身份
847
+
848
+ - 只查询原部署,不重复启动
849
+
850
+ ## deployment cancel
851
+
852
+ 固定 Qwen 2.1 部署 cancel
853
+
854
+ ```sh
855
+ v-cli art deployment cancel
856
+ ```
857
+
858
+ - `--id <id>`:原部署身份
859
+
860
+ - 请求取消;仅停止已核验子进程与本部署采样,确认后释放安装占用
861
+
862
+ ## deployment recover
863
+
864
+ 查询唯一原部署回执,不重新执行
865
+
866
+ ```sh
867
+ v-cli art deployment recover
868
+ ```
869
+
870
+ - `--operation <id>`:启动前登记的稳定身份
871
+
872
+ - 只读;无法唯一核验时停止未知
873
+
874
+ ## job template
875
+
876
+ 只读返回工具权威的任务配置模板;生成任务使用已冻结核心的题材
877
+
878
+ ```sh
879
+ v-cli art job template --project <id> --kind <generate|edit> [--core <id>]
880
+ ```
881
+
882
+ - `--project <id>`:工程身份
883
+ - `--kind <generate|edit>`:任务类型
884
+ - `--core <id>`:生成任务的冻结核心身份
885
+
886
+ - 只读返回模板;不创建任务或文件
887
+
888
+ ## job from-candidate
889
+
890
+ 将完整候选导入私有底图,创建独立编辑草稿,不运行
891
+
892
+ ```sh
893
+ v-cli art job from-candidate --project <id> --id <task> --run <id> --candidate <id>
894
+ ```
895
+
896
+ - `--project <id>`:工程身份
897
+ - `--id <task>`:源任务身份
898
+ - `--run <id>`:真实批次
899
+ - `--candidate <id>`:完整候选身份
900
+
901
+ - 写入新的编辑草稿和私有底图;保留候选来源;不启动生成
902
+
903
+ ## task resume
904
+
905
+ 仅恢复原上游任务的查询和下载,绝不重新提交
906
+
907
+ ```sh
908
+ v-cli art task resume TASK
909
+ ```
910
+
911
+ - 位置参数 `TASK`:art 任务 ID(必填)
912
+
913
+ - 写入原任务状态
914
+ - 查询原上游任务并下载已有产物
915
+ - 提交结果未知时拒绝恢复