@kevlns/art-workshop 0.5.2 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/README.md +13 -11
  2. package/art-workshop.mjs +50 -10
  3. package/docs/channels.md +49 -0
  4. package/docs/commands.md +2158 -91
  5. package/docs/configuration.md +8 -0
  6. package/docs/core-guidance.md +12 -4
  7. package/docs/data-formats.md +10 -6
  8. package/docs/local-models/qwen-image-2.1.json +1 -1
  9. package/docs/modes.md +12 -6
  10. package/docs/release-0.6.0.md +9 -0
  11. package/lib/analysis-worker.mjs +9 -5
  12. package/lib/backends.mjs +2 -0
  13. package/lib/candidates.mjs +2 -1
  14. package/lib/channel-operation.mjs +84 -0
  15. package/lib/core.mjs +33 -2
  16. package/lib/edit.mjs +5 -3
  17. package/lib/generate.mjs +5 -3
  18. package/lib/generation-policy.mjs +1 -1
  19. package/lib/object-format.mjs +2 -2
  20. package/lib/prompt-structure.mjs +3 -3
  21. package/lib/service.mjs +21 -0
  22. package/lib/style-bundle.mjs +19 -6
  23. package/lib/style-contract.mjs +3 -3
  24. package/lib/style-lifecycle.mjs +7 -73
  25. package/lib/style-report.mjs +1 -1
  26. package/lib/style-samples.mjs +94 -0
  27. package/lib/task-contract.mjs +2 -1
  28. package/lib/templates.mjs +1 -1
  29. package/lib/video/PROVENANCE.json +63 -0
  30. package/lib/video/atomic.mjs +32 -0
  31. package/lib/video/channel.mjs +70 -0
  32. package/lib/video/contract-local-media.mjs +42 -0
  33. package/lib/video/contract-story.mjs +213 -0
  34. package/lib/video/contract-video.mjs +117 -0
  35. package/lib/video/contracts.mjs +3 -0
  36. package/lib/video/h3.mjs +232 -0
  37. package/lib/video/local-runtime.mjs +20 -0
  38. package/lib/video/media.mjs +223 -0
  39. package/lib/video/models.mjs +336 -0
  40. package/lib/video/path.mjs +18 -0
  41. package/lib/video/process.mjs +15 -0
  42. package/lib/video/resource.mjs +15 -0
  43. package/lib/video/service.mjs +731 -0
  44. package/lib/video/workflow.mjs +571 -0
  45. package/lib/video.mjs +12 -0
  46. package/lib/workspace.mjs +35 -21
  47. package/package.json +8 -3
  48. package/rules/core-guidance.json +1 -1
  49. package/skills/art-workshop/SKILL.md +4 -2
  50. package/skills/art-workshop/references/project.md +18 -9
  51. package/skills/art-workshop/references/style-discussion.md +8 -6
  52. package/skills/art-workshop/references/video.md +13 -0
  53. package/v-cli.plugin.json +4380 -276
package/lib/workspace.mjs CHANGED
@@ -15,6 +15,7 @@ import {taskStatus} from './tasks.mjs';
15
15
 
16
16
  import {STYLE_CATEGORIES,STYLE_SCHEMA_VERSION} from './style-contract.mjs';
17
17
  import {styleReviewState,resolvedRecommendation,validateStyleConfig,styleEvidenceHash} from './style-review.mjs';
18
+ import {loadCore,syncStyleCore} from './core.mjs';
18
19
  export {STYLE_CATEGORIES} from './style-contract.mjs';
19
20
  export const TASK_PURPOSES=['subject','composition','pose','identity-color','surface','scene-light','text'];
20
21
  const now=()=>new Date().toISOString();
