@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.
- package/AGENTS.md +24 -51
- package/README.md +31 -93
- package/art-workshop.mjs +69 -25
- package/docs/commands.md +913 -80
- package/docs/configuration.md +33 -139
- package/docs/core-guidance.md +7 -7
- package/docs/data-formats.md +14 -152
- package/docs/deployment.md +40 -0
- package/docs/model-architecture.md +52 -0
- package/docs/modes.md +15 -116
- package/docs/remote-models.md +42 -0
- package/docs/troubleshooting.md +30 -68
- package/lib/adapters/dashscope.mjs +234 -0
- package/lib/adapters/index.mjs +28 -0
- package/lib/agent.mjs +2 -2
- package/lib/analysis-worker.mjs +25 -0
- package/lib/analyze.mjs +8 -8
- package/lib/backends.mjs +350 -74
- package/lib/bl.mjs +3 -18
- package/lib/candidates.mjs +82 -0
- package/lib/comfyui.mjs +10 -8
- package/lib/contracts.d.ts +67 -0
- package/lib/deployment-worker.mjs +97 -0
- package/lib/deployment.mjs +72 -0
- package/lib/design.mjs +5 -5
- package/lib/dimensions.mjs +22 -0
- package/lib/edit.mjs +6 -3
- package/lib/environments.mjs +67 -0
- package/lib/execution/remote.mjs +156 -0
- package/lib/executor.mjs +10 -24
- package/lib/generate.mjs +9 -5
- package/lib/generation-policy.mjs +198 -0
- package/lib/images.mjs +10 -0
- package/lib/lifecycle.mjs +40 -0
- package/lib/migration.mjs +154 -0
- package/lib/model-catalog.mjs +288 -0
- package/lib/model-registry.mjs +234 -0
- package/lib/plan.mjs +98 -28
- package/lib/project.mjs +13 -4
- package/lib/providers.mjs +27 -22
- package/lib/refs.mjs +12 -16
- package/lib/runtime.mjs +6 -4
- package/lib/service.mjs +45 -4
- package/lib/settings.mjs +2 -4
- package/lib/style-lifecycle.mjs +72 -0
- package/lib/task-references.mjs +35 -0
- package/lib/task-worker.mjs +225 -50
- package/lib/tasks.mjs +440 -63
- package/lib/templates.mjs +69 -0
- package/lib/transport/cli.mjs +69 -0
- package/lib/transport/http.mjs +82 -0
- package/lib/vision.mjs +46 -0
- package/lib/workflows.mjs +10 -1
- package/lib/workspace.mjs +190 -0
- package/package.json +9 -3
- package/skills/art-workshop/SKILL.md +27 -54
- package/v-cli.plugin.json +1257 -143
- 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
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
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
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
config
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
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
|
+
- 提交结果未知时拒绝恢复
|