tirtc-devtools-cli 0.0.1 → 0.0.2

package/README.md

@@ -4,11 +4,11 @@
 
 ## 使用说明 (C-Lite)
 
-关于 `tirtc-devtool` 命令的详细使用方法、参数说明与示例，请参考 [USAGE.md](./USAGE.md)。
+关于 `tirtc-devtools-cli` 命令的详细使用方法、参数说明与示例，请参考 [USAGE.md](./USAGE.md)。
 
 ## 负责什么
 
-- **唯一用户产品门面**：提供 `tirtc-devtool` 命令族，覆盖常见的 RTC 测试操作，让内部研发、外部开发者和 AI agent 脚本无需手写底层协议。
+- **唯一用户产品门面**：提供 `tirtc-devtools-cli` 命令族，覆盖常见的 RTC 测试操作，让内部研发、外部开发者和 AI agent 脚本无需手写底层协议。
 - **配置解析与翻译**：负责解析用户传入的 CLI 参数和 TOML 配置文件，进行本地必填校验、脱敏，并翻译为 App Server 协议的 request。
 - **产品级 Observability**：将底层的运行时事件和状态翻译为结构化输出 (JSON) 或友好的终端日志输出。
 - **调试期工具内聚**：承接调试期必要工具（如 token bootstrap、二维码与媒体预处理）的产品化入口，避免把调试流程散落在 runtime 或外部手工步骤中。
@@ -49,4 +49,4 @@
 
 - 本地测试配置文件路径：`devtools/cli/tests/.local/runtime-backed.e2e.local.json`（必需，已在 `.gitignore` 忽略）。
 - 示例模板：`devtools/cli/tests/runtime-backed.e2e.config.example.json`。
-- 推荐先运行 `tirtc-devtool media assets prepare --source .refers/simple.mp4 --output-root ./.tmp/tirtc-devtool/assets`，再把 `assetsDir` 指向返回的 `assets_dir`。
+- 推荐先运行 `tirtc-devtools-cli media assets prepare --source .refers/simple.mp4 --output-root ./.tmp/tirtc-devtools-cli/assets`，再把 `assetsDir` 指向返回的 `assets_dir`。

package/USAGE.md

@@ -1,6 +1,6 @@
 # TiRTC DevTool CLI（用户手册）
 
-`tirtc-devtool` 是基于 `app-server/host` 的命令行门面，用来控制会话、服务、连接、流、命令通道与调试工具。
+`tirtc-devtools-cli` 是基于 `app-server/host` 的命令行门面，用来控制会话、服务、连接、流、命令通道与调试工具。
 
 ## 一、先说清楚关系
 
@@ -26,7 +26,7 @@ npm --prefix app-server ci && \
 构建后可直接运行：
 
 ```bash
-node devtools/cli/bin/tirtc-devtool.js --help
+node devtools/cli/bin/tirtc-devtools-cli.js --help
 ```
 
 ### 2) 发布态打包（可分发二进制）
@@ -60,9 +60,9 @@ node devtools/cli/bin/tirtc-devtool.js --help
 
 一个 session = 一个常驻 Host 进程 + 一个 endpoint runtime 实例。
 
-- `tirtc-devtool host session start`：创建会话，返回 `sessionId`
-- `tirtc-devtool host session list`：查看会话
-- `tirtc-devtool host session stop <sessionId>`：停止会话
+- `tirtc-devtools-cli host session start`：创建会话，返回 `sessionId`
+- `tirtc-devtools-cli host session list`：查看会话
+- `tirtc-devtools-cli host session stop <sessionId>`：停止会话
 
 设计约束：
 
@@ -77,22 +77,22 @@ node devtools/cli/bin/tirtc-devtool.js --help
 
 用途：初始化 CLI 配置文件，作为后续 `service/debug/logging` 等命令的参数来源。
 
-- `tirtc-devtool init [outputPath]`：生成配置模板；不传路径时默认写入 `./.tmp/tirtc-devtool/config.toml`。
+- `tirtc-devtools-cli init [outputPath]`：生成配置模板；不传路径时默认写入 `./.tmp/tirtc-devtools-cli/config.toml`。
 
 ### Host
 
 用途：管理 Host 进程生命周期与会话健康状态。
 
