内容
# rdx-tools
`rdx-tools` 是一个仅限于命令行界面的 RenderDoc `.rdc` 运行时包,用于 Windows x64 本地重放和远程 Android 重放。它通过 `rdx` 命令公开了 194 个 JSON-first `rd.*` 工具。
## 入口点
```bat
rdx --version
rdx version --json
rdx --json doctor
rdx tools list --json
rdx context status --json
rdx capture open --file "C:\path\capture.rdc" --frame-index 0
rdx context update --key notes --value "triaged" --json
rdx vfs ls --path / --format tsv
rdx event list --format tsv
rdx pipeline show --event-id 42 --format json
rdx resource list --format tsv
rdx completion powershell
```
```bash
bash resources/tools/bin/rdx --json doctor
```
`--non-interactive` 是仅限于 Windows 启动器的标志。`rdx --non-interactive --json doctor` 在 Windows 上运行相同的命令行界面。
## 烟雾测试
代理平台应通过 bash 运行烟雾测试,以便在终端中显示每个命令行界面步骤:
```bash
bash scripts/smoke_cli.sh
bash scripts/smoke_cli.sh --rdc "C:/path/sample.rdc" --context cli-smoke
```
烟雾测试脚本直接调用 `bin/rdx` 进行 `doctor`、`tools list`、`tools search`,并在传递 `--rdc` 时调用后台守护进程支持的捕获链。该存储库包含用于测试的少量公共 `.rdc` 固定装置;发布包不包含它们。完整的烟雾测试可以传递显式的本地或远程捕获路径。脚本将相同的实时输出写入 `intermediate/logs/smoke_cli.log`。
## 安装
发布包是自包含的 Windows x64 zip 文件。参见 [安装](docs/install.md)。
## 会话状态
使用 `rdx context status` 读取上下文状态,并使用 `rdx context update` 更新备注、焦点和代理可见的元数据。`--daemon-context <id>` 选择连续运行时命名空间;省略它则使用 `default`。多个后台守护进程上下文彼此隔离,调用者选择要操作的上下文 ID。状态包括 `session_locator`、当前捕获/会话 ID、预览状态和远程生命周期字段。`remote_handle_consumed` 表示远程句柄已绑定到重放会话,不得重复用作空闲远程连接。
## 预览命令行界面合约
`session preview on|status|off` 通过 `rd.session.open_preview` 由后台守护进程支持。`rdx context status` 报告 `rd.session.get_context.preview` 和 `preview.display`;预览曲面应显示完整的帧缓冲区(完整帧缓冲区),而不是裁剪视口/剪刀状态。
## 文档
- [会话模型](docs/session-model.md)
- [代理模型](docs/agent-model.md)
- [安装](docs/install.md)
- [代理集成](docs/agent-integration.md)
- [稳定性](docs/stability.md)
- [文档治理](docs/doc-governance.md)
- [工具](docs/tools.md)
- [工具参考](docs/tool-reference.md)
- [rdx-native 代理手册](docs/rdx-native-agent-playbook.md)
- [固定装置策略](docs/fixture-strategy.md)
- [脚本](scripts/README.md)
## 许可证
`rdx-tools` 采用 Apache-2.0 许可证。仅测试第三方固定装置归属在 [第三方通知](THIRD_PARTY_NOTICES.md) 中跟踪。