@@ -60,7 +61,11 @@ export function assertObjectCurrent(root,record,{allowMigration=false}={}){asser
60
61
  export function styleView(root,record){
61
62
  const format=objectFormat(root,record);
62
63
  const pendingReferences=(record.references??[]).filter(ref=>!STYLE_CATEGORIES.includes(ref.category)).map(ref=>ref.id);
63
- return {...record,format,analysisReadiness:styleAnalysisReadiness(record),review:styleReviewState(record),compatibility:{usable:format.status==='current',pendingReferences,reasons:format.reasons}};
64
+ const config=structuredClone(record.config);
65
+ delete config.analysis; // Historical model selection is not an editable style field.
66
+ if(format.status==='current'&&!Array.isArray(config.rules)&&record.status==='frozen')config.rules=structuredClone(loadCore(record.project,record.id,root).config.rules);
67
+ const rulesHash=hash(config.rules??[]);
68
+ return {...record,config,rulesHash,samples:(record.samples??[]).map(sample=>({...sample,stale:sample.rulesHash!==rulesHash})),editable:format.canEdit,format,review:styleReviewState(record),compatibility:{usable:format.status==='current',pendingReferences,reasons:format.reasons}};
64
69
  }
65
70
  function objectRuns(settings,record){return tasks(runtimeRoot(settings)).filter(t=>(t.plan?.project??t.project)===record.project&&(record.schema==='art-workshop/task'?(t.plan?.job===record.id||t.objectId===record.id&&t.objectKind==='task'):t.styleId===record.id&&t.project===record.project)).map(t=>taskStatus(runtimeRoot(settings),t.taskId));}
66
71
  export async function mutateObject(settings,projectId,kind,objectId,revision,change,{allowFrozen=false}={}){
@@ -70,12 +75,18 @@ export async function mutateObject(settings,projectId,kind,objectId,revision,cha
70
75
  if(['discarded','cleanup-required'].includes(before.status)&&!allowFrozen)throw new Error('对象已放弃或需要清理,不能继续编辑');
71
76
  if(!allowFrozen)assertObjectCurrent(settings.paths.workspace,before,{allowMigration:true});
72
77
  if(before.revision!==revision)throw new Error('对象版本冲突,请重新读取');
73
- assertIdle(objectRuns(settings,before),kind==='style'?'风格':'任务');
74
- if(kind==='style'&&before.status==='frozen'&&!allowFrozen)throw new Error('冻结风格只读,请派生新风格');
75
- const after=await change(structuredClone(before));
78
+ if(kind==='task')assertIdle(objectRuns(settings,before),'任务');
79
+ const editable=structuredClone(before);
80
+ if(kind==='style'&&before.status==='frozen'&&!Array.isArray(editable.config.rules)&&objectFormat(settings.paths.workspace,before).status==='current'){
81
+ editable.config.rules=structuredClone(loadCore(projectId,objectId,settings.paths.workspace).config.rules);
82
+ if(editable.report?.sourceHash===hash({config:before.config,references:before.references}))editable.report.sourceHash=hash({config:editable.config,references:editable.references});
83
+ }
84
+ const after=await change(editable);
76
85
  if(after.id!==before.id||after.project!==before.project||after.schema!==before.schema||after.schemaVersion!==2)throw new Error('禁止修改对象身份');
77
86
  if(hash(after)===hash(before))return before;
78
- after.revision=before.revision+1;after.updatedAt=now();writeJson(file,after);return after;
87
+ after.revision=before.revision+1;after.updatedAt=now();
88
+ const rollback=kind==='style'?syncStyleCore(settings.paths.workspace,after):()=>{};
89
+ try{writeJson(file,after);}catch(error){rollback();throw error;}return after;
79
90
  });
80
91
  }
