文档目录 · MCP 使用与接口 · Agent 设计与验收
本页记录通过 MCP 让 Agent 完成真实建模任务的人工实测结果。接口存在不等于任务能可靠完成，因此这里只记录实际跑过的样本；缺失的信息标为"未记录"，不做推测。
| 任务 | 状态 | 评价 | 返工 | 模型 | 样本数 | 备注 |
|---|---|---|---|---|---|---|
| 添加小装饰与开关 | 已验证 | 可用 | 无 | gemini3.8f | 3 | 效果较好 |
| 参数调整 | 已验证 | 很好 | 无 | 未记录 | 未记录 | 环境与样本待补 |
| 表情与动作差分 | 少量验证 | 勉强 | 中 | gemini3.8f | 2 | 细节未记录 |
| 表情、姿势组与动作 Event | 未测 | — | — | — | — | 已有 expression_*、pose_*、motion_set_event 操作与 exp3 / pose3 导出，尚无 Agent 实测 |
| 简单图层切分 | 未测 | — | — | — | — | 已有素材拆分接口，尚无实测 |
| 口腔部件拆分 | 未测 | — | — | — | — | — |
| 头发拆分与遮挡补全 | 已验证 | 不可用 | 未记录 | gpt6-astra | 3 | — |
| 挥手动作 | 未测 | — | — | — | — | — |
| 循环动作与时间轴辅助 | 未测 | — | — | — | — | 已有 motion_close_loop、参数循环与 timeline_* 接口及回归测试，尚无 Agent 实测 |
| 关键形复制、重置、补间与多键编辑 | 未测 | — | — | — | — | 已有 keyform_apply 的 paste / reset / interpolate / multi_key，尚无实测 |
| 尾巴变形与物理 | 已验证 | 勉强 | 无 / 少 | gemini3.8f | 未记录 | 容易完成，但效果一般 |
| 自生成图像与九轴调整 | 未测 | — | — | — | — | — |
| 网格手工修正（加点、删边、重新三角化） | 未测 | — | — | — | — | canvas 的 topology 分支已支持，尚无 Agent 实测 |
绘画会话选区、渐变与模糊（paint_session_control） |
未测 | — | — | — | — | 接口与界面已实现并有回归测试，尚无 Agent 实测 |
| 设置点击区域并验证命中 | 未测 | — | — | — | — | 已有 hit_area_* 接口（hit_area_test 按运行时规则命中测试）与预览单击验证，尚无 Agent 实测 |
| 物体复制粘贴、查找替换与 ID 转变 | 未测 | — | — | — | — | 已有 object_paste/mesh_duplicate/object_find/object_rename/object_convert_id 与回归测试，尚无 Agent 实测 |
是否需要图像生成取决于具体任务：调整已有参数或物理不需要；补画被遮挡区域或新增素材则需要宿主提供图像生成能力。
| 评价 | 含义 |
|---|---|
| 很好 | 稳定完成 |
| 可用 | 完成，需要少量人工修正 |
| 勉强 | 需要大量返工或人工兜底 |
| 不可用 | 未完成，或结果不可接受 |
少量成功样本不代表在其他素材上同样稳定。
每条记录请包含：
- 应用版本或 commit、宿主、模型；
- 任务描述与源素材，是否使用了图像生成；
- 样本数、返工次数、耗时与额度消耗；
- 结果文件或历史节点，以及明确的通过 / 失败原因。
验收时对照实际模型的中立姿态、参数端点与动态效果，并检查保存重开和导出结果。仅有参考图、工具成功返回或单张截图，不足以证明任务完成。
JVM 插件契约已抽为 algorithm-api 独立模块，宿主改为依赖该模块；实例和包引用、版本解析、依赖范围及实际求值接口不再随应用源码定义。独立模块的三项回归通过：无宿主实现求值、旧 JSON 与固定引用读回、版本范围比较。此项证明接口可独立编译，不代表内置算法包加载和历史二进制保留已经完成。
物理组算法已独立构建为可安装 JVM 包。开发工具实测安装、常驻进程连续两次求值、卸载及原包重装后求值均通过，完整结果与应用进程内的同一实现一致，包含输出别名和无关素材保留；安装包不含应用、UI、工程或 Umamo 类。工作进程通过带摘要的模型对象差异返回结果，不委托宿主重新执行物理算法。对象传输与结构校验定向测试通过。当前包身份改为 builtin.70687973696373.v1，以 physics 别名保持工程类型；完整包保留、旧版本目录重开、实例 JSON 读回后的固定引用求值及卸载重装恢复均通过开发工具检查。别名冲突与管理 schema 定向回归通过。这尚未覆盖其他内置算法迁出，也不代表完整工程冷重放验收已完成。
动作算法已迁到 :algorithms:motion，配置数据、JSON 读写和曲线转换由独立模块提供，应
7C61
用注册入口只委托调用。独立模块的两项回归通过，覆盖四种插值、事件、参数角色、固定输出 ID、冲突与取消；应用动作回归和分层约束检查通过，物理与动作两种独立包均通过安装、常驻进程求值、目录重开和卸载重装恢复检查，且安装包不含应用或 Umamo 类。此项尚未覆盖其余生成模板迁移。
摆动算法已迁到 :algorithms:swing：网格包裹、关键形生成与物理组定义独立执行，应用入口不再把求值交给编辑日志。开发工具验证包裹结果与原日志重放一致，并通过真实工作进程、安装目录重开和卸载重装恢复；静止姿态与固定边的独立回归通过。此模块依赖 GPL Umamo 和格式转换器，安装包含引擎但不含应用、工程、历史或 UI 类。派生输出规则约束旧名称前缀、实例输出 token、对象种类与规范后缀，定向验证通过。
烘焙模拟求值已迁到 :algorithms:simulation。真实安装包验证通过：自动权重与原日志路径一致，输出包含模式参数、网格关键形和物理组，目录重开与卸载重装后可恢复。模拟导出及无窗口烘焙入口的相关回归通过。数值烘焙仍在原流水线中执行，未调整求解器；基础绑定仍待独立迁移。此批迁移覆盖烘焙结果的独立求值。
基础绑定开始迁入 :algorithms:binding。目前拆出表情开关参数及透明度曲线计算，由原生成器和修改器共享；普通自定义表情不再为了获取这些通道调用整套绑定生成器，标准参数名称冲突仍使用原兼容路径。独立核函数回归、修改器相关回归及表情透明度／顺序／应用前缀等价检查通过。表情应用已进一步迁为独立 ExpressionAlgorithm，经作者输入上下文执行；通道残差合成由应用和插件共用。独立模块测试验证作者透明度残差、未选网格和取消，原表情等价回归继续通过。表情开关现已生成独立安装包，真实工作进程的连续求值、目录重开、实例身份恢复、卸载重装及规范入口调用通过开发工具检查。宿主批准的动态共享参数定向验证通过，错误定义及未批准的新增参数被拒绝。其余绑定尚未完成独立包迁移，也未实测本项对完整生成耗时的改善。
六种语言（Python、Kotlin、Rust、C、C++、C#）的示例已在 Windows 上构建为独立安装包，通过隔离目录安装、常驻进程连续两次真实求值及卸载检查。共享管理接口的严格 schema、包身份和作者输入缓存有定向回归；禁用缓存后的完整 IR 与缓存结果一致。此项是开发工具验收，不代表 Agent 建模或 GUI 人工验收。
内置算法已逐项提供插件身份、完整包版本与入口代码摘要，新建实例固定引用，旧实例仍按原格式读取。摆动、模拟、物理、动作、表情开关、眉眼透发和皮肤裁切已拆出独立实现入口；GUI／MCP 支持逐项启停，外部包可声明对内置入口的版本依赖。身份持久化、严格 schema、依赖停用与恢复已通过定向回归。其余绑定类仍调用共享模板生成服务，尚非独立安装 JAR，其历史实现的独立分发与保留尚未完成，不能视为全部插件化验收完成。
已修复显式动作与旧保留名称冲突、生成动作自动打键的归属，以及 Windows 卸载插件时工作进程残留文件句柄的问题。预设回归区分旧版独立目标结构和新版共享结构；遗留失败已收敛，前一轮全量 test 通过（未变更的子模块任务复用 Gradle 结果）。
本轮先完成独立算法接入和旧模板代码清理，性能优化在重构交付后进行。诊断报告保留完整生成和同步烘焙耗时。几何边界、脸部特征点与模拟求解的帧内常量已复用；源图分类缓存排除修改器配置与烘焙数据，普通作者输入仍参与缓存失效。模拟输入指纹跟踪目标、碰撞对象、Glue 连接对象及父级变形器，保守保留其余附属输入。首次导入冻结图集与分类整理保留求值缓存，模拟预检接续几何缓存；模板缓存不再依赖临时预览图片的对象身份。表情颜色与开关的配置不再使网格几何缓存失效；实际构建次数下降，完整 IR 冷重建一致，但尚未证明端到端耗时稳定下降。开发工具实测眼部调整不触发衣物重烘焙，调整后的缓存结果与关闭缓存的完整 IR 一致。
外部工作进程的崩溃、错误响应、非法输出、超时、执行中取消、排队取消、卸载中断和重新安装后求值已通过定向回归；排队取消不打断其他正在执行的请求。本机真实 Git 服务验收覆盖标签、完整提交号、默认分支、版本并存和安装后求值，修复了 Windows 只读 Git 对象导致临时仓库清理失败的问题。HTTPS／SSH 凭据环境、复杂外部算法及 GUI 操作尚未完成完整验收。实现与协议见算法插件。
源图拟合已按图层内容与顺序、坐标系、眼部中线、手柄移动后的拟合结果及部件声明共享缓存，运动选项仍独立求值。专用性能工具验证调整后的完整 IR 与关闭缓存重建一致，且眼部调整未触发衣物重烘焙；本次同机前后测量未证明明显的端到端提速。参数查询触发的整套绑定模板构建仍是待替换路径。
腮红与阴影颜色核已迁入独立绑定模块。颜色追加路径局部更新转换前输入，再重跑原 Cubism 转换，避免遗漏因颜色轴增加而需要的转向变形器；转换前输入延迟求值，未使用的模板不额外转换 UV。颜色覆盖／应用前缀、旧工程完整转换回归通过，专用工具的缓存结果与完整生成 IR 一致；整套绑定构建次数减少，但该次测量仍未证明端到端提速，首次目标仍未达成。这两类修改器尚未完成可安装入口迁移。
Cubism 混合形转换已抽出为独立绑定模块的 BlendShapeLowering，应用层仅适配名称；保留关键形预算、承载变形器计算与确定性 ID，并支持调用方取消检查。转换几何效果、旧工程完整转换及独立模块取消回归通过。此轮未重测整链路性能，其余绑定入口仍需继续迁移。
颜色绑定的参数整理、参数树更新、所属通道替换和降级转换已整合到独立 MoodBinding 接口，产品层提供捕获的语义权重与参数定义。重复调整不累积参数、保留其他网格及完整转换一致性回归通过；可安装颜色入口与宿主覆盖适配仍待接入。
绑定局部遮罩判定已移入独立模块，改为按网格和指定祖先转换／缓存规范表示，避免每次构造完整 IR；几何数组、通道和祖先变化判定回归通过。专用生成工具确认参数调整不触发重烘焙，缓存结果与关闭缓存重建的完整 IR 一致。本次首次与重复生成、修改响应均低于上一记录，但单次差异不作为独立优化收益证明；首次生成仍未达到排除烘焙后的限制。
眉眼透发的副本、反向遮罩、透明度／绘制顺序继承及预览刷新已抽出为独立 SeeThroughBinding。应用层保留图层像素覆盖识别及配置／本地化适配，原类型与调用接口不变。眼睛和眉毛透发场景回归通过；可安装入口与捕获输入协议接入尚未完成，本轮未重新计时。
眉眼透发已接入版本化捕获输入及独立安装包，源图覆盖识别共享一次计算，插件按实际网格顺序生成副本／窗口。两种包的真实安装、工作进程重复求值、规范入口／旧别名一致、保存恢复与卸载重装均通过；现有透发效果、应用后副本保留及完整工程转换回归通过。此前记录的这两项安装入口待办已完成，其余绑定插件迁移仍未完成，本轮未重测生成时间。
对象引用重映射已迁入独立绑定模块的 ModelIdRemap，保留应用兼容别名；无关模型分区和网格不再重建。ID 全引用重写／冲突拒绝、对象操作、完整工程转换，以及独立模块的输入共享／关键形轴迁移回归通过。此轮未重新测量性能，不计作端到端提速验收。
作者几何残差、网格／变形器混合形的三方合并及顶点对应传递已迁入独立绑定模块，计算公式保持原样，应用旧名称为兼容别名。独立混合形与组合动作、生成闭嘴默认值的编辑归属、身体绑定及应用其前置结构的定向回归通过。这些是剩余绑定插件的共享依赖，不代表全部绑定入口已经完成迁移。
父级坐标转换已迁入独立 BindingFrames，普通重新绑定、修改器新增承载变形器及共享祖先下的局部反演共用同一算法；修改器调用可传递取消检查。保留作者父级与几何、身体绑定应用前置结构、结构特征位移应用后脸部绑定的定向回归通过。本轮为独立绑定接口补齐坐标传递能力，未重测生成性能。
绑定合并主流程已迁入独立 BindingMerge，应用层通过只读 Source 提供捕获投影、ID 映射和顶点对应，并保留物理与初始姿态策略。完整工程转换、独立混合形／组合动作、身体绑定应用前置结构回归通过；独立模块测试验证无应用服务的通道合并及取消。轴合并与有限坐标枚举也已共享。该边界尚不是外部传输协议，模板生成与剩余插件入口仍待迁移；本轮未重测性能。
皮肤裁切已成为独立可安装插件，直接修改 IR 遮罩，不经过整套绑定生成与模型转换；作者遮罩冲突和已生效实例的范围保持原语义。覆盖判定／目标范围、取消、原效果及应用后编辑、完整工程转换，以及真实安装／工作进程／卸载重装回归通过。专用工具确认缓存结果与关闭缓存重建的完整 IR 一致；首次耗时与上一记录基本相同，仍未达标，重复生成本次通过。后续绑定仍会为自身输入重建包含裁切的模板，不能把单项直算视为整条生成链路已经完成优化。
以皮肤裁切结尾的下游模板改为复用前置结果，仅合并插件产生的遮罩差异，并保留转换前输入的惰性捕获。修复应用前缀后此路径查询已移除实例的问题。裁切／颈部联动应用与历史恢复、完整工程转换回归通过；专用工具确认完整 IR 与无缓存重建一致、参数调整未重烘焙。该样例完整绑定构建次数未减少，首次生成仍未达标，不将本次局部模板复用视为端到端性能目标完成。
嘴部描边输入增加独立素材缓存与模板附加图集缓存，运动参数变化复用源轮廓／栅格，描边宽度、颜色及网格条件变化重新计算。新增缓存失效与像素等价回归，描边保存重开／导出读回及完整工程转换通过。专用工具确认最终 IR 与无缓存重建一致，后续模板的附加图集只打包一次；本轮端到端耗时高于上一记录，不能据此声称整链路提速，首次生成目标仍未达到。独立嘴部描边插件入口尚待迁移。
修复不兼容历史插件包阻断整个算法目录的问题：捕获输入适配契约在实际使用该包时检查，无关包仍可构建目录及校验；旧别名与规范入口均在输入捕获、参数查询、验证及求值前拒绝不匹配声明，并报告包身份。隔离回归及现有安装／重放／工作进程复用回归通过；未替换已固定版本，未重测生成时间。
描边几何计算已从产品层迁入独立绑定模块：轮廓边界、等弧长采样、交叉唇线路径、圆角／端帽带状网格只读取数组和数值，产品保留适配。绑定包版本递增，未改变公式与拓扑。独立模块的轮廓／网格有效性与输入不变性、描边保存重开／导出读回、完整工程转换回归通过；源图栅格化及描边独立入口仍待迁移，本轮未重新计时。
描边的 RGBA 栅格化与边缘取色已移入独立 MouthOutlineRaster，宿主只适配坐标和图层包装；新增取消检查及绘图资源 finally 释放。平移像素一致性、边缘取色排除内部／透明 RGB、取消，以及描边保存重开／导出读回、完整工程转换回归通过。绑定包版本递增；网格生成与实例输出组装仍待接入独立描边入口，本轮未重测性能。
插件目录与依赖解析增加按管理修订失效的有界缓存；安装、卸载、重装、启停及传递依赖恢复回归通过，仍保留完整性检查与固定依赖版本。专用生成工具确认重复查询复用解析、重复生成无需重新解析，缓存模型与无缓存重建的完整 IR 一致，修改未触发模拟重烘焙。首次生成仍未达到排除烘焙后的时间目标，不能把目录缓存视为剩余算法迁移或性能验收完成。
插件载荷完整性校验改为固定缓冲的流式 SHA-256，避免为每个历史可执行包分配完整字节数组；增加块间取消检查及单独阶段计时，仍完整校验全部内容。跨块／空文件哈希一致性、取消后释放、损坏包恢复及失败安装不发布回归通过。专用工具确认完整 IR 等价与修改不重烘焙；载荷校验并非当前首次生成的主要耗时，首次时间目标仍未达到。
共享变形器缓存键收窄为实际读取的配置，局部眼部形变及描边素材设置不再触发整体重建，视线联动等真实输入仍失效重建。局部配置复用／视线失效、源拟合缓存及完整工程转换回归通过；专用工具确认共享变形器构建次数减少，完整 IR 与无缓存路径一致、修改不重烘焙。完整绑定模板构建次数仍未减少，首次生成仍未达到时间目标。
身体网格缓存移除眼眉嘴局部模块配置，保留胸部／颈部／转向与父级几何输入；面部选项复用身体网格、胸部选项失效重算和完整工程转换回归通过。专用工具确认网格及关键形重复构建次数减少，完整 IR 与无缓存路径一致。端到端时间变化较小，首次生成仍未达到目标，完整模板及剩余绑定插件迁移仍待继续。
眉毛的像素拟合、基础眉高／角度关键形及眉形、眨眼联动、回弹计算已迁入独立绑定模块，边界／左右侧成为共享数据类型，产品保留类型别名与图层输入适配。新增纯像素输入、运动输出及取消回归；缓存、完整工程转换、组合姿态应用前缀及拟合算法版本持久化回归通过。绑定包版本递增；独立可安装眉毛入口和实例合并传输仍未完成，本轮未重新计时。
头部深度转向、胸部运动、薄板样条及平滑位移场已迁入独立绑定模块，产品保留类型别名；计算公式不变，公开取消检查及线性求解入口。中立姿态、刚性附件、仿射插值、固定节点、取消，以及眼部拟合、几何缓存、完整工程转换和组合姿态应用前缀回归通过。绑定包版本递增；这些共享内核尚不代表对应修改器独立入口迁移完成，本轮未重新计时。
薄板样条的 X／Y 坐标拟合改为共用一次矩阵消元，新增可复用的多右端列求解入口，保留各列的运算顺序和奇异主元行为。带换行主元的已知解、奇异矩阵、输入不变性、单次消元检查，以及完整工程转换、组合姿态应用前缀回归通过。绑定包版本递增；本次未重测整链路，不能据此宣称首次生成达标。
表情开关仅引用眼／嘴开合标准参数时，参数捕获改为直接读取拟合范围，不再生成完整模板。定向回归验证查询未构建网格、参数与完整生成一致、应用后重建一致，以及原有表情与物理链组合保持正常。其他标准参数可能经 Cubism 降级改变类型，仍保留兼容路径；未新增独立插件类型，未重测完整生成时间。
眉毛原始像素拟合接入共享阶段缓存，运动选项和手柄修正不再重复扫描像素，修正继续在拟合后应用。定向回归验证运动配置复用同一拟合、手柄编辑不重新测量、源像素变化失效、缓存与独立重建的完整 IR 一致，以及组合姿态应用前缀一致。眉毛完整可安装入口仍待接入，本轮未重测端到端生成时间。
模板参数裁剪改为有序批量删除，保留每项的网格／通道折叠与混合形清理，仅在末尾派生渲染树。批量与逐项删除的通道／部件／渲染树一致性、空操作、重复参数、取消不修改输入，以及完整工程转换和组合姿态应用前缀回归通过。所有携带变更引擎字节码的内置包递增包版本；算法行为版本未变，独立算法入口迁移仍未全部完成。
本轮专用工具确认完整 IR 与无缓存重建一致、调整不触发模拟重烘焙；首次生成仍未达到排除烘焙后的时间目标，且本次测量比上一轮更慢，尚未证明端到端提速。完整绑定模板的重复构建仍在，需继续定位并迁移。
模板参数裁剪和静态姿态投影迁入独立 BindingProjection，宿主只传入保留轴与源图默认姿态。插值静态网格／变形器、剩余轴、源图默认值覆盖、输入不变性、取消及非有限默认值拒绝回归通过；完整工程转换和组合姿态应用前缀回归通过。绑定包版本递增，完整模板生成仍待拆除，本轮未重新测量性能。
绑定结构执行迁入独立 ScaffoldBinding，直接调用引擎进行坐标迁移与组织树移动，宿主不再通过 JSON 编辑分发器组装层级。新增只读捕获输入适配器及共享／逐目标层级、确定性身份、重复输出拒绝、取消回归；完整工程转换、共享层级固化别名与特征位移应用前缀回归通过。绑定包版本递增；结构模板来源和安装包入口仍待迁移，本轮未测量性能。
绑定结构的算法修订 1／2 已具有独立安装包、工作进程入口及 scaffold/1 二进制作者输入，应用保留完整包并固定版本与内容。实际安装、旧名称与规范入口求值、工作进程复用、保存恢复、卸载重装均通过；包内不含应用／项目／历史／界面类。工程转换和共享层级固化别名回归通过。完整可安装类型增至九类，但结构模板仍由宿主捕获生成，其他绑定入口迁移尚未完成。专用工具验证完整 IR 等价、调整无重烘焙；首次生成仍未达到排除烘焙后的时间目标，模板构建次数未减少。
绑定结构捕获资源缩减为目标网格及必要框架，移除源文件／图集清单、无关网格与外观元数据，保留完整部件和变形器顺序。定向回归验证资源体积缩小、v1／v2 在完整与精简输入上的结果一致、已编辑网格的坐标迁移一致，以及完整工程转换和共享层级固化别名一致。绑定包版本递增，旧完整输入继续兼容；本轮未重测端到端时间。