tirtc-devtools-cli 0.0.12 → 0.0.14

package/README.md

@@ -1,67 +1,63 @@
 # TiRTC DevTools CLI
 
-`products/cli/` 承接 `TiRTC DevTools CLI`。它是当前唯一用户界面的产品门面 (command client)，为用户提供了一套操作 `Matrix Host` 控制面的终端工具。
-
-## 使用说明 (C-Lite)
-
-关于 `tirtc-devtools-cli` 命令的详细使用方法、参数说明与示例，请参考 [USAGE.md](./USAGE.md)。
-
-如果要先快速确认当前 binary 暴露了哪些命令面，直接运行：`node products/cli/bin/tirtc-devtools-cli.js --help`。
-
-当前正式入口补充：
-
-- server 侧最小入口：`service start`
-- client 本地预览正式入口：`client start --token <token>` + `[client]` TOML
+`products/cli/` 承接 `TiRTC DevTools CLI`，是当前唯一公开 DevTools 命令行入口。
 
 ## 负责什么
 
-- **唯一用户产品门面**：提供 `tirtc-devtools-cli` 命令族，覆盖常见的 RTC 测试操作，让内部研发、外部开发者和 AI agent 脚本无需手写底层协议。
-- **配置解析与翻译**：负责解析用户传入的 CLI 参数和 TOML 配置文件，进行本地必填校验、脱敏，并翻译为 App Server 协议的 request。
-- **产品级 Observability**：将底层的运行时事件和状态翻译为结构化输出 (JSON) 或友好的终端日志输出；对长耗时命令补轻量进度提示。
-- **调试期工具内聚**：承接调试期必要工具（如 token bootstrap、二维码与媒体预处理）的产品化入口，避免把调试流程散落在 runtime 或外部手工步骤中。
-- **本地 token 工具**：提供直接签发 token、打印组合 JSON、单独 token 与本地二维码 PNG 路径的公开 CLI 能力，服务本地联调与体验验证。
-- **本地 license 二维码工具**：提供 server 扫码用的 license JSON 二维码生成能力，支持可选 `endpoint`。
+- `token issue` / `license qrcode`：本地联调的凭据与二维码工具。
+- `assets prepare`：把默认资产或任意 MP4 准备成 native role driver 使用的媒体资产。
+- `send start`：作为标准上行端启动 native DevTools driver，送出音视频，产出 `bootstrap.json` 与 execution evidence。
+- `receive start`：作为标准下行端消费本机 `bootstrap.json` 或显式 `remote/token`，产出 `frame_dump` 与 summary。
+- CLI 负责参数、环境变量、token 签发、JSON envelope、artifact 摘要与打包定位；真实 TiRTC lifecycle 由 `products/devtools/driver/` 承接。
 
 ## 不负责什么
 
-- **不拥有底层 RTC 能力**：它只是一个客户端门面，它自己不负责跑 RTC 媒体栈，所有的执行能力均交由底层的 `Matrix Host` 进程完成。
-- **不重新定义协议**：不私自发明 undocumented control path；CLI 命令到 Host method 的映射必须与协议文档保持一一对应。
-- **不把 App Server 变成业务服务**：鉴权签发等能力仅用于本地联调 bootstrap，不替代正式业务系统。
+- 不在 TypeScript 中实现媒体帧队列、PTS pacing、transport attach/detach、decoder 或 render sink。
+- 不提供长驻 Host、HTTP API、共享 session 或桌面 UI。
+- 不替代业务鉴权系统；token 签发只服务 DevTools 联调与验收。
+- 不把 `bootstrap.json` 定义成移动端接入协议；它只是本机 CLI receive、sample smoke 和 validation automation 的交接产物。
+- 不宣称 Linux native send/receive 调试已支持；当前外部调试发布面先按 `macos-arm64` 收口。
 
 ## 依赖方向
 
