Menú
3D 渲染调试。当用户报告 3D 模型显示异常、骨骼错位、纹理问题时使用此技能。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Wails Binding 签名一致性。对比 Go 端导出函数 vs 前端 wailsjs。
问题排查记录搜索。按关键词查找 bug-chronicle.md 中的相关 bug。
构建与调试流程。Go 后端编译、前端 Vite 构建、完整 Wails 构建、测试。
注释质量检查。检测 AI 废话注释、空 JSDoc、TODO 无编号、调试日志等。
项目结构扫描与 AGENTS.md 更新。扫描 Go 包和前端组件结构，输出文档地图更新建议。
项目健康诊断。一键检查 Go 编译、前端构建、文件完整性、治理红线、配置一致性。
| name | 3d-debug |
| description | 3D 渲染调试。当用户报告 3D 模型显示异常、骨骼错位、纹理问题时使用此技能。 |
在 DevTools 控制台执行：
window.debugGetSpec("path/to/model.ysm")
检查输出：
localPosition 是否合理（骨骼相对父级的偏移）localRotation 四元数是否为 [0,0,0,1] 或合理值texIdx 是否正确分配读取 BedrockModel JSON（解压后的 models/main.json）：
{
"bones": [
{
"name": "Head",
"pivot": [0, 24, 0],
"parent": "AllBody"
}
]
}
对比 spec 输出：
Head.localPosition 应该 = Head.pivot - AllBody.pivot取一个已知骨骼，手动计算预期坐标：
Head: pivot=[0,24,0], parent=AllBody: pivot=[0,0,0]
预期: localPosition = [0,24,0] - [0,0,0] = [0,24,0]
如果实际值与预期不符，问题在 go/threejs/spec.go。
根因：坐标系转换错误（X 轴取反）
检查：spec.go:72 的 pivot 处理
// 正确：不取反
np := vec3{b.Pivot[0], b.Pivot[1], b.Pivot[2]}
根因：eulerToQuaternion 符号或顺序错误
检查：spec.go:104
// 正确：三轴均取反
localRot = eulerToQuaternion(-b.Rotation[0], -b.Rotation[1], -b.Rotation[2])
根因：texIdx 未正确分配
检查流程：
[YSM] 纹理: 日志确认 texIdx 分配[3dspec] 日志确认 MeshData.texIdx 值根因：同名骨骼覆盖策略问题
检查：spec.go:73-78 的 pivots map 逻辑
parent 的骨骼 pivot// 获取 Go spec JSON
window.debugGetSpec(path)
// 打印 Three.js 场景信息
window.__dumpScene()
docs/3D-RENDERING/3d-rendering-report.md — 完整开发报告docs/3D-RENDERING/2026-06-17-summary.md — 修复总结docs/3D-RENDERING-PLAN.md — 攻关计划| 文件 | 职责 |
|---|---|
go/threejs/spec.go | Go 端骨骼计算、pivot、顶点、四元数 |
go/geometry/archive.go | ZIP/7z 解析 + ysm.json 读取 + TexSlot 分配 |
frontend/js/utils/model3d.js | Three.js 3D 渲染 |
frontend/js/utils/model3d-loader.js | 纹理加载 + spec 调用 |