القائمة
3D 渲染调试。当用户报告 3D 模型显示异常、骨骼错位、纹理问题时使用此技能。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف 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 调用 |