-- **依赖 `products/app-server/protocol-client/`**：通过可复用的第一方协议客户端与 `Matrix Host` 进程通信。
-- **绝不依赖 `runtime/` 代码实现**：CLI 不直接链接 runtime 模块，只消费 app-server 打包好的运行时产物与 Host 协议。
+- token/license 工具由 CLI 自己承接；仓库级 token helper 入口为 `./script/issue_devtools_token.sh`。
+- send/receive 通过本地 native driver executable 执行，默认查找 `.build/devtools-driver/bin/<platform>/devtools_driver_probe` 或 `vendor/devtools/driver/<platform>/devtools_driver_probe`。
+- runtime bundle 默认查找 `.build/products/runtime/<platform>` 或 `vendor/runtime/<platform>`。
 
-## 这里应该放什么
+## 常用命令
 
-- CLI 命令行入口、命令树 (Commands) 的注册与参数解析逻辑。
-- 配置文件 (TOML) 的读取与校验逻辑。
-- 终端交互、控制台进度打印、结构化输出等 UI 面板逻辑。
-- 与 `protocol-client/` 交互并把业务结果展示给用户的封装逻辑。
+```sh
+npm --prefix products/cli run build
+npm --prefix products/cli test -- --runInBand
+node products/cli/bin/tirtc-devtools-cli.js --help
+```
 
-## 代码规范与 lint
+常用 token 自测入口：
 
-- TypeScript 代码规范通过 `eslint` 承接，配置文件位于 `products/cli/.eslintrc.cjs`。
-- 本目录作者侧收口命令：`npm run lint`、`npm test`、`npm run build`。
-- 仓库级 gate 会通过 `./script/lint_node_products.sh` 在 `pre-commit` 与 `./script/check.sh` 中统一执行 Node 产品 lint。
+```sh
+./script/issue_devtools_token.sh --token-only
+```
 
-## 开发与构建
+真实 send/receive 闭环优先走：
 
-- `npm run build`：执行 TypeScript 编译。
-- `npm test`：运行 CLI 门面与 Smoke 测试。
-- `npm run package`：执行 `./script/package.sh`，构建 CLI 本体并同步 npm 发布所需的 products/app-server/runtime vendor 资产。
-- 运行 `media assets prepare` 时，CLI 会优先复用系统 `ffmpeg/ffprobe`；若本机不存在，则首次使用时自动下载到用户缓存目录。
+```sh
+products/devtools/driver/script/run_capability_probe.sh
+```
 
-## Runtime E2E Tester Config
+一台电脑模拟上行端送任意 MP4：
 
-- CLI server/client E2E 本地配置路径：`products/cli/config/.local/server.local.toml` + `products/cli/config/.local/client.local.toml`。
-- `products/cli/config/.local/` 默认整体忽略；本地 gate 直接读取这两份 TOML，不再依赖 `tests/.local/*.json`。
-- `server.local.toml` 负责 `service start` 和 `debug.connect_bootstrap` 真相；`client.local.toml` 负责 `client start` 与 `token issue` 所需的本地 truth。`license qrcode` 为纯命令行输入，不依赖 TOML。
+```sh
+node products/cli/bin/tirtc-devtools-cli.js --json assets prepare \
+  --source ./movie.mp4 \
+  --output-root .build/tirtc-assets
+node products/cli/bin/tirtc-devtools-cli.js --json send start \
+  --source .build/tirtc-assets/manifest.json \
+  --video-codec h264 \
+  --artifact-root .build/devtools-cli/send-movie-h264
+```
 
-## Command Loop E2E Harness
+打包入口：
 
-- 长驻人工验收脚本：`products/cli/script/command_loop_e2e.sh`
-- 示例配置：`products/cli/config/command_loop_e2e.example.toml`
-- 本地配置路径：`products/cli/config/.local/command_loop_e2e.local.toml`（已在 `.gitignore` 忽略）
-- 该脚本会先打包最新 `runtime + app-server + cli`，再清场、`service start`、周期性发送 `stream message` / time command，并轮询 `command pending list` 后自动做 CLI 侧显式 reply；启动成功后保持常驻，等待人工去操作 Android example。
+```sh
+npm --prefix products/cli run package
+```

