@kevlns/art-workshop 0.6.3 → 0.6.4
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/package.json +1 -1
- package/skills/art-workshop/SKILL.md +2 -0
- package/skills/art-workshop/references/video.md +2 -0
- package/skills/vant-spine-production/SKILL.md +21 -0
- package/skills/vant-spine-production/references/art-parts.md +21 -0
- package/skills/vant-spine-production/references/delivery.md +33 -0
- package/skills/vant-spine-production/references/rig-motion.md +33 -0
- package/skills/vant-spine-production/scripts/check-variants.mjs +32 -0
- package/v-cli.plugin.json +4 -0
package/package.json
CHANGED
|
@@ -5,6 +5,8 @@ description: "处理图片与视频美术制作:图片讨论、风格、生成
|
|
|
5
5
|
|
|
6
6
|
# 美术工坊
|
|
7
7
|
|
|
8
|
+
制作、调整或交付 2D Spine 角色时,查阅同包技能 `vant-spine-production`,按当前阶段选择原型、拆件、绑定、动作或导出指导。在 Vant 中,用户要求将已确认的正式作品入美术仓或接入游戏时,接续工作台技能 `vant-asset-intake`。
|
|
9
|
+
|
|
8
10
|
工具包提供 `image` 和 `video` 两个独立二级通道。图片沿用下述会话与项目管线;视频剧本、镜头、成片和精修先读取 [视频通道](references/video.md)。不要把视频任务改造成图片生成请求,也不要用图片配置替代视频模型和工作流设置。
|
|
9
11
|
|
|
10
12
|
判断本轮是讨论、生成还是编辑,再确定归属会话或项目任务。信息充分时直接使用对应结构化工具,不把普通讨论升级为生成。当前消息明确指定的对象和图片优先于历史推断。
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: vant-spine-production
|
|
3
|
+
description: "制作或调整 2D Spine 角色与动画时按需查阅。适用于从需求设计原型、高清拆件补绘、绑骨蒙皮、对照修形、动作与转场、GIF 验收,以及 Unity 或 Web 运行资源的质量与开销调优。"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# 2D Spine 制作指南
|
|
7
|
+
|
|
8
|
+
**动作命名。** 新制动作统一使用 `<语义类别>_<三位变体号>`。类别使用小写英文 snake_case,每类从 `001` 起,即使只有一个动作也保留编号。已有动作的编号保持稳定。交付时同时校验骨架和同目录的 `animations.json`,详见[命名与索引](references/rig-motion.md#命名与索引)。
|
|
9
|
+
|
|
10
|
+
从用户要看到的变化和手里的材料入手。已有定稿就沿用定稿,已有骨架就保留可用的绑定和动作。只读与当前问题有关的小节。交接时留下本次产物、采用的基准图,以及在什么尺寸和运行端看过效果。
|
|
11
|
+
|
|
12
|
+
| 当前问题 | 查阅 |
|
|
13
|
+
| --- | --- |
|
|
14
|
+
| 只有一句角色设想,或要把已定稿的角色拆成可动部件 | [原型与拆件](references/art-parts.md#原型设计)、[拆分粒度](references/art-parts.md#拆分粒度) |
|
|
15
|
+
| 放大后细节糊、转腕露洞、换表情时整张脸变了 | [高清重绘与补绘](references/art-parts.md#高清重绘与补绘) |
|
|
16
|
+
| 原画很像,进引擎后脸宽了、手袖有缝或姿势不对 | [绑定与蒙皮](references/rig-motion.md#绑定与蒙皮)、[对照修形](references/rig-motion.md#对照修形) |
|
|
17
|
+
| 想做一个动作、改善循环或检查两段动作如何衔接 | [动作与转场](references/rig-motion.md#动作与转场)、[GIF 预览](references/rig-motion.md#gif-预览) |
|
|
18
|
+
| 要交给程序、接入 Vanter,或运行后模糊、掉帧、包太大 | [导出、运行验收与成本取舍](references/delivery.md) |
|
|
19
|
+
| 需要判断 Vant 能直接做哪一段、还缺什么 | [工具与缺口](references/delivery.md#工具与缺口) |
|
|
20
|
+
|
|
21
|
+
**在 Vant 中预览。** 桌面提供 `vant_spine_preview` 时,用项目骨架相对路径或已登记资产 ID 打开浮窗,可指定初始动作。需要逐帧、查看绑定或对照上一版时,打开图片工坊的 Spine 页签。工作台以外使用目标版本的 Spine 播放器。需要分享动图时再导出 GIF。在 Vant 中确认某个项目导出版本入美术仓时,接续工作台的 `vant-asset-intake` 指南。
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# 原型与部件
|
|
2
|
+
|
|
3
|
+
## 原型设计
|
|
4
|
+
|
|
5
|
+
从用途推导造型。角色在聊天角落挥手,首先要在实际显示尺寸下看清眼神、手势和剪影;需要转身的战斗角色则要提前解决侧面、背面和武器遮挡。优先从现有需求和参考里确定镜头、显示大小、最有代表性的姿态和可变部位。只有会改变造型或制作成本的未决点才值得问用户。
|
|
6
|
+
|
|
7
|
+
有定稿时明确具体哪张、哪个视角是造型基准。没有定稿且造型仍有分歧时,用同构图的小稿比较轮廓和比例;选定后再细化正面或主视角。用最能暴露问题的动作草图检验原型,例如叉腰能否看清短手臂。按实际动作补所需视角、手形和表情。交给拆件的人应能指出哪些比例必须保留、哪些部位预期会动。
|
|
8
|
+
|
|
9
|
+
## 拆分粒度
|
|
10
|
+
|
|
11
|
+
在原型副本上标出动作涉及的轮廓、轴心和前后遮挡。**会独立运动、改变遮挡顺序、局部变形或切换外形的部分值得拆。** 始终随同一表面运动的纹理和高光可以合画。同一条尾焰可由一张图配多骨变形;握拳与张掌轮廓相差大时可做同槽替换手形。用目标动作验证这个决定。
|
|
12
|
+
|
|
13
|
+
每个部件记录稳定名称、左右侧约定、原画位置、转轴、前后层级及需要露出的底色。裁成紧边 PNG 时保留原画偏移或可还原位置的定位点。照原位置拼回静止姿,再分别隐藏前景、摆出极限姿,检查是否有重复五官、断面或漏底。两侧受光、轮廓不同就分别取图。
|
|
14
|
+
|
|
15
|
+
## 高清重绘与补绘
|
|
16
|
+
|
|
17
|
+
部件高清化要保住位置与形状。留存原稿和未裁切的高清母版,统一画布与视角。在原图和高清图标记同名定位点,例如眼角、下巴、袖口、指尖。已有细节够用就直接取图。确需重绘时用定稿作编辑底图,给出局部范围、目标像素密度,以及要保留的相邻轮廓、受光和透视;多个候选放回原坐标比较后再取用。
|
|
18
|
+
|
|
19
|
+
补绘看**动作将显露的面积**。移动原前景模拟抬手或侧摆,在独立底层补到最远暴露处,并给接缝留重叠。取回所需区域,与母版核对改动范围和透明边。若当前编辑工具无法精确限定像素,在图像编辑器以蒙版合回结果,检查蒙版外像素。大幅转面需要绘制新视角,拉伸正面纹理很容易失真。
|
|
20
|
+
|
|
21
|
+
**Vanter 的处理。** 设计板有多个视图,造型以左上大正面为准。闭眼稿只取双眼,无五官底脸补全替换区域。手掌与圆袖按实际遮挡分别拆开,叉腰时另外补出被原手臂遮住的头发和衣身。这样加表情和手势可以沿用同一张脸和主体。
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# 导出与运行验收
|
|
2
|
+
|
|
3
|
+
## 目标端与交付物
|
|
4
|
+
|
|
5
|
+
核对项目实际使用的 Spine Runtime 主次版本、加载格式、材质和透明度约定,再选对应导出设置。制作源保留分层母版、定位信息、可编辑骨架及附件原图;运行目录仅放加载器消费的骨架、atlas、图集和项目要求的索引或集成资源。GIF、过程图和重复的原尺寸部件留在源资产或预览目录。
|
|
6
|
+
|
|
7
|
+
Vanter 的实例交付 Spine 4.2 骨架 JSON、原始部件 PNG、PMA 图集、动作索引及 Unity 包。编辑时在匹配版本的 Spine Editor 导入 JSON 并关联原图,可再保存为原生 `.spine` 工程。交付说明要准确写出实际文件格式。
|
|
8
|
+
|
|
9
|
+
交付前按[命名与索引](rig-motion.md#命名与索引)核对完整动作清单。接入 Vanter 时,按实际入口验证入场、循环、表情衔接和退场完成。
|
|
10
|
+
|
|
11
|
+
## 保真与开销
|
|
12
|
+
|
|
13
|
+
| 现象或指标 | 如何取舍 |
|
|
14
|
+
| --- | --- |
|
|
15
|
+
| 原图清楚,放到界面就糊 | 用最终显示大小和设备像素比确定所需纹理分辨率;对照图集原像素、运行时渲染缓冲和界面缩放,找出第一次变糊的位置,再决定改导出比例或渲染设置。 |
|
|
16
|
+
| 包大或显存高 | 分开记录下载字节数与解码后的纹理开销。盘点图集页数、长宽、透明空白和重复图块。先修剪、合理打包和复用,再试缩小大图;为边缘滤波留足间距。每次在最大实际尺寸复看眼睛、细线和半透明边。 |
|
|
17
|
+
| 动作复杂时掉帧 | 用同一设备、镜头、角色数量和最重的动作比较帧耗时。检查实际 draw calls、材质或混合切换、大面积半透明叠画,以及每帧变形的顶点和骨骼影响数。优先优化测到的瓶颈,保住轮廓和关键姿势。 |
|
|
18
|
+
| 出现黑边、白边或图块串色 | 在深浅底色和运动中检查。核对导出与加载端的直通或预乘 Alpha、纹理过滤和 atlas 边缘填充,再调整压缩。 |
|
|
19
|
+
|
|
20
|
+
记录调整前后的运行包大小、纹理尺寸与页数、目标端测量值,并保留同帧同尺寸的图。交付时从干净目录用实际加载入口播放一次,检查 atlas 各页和附件都能解析、大小写路径匹配、动作完成事件与循环正常。仅验证过 Unity 时,将 Web 验收标为待测,反之亦然。[Spine 性能指标](https://esotericsoftware.com/spine-metrics) · [Spine 图集打包](https://esotericsoftware.com/spine-texture-packer)
|
|
21
|
+
|
|
22
|
+
## 工具与缺口
|
|
23
|
+
|
|
24
|
+
以下入口由 Vant 桌面工作台提供,按当前宿主实际可用的工具选择。
|
|
25
|
+
|
|
26
|
+
| 当前工作 | Vant 中的可用入口与边界 |
|
|
27
|
+
| --- | --- |
|
|
28
|
+
| 制作预览与修形复核 | 图片工坊 → Spine → 接入项目资产。填项目相对的骨架路径,图集和页纹理随骨架一起读取。用部件显隐、绑定叠加、时间轴和上一版本对照检查修改;同一项目的美术讨论能读取所选动作、秒数与版本。 |
|
|
29
|
+
| 画原型、重绘部件、生成替换手形 | 会话使用 `vant_art_conversation` 的 `generate` 或 `edit`,通过 `describe` 查当前输入,`wait` 取回对应结果。编辑带基准图并注明保留项。图像结果还需配准、抠取和拼回验证。 |
|
|
30
|
+
| 项目风格、参考与资产 | 通过 `vant_art` 的 `describe` 查询相应操作。项目已有拆件、打包或预览脚本时,先核对输入、输出和适用角色,再复用。 |
|
|
31
|
+
| Unity 实例验收、Vanter 对话里试动作 | Unity 交互复用项目配置的 `v-cli` Unity 工具,先核对目标工作区的项目路径及实例。Vanter 在桌面用 `vanter_animation` 查询和播放已装配动作。 |
|
|
32
|
+
|
|
33
|
+
**目前缺少的通用制作入口**有三处:带原画坐标、轴心和遮挡元数据的拆件与精确蒙版回写;创建或编辑 Spine 骨架、网格、权重与时间线;从指定运行端批量取帧、生成对照图和 GIF 并统计导出成本。Vanter 有角色专用的构建和 Unity 预览脚本,可供项目参考。实际制作可用现有项目脚本或匹配版本的 Spine Editor;环境缺少某项时,指出受影响的产物及尚未验证的部分。
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# 绑定、修形与表演
|
|
2
|
+
|
|
3
|
+
## 绑定与蒙皮
|
|
4
|
+
|
|
5
|
+
先在设置姿势拼回原画。根骨控制整体位移,身体和头承担主要姿态,手腕、耳尖、尾焰等按独立运动需求挂在合适的父骨下。把枢轴放在实际弯折或旋转的位置,核对 slot 的绘制顺序。硬饰品可用普通附件跟骨;需要弯折的软轮廓再做网格,在弯折和轮廓变化处增加顶点。
|
|
6
|
+
|
|
7
|
+
蒙皮从主要骨骼的影响开始,沿关节逐步过渡,检查权重归一化。共享接缝两侧的顶点跟随要一致。分别转动父骨、子骨并测试组合极限姿,检查塌陷、滑动和穿帮。若旋转时纹理大幅拉长,先判断缺的是另一个手形、另一视角还是遮挡底图,再决定是否加骨或加点。[Spine 权重工具](https://esotericsoftware.com/spine-weights)
|
|
8
|
+
|
|
9
|
+
## 对照修形
|
|
10
|
+
|
|
11
|
+
用目标运行时渲染设置姿势或约定帧,在与基准图相同的坐标窗口比较。固定根位置、缩放和相机,做并排图或半透明叠图。先看剪影和比例,再看眼角、下巴、袖口、指尖等定位点。设置姿势就偏,查图层偏移、枢轴和设置姿势;仅某个动作偏,查该帧的关键帧、权重、附件切换和混合。
|
|
12
|
+
|
|
13
|
+
Vanter 将设计板大正面与 Unity 首帧放在同一窗口对照。修脸时以已认可的生气动作第 12 帧脸颊和下巴为基准,约束表情变形在轮廓内,再回看待机、眨眼与生气。这比让每个表情各自生成一张完整头像更容易保持角色一致。
|
|
14
|
+
|
|
15
|
+
## 动作与转场
|
|
16
|
+
|
|
17
|
+
从观众应读懂的意图选关键姿态。先让起势、最有辨识度的姿势和收势在实际大小下可读,再调重心、停顿、加减速和次级摆动。待机的呼吸、浮动和眨眼可以有不同节奏;一次性动作要明确接续哪个状态,退场要标明完成点。以正常速度检查情绪,再慢放排查穿插和跳帧。
|
|
18
|
+
|
|
19
|
+
除了单播,还要从正在运行的上一个动作切入,再接回下一状态。循环同时检查首尾姿势和速度;切换附件、层序、透明度的帧要在混合中实际播放。Vanter 的叉腰先收腕到胸前再落拳到腰,耳尖和尾焰在主体停住后回弹。验收片是「待机 → 叉腰 → 待机」,两个方向的混合时间可分别调整。
|
|
20
|
+
|
|
21
|
+
## 命名与索引
|
|
22
|
+
|
|
23
|
+
同一意图的多种演法归入同一类别。例如轻挥手和大幅挥手可命名为 `wave_001`、`wave_002`,语义不同的告别可另建 `wave_goodbye_001`。类别分段用小写英文字母开头,可带数字。编号范围为 `001` 至 `999`,新变体沿用该类下一个可用的新编号。删减允许留下空号,保留动作不重新编号。
|
|
24
|
+
|
|
25
|
+
导出 `animations.json`,把每个类别映射到按编号升序排列的非空动作名数组,例如 `{"wave":["wave_001","wave_002"],"wave_goodbye":["wave_goodbye_001"]}`。每个交付动作在自己的类别中出现一次,骨架与索引的名称集合完全一致。随机选择在同一类别内进行。
|
|
26
|
+
|
|
27
|
+
导出后运行 `node <技能目录>/scripts/check-variants.mjs <骨架.json> <animations.json>`。二进制交付使用同一次导出的 JSON 副本核对名称,再用目标播放器加载最终 SKEL 核对动作列表。接手已有资产时保留已公布的调用名;需要规范化改名时,同步修改源工程、索引、默认动作、转场及调用方,再重导验收。
|
|
28
|
+
|
|
29
|
+
## GIF 预览
|
|
30
|
+
|
|
31
|
+
从目标运行时采帧。锁定相机、根位置与背景,取整段动作边界的并集并留边,避免逐帧自动裁切制造假抖动。记录播放速度、采样帧率和循环方式。按真实时长编码 GIF,循环段末尾避免重复首帧,一次性动作保留该看的停顿。需要检查转场时导出连播。
|
|
32
|
+
|
|
33
|
+
至少按最终显示尺寸看一次,重点区域另看等比静帧。GIF 调色板和透明度会损失渐变、辉光和半透明边缘,出现闪色或锯齿时回看原始 PNG 帧和运行时。Vanter 的待机预览采用 Unity 输出的 144 帧,母版旁另存首帧对照图;预览 GIF 单独交付。
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { readFile } from 'node:fs/promises';
|
|
2
|
+
|
|
3
|
+
async function json(file) {
|
|
4
|
+
return JSON.parse(await readFile(file, 'utf8'));
|
|
5
|
+
}
|
|
6
|
+
|
|
7
|
+
try {
|
|
8
|
+
const [skeletonPath, indexPath] = process.argv.slice(2);
|
|
9
|
+
if (!skeletonPath || !indexPath) throw Error('用法:node check-variants.mjs <骨架.json> <animations.json>');
|
|
10
|
+
const [skeleton, groups] = await Promise.all([json(skeletonPath), json(indexPath)]);
|
|
11
|
+
const object = value => value !== null && typeof value === 'object' && !Array.isArray(value);
|
|
12
|
+
if (!object(skeleton?.animations) || !object(groups)) throw Error('骨架 animations 和动作索引须为对象。');
|
|
13
|
+
const remaining = new Set(Object.keys(skeleton.animations));
|
|
14
|
+
if (!remaining.size) throw Error('骨架中没有可交付动作。');
|
|
15
|
+
for (const [group, variants] of Object.entries(groups)) {
|
|
16
|
+
if (!/^[a-z][a-z0-9]*(?:_[a-z][a-z0-9]*)*$/.test(group) || !Array.isArray(variants) || !variants.length)
|
|
17
|
+
throw Error('无效类别或空变体列表:' + group);
|
|
18
|
+
let previous = 0;
|
|
19
|
+
for (const clip of variants) {
|
|
20
|
+
const match = typeof clip === 'string' && /^(.*)_([0-9]{3})$/.exec(clip);
|
|
21
|
+
if (!match || match[1] !== group || Number(match[2]) <= previous)
|
|
22
|
+
throw Error('变体须按组内三位正编号升序且唯一:' + clip);
|
|
23
|
+
if (!remaining.delete(clip)) throw Error('索引动作没有匹配的骨架动作:' + clip);
|
|
24
|
+
previous = Number(match[2]);
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
if (remaining.size) throw Error('骨架动作未入索引:' + [...remaining].join('、'));
|
|
28
|
+
console.log('动作索引一致,共 ' + Object.keys(skeleton.animations).length + ' 个变体。');
|
|
29
|
+
} catch (error) {
|
|
30
|
+
console.error(error.message);
|
|
31
|
+
process.exitCode = 1;
|
|
32
|
+
}
|