81
92
  export async function createObject(settings,projectId,kind,{name,config={},source=null}={}){
@@ -87,8 +98,9 @@ export async function createObject(settings,projectId,kind,{name,config={},sourc
87
98
  if(kind==='task'){validateTaskDraft(config);if(!['generate','edit'].includes(config.kind))throw new Error('任务必须声明生成或编辑类型');record.config.project=projectId;}
88
99
  if(kind==='task')assertSupportedObject(objectFormat(settings.paths.workspace,{...record,source:null}));
89
100
  const directory=objectDirectory(settings.paths.workspace,projectId,kind,objectId);
90
- try{if(kind==='task')record.config=await importSources(settings,record,record.config);writeJson(objectFile(settings.paths.workspace,projectId,kind,objectId),record);return record;}
91
- catch(error){if(existsSync(directory))rmSync(ownedPath(settings.paths.workspace,directory),{recursive:true,force:true});throw error;}
101
+ let rollback=()=>{};
102
+ try{if(kind==='task')record.config=await importSources(settings,record,record.config);if(kind==='style')rollback=syncStyleCore(settings.paths.workspace,record);writeJson(objectFile(settings.paths.workspace,projectId,kind,objectId),record);return record;}
103
+ catch(error){rollback();if(existsSync(directory))rmSync(ownedPath(settings.paths.workspace,directory),{recursive:true,force:true});throw error;}
92
104
  }
93
105
  export function verifyReferences(root,record){
94
106
  const directory=objectDirectory(root,record.project,record.schema.slice('art-workshop/'.length),record.id);
@@ -156,25 +168,35 @@ export async function deriveObject(settings,projectId,kind,objectId,revision){
156
168
  verifyReferences(settings.paths.workspace,source);
157
169
  if(objectFormat(settings.paths.workspace,source).status==='unreadable')throw new Error('源数据不可读,请先核对完整性');
158
170
  if(objectFormat(settings.paths.workspace,source).status!=='current')return createMigrationDraft(settings,source,kind);
159
- const frozenCore=kind==='style'&&source.status==='frozen'&&source.report?.data?.schemaVersion===STYLE_SCHEMA_VERSION?(await import('./core.mjs')).loadCore(projectId,objectId,settings.paths.workspace):null;
171
+ const frozenCore=kind==='style'&&source.status==='frozen'?loadCore(projectId,objectId,settings.paths.workspace):null;
160
172
  const finalRules=frozenCore?.config.rules??null;
161
- const config=kind==='style'?{description:finalRules?source.report.data.summary:source.config.description??source.report?.data?.summary??'',constraints:finalRules?[]:source.config.constraints??[],...(finalRules?{rules:structuredClone(finalRules)}:source.config.rules?{rules:structuredClone(source.config.rules)}:{}),...(source.config.analysis?{analysis:source.config.analysis}:{})}:source.config;
173
+ const config=kind==='style'?{...structuredClone(source.config),...(finalRules?{rules:structuredClone(finalRules)}:{})}:source.config;
174
+ const samples=kind==='style'?(frozenCore?.approvedSamples??source.samples??[]).map(sample=>{
175
+ const path=ownedPath(objectDirectory(settings.paths.workspace,projectId,'style',objectId),sample.path),bytes=readFileSync(path);
176
+ if(createHash('sha256').update(bytes).digest('hex')!==sample.hash)throw new Error('运行时参考已改变,不能复制风格:'+sample.id);
177
+ return {sample,bytes};
178
+ }):[];
162
179
  const derived=await createObject(settings,projectId,kind,{name:source.name+' · 派生',config,source:{id:source.id,revision:source.revision}});
163
180
  try{
164
181
  const directory=objectDirectory(settings.paths.workspace,projectId,kind,derived.id);
165
182
  for(const ref of source.references){const old=ownedPath(objectDirectory(settings.paths.workspace,projectId,kind,source.id),ref.path),target=ownedPath(directory,ref.path);mkdirSync(dirname(target),{recursive:true});cpSync(old,target,{errorOnExist:true,force:false});derived.references.push({...ref});}
166
- if(finalRules){
183
+ if(kind==='style')derived.samples=samples.map(({sample,bytes})=>{const target=ownedPath(directory,sample.path);mkdirSync(dirname(target),{recursive:true});writeFileSync(target,bytes,{flag:'wx'});return structuredClone(sample);});
184
+ if(finalRules&&source.report?.data?.schemaVersion===STYLE_SCHEMA_VERSION){
167
185
  const data={...structuredClone(source.report.data),id:derived.id,recommendation:{rules:structuredClone(finalRules)},issues:[],decisions:[],provenance:styleProvenance(source.report.data.provenance,{method:'inherited-frozen',source:{id:source.id,revision:source.revision,coreHash:source.coreHash},sourceReportHash:hash(source.report.data)})};
168
186
  derived.report={data,sourceRevision:derived.revision,sourceHash:hash({config:derived.config,references:derived.references}),evidenceHash:styleEvidenceHash(derived),path:null,runId:null};
169
187
  }
170
- writeJson(objectFile(settings.paths.workspace,projectId,kind,derived.id),derived);return derived;
188
+ const rollback=kind==='style'?syncStyleCore(settings.paths.workspace,derived):()=>{};
189
+ try{writeJson(objectFile(settings.paths.workspace,projectId,kind,derived.id),derived);}catch(error){rollback();throw error;}return derived;
171
190
  }catch(error){derived.status='cleanup-required';derived.error=error.message;writeJson(objectFile(settings.paths.workspace,projectId,kind,derived.id),derived);throw error;}
172
191
  });
173
192
  }
174
193
  export async function discardObject(settings,projectId,kind,objectId,revision){
175
194
  const directory=objectDirectory(settings.paths.workspace,projectId,kind,objectId);
176
195
  return mutateObject(settings,projectId,kind,objectId,revision,record=>{
177
- if(record.status==='frozen')throw new Error('正式风格不能作为草稿放弃');
196
+ if(kind==='style'){
197
+ if(record.status==='discarded')return record;
198
+ record.status='discarded';record.deletedAt=now();return record;
199
+ }
178
200
  // Task archival removes its active identity, preserving immutable history
179
201
  // and files that other task plans or private edit sources may reference.
180
202
  if(kind==='task'){
@@ -182,14 +204,6 @@ export async function discardObject(settings,projectId,kind,objectId,revision){
182
204
  record.status='discarded';record.deletedAt=now();
183
205
  return record;
184
206
  }
185
- if(record.status==='discarded'&&record.cleanup?.status==='completed')return record;
186
- record.status='discarded';record.references=[];record.cleanup={status:'pending'};
187
- // Mark and advance the revision before cleanup. Failed or interrupted deletion
188
- // stays explicit and can be retried without reviving the draft.
189
- writeJson(objectFile(settings.paths.workspace,projectId,kind,objectId),{...record,revision:record.revision+1,updatedAt:now()});
190
- try{for(const folder of ['refs','sources']){const path=ownedPath(directory,folder);rmSync(path,{recursive:true,force:true});}record.cleanup={status:'completed'};}
191
- catch(error){record.status='cleanup-required';record.cleanup={status:'failed',error:error.message};}
192
- return record;
193
207
  },{allowFrozen:true});
194
208
  }
195
209
  export async function restoreTask(settings,projectId,objectId,revision){
@@ -216,7 +230,7 @@ export function assertPlanCurrent(plan,settings){
216
230
  const project=readJson(ownedPath(settings.paths.workspace,'projects',plan.project,'project.json'));
217
231
  if(hash(project)!==hash(plan.snapshots.project))throw new Error('工程默认配置已变化,请重新编译');
218
232
  if(plan.snapshots.profile){const profile=current.config.asset??readJson(ownedPath(settings.paths.workspace,'projects',plan.project,'profiles',current.config.profile+'.json'));if(hash(profile)!==hash(plan.snapshots.profile))throw new Error('资产规格已变化,请重新编译');}
219
- if(plan.sources.core){const core=readJson(ownedPath(settings.paths.workspace,'projects',plan.project,'styles',plan.sources.core,'core.json'));if(core.schemaVersion!==STYLE_SCHEMA_VERSION)throw new Error('旧风格核心需派生并重新分析采用,不能执行旧计划');if(core.coreHash!==plan.sources.coreHash||hash(core)!==hash(plan.snapshots.core))throw new Error('核心已变化,请重新编译');}
233
+ if(plan.sources.core){const core=loadCore(plan.project,plan.sources.core,settings.paths.workspace);if(core.coreHash!==plan.sources.coreHash||hash(core)!==hash(plan.snapshots.core))throw new Error('核心已变化,请重新编译');}
220
234
  for(const ref of plan.refs){if(!existsSync(ref.path)||createHash('sha256').update(readFileSync(ref.path)).digest('hex')!==ref.hash)throw new Error('底图已变化,请重新编译');}
221
235
  }
222
236
  export function taskDisplayState(record,runs,finalizations=[]){
package/package.json CHANGED
@@ -1,9 +1,13 @@
1
1
  {
2
2
  "name": "@kevlns/art-workshop",
3
- "version": "0.5.2",
3
+ "version": "0.6.1",
4
4
  "private": false,
5
- "description": "管理项目风格、参考图、图片生成、编辑和定版。支持本地 ComfyUI 与远程图片模型。",
5
+ "description": "统一管理图片工坊与视频工坊:项目风格、图片生成编辑、剧本镜头、视频生成与成片精修。",
6
6
  "type": "module",
7
+ "exports": {
8
+ "./video": "./lib/video.mjs",
9
+ "./*": "./*"
10
+ },
7
11
  "bin": {
8
12
  "art-workshop": "art-workshop.mjs"
9
13
  },
@@ -51,6 +55,7 @@
51
55
  "dependencies": {
52
56
  "bailian-cli": "2.2.1",
53
57
  "bailian-cli-core": "2.2.1",
54
- "sharp": "^0.35.5"
58
+ "sharp": "^0.35.5",
59
+ "zod": "4.6.7"
55
60
  }
56
61
  }
@@ -10,7 +10,7 @@
10
10
  "区分观察、建议和未确定项,不从参考图片中的内容生成全局主题或题材白名单。",
11
11
  "规则精炼且一致,模型、凭据、参数和运行状态不进入风格核心。",
12
12
  "风格负向只排除可跨主体复用的抽象绘制语言,不冻结具体内容黑名单;明确 negative 表达不加否定前缀,条件与例外写入 when,条件规则不展开为全局禁止。",
13
- "冻结可追溯,核心不可原地覆写;旧职责版本必须重新分析和明确采用。"
13
+ "风格规则可随时增删改查,保存即更新当前版本;历史任务保留原规则与样张快照,待执行预案在风格变化后重新编译。认可样张须对应当前规则,原始分主题参考只用于分析。"
14
14
  ],
15
15
  "ownership": {
16
16
  "core": "媒介、描绘细节、明暗方式、描边、高光画法、笔触、明度对比与色彩关系",
@@ -1,10 +1,12 @@
1
1
  ---
2
2
  name: art-workshop
3
- description: "处理美术讨论、风格与任务表达、会话生图和图片编辑;根据意图与引用选择会话或项目管线。"
3
+ description: "处理图片与视频美术制作:图片讨论、风格、生成与编辑,视频剧本、镜头生成、成片与精修;按意图选择独立通道。"
4
4
  ---
5
5
 
6
6
  # 美术工坊
7
7
 
8
+ 工具包提供 `image` 和 `video` 两个独立二级通道。图片沿用下述会话与项目管线;视频剧本、镜头、成片和精修先读取 [视频通道](references/video.md)。不要把视频任务改造成图片生成请求,也不要用图片配置替代视频模型和工作流设置。
9
+
8
10
  判断本轮是讨论、生成还是编辑,再确定归属会话或项目任务。信息充分时直接使用对应结构化工具,不把普通讨论升级为生成。当前消息明确指定的对象和图片优先于历史推断。
9
11
 
10
12
  以用户意图为主线,让表达更清楚、专业、便于执行,允许贴合原意的适度补充。留意补充是否改变了用户的方向、程度或选择空间,尤其不要将倾向升级成硬性禁令。看图分析可以提炼可见特征;影响不大的合理细化直接处理,实质性的新设计取舍再提出建议或询问。
@@ -12,6 +14,6 @@ description: "处理美术讨论、风格与任务表达、会话生图和图片
12
14
  - 整理或回填美术表述前读取 [表达规范](references/expression.md),本会话已掌握时直接沿用。需要 Getty 核实时,先从中文意图提炼英文专业词,在一个批次中通过 art_getty 查询,再按原始上下文校验候选;失败或无匹配保留原表达,不阻塞其他内容,不重试或另找调用路径。
13
15
  - 参考图风格讨论、分析并填写风格草稿,读取 [风格讨论与回填](references/style-discussion.md)。
14
16
  - 会话探索、新图及修改上一轮产物,读取 [会话管线](references/conversation.md),使用 art_conversation。
15
- - 已有项目任务、风格冻结和正式资产交付,读取 [项目管线](references/project.md),使用 art_operation。
17
+ - 已有项目任务、可编辑风格规则、打样与样张定版和正式资产交付,读取 [项目管线](references/project.md),使用 art_operation。
16
18
 
17
19
  同一请求只提交一次;重复调用复用请求身份。未知状态仅查询原运行,禁止更换身份重投。状态查询按工具返回的 wait/状态约束进行;到达等待上限就结束本轮并保留可恢复身份,不用修改需求或新建任务绕过失败。只有用户明确修改目标或请求新一轮生成时才创建新请求。
@@ -23,17 +23,24 @@ art-workshop agent index
23
23
  任务参考只提取 purposes 指定且未被 ignore 排除的特征。用途范围外、用户已明确覆盖的背景和绘制差异不构成阻塞;conflicts 仅列范围内不可调和要求,uncertainties 仅列影响执行的关键缺失,两者为非空字符串数组,无问题用 []。不得删除用户参考或清空报告来绕过分析;应明确参考范围后重新分析,真正的未决取舍再交用户决定。
24
24
 
25
25
  工程对象使用 schemaVersion 2;读写前核实工程配置和当前 revision。
26
- 风格和任务都有稳定 id 与 revision。UI、聊天和 CLI 共用对象;写入、派生与清理提交预期 revision,冲突重新读取。正式风格只读,改动创建派生风格;派生不继承核心、批次、授权与对话。冻结风格派生保留结构化规则和独立参考,报告标明引用的冻结证据。
26
+ 风格和任务都有稳定 id 与 revision。UI、聊天和 CLI 共用对象;写入、派生与清理提交预期 revision,冲突重新读取。风格规则可随时增删修改并保存,包括已有正式风格;有效 rules 保存即同步可执行核心,不需要派生、分析或采用。历史核心快照和运行证据保留,修改后重新编译预案。派生仅用于独立方向,不继承批次、授权与对话。
27
27
  风格静态参考只有 style、palette、rendering,只分析媒介、描绘、明暗、描边、笔触和色彩关系。具体造型、比例、结构、部件、身份色、材质与光源属于任务。任务动态参考只有 subject、composition、pose、identity-color、surface、scene-light、text;编辑底图另列。导入复制原图,不修改用户文件。未适配直接参考时拒绝,不隐式上传风格图片。
28
28
 
29
29
  ### 风格生命周期
30
30
 
31
31
  草稿可含 rules,每条为 id/scope/strength/instruction/when,avoid 可另填 negative 字符串数组。按媒介、描边、明暗、高光、笔触、刻画、配色整理,主题不必填满。required 必须遵守、default 默认倾向、avoid 必须避免;“默认少用”使用 default,不升级为禁止。条件保留在 when。风格负向只表达跨主体复用的抽象绘制语言,不排除具体主体、部件、身份色、物体纹理、材质或资产规格。negative 直接描述被排除的视觉特征,不加否定前缀;instruction 为同一规则的阅读说明,条件和例外写入 when。无条件且明确填写的 negative 编译为独立负向表达,条件规则连同排除表达保留在正向条件段;未填写 negative 的文字约束保留原文,不机械转换。支持负向参数的模型直接传递,不支持时由适配器并入排除段,不丢弃、不截断。
32
- 已有证据的规则编辑可用 style revise --project ID --id STYLE --revision N --input FILE,输入 {rules,summary,note};这是用户修订方案,沿用未改变的参考,记录原报告和用户依据,不调用模型、不自动采用。参考或分析配置变化时需分析,未决问题按报告处理。用户明确授权后 adopt 冻结新身份,保留源核心与任务快照。
33
32
 
34
- style create/read/update/derive/discard 管理草稿。style analyze --dry 只读编译,不联网、启动服务或创建参考目录。实际 analyze 创建 taskId 与独立参考证据;task status/wait/cancel 控制执行,recover 查原登记,resume 仅按已记录的上游身份恢复查询与取回,不重新提交。
35
- 报告绑定源配置、参考与模型。更新配置保留报告并标记需复核,源证据保持不变。报告 recommendation.rules 是精炼独立成稿,规则明确主题、强度和适用条件。issues 仅列需用户取舍的矛盾,notes 保留不阻塞采用的证据局限。style resolve --input {issueId,optionId,note} 记录明确选择并修订有效方案,不重新分析;以 style read 的 review.ready 判断采用条件。复核沿用证据与决定,新证据才重新打开问题。style adopt 校验来源匹配和所有问题已决定,用户采用后冻结。采用中断通过 style recover 完成已授权事务,不能重新冻结另一份核心。
36
- 退出风格配置先继续编辑、保存草稿或放弃;分析停止未确认时不能清理。
33
+ 退出风格配置先按宿主提供的保存或草稿机制处理未保存内容。分析与生成仍遵循原执行身份和停止确认;不能因切换页面或保存规则重投任务。
34
+
35
+ ### 打样与样张定版
36
+
37
+ 保存规则后使用 style sample-job --project P --id STYLE --revision N 创建普通生成任务,可选 --count 1~4 指定每个默认主体的候选数量(共三个主体,写入 config.execution.perValue),任务固定 styleReferenceMode=text-only,source 记录规则和核心哈希。创建任务不启动生成;配置模型并按普通任务预案运行,用户不满意时直接修改规则重新打样,不从不合格结果中强行选图。
38
+
39
+ 用户认可成功候选后使用 style sample-select --project P --id STYLE --revision N --job JOB --run RUN --candidate HASH,可选 --note 记录用途;图片独立复制到风格 samples 目录,保留规则哈希、来源与模型。style sample-remove --project P --id STYLE --revision N --sample SAMPLE 移除当前采用关系,历史文件保留。样张定版不调用 candidate finalize,不导出到 VantArtForge。
40
+
41
+ 后续任务 config.styleReferenceMode 为 approved(默认)或 text-only。approved 只使用匹配当前规则哈希的运行时参考,从未采用样张时按规则生成且预案明确 no-samples;已有样张全部过期则拒绝使用,混合新旧样张只采用当前匹配项并列出 staleCount。text-only 明确仅使用规则。后端不支持图片参考时明确报错,不能静默丢图。原始分主题图仅分析其指定用途,不自动全部上传;普通图片参考的用途提示不保证完全隔离主体或构图,需真实结果验证。
42
+
43
+ 候选图片使用“样张定版 / 取消样张定版”开关,对应兼容 API style sample-select / sample-remove;这只维护当前风格的运行时参考,不执行资产定版或导出。定版图片在“风格配置 → 运行时参考”显示,按图片内容哈希去重,重复图片不会新增一份。任务的 approved/text-only 决定是否使用运行时参考,不为每张参考另设启用开关。
37
44
 
38
45
  ### 计划与执行
39
46
 
@@ -44,7 +51,7 @@ style create/read/update/derive/discard 管理草稿。style analyze --dry 只
44
51
  先读取实际 job,再 generate/edit plan 和 run --plan --dry,展示有效核心、设计尺寸、预留缩放、请求与实际像素、模型后端、候选数量和编辑底图。后端尺寸由工具统一解析,超限或未对齐选最近合法尺寸,保留设计基准并明确实际值;不承诺显存或自动缩放导出。
45
52
  授权覆盖方案后使用 run --background;前台同样创建执行身份。配置、核心、规格、参考、底图和后端变化拒绝失效方案,重新编译。重启查 taskId,不重复提交。不自动换模型或重跑成功项。
46
53
  每个任务只能有一个未停止确认的执行;编辑、派生、归档、恢复与运行共用状态检查。切页面不取消。
47
- job discard 归档已停止的任务,草稿、待定版和已定版均可归档。按 revision 将任务标记为 discarded(归档存储状态),保留配置、参考、私有底图、运行、输出、收藏和定版历史;活跃列表、收藏及作品暂不显示。job restore 按同一身份和当前 revision 恢复到活跃列表,收藏与作品重新显示,不重新生成。归档与恢复均检查停止确认和版本,重复操作幂等;恢复后重新编译预案。风格 discard 仍为草稿放弃,不参与任务归档。
54
+ job discard 归档已停止的任务,草稿、待定版和已定版均可归档。按 revision 将任务标记为 discarded(归档存储状态),保留配置、参考、私有底图、运行、输出、收藏和定版历史;活跃列表、收藏及作品暂不显示。job restore 按同一身份和当前 revision 恢复到活跃列表,收藏与作品重新显示,不重新生成。归档与恢复均检查停止确认和版本,重复操作幂等;恢复后重新编译预案。风格 discard 将当前风格归档,保留已有核心和样张快照供历史运行核对,不删除历史依赖。
48
55
 
49
56
  ### 取消、异常和关闭
50
57
 
@@ -81,7 +88,7 @@ candidate delete 先确认影响,拒绝运行中或被计划/底图引用的
81
88
 
82
89
  任务 mustRead 是必须看清的视觉特征,保持字符串数组;画面文字使用独立 textSpecs 数组,每项 content(准确文字)、hierarchy(层级)、zone(位置或载体)必填,fontHint(字形)可选。所有描述完整保存,不设字数上限;草稿允许未填完,预案要求完整。生成任务仅在资产规格允许文字时接受非空 textSpecs,编辑任务按底图及 changes/preserve 执行;不把视觉特征转成文字,不自动开启文字权限。entity.material 是可选物理材质描述。composition.lightDirection/lightQuality 由资产规格成对声明词表及默认值,任务和 variant 可以单项覆盖,未开放能力时携带字段会报错。
83
90
 
84
- job read 返回的 resolvedAsset 是只读有效资产规格,assetError 表示解析失败;更新只提交原 config,不回填投影或默认值。任务对象 schemaVersion=2、风格核心 schemaVersion=3 与计划 compilerVersion=4 相互独立。预案在编译时记录编译版本;读取与执行保持预案及其绑定对象不变。
91
+ job read 返回的 resolvedAsset 是只读有效资产规格,assetError 表示解析失败;更新只提交原 config,不回填投影或默认值。任务对象 schemaVersion=2、风格核心 schemaVersion=3 与计划 compilerVersion=5 相互独立。预案在编译时记录编译版本;读取与执行保持预案及其绑定对象不变。
85
92
 
86
93
  任务参考可通过 reference import --item-id <对象标识> 绑定单个出图对象;未绑定的参考为任务共用。生成与编辑只采纳共用参考和当前对象参考的观察。reference update 的 itemId 可改绑对象,null 表示任务共用。
87
94
 
@@ -91,9 +98,9 @@ job read 返回的 resolvedAsset 是只读有效资产规格,assetError 表示
91
98
 
92
99
  使用 environment guide 获取部署指南与契约,environment inspect 读取机器环境。Pi 通过基础工具和动态工作流完成安装、下载、修正与采样;environment verify 独立校验文件、服务和节点,environment register 验收后登记。任务授权、进程、互斥与恢复交由 Harness。不得把模型回复或服务连通当作真实出图。unregister 仅解除登记,不删除模型或停止外部服务。按 --guide 选择随包方案,模型事实和启动参数只由 art 维护。
93
100
 
94
- ### 共享冻结风格
101
+ ### 共享风格快照
95
102
 
96
- 用户要求共享时使用 style export --project ID --id STYLE --out FILE.style.json,收集冻结核心和必要参考,不复制运行记录或设置。style sources --input DIRS.json 只读列出多个来源,单个来源不可用时报告并继续,重复身份内容冲突按来源明确选择。style import --project TARGET --file FILE.style.json 导入固定快照,保留来源身份、版本及核心哈希;不重新分析、采用或随来源更新。导入的冻结对象只读,改动使用 style derive。输出文件不覆盖已有版本。
103
+ 用户要求共享时使用 style export --project ID --id STYLE --out FILE.style.json,收集当前核心、必要参考和运行时参考,不复制运行记录或设置。style sources --input DIRS.json 只读列出多个来源,单个来源不可用时报告并继续,重复身份内容冲突按来源明确选择。style import --project TARGET --file FILE.style.json 导入固定版本,保留来源身份、版本及核心哈希;不随来源自动更新。导入后可直接编辑保存为本地版本,来源记录与历史快照保留。输出文件不覆盖已有版本。
97
104
 
98
105
 
99
106
  ## 结果验证
@@ -107,3 +114,5 @@ job read 返回的 resolvedAsset 是只读有效资产规格,assetError 表示
107
114
  ## 许可与版权
108
115
 
109
116
  MIT。Copyright © 2026 Vant。
117
+
118
+ 风格直接使用 style read/update 保存完整 config.rules,再 style sample-job 创建样张任务,通过 generate plan 编译契约与提示词后生成。没有独立风格分析、报告回填或采用步骤。可自由调整规则、条件、倾向、参考关注点和样张任务的主体与参数;描述与约束是讨论上下文,实际绘制契约以 config.rules 为准。空规则可保存草稿,打样需要有效规则。历史报告保留只读证据;style recover 仅用于完成原有中断事务,不能新建采用流程。
@@ -8,20 +8,22 @@
8
8
 
9
9
  读取真实图片像素,再分析可复用的媒介观感、线条、笔触、明暗处理、刻画密度及色彩关系。某张图里的具体人物、比例、部件、身份色、材质、场景和光源记录在相关观察上下文,不写成跨主体风格要求。没有证据的分类可以不填,不补齐一套看似完整的规则。
10
10
 
11
- 宿主模型能直接看图时,可以根据当前图像观察整理风格草稿;这不等于已经执行了正式风格分析任务。宿主无法看图时使用当前对象配置的视觉分析能力,能力未配置或不可用就说明限制,不凭图片名称猜测。只为普通措辞修改不重复分析。
11
+ 宿主模型能直接看图时,可以根据当前图像观察整理风格草稿;无需启动独立风格分析任务。宿主无法看图时使用会话中实际可用的视觉能力,能力未配置或不可用就说明限制,不凭图片名称猜测。只为普通措辞修改不重复分析。
12
12
 
13
- 用户已授权分析和填写时,把贴合目标的分析与适度专业化描述自动保存到当前草稿,保留未修改配置,使用工具提供的 description、constraints、rules、analysis 等实际字段。图像观察通常适合写成 default 倾向;required/avoid 用于确实需要必须遵守或避免的要求,注意不要仅因参考图如此就升级强度。既有身份、分析模型、参考分类及无关规则保持不变。
13
+ 用户已授权分析和填写时,把贴合目标的分析与适度专业化描述自动保存到当前草稿,保留未修改配置,使用工具提供的 description、constraints、rules 等实际字段。图像观察通常适合写成 default 倾向;required/avoid 用于确实需要必须遵守或避免的要求,注意不要仅因参考图如此就升级强度。既有身份、参考分类及无关规则保持不变。
14
14
 
15
15
  描述可以有细节,重点是保持适用范围和弹性。例如由柔和光晕提炼出柔和高光是合理的,直接变成所有资产禁止硬边高光就可能过度。毛发、雪面等可作观察例子,通用规则尽量提炼其背后的笔触或过渡方式。配色可描述参考图中的颜色及关系,但不要无意中固定以后所有主体的身份色。无需机械删除具体颜色、数量或形容词,按它们是否有依据、是否帮助当前目标来判断,也不要求填满所有绘制主题。
16
16
 
17
- rules 使用当前工具返回的规则数组,不把主题目录包装成新对象。没有正式分析报告的草稿使用对象更新;已有可沿用的正式报告与参考证据时才使用规则修订入口,不先试一个会报错的入口再换另一个。
17
+ rules 使用当前工具返回的规则数组,不把主题目录包装成新对象。按当前 revision 用对象更新保存完整 config.rules,已有正式风格也可直接保存;有无正式报告都不要求先派生或重新分析。实际打样以 config.rules 编译;描述和约束用于讨论上下文,不自动转换为规则。
18
18
 
19
19
  用户后续说“线条稍利落一点,颜色别变”时,只局部调整相关规则的措辞与程度,保留其他规则和配置,不把小幅修改改成全局禁用软边、纹理或其他技法。原意已清楚就直接保存,不以分类未填满为由继续追问。
20
20
 
21
- ## 正式报告与实际保存
21
+ ## 打样与样张定版
22
22
 
23
- 需要运行正式分析任务时,按 [项目管线](project.md) 和当前工具契约执行,沿用原 taskId 查询或恢复,不通过新建分析绕过失败。区分三份内容:图像观察是证据;报告 recommendation.rules 是分析建议;对象 config.rules 才是实际保存的草稿规则。正式风格核心另由采用操作生成。
23
+ 规则保存后可以按用户要求创建仅规则打样任务,使用不同简单主体验证可复用的绘制语言。仅创建任务不自动生成;实际出图按任务配置和授权执行。用户不满意时局部修改并保存规则,重新打样;用户选定后通过样张定版加入当前风格的运行时参考。原始分主题图继续作为分析依据,不全部上传给生成模型。规则变化使原样张过期时说明实际状态,后续任务可重新打样或明确采用仅规则模式,不伪称新规则已验证。
24
24
 
25
- 不能只展示报告建议就声称已回填。用户要求填写配置时,分析完成后还需按真实契约保存可用规则;已有未变参考证据的规则修订用对应 revise 入口,其他情况按工具允许的更新入口处理。真实未决问题保留对应项,不清空问题或更改参考来强行通过,也不自动采用或冻结。
25
+ ## 实际保存
26
+
27
+ 规则保存即同步当前契约,历史报告只保留证据,不需要报告回填或采用。空规则允许保存草稿;打样前将要生效的约束整理为规则。
26
28
 
27
29
  用保存回执中的完整对象核对 revision 及实际 config;回执缺少完整内容时再读取一次。简短展示实际填入内容与必要未决项;用户要看最终配置时直接展示保存后的 JSON,不展示另写的一份理想配置。不逐条解释自己没有做哪些扩写,也不附带与本轮无关的下一步确认。保存失败、分析尚未完成或仅有观察建议时如实说明,不声称已经生效。一次校验后结束,本轮不自发循环分析、改写或出图。
@@ -0,0 +1,13 @@
1
+ # 视频通道
2
+
3
+ 先用 `art-workshop video describe --workspace <工程绝对根目录>` 或 `v-cli agent describe art --json` 取得当前能力与输入契约。视频使用独立的模型、工作流和任务,不复用图片计划或图片全局配置。
4
+
5
+ 请求 JSON 放在工程内文件,通过 `--input` 传入。写操作使用稳定的原操作身份;运行还需要业务契约中的 `requestId`。读取、规划和保存配置不启动生成。只有用户意图明确包含执行时,才运行对应原生工具能力;宿主的权限及审批仍然适用。
6
+
7
+ - 先读任务、操作、设置和 revision,再准备更新或运行。
8
+ - 剧本规划、尾帧采纳、成片合成和精修使用各自明确动作,不用提示词替代前后依赖校验。
9
+ - 结果未知时查询原操作、原 `requestId / runId / upstreamId`;不更换 ID、入口或目标重投。
10
+ - 取消只处理原排队身份。服务不支持安全的单任务停止时保留原运行,不中断其他共享任务。
11
+ - 当前缺模型、FFmpeg、节点或服务时如实说明;保存成功不表示运行环境或生成已验收。
12
+
13
+ 视频模型及工作流配置保存在工程 `.vant/config/video.json`,任务、素材与成片保存在 `.vant/video`。与图片通道分别读取各自的配置和 revision,不迁移或覆盖已有图片对象。