package/USAGE.md

@@ -1,286 +1,43 @@
-# TiRTC DevTools CLI（用户手册）
+# TiRTC DevTools CLI Usage
 
-`tirtc-devtools-cli` 是基于 `products/app-server/host` 的命令行门面，用来控制会话、服务、连接、流、命令通道与调试工具。
+## Build
 
-## 一、关系
-
-- Runtime：底层 transport/audio/video/media 能力。
-- App Server：把 Runtime 组织成稳定控制面协议。
-- CLI：面向用户的命令行门面，通过协议驱动 App Server。
-
-## 二、开发态构建
-
-```bash
-npm --prefix products/app-server ci
+```sh
 npm --prefix products/cli ci
-npm --prefix products/app-server run build
 npm --prefix products/cli run build
-```
-
-运行入口：
-
-```bash
-node products/cli/bin/tirtc-devtools-cli.js --help
-```
-
-## 三、Help 菜单速览
-
-安装或构建完成后，先用 help 菜单确认当前 binary 暴露的命令面：
-
-```bash
 node products/cli/bin/tirtc-devtools-cli.js --help
 ```
 
-当前顶层 help 快照：
-
-```text
-Usage: tirtc-devtools-cli [options] [command]
-
-TiRTC DevTools CLI
-
-Options:
-  --config <path>        配置文件路径（TOML）
-  --json                 以机器可读 JSON 输出（便于脚本集成）
-  --session <sessionId>  指定会话 ID；除 service start / client start / connection connect 外必须传
-  -h, --help             display help for command
-
-Commands:
-  host        Host 基础能力（状态、停止）
-  init        新手第一步：生成 CLI 配置模板
-  media       媒体素材辅助：prepare local assets
-  service     服务端能力：启动/停止服务，等待远端接入
-  client      客户端正式入口：连接远端并自动挂载本地 web preview
-  connection  客户端能力：主动连接远端 peer
-  token       Token 工具：签发 token，并输出可直接使用的 JSON 与本地二维码 PNG
-  license     License 工具：生成 server 扫码 JSON 与本地二维码 PNG
-  stream      流控制：发送/接收/消息
-  output      输出挂载：文件等消费者 attach/detach
-  command     命令通道：发送命令与事件跟踪
-  debug       调试工具：连接 bootstrap 二维码
-  events      事件订阅：实时观察 Host 事件
-  logs        日志导出：导出运行日志
-  report      报告查看/导出：验收证据
-  guide       新手入口：按场景给出可执行步骤
-```
-
-常用子菜单 help：
-
-```bash
-node products/cli/bin/tirtc-devtools-cli.js service --help
-node products/cli/bin/tirtc-devtools-cli.js stream --help
-node products/cli/bin/tirtc-devtools-cli.js command --help
-node products/cli/bin/tirtc-devtools-cli.js token issue --help
-node products/cli/bin/tirtc-devtools-cli.js license qrcode --help
-```
-
-当前关键子菜单快照：
-
-```text
-$ node ... service --help
-Commands:
-  start  启动 server-only 会话（必须显式提供 --config）
-  stop   停止服务端监听
-
-$ node ... stream --help
-Commands:
-  list                                 查看流快照列表
-  send                                 发送流：绑定 prepared local assets 并发起上行
-  receive                              接收流：声明并接收下行
-  message                              发送 stream message
-
-$ node ... command --help
-Commands:
-  request [options] <commandId> <payloadEncoding> <payload>        发送命令请求并等待响应
-  send [options] <commandId> <payloadEncoding> <payload>           兼容别名：等价于 command request
-  pending                                                          查看当前会话内待回复的远端命令请求
-  reply <remoteRequestId> <commandId> <payloadEncoding> <payload>  按 remoteRequestId 显式回复待处理命令
-  tail                                                             持续监听命令相关事件
-
-$ node ... token issue --help
-Usage: tirtc-devtools-cli token issue [options] <remote_id>
-
-Options:
-  --access-id <accessId>
-  --secret-key <secretKey>
-  --openapi-endpoint <url>
-  --endpoint <entry>
-  --qr-error-correction-level <level>
-  --ascii-max-columns <columns>
-
-$ node ... license qrcode --help
-Usage: tirtc-devtools-cli license qrcode [options] <license>
-
-Options:
-  --endpoint <entry>
-  --qr-error-correction-level <level>
-  --ascii-max-columns <columns>
-```
-
-## 四、全局参数
-
-- `--config <path>`：TOML 配置文件路径。
-- `--json`：结构化 JSON 输出。
-- `--session <sessionId>`：除 `service start` / `client start` / `connection connect` 外，其余业务命令必须显式提供。
-
-## 五、会话模型
+## Global
 
-一个 session = 一个常驻 Host 进程 + 一个 endpoint runtime 实例。
+- `--json` prints a machine-readable envelope.
+- `--version` prints CLI version and native driver contract version.
 
-- `host session start`：创建会话。
-- `host session list`：查看会话。
-- `host session stop <sessionId>`：停止会话。
-- `service start`：默认创建 `service` 会话；可通过 `--session` 绑定已有空闲会话。
-- `client start` / `connection connect`：总是创建新的 `client` 会话，不允许复用 `--session`。
+## Platform Support
 
-## 六、server-only 正式入口
+- `macos-arm64`: supported for token, assets prepare, send, receive, package smoke, and native send+receive qualification.
+- `linux-x64`: runtime package surface and cross-build are covered, but native send/receive qualification is not a supported external debugging path yet.
 
-### 1. 配置真相
-
-server-only 正式路径只认 `[server]`：
-
-```toml
-[server]
-service_entry = ""
-license = "runtime-license"
-mp4_path = "/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.refers/simple.mp4"
-video_stream_id = 11
-audio_stream_id = 10
-```
-
-说明：
-
-- `license`、`mp4_path`、`video_stream_id`、`audio_stream_id` 必填。
-- `service_entry` 可留空，回退到底层默认值。
-- 旧 `[service]`、`[stream.request_policy]`、`[streams.send]` 不再属于正式合同。
-- 正式命令默认开启 console mirror，并把日志固定落到 `~/.tirtc-devtools-cli/logging/`。
-
-### 2. 启动命令
-
-```bash
-node products/cli/bin/tirtc-devtools-cli.js --config ./server.toml --json service start
-```
-
-`service start` 固定流程：
-
-1. 读取并校验 `[server]`。
-2. 对 `mp4_path` 执行 prepare。
-3. 调用 `service/start`。
-4. 自动调用两次 `stream/sendStart`：一次音频、一次视频。
-5. 返回 `autoApplied` 摘要：`preparedAssetsDir`、固定 `mediaSendPolicy=AUTO_ON_CONNECTED`、以及音视频 sendStart 结果。
-
-非 `--json` 模式下，CLI 会在 `stderr` 输出轻量进度提示：先显示 MP4 prepare，再显示 service start，避免长时间静默。
-
-### 3. 自动发送语义
-
-- App Server server 角色固定使用 `AUTO_ON_CONNECTED`。
-- CLI 不再暴露 request-policy 配置或命令。
-- 一旦远端请求对应 media，已绑定的发送流会自动转为 `active`。
-
-## 七、client start
-
-```bash
-node products/cli/bin/tirtc-devtools-cli.js --config ./client.toml --json client start --token <TOKEN>
-```
-
-client 正式路径只认 `[client]`：
-
-```toml
-[client]
-service_entry = ""
-peer_id = "peer-123"
-audio_stream_id = 10
-video_stream_id = 11
-consumer = "web_preview"
-```
+Do not treat Linux send/receive as ready until the Linux headless receive driver or a containerized online runner is delivered.
 
-说明：
+## Token
 
-- `peer_id`、`audio_stream_id`、`video_stream_id`、`consumer` 必填。
-- `consumer` 当前固定为 `web_preview`。
-- token 必须通过命令行 `--token` 显式提供，不进入配置文件。
+```sh
+export TIRTC_ACCESS_KEY_ID="<ACCESS_KEY_ID>"
+export TIRTC_SECRET_KEY_ID="<SECRET_KEY_ID>"
+export TIRTC_APP_ID="<APP_ID>"
+export TIRTC_DEVICE_ID="<REMOTE_ID>"
+export TIRTC_ENDPOINT="<SERVICE_ENTRY>"
+export TIRTC_OPEN_API_ENDPOINT="<OPENAPI_ENDPOINT>"
 