-- `tirtc-devtool host status`：查看当前 Host/service/connection/artifact 状态。
-- `tirtc-devtool host stop`：停止当前 `--session` 对应的 Host 进程。
-- `tirtc-devtool host stop --all`：停止全部 session 对应 Host，并清理本机 orphan host 进程。
+- `tirtc-devtools-cli host status`：查看当前 Host/service/connection/artifact 状态。
+- `tirtc-devtools-cli host stop`：停止当前 `--session` 对应的 Host 进程。
+- `tirtc-devtools-cli host stop --all`：停止全部 session 对应 Host，并清理本机 orphan host 进程。
 
 ### Service
 
 用途：控制服务端角色（等待远端连接的一侧）。
 
-- `tirtc-devtool service start [serviceEntry] [license]`：启动服务并进入等待连接状态。
-- `tirtc-devtool service stop`：停止服务。
+- `tirtc-devtools-cli service start [serviceEntry] [license]`：启动服务并进入等待连接状态。
+- `tirtc-devtools-cli service stop`：停止服务。
 
 说明：`license` 必填；`serviceEntry` 可省略，省略时走 runtime/core/transport 默认值。
 
@@ -102,9 +102,9 @@ node devtools/cli/bin/tirtc-devtool.js --help
 
 用途：控制客户端侧连接动作（主动连接/断开）。
 
-- `tirtc-devtool connection show`：查看当前连接状态。
-- `tirtc-devtool connection connect [serviceEntry] <peerId> [token]`：主动发起连接（不传 token 时自动签发）。
-- `tirtc-devtool connection disconnect`：主动断开连接。
+- `tirtc-devtools-cli connection show`：查看当前连接状态。
+- `tirtc-devtools-cli connection connect [serviceEntry] <peerId> [token]`：主动发起连接（不传 token 时自动签发）。
+- `tirtc-devtools-cli connection disconnect`：主动断开连接。
 
 说明：`connect` 每次都会新建一个 session；省略 `serviceEntry` 时，Host 回退到 runtime 配置默认值。
 
@@ -118,7 +118,7 @@ node devtools/cli/bin/tirtc-devtool.js --help
 
 用途：直接签发 token，并把调试所需的核心信息一次性输出到控制台，同时在本地生成二维码 PNG。
 
-- `tirtc-devtool token issue <accessId> <secretKey> <localId> <peerId>`：签发 token。
+- `tirtc-devtools-cli token issue <accessId> <secretKey> <localId> <peerId>`：签发 token。
 
 可选参数：
 
@@ -144,14 +144,14 @@ node devtools/cli/bin/tirtc-devtool.js --help
 
 用途：管理音视频流的发送/接收与远端请求策略。
 
-- `tirtc-devtool stream list`：列出当前流状态。
-- `tirtc-devtool media assets prepare --source <mp4> --output-root <dir>`：把 MP4 prepare 为 local assets。
-- `tirtc-devtool stream send start <streamId> <media> <assets_dir>`：启动发送流并绑定 prepared local assets。
-- `tirtc-devtool stream send stop <streamId>`：停止发送流。
-- `tirtc-devtool stream receive start <streamId> <media>`：启动接收流。
-- `tirtc-devtool stream receive stop <streamId>`：停止接收流。
-- `tirtc-devtool stream request-policy get`：查看远端请求策略。
-- `tirtc-devtool stream request-policy set <manual|auto-if-bound>`：设置远端请求策略。
+- `tirtc-devtools-cli stream list`：列出当前流状态。
+- `tirtc-devtools-cli media assets prepare --source <mp4> --output-root <dir>`：把 MP4 prepare 为 local assets。
+- `tirtc-devtools-cli stream send start <streamId> <media> <assets_dir>`：启动发送流并绑定 prepared local assets。
+- `tirtc-devtools-cli stream send stop <streamId>`：停止发送流。
+- `tirtc-devtools-cli stream receive start <streamId> <media>`：启动接收流。
+- `tirtc-devtools-cli stream receive stop <streamId>`：停止接收流。
+- `tirtc-devtools-cli stream request-policy get`：查看远端请求策略。
+- `tirtc-devtools-cli stream request-policy set <manual|auto-if-bound>`：设置远端请求策略。
 
 `request-policy` 行为：
 
