@kevlns/art-workshop 0.2.1 → 0.3.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.
- package/AGENTS.md +26 -49
- package/README.md +31 -93
- package/art-workshop.mjs +70 -26
- package/docs/commands.md +913 -80
- package/docs/configuration.md +33 -139
- package/docs/core-guidance.md +15 -76
- package/docs/data-formats.md +15 -151
- package/docs/deployment.md +42 -0
- package/docs/model-architecture.md +52 -0
- package/docs/modes.md +15 -116
- package/docs/remote-models.md +42 -0
- package/docs/troubleshooting.md +31 -67
- package/lib/adapters/dashscope.mjs +234 -0
- package/lib/adapters/index.mjs +28 -0
- package/lib/agent.mjs +2 -2
- package/lib/analysis-worker.mjs +27 -0
- package/lib/analyze.mjs +29 -13
- package/lib/backends.mjs +350 -74
- package/lib/bl.mjs +3 -18
- package/lib/candidates.mjs +82 -0
- package/lib/comfyui.mjs +10 -8
- package/lib/contracts.d.ts +67 -0
- package/lib/core.mjs +24 -45
- package/lib/deployment-process.mjs +19 -0
- package/lib/deployment-source.mjs +24 -0
- package/lib/deployment-worker.mjs +86 -0
- package/lib/deployment.mjs +75 -0
- package/lib/design.mjs +5 -5
- package/lib/dimensions.mjs +22 -0
- package/lib/edit.mjs +6 -3
- package/lib/environments.mjs +67 -0
- package/lib/execution/remote.mjs +156 -0
- package/lib/executor.mjs +12 -24
- package/lib/generate.mjs +9 -6
- package/lib/generation-policy.mjs +198 -0
- package/lib/images.mjs +10 -0
- package/lib/lifecycle.mjs +40 -0
- package/lib/migration.mjs +154 -0
- package/lib/model-catalog.mjs +288 -0
- package/lib/model-registry.mjs +234 -0
- package/lib/plan.mjs +98 -28
- package/lib/project.mjs +13 -4
- package/lib/providers.mjs +27 -22
- package/lib/refs.mjs +10 -18
- package/lib/runtime.mjs +6 -4
- package/lib/service.mjs +45 -4
- package/lib/settings.mjs +2 -4
- package/lib/shared.mjs +10 -7
- package/lib/style-contract.mjs +19 -0
- package/lib/style-lifecycle.mjs +73 -0
- package/lib/task-references.mjs +37 -0
- package/lib/task-worker.mjs +225 -50
- package/lib/tasks.mjs +442 -63
- package/lib/templates.mjs +68 -0
- package/lib/transport/cli.mjs +69 -0
- package/lib/transport/http.mjs +82 -0
- package/lib/vision.mjs +46 -0
- package/lib/workflows.mjs +10 -1
- package/lib/workspace.mjs +211 -0
- package/package.json +9 -3
- package/rules/core-guidance.json +14 -13
- package/skills/art-workshop/SKILL.md +28 -53
- package/v-cli.plugin.json +1257 -143
- package/docs//351/227/256/351/242/230/346/212/245/345/221/212-2026-10-08.md +0 -29
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
export class RemoteError extends Error {
|
|
2
|
+
constructor(message, { unsettled = false, code = "remote_error" } = {}) {
|
|
3
|
+
super(message);
|
|
4
|
+
this.name = "RemoteError";
|
|
5
|
+
this.unsettled = unsettled;
|
|
6
|
+
this.code = code;
|
|
7
|
+
}
|
|
8
|
+
}
|
|
9
|
+
export async function boundedBody(response, limit) {
|
|
10
|
+
const reader = response.body?.getReader();
|
|
11
|
+
if (!reader) throw new RemoteError("远程响应为空", { unsettled: true });
|
|
12
|
+
const chunks = [];
|
|
13
|
+
let size = 0;
|
|
14
|
+
try {
|
|
15
|
+
while (true) {
|
|
16
|
+
const next = await reader.read();
|
|
17
|
+
if (next.done) break;
|
|
18
|
+
size += next.value.byteLength;
|
|
19
|
+
if (size > limit)
|
|
20
|
+
throw new RemoteError("远程响应超过大小限制", { unsettled: true });
|
|
21
|
+
chunks.push(next.value);
|
|
22
|
+
}
|
|
23
|
+
} catch (error) {
|
|
24
|
+
await reader.cancel().catch(() => {});
|
|
25
|
+
throw error;
|
|
26
|
+
}
|
|
27
|
+
return Buffer.concat(chunks);
|
|
28
|
+
}
|
|
29
|
+
/** Authentication is sent only to the configured origin; redirects never forward it. */
|
|
30
|
+
export async function requestJson(
|
|
31
|
+
url,
|
|
32
|
+
{
|
|
33
|
+
method = "GET",
|
|
34
|
+
headers = {},
|
|
35
|
+
body,
|
|
36
|
+
cancelled = () => false,
|
|
37
|
+
transport = fetch,
|
|
38
|
+
timeout = 60000,
|
|
39
|
+
} = {},
|
|
40
|
+
) {
|
|
41
|
+
const controller = new AbortController(),
|
|
42
|
+
deadline = setTimeout(() => controller.abort(), timeout),
|
|
43
|
+
timer = setInterval(() => {
|
|
44
|
+
if (cancelled()) controller.abort();
|
|
45
|
+
}, 100);
|
|
46
|
+
try {
|
|
47
|
+
const response = await transport(url, {
|
|
48
|
+
method,
|
|
49
|
+
headers,
|
|
50
|
+
redirect: "error",
|
|
51
|
+
signal: controller.signal,
|
|
52
|
+
...(body ? { body: JSON.stringify(body) } : {}),
|
|
53
|
+
});
|
|
54
|
+
if (!response.ok)
|
|
55
|
+
throw new RemoteError(
|
|
56
|
+
"图片服务请求失败(HTTP " + response.status + ")",
|
|
57
|
+
{ unsettled: response.status >= 500, code: "http_" + response.status },
|
|
58
|
+
);
|
|
59
|
+
let result;
|
|
60
|
+
try {
|
|
61
|
+
result = JSON.parse(
|
|
62
|
+
(await boundedBody(response, 4 * 1024 * 1024)).toString("utf8"),
|
|
63
|
+
);
|
|
64
|
+
} catch (error) {
|
|
65
|
+
if (error instanceof RemoteError) throw error;
|
|
66
|
+
throw new RemoteError("图片服务返回无效 JSON", { unsettled: true });
|
|
67
|
+
}
|
|
68
|
+
if (!result || typeof result !== "object" || Array.isArray(result))
|
|
69
|
+
throw new RemoteError("图片服务响应结构无效", { unsettled: true });
|
|
70
|
+
if (result.code)
|
|
71
|
+
throw new RemoteError("图片服务拒绝请求", { code: "provider_rejected" });
|
|
72
|
+
return result;
|
|
73
|
+
} catch (error) {
|
|
74
|
+
if (error instanceof RemoteError) throw error;
|
|
75
|
+
throw new RemoteError("图片服务连接中断或超时,不能确认上游执行结果", {
|
|
76
|
+
unsettled: true,
|
|
77
|
+
});
|
|
78
|
+
} finally {
|
|
79
|
+
clearTimeout(deadline);
|
|
80
|
+
clearInterval(timer);
|
|
81
|
+
}
|
|
82
|
+
}
|
package/lib/vision.mjs
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import {readFileSync} from 'node:fs';
|
|
2
|
+
|
|
3
|
+
/** The harness supplies one selected credential in process memory, never in argv or run evidence. */
|
|
4
|
+
export async function callVision(args,{cancelled=()=>false,onRemoteCancel,transport=fetch}={}) {
|
|
5
|
+
const config=JSON.parse(process.env.ART_VISION_CONFIG??'null'),key=process.env.ART_VISION_KEY;
|
|
6
|
+
if(!config||!key)throw new Error('视觉模型实例未配置');
|
|
7
|
+
const value=name=>args[args.indexOf(name)+1],model=value('--model');
|
|
8
|
+
const image=args.includes('--image')?value('--image'):null,text=args.includes('--prompt')?value('--prompt'):value('--message');
|
|
9
|
+
if(!model||!text)throw new Error('视觉调用缺少模型或提示');
|
|
10
|
+
if(config.model&&model!==config.model)throw new Error('视觉模型与授权实例不匹配');
|
|
11
|
+
const configuredTokens=config.maxTokens??16384;if(!Number.isSafeInteger(configuredTokens)||configuredTokens<1024)throw new Error('视觉模型输出额度非法');
|
|
12
|
+
const maxTokens=Math.min(configuredTokens,32768);
|
|
13
|
+
const base=new URL(config.baseUrl);if(!['http:','https:'].includes(base.protocol)||base.username||base.password||base.search||base.hash)throw new Error('视觉模型地址非法');
|
|
14
|
+
let mime='image/png',data;if(image){const bytes=readFileSync(image);mime=bytes[0]===255?'image/jpeg':bytes.subarray(0,4).toString()==='RIFF'?'image/webp':'image/png';data=bytes.toString('base64');}
|
|
15
|
+
let endpoint,headers,body;
|
|
16
|
+
if(config.api==='openai-completions'){
|
|
17
|
+
endpoint='/chat/completions';headers={Authorization:'Bearer '+key};body={model,messages:[{role:'user',content:[{type:'text',text},...(data?[{type:'image_url',image_url:{url:`data:${mime};base64,${data}`}}]:[])]}],max_tokens:maxTokens};
|
|
18
|
+
}else if(config.api==='openai-responses'){
|
|
19
|
+
endpoint='/responses';headers={Authorization:'Bearer '+key};body={model,input:[{role:'user',content:[{type:'input_text',text},...(data?[{type:'input_image',image_url:`data:${mime};base64,${data}`}]:[])]}],max_output_tokens:maxTokens};
|
|
20
|
+
}else if(config.api==='anthropic-messages'){
|
|
21
|
+
endpoint='/messages';headers={'x-api-key':key,'anthropic-version':'2023-06-01'};body={model,max_tokens:maxTokens,messages:[{role:'user',content:[...(data?[{type:'image',source:{type:'base64',media_type:mime,data}}]:[]),{type:'text',text}]}]};
|
|
22
|
+
}else if(config.api==='google-generative-ai'){
|
|
23
|
+
endpoint='/models/'+encodeURIComponent(model)+':generateContent';headers={'x-goog-api-key':key};body={contents:[{role:'user',parts:[{text},...(data?[{inlineData:{mimeType:mime,data}}]:[])]}],generationConfig:{maxOutputTokens:maxTokens}};
|
|
24
|
+
}else throw new Error('视觉模型协议尚未适配');
|
|
25
|
+
if(cancelled())throw new Error('分析已取消');
|
|
26
|
+
const controller=new AbortController();let sent=false;
|
|
27
|
+
const timer=setInterval(()=>{if(cancelled())controller.abort();},100),timeout=setTimeout(()=>controller.abort(),300000);
|
|
28
|
+
try{
|
|
29
|
+
sent=true;
|
|
30
|
+
const response=await transport(base.href.replace(/\/$/,'')+endpoint,{method:'POST',headers:{...headers,'Content-Type':'application/json'},body:JSON.stringify(body),redirect:'error',signal:controller.signal});
|
|
31
|
+
if(!response.ok)throw new Error('视觉模型请求失败(HTTP '+response.status+')');
|
|
32
|
+
const reader=response.body?.getReader();if(!reader)throw new Error('视觉模型未返回报告');
|
|
33
|
+
const chunks=[];let size=0;
|
|
34
|
+
while(true){const next=await reader.read();if(next.done)break;size+=next.value.byteLength;if(size>8_000_000){await reader.cancel();throw new Error('视觉响应过大');}chunks.push(next.value);}
|
|
35
|
+
const raw=Buffer.concat(chunks).toString('utf8');
|
|
36
|
+
const result=JSON.parse(raw);
|
|
37
|
+
if(result.choices?.[0]?.finish_reason==='length'||result.status==='incomplete'||result.stop_reason==='max_tokens'||result.candidates?.some(c=>c.finishReason==='MAX_TOKENS'))throw new Error('视觉报告超出模型输出额度,请调整输出额度后重新分析;未回填截断结果');
|
|
38
|
+
// Return only assistant text, rather than recursively interpreting arbitrary response metadata as a report.
|
|
39
|
+
const texts=config.api==='openai-completions'?[result.choices?.[0]?.message?.content]:config.api==='openai-responses'?(result.output??[]).flatMap(item=>(item.content??[]).filter(c=>c.type==='output_text').map(c=>c.text)):config.api==='anthropic-messages'?(result.content??[]).filter(c=>c.type==='text').map(c=>c.text):(result.candidates??[]).flatMap(item=>(item.content?.parts??[]).map(c=>c.text));
|
|
40
|
+
if(!texts.length||texts.some(t=>typeof t!=='string'))throw new Error('视觉模型未返回文字报告');
|
|
41
|
+
return {text:texts.join('\n')};
|
|
42
|
+
}catch(error){
|
|
43
|
+
if(sent&&(controller.signal.aborted||error instanceof TypeError)){onRemoteCancel?.();throw new Error('视觉请求未确认停止,请查询原运行;不要重新提交');}
|
|
44
|
+
throw new Error(/^视觉/.test(error.message)?error.message:'视觉模型响应解析失败');
|
|
45
|
+
}finally{clearInterval(timer);clearTimeout(timeout);}
|
|
46
|
+
}
|
package/lib/workflows.mjs
CHANGED
|
@@ -4,7 +4,7 @@ import {fileURLToPath} from 'node:url';
|
|
|
4
4
|
export const BUILTIN_WORKFLOW='vant-builtin-qwen-image-2.1-Q4-8GB';
|
|
5
5
|
const root=dirname(dirname(fileURLToPath(import.meta.url)));
|
|
6
6
|
export const builtinBindings={model:{node:'1',input:'unet_name'},prompt:{node:'4',input:'prompt'},negativePrompt:{node:'4',input:'negative_prompt'},width:{node:'5',input:'width'},height:{node:'5',input:'height'},count:{node:'5',input:'batch_size'},seed:{node:'6',input:'seed'}};
|
|
7
|
-
export function loadBackend(settings,name) {
|
|
7
|
+
export function loadBackend(settings,name,mode='generate') {
|
|
8
8
|
const backend=structuredClone(settings.generation.backends[name]);if(!backend)throw new Error('未知 backend '+name);
|
|
9
9
|
backend.id=name;
|
|
10
10
|
if(backend.provider!=='comfyui')return backend;
|
|
@@ -13,6 +13,15 @@ export function loadBackend(settings,name) {
|
|
|
13
13
|
const path=builtin?resolve(root,'workflows',BUILTIN_WORKFLOW+'.api.json'):backend.workflow;
|
|
14
14
|
backend.template=JSON.parse(readFileSync(path,'utf8'));
|
|
15
15
|
backend.bindings=builtin?{...structuredClone(builtinBindings),...backend.bindings}:backend.bindings;
|
|
16
|
+
if(builtin&&mode==='edit'&&!backend.bindings.image){
|
|
17
|
+
backend.template['10']={class_type:'LoadImage',inputs:{image:'art-input.png'},_meta:{title:'加载本任务编辑底图'}};
|
|
18
|
+
backend.template['5']={class_type:'ImageScale',inputs:{image:['10',0],upscale_method:'lanczos',width:512,height:512,crop:'disabled'},_meta:{title:'按冻结方案调整底图尺寸'}};
|
|
19
|
+
backend.template['4'].inputs.resolution=0;
|
|
20
|
+
backend.template['6'].inputs.latent_image=['4',2];
|
|
21
|
+
delete backend.bindings.count;
|
|
22
|
+
backend.bindings.image={node:'10',input:'image'};
|
|
23
|
+
backend.bindings.vae={node:'3',input:'vae_name'};
|
|
24
|
+
}
|
|
16
25
|
if(backend.launch){backend.launch.executable=resolve(dirname(settings.file),backend.launch.executable);backend.launch.cwd=resolve(dirname(settings.file),backend.launch.cwd);}
|
|
17
26
|
return backend;
|
|
18
27
|
}
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
import {existsSync,mkdirSync,readdirSync,readFileSync,writeFileSync,lstatSync,rmSync,cpSync} from 'node:fs';
|
|
2
|
+
import {resolve,join,dirname,relative,isAbsolute} from 'node:path';
|
|
3
|
+
import {randomUUID,createHash} from 'node:crypto';
|
|
4
|
+
import {id,hash,readJson,writeJson,integer,keys,text,texts} from './shared.mjs';
|
|
5
|
+
import {externalPath} from './settings.mjs';
|
|
6
|
+
import {locked,tasks,runtimeRoot} from './runtime.mjs';
|
|
7
|
+
import {assertIdle,executionSettled} from './lifecycle.mjs';
|
|
8
|
+
import {validateProject} from './project.mjs';
|
|
9
|
+
import {validateImage} from './images.mjs';
|
|
10
|
+
import {taskStatus} from './tasks.mjs';
|
|
11
|
+
|
|
12
|
+
import {STYLE_CATEGORIES,STYLE_SCHEMA_VERSION} from './style-contract.mjs';
|
|
13
|
+
export {STYLE_CATEGORIES} from './style-contract.mjs';
|
|
14
|
+
export const TASK_PURPOSES=['subject','composition','pose','identity-color','surface','scene-light','text'];
|
|
15
|
+
const now=()=>new Date().toISOString();
|
|
16
|
+
function styleConfig(config){
|
|
17
|
+
keys(config,['description','constraints','analysis'],'style config');
|
|
18
|
+
if(config.description!==undefined&&(typeof config.description!=='string'||config.description.length>2000))throw new Error('风格描述必须是2000字以内文本');
|
|
19
|
+
if(config.constraints!==undefined)texts(config.constraints,'constraints',{empty:true});
|
|
20
|
+
if(config.analysis!==undefined){keys(config.analysis,['provider','model'],'analysis');text(config.analysis.provider,'analysis.provider');text(config.analysis.model,'analysis.model');}
|
|
21
|
+
return structuredClone(config);
|
|
22
|
+
}
|
|
23
|
+
/** Resolve every existing ancestor: no user-controlled link may escape the project. */
|
|
24
|
+
export function ownedPath(root,...segments){
|
|
25
|
+
const base=externalPath(resolve(root)),path=resolve(base,...segments),rel=relative(base,path);
|
|
26
|
+
if(isAbsolute(rel)||rel==='..'||rel.startsWith('../')||rel.startsWith('..\\'))throw new Error('项目资源路径越界');
|
|
27
|
+
let current=base;
|
|
28
|
+
if(existsSync(base)&&lstatSync(base).isSymbolicLink())throw new Error('项目根不能为链接');
|
|
29
|
+
for(const segment of rel.split(/[\\/]/).filter(Boolean)){
|
|
30
|
+
current=join(current,segment);if(existsSync(current)&&lstatSync(current).isSymbolicLink())throw new Error('受管资源路径不能为链接');
|
|
31
|
+
}
|
|
32
|
+
return path;
|
|
33
|
+
}
|
|
34
|
+
export function objectDirectory(root,projectId,kind,objectId){
|
|
35
|
+
id(projectId,'project');id(objectId,kind);if(!['style','task'].includes(kind))throw new Error('对象类型非法');
|
|
36
|
+
return ownedPath(root,'projects',projectId,kind==='style'?'styles':'tasks',objectId);
|
|
37
|
+
}
|
|
38
|
+
export function objectFile(root,projectId,kind,objectId){return ownedPath(objectDirectory(root,projectId,kind,objectId),kind+'.json');}
|
|
39
|
+
export function readObject(root,projectId,kind,objectId){
|
|
40
|
+
if(existsSync(ownedPath(root,'.runtime/upgrades',id(projectId)+'.json')))throw new Error('工程升级事务未完成,请显式 project upgrade 恢复');
|
|
41
|
+
if(kind==='style'&&existsSync(ownedPath(objectDirectory(root,projectId,kind,objectId),'adoption.json')))throw new Error('风格采用事务未完成,请 style recover 后再操作');
|
|
42
|
+
const record=readJson(objectFile(root,projectId,kind,objectId));
|
|
43
|
+
if(record.schema!=='art-workshop/'+kind||record.schemaVersion!==2||record.project!==projectId||record.id!==objectId)throw new Error('对象身份或版本不匹配,请显式升级工程');
|
|
44
|
+
integer(record.revision,'revision',1);return record;
|
|
45
|
+
}
|
|
46
|
+
export function listObjects(root,projectId,kind){
|
|
47
|
+
const folder=ownedPath(root,'projects',id(projectId),kind==='style'?'styles':'tasks');
|
|
48
|
+
return existsSync(folder)?readdirSync(folder).filter(x=>existsSync(ownedPath(folder,x,kind+'.json'))).map(x=>readObject(root,projectId,kind,x)):[];
|
|
49
|
+
}
|
|
50
|
+
/** Read projection only: never rewrite old frozen evidence or reinterpret old references. */
|
|
51
|
+
export function styleView(root,record){
|
|
52
|
+
const pendingReferences=record.references.filter(ref=>!STYLE_CATEGORIES.includes(ref.category)).map(ref=>ref.id);
|
|
53
|
+
const reasons=[];
|
|
54
|
+
if(record.report&&record.report.data?.schemaVersion!==STYLE_SCHEMA_VERSION)reasons.push('旧分析报告职责版本已变化,请重新分析后采用。');
|
|
55
|
+
if(pendingReferences.length)reasons.push('旧参考分类已取消,请逐图指定当前风格分类;具体造型参考应导入任务。');
|
|
56
|
+
if(record.status==='frozen'){
|
|
57
|
+
const core=readJson(ownedPath(objectDirectory(root,record.project,'style',record.id),'core.json'));
|
|
58
|
+
if(core.schemaVersion!==STYLE_SCHEMA_VERSION)reasons.push('旧核心包含已取消的风格职能,请派生草稿、核对参考并重新分析采用;原核心与历史产物保留。');
|
|
59
|
+
}
|
|
60
|
+
return {...record,compatibility:{usable:reasons.length===0,pendingReferences,reasons}};
|
|
61
|
+
}
|
|
62
|
+
function objectRuns(settings,record){return tasks(runtimeRoot(settings)).map(t=>taskStatus(runtimeRoot(settings),t.taskId)).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));}
|
|
63
|
+
export async function mutateObject(settings,projectId,kind,objectId,revision,change,{allowFrozen=false}={}){
|
|
64
|
+
const file=objectFile(settings.paths.workspace,projectId,kind,objectId);
|
|
65
|
+
return locked(runtimeRoot(settings),'control',async()=>{
|
|
66
|
+
const before=readObject(settings.paths.workspace,projectId,kind,objectId);
|
|
67
|
+
if(['discarded','cleanup-required'].includes(before.status)&&!allowFrozen)throw new Error('对象已放弃或需要清理,不能继续编辑');
|
|
68
|
+
if(before.revision!==revision)throw new Error('对象版本冲突,请重新读取');
|
|
69
|
+
assertIdle(objectRuns(settings,before),kind==='style'?'风格':'任务');
|
|
70
|
+
if(kind==='style'&&before.status==='frozen'&&!allowFrozen)throw new Error('冻结风格只读,请派生新风格');
|
|
71
|
+
const after=await change(structuredClone(before));
|
|
72
|
+
if(after.id!==before.id||after.project!==before.project||after.schema!==before.schema||after.schemaVersion!==2)throw new Error('禁止修改对象身份');
|
|
73
|
+
if(hash(after)===hash(before))return before;
|
|
74
|
+
after.revision=before.revision+1;after.updatedAt=now();writeJson(file,after);return after;
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
export async function createObject(settings,projectId,kind,{name,config={},source=null}={}){
|
|
78
|
+
if(existsSync(ownedPath(settings.paths.workspace,'.runtime/upgrades',id(projectId)+'.json')))throw new Error('工程升级事务未完成,请显式 project upgrade 恢复');
|
|
79
|
+
const project=readJson(ownedPath(settings.paths.workspace,'projects',id(projectId),'project.json'));
|
|
80
|
+
if(project.schemaVersion!==2)throw new Error('工程需先显式升级');
|
|
81
|
+
if(typeof name!=='string'||!name.trim())throw new Error('对象名称不能为空');
|
|
82
|
+
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};
|
|
83
|
+
if(kind==='task'){if(!['generate','edit'].includes(config.kind))throw new Error('任务必须声明生成或编辑类型');record.config.project=projectId;}
|
|
84
|
+
const directory=objectDirectory(settings.paths.workspace,projectId,kind,objectId);
|
|
85
|
+
try{if(kind==='task')record.config=await importSources(settings,record,record.config);writeJson(objectFile(settings.paths.workspace,projectId,kind,objectId),record);return record;}
|
|
86
|
+
catch(error){if(existsSync(directory))rmSync(ownedPath(settings.paths.workspace,directory),{recursive:true,force:true});throw error;}
|
|
87
|
+
}
|
|
88
|
+
export function verifyReferences(root,record){
|
|
89
|
+
const directory=objectDirectory(root,record.project,record.schema.slice('art-workshop/'.length),record.id);
|
|
90
|
+
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};});
|
|
91
|
+
}
|
|
92
|
+
function imageExtension(buffer){
|
|
93
|
+
if(buffer.length>=24&&buffer.subarray(0,8).equals(Buffer.from([137,80,78,71,13,10,26,10])))return '.png';
|
|
94
|
+
if(buffer.length>=12&&buffer.subarray(0,4).toString()==='RIFF'&&buffer.subarray(8,12).toString()==='WEBP')return '.webp';
|
|
95
|
+
if(buffer.length>=4&&buffer[0]===255&&buffer[1]===216&&buffer.at(-2)===255&&buffer.at(-1)===217)return '.jpg';
|
|
96
|
+
throw new Error('只允许有效 PNG/JPEG/WebP 图片');
|
|
97
|
+
}
|
|
98
|
+
export async function importReference(settings,projectId,kind,objectId,revision,{source,category,purposes=[],usage='understand',note='',ignore=''}={}){
|
|
99
|
+
if(kind==='style'&&!STYLE_CATEGORIES.includes(category))throw new Error('风格参考分类非法');
|
|
100
|
+
if(kind==='task'&&(!purposes.length||purposes.some(p=>!TASK_PURPOSES.includes(p))))throw new Error('任务参考用途非法');
|
|
101
|
+
if(usage!=='understand')throw new Error('后端直接参考尚未完成用途约束适配');
|
|
102
|
+
const buffer=readFileSync(externalPath(source,'参考图片'));if(buffer.length>20*1024*1024)throw new Error('单图最大 20MB');
|
|
103
|
+
await validateImage(buffer);
|
|
104
|
+
const extension=imageExtension(buffer),referenceId='ref-'+randomUUID();
|
|
105
|
+
let created;
|
|
106
|
+
try{return await mutateObject(settings,projectId,kind,objectId,revision,record=>{
|
|
107
|
+
const directory=objectDirectory(settings.paths.workspace,projectId,kind,objectId),path=['refs',...(kind==='style'?[category]:[]),referenceId+extension].join('/');
|
|
108
|
+
const target=ownedPath(directory,path);mkdirSync(dirname(target),{recursive:true});writeFileSync(target,buffer,{flag:'wx'});created=target;
|
|
109
|
+
record.references.push({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});record.report=null;
|
|
110
|
+
return record;
|
|
111
|
+
});}catch(error){if(created)rmSync(created,{force:true});throw error;}
|
|
112
|
+
}
|
|
113
|
+
export async function updateObject(settings,projectId,kind,objectId,revision,{name,config}={}){
|
|
114
|
+
return mutateObject(settings,projectId,kind,objectId,revision,async 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,config):styleConfig(config);if(kind==='task')record.config.project=projectId;}if(hash(record.config)!==before)record.report=null;return record;});
|
|
115
|
+
}
|
|
116
|
+
export async function removeReference(settings,projectId,kind,objectId,revision,referenceId){
|
|
117
|
+
// Keep immutable snapshot resources. A later explicit object cleanup owns deletion.
|
|
118
|
+
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);record.report=null;return record;});
|
|
119
|
+
}
|
|
120
|
+
export async function updateReference(settings,projectId,kind,objectId,revision,referenceId,input){
|
|
121
|
+
keys(input,['category','purposes','note','ignore'],'参考配置');
|
|
122
|
+
let created;
|
|
123
|
+
try{return await mutateObject(settings,projectId,kind,objectId,revision,record=>{
|
|
124
|
+
verifyReferences(settings.paths.workspace,record);
|
|
125
|
+
const ref=record.references.find(ref=>ref.id===referenceId);if(!ref)throw new Error('参考不存在');
|
|
126
|
+
const before=hash(ref);
|
|
127
|
+
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];}
|
|
128
|
+
if(kind==='style'){
|
|
129
|
+
if(input.purposes!==undefined)throw new Error('风格参考不能配置任务用途');
|
|
130
|
+
if(input.category!==undefined){if(!STYLE_CATEGORIES.includes(input.category))throw new Error('风格参考分类非法');
|
|
131
|
+
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;}
|
|
132
|
+
}
|
|
133
|
+
}else{
|
|
134
|
+
if(input.category!==undefined)throw new Error('任务参考不能配置静态风格分类');
|
|
135
|
+
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)];}
|
|
136
|
+
}
|
|
137
|
+
if(hash(ref)!==before)record.report=null;
|
|
138
|
+
return record;
|
|
139
|
+
});}catch(error){if(created)rmSync(created,{force:true});throw error;}
|
|
140
|
+
}
|
|
141
|
+
export async function deriveObject(settings,projectId,kind,objectId,revision){
|
|
142
|
+
return locked(runtimeRoot(settings),'control',async()=>{
|
|
143
|
+
const source=readObject(settings.paths.workspace,projectId,kind,objectId);
|
|
144
|
+
if(['discarded','cleanup-required'].includes(source.status))throw new Error('对象不可派生');
|
|
145
|
+
assertIdle(objectRuns(settings,source));
|
|
146
|
+
if(source.revision!==revision)throw new Error('对象版本冲突');
|
|
147
|
+
verifyReferences(settings.paths.workspace,source);
|
|
148
|
+
const config=kind==='style'?{description:source.config.description??source.report?.data?.summary??'',constraints:source.config.constraints??[],...(source.config.analysis?{analysis:source.config.analysis}:{})}:source.config;
|
|
149
|
+
const derived=await createObject(settings,projectId,kind,{name:source.name+' · 派生',config,source:{id:source.id,revision:source.revision}});
|
|
150
|
+
try{
|
|
151
|
+
const directory=objectDirectory(settings.paths.workspace,projectId,kind,derived.id);
|
|
152
|
+
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});}
|
|
153
|
+
writeJson(objectFile(settings.paths.workspace,projectId,kind,derived.id),derived);return derived;
|
|
154
|
+
}catch(error){derived.status='cleanup-required';derived.error=error.message;writeJson(objectFile(settings.paths.workspace,projectId,kind,derived.id),derived);throw error;}
|
|
155
|
+
});
|
|
156
|
+
}
|
|
157
|
+
export async function discardObject(settings,projectId,kind,objectId,revision){
|
|
158
|
+
const directory=objectDirectory(settings.paths.workspace,projectId,kind,objectId);
|
|
159
|
+
return mutateObject(settings,projectId,kind,objectId,revision,record=>{
|
|
160
|
+
if(record.status==='frozen')throw new Error('正式风格不能作为草稿放弃');
|
|
161
|
+
// Executed artifacts are immutable evidence and are not draft trash.
|
|
162
|
+
if(kind==='task'&&objectRuns(settings,record).some(run=>run.plan))throw new Error('对象已有执行记录,不能作为草稿放弃');
|
|
163
|
+
if(record.status==='discarded'&&record.cleanup?.status==='completed')return record;
|
|
164
|
+
record.status='discarded';record.report=null;record.references=[];record.cleanup={status:'pending'};
|
|
165
|
+
// Mark and advance the revision before cleanup. Failed or interrupted deletion
|
|
166
|
+
// stays explicit and can be retried without reviving the draft.
|
|
167
|
+
writeJson(objectFile(settings.paths.workspace,projectId,kind,objectId),{...record,revision:record.revision+1,updatedAt:now()});
|
|
168
|
+
try{for(const folder of ['refs','sources']){const path=ownedPath(directory,folder);rmSync(path,{recursive:true,force:true});}record.cleanup={status:'completed'};}
|
|
169
|
+
catch(error){record.status='cleanup-required';record.cleanup={status:'failed',error:error.message};}
|
|
170
|
+
return record;
|
|
171
|
+
},{allowFrozen:true});
|
|
172
|
+
}
|
|
173
|
+
export function assertPlanCurrent(plan,settings){
|
|
174
|
+
const current=readObject(settings.paths.workspace,plan.project,'task',plan.job);
|
|
175
|
+
if(current.status==='discarded'||current.revision!==plan.sources.taskRevision||hash(current.config)!==plan.sources.taskConfigHash)throw new Error('计划来源已变化,请重新编译');
|
|
176
|
+
verifyReferences(settings.paths.workspace,current);
|
|
177
|
+
const project=readJson(ownedPath(settings.paths.workspace,'projects',plan.project,'project.json'));
|
|
178
|
+
if(hash(project)!==hash(plan.snapshots.project))throw new Error('工程默认配置已变化,请重新编译');
|
|
179
|
+
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('资产规格已变化,请重新编译');}
|
|
180
|
+
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('核心已变化,请重新编译');}
|
|
181
|
+
for(const ref of plan.refs){if(!existsSync(ref.path)||createHash('sha256').update(readFileSync(ref.path)).digest('hex')!==ref.hash)throw new Error('底图已变化,请重新编译');}
|
|
182
|
+
}
|
|
183
|
+
export function taskDisplayState(record,runs,finalizations=[]){
|
|
184
|
+
const own=runs.filter(r=>(r.plan?.project??r.project)===record.project&&(r.plan?.job===record.id||r.objectKind==='task'&&r.objectId===record.id));
|
|
185
|
+
if(own.some(run=>!executionSettled(run)))return {status:'执行中',issue:own.some(r=>r.status==='unknown'||r.unsettled)?'停止未确认':null};
|
|
186
|
+
const items=record.config.items??[],selected=new Set(finalizations.filter(f=>f.taskConfigHash===hash(record.config)).map(f=>f.assetId));
|
|
187
|
+
if(items.length&&items.every(i=>selected.has(i.id)))return {status:'已定版',issue:null};
|
|
188
|
+
const deleted=new Set((record.deletedCandidates??[]).map(c=>c.candidateId));
|
|
189
|
+
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}))))});
|
|
190
|
+
if(available)return {status:'待定版',issue:own.some(r=>r.status==='failed')?'部分执行失败':null};
|
|
191
|
+
return {status:'草稿',issue:own.some(r=>r.status==='failed')?'执行失败':null};
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
export async function createProject(settings,projectId,input){
|
|
195
|
+
id(projectId,'project');const file=ownedPath(settings.paths.workspace,'projects',projectId,'project.json');
|
|
196
|
+
const project=validateProject({...input,id:projectId,schemaVersion:2,revision:1,cores:[],defaultCore:null},projectId);
|
|
197
|
+
return locked(runtimeRoot(settings),'control',async()=>{if(existsSync(file))throw new Error('工程已存在,不能覆写');writeJson(file,project);return project;});
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
async function importSources(settings,record,config){
|
|
201
|
+
const result=structuredClone(config);if(result.kind!=='edit')return result;
|
|
202
|
+
const directory=objectDirectory(settings.paths.workspace,record.project,'task',record.id);
|
|
203
|
+
const created=[];
|
|
204
|
+
try{for(const item of result.items??[]){
|
|
205
|
+
if(!item.source)continue;
|
|
206
|
+
const original=externalPath(resolve(settings.paths.workspace,item.source),'编辑底图'),rel=relative(directory,original);
|
|
207
|
+
if(!isAbsolute(rel)&&rel.split(/[\\/]/)[0]==='sources'){ownedPath(directory,rel);await validateImage(readFileSync(original));item.source=relative(settings.paths.workspace,original).replaceAll('\\','/');continue;}
|
|
208
|
+
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('\\','/');
|
|
209
|
+
}
|
|
210
|
+
return result;}catch(error){for(const file of created)rmSync(ownedPath(directory,file),{force:true});throw error;}
|
|
211
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kevlns/art-workshop",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.1",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "美术工坊:统一风格的多工程图片生成与编辑工具",
|
|
6
6
|
"type": "module",
|
|
@@ -27,10 +27,11 @@
|
|
|
27
27
|
"pack:guard": "node scripts/pack-guard.mjs",
|
|
28
28
|
"check": "npm run docs:check && npm test && npm run pack:guard",
|
|
29
29
|
"test:package": "node scripts/test-package-install.mjs",
|
|
30
|
-
"docs:check": "node scripts/check-docs.mjs"
|
|
30
|
+
"docs:check": "node scripts/check-docs.mjs",
|
|
31
|
+
"docs:generate": "node scripts/command-docs.mjs"
|
|
31
32
|
},
|
|
32
33
|
"engines": {
|
|
33
|
-
"node": ">=20"
|
|
34
|
+
"node": ">=20.9"
|
|
34
35
|
},
|
|
35
36
|
"repository": {
|
|
36
37
|
"type": "git",
|
|
@@ -47,5 +48,10 @@
|
|
|
47
48
|
"author": "kevlns",
|
|
48
49
|
"vCli": {
|
|
49
50
|
"manifest": "v-cli.plugin.json"
|
|
51
|
+
},
|
|
52
|
+
"dependencies": {
|
|
53
|
+
"bailian-cli": "2.2.1",
|
|
54
|
+
"bailian-cli-core": "2.2.1",
|
|
55
|
+
"sharp": "^0.35.5"
|
|
50
56
|
}
|
|
51
57
|
}
|
package/rules/core-guidance.json
CHANGED
|
@@ -1,20 +1,21 @@
|
|
|
1
1
|
{
|
|
2
2
|
"principles": [
|
|
3
|
-
"
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
"
|
|
7
|
-
"
|
|
8
|
-
"
|
|
9
|
-
"
|
|
10
|
-
"
|
|
11
|
-
"
|
|
3
|
+
"风格只定义如何绘制,跨主体复用;不能冻结参考作品的具体内容。",
|
|
4
|
+
"具体轮廓、比例、结构、部件、姿态、数量、身份色、物理材质和光源方向由任务需求定义。",
|
|
5
|
+
"刻画密度只控制绘制繁简,不省略任务声明的结构、部件或文字。",
|
|
6
|
+
"高光是表现方式,不统一物体材质;笔触是绘画痕迹,不禁止需求中的鳞片、花纹或表面结构。",
|
|
7
|
+
"色彩规则描述饱和度、色相对比和阴影偏色;主体身份色与实际光照以任务声明为准。",
|
|
8
|
+
"背景、视角、构图、留白、裁切、文字和尺寸属于任务与资产规格。",
|
|
9
|
+
"分类决定观察焦点,不按图片主体或文件名推断;风格参考不配置任务用途。",
|
|
10
|
+
"区分观察、建议和未确定项,不从参考图片中的内容生成全局主题或题材白名单。",
|
|
11
|
+
"规则精炼且一致,模型、凭据、参数和运行状态不进入风格核心。",
|
|
12
|
+
"冻结可追溯,核心不可原地覆写;旧职责版本必须重新分析和明确采用。"
|
|
12
13
|
],
|
|
13
14
|
"ownership": {
|
|
14
|
-
"core": "
|
|
15
|
-
"
|
|
16
|
-
"
|
|
15
|
+
"core": "媒介、描绘细节、明暗方式、描边、高光画法、笔触、明度对比与色彩关系",
|
|
16
|
+
"brief": "主体、轮廓、比例、结构、部件、姿态、动作、数量、身份色、材质与光源",
|
|
17
|
+
"profile": "画幅、背景、视角、构图、留白、裁切、文字和投影要求",
|
|
17
18
|
"execution": "模型、像素尺寸、候选数量、seed、水印与扩写",
|
|
18
|
-
"edit": "
|
|
19
|
+
"edit": "明确的修改目标、保持目标和编辑底图,二者不得冲突"
|
|
19
20
|
}
|
|
20
21
|
}
|
|
@@ -1,74 +1,49 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: art-workshop
|
|
3
|
-
description:
|
|
3
|
+
description: 美术工坊风格、任务、参考、预演、执行与定版管理。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# art Agent 调用规范
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
用户既有授权与偏好持续有效;查询和预演不授权生成或采用。规范与实时参数通过 v-cli agent docs art 和 v-cli agent describe art --json 获取。
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## 对象与参考
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
工程必须使用 schemaVersion 2。project upgrade 是显式一次性升级,备份和原子替换;混合旧参考必须明确映射,日常读写无旧格式回退。
|
|
13
|
+
风格和任务都有稳定 id 与 revision。UI、聊天和 CLI 共用对象;写入、派生与清理提交预期 revision,冲突重新读取。正式风格只读,改动创建派生风格;派生不继承报告、核心、批次、授权与对话。
|
|
14
|
+
风格静态参考只有 style、palette、rendering,只分析媒介、描绘、明暗、描边、笔触和色彩关系。具体造型、比例、结构、部件、身份色、材质与光源属于任务。任务动态参考只有 subject、composition、pose、identity-color、surface、scene-light、text;编辑底图另列。导入复制原图,不修改用户文件。未适配直接参考时拒绝,不隐式上传风格图片。
|
|
13
15
|
|
|
14
|
-
|
|
15
|
-
|---|---|
|
|
16
|
-
| 远程生图 | 百炼真实入口及 bl auth status/config show;config validate;generate plan、run --dry |
|
|
17
|
-
| 远程编辑 | 远程检查加原图与 changes/preserve;edit plan、run --dry |
|
|
18
|
-
| 本地内置 | workflow list、config validate、doctor;generate plan、run --dry |
|
|
19
|
-
| 本地自定义 | API JSON/bindings、插件与模型、单张输出;config validate、doctor、plan、dry |
|
|
20
|
-
| 本地 Qwen 2.1 编辑 | 一张底图、image/vae 绑定与编码器、修改/保留不冲突;doctor、edit plan、dry |
|
|
21
|
-
| 分析与冻结 | 百炼 analysisModel、参考 scope;analyze --dry、报告 validate;用户采用后 freeze |
|
|
16
|
+
## 风格生命周期
|
|
22
17
|
|
|
23
|
-
|
|
18
|
+
style create/read/update/derive/discard 管理草稿。style analyze --dry 只读编译,不联网、启动服务或创建参考目录。实际 analyze 创建 taskId 与独立参考证据;task status/wait/cancel 控制执行,recover 查原登记,resume 仅恢复远程查询与取回。
|
|
19
|
+
报告绑定源配置、参考与模型。更新配置会清除当前报告,旧证据保留。style adopt 校验源版本、报告身份、冲突与未确定项,用户采用后冻结。采用中断通过 style recover 完成已授权事务,不能重新冻结另一份核心。
|
|
20
|
+
退出风格配置先继续编辑、保存草稿或放弃;分析停止未确认时不能清理。
|
|
24
21
|
|
|
25
|
-
##
|
|
22
|
+
## 计划与执行
|
|
26
23
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
# 服务未运行时可按配置启动后检测,不采样。
|
|
31
|
-
v-cli art doctor --backend local-qwen --start
|
|
32
|
-
v-cli art generate show --project P --job J
|
|
33
|
-
v-cli art generate plan --project P --job J --backend local-qwen --out .cache/plan.json
|
|
34
|
-
v-cli art generate run --plan .cache/plan.json --item ITEM --dry
|
|
35
|
-
v-cli art generate run --plan .cache/plan.json --item ITEM --background
|
|
36
|
-
```
|
|
24
|
+
先读取实际 job,再 generate/edit plan 和 run --plan --dry,展示有效核心、设计尺寸、预留缩放、请求与实际像素、模型后端、候选数量和编辑底图。后端尺寸由工具统一解析,超限或未对齐选最近合法尺寸,保留设计基准并明确实际值;不承诺显存或自动缩放导出。
|
|
25
|
+
授权覆盖方案后使用 run --background;前台同样创建执行身份。配置、核心、规格、参考、底图和后端变化拒绝旧方案,重新编译。重启查 taskId,不重复提交。不自动换模型或重跑成功项。
|
|
26
|
+
每个任务只能有一个未停止确认的执行;编辑、派生、删除与运行共用状态检查。切页面不取消。
|
|
37
27
|
|
|
38
|
-
|
|
28
|
+
## 取消、异常和关闭
|
|
39
29
|
|
|
40
|
-
|
|
30
|
+
任务状态与停止证据分开。queued/running/cancelling 仍占用资源;unknown 或 stopConfirmed=false 保留资源。failed/cancelled 也不能单凭状态释放资源;dispatching/accepted 远程回执尚未结清时继续占用。工作进程丢失标记 unknown,不推测停止。
|
|
31
|
+
task cancel 只取消指定运行,保留服务。远程取消只停止本地客户端,上游停止未知如实报告,不允许清理。shutdown 阻止提交、停止关联任务、核验共享队列和进程身份后关闭本地服务,不清空共享队列;有其他任务或停止未确认时保留服务。不得广泛杀所有 Python。
|
|
41
32
|
|
|
42
|
-
|
|
33
|
+
## 生成与定版
|
|
43
34
|
|
|
44
|
-
|
|
35
|
+
只有生成与定版两个产品阶段。check 验证计划、执行身份、文件哈希和完成事实;不要求人工 content/style/asset 评分。candidate finalize 按资产选定候选,重复操作幂等;替换已有定版需要明确 replace,保留历史。
|
|
36
|
+
candidate delete 先确认影响,拒绝运行中或被计划/底图引用的候选;先记删除事实,清理所属文件,并取消关联定版。定版不自动导入游戏或提交 Git。
|
|
45
37
|
|
|
46
|
-
|
|
38
|
+
## 验证和技能
|
|
47
39
|
|
|
48
|
-
|
|
40
|
+
本地先 config validate、doctor、plan/dry,再按授权真实生成与编辑。配置有效、服务可连接与真实出图是不同证据。远程核对实际认证和模型入口;凭证不得写入项目、计划、日志或命令行。
|
|
41
|
+
随包 skills/art-workshop 是技能源;通过 agent init 或 skill:sync 同步,保留项目扩展。查询和预演不自动同步。源码/单测/mock 不能代替真实模型、图像、桌面与安装验证。
|
|
49
42
|
|
|
50
|
-
|
|
43
|
+
任务动态参考先 `job analyze`,缺失、过期或职责越界的观察不能进入生成预案。分析与生成共用任务占用与停止确认。启动回执丢失只能 `task recover --project P --operation ID` 查询唯一原登记;没有唯一证据时保持未知,不能重发生成。
|
|
51
44
|
|
|
52
|
-
|
|
45
|
+
模型、参数及支持状态只在 art 工具 model-catalog/model-registry 内维护,界面与 v-cli 不复制型号判断。远程图片由已注册协议适配器直接调用;视觉分析连接独立,未注入时使用百炼 CLI。Token Plan 是渠道,DashScope 是协议,不跨站点回退凭据。
|
|
53
46
|
|
|
54
|
-
|
|
55
|
-
v-cli art task status TASK
|
|
56
|
-
v-cli art task wait TASK --timeout 60
|
|
57
|
-
v-cli art task cancel TASK
|
|
58
|
-
v-cli art shutdown
|
|
59
|
-
v-cli art check RUN --out .cache/review.json
|
|
60
|
-
```
|
|
47
|
+
远端上游身份持久化后才能轮询。`task resume TASK` 只恢复原身份查询与取回,不重发生成;无回执或仍处于 dispatching 的提交保持未知。界面与保存共用 modelEligibility,展示字段不进入执行契约。
|
|
61
48
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
失败读取 task status 的 diagnostic、error、manifest 与日志:环境/提交/执行阶段、workflow/backend、节点和原始错误、修复提示。failed/lost 不证明后端停止,unsettled 必须如实报告。不得擅自换模型、后端或设计尺寸;修复后重新 plan/dry。
|
|
65
|
-
|
|
66
|
-
check 只核对完整性并汇总 content/style/asset 人工验收;全部 pass 才可 select。环境检查、mock 测试、模型输出都不等于实际图像或生产资产通过。
|
|
67
|
-
|
|
68
|
-
## 路径与副作用
|
|
69
|
-
|
|
70
|
-
资源放在安装目录之外。相对 input/report/plan/out/review/source 基于 workspace,RUN 基于 output,参考图基于实际 refs,workflow/launch 路径基于配置目录。目录覆盖建议绝对路径。
|
|
71
|
-
|
|
72
|
-
plan/dry 不联网、启动服务、上传或采样;普通 CLI 仍可补 refs 分类,plan --out 写计划。config validate/doctor/workflow list 不补 refs;doctor --start 可启动并保留服务。检测通过不保证权重加载、显存或效果。
|
|
73
|
-
|
|
74
|
-
用 refs guide 查实际分类;输入显式指定参考 path/scope/note。随包 SKILL.md 是源,agent init 同步到已有技能目录并保留扩展,不写工作区 AGENTS.md;避免直接改同步副本。
|
|
49
|
+
风格报告和核心职责版本 schemaVersion=2;不再包含 shape、lighting、domains,不限定主体题材。旧核心保留,只能派生后重新分析采用;旧分类参考必须明确重新分类,不能猜测搬到任务或渲染。低刻画密度不删任务结构,干净笔触不禁止物体纹理,高光画法不统一物理材质。
|