-`client start` 固定流程：
-
-1. 读取并校验 `[client]`。
-2. 调用 `connection/connect`。
-3. 自动调用两次 `stream/receiveStart`：一次音频、一次视频。
-4. 自动调用两次 `output/attach`，consumer 固定为 `web_preview`。
-5. 返回 `autoApplied` 摘要，其中 `preview.url` 是正式浏览器入口。
-
-## 八、connection connect
-
-```bash
-node products/cli/bin/tirtc-devtools-cli.js --config ./client.toml --json connection connect <serviceEntry> <peerId> <token>
-```
-
-说明：
-
-- 该命令保留为 expert/atomic 路径。
-- token 必须显式提供；CLI 不再提供 auto token 回退。
-
-## 九、stream / output / command
-
-### Stream
-
-- `stream list`
-- `stream send start <streamId> <media> <assets_dir>`
-- `stream send stop <streamId>`
-- `stream message send <streamId> <payload>`
-- `stream receive start <streamId> <media>`
-- `stream receive stop <streamId>`
-
-`stream message send` 是字符串型 payload contract；当前 Host/runtime-backed adapter 至少保证连接存在时可接受请求并落事件。
-
-### Output
-
-- `output attach <streamId> <consumer> <mediaView> <format> <delivery> [targetPath] [maxFiles]`
-- `output detach <outputId>`
-
-CLI 仍会在本地收紧最小组合矩阵：
-
-- `web_preview` 只允许 `delivery=artifact_path`，`format` 允许 `jpeg|pcm|h264|g711a`
-- `file_sink` 只允许 `delivery=file`，`format=mp4`
-
-### Command
-
-- `command request <commandId> <payloadEncoding> <payload> [--timeout-ms <ms>]`
-- `command send <commandId> <payloadEncoding> <payload> [--timeout-ms <ms>]`
-- `command pending list`
-- `command reply <remoteRequestId> <commandId> <payloadEncoding> <payload>`
-- `command tail`
-
-`command request` 是 canonical 主语，`command send` 只保留为兼容别名。若要发 JSON，请把 JSON 文本作为 `payload` 传入。`command pending list` 用于恢复或轮询当前积压，`command reply` 基于 `remoteRequestId` 显式回复待处理请求。
-
-## 十、token / license / debug / report
-
-### token issue
-
-命令形态：
-
-```bash
-export TIRTC_CONN_ACCESS_ID="<ACCESS_ID>"
-export TIRTC_CONN_SECRET_KEY="<SECRET_KEY>"
-node products/cli/bin/tirtc-devtools-cli.js --json token issue <REMOTE_ID>
-```
-
-如果要覆盖默认 endpoint，并显式透传给底层签发路径：
-
-```bash
 node products/cli/bin/tirtc-devtools-cli.js --json token issue <REMOTE_ID> \
   --endpoint <ENDPOINT> \
   --openapi-endpoint <OPENAPI_ENDPOINT>
-```
-
-当前 CLI 合同：
 