@@ -168,8 +168,8 @@ node devtools/cli/bin/tirtc-devtool.js --help
 
 用途：把流内容挂到具体消费端（文件、预览页等）。
 
-- `tirtc-devtool output attach <streamId> <consumer> <mediaView> <format> <delivery> [targetPath] [maxFiles]`：附加输出消费。
-- `tirtc-devtool output detach <outputId>`：移除输出消费。
+- `tirtc-devtools-cli output attach <streamId> <consumer> <mediaView> <format> <delivery> [targetPath] [maxFiles]`：附加输出消费。
+- `tirtc-devtools-cli output detach <outputId>`：移除输出消费。
 
 `output attach` 当前最小稳定组合（CLI 前置校验）：
 
@@ -179,11 +179,11 @@ node devtools/cli/bin/tirtc-devtool.js --help
 `web_preview` 用法（音视频一起预览）：
 
 - 先在客户端会话中启动接收（必须两路都起）：
-  - `tirtc-devtool stream receive start <videoStreamId> video`
-  - `tirtc-devtool stream receive start <audioStreamId> audio`
+  - `tirtc-devtools-cli stream receive start <videoStreamId> video`
+  - `tirtc-devtools-cli stream receive start <audioStreamId> audio`
 - 再挂接两路输出到同一个预览页：
-  - `tirtc-devtool output attach <videoStreamId> web_preview encoded jpeg artifact_path [videoTargetPath]`
-  - `tirtc-devtool output attach <audioStreamId> web_preview encoded pcm artifact_path [audioTargetPath]`
+  - `tirtc-devtools-cli output attach <videoStreamId> web_preview encoded jpeg artifact_path [videoTargetPath]`
+  - `tirtc-devtools-cli output attach <audioStreamId> web_preview encoded pcm artifact_path [audioTargetPath]`
 - 两次 `output attach` 返回的 `result.preview.url` 应一致；用该 URL 在 Chrome 打开本地预览。
 - 页面打开后会自动触发 `GET /preview/start?token=...`；若浏览器拦截自动播放音频，请手动点击 `Start Stream` 解锁。
 - 可通过 `GET /preview/status?token=...` 查看 audio/video source 启动状态与 frame 计数。
@@ -192,9 +192,9 @@ node devtools/cli/bin/tirtc-devtool.js --help
 
 用途：发送业务命令与实时观察命令事件。
 
-- `tirtc-devtool command send <commandId> <kind> <payloadEncoding> <payload>`：发送命令。
-- `tirtc-devtool command send-json <commandId> <kind> <payloadJson>`：以 JSON-first 形态发送命令。
-- `tirtc-devtool command tail`：持续监听命令相关事件。
+- `tirtc-devtools-cli command send <commandId> <kind> <payloadEncoding> <payload>`：发送命令。
+- `tirtc-devtools-cli command send-json <commandId> <kind> <payloadJson>`：以 JSON-first 形态发送命令。
+- `tirtc-devtools-cli command tail`：持续监听命令相关事件。
 
 `command send-json` 约束：
 
@@ -205,8 +205,8 @@ node devtools/cli/bin/tirtc-devtool.js --help
 
 用途：生成客户端扫码连接所需的 bootstrap 二维码（只包含连接信息，不签发 token）。
 
-- `tirtc-devtool debug bootstrap qrcode <accessId> <secretKey> <peerId> [serviceEntry]`：按命令参数生成二维码。
-- `tirtc-devtool debug bootstrap qrcode-from-config`：按 `[debug.connect_bootstrap]` 配置生成二维码。
+- `tirtc-devtools-cli debug bootstrap qrcode <accessId> <secretKey> <peerId> [serviceEntry]`：按命令参数生成二维码。
+- `tirtc-devtools-cli debug bootstrap qrcode-from-config`：按 `[debug.connect_bootstrap]` 配置生成二维码。
 
 二维码产物会落到 Host artifact 的 `debug/` 目录。
 
@@ -214,10 +214,10 @@ node devtools/cli/bin/tirtc-devtool.js --help
 
 用途：做运行观测与验收证据导出。
 
