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 分