安装与版本
- 下载 QRD-0.01.5-win64-Setup.exe。在文件所在目录运行
Get-FileHash -Algorithm SHA256 -LiteralPath .\QRD-0.01.5-win64-Setup.exe,把输出与下载页比对。下载与校验 - 确认文件来源后运行安装向导,默认安装目录为
C:\Program Files\QRD。安装需要管理员权限,未签名的测试包可能显示“未知发布者”。 - 从开始菜单启动 QRD。在“帮助 → 关于”确认版本为 0.01.5。需要检查本机组件时,可运行开始菜单中的自检入口。
打开现有 RDC
- 在 QRD 选择 文件 → 打开捕获,打开已有的
.rdc。 - 等回放加载完成,确认事件浏览器有事件,并记录图形 API。回放报错、降级或缺少事件时,先保留错误信息。
- 选中帧末的
Present或最后写入最终画面的事件,在纹理查看器确认实际画面。记录帧号、事件编号(EID)和输出资源。
第一次使用可以从已有 RDC 开始。查看两条实际记录
捕获自己的应用
- 选择 文件 → 启动应用,填写你有权调试的程序路径。只有应用确实需要时才填写工作目录和启动参数。
- 启动后进入要检查的画面,按捕获覆盖层提示的键,默认是 F12 或 Print Screen。触发后等捕获条目出现,再保存
.rdc。 - 重新打开保存的文件,核对 API、事件列表和最终画面。以实际输出确认抓到了目标画面。RenderDoc 1.47 快速入门
检查绘制、管线和资源
- 事件浏览器定位一次绘制或计算调度,记下 EID。
- 管线状态查看着色器、绑定的纹理和缓冲区,以及混合、深度和输出目标。
- 纹理查看器检查输出和中间结果。需要追踪某个像素时,在当前 API 和捕获支持的情况下使用像素历史。
- 网格查看器核对顶点、索引和几何输出。比较两帧时分别定位事件,记录各自的 EID 和资源 ID。
连接 AI 与 MCP
0.01.5 的 MCP 入口是随包 Python 启动的 mcp/gateway.py。qrd_full 提供独立的 RDC 回放工作进程。qrd_ui 只用于观察或操作已授权的 QRD 窗口。
- 打开 开始菜单 → QRD → MCP 连接配置,也可运行安装目录里的
Generate-MCP-Config.cmd。生成文件位于%LOCALAPPDATA%\Qinxa\QRD\mcp-config。 - 分析 RDC 时选
qrd_full。支持mcpServers的客户端使用qrd_full.json,Codex 使用qrd_full.toml中的配置段。合并到客户端原配置后,重新加载 MCP 或启动新会话。 - 确认客户端能列出
qrd_replay_open和qrd_event_evidence,再把本机的 RDC 路径交给 AI。桌面窗口和 MCP 回放各自加载文件。
[mcp_servers.qrd_full]
command = "C:/Program Files/QRD/runtime/python/python.exe"
args = ["-B", "C:/Program Files/QRD/mcp/gateway.py"]
自定义目录以本机生成的配置为准。可用 codex mcp list 检查配置,再在 Codex 会话中确认工具可调用。Codex MCP 官方文档
交给 AI 的回放提示词
用 QRD MCP 回放我提供的本机 RDC,只做分析。
查看工具列表后,用 qrd_replay_open 打开文件。
记录 session_id、文件 SHA-256、图形 API 和 degraded 状态。
用同一 session_id 和我给出的 EID 调用 qrd_event_evidence,
核对着色器、资源绑定、常量缓冲和渲染目标。
按「观察结果、EID 与资源 ID、证据限制」汇报,并给出证据索引路径。
回放降级或导出不完整时,注明缺项和错误。
让 AI 跟进授权应用的抓帧
请 AI 用 qrd_capture_preflight 预检你有权调试的 Windows 程序。确认后用 qrd_capture_start 启动,记下 job_id,用 qrd_capture_job_status 查询进度。若已有文件候选而完成通知缺失,用 qrd_capture_job_validate 验证原任务。确认实际 RDC、SHA-256 和回放状态后,再开始分析。
需要观察 QRD 窗口时
在 QRD 的「自动化与 MCP」设置中启用观察。只需要窗口能力时,用生成的 qrd_ui 配置。AI 先调用 qrd_ui_get_guide 和 qrd_ui_list_instances,核对版本和进程后读取窗口状态。需要改动时由操作者授权,AI 等 qrd_ui_wait 返回后再读回结果。窗口截图能确认 Qt 界面,GPU 画面以 RDC 回放输出为准。
WorkBuddy 演示
在 QRD 中授权界面操作,将本机生成的 qrd_ui.json 合并到 WorkBuddy 的 MCP 配置。重连后确认 qrd_ui 工具可用。
演示用脚本直连本机 UI 网关,依次切换纹理查看器、管线状态、网格查看器和启动应用。每一步都等待切换完成,读回选中状态,再截图。
演示只切换主区标签页。查看实际渲染数据前,请先加载 RDC。 WorkBuddy MCP 配置指南
实测记录
以下案例整理自 AstraeOratio 项目的 2026-11-11 QRD 记录包。编号只对应各自的抓帧。
核对抓到的画面 · UE / D3D12
当时想捕获语言选择页,打开 RDC 后,通过 帧 17467、Present EID 11825 和输出 ResourceId::754 核对了 2560 × 1440 的最终画面,实际捕获的是序章。由此只能确认该帧的渲染输出。若要验证语言页,应在该页另抓一帧并重新核对。这份抓帧来自 UE 重建工程,音频需另行验证。
让 AI 核对一次绘制 · 0.01.4 / Vulkan
在 0.01.4 的 MCP 回放中打开一份已有 Vulkan RDC。get_capture_info 返回 1140 个事件、791 次绘制,且 degraded=false。查询 EID 2204,get_draw_info 返回 45,051 个索引、1 个实例,再从绑定和着色器反射交叉核对片元着色器为 ResourceId::512891。这次验证覆盖已有文件的回放及该次绘制。
常见问题
客户端找不到 QRD 工具
重新生成配置,核对 command 和 args 的安装路径。只看到窗口工具时,确认添加的是 qrd_full。升级后请重新生成网关配置,再用工具列表确认当前入口。
抓帧完成提示出现了,但打不开文件
确认已保存本地 .rdc 并能重新加载。记录图形 API、显卡、驱动和回放错误。能打开文件后再继续分析,并标注降级状态。
桌面已经打开抓帧,AI 为什么没有看到?
MCP 回放有独立会话。用 qrd_replay_open 打开原始 RDC,记录 session_id 和 SHA-256。后续查询沿用该会话。若网关重启,重新打开并核对 SHA-256。
升级或卸载前要保留哪些文件?
把需要的 RDC、导出结果和配置备份到自己的目录。0.01.5 的卸载保留用户抓帧、配置和报告。
终末地分析专题
用 QRD 检查《明日方舟:终末地》参考画面中与描边、角色、材质和场景有关的绘制。记录可回放的事件和资源,再验证候选解释。
证据状态 本节提供研究方法和记录模板。游戏的具体实现、纹理通道含义和捕获兼容性仍待实际捕获验证。
描边
不要把外轮廓、衣服接缝和头发内部线条合并为“描边”。它们可以有相似颜色,却未必来自同一个绘制步骤。选取人物肩部轮廓、发束交界和衣物接缝三个局部,分别记录线条出现的位置与宽度。
在 QRD 中检查 在可回放的捕获中,对照目标局部出现前后的输出,检查相关绘制的网格、剔除模式、深度状态和着色器。若线条与主体在同一次绘制中出现,继续检查材质纹理和着色逻辑;若是后续事件增加,再核对其输入是否包含深度、法线或其他屏幕纹理。
结论边界 “模型外扩”“屏幕空间边缘”和“纹理绘制的线”是待排查的候选解释。只有事件和资源能够对应,才给具体区域下结论;远近镜头的线宽变化还需要多帧对照。
脸部与头发
观察脸颊、鼻侧和下巴的阴影边界,再观察发束的亮带与暗部。先描述形状、颜色和边缘软硬,再提出实现假设,可以避免看见风格化阴影就直接认定使用 SDF。
在 QRD 中检查 分别定位脸部与头发的绘制,记录绑定资源、常量及输出。检查阴影分界是否能与某张纹理或某组参数对应;比较不同光向、视角时,固定其他条件,并标明每一张捕获的来源。
结论边界 单张截图不能证明脸部采用 SDF,也不能确定发丝使用各向异性、Matcap 或手绘高光。缺少可读着色器或对照捕获时,保留多种解释。
材质通道
皮肤、布料、漆面和裸露金属应该各选一块区域。记录其基础颜色、亮部形状、暗部层次与边缘表现,避免把曝光变化误判成材质变化。
在 QRD 中检查 从选中绘制的实际绑定出发,记录纹理资源 ID、尺寸、格式、mip 与采样位置,逐个查看 R、G、B、A。再结合着色器读取方式判断通道用途;颜色资源与数据遮罩的解码方式也要分别核对。
结论边界 文件名包含 Mask 或 Normal 只能作为线索。没有读取路径的证据,不把某一通道直接标成粗糙度、金属度、AO 或描边宽度,也不套用其他游戏的通道约定。
场景光照
先选一处固定构图,分别记录建筑的大色块、接触处暗部、远景对比和天空影响。角色的着色结论不能直接推广到场景,场景中不同类型表面也可能使用不同流程。
在 QRD 中检查 沿相关事件比较中间输出,寻找阴影、环境贡献、透明层与最终颜色处理发生变化的位置。记录输入输出资源的对应关系;需要讨论性能时,另做受控的计时测试,注明设备、分辨率和设置。
结论边界 最终画面的柔和程度不足以证明使用了某种全局光照方案。绘制次数也不等于 GPU 耗时;一份静态捕获不能说明持续运行的帧率与稳定性。
亮边与透明效果
发梢亮边、设备发光、粒子与空气中的薄雾都可能让局部变亮。先在最终输出中选定一个像素,并记录目标纹理和子资源,避免在不同输出上比较同一坐标。
在 QRD 中检查 在当前 API 和捕获支持时,使用 Pixel History 查看该像素截至选中事件的修改记录,再回到对应事件检查混合与深度状态。结合相邻区域与中间输出,辨别表面本身的着色和后续叠加。
结论边界 像素历史是定位线索,不是效果名称识别器。透明片、发光表面和后期泛光仍要依靠实际输入输出区分;工具不支持时,如实记录无法完成的检查。
从分析到复现
把“参考画面长什么样”“捕获里查到了什么”和“自己的实现采用什么办法”分开记录。视觉相近的实现可以用于实验,但不能因此声称它就是原游戏方案。
在 QRD 中检查 建立同视角、同分辨率的对照图,先验证一个局部,再扩大到多视角、多光照和运动条件。保存原始参考、实验参数与失败结果,检查线条闪烁、阴影跳变、透明排序以及曝光差异。
结论边界 一次静态对比通过,只证明该条件下的表现。角色动态、完整场景、性能与用户验收分别记录;不要用材质编译成功代替视觉验证。
分析记录模板
记录应让读者找到同一份捕获、同一个事件和同一块区域。未知项标为「待确认」。
- 捕获条件 文件名与校验值、游戏版本、图形 API、分辨率、设备与画质设置。
- 局部定位 角色或场景、画面区域、目标输出、子资源、像素坐标与事件编号。
- 资源关系 着色器阶段、绑定槽位、资源 ID、格式、通道及输入输出关系。
- 判断依据 直接观察、候选解释、反例、尚缺证据,以及下一项可执行检查。
MCP 提问示例
先确认当前 QRD 会话、捕获文件与可用工具。围绕我选中的终末地角色轮廓,列出相关事件和实际绑定的资源;把工具返回的事实、你的推断及无法确认的部分分别说明。没有证据时不要填入通道用途或着色算法名称。最后指出下一步应该检查哪个事件或资源。
方法参考
- 查看输出纹理、通道和子资源。RenderDoc 纹理查看器
- 检查像素值及可用的修改历史。RenderDoc 像素检查
- 查看相关事件的着色器。RenderDoc 着色器查看器
《明日方舟:终末地》及相关内容归原权利人所有。本节是独立研究资料。产品首页的《阿索拉 星之祈愿》回放图属于另一案例。
版本与参考
- QRD 特有的安装与 MCP 行为依据 0.01.5 安装包内的
INSTALL-README.txt、mcp/WORKFLOWS.md和配置生成器。查看版本记录 - 桌面抓帧和回放界面参考对应的上游版本。RenderDoc 1.47 官方文档
- AI 客户端通过
tools/list获取当前服务的工具名和参数。MCP 工具规范