关于 live2d-from-art
live2d-from-art 是将角色原画制作成交互式 Live2D 模型的 Skill,适用于网页、VTube Studio 或可编辑的 Cubism 工程。它涵盖素材检查、建模、画面验证、动作润色和交付,并区分技术加载与视觉验收。
主要功能
- 01按现有素材选择制作路径
- 02重组部件并检查角色外观
- 03分阶段建模并保留回退点
- 04在网页查看器验证 MOC3 渲染
- 05润色动作并检查画面问题
- 06检查交付内容及目标平台验收
适用场景
- 01根据分层 PNG 或 PSD 制作模型
- 02拆分并重组单张图片的部件
- 03检查模型中性姿态和面部对齐
- 04验收 VTube Studio 交付
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ fifteen42/ live2d-from-art --skill live2d-from-art安装后在 Claude Code 中输入/live2d-from-art确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
.gitignoreREADME.mdREADME.zh-CN.mdagents/openai.yamlassets/worked-example/character/extract_reference.pyexport_psd.pyindex.htmlbuild_moc.pycompare_neutral.pypackage.pyprepare_expression_hair.pypreview.jsprepare_eyes.pyvalidate_native.pyprepare_mouth.pyrebuild.pyvalidate.cjsassets/worked-example/tooling/py-moc3/LICENSEassets/worked-example/tooling/py-moc3/src/moc3/__main__.py__init__.py_core.pyreferences/worked-example.mdvalidation.mdartwork.mddirect-moc3.mdmotion-and-preview.mdscripts/check_runtime.py详细介绍
来自项目 README从原画制作可交互 Live2D
目标是保留角色辨识度并让动作可信。可加载、会动、好看是三个不同验收层级,分别报告。过去案例曾通过结构检查但因歪眼、拼接和持续摇晃被用户否定;不能用技术测试替代画面判断。
选择路径
先检查用户已有素材和项目,确定目标是网页、VTube Studio(VTS)、还是可继续编辑的 Cubism 工程。复用已有原图、授权素材和项目约定,不自行换脸或扩大到 TTS/Agent 平台。
- 有成熟模型:先修现有资源和参数映射,不重做拆图。
- 有 PSD/分层 PNG:检查默认拼合,再做网格与形变。
- 单张图片:先保真拆件和遮挡补绘。生图工具可辅助局部补绘,不能把一张“部件展示图”直接当作已对齐的建模素材。
- 用户要求不用 Cubism Editor:可采用本 Skill 的实验性 MOC3 代码路线。其局限及格式细节见 直接建模。不要把它描述成官方编译器或通用一键转换器。
工作顺序
- 建立基准:保存不可覆盖的原图、画布、透明通道、部件清单和检查点。先读 素材处理。明确正脸、转脸范围与可见动作,分辨率沿用真实素材质量,放大不等于新增细节。
- 静态重组:将部件按坐标和层级拼回原图,解决眼形、眉形、脸宽、发际线、领口及接缝。默认姿态像原图后再加动作。
- 模型构造:先静态 MOC3 加载,再逐个增加眼、嘴、眉、头、身体和发丝参数;各阶段保留可回退版本。读 直接建模。
- 网页验证:用实际 Cubism Core 渲染目标 MOC3,原图并排、同尺度、支持脸部放大、参数滑块和复位。读 动作与网页。
- 动作润色:先单参数,后组合;检查遮挡、拉伸、图层贯穿及姿态停顿。待机不能用持续摆动掩盖模型问题。用户说“像鬼”“纸片”“歪眼”时,先停自动动作、回到中性姿态,定位后再演示。
- 交付:按 验收与交付 检查运行包、分层源文件、制作代码与预览。区分已测平台与未测平台;用户要求 VTS 时实际加载验收,网页通过不能冒充 VTS 通过。
可复用资源
- 本次案例与代码导航:原项目位置、复建顺序、已验证环境、哪些常量必须按新角色改写。
assets/worked-example/:实际使用的制作脚本、网页和 MIT 序列化库快照。是需要适配的案例,不含原画、生成补绘、专有 Core 或其他 vendor 库,不是开箱即用工程。scripts/check_runtime.py MODEL.model3.json:检查模型清单引用、纹理/MOC 文件存在性和 JSON 可解析性。不会证明 MOC 二进制有效或画面好看。
不要覆盖唯一原图;无需为每个可逆调整重复询问用户。涉及生成图片时使用当前环境可用的图像工具及其规范;没有图像工具时说明所缺补绘,继续能独立完成的代码和结构工作。
评论
支持 Markdown