-- 位置参数改为 `<remote_id>`。
-- `--endpoint` 取代旧 `--service-entry`。
-- `--openapi-endpoint` 取代旧 `--openapi-entry`。
-- 不再接收 `local_id`。
-- 显式传入的 `endpoint` / `openapi_endpoint` 会透传给 C 层签发路径，并同时进入二维码 payload。
-- 若未显式传入 `endpoint` / `openapi_endpoint`，则 payload 中不再补默认字段。
+./script/issue_devtools_token.sh --token-only
+```
 
-`--json` 输出保持外层 envelope 不变：
+`token issue` preserves the public JSON envelope:
 
 ```json
 {
@@ -288,79 +45,101 @@ node products/cli/bin/tirtc-devtools-cli.js --json token issue <REMOTE_ID> \
   "message": "OK",
   "data": {
     "payload": {
-      "remote_id": "TESTFENGJUN4",
+      "app_id": "APP",
+      "remote_id": "REMOTE",
       "token": "<TOKEN>",
-      "endpoint": "http://ep-test-tirtc.tange365.com",
-      "openapi_endpoint": "http://api-test-tirtc.tange365.com"
+      "endpoint": "http://...",
+      "openapi_endpoint": "http://..."
     },
-    "payloadJson": "{\"remote_id\":\"TESTFENGJUN4\",\"token\":\"<TOKEN>\",\"endpoint\":\"http://ep-test-tirtc.tange365.com\",\"openapi_endpoint\":\"http://api-test-tirtc.tange365.com\"}",
+    "payloadJson": "{\"app_id\":\"APP\",\"remote_id\":\"REMOTE\",\"token\":\"<TOKEN>\"}",
     "token": "<TOKEN>",
-    "qrCodePngPath": "/absolute/path/to/token-*.png"
+    "qrCodePngPath": "/absolute/path/token-*.png"
   }
 }
 ```
 
-说明：
+TiRTC token has anti-replay semantics. Treat every token as single-use and issue a fresh token for every new connection.
 
-- payload 只保留 `remote_id`、`token`、可选 `endpoint`、可选 `openapi_endpoint`。
-- 已删除字段不再出现：`version`、`type`、`local_id`、`peer_id`、`openapi_entry`、`service_entry`、`user_ttl_seconds`、`channel_ttl_seconds`、`generated_at`。
+## License QR
 
-### license qrcode
+```sh
+node products/cli/bin/tirtc-devtools-cli.js --json license qrcode <LICENSE> --endpoint <ENDPOINT>
+```
 
-命令形态：
+## Assets
 
-```bash
-node products/cli/bin/tirtc-devtools-cli.js --json license qrcode <LICENSE>
-node products/cli/bin/tirtc-devtools-cli.js --json license qrcode <LICENSE> --endpoint <ENDPOINT>
+```sh
+node products/cli/bin/tirtc-devtools-cli.js --json assets prepare
+node products/cli/bin/tirtc-devtools-cli.js --json assets prepare --source runtime/assets/source.mp4
 ```
 
