@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/art-workshop.mjs CHANGED
@@ -1,174 +1,219 @@
1
- #!/usr/bin/env node
2
- import {prepareRuntime} from './lib/environment-runtime.mjs';
3
- import {readdirSync,existsSync} from 'node:fs';
4
- import {join,resolve} from 'node:path';
5
- import {readJson,writeJson} from './lib/shared.mjs';
6
- const args=process.argv.slice(2),pos=[],options={};
7
- if(args.length===1&&['--version','-V'].includes(args[0])){console.log(readJson(new URL('./package.json',import.meta.url)).version);process.exit(0);}
8
- const help='art-workshop: config path/show/init/validate | doctor [--backend ID] [--start] | workflow list | environment guide/list/prepare/inspect/verify/register/unregister | refs guide | agent index/docs/export | conversation start/status/cancel/resume | list | style export/import/sources/create/list/read/update/derive/discard/analyze/resolve/adopt/recover/validate/show | generate show/plan/run | edit show/plan/run | task list/status/wait/cancel/recover/resume | shutdown | check RUN | project init/upgrade | job template/from-candidate/create/list/read/update/derive/discard/restore/analyze | reference import/list/update/remove | candidate list/favorites/favorite/finalize/delete/finalizations | compare PLAN PLAN\nrun --background 返回任务 ID;--backend 选择后端。shutdown 停止当前工作区关联任务,核验共享队列和进程身份后关闭本地服务。\n也可用 v-cli art 调用;先 v-cli agent docs art,再 v-cli agent describe art --json 查看完整参数。';
9
- if(!args.length||args.length===1&&['--help','-h','help'].includes(args[0])){console.log(help);process.exit(0);}
10
- const {taskObjectView}=await import('./lib/asset-profile.mjs');
11
- const {loadJob,loadProject}=await import('./lib/project.mjs');
12
- const {referenceRoot,referenceGuide}=await import('./lib/refs.mjs');
13
- const {loadSettings,initSettings,externalPath}=await import('./lib/settings.mjs');
14
- const {validateReport,loadCore}=await import('./lib/core.mjs');
15
- const {compileGenerate}=await import('./lib/generate.mjs');
16
- const {compileEdit}=await import('./lib/edit.mjs');
17
- const {validatePlan,selectItems}=await import('./lib/plan.mjs');
18
- const {executePlan,checkRun}=await import('./lib/executor.mjs');
19
- const {agentIndex,agentDocs,exportSkill}=await import('./lib/agent.mjs');
20
- const {backendDefaults,bindBackend,buildComfyRequest}=await import('./lib/backends.mjs');
21
- const {startTask,taskStatus,taskView,recoverTask,resumeTask,waitTask,cancelTask,shutdown}=await import('./lib/tasks.mjs');
22
- const {runtimeRoot,tasks}=await import('./lib/runtime.mjs');
23
- const {validateConfiguration,doctor}=await import('./lib/diagnostics.mjs');
24
- const {finishMigration,createProject,createObject,listObjects,readObject,styleView,updateObject,deriveObject,discardObject,restoreTask,importReference,removeReference,updateReference,taskDisplayState,STYLE_CATEGORIES,TASK_PURPOSES}=await import('./lib/workspace.mjs');
25
- const {startAnalysis,adoptStyle,recoverStyleAdoption,resolveStyleIssue,reviseStyleRules}=await import('./lib/style-lifecycle.mjs');
26
- const {candidates,finalize,deleteCandidate,finalizations,editFromCandidate}=await import('./lib/candidates.mjs');
27
- const {favoriteList,setFavorite}=await import('./lib/favorites.mjs');
28
- const {upgradeProject}=await import('./lib/migration.mjs');
29
- const {workflowList}=await import('./lib/workflows.mjs');
30
- const {jobTemplate}=await import('./lib/templates.mjs');
31
- const {deploymentGuide}=await import('./lib/deployment-guide.mjs');
32
- const {inspectInstallation,discoverInstallations}=await import('./lib/environments.mjs');
33
- const {verifyInstallation,registerInstallation,unregisterInstallation}=await import('./lib/environment-operations.mjs');
34
- const flags=new Set(['dry','explore','background','start','replace','confirm','all-variants']);
35
- const allowed=new Set(['config','workspace','output-dir','refs-dir','cache-dir','directory','host','session','request','endpoint','guide','project','input','out','report','note','core','job','plan','item','variant','offset','limit','file','backend','timeout','kind','id','revision','source','category','purposes','mapping','run','candidate','actor','operation','retry-run','item-id','value','name',...flags]);
36
- for(let i=0;i<args.length;i++){if(args[i].startsWith('--')){const k=args[i].slice(2);if(!allowed.has(k)||k in options) throw new Error('未知或重复参数 '+k);options[k]=flags.has(k)?true:args[++i];if(options[k]===undefined) throw new Error('参数缺少值 '+k);}else pos.push(args[i]);}
37
- const print=x=>console.log(JSON.stringify(x?.schema==='art-workshop/style'?styleView(settings.paths.workspace,x):x,null,2));
38
- if(pos[0]==='workflow'&&pos[1]==='list'){print(workflowList());process.exit(0);}
39
- let settings;
40
- try{settings=loadSettings({file:options.config?resolve(options.config):undefined,workspace:options.workspace,output:options['output-dir'],refs:options['refs-dir'],cache:options['cache-dir']});}
41
- catch(error){print({ok:false,stage:'configuration',issues:[{code:'configuration',message:error.message}]});process.exit(1);}
42
- if(pos[0]==='config'&&pos[1]==='validate'||pos[0]==='doctor'){
43
- if(pos[0]==='doctor'&&pos[1])throw new Error('doctor 不接受位置参数');
44
- const report=pos[0]==='doctor'?await doctor(settings,{backend:options.backend,start:options.start}):validateConfiguration(settings,{backend:options.backend});print(report);process.exitCode=report.ok?0:1;
45
- }else{
46
- if(options.start)throw new Error('--start 仅用于 doctor');
47
- const ROOT=settings.paths.workspace;
48
- const path=x=>externalPath(resolve(ROOT,x),'资源文件');
49
- function required(k){const value=options[k]??(k==='project'?settings.defaultProject:undefined);if(!value) throw new Error('需要 --'+k);return value;}
50
- function manifestPath(value){const p=externalPath(resolve(settings.paths.output,value));return p.endsWith('.json')?p:join(p,'manifest.json');}
51
- try {
52
- const [module,action]=pos;
53
-
54
- const effectiveRefs=referenceRoot({defaultRefsDir:settings.paths.refs});
55
- if(module==='conversation'){
56
- const {startConversation,conversationStatus,controlConversation}=await import('./lib/conversation.mjs');
57
- if(action==='start')print(await startConversation(readJson(path(required('input'))),settings));
58
- else if(action==='status')print(await conversationStatus(settings,required('session'),required('request')));
59
- else if(['cancel','resume','close'].includes(action))print(await controlConversation(settings,required('session'),required('request'),action));
60
- else throw new Error('未知 conversation 操作');
61
- }else if(module==='environment'){
62
- if(action==='guide')print(deploymentGuide(options.guide));
63
- else if(action==='list')print({environments:discoverInstallations()});
64
- else if(action==='prepare')print(await prepareRuntime(required('directory'),{guideId:options.guide}));
65
- else if(action==='inspect')print(await inspectInstallation(required('directory'),required('endpoint'),options.guide));
66
- else if(action==='verify'){const result=await verifyInstallation(required('directory'),required('endpoint'),{guideId:options.guide});print(result);if(!result.ok)process.exitCode=1;}
67
- else if(action==='register')print(await registerInstallation(required('directory'),required('endpoint'),{guideId:options.guide}));
68
- else if(action==='unregister')print(await unregisterInstallation(required('directory')));
69
- else throw new Error('未知 environment 操作');
70
- }
71
- else if(module==='config'){
72
- if(action==='path') console.log(settings.file);
73
- else if(action==='show') print(settings);
74
- else if(action==='init') print(initSettings(settings.file));
75
- else throw new Error('未知 config 操作');
76
- }
77
- else if(module==='project'){
78
- if(action==='upgrade')print(await upgradeProject(ROOT,required('project'),{dry:options.dry,settings,referenceAssignments:options.mapping?readJson(path(options.mapping)):undefined}));
79
- else if(action==='init')print(await createProject(settings,required('project'),readJson(path(required('input')))));
80
- else throw new Error('未知 project 操作');
81
- }
82
- else if(module==='reference'){
83
- const projectId=required('project'),kind=required('kind'),objectId=required('id');
84
- if(action==='list')print(readObject(ROOT,projectId,kind,objectId).references);
85
- else if(action==='import')print(await importReference(settings,projectId,kind,objectId,Number(required('revision')),{source:required('source'),category:options.category,purposes:options.purposes?.split(','),itemId:options['item-id'],note:options.note??''}));
86
- else if(action==='remove')print(await removeReference(settings,projectId,kind,objectId,Number(required('revision')),required('item')));
87
- else if(action==='update')print(await updateReference(settings,projectId,kind,objectId,Number(required('revision')),required('item'),readJson(path(required('input')))));
88
- else throw new Error('未知 reference 操作');
89
- }
90
- else if(module==='job'||module==='style'&&['create','list','update','derive','discard','read','migration-complete'].includes(action)){
91
- const projectId=required('project'),kind=module==='job'?'task':'style';
92
- if(action==='migration-complete')print(await finishMigration(settings,projectId,kind,required('id'),Number(required('revision')),readJson(path(required('input')))));
93
- else if(action==='template'&&kind==='task')print(jobTemplate(ROOT,projectId,{kind:options.kind,core:options.core}));
94
- else if(action==='from-candidate'&&kind==='task')print(await editFromCandidate(settings,projectId,required('id'),{runId:required('run'),candidateId:required('candidate')}));
95
- else if(action==='list'){const records=listObjects(ROOT,projectId,kind),runs=kind==='task'?tasks(runtimeRoot(settings)).map(t=>taskStatus(runtimeRoot(settings),t.taskId)):[];print(records.map(record=>kind==='task'?{...taskObjectView(ROOT,record),display:taskDisplayState(record,runs,record.finalizations??[])}:styleView(ROOT,record)));}
96
- else if(action==='create')print(await createObject(settings,projectId,kind,readJson(path(required('input')))));
97
- else if(action==='read'){const record=readObject(ROOT,projectId,kind,required('id'));print(kind==='style'?styleView(ROOT,record):taskObjectView(ROOT,record));}
98
- else if(action==='update'){const record=await updateObject(settings,projectId,kind,required('id'),Number(required('revision')),readJson(path(required('input'))));print(kind==='style'?styleView(ROOT,record):taskObjectView(ROOT,record));}
99
- else if(action==='analyze'&&kind==='task')print(await startAnalysis(settings,projectId,required('id'),Number(required('revision')),{dry:options.dry,kind:'task',operationId:options.operation}));
100
- else if(action==='derive')print(await deriveObject(settings,projectId,kind,required('id'),Number(required('revision'))));
101
- else if(action==='restore'&&kind==='task')print(await restoreTask(settings,projectId,required('id'),Number(required('revision'))));
102
- else if(action==='discard')print(await discardObject(settings,projectId,kind,required('id'),Number(required('revision'))));
103
- else throw new Error('未知对象操作');
104
- }
105
- else if(module==='refs'){
106
- if(action!=='guide') throw new Error('未知 refs 操作;使用 refs guide');
107
- console.log(referenceGuide(effectiveRefs));
108
- }
109
- else if(module==='agent'){
110
- if(action==='index') print({...agentIndex(undefined,ROOT),config:settings.file,paths:settings.paths});
111
- else if(action==='docs') console.log(agentDocs());
112
- else if(action==='export') print(exportSkill({directory:required('directory'),host:required('host'),dry:options.dry}));
113
- else throw new Error('未知 agent 操作');
114
- }
115
- else if(module==='list'){print((existsSync(join(ROOT,'projects'))?readdirSync(join(ROOT,'projects')):[]).map(id=>readJson(join(ROOT,'projects',id,'project.json'))));}
116
- else if(module==='style'&&['export','import','sources'].includes(action)){
117
- const bundle=await import('./lib/style-bundle.mjs');
118
- if(action==='export')print(bundle.exportStyleBundle(ROOT,required('project'),required('id'),path(required('out'))));
119
- else if(action==='import')print(await bundle.importStyleBundle(settings,required('project'),path(required('file'))));
120
- else print(bundle.listStyleSources(readJson(path(required('input')))));
121
- }
122
- else if(module==='style'){
123
- const projectId=required('project');
124
- if(action==='analyze')print(await startAnalysis(settings,projectId,required('id'),Number(required('revision')),{dry:options.dry,operationId:options.operation}));
125
- else if(action==='recover')print(await recoverStyleAdoption(settings,projectId,required('id')));
126
- else if(action==='revise')print(styleView(ROOT,await reviseStyleRules(settings,projectId,required('id'),Number(required('revision')),readJson(path(required('input'))))));
127
- else if(action==='resolve')print(styleView(ROOT,await resolveStyleIssue(settings,projectId,required('id'),Number(required('revision')),readJson(path(required('input'))))));
128
- else if(action==='adopt')print(await adoptStyle(settings,projectId,required('id'),Number(required('revision')),{note:options.note}));
129
- else if(action==='validate') print(validateReport(readJson(path(required('report'))),projectId));
130
- else if(action==='show') print(loadCore(projectId,required('core'),ROOT));
131
- else throw new Error('未知 style 操作');
132
- }else if(['generate','edit'].includes(module)){
133
- if(action==='show') print(loadJob(required('project'),required('job'),module,ROOT));
134
- else if(['plan','run'].includes(action)){
135
- let plan;
136
- if(options.plan){if(action!=='run'||['project','job','core','explore','backend'].some(k=>options[k]!==undefined)) throw new Error('冻结计划不能同时调整来源;修改任务后重新 plan');plan=readJson(path(options.plan));validatePlan(plan);if(plan.module!==module) throw new Error('计划模块不匹配');}
137
- else {const job=loadJob(required('project'),required('job'),module,ROOT),backend=options.backend??job.generation?.backend;plan=bindBackend((module==='generate'?compileGenerate:compileEdit)({projectId:required('project'),jobId:required('job'),coreId:options.core,root:ROOT,localExecution:backendDefaults(settings,backend)}),settings,backend);}
138
- if(action==='plan'){if(options.out) writeJson(path(options.out),plan);print(plan);}
139
- else {
140
- if(options['retry-run']&&(options.dry||options.variant||options.item||options.offset||options.limit))throw new Error('失败项重试不能混用预演或手动筛选');
141
- if(options.variant&&options['all-variants'])throw new Error('不能同时选择单个候选与全部候选');
142
- const variant=options.variant??(options.explore||options['all-variants']?undefined:'base');const items=selectItems(plan,{item:options.item,variant,offset:options.offset===undefined?0:Number(options.offset),limit:options.limit===undefined?undefined:Number(options.limit)});
143
- if(options.dry){if(plan.backend?.provider==='comfyui')print({dry:true,remoteCalls:0,planHash:plan.planHash,requests:items.map(item=>({itemId:item.itemId,variantId:item.variantId,requests:Array.from({length:(item.execution??plan.execution).perValue},(_,index)=>buildComfyRequest(plan,item,{index}))}))});else executePlan(plan,items,{outputRoot:settings.paths.output,dry:true});}
144
- else {const task=await startTask(plan,items,settings,{operationId:options.operation,retryRun:options['retry-run']??null});if(options.background)print(task);else {console.log('task → '+task.taskId);const result=await waitTask(runtimeRoot(settings),task.taskId);print(taskView(result));if(result.status!=='succeeded')process.exitCode=1;}}
145
- }
146
- }else throw new Error('未知模块操作');
147
- }else if(module==='task'){
148
- const root=runtimeRoot(settings),taskId=pos[2];
149
- if(action==='list')print(tasks(root).filter(t=>!options.project||(t.plan?.project??t.project)===options.project).map(t=>taskView(taskStatus(root,t.taskId))));
150
- else if(action==='recover')print(recoverTask(root,required('project'),required('operation')));
151
- else if(action==='status')print(taskView(taskStatus(root,taskId)));
152
- else if(action==='resume')print(await resumeTask(root,taskId));
153
- else if(action==='cancel')print(taskView(await cancelTask(root,taskId)));
154
- else if(action==='wait'){const timeoutSeconds=options.timeout===undefined?3600:Number(options.timeout);if(!Number.isFinite(timeoutSeconds)||timeoutSeconds<=0)throw new Error('timeout 必须为正秒数');const result=await waitTask(root,taskId,{timeoutSeconds});print(taskView(result));if(result.status!=='succeeded')process.exitCode=1;}
155
- else throw new Error('未知 task 操作');
156
- }else if(module==='shutdown'){if(action)throw new Error('shutdown 不接受位置参数');print(await shutdown(settings));}
157
- else if(module==='candidate'){
158
- const projectId=required('project');
159
- if(action==='favorites')print(favoriteList(settings,projectId));
160
- else if(action==='favorite'){
161
- if(!['true','false'].includes(options.value))throw new Error('value 必须为 true 或 false');
162
- print(await setFavorite(settings,projectId,required('job'),{runId:required('run'),candidateId:required('candidate'),value:options.value==='true'}));
163
- }
164
- else if(action==='list')print(candidates(settings,projectId,required('job'),required('run')));
165
- else if(action==='finalize')print(await finalize(settings,projectId,required('job'),Number(required('revision')),{runId:required('run'),candidateId:required('candidate'),replace:options.replace,actor:required('actor'),name:options.name}));
166
- else if(action==='delete')print(await deleteCandidate(settings,projectId,required('job'),Number(required('revision')),{runId:required('run'),candidateId:required('candidate'),confirm:options.confirm,actor:required('actor')}));
167
- else if(action==='finalizations')print(finalizations(settings,projectId,required('job')));
168
- else throw new Error('未知 candidate 操作');
169
- }else if(module==='check'){print(checkRun(readJson(manifestPath(action??required('file'))),manifestPath(action??required('file'))));
170
- }else if(module==='compare'){const read=value=>{const data=readJson(path(value));const plan=data.plan??data;validatePlan(plan);return plan;};const a=read(action),b=read(pos[2]);print({sameCore:a.sources.coreHash===b.sources.coreHash,execution:{before:a.execution,after:b.execution},items:b.items.map(x=>({itemId:x.itemId,variantId:x.variantId,changed:a.items.find(y=>y.itemId===x.itemId&&y.variantId===x.variantId)?.inputHash!==x.inputHash}))});}
171
- else if(!module||module==='help') console.log(help);
172
- else throw new Error('未知模块或旧入口:'+module);
173
- }catch(e){print({ok:false,error:e.message,...(e.diagnostic?{diagnostic:e.diagnostic}:{})});process.exitCode=1;}
174
- }
1
+ #!/usr/bin/env node
2
+ import {prepareRuntime} from './lib/environment-runtime.mjs';
3
+ import {readdirSync,existsSync} from 'node:fs';
4
+ import {join,resolve} from 'node:path';
5
+ import {readJson,writeJson} from './lib/shared.mjs';
6
+ const args=process.argv.slice(2),pos=[],options={};
7
+ const channel=['image','video'].includes(args[0])?args.shift():null;
8
+ if(args.length===1&&['--version','-V'].includes(args[0])){console.log(readJson(new URL('./package.json',import.meta.url)).version);process.exit(0);}
9
+ const imageHelp='art-workshop image: config path/show/init/validate | doctor [--backend ID] [--start] | workflow list | environment guide/list/prepare/inspect/verify/register/unregister | refs guide | agent index/docs/export | conversation start/status/cancel/resume | list | style export/import/sources/create/list/read/update/derive/discard/analyze/resolve/adopt/recover/validate/show | generate show/plan/run | edit show/plan/run | task list/status/wait/cancel/recover/resume | shutdown | check RUN | project init/upgrade | job template/from-candidate/create/list/read/update/derive/discard/restore/analyze | reference import/list/update/remove | candidate list/favorites/favorite/finalize/delete/finalizations | compare PLAN PLAN\nrun --background 返回任务 ID;--backend 选择后端。shutdown 停止当前工作区关联任务,核验共享队列和进程身份后关闭本地服务。';
10
+ const videoHelp='art-workshop video: describe | snapshot | settings get/save/presets h3 | runtime status/start/stop | task list/read/create/rename/archive | operation create/update/rename/derive/validate/run/resume/cancel/accept/bind | script read/update/plan/apply | film compose/refine/preview/adopt/undo | material list/import/import-file/upload/hide | image | media status | execution status\n--workspace <工程根目录> --project <项目身份,默认 project> --input <工程内 JSON 对象文件> --operation <稳定CLI操作身份>\n所有写入必须传 --operation,重复同身份只核对原回执;execution status --operation 查询意图/回执。先 describe 读取业务输入契约;写入保留 revision/expectedRevision,生成必须传稳定 requestId。unknown 只查询原运行,不换 ID 重投。读取不会启动服务,runtime start/operation run/film 操作必须显式调用。';
11
+ const help='art-workshop: image(图片)与 video(视频)两个独立通道。图片旧根命令继续兼容。\n'+imageHelp+'\n'+videoHelp+'\n也可用 v-cli art 调用;先 v-cli agent docs art,再 v-cli agent describe art --json 查看完整参数。';
12
+ if(!args.length||args.length===1&&['--help','-h','help'].includes(args[0])){console.log(channel==='video'?videoHelp:channel==='image'?imageHelp:help);process.exit(0);}
13
+ if(channel==='video'){
14
+ let api;
15
+ try{
16
+ const positions=[],values={},allowed=new Set(['workspace','project','input','operation']);
17
+ for(let index=0;index<args.length;index++){
18
+ const argument=args[index];
19
+ if(argument.startsWith('-')){
20
+ const key=argument.slice(2);
21
+ if(!argument.startsWith('--')||!allowed.has(key)||key in values)throw Object.assign(new Error('未知或重复视频参数 '+argument),{code:'video-cli-argument-invalid'});
22
+ const value=args[++index];if(!value||value.startsWith('--'))throw Object.assign(new Error('视频参数缺少值 '+argument),{code:'video-cli-argument-invalid'});values[key]=value;
23
+ }else positions.push(argument);
24
+ }
25
+ const {actions,readActions,createVideoChannel}=await import('./lib/video.mjs');
26
+ const action=positions.join('.');
27
+ if(!actions.has(action)&&action!=='execution.status')throw Object.assign(new Error('未知视频操作:'+positions.join(' ')),{code:'video-action-invalid'});
28
+ const root=resolve(values.workspace||process.cwd()),workspaceId=values.project||'project';
29
+ if(action==='execution.status'){
30
+ if(values.input)throw new Error('execution status 不接受 --input');
31
+ const {readChannelOperation}=await import('./lib/channel-operation.mjs');
32
+ console.log(JSON.stringify(await readChannelOperation({root,operationId:values.operation}),null,2));process.exit(0);
33
+ }
34
+ let input={};
35
+ if(values.input){
36
+ const {projectPath}=await import('./lib/video/path.mjs');
37
+ const {readFile,stat}=await import('node:fs/promises');
38
+ const file=await projectPath(root,values.input),info=await stat(file);
39
+ if(!info.isFile()||info.size>32*1024*1024)throw Object.assign(new Error('视频请求必须为不超过32MiB的工程内JSON文件'),{code:'video-input-invalid'});
40
+ input=JSON.parse(await readFile(file,'utf8'));
41
+ if(!input||typeof input!=='object'||Array.isArray(input))throw Object.assign(new Error('视频请求必须为JSON对象'),{code:'video-input-invalid'});
42
+ }
43
+ api=createVideoChannel({root,workspaceId});
44
+ const readonly=readActions.has(action)||action==='media.status';
45
+ const result=readonly?await api.execute(action,input):await (await import('./lib/channel-operation.mjs')).executeChannelOperation({root,workspaceId,operationId:values.operation,action,input,execute:()=>api.execute(action,input)});
46
+ console.log(JSON.stringify(result,null,2));
47
+ }catch(error){console.log(JSON.stringify({ok:false,error:error.message,...(error.code?{code:error.code}:{}),...(error.unknown===true?{unknown:true}:{}),...(error.operationId?{operationId:error.operationId}:{})},null,2));process.exitCode=1;}
48
+ finally{if(api)await api.dispose();}
49
+ process.exit(process.exitCode||0);
50
+ }
51
+ const {taskObjectView}=await import('./lib/asset-profile.mjs');
52
+ const {loadJob,loadProject}=await import('./lib/project.mjs');
53
+ const {referenceRoot,referenceGuide}=await import('./lib/refs.mjs');
54
+ const {loadSettings,initSettings,externalPath}=await import('./lib/settings.mjs');
55
+ const {validateReport,loadCore}=await import('./lib/core.mjs');
56
+ const {compileGenerate}=await import('./lib/generate.mjs');
57
+ const {compileEdit}=await import('./lib/edit.mjs');
58
+ const {validatePlan,selectItems}=await import('./lib/plan.mjs');
59
+ const {executePlan,checkRun}=await import('./lib/executor.mjs');
60
+ const {agentIndex,agentDocs,exportSkill}=await import('./lib/agent.mjs');
61
+ const {backendDefaults,bindBackend,buildComfyRequest}=await import('./lib/backends.mjs');
62
+ const {startTask,taskStatus,taskView,recoverTask,resumeTask,waitTask,cancelTask,shutdown}=await import('./lib/tasks.mjs');
63
+ const {runtimeRoot,tasks}=await import('./lib/runtime.mjs');
64
+ const {validateConfiguration,doctor}=await import('./lib/diagnostics.mjs');
65
+ const {finishMigration,createProject,createObject,listObjects,readObject,styleView,updateObject,deriveObject,discardObject,restoreTask,importReference,removeReference,updateReference,taskDisplayState,STYLE_CATEGORIES,TASK_PURPOSES}=await import('./lib/workspace.mjs');
66
+ const {startAnalysis,adoptStyle,recoverStyleAdoption,resolveStyleIssue,reviseStyleRules}=await import('./lib/style-lifecycle.mjs');
67
+ const {candidates,finalize,deleteCandidate,finalizations,editFromCandidate}=await import('./lib/candidates.mjs');
68
+ const {createStyleSampleJob,selectStyleSample,removeStyleSample}=await import('./lib/style-samples.mjs');
69
+ const {favoriteList,setFavorite}=await import('./lib/favorites.mjs');
70
+ const {upgradeProject}=await import('./lib/migration.mjs');
71
+ const {workflowList}=await import('./lib/workflows.mjs');
72
+ const {jobTemplate}=await import('./lib/templates.mjs');
73
+ const {deploymentGuide}=await import('./lib/deployment-guide.mjs');
74
+ const {inspectInstallation,discoverInstallations}=await import('./lib/environments.mjs');
75
+ const {verifyInstallation,registerInstallation,unregisterInstallation}=await import('./lib/environment-operations.mjs');
76
+ const flags=new Set(['dry','explore','background','start','replace','confirm','all-variants']);
77
+ const allowed=new Set(['config','workspace','output-dir','refs-dir','cache-dir','directory','host','session','request','endpoint','guide','project','input','out','report','note','core','job','plan','item','variant','offset','limit','file','backend','timeout','kind','id','revision','source','category','purposes','mapping','run','candidate','sample','actor','operation','retry-run','item-id','value','name','count',...flags]);
78
+ for(let i=0;i<args.length;i++){if(args[i].startsWith('--')){const k=args[i].slice(2);if(!allowed.has(k)||k in options) throw new Error('未知或重复参数 '+k);options[k]=flags.has(k)?true:args[++i];if(options[k]===undefined) throw new Error('参数缺少值 '+k);}else pos.push(args[i]);}
79
+ const print=x=>console.log(JSON.stringify(x?.schema==='art-workshop/style'&&!x.format?styleView(settings.paths.workspace,x):x,null,2));
80
+ if(pos[0]==='workflow'&&pos[1]==='list'){print(workflowList());process.exit(0);}
81
+ let settings;
82
+ try{settings=loadSettings({file:options.config?resolve(options.config):undefined,workspace:options.workspace,output:options['output-dir'],refs:options['refs-dir'],cache:options['cache-dir']});}
83
+ catch(error){print({ok:false,stage:'configuration',issues:[{code:'configuration',message:error.message}]});process.exit(1);}
84
+ if(pos[0]==='config'&&pos[1]==='validate'||pos[0]==='doctor'){
85
+ if(pos[0]==='doctor'&&pos[1])throw new Error('doctor 不接受位置参数');
86
+ const report=pos[0]==='doctor'?await doctor(settings,{backend:options.backend,start:options.start}):validateConfiguration(settings,{backend:options.backend});print(report);process.exitCode=report.ok?0:1;
87
+ }else{
88
+ if(options.start)throw new Error('--start 仅用于 doctor');
89
+ const ROOT=settings.paths.workspace;
90
+ const path=x=>externalPath(resolve(ROOT,x),'资源文件');
91
+ function required(k){const value=options[k]??(k==='project'?settings.defaultProject:undefined);if(!value) throw new Error('需要 --'+k);return value;}
92
+ function manifestPath(value){const p=externalPath(resolve(settings.paths.output,value));return p.endsWith('.json')?p:join(p,'manifest.json');}
93
+ try {
94
+ const [module,action]=pos;
95
+
96
+ const effectiveRefs=referenceRoot({defaultRefsDir:settings.paths.refs});
97
+ if(module==='conversation'){
98
+ const {startConversation,conversationStatus,controlConversation}=await import('./lib/conversation.mjs');
99
+ if(action==='start')print(await startConversation(readJson(path(required('input'))),settings));
100
+ else if(action==='status')print(await conversationStatus(settings,required('session'),required('request')));
101
+ else if(['cancel','resume','close'].includes(action))print(await controlConversation(settings,required('session'),required('request'),action));
102
+ else throw new Error('未知 conversation 操作');
103
+ }else if(module==='environment'){
104
+ if(action==='guide')print(deploymentGuide(options.guide));
105
+ else if(action==='list')print({environments:discoverInstallations()});
106
+ else if(action==='prepare')print(await prepareRuntime(required('directory'),{guideId:options.guide}));
107
+ else if(action==='inspect')print(await inspectInstallation(required('directory'),required('endpoint'),options.guide));
108
+ else if(action==='verify'){const result=await verifyInstallation(required('directory'),required('endpoint'),{guideId:options.guide});print(result);if(!result.ok)process.exitCode=1;}
109
+ else if(action==='register')print(await registerInstallation(required('directory'),required('endpoint'),{guideId:options.guide}));
110
+ else if(action==='unregister')print(await unregisterInstallation(required('directory')));
111
+ else throw new Error('未知 environment 操作');
112
+ }
113
+ else if(module==='config'){
114
+ if(action==='path') console.log(settings.file);
115
+ else if(action==='show') print(settings);
116
+ else if(action==='init') print(initSettings(settings.file));
117
+ else throw new Error('未知 config 操作');
118
+ }
119
+ else if(module==='project'){
120
+ if(action==='upgrade')print(await upgradeProject(ROOT,required('project'),{dry:options.dry,settings,referenceAssignments:options.mapping?readJson(path(options.mapping)):undefined}));
121
+ else if(action==='init')print(await createProject(settings,required('project'),readJson(path(required('input')))));
122
+ else throw new Error('未知 project 操作');
123
+ }
124
+ else if(module==='reference'){
125
+ const projectId=required('project'),kind=required('kind'),objectId=required('id');
126
+ if(action==='list')print(readObject(ROOT,projectId,kind,objectId).references);
127
+ else if(action==='import')print(await importReference(settings,projectId,kind,objectId,Number(required('revision')),{source:required('source'),category:options.category,purposes:options.purposes?.split(','),itemId:options['item-id'],note:options.note??''}));
128
+ else if(action==='remove')print(await removeReference(settings,projectId,kind,objectId,Number(required('revision')),required('item')));
129
+ else if(action==='update')print(await updateReference(settings,projectId,kind,objectId,Number(required('revision')),required('item'),readJson(path(required('input')))));
130
+ else throw new Error('未知 reference 操作');
131
+ }
132
+ else if(module==='job'||module==='style'&&['create','list','update','derive','discard','read','migration-complete'].includes(action)){
133
+ const projectId=required('project'),kind=module==='job'?'task':'style';
134
+ if(action==='migration-complete')print(await finishMigration(settings,projectId,kind,required('id'),Number(required('revision')),readJson(path(required('input')))));
135
+ else if(action==='template'&&kind==='task')print(jobTemplate(ROOT,projectId,{kind:options.kind,core:options.core}));
136
+ else if(action==='from-candidate'&&kind==='task')print(await editFromCandidate(settings,projectId,required('id'),{runId:required('run'),candidateId:required('candidate')}));
137
+ else if(action==='list'){const records=listObjects(ROOT,projectId,kind),runs=kind==='task'?tasks(runtimeRoot(settings)).map(t=>taskStatus(runtimeRoot(settings),t.taskId)):[];print(records.map(record=>kind==='task'?{...taskObjectView(ROOT,record),display:taskDisplayState(record,runs,record.finalizations??[])}:styleView(ROOT,record)));}
138
+ else if(action==='create')print(await createObject(settings,projectId,kind,readJson(path(required('input')))));
139
+ else if(action==='read'){const record=readObject(ROOT,projectId,kind,required('id'));print(kind==='style'?styleView(ROOT,record):taskObjectView(ROOT,record));}
140
+ else if(action==='update'){const record=await updateObject(settings,projectId,kind,required('id'),Number(required('revision')),readJson(path(required('input'))));print(kind==='style'?styleView(ROOT,record):taskObjectView(ROOT,record));}
141
+ else if(action==='analyze'&&kind==='task')print(await startAnalysis(settings,projectId,required('id'),Number(required('revision')),{dry:options.dry,kind:'task',operationId:options.operation}));
142
+ else if(action==='derive')print(await deriveObject(settings,projectId,kind,required('id'),Number(required('revision'))));
143
+ else if(action==='restore'&&kind==='task')print(await restoreTask(settings,projectId,required('id'),Number(required('revision'))));
144
+ else if(action==='discard')print(await discardObject(settings,projectId,kind,required('id'),Number(required('revision'))));
145
+ else throw new Error('未知对象操作');
146
+ }
147
+ else if(module==='refs'){
148
+ if(action!=='guide') throw new Error('未知 refs 操作;使用 refs guide');
149
+ console.log(referenceGuide(effectiveRefs));
150
+ }
151
+ else if(module==='agent'){
152
+ if(action==='index') print({...agentIndex(undefined,ROOT),config:settings.file,paths:settings.paths});
153
+ else if(action==='docs') console.log(agentDocs());
154
+ else if(action==='export') print(exportSkill({directory:required('directory'),host:required('host'),dry:options.dry}));
155
+ else throw new Error('未知 agent 操作');
156
+ }
157
+ else if(module==='list'){print((existsSync(join(ROOT,'projects'))?readdirSync(join(ROOT,'projects')):[]).map(id=>readJson(join(ROOT,'projects',id,'project.json'))));}
158
+ else if(module==='style'&&['export','import','sources'].includes(action)){
159
+ const bundle=await import('./lib/style-bundle.mjs');
160
+ if(action==='export')print(bundle.exportStyleBundle(ROOT,required('project'),required('id'),path(required('out'))));
161
+ else if(action==='import')print(await bundle.importStyleBundle(settings,required('project'),path(required('file'))));
162
+ else print(bundle.listStyleSources(readJson(path(required('input')))));
163
+ }
164
+ else if(module==='style'){
165
+ const projectId=required('project');
166
+ if(action==='sample-job')print(await createStyleSampleJob(settings,projectId,required('id'),Number(required('revision')),{name:options.name,...(options.count!==undefined?{count:Number(options.count)}:{})}));
167
+ else if(action==='sample-select')print(await selectStyleSample(settings,projectId,required('id'),Number(required('revision')),{job:required('job'),run:required('run'),candidate:required('candidate'),note:options.note}));
168
+ else if(action==='sample-remove')print(await removeStyleSample(settings,projectId,required('id'),Number(required('revision')),required('sample')));
169
+ else if(action==='analyze')print(await startAnalysis(settings,projectId,required('id'),Number(required('revision')),{dry:options.dry,operationId:options.operation}));
170
+ else if(action==='recover')print(await recoverStyleAdoption(settings,projectId,required('id')));
171
+ else if(action==='revise')print(styleView(ROOT,await reviseStyleRules(settings,projectId,required('id'),Number(required('revision')),readJson(path(required('input'))))));
172
+ else if(action==='resolve')print(styleView(ROOT,await resolveStyleIssue(settings,projectId,required('id'),Number(required('revision')),readJson(path(required('input'))))));
173
+ else if(action==='adopt')print(await adoptStyle(settings,projectId,required('id'),Number(required('revision')),{note:options.note}));
174
+ else if(action==='validate') print(validateReport(readJson(path(required('report'))),projectId));
175
+ else if(action==='show') print(loadCore(projectId,required('core'),ROOT));
176
+ else throw new Error('未知 style 操作');
177
+ }else if(['generate','edit'].includes(module)){
178
+ if(action==='show') print(loadJob(required('project'),required('job'),module,ROOT));
179
+ else if(['plan','run'].includes(action)){
180
+ let plan;
181
+ if(options.plan){if(action!=='run'||['project','job','core','explore','backend'].some(k=>options[k]!==undefined)) throw new Error('冻结计划不能同时调整来源;修改任务后重新 plan');plan=readJson(path(options.plan));validatePlan(plan);if(plan.module!==module) throw new Error('计划模块不匹配');}
182
+ else {const job=loadJob(required('project'),required('job'),module,ROOT),backend=options.backend??job.generation?.backend;plan=bindBackend((module==='generate'?compileGenerate:compileEdit)({projectId:required('project'),jobId:required('job'),coreId:options.core,root:ROOT,localExecution:backendDefaults(settings,backend)}),settings,backend);}
183
+ if(action==='plan'){if(options.out) writeJson(path(options.out),plan);print(plan);}
184
+ else {
185
+ if(options['retry-run']&&(options.dry||options.variant||options.item||options.offset||options.limit))throw new Error('失败项重试不能混用预演或手动筛选');
186
+ if(options.variant&&options['all-variants'])throw new Error('不能同时选择单个候选与全部候选');
187
+ const variant=options.variant??(options.explore||options['all-variants']?undefined:'base');const items=selectItems(plan,{item:options.item,variant,offset:options.offset===undefined?0:Number(options.offset),limit:options.limit===undefined?undefined:Number(options.limit)});
188
+ if(options.dry){if(plan.backend?.provider==='comfyui')print({dry:true,remoteCalls:0,planHash:plan.planHash,requests:items.map(item=>({itemId:item.itemId,variantId:item.variantId,requests:Array.from({length:(item.execution??plan.execution).perValue},(_,index)=>buildComfyRequest(plan,item,{index}))}))});else executePlan(plan,items,{outputRoot:settings.paths.output,dry:true});}
189
+ else {const task=await startTask(plan,items,settings,{operationId:options.operation,retryRun:options['retry-run']??null});if(options.background)print(task);else {console.log('task → '+task.taskId);const result=await waitTask(runtimeRoot(settings),task.taskId);print(taskView(result));if(result.status!=='succeeded')process.exitCode=1;}}
190
+ }
191
+ }else throw new Error('未知模块操作');
192
+ }else if(module==='task'){
193
+ const root=runtimeRoot(settings),taskId=pos[2];
194
+ if(action==='list')print(tasks(root).filter(t=>!options.project||(t.plan?.project??t.project)===options.project).map(t=>taskView(taskStatus(root,t.taskId))));
195
+ else if(action==='recover')print(recoverTask(root,required('project'),required('operation')));
196
+ else if(action==='status')print(taskView(taskStatus(root,taskId)));
197
+ else if(action==='resume')print(await resumeTask(root,taskId));
198
+ else if(action==='cancel')print(taskView(await cancelTask(root,taskId)));
199
+ else if(action==='wait'){const timeoutSeconds=options.timeout===undefined?3600:Number(options.timeout);if(!Number.isFinite(timeoutSeconds)||timeoutSeconds<=0)throw new Error('timeout 必须为正秒数');const result=await waitTask(root,taskId,{timeoutSeconds});print(taskView(result));if(result.status!=='succeeded')process.exitCode=1;}
200
+ else throw new Error('未知 task 操作');
201
+ }else if(module==='shutdown'){if(action)throw new Error('shutdown 不接受位置参数');print(await shutdown(settings));}
202
+ else if(module==='candidate'){
203
+ const projectId=required('project');
204
+ if(action==='favorites')print(favoriteList(settings,projectId));
205
+ else if(action==='favorite'){
206
+ if(!['true','false'].includes(options.value))throw new Error('value 必须为 true 或 false');
207
+ print(await setFavorite(settings,projectId,required('job'),{runId:required('run'),candidateId:required('candidate'),value:options.value==='true'}));
208
+ }
209
+ else if(action==='list')print(candidates(settings,projectId,required('job'),required('run')));
210
+ else if(action==='finalize')print(await finalize(settings,projectId,required('job'),Number(required('revision')),{runId:required('run'),candidateId:required('candidate'),replace:options.replace,actor:required('actor'),name:options.name}));
211
+ else if(action==='delete')print(await deleteCandidate(settings,projectId,required('job'),Number(required('revision')),{runId:required('run'),candidateId:required('candidate'),confirm:options.confirm,actor:required('actor')}));
212
+ else if(action==='finalizations')print(finalizations(settings,projectId,required('job')));
213
+ else throw new Error('未知 candidate 操作');
214
+ }else if(module==='check'){print(checkRun(readJson(manifestPath(action??required('file'))),manifestPath(action??required('file'))));
215
+ }else if(module==='compare'){const read=value=>{const data=readJson(path(value));const plan=data.plan??data;validatePlan(plan);return plan;};const a=read(action),b=read(pos[2]);print({sameCore:a.sources.coreHash===b.sources.coreHash,execution:{before:a.execution,after:b.execution},items:b.items.map(x=>({itemId:x.itemId,variantId:x.variantId,changed:a.items.find(y=>y.itemId===x.itemId&&y.variantId===x.variantId)?.inputHash!==x.inputHash}))});}
216
+ else if(!module||module==='help') console.log(help);
217
+ else throw new Error('未知模块或旧入口:'+module);
218
+ }catch(e){print({ok:false,error:e.message,...(e.diagnostic?{diagnostic:e.diagnostic}:{})});process.exitCode=1;}
219
+ }
@@ -0,0 +1,49 @@
1
+ # 图片与视频通道
2
+
3
+ `art-workshop` 是同一工具包,`image` 和 `video` 是独立二级通道。宿主可以把它们展示成相邻的“图片工坊”“视频工坊”,两者无需共用一个页面或一套任务状态。
4
+
5
+ ## 调用与兼容
6
+
7
+ 图片命令使用 `art-workshop image ...` 或 `v-cli art image ...`。原有 `art-workshop style ...`、`art-workshop generate ...` 及 `art.*` 结构化能力继续兼容;`art.image-*` 提供明确的图片通道能力。图片对象、计划和运行仍走原来的图片执行链路。
8
+
9
+ 视频命令使用 `art-workshop video ...` 或 `v-cli art video ...`,对应结构化能力为 `art.video-*`。`--workspace` 指向工程绝对根目录。请求 JSON 通过工程内 `--input` 文件传入,不把整份剧本、图片或凭据拼入命令行。具体路径与参数以 [命令参考](commands.md) 为准。
10
+
11
+ 视频通道处理任务、操作、剧本规划、素材、模型设置、运行时观察、成片和精修。读取、校验、规划与保存配置不会启动模型生成;只有显式运行操作才提交生成。运行继续使用原 `requestId`、`runId` 和 `upstreamId`,恢复只查询原队列或原结果。
12
+
13
+ ## SDK 与宿主边界
14
+
15
+ ```js
16
+ import { createVideoChannel } from '@kevlns/art-workshop/video';
17
+
18
+ const channel = createVideoChannel({ root: projectRoot, workspaceId });
19
+ try {
20
+ const tasks = await channel.execute('task.list', {});
21
+ } finally {
22
+ await channel.dispose();
23
+ }
24
+ ```
25
+
26
+ SDK 的 `execute / snapshot / media / settingsRevision / dispose` 由同一包内的 VideoService、VideoModels、VideoWorkflow、VideoMedia 和本地运行时实现。宿主注入图片素材来源及覆盖范围;未注入来源时明确报告不可用,不扫描其他宿主的会话或资料。
27
+
28
+ DSH 负责自己的权限、项目与会话身份、原生附件准入及外层事务。工具包不反向依赖 DSH,不创建应用服务器、聊天会话或审批系统。DSH 的视频入口调用本 SDK,不维护第二份 VideoService 算法。
29
+
30
+ ## 配置、状态与失败
31
+
32
+ | 内容 | 归属 |
33
+ | --- | --- |
34
+ | 图片全局默认配置 | `<VANT_HOME 或 ~/.vant>/tools/art-workshop/config.json` |
35
+ | 图片项目对象与批次 | 显式绑定的图片 workspace;DSH 通常绑定工程 `.vant/art` |
36
+ | 视频模型、工作流与 FFmpeg 配置 | 工程 `.vant/config/video.json` |
37
+ | 视频任务、操作、素材与成片 | 工程 `.vant/video`,真源为 `project.json` |
38
+ | 视频外层请求、意图与回执 | 工程 `.vant/state/video` |
39
+ | 跨进程视频资源锁 | 工程 `.vant/state/locks`,沿用规范路径的 SHA-256 SQLite 身份 |
40
+
41
+ 图片和视频保持各自配置、版本和运行记录。视频设置按旧 revision 校验后保存,目录跳转、路径逃逸和损坏状态明确拒绝,不覆盖为默认值。请求及结果未知时保留原身份与未决索引,不能通过更换操作 ID 或入口再次提交。
42
+
43
+ 视频需要 Node.js 22.13 及以上和可用 SQLite;不足时返回 `video-runtime-unsupported`,不改变图片通道的 Node.js 20.9 兼容范围。DSH 找不到带视频通道的工具包时返回 `video-core-unavailable`,不会回退到另一份内核。
44
+
45
+ 视频队列取消仅删除原排队任务。共享运行中的 ComfyUI 没有安全的通用单任务中断接口时,返回 `video-running-cancel-unavailable`,不调用全局 interrupt。模型请求丢回执、下载损坏或结果写入失败均不能作为重新付费生成的依据。
46
+
47
+ ## 验证边界
48
+
49
+ 协议 fixture、真实 FFmpeg 媒体处理、包安装和 DSH 界面分别验证。fake HTTP 返回的生成结果只证明调用、恢复与产物处理机制,不代表真实 GPU 或远程模型完成生成。未发布的源码与本地开发链接不代表 npm 已更新。