Agent 连接握手工具。Agent 成功连接 MCP 后调用它，WinForms 连接向导会据此显示绿色连接状态。只写运行态握手文件，不写 Spine JSON。

读取 Agent 连接状态、最近握手、项目规则检测和 Codex/Claude Code/opencode 配置片段。只读，不写 Spine JSON。

返回 Spine JSON 版本、文件哈希、顶层字段、数量统计，以及 V1 是否允许写入。

返回当前 MCP 内置的 Spine 官方 JSON 规范审查摘要、可写 timeline 规则和 4.1.24 字段适配说明。

返回骨骼树；可选返回 setup pose 的局部变换。

返回插槽绘制顺序、绑定骨骼、默认附件和显示属性。

返回皮肤名称和附件摘要。

返回动画名称、估算时长和时间线类型统计。

返回指定动画的原始时间线和规范化摘要，可按目标类型和名称过滤。

返回适合 Agent 编辑的关键帧表格，包含目标、时间线、时间、值、曲线和 JSON path。

新建空动画。默认不覆盖已有动画。

复制一个已有动画，作为后续编辑模板。默认不覆盖目标动画。

删除动画。高风险操作，必须显式传 confirm: true。

为已有动画中的已有骨骼插入或更新 rotate/translate/scale/shear 关键帧。

插入或更新插槽附件关键帧。attachmentName 为 null 表示隐藏附件。

使用官方 draw order offsets 结构插入或更新绘制顺序关键帧。

将指定动画、时间范围和目标过滤器内的关键帧整体前后平移。

以 originTime 为原点压缩或拉伸指定关键帧的时间。

删除某段时间范围内的关键帧，可按骨骼、插槽或绘制顺序过滤。

把一个动画片段复制到另一个动画或同一动画的指定时间点。

在同一时间点批量设置多个骨骼和插槽的姿态关键帧。

一次性创建或覆盖动画，并批量写入多个姿态时间点；适合减少多次写入、备份和审查调用。

批量调整骨骼时间线数值，可增加偏移或按比例缩放。

把 sourceTime 的已有关键帧复制到 targetTime，用于让循环动画首尾闭合。

按时间从骨骼、插槽或绘制顺序时间线中删除关键帧。

校验结构、版本、引用关系、关键帧排序和插槽附件引用。

返回浏览器预览层默认配置、官方 runtime 版本和 URL 参数说明。只读，不写入 JSON。

检查预览所需的 JSON、atlas 和 atlas 引用贴图是否存在，并确认目标动画是否存在。只读，不写入 JSON。

生成可直接打开的浏览器预览 URL，支持指定 JSON、atlas、动画、皮肤、PMA、Mipmaps 和自动载入。只读，不写入 JSON。

使用官方 spine-core runtime 读取 JSON、atlas 和附件数据，验证资源是否能被当前 4.1 runtime 加载。只读，不写入 JSON。

执行写入后的推荐只读验证流程：结构校验、官方 runtime 加载验证和预览 URL 生成。不写入 JSON。

列出 backups/ 中的 Spine JSON 备份，可按目标 filePath 过滤，并可校验备份 JSON 是否可用。只读，不写入 JSON。

将 backups/ 中的指定备份恢复到目标 JSON 文件。高风险操作，必须 confirm:true；默认 dryRun:true；真实恢复前会先备份当前目标文件。

设置 Agent 驱动的预览会话状态，让 WinForms 或浏览器预览层自动知道当前 JSON、atlas、动画和操作说明。只写会话状态，不写 Spine JSON。

读取当前 Agent 驱动的预览会话状态，并返回对应预览 URL。只读，不写入 JSON。

清空当前预览会话状态，恢复默认 JSON、atlas 和动画。只写会话状态，不写 Spine JSON。