-- `tirtc-devtool events tail`：实时查看事件流。
-- `tirtc-devtool logs export <outputPath>`：导出日志。
-- `tirtc-devtool report show`：查看报告。
-- `tirtc-devtool report export <outputPath>`：导出报告。
+- `tirtc-devtools-cli events tail`：实时查看事件流。
+- `tirtc-devtools-cli logs export <outputPath>`：导出日志。
+- `tirtc-devtools-cli report show`：查看报告。
+- `tirtc-devtools-cli report export <outputPath>`：导出报告。
 
 ## 六、服务端操作指引（对接安卓扫码）
 
@@ -226,7 +226,7 @@ node devtools/cli/bin/tirtc-devtool.js --help
 ### 1) 启动服务端
 
 ```bash
-node devtools/cli/bin/tirtc-devtool.js service start "" "runtime-license"
+node devtools/cli/bin/tirtc-devtools-cli.js service start "" "runtime-license"
 ```
 
 记下返回里的 `sessionId`。
@@ -239,7 +239,7 @@ node devtools/cli/bin/tirtc-devtool.js service start "" "runtime-license"
 mode = "auto-if-bound"
 
 [streams.send]
-assets_dir = "./.tmp/tirtc-devtool/assets/<prepared-assets-id>"
+assets_dir = "./.tmp/tirtc-devtools-cli/assets/<prepared-assets-id>"
 audio_stream_id = 10
 video_stream_id = 11
 
@@ -254,7 +254,7 @@ video_stream_id = 11
 ### 3) 生成给安卓扫码的 bootstrap 二维码
 
 ```bash
-node devtools/cli/bin/tirtc-devtool.js --session <SESSION_ID> debug bootstrap qrcode \
+node devtools/cli/bin/tirtc-devtools-cli.js --session <SESSION_ID> debug bootstrap qrcode \
   "<access-id>" "<secret-key>" "<peer-id>" "<service-entry>"
 ```
 
@@ -271,7 +271,7 @@ node devtools/cli/bin/tirtc-devtool.js --session <SESSION_ID> debug bootstrap qr
 ### 4.1) 本地直接签发 token（公开调试入口）
 
 ```bash
-node devtools/cli/bin/tirtc-devtool.js token issue \
+node devtools/cli/bin/tirtc-devtools-cli.js token issue \
   "<access-id>" "<secret-key>" "<local-id>" "<peer-id>" \
   --service-entry "<service-entry>"
 ```
@@ -339,7 +339,7 @@ node devtools/cli/bin/tirtc-devtool.js token issue \
 
 `[logging]` 段默认已在模板里生成：
 
-- `root_dir`：会话日志根目录（默认 `./.tmp/tirtc-devtool/logging`）
+- `root_dir`：会话日志根目录（默认 `./.tmp/tirtc-devtools-cli/logging`）
 - `console_mirror`：是否把 Host 关键日志镜像到当前命令终端
 - `level`：日志级别预留位（当前 Host 以统一关键路径日志为主）
 
@@ -351,13 +351,13 @@ node devtools/cli/bin/tirtc-devtool.js token issue \
 
 实时观察：
 
-- `node devtools/cli/bin/tirtc-devtool.js --session <SESSION_ID> events tail`
+- `node devtools/cli/bin/tirtc-devtools-cli.js --session <SESSION_ID> events tail`
 - 输出中包含 `family=logs` / `kind=host.line` 的实时日志事件
 
 ## 六点六、配置格式说明
 
 - 推荐使用 TOML（支持注释，便于人工维护）
-- `init` 默认生成 TOML 模板：`.tmp/tirtc-devtool/config.toml`
+- `init` 默认生成 TOML 模板：`.tmp/tirtc-devtools-cli/config.toml`
 
 ## 七、本地 E2E 配置（必需）
 
