@kevlns/art-workshop 0.5.1 → 0.5.2

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 (57) hide show
  1. package/AGENTS.md +25 -25
  2. package/LICENSE +21 -21
  3. package/README.md +63 -63
  4. package/art-workshop.mjs +174 -174
  5. package/docs/configuration.md +82 -82
  6. package/docs/core-guidance.md +50 -50
  7. package/docs/data-formats.md +85 -85
  8. package/docs/deployment.md +32 -32
  9. package/docs/local-models/qwen-image-2.1.json +73 -73
  10. package/docs/local-models/qwen-image-2.1.md +33 -33
  11. package/docs/model-architecture.md +78 -78
  12. package/docs/modes.md +67 -67
  13. package/lib/agent.mjs +32 -32
  14. package/lib/analysis-worker.mjs +32 -32
  15. package/lib/analyze.mjs +85 -85
  16. package/lib/asset-profile.mjs +23 -23
  17. package/lib/candidates.mjs +103 -103
  18. package/lib/comfy-recovery.mjs +17 -17
  19. package/lib/conversation.mjs +77 -77
  20. package/lib/core.mjs +75 -75
  21. package/lib/deployment-guide.mjs +12 -12
  22. package/lib/design.mjs +29 -29
  23. package/lib/dimensions.mjs +22 -22
  24. package/lib/edit.mjs +41 -41
  25. package/lib/environment-operations.mjs +49 -49
  26. package/lib/environment-runtime.mjs +99 -99
  27. package/lib/environments.mjs +55 -55
  28. package/lib/executor.mjs +107 -107
  29. package/lib/generate.mjs +58 -58
  30. package/lib/heartbeat.mjs +16 -16
  31. package/lib/images.mjs +1 -1
  32. package/lib/lifecycle.mjs +53 -53
  33. package/lib/migration.mjs +154 -154
  34. package/lib/process-identity.mjs +22 -14
  35. package/lib/project.mjs +39 -39
  36. package/lib/refs.mjs +26 -26
  37. package/lib/runtime.mjs +25 -25
  38. package/lib/service.mjs +134 -126
  39. package/lib/settings.mjs +50 -50
  40. package/lib/shared.mjs +67 -67
  41. package/lib/style-bundle.mjs +85 -85
  42. package/lib/style-contract.mjs +74 -74
  43. package/lib/style-lifecycle.mjs +125 -125
  44. package/lib/style-review.mjs +14 -14
  45. package/lib/task-contract.mjs +93 -93
  46. package/lib/tasks.mjs +497 -497
  47. package/lib/templates.mjs +80 -80
  48. package/lib/vision.mjs +56 -56
  49. package/lib/worker-process.mjs +6 -6
  50. package/lib/workspace.mjs +292 -292
  51. package/package.json +1 -1
  52. package/rules/core-guidance.json +22 -22
  53. package/skills/art-workshop/SKILL.md +17 -17
  54. package/skills/art-workshop/references/conversation.md +11 -11
  55. package/skills/art-workshop/references/expression.md +27 -27
  56. package/skills/art-workshop/references/project.md +109 -109
  57. package/v-cli.plugin.json +2747 -2747