-当前 CLI 合同：
+Prepare any MP4 and use the returned `data.manifest_path` as `send start --source`:
 
-- 只保留 `license` 和可选 `endpoint`。
-- `--endpoint` 取代旧 `--service-entry`。
-- 若未显式传入 `endpoint`，payload 中不再补默认字段。
+```sh
+node products/cli/bin/tirtc-devtools-cli.js --json assets prepare \
+  --source ./movie.mp4 \
+  --output-root .build/tirtc-assets
+```
 
-### 其他命令
+## Send
 
-- `debug bootstrap qrcode ...` / `debug bootstrap qrcode-from-config`：生成联调用二维码。
-- `events tail`：实时查看事件流。
-- `logs export <outputPath>`：导出日志。
-- `report show` / `report export <outputPath>`：查看或导出报告。
+Required environment:
 
-## 十一、本地 E2E 配置
+```sh
+export TIRTC_DEVICE_ID="<DEVICE_ID>"
+export TIRTC_DEVICE_SECRET_KEY="<DEVICE_SECRET_KEY>"
+export TIRTC_ACCESS_KEY_ID="<ACCESS_KEY_ID>"
+export TIRTC_SECRET_KEY_ID="<SECRET_KEY_ID>"
+export TIRTC_APP_ID="<APP_ID>"
+export TIRTC_ENDPOINT="<SERVICE_ENTRY>"
+export TIRTC_OPEN_API_ENDPOINT="<OPENAPI_ENDPOINT>"
+```
 