@@ -372,7 +372,7 @@ cp devtools/cli/tests/runtime-backed.e2e.config.example.json devtools/cli/tests/
 
 ```json
 {
-  "assetsDir": "./.tmp/tirtc-devtool/assets/<prepared-assets-id>",
+  "assetsDir": "./.tmp/tirtc-devtools-cli/assets/<prepared-assets-id>",
   "license": "<license>",
   "peerId": "<peer-id>",
   "useFakeToken": false,
@@ -396,7 +396,7 @@ cp devtools/cli/tests/runtime-backed.e2e.config.example.json devtools/cli/tests/
 
 ## 九、新手入口
 
-- `node devtools/cli/bin/tirtc-devtool.js guide quickstart`
+- `node devtools/cli/bin/tirtc-devtools-cli.js guide quickstart`
 
 会直接打印“服务端启动 -> 绑定自动发流 -> 生成 bootstrap 二维码 -> 客户端扫码签发 token 并连接 -> 打开 Web Preview 后手动 Start/Stop -> 观测报告”的最小闭环步骤。
 

package/dist/devtools/cli/src/config.js

@@ -30,7 +30,7 @@ function resolveConfigOutputPath(outputPath) {
     if (outputPath && outputPath.trim().length > 0) {
         return path_1.default.resolve(outputPath.trim());
     }
-    return path_1.default.resolve(process.cwd(), '.tmp/tirtc-devtool/config.toml');
+    return path_1.default.resolve(process.cwd(), '.tmp/tirtc-devtools-cli/config.toml');
 }
 function renderTomlConfigTemplate() {
     return [
@@ -65,13 +65,13 @@ function renderTomlConfigTemplate() {
         'mode = "manual"',
         '',
         '[streams.send]',
-        'assets_dir = "./.tmp/tirtc-devtool/assets/<prepared-assets-id>"',
+        'assets_dir = "./.tmp/tirtc-devtools-cli/assets/<prepared-assets-id>"',
         'audio_stream_id = 10',
         'video_stream_id = 11',
         '',
         '[logging]',
         '# session 日志根目录；每个 session 会写到 <root_dir>/<session_id>/',
-        'root_dir = "./.tmp/tirtc-devtool/logging"',
+        'root_dir = "./.tmp/tirtc-devtools-cli/logging"',
         '# 是否镜像 Host 控制台日志到当前终端',
         'console_mirror = true',
         '# verbose|debug|info|warn|error|fatal（预留）',

package/dist/devtools/cli/src/embedded_paths.js

@@ -25,7 +25,7 @@ function resolveCliPackageRoot(fromDir) {
         path_1.default.resolve(process.cwd(), 'devtools/cli'),
     ];
     for (const candidate of candidates) {
-        if (pathExists(path_1.default.join(candidate, 'package.json')) && pathExists(path_1.default.join(candidate, 'bin/tirtc-devtool.js'))) {
+        if (pathExists(path_1.default.join(candidate, 'package.json')) && pathExists(path_1.default.join(candidate, 'bin/tirtc-devtools-cli.js'))) {
             return candidate;
         }
     }

package/dist/devtools/cli/src/ffmpeg_tool.js

@@ -23,7 +23,7 @@ function resolveFfmpegCacheRoot() {
     if (explicit && explicit.trim().length > 0) {
         return path_1.default.resolve(explicit.trim());
     }
-    return path_1.default.join(os_1.default.homedir(), '.tirtc-devtool', 'tools', 'ffmpeg');
+    return path_1.default.join(os_1.default.homedir(), '.tirtc-devtools-cli', 'tools', 'ffmpeg');
 }
 function resolveCachedToolDir(platform) {
     return path_1.default.join(resolveFfmpegCacheRoot(), platform);

package/dist/devtools/cli/src/guide.js

@@ -12,17 +12,17 @@ function printQuickstartGuide() {
         '2) 服务端已准备可发送媒体文件（示例：.refers/simple.mp4）',
         '',
         '步骤 1：启动服务（自动创建 session）',
-        '  node devtools/cli/bin/tirtc-devtool.js service start "" "<LICENSE>"',
+        '  node devtools/cli/bin/tirtc-devtools-cli.js service start "" "<LICENSE>"',
         '  # 记下输出里的 sessionId，后续命令都显式带 --session',
         '',
         '步骤 2：先 prepare local assets，再配置 assets_dir + 显式音视频 stream id 并启动自动按需发流',
-        '  node devtools/cli/bin/tirtc-devtool.js media assets prepare --source .refers/simple.mp4 --output-root ./.tmp/tirtc-devtool/assets',
+        '  node devtools/cli/bin/tirtc-devtools-cli.js media assets prepare --source .refers/simple.mp4 --output-root ./.tmp/tirtc-devtools-cli/assets',
         '  [stream.request_policy] mode = "auto-if-bound"',
-        '  [streams.send] assets_dir = "./.tmp/tirtc-devtool/assets/<prepared-assets-id>"  audio_stream_id = 10  video_stream_id = 11',
+        '  [streams.send] assets_dir = "./.tmp/tirtc-devtools-cli/assets/<prepared-assets-id>"  audio_stream_id = 10  video_stream_id = 11',
         '  # service start 成功后会自动应用上述 request_policy + send 绑定',
         '',
         '步骤 3：生成连接 bootstrap 二维码（给安卓扫码）',
-        '  node devtools/cli/bin/tirtc-devtool.js --session <SESSION_ID> debug bootstrap qrcode \\',
+        '  node devtools/cli/bin/tirtc-devtools-cli.js --session <SESSION_ID> debug bootstrap qrcode \\',
         '    "<ACCESS_ID>" "<SECRET_KEY>" "<PEER_ID>" "<SERVICE_ENTRY>"',
         '',
         '步骤 4：安卓扫码后流程（客户端侧）',
@@ -31,19 +31,19 @@ function printQuickstartGuide() {
         '  - 持 token + peer_id 连接服务端；连接成功后请求 audio_stream_id/video_stream_id',
         '',
         '额外：如果你只想本地直接签发并拿到可扫码 payload，可执行：',
-        '  node devtools/cli/bin/tirtc-devtool.js token issue "<ACCESS_ID>" "<SECRET_KEY>" "<LOCAL_ID>" "<PEER_ID>" \\',
+        '  node devtools/cli/bin/tirtc-devtools-cli.js token issue "<ACCESS_ID>" "<SECRET_KEY>" "<LOCAL_ID>" "<PEER_ID>" \\',
         '    --service-entry "<SERVICE_ENTRY>"',
         '  # CLI 会直接打印摘要、payload JSON、token，并生成本地二维码 PNG 路径',
         '',
         '步骤 5：服务端观测',
-        '  node devtools/cli/bin/tirtc-devtool.js --session <SESSION_ID> events tail',
-        '  node devtools/cli/bin/tirtc-devtool.js --session <SESSION_ID> report show',
+        '  node devtools/cli/bin/tirtc-devtools-cli.js --session <SESSION_ID> events tail',
+        '  node devtools/cli/bin/tirtc-devtools-cli.js --session <SESSION_ID> report show',
         '',
         '补充：',
         '- debug bootstrap qrcode 仅生成连接信息二维码，不签发 token',
         '- 机器可读输出：在命令后追加 --json',
-        '- 查看全部命令：node devtools/cli/bin/tirtc-devtool.js --help',
-        '- 查看单命令说明：node devtools/cli/bin/tirtc-devtool.js <command> --help',
+        '- 查看全部命令：node devtools/cli/bin/tirtc-devtools-cli.js --help',
+        '- 查看单命令说明：node devtools/cli/bin/tirtc-devtools-cli.js <command> --help',
     ];
     console.log(lines.join('\n'));
 }

package/dist/devtools/cli/src/index.js

@@ -161,7 +161,7 @@ async function runCommand(cmdName, params, options) {
         const session = resolveSessionForCommand(cmdName, options, config);
         transport = createSessionTransport(session.sessionId);
         const client = new protocol_client_1.AppServerClient(transport);
-        await client.initialize({ name: 'tirtc-devtool-cli', version: CLI_VERSION });
+        await client.initialize({ name: 'tirtc-devtools-cli', version: CLI_VERSION });
         const method = facade_1.CommandToHostMethodMapping[cmdName];
         if (!method) {
             throw new Error('Unknown command mapping for: ' + cmdName);
@@ -226,7 +226,7 @@ async function tailEvents(_cmdName, families, options) {
             }
             transport?.stop();
         });
-        await client.initialize({ name: 'tirtc-devtool-cli', version: CLI_VERSION });
+        await client.initialize({ name: 'tirtc-devtools-cli', version: CLI_VERSION });
         await client.subscribeEvents(families);
         await new Promise((resolve) => {
             process.on('SIGINT', () => {
@@ -339,8 +339,8 @@ function mustParseJsonPayload(input) {
         throw new Error('payloadJson must be valid JSON text');
     }
 }
-program.name('tirtc-devtool')
-    .description('TiRTC DevTool CLI')
+program.name('tirtc-devtools-cli')
+    .description('TiRTC DevTools CLI')
     .option('--config <path>', '配置文件路径（TOML）')
     .option('--json', '以机器可读 JSON 输出（便于脚本集成）')
     .option('--session <sessionId>', '指定会话 ID；除 service start/connect 外必须传');
@@ -468,7 +468,7 @@ function handleConfigInit(outputPath) {
         console.error('Error:', normalized.message);
     }
 }
-const init = program.command('init [outputPath]').description('新手第一步：生成 CLI 配置模板（默认输出到 ./.tmp/tirtc-devtool/config.toml）');
+const init = program.command('init [outputPath]').description('新手第一步：生成 CLI 配置模板（默认输出到 ./.tmp/tirtc-devtools-cli/config.toml）');
 init.action((outputPath) => {
     handleConfigInit(outputPath);
 });

package/dist/devtools/cli/src/session_manager.js

@@ -30,7 +30,7 @@ function getStateDir() {
     if (explicit && explicit.trim().length > 0) {
         return explicit.trim();
     }
-    return path_1.default.join(os_1.default.homedir(), '.tirtc-devtool');
+    return path_1.default.join(os_1.default.homedir(), '.tirtc-devtools-cli');
 }
 function getSocketDir() {
     const explicit = process.env.TIRTC_DEVTOOL_SOCKET_DIR;
@@ -191,7 +191,7 @@ function waitForSocketReady(socketPath, pid) {
     throw new Error(`session startup timeout: socket not ready within ${kStartupTimeoutMs}ms`);
 }
 function resolveDefaultLogRootDir() {
-    return path_1.default.resolve(process.cwd(), '.tmp/tirtc-devtool/logging');
+    return path_1.default.resolve(process.cwd(), '.tmp/tirtc-devtools-cli/logging');
 }
 function createSession(options) {
     const runtimePlatform = resolveRuntimePlatform();

package/dist/devtools/cli/src/token_tool.js

@@ -27,7 +27,7 @@ function sanitizePathSegment(text) {
     return text.replace(/[^a-zA-Z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'value';
 }
 function resolveQrCodeOutputDir() {
-    return path_1.default.resolve(process.cwd(), '.tmp/tirtc-devtool/qrcode');
+    return path_1.default.resolve(process.cwd(), '.tmp/tirtc-devtools-cli/qrcode');
 }
 function buildQrCodePngPath(payload) {
     const fileName = [

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "tirtc-devtools-cli",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "private": false,
   "main": "dist/index.js",
   "bin": {
-    "tirtc-devtool": "./bin/tirtc-devtool.js"
+    "tirtc-devtools-cli": "./bin/tirtc-devtools-cli.js"
   },
   "files": [
     "README.md",
     "USAGE.md",
-    "bin/tirtc-devtool.js",
+    "bin/tirtc-devtools-cli.js",
     "dist",
     "script/ensure_ffmpeg.sh",
     "vendor"

package/vendor/app-server/bin/runtime/macos-arm64/manifest.txt

@@ -1,5 +1,5 @@
 platform=macos-arm64
-staged_at_utc=2026-04-09T05:05:37Z
+staged_at_utc=2026-04-09T05:31:28Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/macos-arm64
 
 58cbe872af5a68a1f5832912ab9deb7ef5af1ac5d19439b523ce6619978214c0  include/tirtc/audio.h

package/vendor/app-server/dist/host/RuntimeAdapter.js

@@ -101,7 +101,7 @@ function resolveOutputRoot() {
     if (explicit && explicit.trim().length > 0) {
         return path.resolve(explicit.trim());
     }
-    return path.join(path.resolve(process.cwd()), '.tmp', 'tirtc-devtool', 'output');
+    return path.join(path.resolve(process.cwd()), '.tmp', 'tirtc-devtools-cli', 'output');
 }
 function normalizeMedia(media) {
     if (media === 'audio') {