package/lib/workspace.mjs CHANGED
@@ -1,292 +1,292 @@
1
- import {inspectObjectFormat,assertSupportedObject} from './object-format.mjs';
2
- import {styleProvenance} from './style-evidence.mjs';
3
- import {validateStyleDraft as styleConfig,validateReferenceNotes,styleAnalysisReadiness} from './style-contract.mjs';
4
- import {validateTaskDraft} from './task-contract.mjs';
5
- import {existsSync,mkdirSync,readdirSync,readFileSync,writeFileSync,lstatSync,rmSync,cpSync} from 'node:fs';
6
- import {resolve,join,dirname,relative,isAbsolute} from 'node:path';
7
- import {randomUUID,createHash} from 'node:crypto';
8
- import {id,hash,readJson,writeJson,integer,keys,text,texts} from './shared.mjs';
9
- import {externalPath} from './settings.mjs';
10
- import {locked,tasks,runtimeRoot} from './runtime.mjs';
11
- import {assertIdle,executionSettled} from './lifecycle.mjs';
12
- import {validateProject} from './project.mjs';
13
- import {validateImage} from './images.mjs';
14
- import {taskStatus} from './tasks.mjs';
15
-
16
- import {STYLE_CATEGORIES,STYLE_SCHEMA_VERSION} from './style-contract.mjs';
17
- import {styleReviewState,resolvedRecommendation,validateStyleConfig,styleEvidenceHash} from './style-review.mjs';
18
- export {STYLE_CATEGORIES} from './style-contract.mjs';
19
- export const TASK_PURPOSES=['subject','composition','pose','identity-color','surface','scene-light','text'];
20
- const now=()=>new Date().toISOString();
21
- /** Resolve every existing ancestor: no user-controlled link may escape the project. */
22
- export function ownedPath(root,...segments){
23
- const base=externalPath(resolve(root)),path=resolve(base,...segments),rel=relative(base,path);
24
- if(isAbsolute(rel)||rel==='..'||rel.startsWith('../')||rel.startsWith('..\\'))throw new Error('项目资源路径越界');
25
- let current=base;
26
- if(existsSync(base)&&lstatSync(base).isSymbolicLink())throw new Error('项目根不能为链接');
27
- for(const segment of rel.split(/[\\/]/).filter(Boolean)){
28
- current=join(current,segment);if(existsSync(current)&&lstatSync(current).isSymbolicLink())throw new Error('受管资源路径不能为链接');
29
- }
30
- return path;
31
- }
32
- export function objectDirectory(root,projectId,kind,objectId){
33
- id(projectId,'project');id(objectId,kind);if(!['style','task'].includes(kind))throw new Error('对象类型非法');
34
- return ownedPath(root,'projects',projectId,kind==='style'?'styles':'tasks',objectId);
35
- }
36
- export function objectFile(root,projectId,kind,objectId){return ownedPath(objectDirectory(root,projectId,kind,objectId),kind+'.json');}
37
- export function readObject(root,projectId,kind,objectId){
38
- if(existsSync(ownedPath(root,'.runtime/upgrades',id(projectId)+'.json')))throw new Error('工程升级事务未完成,请显式 project upgrade 恢复');
39
- if(kind==='style'&&existsSync(ownedPath(objectDirectory(root,projectId,kind,objectId),'adoption.json')))throw new Error('风格采用事务未完成,请 style recover 后再操作');
40
- const record=readJson(objectFile(root,projectId,kind,objectId));
41
- if(record.schema!=='art-workshop/'+kind||record.project!==projectId||record.id!==objectId)throw new Error('对象身份或版本不匹配,请显式升级工程');
42
- integer(record.revision,'revision',1);return record;
43
- }
44
- export function listObjects(root,projectId,kind){
45
- const folder=ownedPath(root,'projects',id(projectId),kind==='style'?'styles':'tasks');
46
- return existsSync(folder)?readdirSync(folder).filter(x=>existsSync(ownedPath(folder,x,kind+'.json'))).map(x=>{try{return readObject(root,projectId,kind,x);}catch(error){return {schema:'art-workshop/'+kind,schemaVersion:2,project:projectId,id:x,name:x,status:'unreadable',revision:1,config:{},references:[],report:null,readError:error.message};}}):[];
47
- }
48
- /** Read projection only: never rewrite old frozen evidence or reinterpret old references. */
49
- export function objectFormat(root,record){
50
- let core,dependency;
51
- if(record.schema==='art-workshop/style'&&record.status==='frozen'){try{core=readJson(ownedPath(objectDirectory(root,record.project,'style',record.id),'core.json'));}catch(error){return {status:'unreadable',reasons:[error.message],canEdit:false,canDerive:false};}}
52
- if(record.schema==='art-workshop/task'&&record.config?.core){try{
53
- const file=objectFile(root,record.project,'style',record.config.core);
54
- if(existsSync(file))dependency=objectFormat(root,readObject(root,record.project,'style',record.config.core));
55
- else {const core=readJson(ownedPath(objectDirectory(root,record.project,'style',record.config.core),'core.json'));dependency=inspectObjectFormat({schema:'art-workshop/style',schemaVersion:2,status:'frozen',config:core.config,report:{data:core.report},references:[]},{core});}
56
- }catch(error){dependency={status:'unreadable',reasons:[error.message]};}}
57
- return inspectObjectFormat(record,{core,dependency});
58
- }
59
- export function assertObjectCurrent(root,record,{allowMigration=false}={}){assertSupportedObject(objectFormat(root,record));if(!allowMigration&&record.migration?.status==='pending')throw new Error('迁移尚未完成,请继续迁移讨论并校验草稿');}
60
- export function styleView(root,record){
61
- const format=objectFormat(root,record);
62
- 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
- }
65
- 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
- export async function mutateObject(settings,projectId,kind,objectId,revision,change,{allowFrozen=false}={}){
67
- const file=objectFile(settings.paths.workspace,projectId,kind,objectId);
68
- return locked(runtimeRoot(settings),'control',async()=>{
69
- const before=readObject(settings.paths.workspace,projectId,kind,objectId);
70
- if(['discarded','cleanup-required'].includes(before.status)&&!allowFrozen)throw new Error('对象已放弃或需要清理,不能继续编辑');
71
- if(!allowFrozen)assertObjectCurrent(settings.paths.workspace,before,{allowMigration:true});
72
- 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));
76
- if(after.id!==before.id||after.project!==before.project||after.schema!==before.schema||after.schemaVersion!==2)throw new Error('禁止修改对象身份');
77
- if(hash(after)===hash(before))return before;
78
- after.revision=before.revision+1;after.updatedAt=now();writeJson(file,after);return after;
79
- });
80
- }
81
- export async function createObject(settings,projectId,kind,{name,config={},source=null}={}){
82
- if(existsSync(ownedPath(settings.paths.workspace,'.runtime/upgrades',id(projectId)+'.json')))throw new Error('工程升级事务未完成,请显式 project upgrade 恢复');
83
- const project=readJson(ownedPath(settings.paths.workspace,'projects',id(projectId),'project.json'));
84
- if(project.schemaVersion!==2)throw new Error('工程需先显式升级');
85
- if(typeof name!=='string'||!name.trim())throw new Error('对象名称不能为空');
86
- const objectId=kind+'-'+randomUUID(),record={schema:'art-workshop/'+kind,schemaVersion:2,project:projectId,id:objectId,name:name.trim(),revision:1,status:'draft',createdAt:now(),updatedAt:now(),source,config:kind==='style'?styleConfig(config):structuredClone(config),references:[],report:null};
87
- if(kind==='task'){validateTaskDraft(config);if(!['generate','edit'].includes(config.kind))throw new Error('任务必须声明生成或编辑类型');record.config.project=projectId;}
88
- if(kind==='task')assertSupportedObject(objectFormat(settings.paths.workspace,{...record,source:null}));
89
- 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;}
92
- }
93
- export function verifyReferences(root,record){
94
- const directory=objectDirectory(root,record.project,record.schema.slice('art-workshop/'.length),record.id);
95
- return record.references.map(ref=>{const path=ownedPath(directory,ref.path);if(!existsSync(path)||createHash('sha256').update(readFileSync(path)).digest('hex')!==ref.hash)throw new Error('参考资源已变化:'+ref.id);return {...ref,path};});
96
- }
97
- function imageExtension(buffer){
98
- if(buffer.length>=24&&buffer.subarray(0,8).equals(Buffer.from([137,80,78,71,13,10,26,10])))return '.png';
99
- if(buffer.length>=12&&buffer.subarray(0,4).toString()==='RIFF'&&buffer.subarray(8,12).toString()==='WEBP')return '.webp';
100
- if(buffer.length>=4&&buffer[0]===255&&buffer[1]===216&&buffer.at(-2)===255&&buffer.at(-1)===217)return '.jpg';
101
- throw new Error('只允许有效 PNG/JPEG/WebP 图片');
102
- }
103
- export async function importReference(settings,projectId,kind,objectId,revision,{source,category,purposes=[],itemId,usage='understand',note='',ignore=''}={}){
104
- validateReferenceNotes({note,ignore});
105
- if(kind==='style'&&!STYLE_CATEGORIES.includes(category))throw new Error('风格参考分类非法');
106
- if(kind==='task'&&(!purposes.length||purposes.some(p=>!TASK_PURPOSES.includes(p))))throw new Error('任务参考用途非法');
107
- if(usage!=='understand')throw new Error('后端直接参考尚未完成用途约束适配');
108
- const buffer=readFileSync(externalPath(source,'参考图片'));if(buffer.length>20*1024*1024)throw new Error('单图最大 20MB');
109
- await validateImage(buffer);
110
- const extension=imageExtension(buffer),referenceId='ref-'+randomUUID();
111
- let created;
112
- try{return await mutateObject(settings,projectId,kind,objectId,revision,record=>{
113
- if(itemId!==undefined&&(kind!=='task'||!record.config.items.some(item=>item.id===itemId)))throw new Error('参考所属对象不存在');
114
- const directory=objectDirectory(settings.paths.workspace,projectId,kind,objectId),path=['refs',...(kind==='style'?[category]:[]),referenceId+extension].join('/');
115
- const target=ownedPath(directory,path);mkdirSync(dirname(target),{recursive:true});writeFileSync(target,buffer,{flag:'wx'});created=target;
116
- record.references.push({...(itemId?{itemId}:{}),id:referenceId,path,hash:createHash('sha256').update(buffer).digest('hex'),source:resolve(source),category:kind==='style'?category:null,purposes:kind==='task'?[...new Set(purposes)]:[],usage,note,ignore});if(kind==='task')record.report=null;
117
- return record;
118
- });}catch(error){if(created)rmSync(created,{force:true});throw error;}
119
- }
120
- export async function updateObject(settings,projectId,kind,objectId,revision,{name,config}={}){
121
- return mutateObject(settings,projectId,kind,objectId,revision,async record=>{if(kind==='style'&&record.report&&record.report.sourceHash===hash({config:record.config,references:record.references}))record.report.evidenceHash=styleEvidenceHash(record);const before=hash(record.config);if(name!==undefined){if(!name.trim())throw new Error('名称不能为空');record.name=name;}if(config!==undefined){if(kind==='task'&&(config.kind!==record.config.kind||config.project&&config.project!==projectId))throw new Error('任务类型/工程不可修改');record.config=kind==='task'?await importSources(settings,record,validateTaskDraft(config)):styleConfig(config);if(kind==='task')record.config.project=projectId;}if(hash(record.config)!==before)if(kind==='task')record.report=null;return record;});
122
- }
123
- export async function removeReference(settings,projectId,kind,objectId,revision,referenceId){
124
- // Keep immutable snapshot resources. A later explicit object cleanup owns deletion.
125
- return mutateObject(settings,projectId,kind,objectId,revision,record=>{if(!record.references.some(r=>r.id===referenceId))throw new Error('参考不存在');record.references=record.references.filter(r=>r.id!==referenceId);if(kind==='task')record.report=null;return record;});
126
- }
127
- export async function updateReference(settings,projectId,kind,objectId,revision,referenceId,input){
128
- keys(input,['category','purposes','itemId','note','ignore'],'参考配置');
129
- let created;
130
- try{return await mutateObject(settings,projectId,kind,objectId,revision,record=>{
131
- verifyReferences(settings.paths.workspace,record);
132
- const ref=record.references.find(ref=>ref.id===referenceId);if(!ref)throw new Error('参考不存在');
133
- const before=hash(ref);
134
- for(const key of ['note','ignore'])if(input[key]!==undefined){if(typeof input[key]!=='string'||input[key].length>8000)throw new Error('参考说明非法');ref[key]=input[key];}
135
- if(kind==='style'){
136
- if(input.itemId!==undefined)throw new Error('风格参考不能配置生图对象');
137
- if(input.purposes!==undefined)throw new Error('风格参考不能配置任务用途');
138
- if(input.category!==undefined){if(!STYLE_CATEGORIES.includes(input.category))throw new Error('风格参考分类非法');
139
- if(ref.category!==input.category){const directory=objectDirectory(settings.paths.workspace,projectId,kind,objectId),old=ownedPath(directory,ref.path);ref.path=['refs',input.category,ref.id+imageExtension(readFileSync(old))].join('/');const target=ownedPath(directory,ref.path);mkdirSync(dirname(target),{recursive:true});if(!existsSync(target)){cpSync(old,target,{force:false,errorOnExist:true});created=target;}else if(createHash('sha256').update(readFileSync(target)).digest('hex')!==ref.hash)throw new Error('目标参考内容冲突');ref.category=input.category;}
140
- }
141
- }else{
142
- if(input.category!==undefined)throw new Error('任务参考不能配置静态风格分类');
143
- if(input.itemId!==undefined){if(input.itemId===null)delete ref.itemId;else {if(!record.config.items.some(item=>item.id===input.itemId))throw new Error('参考所属对象不存在');ref.itemId=input.itemId;}}
144
- if(input.purposes!==undefined){if(!Array.isArray(input.purposes)||!input.purposes.length||input.purposes.some(p=>!TASK_PURPOSES.includes(p)))throw new Error('任务参考用途非法');ref.purposes=[...new Set(input.purposes)];}
145
- }
146
- if(hash(ref)!==before)if(kind==='task')record.report=null;
147
- return record;
148
- });}catch(error){if(created)rmSync(created,{force:true});throw error;}
149
- }
150
- export async function deriveObject(settings,projectId,kind,objectId,revision){
151
- return locked(runtimeRoot(settings),'control',async()=>{
152
- const source=readObject(settings.paths.workspace,projectId,kind,objectId);
153
- if(['discarded','cleanup-required'].includes(source.status))throw new Error('对象不可派生');
154
- assertIdle(objectRuns(settings,source));
155
- if(source.revision!==revision)throw new Error('对象版本冲突');
156
- verifyReferences(settings.paths.workspace,source);
157
- if(objectFormat(settings.paths.workspace,source).status==='unreadable')throw new Error('源数据不可读,请先核对完整性');
158
- 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;
160
- 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;
162
- const derived=await createObject(settings,projectId,kind,{name:source.name+' · 派生',config,source:{id:source.id,revision:source.revision}});
163
- try{
164
- const directory=objectDirectory(settings.paths.workspace,projectId,kind,derived.id);
165
- 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){
167
- 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
- derived.report={data,sourceRevision:derived.revision,sourceHash:hash({config:derived.config,references:derived.references}),evidenceHash:styleEvidenceHash(derived),path:null,runId:null};
169
- }
170
- writeJson(objectFile(settings.paths.workspace,projectId,kind,derived.id),derived);return derived;
171
- }catch(error){derived.status='cleanup-required';derived.error=error.message;writeJson(objectFile(settings.paths.workspace,projectId,kind,derived.id),derived);throw error;}
172
- });
173
- }
174
- export async function discardObject(settings,projectId,kind,objectId,revision){
175
- const directory=objectDirectory(settings.paths.workspace,projectId,kind,objectId);
176
- return mutateObject(settings,projectId,kind,objectId,revision,record=>{
177
- if(record.status==='frozen')throw new Error('正式风格不能作为草稿放弃');
178
- // Task archival removes its active identity, preserving immutable history
179
- // and files that other task plans or private edit sources may reference.
180
- if(kind==='task'){
181
- if(record.status==='discarded')return record;
182
- record.status='discarded';record.deletedAt=now();
183
- return record;
184
- }
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
- },{allowFrozen:true});
194
- }
195
- export async function restoreTask(settings,projectId,objectId,revision){
196
- return mutateObject(settings,projectId,'task',objectId,revision,record=>{
197
- if(record.status==='draft')return record;
198
- if(record.status!=='discarded')throw new Error('只有已归档任务可以恢复');
199
- record.status='draft';delete record.deletedAt;
200
- record.restoredAt=now();
201
- return record;
202
- },{allowFrozen:true});
203
- }
204
- export function assertPlanCurrent(plan,settings){
205
- if(plan.scope?.kind==='conversation'){
206
- id(plan.scope.sessionId,'session');id(plan.scope.requestId,'request');
207
- const saved=readJson(ownedPath(settings.paths.workspace,'conversations',plan.scope.sessionId,plan.scope.requestId+'.json'));
208
- if(hash(saved.request)!==plan.sources.requestHash||hash(saved.plan)!==hash(plan))throw new Error('会话请求与预案不一致');
209
- for(const ref of plan.refs)if(!existsSync(ref.path)||createHash('sha256').update(readFileSync(ref.path)).digest('hex')!==ref.hash)throw new Error('会话参考已变化');
210
- return;
211
- }
212
- const current=readObject(settings.paths.workspace,plan.project,'task',plan.job);
213
- assertObjectCurrent(settings.paths.workspace,current);
214
- if(current.status==='discarded'||current.revision!==plan.sources.taskRevision||hash(current.config)!==plan.sources.taskConfigHash)throw new Error('计划来源已变化,请重新编译');
215
- verifyReferences(settings.paths.workspace,current);
216
- const project=readJson(ownedPath(settings.paths.workspace,'projects',plan.project,'project.json'));
217
- if(hash(project)!==hash(plan.snapshots.project))throw new Error('工程默认配置已变化,请重新编译');
218
- 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('核心已变化,请重新编译');}
220
- for(const ref of plan.refs){if(!existsSync(ref.path)||createHash('sha256').update(readFileSync(ref.path)).digest('hex')!==ref.hash)throw new Error('底图已变化,请重新编译');}
221
- }
222
- export function taskDisplayState(record,runs,finalizations=[]){
223
- const own=runs.filter(r=>(r.plan?.project??r.project)===record.project&&(r.plan?.job===record.id||r.objectKind==='task'&&r.objectId===record.id));
224
- if(own.some(run=>run.status==='unknown'))return {status:'待恢复',issue:'执行连接中断,需核对原批次'};
225
- if(own.some(run=>!executionSettled(run)))return {status:'执行中',issue:own.some(r=>r.status==='unknown'||r.unsettled)?'停止未确认':null};
226
- const items=record.config.items??[],selected=new Set(finalizations.filter(f=>f.taskConfigHash===hash(record.config)).map(f=>f.assetId));
227
- if(items.length&&items.every(i=>selected.has(i.id)))return {status:'已定版',issue:null};
228
- const deleted=new Set((record.deletedCandidates??[]).map(c=>c.candidateId));
229
- const available=own.some(run=>{if(!run.manifestPath||!existsSync(run.manifestPath))return false;const manifest=readJson(run.manifestPath);return manifest.items?.some(item=>item.ok&&item.files?.some(file=>existsSync(resolve(dirname(run.manifestPath),file))&&!deleted.has(hash({runId:run.taskId,assetId:item.itemId,variantId:item.variantId,file}))))});
230
- if(available)return {status:'待定版',issue:own.some(r=>r.status==='failed')?'部分执行失败':null};
231
- return {status:'草稿',issue:own.some(r=>r.status==='failed')?'执行失败':null};
232
- }
233
-
234
- export async function createProject(settings,projectId,input){
235
- id(projectId,'project');const file=ownedPath(settings.paths.workspace,'projects',projectId,'project.json');
236
- const project=validateProject({...input,id:projectId,schemaVersion:2,revision:1,cores:[],defaultCore:null},projectId);
237
- return locked(runtimeRoot(settings),'control',async()=>{if(existsSync(file))throw new Error('工程已存在,不能覆写');writeJson(file,project);return project;});
238
- }
239
-
240
- async function importSources(settings,record,config){
241
- const result=structuredClone(config);if(result.kind!=='edit')return result;
242
- const directory=objectDirectory(settings.paths.workspace,record.project,'task',record.id);
243
- const created=[];
244
- try{for(const item of result.items??[]){
245
- if(!item.source)continue;
246
- const original=externalPath(resolve(settings.paths.workspace,item.source),'编辑底图'),rel=relative(directory,original);
247
- if(!isAbsolute(rel)&&rel.split(/[\\/]/)[0]==='sources'){ownedPath(directory,rel);await validateImage(readFileSync(original));item.source=relative(settings.paths.workspace,original).replaceAll('\\','/');continue;}
248
- const buffer=readFileSync(original);await validateImage(buffer);const filename='sources/'+randomUUID()+imageExtension(buffer),target=ownedPath(directory,filename);mkdirSync(dirname(target),{recursive:true});writeFileSync(target,buffer,{flag:'wx'});created.push(target);item.source=relative(settings.paths.workspace,target).replaceAll('\\','/');
249
- }
250
- return result;}catch(error){for(const file of created)rmSync(ownedPath(directory,file),{force:true});throw error;}
251
- }
252
-
253
- async function createMigrationDraft(settings,source,kind){
254
- const root=settings.paths.workspace;
255
- const existing=listObjects(root,source.project,kind).find(r=>r.migration?.status==='pending'&&r.migration.source.id===source.id&&r.migration.source.revision===source.revision);
256
- if(existing)return existing;
257
- const config=kind==='style'?{description:'',constraints:[]}:(await import('./templates.mjs')).emptyJobTemplate(source.project,source.config.kind);
258
- const staged=listObjects(root,source.project,kind).find(r=>r.source?.kind==='migration'&&!r.migration&&r.source.id===source.id&&r.source.revision===source.revision);
259
- const derived=staged??await createObject(settings,source.project,kind,{name:source.name+' · 迁移',config,source:{kind:'migration',id:source.id,revision:source.revision}});
260
- const directory=objectDirectory(root,source.project,kind,derived.id),resources=[];
261
- try{
262
- const originals=verifyReferences(root,source);
263
- if(kind==='task'&&source.config.kind==='edit')for(const item of source.config.items??[])if(item.source){const path=ownedPath(root,item.source);originals.push({id:item.id,path,hash:createHash('sha256').update(readFileSync(path)).digest('hex'),role:'edit-source'});}
264
- for(const [index,ref] of originals.entries()){
265
- const bytes=readFileSync(ref.path);if(createHash('sha256').update(bytes).digest('hex')!==ref.hash)throw new Error('迁移源图片完整性失败');
266
- const path='migration/resources/'+index+imageExtension(bytes);mkdirSync(ownedPath(directory,'migration/resources'),{recursive:true});writeJson(ownedPath(directory,'migration/marker.json'),{version:1});if(existsSync(ownedPath(directory,path))){if(createHash('sha256').update(readFileSync(ownedPath(directory,path))).digest('hex')!==ref.hash)throw new Error('迁移暂存图片发生变化');}else cpSync(ref.path,ownedPath(directory,path),{force:false,errorOnExist:true});resources.push({...ref,path,source:undefined});
267
- }
268
- const snapshot={schema:'art-workshop/migration-source',version:1,object:source,resources};
269
- if(kind==='style'&&source.status==='frozen')snapshot.core=readJson(ownedPath(objectDirectory(root,source.project,kind,source.id),'core.json'));
270
- writeJson(ownedPath(directory,'migration/source.json'),snapshot);
271
- derived.status='draft';delete derived.error;
272
- derived.migration={id:'migration-'+randomUUID(),status:'pending',source:{kind,id:source.id,revision:source.revision},snapshotHash:hash(snapshot),createdAt:now()};
273
- writeJson(objectFile(root,source.project,kind,derived.id),derived);return derived;
274
- }catch(error){derived.status='cleanup-required';derived.error=error.message;writeJson(objectFile(root,source.project,kind,derived.id),derived);throw error;}
275
- }
276
- export function migrationSource(root,record){
277
- if(!record.migration)throw new Error('当前对象没有迁移来源');const directory=objectDirectory(root,record.project,record.schema.slice('art-workshop/'.length),record.id);
278
- const snapshot=readJson(ownedPath(directory,'migration/source.json'));if(hash(snapshot)!==record.migration.snapshotHash)throw new Error('迁移来源快照已变化');
279
- for(const resource of snapshot.resources){const file=ownedPath(directory,resource.path);if(createHash('sha256').update(readFileSync(file)).digest('hex')!==resource.hash)throw new Error('迁移来源图片已变化');}
280
- return snapshot;
281
- }
282
- export async function finishMigration(settings,projectId,kind,objectId,revision,{note}={}){
283
- if(typeof note!=='string'||!note.trim())throw new Error('请说明迁移结果、未沿用内容及原因');
284
- return mutateObject(settings,projectId,kind,objectId,revision,record=>{
285
- if(!record.migration)throw new Error('当前草稿没有迁移来源');migrationSource(settings.paths.workspace,record);assertObjectCurrent(settings.paths.workspace,record,{allowMigration:true});
286
- if(kind==='style'){if(!styleAnalysisReadiness(record).ready)throw new Error('迁移草稿仍缺少风格内容');}
287
- else {validateTaskDraft(record.config);if(!record.config.items?.length)throw new Error('任务内容尚未迁移');if(record.config.kind==='generate'&&(!record.config.core||record.config.items.some(i=>!i.intent?.trim()||!i.entities?.length||i.entities.some(e=>!e.appearance?.trim()))))throw new Error('请先填写任务主体、需求并绑定已采用的当前风格');if(record.config.kind==='edit'&&record.config.items.some(i=>!i.source||!i.changes?.length))throw new Error('编辑底图或修改需求尚未迁移');}
288
- verifyReferences(settings.paths.workspace,record);record.migration={...record.migration,status:'ready',note:note.trim(),completedAt:now()};return record;
289
- });
290
- }
291
-
292
- export async function confirmMigration(settings,projectId,kind,id,revision){return mutateObject(settings,projectId,kind,id,revision,record=>{if(record.migration?.status!=='ready')throw new Error('请先完成配置迁移');record.migration.confirmedAt=now();return record;});}
1
+ import {inspectObjectFormat,assertSupportedObject} from './object-format.mjs';
2
+ import {styleProvenance} from './style-evidence.mjs';
3
+ import {validateStyleDraft as styleConfig,validateReferenceNotes,styleAnalysisReadiness} from './style-contract.mjs';
4
+ import {validateTaskDraft} from './task-contract.mjs';
5
+ import {existsSync,mkdirSync,readdirSync,readFileSync,writeFileSync,lstatSync,rmSync,cpSync} from 'node:fs';
6
+ import {resolve,join,dirname,relative,isAbsolute} from 'node:path';
7
+ import {randomUUID,createHash} from 'node:crypto';
8
+ import {id,hash,readJson,writeJson,integer,keys,text,texts} from './shared.mjs';
9
+ import {externalPath} from './settings.mjs';
10
+ import {locked,tasks,runtimeRoot} from './runtime.mjs';
11
+ import {assertIdle,executionSettled} from './lifecycle.mjs';
12
+ import {validateProject} from './project.mjs';
13
+ import {validateImage} from './images.mjs';
14
+ import {taskStatus} from './tasks.mjs';
15
+
16
+ import {STYLE_CATEGORIES,STYLE_SCHEMA_VERSION} from './style-contract.mjs';
17
+ import {styleReviewState,resolvedRecommendation,validateStyleConfig,styleEvidenceHash} from './style-review.mjs';
18
+ export {STYLE_CATEGORIES} from './style-contract.mjs';
19
+ export const TASK_PURPOSES=['subject','composition','pose','identity-color','surface','scene-light','text'];
20
+ const now=()=>new Date().toISOString();
21
+ /** Resolve every existing ancestor: no user-controlled link may escape the project. */
22
+ export function ownedPath(root,...segments){
23
+ const base=externalPath(resolve(root)),path=resolve(base,...segments),rel=relative(base,path);
24
+ if(isAbsolute(rel)||rel==='..'||rel.startsWith('../')||rel.startsWith('..\\'))throw new Error('项目资源路径越界');
25
+ let current=base;
26
+ if(existsSync(base)&&lstatSync(base).isSymbolicLink())throw new Error('项目根不能为链接');
27
+ for(const segment of rel.split(/[\\/]/).filter(Boolean)){
28
+ current=join(current,segment);if(existsSync(current)&&lstatSync(current).isSymbolicLink())throw new Error('受管资源路径不能为链接');
29
+ }
30
+ return path;
31
+ }
32
+ export function objectDirectory(root,projectId,kind,objectId){
33
+ id(projectId,'project');id(objectId,kind);if(!['style','task'].includes(kind))throw new Error('对象类型非法');
34
+ return ownedPath(root,'projects',projectId,kind==='style'?'styles':'tasks',objectId);
35
+ }
36
+ export function objectFile(root,projectId,kind,objectId){return ownedPath(objectDirectory(root,projectId,kind,objectId),kind+'.json');}
37
+ export function readObject(root,projectId,kind,objectId){
38
+ if(existsSync(ownedPath(root,'.runtime/upgrades',id(projectId)+'.json')))throw new Error('工程升级事务未完成,请显式 project upgrade 恢复');
39
+ if(kind==='style'&&existsSync(ownedPath(objectDirectory(root,projectId,kind,objectId),'adoption.json')))throw new Error('风格采用事务未完成,请 style recover 后再操作');
40
+ const record=readJson(objectFile(root,projectId,kind,objectId));
41
+ if(record.schema!=='art-workshop/'+kind||record.project!==projectId||record.id!==objectId)throw new Error('对象身份或版本不匹配,请显式升级工程');
42
+ integer(record.revision,'revision',1);return record;
43
+ }
44
+ export function listObjects(root,projectId,kind){
45
+ const folder=ownedPath(root,'projects',id(projectId),kind==='style'?'styles':'tasks');
46
+ return existsSync(folder)?readdirSync(folder).filter(x=>existsSync(ownedPath(folder,x,kind+'.json'))).map(x=>{try{return readObject(root,projectId,kind,x);}catch(error){return {schema:'art-workshop/'+kind,schemaVersion:2,project:projectId,id:x,name:x,status:'unreadable',revision:1,config:{},references:[],report:null,readError:error.message};}}):[];
47
+ }
48
+ /** Read projection only: never rewrite old frozen evidence or reinterpret old references. */
49
+ export function objectFormat(root,record){
50
+ let core,dependency;
51
+ if(record.schema==='art-workshop/style'&&record.status==='frozen'){try{core=readJson(ownedPath(objectDirectory(root,record.project,'style',record.id),'core.json'));}catch(error){return {status:'unreadable',reasons:[error.message],canEdit:false,canDerive:false};}}
52
+ if(record.schema==='art-workshop/task'&&record.config?.core){try{
53
+ const file=objectFile(root,record.project,'style',record.config.core);
54
+ if(existsSync(file))dependency=objectFormat(root,readObject(root,record.project,'style',record.config.core));
55
+ else {const core=readJson(ownedPath(objectDirectory(root,record.project,'style',record.config.core),'core.json'));dependency=inspectObjectFormat({schema:'art-workshop/style',schemaVersion:2,status:'frozen',config:core.config,report:{data:core.report},references:[]},{core});}
56
+ }catch(error){dependency={status:'unreadable',reasons:[error.message]};}}
57
+ return inspectObjectFormat(record,{core,dependency});
58
+ }
59
+ export function assertObjectCurrent(root,record,{allowMigration=false}={}){assertSupportedObject(objectFormat(root,record));if(!allowMigration&&record.migration?.status==='pending')throw new Error('迁移尚未完成,请继续迁移讨论并校验草稿');}
60
+ export function styleView(root,record){
61
+ const format=objectFormat(root,record);
62
+ 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
+ }
65
+ 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
+ export async function mutateObject(settings,projectId,kind,objectId,revision,change,{allowFrozen=false}={}){
67
+ const file=objectFile(settings.paths.workspace,projectId,kind,objectId);
68
+ return locked(runtimeRoot(settings),'control',async()=>{
69
+ const before=readObject(settings.paths.workspace,projectId,kind,objectId);
70
+ if(['discarded','cleanup-required'].includes(before.status)&&!allowFrozen)throw new Error('对象已放弃或需要清理,不能继续编辑');
71
+ if(!allowFrozen)assertObjectCurrent(settings.paths.workspace,before,{allowMigration:true});
72
+ 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));
76
+ if(after.id!==before.id||after.project!==before.project||after.schema!==before.schema||after.schemaVersion!==2)throw new Error('禁止修改对象身份');
77
+ if(hash(after)===hash(before))return before;
78
+ after.revision=before.revision+1;after.updatedAt=now();writeJson(file,after);return after;
79
+ });
80
+ }
81
+ export async function createObject(settings,projectId,kind,{name,config={},source=null}={}){
82
+ if(existsSync(ownedPath(settings.paths.workspace,'.runtime/upgrades',id(projectId)+'.json')))throw new Error('工程升级事务未完成,请显式 project upgrade 恢复');
83
+ const project=readJson(ownedPath(settings.paths.workspace,'projects',id(projectId),'project.json'));
84
+ if(project.schemaVersion!==2)throw new Error('工程需先显式升级');
85
+ if(typeof name!=='string'||!name.trim())throw new Error('对象名称不能为空');
86
+ const objectId=kind+'-'+randomUUID(),record={schema:'art-workshop/'+kind,schemaVersion:2,project:projectId,id:objectId,name:name.trim(),revision:1,status:'draft',createdAt:now(),updatedAt:now(),source,config:kind==='style'?styleConfig(config):structuredClone(config),references:[],report:null};
87
+ if(kind==='task'){validateTaskDraft(config);if(!['generate','edit'].includes(config.kind))throw new Error('任务必须声明生成或编辑类型');record.config.project=projectId;}
88
+ if(kind==='task')assertSupportedObject(objectFormat(settings.paths.workspace,{...record,source:null}));
89
+ 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;}
92
+ }
93
+ export function verifyReferences(root,record){
94
+ const directory=objectDirectory(root,record.project,record.schema.slice('art-workshop/'.length),record.id);
95
+ return record.references.map(ref=>{const path=ownedPath(directory,ref.path);if(!existsSync(path)||createHash('sha256').update(readFileSync(path)).digest('hex')!==ref.hash)throw new Error('参考资源已变化:'+ref.id);return {...ref,path};});
96
+ }
97
+ function imageExtension(buffer){
98
+ if(buffer.length>=24&&buffer.subarray(0,8).equals(Buffer.from([137,80,78,71,13,10,26,10])))return '.png';
99
+ if(buffer.length>=12&&buffer.subarray(0,4).toString()==='RIFF'&&buffer.subarray(8,12).toString()==='WEBP')return '.webp';
100
+ if(buffer.length>=4&&buffer[0]===255&&buffer[1]===216&&buffer.at(-2)===255&&buffer.at(-1)===217)return '.jpg';
101
+ throw new Error('只允许有效 PNG/JPEG/WebP 图片');
102
+ }
103
+ export async function importReference(settings,projectId,kind,objectId,revision,{source,category,purposes=[],itemId,usage='understand',note='',ignore=''}={}){
104
+ validateReferenceNotes({note,ignore});
105
+ if(kind==='style'&&!STYLE_CATEGORIES.includes(category))throw new Error('风格参考分类非法');
106
+ if(kind==='task'&&(!purposes.length||purposes.some(p=>!TASK_PURPOSES.includes(p))))throw new Error('任务参考用途非法');
107
+ if(usage!=='understand')throw new Error('后端直接参考尚未完成用途约束适配');
108
+ const buffer=readFileSync(externalPath(source,'参考图片'));if(buffer.length>20*1024*1024)throw new Error('单图最大 20MB');
109
+ await validateImage(buffer);
110
+ const extension=imageExtension(buffer),referenceId='ref-'+randomUUID();
111
+ let created;
112
+ try{return await mutateObject(settings,projectId,kind,objectId,revision,record=>{
113
+ if(itemId!==undefined&&(kind!=='task'||!record.config.items.some(item=>item.id===itemId)))throw new Error('参考所属对象不存在');
114
+ const directory=objectDirectory(settings.paths.workspace,projectId,kind,objectId),path=['refs',...(kind==='style'?[category]:[]),referenceId+extension].join('/');
115
+ const target=ownedPath(directory,path);mkdirSync(dirname(target),{recursive:true});writeFileSync(target,buffer,{flag:'wx'});created=target;
116
+ record.references.push({...(itemId?{itemId}:{}),id:referenceId,path,hash:createHash('sha256').update(buffer).digest('hex'),source:resolve(source),category:kind==='style'?category:null,purposes:kind==='task'?[...new Set(purposes)]:[],usage,note,ignore});if(kind==='task')record.report=null;
117
+ return record;
118
+ });}catch(error){if(created)rmSync(created,{force:true});throw error;}
119
+ }
120
+ export async function updateObject(settings,projectId,kind,objectId,revision,{name,config}={}){
121
+ return mutateObject(settings,projectId,kind,objectId,revision,async record=>{if(kind==='style'&&record.report&&record.report.sourceHash===hash({config:record.config,references:record.references}))record.report.evidenceHash=styleEvidenceHash(record);const before=hash(record.config);if(name!==undefined){if(!name.trim())throw new Error('名称不能为空');record.name=name;}if(config!==undefined){if(kind==='task'&&(config.kind!==record.config.kind||config.project&&config.project!==projectId))throw new Error('任务类型/工程不可修改');record.config=kind==='task'?await importSources(settings,record,validateTaskDraft(config)):styleConfig(config);if(kind==='task')record.config.project=projectId;}if(hash(record.config)!==before)if(kind==='task')record.report=null;return record;});
122
+ }
123
+ export async function removeReference(settings,projectId,kind,objectId,revision,referenceId){
124
+ // Keep immutable snapshot resources. A later explicit object cleanup owns deletion.
125
+ return mutateObject(settings,projectId,kind,objectId,revision,record=>{if(!record.references.some(r=>r.id===referenceId))throw new Error('参考不存在');record.references=record.references.filter(r=>r.id!==referenceId);if(kind==='task')record.report=null;return record;});
126
+ }
127
+ export async function updateReference(settings,projectId,kind,objectId,revision,referenceId,input){
128
+ keys(input,['category','purposes','itemId','note','ignore'],'参考配置');
129
+ let created;
130
+ try{return await mutateObject(settings,projectId,kind,objectId,revision,record=>{
131
+ verifyReferences(settings.paths.workspace,record);
132
+ const ref=record.references.find(ref=>ref.id===referenceId);if(!ref)throw new Error('参考不存在');
133
+ const before=hash(ref);
134
+ for(const key of ['note','ignore'])if(input[key]!==undefined){if(typeof input[key]!=='string'||input[key].length>8000)throw new Error('参考说明非法');ref[key]=input[key];}
135
+ if(kind==='style'){
136
+ if(input.itemId!==undefined)throw new Error('风格参考不能配置生图对象');
137
+ if(input.purposes!==undefined)throw new Error('风格参考不能配置任务用途');
138
+ if(input.category!==undefined){if(!STYLE_CATEGORIES.includes(input.category))throw new Error('风格参考分类非法');
139
+ if(ref.category!==input.category){const directory=objectDirectory(settings.paths.workspace,projectId,kind,objectId),old=ownedPath(directory,ref.path);ref.path=['refs',input.category,ref.id+imageExtension(readFileSync(old))].join('/');const target=ownedPath(directory,ref.path);mkdirSync(dirname(target),{recursive:true});if(!existsSync(target)){cpSync(old,target,{force:false,errorOnExist:true});created=target;}else if(createHash('sha256').update(readFileSync(target)).digest('hex')!==ref.hash)throw new Error('目标参考内容冲突');ref.category=input.category;}
140
+ }
141
+ }else{
142
+ if(input.category!==undefined)throw new Error('任务参考不能配置静态风格分类');
143
+ if(input.itemId!==undefined){if(input.itemId===null)delete ref.itemId;else {if(!record.config.items.some(item=>item.id===input.itemId))throw new Error('参考所属对象不存在');ref.itemId=input.itemId;}}
144
+ if(input.purposes!==undefined){if(!Array.isArray(input.purposes)||!input.purposes.length||input.purposes.some(p=>!TASK_PURPOSES.includes(p)))throw new Error('任务参考用途非法');ref.purposes=[...new Set(input.purposes)];}
145
+ }
146
+ if(hash(ref)!==before)if(kind==='task')record.report=null;
147
+ return record;
148
+ });}catch(error){if(created)rmSync(created,{force:true});throw error;}
149
+ }
150
+ export async function deriveObject(settings,projectId,kind,objectId,revision){
151
+ return locked(runtimeRoot(settings),'control',async()=>{
152
+ const source=readObject(settings.paths.workspace,projectId,kind,objectId);
153
+ if(['discarded','cleanup-required'].includes(source.status))throw new Error('对象不可派生');
154
+ assertIdle(objectRuns(settings,source));
155
+ if(source.revision!==revision)throw new Error('对象版本冲突');
156
+ verifyReferences(settings.paths.workspace,source);
157
+ if(objectFormat(settings.paths.workspace,source).status==='unreadable')throw new Error('源数据不可读,请先核对完整性');
158
+ 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;
160
+ 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;
162
+ const derived=await createObject(settings,projectId,kind,{name:source.name+' · 派生',config,source:{id:source.id,revision:source.revision}});
163
+ try{
164
+ const directory=objectDirectory(settings.paths.workspace,projectId,kind,derived.id);
165
+ 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){
167
+ 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
+ derived.report={data,sourceRevision:derived.revision,sourceHash:hash({config:derived.config,references:derived.references}),evidenceHash:styleEvidenceHash(derived),path:null,runId:null};
169
+ }
170
+ writeJson(objectFile(settings.paths.workspace,projectId,kind,derived.id),derived);return derived;
171
+ }catch(error){derived.status='cleanup-required';derived.error=error.message;writeJson(objectFile(settings.paths.workspace,projectId,kind,derived.id),derived);throw error;}
172
+ });
173
+ }
174
+ export async function discardObject(settings,projectId,kind,objectId,revision){
175
+ const directory=objectDirectory(settings.paths.workspace,projectId,kind,objectId);
176
+ return mutateObject(settings,projectId,kind,objectId,revision,record=>{
177
+ if(record.status==='frozen')throw new Error('正式风格不能作为草稿放弃');
178
+ // Task archival removes its active identity, preserving immutable history
179
+ // and files that other task plans or private edit sources may reference.
180
+ if(kind==='task'){
181
+ if(record.status==='discarded')return record;
182
+ record.status='discarded';record.deletedAt=now();
183
+ return record;
184
+ }
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
+ },{allowFrozen:true});
194
+ }
195
+ export async function restoreTask(settings,projectId,objectId,revision){
196
+ return mutateObject(settings,projectId,'task',objectId,revision,record=>{
197
+ if(record.status==='draft')return record;
198
+ if(record.status!=='discarded')throw new Error('只有已归档任务可以恢复');
199
+ record.status='draft';delete record.deletedAt;
200
+ record.restoredAt=now();
201
+ return record;
202
+ },{allowFrozen:true});
203
+ }
204
+ export function assertPlanCurrent(plan,settings){
205
+ if(plan.scope?.kind==='conversation'){
206
+ id(plan.scope.sessionId,'session');id(plan.scope.requestId,'request');
207
+ const saved=readJson(ownedPath(settings.paths.workspace,'conversations',plan.scope.sessionId,plan.scope.requestId+'.json'));
208
+ if(hash(saved.request)!==plan.sources.requestHash||hash(saved.plan)!==hash(plan))throw new Error('会话请求与预案不一致');
209
+ for(const ref of plan.refs)if(!existsSync(ref.path)||createHash('sha256').update(readFileSync(ref.path)).digest('hex')!==ref.hash)throw new Error('会话参考已变化');
210
+ return;
211
+ }
212
+ const current=readObject(settings.paths.workspace,plan.project,'task',plan.job);
213
+ assertObjectCurrent(settings.paths.workspace,current);
214
+ if(current.status==='discarded'||current.revision!==plan.sources.taskRevision||hash(current.config)!==plan.sources.taskConfigHash)throw new Error('计划来源已变化,请重新编译');
215
+ verifyReferences(settings.paths.workspace,current);
216
+ const project=readJson(ownedPath(settings.paths.workspace,'projects',plan.project,'project.json'));
217
+ if(hash(project)!==hash(plan.snapshots.project))throw new Error('工程默认配置已变化,请重新编译');
218
+ 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('核心已变化,请重新编译');}
220
+ for(const ref of plan.refs){if(!existsSync(ref.path)||createHash('sha256').update(readFileSync(ref.path)).digest('hex')!==ref.hash)throw new Error('底图已变化,请重新编译');}
221
+ }
222
+ export function taskDisplayState(record,runs,finalizations=[]){
223
+ const own=runs.filter(r=>(r.plan?.project??r.project)===record.project&&(r.plan?.job===record.id||r.objectKind==='task'&&r.objectId===record.id));
224
+ if(own.some(run=>run.status==='unknown'))return {status:'待恢复',issue:'执行连接中断,需核对原批次'};
225
+ if(own.some(run=>!executionSettled(run)))return {status:'执行中',issue:own.some(r=>r.status==='unknown'||r.unsettled)?'停止未确认':null};
226
+ const items=record.config.items??[],selected=new Set(finalizations.filter(f=>f.taskConfigHash===hash(record.config)).map(f=>f.assetId));
227
+ if(items.length&&items.every(i=>selected.has(i.id)))return {status:'已定版',issue:null};
228
+ const deleted=new Set((record.deletedCandidates??[]).map(c=>c.candidateId));
229
+ const available=own.some(run=>{if(!run.manifestPath||!existsSync(run.manifestPath))return false;const manifest=readJson(run.manifestPath);return manifest.items?.some(item=>item.ok&&item.files?.some(file=>existsSync(resolve(dirname(run.manifestPath),file))&&!deleted.has(hash({runId:run.taskId,assetId:item.itemId,variantId:item.variantId,file}))))});
230
+ if(available)return {status:'待定版',issue:own.some(r=>r.status==='failed')?'部分执行失败':null};
231
+ return {status:'草稿',issue:own.some(r=>r.status==='failed')?'执行失败':null};
232
+ }
233
+
234
+ export async function createProject(settings,projectId,input){
235
+ id(projectId,'project');const file=ownedPath(settings.paths.workspace,'projects',projectId,'project.json');
236
+ const project=validateProject({...input,id:projectId,schemaVersion:2,revision:1,cores:[],defaultCore:null},projectId);
237
+ return locked(runtimeRoot(settings),'control',async()=>{if(existsSync(file))throw new Error('工程已存在,不能覆写');writeJson(file,project);return project;});
238
+ }
239
+
240
+ async function importSources(settings,record,config){
241
+ const result=structuredClone(config);if(result.kind!=='edit')return result;
242
+ const directory=objectDirectory(settings.paths.workspace,record.project,'task',record.id);
243
+ const created=[];
244
+ try{for(const item of result.items??[]){
245
+ if(!item.source)continue;
246
+ const original=externalPath(resolve(settings.paths.workspace,item.source),'编辑底图'),rel=relative(directory,original);
247
+ if(!isAbsolute(rel)&&rel.split(/[\\/]/)[0]==='sources'){ownedPath(directory,rel);await validateImage(readFileSync(original));item.source=relative(settings.paths.workspace,original).replaceAll('\\','/');continue;}
248
+ const buffer=readFileSync(original);await validateImage(buffer);const filename='sources/'+randomUUID()+imageExtension(buffer),target=ownedPath(directory,filename);mkdirSync(dirname(target),{recursive:true});writeFileSync(target,buffer,{flag:'wx'});created.push(target);item.source=relative(settings.paths.workspace,target).replaceAll('\\','/');
249
+ }
250
+ return result;}catch(error){for(const file of created)rmSync(ownedPath(directory,file),{force:true});throw error;}
251
+ }
252
+
253
+ async function createMigrationDraft(settings,source,kind){
254
+ const root=settings.paths.workspace;
255
+ const existing=listObjects(root,source.project,kind).find(r=>r.migration?.status==='pending'&&r.migration.source.id===source.id&&r.migration.source.revision===source.revision);
256
+ if(existing)return existing;
257
+ const config=kind==='style'?{description:'',constraints:[]}:(await import('./templates.mjs')).emptyJobTemplate(source.project,source.config.kind);
258
+ const staged=listObjects(root,source.project,kind).find(r=>r.source?.kind==='migration'&&!r.migration&&r.source.id===source.id&&r.source.revision===source.revision);
259
+ const derived=staged??await createObject(settings,source.project,kind,{name:source.name+' · 迁移',config,source:{kind:'migration',id:source.id,revision:source.revision}});
260
+ const directory=objectDirectory(root,source.project,kind,derived.id),resources=[];
261
+ try{
262
+ const originals=verifyReferences(root,source);
263
+ if(kind==='task'&&source.config.kind==='edit')for(const item of source.config.items??[])if(item.source){const path=ownedPath(root,item.source);originals.push({id:item.id,path,hash:createHash('sha256').update(readFileSync(path)).digest('hex'),role:'edit-source'});}
264
+ for(const [index,ref] of originals.entries()){
265
+ const bytes=readFileSync(ref.path);if(createHash('sha256').update(bytes).digest('hex')!==ref.hash)throw new Error('迁移源图片完整性失败');
266
+ const path='migration/resources/'+index+imageExtension(bytes);mkdirSync(ownedPath(directory,'migration/resources'),{recursive:true});writeJson(ownedPath(directory,'migration/marker.json'),{version:1});if(existsSync(ownedPath(directory,path))){if(createHash('sha256').update(readFileSync(ownedPath(directory,path))).digest('hex')!==ref.hash)throw new Error('迁移暂存图片发生变化');}else cpSync(ref.path,ownedPath(directory,path),{force:false,errorOnExist:true});resources.push({...ref,path,source:undefined});
267
+ }
268
+ const snapshot={schema:'art-workshop/migration-source',version:1,object:source,resources};
269
+ if(kind==='style'&&source.status==='frozen')snapshot.core=readJson(ownedPath(objectDirectory(root,source.project,kind,source.id),'core.json'));
270
+ writeJson(ownedPath(directory,'migration/source.json'),snapshot);
271
+ derived.status='draft';delete derived.error;
272
+ derived.migration={id:'migration-'+randomUUID(),status:'pending',source:{kind,id:source.id,revision:source.revision},snapshotHash:hash(snapshot),createdAt:now()};
273
+ writeJson(objectFile(root,source.project,kind,derived.id),derived);return derived;
274
+ }catch(error){derived.status='cleanup-required';derived.error=error.message;writeJson(objectFile(root,source.project,kind,derived.id),derived);throw error;}
275
+ }
276
+ export function migrationSource(root,record){
277
+ if(!record.migration)throw new Error('当前对象没有迁移来源');const directory=objectDirectory(root,record.project,record.schema.slice('art-workshop/'.length),record.id);
278
+ const snapshot=readJson(ownedPath(directory,'migration/source.json'));if(hash(snapshot)!==record.migration.snapshotHash)throw new Error('迁移来源快照已变化');
279
+ for(const resource of snapshot.resources){const file=ownedPath(directory,resource.path);if(createHash('sha256').update(readFileSync(file)).digest('hex')!==resource.hash)throw new Error('迁移来源图片已变化');}
280
+ return snapshot;
281
+ }
282
+ export async function finishMigration(settings,projectId,kind,objectId,revision,{note}={}){
283
+ if(typeof note!=='string'||!note.trim())throw new Error('请说明迁移结果、未沿用内容及原因');
284
+ return mutateObject(settings,projectId,kind,objectId,revision,record=>{
285
+ if(!record.migration)throw new Error('当前草稿没有迁移来源');migrationSource(settings.paths.workspace,record);assertObjectCurrent(settings.paths.workspace,record,{allowMigration:true});
286
+ if(kind==='style'){if(!styleAnalysisReadiness(record).ready)throw new Error('迁移草稿仍缺少风格内容');}
287
+ else {validateTaskDraft(record.config);if(!record.config.items?.length)throw new Error('任务内容尚未迁移');if(record.config.kind==='generate'&&(!record.config.core||record.config.items.some(i=>!i.intent?.trim()||!i.entities?.length||i.entities.some(e=>!e.appearance?.trim()))))throw new Error('请先填写任务主体、需求并绑定已采用的当前风格');if(record.config.kind==='edit'&&record.config.items.some(i=>!i.source||!i.changes?.length))throw new Error('编辑底图或修改需求尚未迁移');}
288
+ verifyReferences(settings.paths.workspace,record);record.migration={...record.migration,status:'ready',note:note.trim(),completedAt:now()};return record;
289
+ });
290
+ }
291
+
292
+ export async function confirmMigration(settings,projectId,kind,id,revision){return mutateObject(settings,projectId,kind,id,revision,record=>{if(record.migration?.status!=='ready')throw new Error('请先完成配置迁移');record.migration.confirmedAt=now();return record;});}