-- CLI server/client E2E 本地配置文件：`products/cli/config/.local/server.local.toml` + `products/cli/config/.local/client.local.toml`
-- `products/cli/config/.local/` 默认整体忽略，由本地联调环境自行维护
-- `server.local.toml` 字段：`[server]` + `[debug.connect_bootstrap]`
-- `client.local.toml` 字段：`[client]` + `[debug.token_issue]`
-- CLI server-only E2E 不再要求先手工 `media assets prepare` 再回填 `assetsDir`
+Run one send role with the default prepared asset:
 
-## 十二、Android 人工闭环脚本
+```sh
+node products/cli/bin/tirtc-devtools-cli.js --json send start \
+  --video-codec h264 \
+  --artifact-root .build/devtools-cli/send-h264
+```
 
-如果需要把 CLI 侧闭环常驻起来，再手工去操作 Android example，使用：
+Run one send role from a prepared MP4:
 
-```bash
-./products/cli/script/command_loop_e2e.sh
+```sh
+node products/cli/bin/tirtc-devtools-cli.js --json send start \
+  --source .build/tirtc-assets/manifest.json \
+  --video-codec h264 \
+  --artifact-root .build/devtools-cli/send-movie-h264
 ```
 
-默认读取：`products/cli/config/.local/command_loop_e2e.local.toml`
+The send role writes `bootstrap.json`. That file is a local handoff artifact for
+CLI receive, runtime sample smoke, and validation automation. The token in that
+bootstrap is intended for one receive connection.
+
+`bootstrap.json` is not a mobile SDK connection protocol. For phone debugging,
+use token/license QR today; a full session QR or deeplink is a separate product
+slice.
 
-建议先从模板复制：
+## Receive
 
-```bash
-mkdir -p products/cli/config/.local
-cp products/cli/config/command_loop_e2e.example.toml products/cli/config/.local/command_loop_e2e.local.toml
+```sh
+node products/cli/bin/tirtc-devtools-cli.js --json receive start \
+  --bootstrap .build/devtools-cli/send-h264/bootstrap.json \
+  --artifact-root .build/devtools-cli/receive-h264
 ```
 
-该脚本会：
+Receive writes `summary.json`, `events.jsonl`, runtime logs, and `render/first-video-frame.*` for `frame_dump`.
 
-- 打包最新 `runtime + app-server + cli`
-- 杀掉其他同类 `command_loop_e2e.sh` 进程
-- `host stop --all`
-- `service start`
-- 可选生成 bootstrap 二维码
-- 每 `15s` 执行一次 `stream message send`
-- 每 `10s` 执行一次时间命令 `command request 7953 utf8 "time?"`
-- 轮询 `command pending list` 并对每个 pending request 执行 `command reply`
+`receive start --bootstrap` is meant for the local computer-to-computer DevTools
+flow. Mobile clients should not be required to fetch a local JSON file from the
+developer machine.
+
+## Codec Matrix
+
+For the current macOS gate, use the native capability runner:
+
+```sh
+products/devtools/driver/script/run_capability_probe.sh
+```
 
-脚本不会替代 Android 端人工操作；它的职责是把 CLI 侧和 Host 侧闭环保持住，并把日志与产物沉到自己的 workspace。
+It runs H264, H265, and MJPEG send+receive with a fresh token per case.

package/dist/cli/src/embedded_paths.d.ts

@@ -1,8 +1,6 @@
 export declare function resolveCliPackageRoot(fromDir: string): string;
 export declare function resolveWorkspaceRepoRoot(fromDir: string): string | undefined;
 export declare function resolveEmbeddedRoot(fromDir: string): string | undefined;
