renderdocBread README

项目的 README,来自 github.com/Straw1997/renderdocBread。合并为一个 markdown 文件:README.md。

RenderDocBread

RenderDoc 史诗升级,内嵌 AI、调试工具,快使用它来调试渲染吧!

直接在捕获帧中提问,让 AI 分析渲染流程、整理和调试 Shader、动态调整 CBuffer;也可以让 AI 将选定的渲染效果移植到 Unity,搭建可编辑的场景,再对照画面逐步调整。

📖 完整介绍与使用教程:RenderDocBread 史诗升级(知乎)

下载

在 Releases 下载 Windows x64 完整便携版和 SHA-256 校验文件。解压后运行 RenderDocBread.exe。

效果演示

一句话在 Unity 中还原渲染

从捕获中分析模型、纹理、Shader 和参数,在 Unity 中还原并对照效果。

https://github.com/user-attachments/assets/74984035-3306-43dd-b3bd-e33d555f3b32

MP4 文件:Unity 效果还原演示(约 25 秒,含音轨)

https://github.com/user-attachments/assets/22e66080-ca93-40d0-ab08-dcc3c5565b2a

MP4 文件:Unity Frame Debugger 绘制过程(约 15 秒,含音轨)

复杂的光照、后处理和历史帧效果仍需要结合捕获内容分析、移植与校准。

RenderDoc 中直接使用 AI

在同一个窗口中查看捕获、阅读整理后的 Shader,并让 Bread AI 调用工作流与工具继续分析。

RenderDocBread 与内嵌 Bread AI

Shader 可视化调试

选择代码中的变量或计算结果,直接输出到画面,观察这一部分对渲染的影响。

Shader 可视化调试动图

CBuffer 参数动态调整

为参数整理可读名称,修改数值后实时观察捕获画面的变化。

CBuffer 参数动态调整动图

帧渲染流程图

把一帧中的绘制阶段、输入输出纹理和关联事件串起来,点击查看对应内容。

帧渲染流程图

那里不懂圈那里

在渲染目标(RT)上用画笔、圈选或箭头标出想问的位置,直接问 Bread AI「这里的水滴是怎么做的?」AI 会结合标记和捕获数据分析对应的绘制与计算。回复可以用流程图、关键代码和滑动对比展示各层效果,并跳转到相关事件、纹理或 Shader。

在渲染目标上圈选并向 Bread AI 提问

Bread AI 的渲染分析回复和可点击的流程图

滑动查看关闭水痕前后的画面差异

网格查看器

并排查看 3D 网格和 UV 展开图。点、边、面的选择在两侧同步高亮,可切换顶点着色器输入与输出,并用捕获中的纹理及其通道检查 UV 映射。

网格查看器的 3D 与 UV 联动和纹理预览

图示来自演示版本,界面以当前版本为准。

新增与拓展

功能 可以做什么
Bread AI 在 RenderDoc 内对话,使用 Skills、MCP 和内置工具分析捕获;支持模型 API 与 Agent 订阅连接。
项目与资源关联 保存项目中的 Shader、参数别名与分析成果;关联解包资源,辅助查找模型、纹理和材质信息。
着色器工作区 将 Shader 整理为可读函数、计算目录和流程图,编辑、编译、替换并观察渲染结果。
Shader 与 CBuffer 调试 可视化查看中间计算结果,动态调整参数,定位画面差异。
帧渲染流程图 由 AI 梳理 Pass、事件和资源关系,在应用中查看通道详情、跳转事件并导出流程图图片。
那里不懂圈那里 在渲染目标上标记后向 Bread AI 提问,用流程图、滑动对比和可跳转的关键代码查看效果是怎么做出来的。
网格查看器 3D 与 UV 同步选择点、边和面,查看顶点着色器输入与输出,以及捕获纹理的通道。
Unity 效果还原 导出并移植模型、纹理、Shader 和参数,搭建材质、预制体与场景;自动准备 Unity MCP 连接,断线后恢复并继续处理。
日常调试改进 事件过滤、书签与 Shader 跳转、RT 历史、像素检查,以及中英界面和黑色主题。
智能体监视器 查看 AI 任务、工具调用和执行状态,方便跟进分析过程。
查看智能体监视器

智能体监视器

从源码构建

普通 git clone 会包含完整的封存依赖分卷,构建入口会自动离线还原和校验,无需从 Release 单独下载依赖或运行 Git LFS。开发机需安装 Visual Studio C++、Windows SDK、64 位 Python 3.12 和 .NET SDK;运行 PACKAGE_RENDERDOCBREAD.cmd,具体版本和步骤见构建说明。

基于 RenderDoc 拓展。首方代码许可证见 LICENSE.md,随附依赖按各自许可证与通知分发。

renderdocBread (Straw1997/renderdocBread)

正在搜索数据库…

这是什么?RenderDocBread 是图形调试器 RenderDoc 的扩展分支版本,内置 AI 功能。你可以针对捕获的帧提问、分析渲染管线、编辑和调试着色器,并实时调整常量缓冲区的值。
它是 RenderDoc 原版的插件,还是一个独立的应用?它是一个独立的修改版。你通过 RenderDocBread.exe 启动,AI 面板、着色器工作区和其他扩展工具都在同一个窗口里。
我该怎么让它运行起来?从 Releases 下载 Windows x64 便携版压缩包和 SHA-256 校验和文件,核对哈希值,解压压缩包,然后运行 RenderDocBread.exe。无需安装程序。
Unity 的还原效果总是能完美呈现吗?并不总是。复杂的光照、后处理以及依赖历史帧的效果,仍需要在捕获的数据基础上进行分析、移植和手动校准。
它能在 Windows 之外的系统上运行吗?不能。目前列出的下载版本只有 Windows x64,而且从源码构建还需要 Visual Studio、Windows SDK 等 Windows 开发工具。
我能直接编辑着色器并马上看到效果吗?可以。着色器工作区支持编辑、编译和替换着色器,然后你可以在捕获的数据中观察渲染效果如何变化。
我能修改常量缓冲区的值,并看到画面随之更新吗?可以。参数会显示为可读的名称,你可以修改它们的值,捕获的帧会实时更新。
它能把捕获的效果迁移到 Unity 里吗?可以。它能导出模型、纹理、着色器和参数,并帮助在 Unity 中重建材质、预制体和场景。它还会准备一个 Unity MCP 连接,断开后可自动恢复。
相比 RenderDoc 原版,它增加了哪些功能?Bread AI、着色器工作区、AI 生成的帧渲染流程图、同步的 3D 网格与 UV 查看器、项目与资源关联,以及用于跟踪 AI 分析步骤的智能体监视器。
作者
Straw1997
大小
1.3 GB
星标
305
时长
9个月
提交 · 90 天