v0.3.0 · 像塑 9.7.2 适配与官方能力接入

像塑 9.7.2 适配

本版以 像塑 9.7.2 为最低版本，实际验证版本为 9.7.2.918909817。

• 9.7.2：已完成下述实机验证。
• 更新版本：允许使用，提示未实测；后续按实际需要低频适配。
• 更旧版本：校验拒绝，请升级像塑或选择历史 MCP Release。

本次更新

• 新增图片、音频单项／批量生成及导入，AI 工作流与 H5 脚本动画相关工具。
• 保留 stdio 客户端接入、原有编辑工具、试玩状态读取与音频检测输入模拟。
• 兼容新旧音频运行库及新版动作素材／会话接口。
• 重写中英文 README，中文为主，提供版本对应表和安装指引。
• 项目自有代码新增 MIT 许可证，第三方内容保留原有许可。

像塑已提供官方 MCP，建议优先使用官方接入；需要 stdio 或本项目保留能力时再使用本项目。

验证范围

• 37 项自动测试通过，包含官方 38 个工具的 stdio 转发合同测试。
• 9.7.2 实机通过场景编辑、脚本注册挂载、编译、真实预览与日志、原生保存。
• 已真实生成并导入 1 张图片、1 段短音频。
• AI 工作流能力查询、H5 渲染参数及受管产物发布已实测。
• 完整 H5 导入／云端视频、AI 工作流完整编辑／整图生成，以及 9.7.2 整套旧试玩回归尚未实机验证。

升级

获取 v0.3.0 源码，按 中文 README 或 English README 安装依赖并重新运行插件安装器。保留原工程目录配置；先保存工作，再重开像塑工程并重新连接 MCP。

新版适配需求见 Issue #5。

v0.2.2 · 像塑 9.5.2 截图与文字布局修复

修复像塑 9.5.2 的截图与文字布局兼容问题，解决 #3。

修复

• 指定 path 截图时不再在编辑器进程加载 sharp，改用 PNG/JPEG 头解析尺寸，避免原生模块 ABI 不兼容。
• 文字显式尺寸在整批写入前检查；同批操作继承前一步文字框模式，切回 dynamic 后改尺寸会拒绝整批写入。
• 兼容 9.5 Text2D 的 layoutMode 字段，保留旧版 boxDimension 支持；fixedWidth 的高度随内容变化并标记为未验证。

验证

23/23 自动测试通过。像塑 9.5.2.887097048 测试副本通过带/不带 path 截图、三种文字模式读回、连续修改与零写入预检、官方编译和短 MP4 录制。测试对象已清理，工程文件哈希未变。

本次为相关功能专项验证，未逐项验收全部工具。详细范围见 验证记录。

升级

更新源码并安装依赖后，运行 node scripts/install.mjs 更新 MCP 用户插件；保存工作后重新打开像塑工程加载插件。此安装脚本不负责更新像塑应用，像塑应用请使用软件内部更新。桥接协议版本仍为 2。

完整变更 · PR #4

v0.2.1 · 像塑 9.4.1 兼容

像塑 9.4.1 兼容与安装范围调整

在 0.2.0 的 9.4.0 适配基础上，完成像塑 9.4.1 的审查和核心实机回归，并保留 9.4.0 支持。

• 核对 9.4.1 的官方命令结构与安装包，更新对应版本信息；调整测试与说明以适应官方音量语义变化。
• 像塑 9.4.0 及之后版本默认允许安装。**核心工作流只在 Windows 版 9.4.0、9.4.1 实测。**后续版本或同版本不同安装包会显示未验证提示，使用者需在测试工程验证所需功能。
• 保留仓库命令清单基线检查，以及 MCP 服务与已加载插件的协议、运行时代码和命令清单一致性检查。
• 18 项自动测试通过；9.4.1 核心实机回归通过。安装成功不等于所有工具或新编辑器版本均已验证。

详细边界见 9.4.1 审查记录和 README。审查记录描述的是当时的严格安装策略；本 Release 已包含后续的安装范围调整。

v0.2.0 · 像塑 9.4.0 适配

像塑 9.4.0 适配

首个公开的 0.2 系列版本。通过本地 MCP 服务和像塑用户插件，提供场景编辑、素材绑定、TypeScript 脚本、编译、预览截图与试玩等能力。

• 适配并实测 Windows 版像塑 9.4.0；安装器核对编辑器版本及官方包哈希。
• 改进场景读回与写入预检、截图落盘、工程路径限制、文件覆盖保护、桥接与命令清单一致性检查。
• 提供 9.4 的 setupGameScript 和试玩工具入口；保留旧脚本入口用于兼容。
• 17 项自动测试通过，并在可丢弃测试工程完成核心实机回归。

工具入口数量不代表全部能力均已实测；官方云端生成尚未接入。详细验证范围见 0.2.0 升级记录。