-export declare function resolveEmbeddedAppServerRoot(fromDir: string): string | undefined;
-export declare function resolveEmbeddedHostBinary(fromDir: string): string | undefined;
 export declare function resolveEmbeddedRuntimeBundleRoot(fromDir: string, runtimePlatform: string): string | undefined;
 export declare function resolveEmbeddedRuntimeScript(fromDir: string): string | undefined;
 export declare function resolveCliScriptPath(fromDir: string, relativePath: string): string;

package/dist/cli/src/embedded_paths.js

@@ -6,8 +6,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveCliPackageRoot = resolveCliPackageRoot;
 exports.resolveWorkspaceRepoRoot = resolveWorkspaceRepoRoot;
 exports.resolveEmbeddedRoot = resolveEmbeddedRoot;
-exports.resolveEmbeddedAppServerRoot = resolveEmbeddedAppServerRoot;
-exports.resolveEmbeddedHostBinary = resolveEmbeddedHostBinary;
 exports.resolveEmbeddedRuntimeBundleRoot = resolveEmbeddedRuntimeBundleRoot;
 exports.resolveEmbeddedRuntimeScript = resolveEmbeddedRuntimeScript;
 exports.resolveCliScriptPath = resolveCliScriptPath;
@@ -18,7 +16,6 @@ function pathExists(filePath) {
 }
 function isWorkspaceRepoRoot(candidate) {
     return pathExists(path_1.default.join(candidate, 'products/cli/package.json')) &&
-        pathExists(path_1.default.join(candidate, 'products/app-server/package.json')) &&
         pathExists(path_1.default.join(candidate, 'runtime/script/prepare_runtime_media_dataset.sh'));
 }
 function resolveCliPackageRoot(fromDir) {
@@ -51,36 +48,17 @@ function resolveEmbeddedRoot(fromDir) {
     }
     const packageRoot = resolveCliPackageRoot(fromDir);
     const embeddedRoot = path_1.default.join(packageRoot, 'vendor');
-    if (pathExists(path_1.default.join(embeddedRoot, 'app-server')) || pathExists(path_1.default.join(embeddedRoot, 'runtime'))) {
+    if (pathExists(path_1.default.join(embeddedRoot, 'runtime')) || pathExists(path_1.default.join(embeddedRoot, 'devtools'))) {
         return embeddedRoot;
     }
     return undefined;
 }
-function resolveEmbeddedAppServerRoot(fromDir) {
+function resolveEmbeddedRuntimeBundleRoot(fromDir, runtimePlatform) {
     const embeddedRoot = resolveEmbeddedRoot(fromDir);
     if (!embeddedRoot) {
         return undefined;
     }
-    const appServerRoot = path_1.default.join(embeddedRoot, 'app-server');
-    if (pathExists(path_1.default.join(appServerRoot, 'bin/tirtc-devtool-host.js'))) {
-        return appServerRoot;
-    }
-    return undefined;
-}
-function resolveEmbeddedHostBinary(fromDir) {
-    const appServerRoot = resolveEmbeddedAppServerRoot(fromDir);
-    if (!appServerRoot) {
-        return undefined;
-    }
-    const hostPath = path_1.default.join(appServerRoot, 'bin/tirtc-devtool-host.js');
-    return pathExists(hostPath) ? hostPath : undefined;
-}
-function resolveEmbeddedRuntimeBundleRoot(fromDir, runtimePlatform) {
-    const appServerRoot = resolveEmbeddedAppServerRoot(fromDir);
-    if (!appServerRoot) {
-        return undefined;
-    }
-    const runtimeRoot = path_1.default.join(appServerRoot, 'bin/runtime', runtimePlatform);
+    const runtimeRoot = path_1.default.join(embeddedRoot, 'runtime', runtimePlatform);
     if (pathExists(path_1.default.join(runtimeRoot, 'manifest.txt'))) {
         return runtimeRoot;
     }