@kevlns/art-workshop 0.6.6 → 0.6.8
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/docs/channels.md +1 -1
- package/docs/commands.md +1 -1
- package/lib/adapters/dashscope.mjs +1 -1
- package/lib/adapters/openai-images.mjs +1 -1
- package/lib/images.mjs +1 -1
- package/lib/spine/capture.mjs +2 -8
- package/lib/spine.mjs +3 -2
- package/lib/video/service.mjs +1 -1
- package/package.json +1 -1
- package/skills/art-workshop/SKILL.md +5 -3
- package/skills/art-workshop/references/conversation.md +1 -1
- package/skills/art-workshop/references/expression.md +2 -2
- package/skills/art-workshop/references/getty.md +2 -2
- package/skills/vant-spine-production/SKILL.md +5 -5
- package/skills/vant-spine-production/references/art-parts.md +6 -0
- package/skills/vant-spine-production/references/delivery.md +2 -2
- package/skills/vant-spine-production/references/rig-motion.md +3 -3
- package/v-cli.plugin.json +1 -1
package/docs/channels.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
- 图片使用 `v-cli art image` 或 `art-workshop image` 管理风格、参考和制作任务。
|
|
8
8
|
- 视频使用 `v-cli art video` 或 `art-workshop video`。传入工程根目录和工程内请求文件,按任务身份保存剧本、镜头、运行记录和成片。
|
|
9
|
-
- Spine 使用 `v-cli art spine` 或 `art-workshop spine`。`describe` 返回配方,`parts` 从原型生成可配准的部件,`build` 导出骨架与动作索引,`capture` 实绘指定动作并输出 PNG
|
|
9
|
+
- Spine 使用 `v-cli art spine` 或 `art-workshop spine`。`describe` 返回配方,`parts` 从原型生成可配准的部件,`build` 导出骨架与动作索引,`capture` 实绘指定动作并输出 PNG 和对照图。SDK 入口为 `@kevlns/art-workshop/spine` 的 `spineContract` 与 `runSpine(root, action, input)`。
|
|
10
10
|
|
|
11
11
|
完整选项见[命令参考](commands.md)。
|
|
12
12
|
|
package/docs/commands.md
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
import { buildSources, resolveApiKey } from "bailian-cli-core";
|
|
2
2
|
import { readFile } from "node:fs/promises";
|
|
3
|
-
import sharp from "sharp";
|
|
4
3
|
import { compileRemoteRequest } from "../generation-policy.mjs";
|
|
5
4
|
import { resolveModel } from "../model-registry.mjs";
|
|
6
5
|
import { requestJson, RemoteError } from "../transport/http.mjs";
|
|
@@ -102,6 +101,7 @@ async function inputImage(path, policy) {
|
|
|
102
101
|
const buffer = await readFile(path);
|
|
103
102
|
if (buffer.length > policy.maxBytes)
|
|
104
103
|
throw new Error("输入图片超过模型文件大小限制");
|
|
104
|
+
const { default: sharp } = await import("sharp");
|
|
105
105
|
const info = await sharp(buffer, {
|
|
106
106
|
limitInputPixels: 64 * 1024 * 1024,
|
|
107
107
|
}).metadata();
|
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
import {readFile,stat} from 'node:fs/promises';
|
|
2
|
-
import sharp from 'sharp';
|
|
3
2
|
import {RemoteError,requestJson} from '../transport/http.mjs';
|
|
4
3
|
|
|
5
4
|
function fields(request) {
|
|
@@ -23,6 +22,7 @@ export const openaiImagesAdapter = {
|
|
|
23
22
|
const headers={Authorization:'Bearer '+key};
|
|
24
23
|
let body=fields(request);
|
|
25
24
|
if(request.images.length) {
|
|
25
|
+
const {default:sharp} = await import('sharp');
|
|
26
26
|
const form=new FormData();
|
|
27
27
|
for(const [field,value] of Object.entries(body)) form.set(field,String(value));
|
|
28
28
|
for(const [index,file] of request.images.entries()) {
|
package/lib/images.mjs
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import sharp from 'sharp';
|
|
2
1
|
export async function validateImage(buffer){
|
|
3
2
|
if(!Buffer.isBuffer(buffer)||buffer.length>20*1024*1024)throw new Error('单张图片最大 20MB');
|
|
4
3
|
try{
|
|
4
|
+
const {default:sharp} = await import('sharp');
|
|
5
5
|
const pipeline=sharp(buffer,{limitInputPixels:64*1024*1024,failOn:'warning'}),metadata=await pipeline.metadata();
|
|
6
6
|
if(!['png','jpeg','webp'].includes(metadata.format)||!metadata.width||!metadata.height||metadata.pages>1)throw new Error('只支持单帧 PNG/JPEG/WebP');
|
|
7
7
|
await pipeline.resize(1,1).raw().toBuffer();
|
package/lib/spine/capture.mjs
CHANGED
|
@@ -3,7 +3,6 @@ import {dirname,join} from 'node:path';
|
|
|
3
3
|
import {fileURLToPath} from 'node:url';
|
|
4
4
|
import {readFile,writeFile} from 'node:fs/promises';
|
|
5
5
|
import {TextureAtlas} from '@esotericsoftware/spine-webgl';
|
|
6
|
-
import sharp from 'sharp';
|
|
7
6
|
import {projectPath} from '../video/path.mjs';
|
|
8
7
|
import {sheet} from './parts.mjs';
|
|
9
8
|
|
|
@@ -65,19 +64,14 @@ export async function captureFrames(root,recipe,out) {
|
|
|
65
64
|
},{rig,atlas,textures,clip,width,height});
|
|
66
65
|
const times=recipe.times ?? Array.from({length:frames},(_,i)=>duration*i/frames);
|
|
67
66
|
if(!Array.isArray(times)||!times.length||times.length>120||width*height*times.length>32e6||times.some(t=>!Number.isFinite(t)||t<0||t>duration+1e-5)) throw Error('时间点必须位于动作时长内');
|
|
68
|
-
const columns=Math.ceil(Math.sqrt(times.length)),layers=[],
|
|
67
|
+
const columns=Math.ceil(Math.sqrt(times.length)),layers=[],files=[];
|
|
69
68
|
for(const [i,time] of times.entries()) {
|
|
70
69
|
const png=Buffer.from(await page.evaluate(t=>window.renderFrame(t),time),'base64');
|
|
71
70
|
const name='frame-'+String(i+1).padStart(3,'0')+'.png';
|
|
72
71
|
await writeFile(join(out,name),png);files.push(name);
|
|
73
72
|
layers.push({input:png,left:i%columns*width,top:Math.floor(i/columns)*height});
|
|
74
|
-
if(recipe.gif) raw.push(await sharp(png).ensureAlpha().raw().toBuffer());
|
|
75
73
|
}
|
|
76
74
|
await sheet(width*columns,height*Math.ceil(times.length/columns)).composite(layers).png().toFile(join(out,'comparison.png'));
|
|
77
|
-
|
|
78
|
-
const delay=times.map((t,i)=>Math.max(20,Math.round(1000*((times[i+1]??duration)-t))));
|
|
79
|
-
await sharp(Buffer.concat(raw),{raw:{width,height:height*raw.length,channels:4,pageHeight:height}}).gif({delay,loop:0}).toFile(join(out,'preview.gif'));
|
|
80
|
-
}
|
|
81
|
-
return {clip,duration,width,height,times,files,comparison:'comparison.png',...(recipe.gif?{gif:'preview.gif'}:{})};
|
|
75
|
+
return {clip,duration,width,height,times,files,comparison:'comparison.png'};
|
|
82
76
|
} finally {await browser.close();}
|
|
83
77
|
}
|
package/lib/spine.mjs
CHANGED
|
@@ -6,13 +6,14 @@ import {buildRig} from './spine/build.mjs';
|
|
|
6
6
|
|
|
7
7
|
export const spineContract={
|
|
8
8
|
parts:{input:{sourceImage:'art/prototype.png',out:'work/parts-01',parts:[{name:'body',rect:{left:0,top:0,width:100,height:100},pivot:[50,75],occludedBy:[]}]},optional:'parts 的顺序为从后到前。mask 取透明通道或灰度,可传母版大小或局部大小。replacement 接受同比例补绘图。',outputs:['parts.json','images/','assembled.png']},
|
|
9
|
-
build:{input:{parts:'work/parts-01/parts.json',name:'actor',out:'work/rig-01',animations:{wave_001:{bones:{body:{rotate:[{time:0,value:0},{time:0.5,value:22}]}}}}},meshExample:{slot:'body',uvs:[0,0,1,0,0,1],triangles:[0,1,2],points:[[['body',-50,75,1]],[['body',50,75,1]],[['body',-50,-25,1]]]},optional:'bones 按名增改骨骼;meshes 为网格配方列表,points 每项含 [骨名,骨局部x,y,正权重],权重和为1。rig 可指定可编辑的 Spine 4.2 JSON,保留其骨骼、皮肤、约束、网格、权重及时间线;animations 按动作名合并。未传 rig 时使用 parts 中的轴心建立绑定。',outputs:['骨架 JSON','atlas','PNG 图集','images/','animations.json','report.json']},
|
|
10
|
-
capture:{input:{source:'work/rig-01/actor.json',out:'work/frames-01',clip:'wave_001',width:384,height:384,frames:8
|
|
9
|
+
build:{input:{parts:'work/parts-01/parts.json',name:'actor',out:'work/rig-01',animations:{wave_001:{bones:{body:{rotate:[{time:0,value:0},{time:0.5,value:22}]}}}}},meshExample:{slot:'body',uvs:[0,0,1,0,0,1],triangles:[0,1,2],points:[[['body',-50,75,1]],[['body',50,75,1]],[['body',-50,-25,1]]]},optional:'parts 必填,指向含部件图像定位的 parts.json,编辑已有 rig 也需要它来重建图集。bones 按名增改骨骼;meshes 为网格配方列表,points 每项含 [骨名,骨局部x,y,正权重],权重和为1。rig 可指定可编辑的 Spine 4.2 JSON,保留其骨骼、皮肤、约束、网格、权重及时间线;animations 按动作名合并。未传 rig 时使用 parts 中的轴心建立绑定。',outputs:['骨架 JSON','atlas','PNG 图集','images/','animations.json','report.json']},
|
|
10
|
+
capture:{input:{source:'work/rig-01/actor.json',out:'work/frames-01',clip:'wave_001',width:384,height:384,frames:8},optional:'times 可直接指定秒数。无头 Chromium 使用 Spine WebGL 4.2 捕获实际像素。',outputs:['逐帧 PNG','comparison.png','capture.json']}
|
|
11
11
|
};
|
|
12
12
|
export async function runSpine(root,action,input) {
|
|
13
13
|
if(action==='describe')return spineContract;
|
|
14
14
|
if(!Object.hasOwn(spineContract,action))throw Error('未知 Spine 操作:'+action);
|
|
15
15
|
if(typeof input?.out!=='string'||!input.out.trim()) throw Error('指定新的项目内输出目录 out');
|
|
16
|
+
if(action==='build' && !input.parts) throw Error('Spine build 缺少 parts,请指定拆件清单 parts.json');
|
|
16
17
|
const target=await projectPath(root,input.out);
|
|
17
18
|
if(await lstat(target).then(()=>true,e=>{if(e.code!=='ENOENT')throw e;return false;}))throw Error('输出目录已存在,请为本次结果选择新目录');
|
|
18
19
|
await mkdir(dirname(target),{recursive:true});
|
package/lib/video/service.mjs
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
import {assertLocalEndpoint} from './local-runtime.mjs';
|
|
2
2
|
import { atomicJson, atomicWrite, replaceFile } from "./atomic.mjs";
|
|
3
|
-
import sharp from "sharp";
|
|
4
3
|
import { createWriteStream, fstatSync } from "node:fs";
|
|
5
4
|
import { Readable, Transform } from "node:stream";
|
|
6
5
|
import { pipeline } from "node:stream/promises";
|
|
@@ -359,6 +358,7 @@ class VideoService {
|
|
|
359
358
|
throw new Error("图片限 20MB");
|
|
360
359
|
const mime = bytes.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10])) ? "image/png" : bytes[0] === 255 && bytes[1] === 216 ? "image/jpeg" : bytes.toString("ascii", 0, 4) === "RIFF" && bytes.toString("ascii", 8, 12) === "WEBP" ? "image/webp" : "";
|
|
361
360
|
if (!mime) throw new Error("仅支持 PNG、JPEG、WebP 图片");
|
|
361
|
+
const { default: sharp } = await import("sharp");
|
|
362
362
|
const decoder = sharp(bytes, {
|
|
363
363
|
limitInputPixels: 32 * 1024 * 1024,
|
|
364
364
|
failOn: "error"
|
package/package.json
CHANGED
|
@@ -5,6 +5,8 @@ description: "处理图片、视频和 Spine 制作:图片讨论、风格、
|
|
|
5
5
|
|
|
6
6
|
# 美术工坊
|
|
7
7
|
|
|
8
|
+
在 Vant 会话的 shell 中,示例里的 `v-cli` 代表插件入口:PowerShell 写作 `node "$env:DSH_VANT_CLI"`,sh 写作 `node "$DSH_VANT_CLI"`。
|
|
9
|
+
|
|
8
10
|
制作、调整或交付 2D Spine 角色时,查阅同包技能 `vant-spine-production`,按当前阶段选择原型、拆件、绑定、动作或导出指导。在 Vant 中,用户要求将已确认的正式作品入美术仓或接入游戏时,接续工作台技能 `vant-asset-intake`。
|
|
9
11
|
|
|
10
12
|
按制作对象选择 `image`、`video` 或 `spine`。图片沿用下述会话与项目管线;视频参阅[视频通道](references/video.md),骨骼动画参阅[Spine 制作指南](../vant-spine-production/SKILL.md)。
|
|
@@ -13,9 +15,9 @@ description: "处理图片、视频和 Spine 制作:图片讨论、风格、
|
|
|
13
15
|
|
|
14
16
|
以用户意图为主线,让表达更清楚、专业、便于执行,允许贴合原意的适度补充。留意补充是否改变了用户的方向、程度或选择空间,尤其不要将倾向升级成硬性禁令。看图分析可以提炼可见特征;影响不大的合理细化直接处理,实质性的新设计取舍再提出建议或询问。
|
|
15
17
|
|
|
16
|
-
- 整理或回填美术表述前读取 [表达规范](references/expression.md),本会话已掌握时直接沿用。需要 Getty 核实时,先从中文意图提炼英文专业词,在一个批次中通过
|
|
18
|
+
- 整理或回填美术表述前读取 [表达规范](references/expression.md),本会话已掌握时直接沿用。需要 Getty 核实时,先从中文意图提炼英文专业词,在一个批次中通过 vant_art_getty 查询,再按原始上下文校验候选;失败或无匹配保留原表达,不阻塞其他内容,不重试或另找调用路径。
|
|
17
19
|
- 参考图风格讨论、分析并填写风格草稿,读取 [风格讨论与回填](references/style-discussion.md)。
|
|
18
|
-
- 会话探索、新图及修改上一轮产物,读取 [会话管线](references/conversation.md),使用
|
|
19
|
-
- 已有项目任务、可编辑风格规则、打样与样张定版和正式资产交付,读取 [项目管线](references/project.md),使用
|
|
20
|
+
- 会话探索、新图及修改上一轮产物,读取 [会话管线](references/conversation.md),使用 vant_art_conversation。
|
|
21
|
+
- 已有项目任务、可编辑风格规则、打样与样张定版和正式资产交付,读取 [项目管线](references/project.md),使用 vant_art。
|
|
20
22
|
|
|
21
23
|
同一请求只提交一次;重复调用复用请求身份。未知状态仅查询原运行,禁止更换身份重投。状态查询按工具返回的 wait/状态约束进行;到达等待上限就结束本轮并保留可恢复身份,不用修改需求或新建任务绕过失败。只有用户明确修改目标或请求新一轮生成时才创建新请求。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 会话美术管线
|
|
2
2
|
|
|
3
|
-
使用
|
|
3
|
+
使用 vant_art_conversation describe 获取当前输入契约。只讨论时自然答复,不执行生成。
|
|
4
4
|
|
|
5
5
|
一次 generate 或 edit 请求绑定 requestId;相同 requestId 重复调用只返回原运行,不重发。已有产物通过 attachmentId 指定;编辑必须明确底图,引用可以分别指定主体、配色、构图、风格等用途,不把全部会话图片自动作为参考。读取像素后再解释,不能看图时使用已配置的视觉分析能力或说明限制。
|
|
6
6
|
|
|
@@ -17,11 +17,11 @@
|
|
|
17
17
|
|
|
18
18
|
1. 理解意图与主题归类:先明确对象、属性、调整方向、程度、条件及保留要求。区分跨主体复用的绘制语言与当前任务的主体、结构、材质、光照、构图和交付约束,按相关主题组织,不强制填满分类,不为分类补造需求。
|
|
19
19
|
2. 初步整理与语义去重:统一同一对象的称呼,合并对象、含义和适用条件均一致的重复要求;程度、条件或对象不同的内容分别保留。含义不确定时保留原表达和上下文,暂不强行合并或替换,避免先精简掉消歧依据。
|
|
20
|
-
3. 按需专业对齐:发现专业概念歧义或需要核实时,先从中文原意、作用对象及条件中提炼简短的英文专业检索词,再通过实际可用的 Getty 或项目表达库召回概念。不是逐字翻译整段描述,也不将英译当成已确认结论;有多个合理含义时在同一批次查询,不在结果不理想后反复换词。原始中文及约束保留在 context,候选返回后结合类别、概念说明和原始上下文判断,不只按首条或分数采用。Vant 使用
|
|
20
|
+
3. 按需专业对齐:发现专业概念歧义或需要核实时,先从中文原意、作用对象及条件中提炼简短的英文专业检索词,再通过实际可用的 Getty 或项目表达库召回概念。不是逐字翻译整段描述,也不将英译当成已确认结论;有多个合理含义时在同一批次查询,不在结果不理想后反复换词。原始中文及约束保留在 context,候选返回后结合类别、概念说明和原始上下文判断,不只按首条或分数采用。Vant 使用 vant_art_getty 结构化入口,不拼 Python、脚本或请求文件路径。缓存由查询工具管理,仅复用完整检索词及影响结果的全部参数完全一致的请求,不做语义近似缓存;不伪造概念 ID、结果或工具能力。无需引入 OpenRefine 运行依赖。
|
|
21
21
|
4. 精炼表述与整体校验:采用明确且符合原意的概念后,删去空泛修饰与重复说明,形成独立完整的描述;保留对象、程度、条件、例外和 required/default/avoid 的原有强度,不设机械字数限制。核对前后术语及要求一致,未遗漏约束、增加未经支持的含义或混淆风格与任务职责。发现问题做局部修正,不自动回到起点反复检索或改写。
|
|
22
22
|
5. 回填并结束:明确且校验通过的修改在用户当前编辑授权内自动回填,无需逐项确认;读取当前对象及 revision,保留未修改配置,按工具契约保存并核实返回结果。筛选后仍有多个合理解释时,按匹配程度排序,通过宿主现有决策入口展示候选含义、匹配依据、差异和拟回填内容,标明推荐项并允许保留原表达或自行修改;未决字段保留原值,其余明确修改继续处理。无匹配、查询能力不可用、服务失败或语义校验未通过时,保留受影响的原表达,简短说明局限并结束本次对齐,不强行绑定概念或自行重试循环。配置保存失败须如实报告,不声称已回填;技术契约校验仍按原规则执行。
|
|
23
23
|
|
|
24
|
-
Getty 调用前按需读取 `references/getty.md`。Vant 的
|
|
24
|
+
Getty 调用前按需读取 `references/getty.md`。Vant 的 vant_art_getty 由宿主定位受管包中的 `scripts/getty.py` 和共享 Python,通过标准输入输出交换 JSON;模型不用寻找或创建脚本。其他宿主只使用其明确提供的执行入口与解释器,缺少能力时说明失败,不猜路径、搜索系统 Python 或改用临时脚本。适配器负责 AAT 查询、详情、精确缓存和错误分类,模型负责词语提炼和语义判断。上游 serviceScore 只是检索排序分数,serviceMatch 不等于语义通过;失败即保留原文并结束当前检索,不用网页查询冒充已完成 Getty 核实。
|
|
25
25
|
|
|
26
26
|
|
|
27
27
|
每轮对齐只做一次有界整理与查询批次;查询候选可含原词和有依据的候选译名,使用不同 query ID 保留来源。一次局部修正后仍有歧义就交决策卡或保留原文并结束,不为提高检索分数反复换词。用户选择候选后只处理该未决项,不重新启动整套流程。
|
|
@@ -4,13 +4,13 @@
|
|
|
4
4
|
|
|
5
5
|
1. 从原始中文描述及作用对象中提炼简短英文专业检索词,优先术语而非整段直译。例如“晕涂法”可检索 sfumato;“版画感、双色、可见刻刀痕”可在同一批次检索 woodcut、linocut 等有依据的候选含义,不直接用 print feeling。术语不确定时保留为候选,不先确定画法。
|
|
6
6
|
2. 原文及约束保留在每项 context.original、target 等上下文中;英文词只用于召回,不替换用户原文。一次准备好相关候选,最多 10 项,不向用户逐项确认英译。
|
|
7
|
-
3. Vant 调用
|
|
7
|
+
3. Vant 调用 vant_art_getty,参数为下文的查询 JSON。宿主从受管工具包定位脚本,使用共享 Python,通过 stdin 传入请求。模型直接使用结构化入口。
|
|
8
8
|
4. 用返回的类别、说明、别名与原始上下文校验候选。英文词也可能召回无关概念;中文候选、第一名、serviceScore 或 serviceMatch 均不能代替语义判断。全部不合适时保留原表达,不为了得到命中继续扩词查询。
|
|
9
9
|
5. 本次核实完成或失败后继续主任务,不重试、更换路径或新增确认关卡。多候选本身不要求用户确认;真正影响主任务的设计取舍沿用已有交互,不另加 Getty 审批。
|
|
10
10
|
|
|
11
11
|
## Vant 执行结果
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
vant_art_getty 的主状态只有 succeeded 或 failed,stop=true 表示本轮查询已结束。同一用户轮次只有一个查询批次,重复调用或改变检索词会复用原结果,不再次执行。新的用户需求可以开始新一轮查询。
|
|
14
14
|
|
|
15
15
|
- succeeded:适配器完整成功。data.status 为 candidates 或 no_match;零匹配是有效查询结果。
|
|
16
16
|
- failed:读取 error.code、stage、message。资源或解释器问题是明确的前置失败;执行、网络、响应或详情错误也属于失败。runnerAttempted 等执行信息区分是否已尝试适配器,不把前置失败说成已经访问 Getty。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: vant-spine-production
|
|
3
|
-
description: "制作或调整 2D Spine
|
|
3
|
+
description: "制作或调整 2D Spine 角色与动画时按需查阅。适用于从需求设计原型、高清拆件补绘、绑骨蒙皮、对照修形、动作与转场、运行时预览,以及 Unity 或 Web 运行资源的质量与开销调优。"
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 2D Spine 制作指南
|
|
@@ -14,10 +14,10 @@ description: "制作或调整 2D Spine 角色与动画时按需查阅。适用
|
|
|
14
14
|
| 只有一句角色设想,或要把已定稿的角色拆成可动部件 | [原型与拆件](references/art-parts.md#原型设计)、[拆分粒度](references/art-parts.md#拆分粒度) |
|
|
15
15
|
| 放大后细节糊、转腕露洞、换表情时整张脸变了 | [高清重绘与补绘](references/art-parts.md#高清重绘与补绘) |
|
|
16
16
|
| 原画很像,进引擎后脸宽了、手袖有缝或姿势不对 | [绑定与蒙皮](references/rig-motion.md#绑定与蒙皮)、[对照修形](references/rig-motion.md#对照修形) |
|
|
17
|
-
| 想做一个动作、改善循环或检查两段动作如何衔接 | [动作与转场](references/rig-motion.md#动作与转场)、[
|
|
17
|
+
| 想做一个动作、改善循环或检查两段动作如何衔接 | [动作与转场](references/rig-motion.md#动作与转场)、[运行时预览](references/rig-motion.md#运行时预览) |
|
|
18
18
|
| 要交给程序、接入 Vanter,或运行后模糊、掉帧、包太大 | [导出、运行验收与成本取舍](references/delivery.md) |
|
|
19
|
-
| 需要选择制作工具或读取输入契约 | [工具入口](references/delivery.md#工具入口) |
|
|
19
|
+
| 需要选择制作工具或读取输入契约 | [工具入口](references/delivery.md#工具入口)、[图像处理备选](references/art-parts.md#图像处理备选) |
|
|
20
20
|
|
|
21
|
-
**制作入口。**
|
|
21
|
+
**制作入口。** 在 Vant 中从会话提供的 `DSH_VANT_CLI` 运行 `art spine`。配方字段见 `art spine describe`。原画定位与蒙版回贴用 `parts`;骨架、权重、时间线和运行图集用 `build`;留存指定时刻的 PNG 和对照图 用 `capture`。这些命令可在独立工作目录执行。
|
|
22
22
|
|
|
23
|
-
**在 Vant 中预览。** 桌面提供 `vant_spine_preview` 时,用项目骨架相对路径或已登记资产 ID 打开浮窗,可指定初始动作。需要逐帧、查看绑定或对照上一版时,打开美术工坊标题栏右侧的 Spine 页签。工作台以外使用目标版本的 Spine
|
|
23
|
+
**在 Vant 中预览。** 桌面提供 `vant_spine_preview` 时,用项目骨架相对路径或已登记资产 ID 打开浮窗,可指定初始动作。需要逐帧、查看绑定或对照上一版时,打开美术工坊标题栏右侧的 Spine 页签。工作台以外使用目标版本的 Spine 播放器。在 Vant 中确认某个项目导出版本入美术仓时,接续工作台的 `vant-asset-intake` 指南。
|
|
@@ -19,3 +19,9 @@
|
|
|
19
19
|
补绘看**动作将显露的面积**。移动原前景模拟抬手或侧摆,在独立底层补到最远暴露处,并给接缝留重叠。取回所需区域,与母版核对改动范围和透明边。若当前编辑工具无法精确限定像素,在图像编辑器以蒙版合回结果,检查蒙版外像素。大幅转面需要绘制新视角,拉伸正面纹理很容易失真。
|
|
20
20
|
|
|
21
21
|
**Vanter 的处理。** 设计板有多个视图,造型以左上大正面为准。闭眼稿只取双眼,无五官底脸补全替换区域。手掌与圆袖按实际遮挡分别拆开,叉腰时另外补出被原手臂遮住的头发和衣身。这样加表情和手势可以沿用同一张脸和主体。
|
|
22
|
+
|
|
23
|
+
## 图像处理备选
|
|
24
|
+
|
|
25
|
+
当标准配方不能表达所需的局部裁切、蒙版运算、透明图层合成或像素差异对照时,可选用 Node.js + sharp,也可直接用当前工程的图像工具或编辑器。按所需操作和本机可用性选择,包括 macOS;无需为了遵循指南另装 sharp。若选 sharp,先在实际执行脚本的 Node 环境中验证能加载并处理一张小图,不依赖其他应用的私有安装路径。
|
|
26
|
+
|
|
27
|
+
在副本上处理,保留原画坐标、轴心、图层顺序、像素尺寸和透明通道。将结果按原坐标叠回基准图,检查蒙版外像素及半透明边缘,再交给绑定与运行时预览。静态合成可用于定位差异,动作和蒙皮仍以实际骨架播放结果为准。
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
## 目标端与交付物
|
|
4
4
|
|
|
5
|
-
核对项目实际使用的 Spine Runtime 主次版本、加载格式、材质和透明度约定,再选对应导出设置。制作源保留分层母版、定位信息、可编辑骨架及附件原图;运行目录仅放加载器消费的骨架、atlas
|
|
5
|
+
核对项目实际使用的 Spine Runtime 主次版本、加载格式、材质和透明度约定,再选对应导出设置。制作源保留分层母版、定位信息、可编辑骨架及附件原图;运行目录仅放加载器消费的骨架、atlas、图集和项目要求的索引或集成资源。过程图和重复的原尺寸部件留在源资产或预览目录。
|
|
6
6
|
|
|
7
7
|
Vanter 的实例交付 Spine 4.2 骨架 JSON、原始部件 PNG、PMA 图集、动作索引及 Unity 包。编辑时在匹配版本的 Spine Editor 导入 JSON 并关联原图,可再保存为原生 `.spine` 工程。交付说明要准确写出实际文件格式。
|
|
8
8
|
|
|
@@ -27,5 +27,5 @@ Vanter 的实例交付 Spine 4.2 骨架 JSON、原始部件 PNG、PMA 图集、
|
|
|
27
27
|
| --- | --- |
|
|
28
28
|
| 原型与补绘 | 使用当前工作环境的生图、编辑工具制作原型和补绘图。用 `spine parts` 指定母版像素矩形、轴心、前后顺序与遮挡关系。蒙版接受透明度或灰度图;同比例高清替换图按原矩形配准,图集保留替换图像素尺寸。检查 assembled.png,采用补绘前后对照 patched.png 与原图。 |
|
|
29
29
|
| 骨架与动画 | `spine build` 读取 parts.json,按轴心建立初始绑定。用 bones 按名增改骨骼,meshes 指定目标插槽、UV、三角索引、各点的骨名/骨局部坐标/权重。animations 使用 Spine 4.2 时间线。后续可传已编辑的 rig 骨架 JSON,保留其余皮肤、约束和动作。 |
|
|
30
|
-
| 制作验收 | 美术工坊 → Spine 接入导出骨架。桌面对话可用 `vant_spine_preview` 打开同一资产。需要留存指定姿势或分享时,用 `spine capture` 选择动作、秒数或均匀帧数,输出逐帧 PNG
|
|
30
|
+
| 制作验收 | 美术工坊 → Spine 接入导出骨架。桌面对话可用 `vant_spine_preview` 打开同一资产。需要留存指定姿势或分享时,用 `spine capture` 选择动作、秒数或均匀帧数,输出逐帧 PNG 和对照图;需要本机 Chrome、Edge 或 Chromium。 |
|
|
31
31
|
| 交付 | 核对导出的骨架、图集 PNG 与 atlas、animations.json 和 report.json。report 给出运行文件字节数、未压缩 RGBA 占用、骨骼、顶点和影响数。目标引擎的真实帧耗时需在该引擎测量。 |
|
|
@@ -26,8 +26,8 @@ Vanter 将设计板大正面与 Unity 首帧放在同一窗口对照。修脸时
|
|
|
26
26
|
|
|
27
27
|
导出后运行 `node <技能目录>/scripts/check-variants.mjs <骨架.json> <animations.json>`。二进制交付使用同一次导出的 JSON 副本核对名称,再用目标播放器加载最终 SKEL 核对动作列表。接手已有资产时保留已公布的调用名;需要规范化改名时,同步修改源工程、索引、默认动作、转场及调用方,再重导验收。
|
|
28
28
|
|
|
29
|
-
##
|
|
29
|
+
## 运行时预览
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
在 Vant 中用 Spine 浮窗播放正在编辑的骨架,切换动作看起止姿势与循环接缝;复杂对照进 Spine 工坊。按最终显示尺寸看一次,固定根位置、缩放与背景,避免自动裁切造成假抖动。只有涉及目标引擎特有的材质或混合行为时,再到对应引擎复核。
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
需要留存问题帧时导出 PNG。采帧用相同画布、真实播放时长,循环末尾避免重复首帧。渐变或透明边的质量以运行时画面为准。
|
package/v-cli.plugin.json
CHANGED