renderdoc-analyzer

RenderDoc 抓帧逆向分析

概述

此 Skill 提供从 RenderDoc 抓帧文件（.rdc）进行渲染逆向工程的完整工作流，涵盖：

• 打开并浏览 .rdc 抓帧文件
• 识别和定位特定渲染部件的 DrawCall
• 逆向分析着色器（顶点 + 片元）
• 导出贴图、模型、Shader 为 Unity 可用资产
• 生成渲染耗时统计和完整使用文档

核心原则

⚠️ 人工决策优先

严禁自行决定分析范围。 必须由用户明确指定要分析的部件或范围：

• 如果用户说"分析头发"→ 只分析头发相关 DrawCall
• 如果用户说"分析全部"→ 分析所有 DrawCall
• 如果用户说"分析这个 DrawCall"→ 只分析指定的 Event ID
• 如果用户没有指定分析范围 → 主动询问用户要分析哪些部件，提供 DrawCall 列表供选择

⚠️ 基于证据判断

严禁凭经验猜测。 所有判断必须基于实际数据：

• 识别 DrawCall 内容必须通过缩略图对比，不能仅凭面数猜测
• Shader 逆向必须基于 SPIR-V/DXBC 反编译，不能凭渲染效果推测算法
• CBuffer 参数必须从反射数据精确提取 byte offset，不能假设布局
• 纹理用途必须通过查看实际贴图内容确认，不能仅凭 slot 名猜测

工作流

整个分析流程分为 6 个阶段。根据用户需求执行部分或全部阶段。

阶段 1：打开抓帧

1. 检查 RenderDoc 是否在运行（ping）
2. 如未运行，使用 launch_renderdoc 启动并加载 .rdc 文件
3. 如已运行，使用 open_capture 打开指定文件
4. 等待 bridge 就绪（大文件可能需要 60-90 秒）
5. 使用 get_capture_status 确认 API 类型（Vulkan/D3D11/D3D12/OpenGL）

阶段 2：帧概览与 DrawCall 识别

1. get_frame_summary 获取帧统计（总 DrawCall 数、Dispatch 数等）
2. get_draw_calls 获取渲染层级结构，识别主要 Render Pass
3. identify_drawcalls 生成每个 DrawCall 的 RT 缩略图：
   • 指定 output_dir 保存缩略图 PNG
   • 指定 render_target 为主色彩 RT 的资源 ID
   • 限定 event_id_min/event_id_max 到主渲染 Pass 范围
4. 查看缩略图逐一比对，精确识别每个 DrawCall 渲染的内容（皮肤、头发、眼睛、装备等）
5. 将识别结果汇报给用户，等待用户指定要深入分析的部件

阶段 3：Shader 逆向分析

对用户指定的目标 DrawCall：

1. reverse_shader 获取片元着色器完整数据：
   • SPIR-V/DXBC 反编译
   • CBuffer 反射数据（精确 byte offset）
   • 绑定纹理列表（资源 ID、尺寸、推断角色）
   • 运行时 CBuffer 值
2. reverse_shader 获取顶点着色器数据
3. get_pipeline_state 获取完整管线状态（RT 格式、Viewport、混合模式、深度测试等）
4. get_bound_textures 确认纹理绑定的实际资源 ID
5. export_drawcall 导出完整 DrawCall 数据（所有平台反汇编 + 纹理 PNG + summary.json）
6. 查看导出的纹理图片确认每张贴图的实际内容和用途

逆向代码时的精确性要求（详见 references/workflow.md）：

• 所有 helper 函数必须 1:1 从 SPIR-V/DXBC 指令翻译
• 所有魔法数字必须从常量池精确提取，注释来源
• CBuffer 布局必须精确到 byte offset
• 循环结构必须从控制流精确还原

阶段 4：Unity 资产导出

当用户要求导出到 Unity 时：

1. 创建输出目录结构:

   <OutputName>/
   ├── <Name>.shader        # Unity ShaderLab + HLSL
   ├── Textures/            # 所有关联纹理
   └── Models/              # 网格模型 (.fbx/.obj)