@kevlns/art-workshop 0.4.1 → 0.4.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.
- package/AGENTS.md +1 -1
- package/art-workshop.mjs +2 -2
- package/docs/commands.md +1 -0
- package/lib/candidates.mjs +18 -5
- package/package.json +1 -1
- package/skills/art-workshop/SKILL.md +1 -1
- package/v-cli.plugin.json +4 -0
package/AGENTS.md
CHANGED
|
@@ -59,7 +59,7 @@ task cancel 只取消指定运行,保留服务。生成任务远程取消只
|
|
|
59
59
|
|
|
60
60
|
编辑 target 是范围名称,允许 outline 等具体范围;同一范围可修改局部并保留其他特征,不能仅按标签重叠判矛盾。配置和预案仍校验字段、引用、版本及核心风格归属。
|
|
61
61
|
|
|
62
|
-
只有生成与定版两个产品阶段。check 验证计划、执行身份、文件哈希和完成事实;不要求人工 content/style/asset 评分。candidate finalize
|
|
62
|
+
只有生成与定版两个产品阶段。check 验证计划、执行身份、文件哈希和完成事实;不要求人工 content/style/asset 评分。candidate finalize 按资产选定候选,并把图片复制到美术仓库 VantArtForge。导出名称可空,空名称使用 vant-gen-任务-资产-批次。同一候选且同一导出名重复操作幂等;替换已有定版需要明确 replace,保留历史。导出文件名不能包含路径。
|
|
63
63
|
候选 editable 与 accepted 分开:已停止批次中保留的有效图片可作为编辑底图,输出处理失败不阻止继续编辑;已记录的哈希不匹配、文件缺失或已删除则拒绝。job from-candidate 验证图片可解码后复制为独立编辑草稿的私有底图并记录来源,不改变原批次失败事实,也不授权定版或启动生成。
|
|
64
64
|
candidate favorite 使用 --value true/false 收藏或取消收藏,candidate favorites 查看工程收藏。收藏记录独立保存在工程 favorites.json,绑定源任务、批次和图片身份,不修改需求版本、执行或定版状态;可收藏有效的失败保留图。列表隐藏已删除、丢失或所属任务已归档的图片,源任务改名即时反映。
|
|
65
65
|
candidate delete 先确认影响,拒绝运行中或被计划/底图引用的候选;先记删除事实,清理所属文件,并取消关联定版。定版不自动导入游戏或提交 Git。
|
package/art-workshop.mjs
CHANGED
|
@@ -31,7 +31,7 @@ const {deploymentGuide}=await import('./lib/deployment-guide.mjs');
|
|
|
31
31
|
const {inspectInstallation,discoverInstallations}=await import('./lib/environments.mjs');
|
|
32
32
|
const {verifyInstallation,registerInstallation,unregisterInstallation}=await import('./lib/environment-operations.mjs');
|
|
33
33
|
const flags=new Set(['dry','explore','background','start','replace','confirm','all-variants']);
|
|
34
|
-
const allowed=new Set(['config','workspace','output-dir','refs-dir','cache-dir','directory','endpoint','guide','project','input','out','report','note','core','job','plan','item','variant','offset','limit','file','backend','timeout','kind','id','revision','source','category','purposes','mapping','run','candidate','actor','operation','retry-run','item-id','value',...flags]);
|
|
34
|
+
const allowed=new Set(['config','workspace','output-dir','refs-dir','cache-dir','directory','endpoint','guide','project','input','out','report','note','core','job','plan','item','variant','offset','limit','file','backend','timeout','kind','id','revision','source','category','purposes','mapping','run','candidate','actor','operation','retry-run','item-id','value','name',...flags]);
|
|
35
35
|
for(let i=0;i<args.length;i++){if(args[i].startsWith('--')){const k=args[i].slice(2);if(!allowed.has(k)||k in options) throw new Error('未知或重复参数 '+k);options[k]=flags.has(k)?true:args[++i];if(options[k]===undefined) throw new Error('参数缺少值 '+k);}else pos.push(args[i]);}
|
|
36
36
|
const print=x=>console.log(JSON.stringify(x?.schema==='art-workshop/style'?styleView(settings.paths.workspace,x):x,null,2));
|
|
37
37
|
if(pos[0]==='workflow'&&pos[1]==='list'){print(workflowList());process.exit(0);}
|
|
@@ -155,7 +155,7 @@ try {
|
|
|
155
155
|
print(await setFavorite(settings,projectId,required('job'),{runId:required('run'),candidateId:required('candidate'),value:options.value==='true'}));
|
|
156
156
|
}
|
|
157
157
|
else if(action==='list')print(candidates(settings,projectId,required('job'),required('run')));
|
|
158
|
-
else if(action==='finalize')print(await finalize(settings,projectId,required('job'),Number(required('revision')),{runId:required('run'),candidateId:required('candidate'),replace:options.replace,actor:required('actor')}));
|
|
158
|
+
else if(action==='finalize')print(await finalize(settings,projectId,required('job'),Number(required('revision')),{runId:required('run'),candidateId:required('candidate'),replace:options.replace,actor:required('actor'),name:options.name}));
|
|
159
159
|
else if(action==='delete')print(await deleteCandidate(settings,projectId,required('job'),Number(required('revision')),{runId:required('run'),candidateId:required('candidate'),confirm:options.confirm,actor:required('actor')}));
|
|
160
160
|
else if(action==='finalizations')print(finalizations(settings,projectId,required('job')));
|
|
161
161
|
else throw new Error('未知 candidate 操作');
|
package/docs/commands.md
CHANGED
package/lib/candidates.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import {readFileSync,rmSync} from 'node:fs';
|
|
2
|
-
import {join,resolve} from 'node:path';
|
|
1
|
+
import {copyFileSync,existsSync,mkdirSync,readFileSync,rmSync} from 'node:fs';
|
|
2
|
+
import {dirname,extname,join,resolve} from 'node:path';
|
|
3
3
|
import {hash,readJson,writeJson,text} from './shared.mjs';
|
|
4
4
|
import {ownedPath,readObject,objectDirectory,mutateObject,listObjects,createObject} from './workspace.mjs';
|
|
5
5
|
import {validateImage} from './images.mjs';
|
|
@@ -37,7 +37,18 @@ export function candidates(settings,projectId,taskId,runTaskId){
|
|
|
37
37
|
});
|
|
38
38
|
}
|
|
39
39
|
export function finalizations(settings,projectId,taskId){return readObject(settings.paths.workspace,projectId,'task',taskId).finalizations??[];}
|
|
40
|
-
|
|
40
|
+
function exportBaseName(taskId,assetId,runId,name){
|
|
41
|
+
const custom=typeof name==='string'?name.trim().replace(/\.(png|jpeg|jpg|webp)$/i,''):'';
|
|
42
|
+
const base=custom||`vant-gen-${taskId}-${assetId}-${runId}`;
|
|
43
|
+
if(!base||base.length>220||/[\\/:*?"<>|\u0000-\u001f]/.test(base)||base.endsWith('.')||base==='.'||base==='..'||/^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i.test(base))throw new Error('导出名称不能包含路径或系统保留字符');
|
|
44
|
+
return base;
|
|
45
|
+
}
|
|
46
|
+
function publishExport(settings,candidate,filename,previousExportPath){
|
|
47
|
+
const target=ownedPath(settings.paths.workspace,'VantArtForge',filename),exportPath='VantArtForge/'+filename;
|
|
48
|
+
if(existsSync(target)&&previousExportPath!==exportPath&&sha256File(target)!==candidate.hash)throw new Error('导出名称已被其他定版占用');
|
|
49
|
+
mkdirSync(dirname(target),{recursive:true});copyFileSync(candidate.path,target);return exportPath;
|
|
50
|
+
}
|
|
51
|
+
export async function finalize(settings,projectId,taskId,revision,{runId,candidateId,replace=false,actor,name}={}){
|
|
41
52
|
text(actor,'操作者');
|
|
42
53
|
// Mutation lock covers integrity checks, current selection and commit together.
|
|
43
54
|
return mutateObject(settings,projectId,'task',taskId,revision,async record=>{
|
|
@@ -49,11 +60,13 @@ export async function finalize(settings,projectId,taskId,revision,{runId,candida
|
|
|
49
60
|
const expected=(item?.execution??run.plan.execution).size.split('*').map(Number);
|
|
50
61
|
if(info.width!==expected[0]||info.height!==expected[1])throw new Error('候选尺寸与冻结计划不符');
|
|
51
62
|
const previous=(record.finalizations??[]).find(f=>f.assetId===candidate.itemId);
|
|
52
|
-
|
|
63
|
+
const base=exportBaseName(taskId,candidate.itemId,runId,name),filename=base+(extname(candidate.path).toLowerCase()||'.png'),exportPath='VantArtForge/'+filename;
|
|
64
|
+
if(previous?.candidateId===candidateId&&previous.exportPath===exportPath)return record;
|
|
53
65
|
if(previous&&!replace)throw new Error('该资产已有定版,请明确确认替换');
|
|
54
66
|
record.finalizationHistory??=[];if(previous)record.finalizationHistory.push({...previous,replacedAt:new Date().toISOString()});
|
|
55
67
|
if(run.plan.sources.taskConfigHash!==hash(record.config))throw new Error('候选对应的需求配置已变化,请选择匹配当前配置的批次');
|
|
56
|
-
const
|
|
68
|
+
const written=publishExport(settings,candidate,filename,previous?.exportPath);
|
|
69
|
+
const selection={taskConfigHash:run.plan.sources.taskConfigHash,assetId:candidate.itemId,runId,candidateId,path:candidate.path,hash:sha256File(candidate.path),exportName:base,exportPath:written,actor,createdAt:new Date().toISOString(),revision:record.revision+1};
|
|
57
70
|
record.finalizations=[...(record.finalizations??[]).filter(f=>f.assetId!==candidate.itemId),selection];
|
|
58
71
|
return record;
|
|
59
72
|
});
|
package/package.json
CHANGED
|
@@ -66,7 +66,7 @@ task cancel 只取消指定运行,保留服务。生成任务远程取消只
|
|
|
66
66
|
|
|
67
67
|
编辑 target 是范围名称,允许 outline 等具体范围;同一范围可修改局部并保留其他特征,不能仅按标签重叠判矛盾。配置和预案仍校验字段、引用、版本及核心风格归属。
|
|
68
68
|
|
|
69
|
-
只有生成与定版两个产品阶段。check 验证计划、执行身份、文件哈希和完成事实;不要求人工 content/style/asset 评分。candidate finalize
|
|
69
|
+
只有生成与定版两个产品阶段。check 验证计划、执行身份、文件哈希和完成事实;不要求人工 content/style/asset 评分。candidate finalize 按资产选定候选,并把图片复制到美术仓库 VantArtForge。导出名称可空,空名称使用 vant-gen-任务-资产-批次。同一候选且同一导出名重复操作幂等;替换已有定版需要明确 replace,保留历史。导出文件名不能包含路径。
|
|
70
70
|
候选 editable 与 accepted 分开:已停止批次中保留的有效图片可作为编辑底图,输出处理失败不阻止继续编辑;已记录的哈希不匹配、文件缺失或已删除则拒绝。job from-candidate 验证图片可解码后复制为独立编辑草稿的私有底图并记录来源,不改变原批次失败事实,也不授权定版或启动生成。
|
|
71
71
|
candidate favorite 使用 --value true/false 收藏或取消收藏,candidate favorites 查看工程收藏。收藏记录独立保存在工程 favorites.json,绑定源任务、批次和图片身份,不修改需求版本、执行或定版状态;可收藏有效的失败保留图。列表隐藏已删除、丢失或所属任务已归档的图片,源任务改名即时反映。
|
|
72
72
|
candidate delete 先确认影响,拒绝运行中或被计划/底图引用的候选;先记删除事实,清理所属文件,并取消关联定版。定版不自动导入游戏或提交 Git。
|
package/v-cli.plugin.json
CHANGED