Spine Render

top.lain42由 lain42.top 发布官方发布者v0.1.1更新于 Nov 4, 2026

Render Spine 3.8 skeleton animations to PNG frames or GIF. Pay per call with points.

已验证Streamable HTTP可网页运行媒体与设计AI 与机器学习

概览

AI 生成的概览

远程 MCP 端点，把 Spine 3.8 骨骼渲染为透明背景 PNG 单帧或 GIF 动画，按积分计费。

可以做什么
  • 解析 Spine 骨骼：读取 skel 与 atlas 数据，返回版本、骨骼数、动画列表等摘要。
  • 查询定价：免费获取服务的价格与限制说明。
  • 渲染单帧：输出透明背景 PNG，以 base64 图像返回。
  • 渲染动画：输出 GIF，以 base64 图像返回。
  • 相同 request_id 的重试具备幂等性，不会重复扣费。
适用场景
适合需要预览或导出 Spine 3.8 角色素材的场景：查看骨骼内容、生成静帧或动画 GIF，而无需在本机运行渲染器或持有 Spine 运行时授权。
运行要求
远程 streamable HTTP 端点，无需本地安装包。需要 lain42 studio 账号的 Bearer 令牌，通过 Authorization 头发送；注册免费并含 25 点试用积分。渲染调用消耗积分（单帧 5 点，动画 20 点）。
安装前请注意
渲染会消耗预付积分，试用积分用完后即产生费用，建议先查看定价卡片。Bearer 令牌属于计费凭证，应妥善保管。骨骼、atlas 与页面图像数据会以 base64 形式上传到远程服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Spine Render，将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/top.lain42%2Fspine-render/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "spine-render": {
      "type": "http",
      "url": "https://lain42.top/studio/render/mcp-server/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

lyco-ai-toolkit

多模态 AI 资源流水线：一条命令产出 Minecraft 皮肤、Bedrock 模型、BGM、立绘、歌词。

Owner: lilyco-42（云枢智创数码信息科技服务工作室） 调研与决策记录在 _RESEARCH/

现在能做什么

bash
lyco-cli bundle --prompt 'a quiet librarian' --out out# => out/#      skin.png        64x64 Minecraft 皮肤（合法，可校验）#      model.geo.json  Bedrock 几何（Blockbench 可导入）#      bgm.wav         背景音乐#      portrait.png    立绘 512x512#      lyrics.txt      分段歌词#      manifest.json   每个产物的 backend 与 placeholder 标记

全部子命令

lyco-cli bundle    整包：skin + model + bgm + portrait + lyrics + manifestlyco-cli skin      template | validate | info | quantize | generatelyco-cli bsm       humanoid | validate | info | glb-info | from-glblyco-cli bgm       背景音乐lyco-cli lyrics    分段歌词lyco-cli portrait  单张立绘lyco-cli mcp       在 stdin/stdout 上跑 MCP server，给 agent 用

接入 agent（MCP）

lyco-cli mcp 是一个 MCP server，用换行分隔的 JSON-RPC 2.0 收发。它把 12 个工具 暴露给 lilyco_agent / Claude Code / Cursor：skin_template、skin_validate、 skin_quantize、model_humanoid、model_validate、glb_info、model_from_glb、 lyrics_generate、lyrics_validate、bgm_generate、portrait_generate、bundle。

手动试一次：

bash
printf '%s\n' \  '{"jsonrpc":"2.0","id":1,"method":"initialize"}' \  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \  | lyco-cli mcp

布局

lyco-ai-toolkit/+-- crates/|  +-- lyco-cli/        统一入口（clap）|  +-- lyco-mc-skin/    F1  64x64 box-UV、调色板量化、皮肤校验|  +-- lyco-bsm/        F2/F3 Bedrock 几何、玩家模型、GLB 解析、体素化转换|  +-- lyco-audio/      F6  WAV 编解码、生成后端（stub + 子进程）|  +-- lyco-image/      F7  程序化立绘、生成后端|  +-- lyco-lyrics/     F8  歌词解析与结构校验、生成后端|  +-- lyco-bundle/     S5  编排 + 自描述 manifest|  +-- lyco-mcp/        F9  MCP server（JSON-RPC over stdio）+-- _RESEARCH/          lyco skill 预研报告（00-04）+-- scripts/            测试夹具生成器（造 GLB）

三个设计原则

  1. 解码大于编码。 音频、图像、歌词写完都要解回来核对；绝不把子进程退出码 当作产出成功的证据。
  2. placeholder 必须显眼。 内置 stub 后端在 CLI、manifest 的 placeholder 字段和 notes 里三处标注，一个 bundle 永远不会看起来像五次真实生成。
  3. 需要模型的藏在子进程后面。 不对 ACE-Step / ComfyUI / 任何 LLM 的 CLI 做假设， 只约定参数形状，用 --backend 指过去。

生成：Kaggle 免费 GPU

皮肤生成真的能跑 —— 不需要本机有显卡：

bash
lyco-cli skin generate --backend kaggle --owner <you> --slug lyco-skin-gen --seeds 7,42

它把 Rust 生成的笔记本推到 Kaggle，在免费的 Tesla T4 上跑 AliceKJ/BLOCKv0.6， 轮询到结束，拉回产物，然后在本机做 overlay 修复、结构校验和人形预览。

分工是刻意的：Kaggle 只做它唯一不可替代的事（GPU 推理），UV 知识和修复逻辑归 Rust。 生成的笔记本里没有 UV 表，CI 会断言这一点。

其余需要模型的部分（音频引擎、图像引擎、LLM）仍是 --backend '<命令行>' 子进程边界。

F11 Spine：渲染，以及为什么它不随包发布

bash
lyco-cli spine info model.atlas        # 页 / region / 是否声明 size、pmalyco-cli spine normalize model.atlas   # 从 PNG 头补/修 size，幂等lyco-cli spine version model.skel      # 读出需要的 Spine 版本

lyco-spine-render 能把 Spine 骨架摆姿势并在 CPU 上画成 PNG（describe / render --animation NAME）。已用真实方舟数据验证：Spine 3.8.99、52 mesh、508 三角形。

但它不随本仓库发布二进制，原因很具体：

  • 它链接官方 Spine 运行时，那是 Spine Runtimes License Agreement（商业许可）
  • 本仓库源码是 MIT，从它构建出的二进制不是 —— 发布需要你自己的 Spine 授权
  • 所以默认 CI 只验证它能编译，不产出 artifact；windows-binary 只发纯 MIT 的 lyco-cli.exe

要拿到这个二进制，用仓库里的 build from source workflow（workflow_dispatch）： 你在自己的 fork 里触发，在你自己的授权下构建，产物只进你这次 run。

它的输入：

  • target —— 默认 lyco-spine-render，也可选 lyco-cli 或 both
  • runner —— 默认 windows-latest，或 ubuntu-latest
  • spine_lib —— 要链接的 Spine 运行时 git 地址（默认 rusty_spine3.8）
  • spine_rev —— 该运行时的 revision，commit / tag / branch 都行

spine_lib 和 spine_rev 是真的生效的：workflow 会改写 crates/lyco-spine-render/Cargo.toml 里那一行再开始构建，所以你可以拿它试别的运行时。 运行时地址、revision、许可链接会在构建开头打印，并且参与缓存 key， 换 revision 不会误用旧产物。

缓存：默认 CI 和这个 workflow 都缓存两层 —— ~/.cargo/git/db 与 ~/.cargo/git/checkouts（Spine 运行时那个 git 依赖的 clone， 冷启动最慢的一步），以及 rust-cache 管的 target/ 增量编译。

注意：pma 是 Spine 4.x 的键。 往 3.8 的 atlas 里写 pma: true 会让 3.8 运行时 完全读不了那个文件 —— 实测确认（方舟素材池 561 组里 243 组带着它）。两条路都通：

  • 渲染时自动剥离：lyco-spine-render 读取前把 3.8 认不了的字段剥掉（旁路写一份 临时 atlas，用完即删），561/561 全部可读可渲；
  • 离线修复：lyco-cli spine normalize <atlas> --strip-3-8 把剥离结果写回文件。

验证

每次 CI 跑：test → clippy -D warnings → build → 6 组冒烟测试 → fmt。 冒烟测试用外部实现交叉验证：Python 的 wave 解码我们写的 WAV、直接读 PNG 头核对尺寸、 现造 GLB 喂给转换、以及一次真实 MCP 会话。

已知缺口

  • 真实 ACE-Step / ComfyUI / 混元 3D / LLM 接入需要 GPU 机器（皮肤走 Kaggle 已通）
  • keep-percent=12% 这个启发式对某些 seed 会整体清空残留很少的 overlay 矩形， 可能丢掉真实衣物细节；需要人眼判断是否调低
  • BGM 目前是 WAV；mp3 转码需要 ffmpeg
  • 转换出的模型贴图是「每盒平均色」，不是对原网格纹理的 UV 重映射
  • 模型能否被 Blockbench 导入未经人工验证（自动化只能验到 schema 层）

术语更正

调研初稿曾写「YSM/BSM 是 BlockBench 格式」——错的，已在 _RESEARCH/02-niche-knowledge.md 第五节更正： Blockbench 没有这两个格式且是 GPL-3.0；YSM 是 Yes Steve Model 模组的加密二进制； BSM 不存在。本项目落点是开放的 Bedrock geometry。

许可

MIT

来源：README.md，提交 92bb7f0

工具

4

spine_render_pricing

Spine 渲染服务定价与限制卡片（免费调用）。

无需输入参数。

spine_describe

解析 Spine 骨骼并返回摘要（版本/骨骼数/动画列表等，免费）。 atlas/skel 为 base64 文本，pages 为 [{"name": "...", "png": "<base64>"}]。

输入参数skelatlaspagestoken

spine_render_frame

渲染骨骼单帧为透明背景 PNG（5 积分）。返回 base64 图像。 token 为 studio-billing Bearer 令牌（也可走 HTTP Authorization 头）。 request_id 幂等：同 id 重试不会二次扣费。include_image=False 时只返回计费元信息。

输入参数skeltimeatlaspagestokenwidthanchorheightanimationbackgroundrequest_idinclude_image

spine_render_animate

渲染骨骼动画为 GIF（20 积分）。返回 base64 图像。 token 为 studio-billing Bearer 令牌（也可走 HTTP Authorization 头）。 request_id 幂等：同 id 重试不会二次扣费。

输入参数fpsskelatlaspagestokenwidthanchorframesheightanimationbackgroundrequest_id另有 1 个

版本历史

1
  1. v0.1.1最新Oct 21, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分