@tencentcloud/tmeet 1.0.3 → 1.0.5

package/README.md

@@ -1,4 +1,4 @@
-# tmeet
+# tencentmeeting-cli
 
 [English](README_EN.md) | 中文
 
@@ -13,6 +13,7 @@
 - 📅 **会议管理** — 创建、查询、更新、取消会议，支持周期性会议，管理受邀成员
 - 🎬 **录制管理** — 查询录制列表、获取下载地址、智能纪要、转写详情与搜索
 - 📊 **参会报告** — 查询参会人列表、等候室成员记录
+- 🛠️ **问题排查** — 导出本地日志，支持按时间范围过滤，打包为 zip 文件
 - 🔒 **安全存储** — 凭证使用 AES-256-GCM 加密，明文不落盘
 - 🖥️ **跨平台** — 支持 macOS、Linux、Windows
 
@@ -94,6 +95,7 @@ tmeet auth logout
 | 标志 | 简写 | 默认值 | 说明 |
 |------|------|--------|------|
 | `--format` | — | `json` | 输出格式：`json`（紧凑格式）\| `json-pretty`（缩进格式） |
+| `--compact` | — | `false` | 精简输出模式：仅保留关键字段，过滤冗余字段以降低响应体积，适用于查询/列表类命令 |
 | `--version` | `-V` | — | 查看版本号 |
 
 **示例：**
@@ -104,14 +106,61 @@ tmeet -V
 
 # 以缩进格式输出响应
 tmeet meeting get --meeting-id "6953553464429888300" --format json-pretty
+
+# 以精简模式输出查询结果（仅保留关键字段）
+tmeet record list --meeting-id "6953553464429888300" --compact
 ```
 
 ---
 
+## 分页参数说明
+
+自 `v1.0.5` 起，所有支持分页的命令统一采用 **`--page-token` + `--page-size`** 方案。原先的 `--page` / `--pos` / `--pid` / `--size` / `--limit` 参数被标记为 **deprecated**，仍可使用但不再推荐，未来版本可能移除。
+
+**统一用法：**
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `--page-token` | string | 分页游标。**首次查询不传**；后续翻页请将上一次响应中的 `next_page_token` 传入 |
+| `--page-size` | int | 每页大小，不同命令默认值与上限不同，详见各命令说明 |
+
+**典型分页流程：**
+
+```bash
+# 1) 首次查询（不传 page-token）
+tmeet record list --meeting-id "6953553464429888300" --page-size 30
+
+# 2) 从响应中取出 next_page_token，用于下一页
+tmeet record list \
+  --meeting-id "6953553464429888300" \
+  --page-size 30 \
+  --page-token "<next_page_token>"
+
+# 3) 重复直到 next_page_token 为空，即已到最后一页
+```
+
+**各命令 `--page-size` 默认值/最大值速查：**
+
+| 命令 | 默认值 | 最大值 | 旧参数（已弃用） |
+|------|:---:|:------:|------|
+| `meeting list` | 20  | 20 | — |
+| `meeting list-ended` | 30  | 30 | `--page` |
+| `meeting invitees-list` | 30  | 30 | `--pos` |
+| `record list` | 30  | 30 | `--page` |
+| `record address` | 30  | 30 | `--page` |
+| `report participants` | 100 | 100 | `--pos` / `--size` |
+| `report waiting-room-log` | 100 | 100 | `--page` |
+
+> `record transcript-get` / `record transcript-paragraphs` / `record transcript-search` 暂不支持基于 `--page-token` 的新分页方案。
+>
+> 兼容性说明：当未传入 `--page-token` 且同时传入了旧分页参数（如 `--page`、`--pos`）时，CLI 会按旧模式发起请求（`page_type=0`）；否则一律按新模式（`page_type=1`）发起请求。
+
+---
+
 ## 命令总览
 
 ```
-tmeet [--format json] [-V]
+tmeet [--format json|json-pretty] [--compact] [-V]
 ├── auth
 │   ├── login          # OAuth 授权登录
 │   ├── logout         # 登出并清除凭证
@@ -131,9 +180,11 @@ tmeet [--format json] [-V]
 │   ├── transcript-get        # 获取转写详情
 │   ├── transcript-paragraphs # 获取转写段落列表
 │   └── transcript-search     # 搜索转写内容
-└── report
-    ├── participants   # 获取参会人列表
-    └── waiting-room-log # 获取等候室成员列表
+├── report
+│   ├── participants      # 获取参会人列表
+│   └── waiting-room-log  # 获取等候室成员列表
+└── tshoot
+    └── log               # 导出本地日志（支持按时间范围过滤，可选 --upload 上传至服务器）
 ```
 
 ---
@@ -332,6 +383,8 @@ tmeet meeting list [选项]
 | `--start` | string | — | — | 分页查询起始时间值，ISO 8601，如 `2026-03-12T15:00+08:00` |
 | `--end` | string | — | — | 分页查询结束时间值，ISO 8601，如 `2026-03-12T15:00+08:00` |
 | `--show-all-sub` | int | — | `0` | 是否展示全部子会议：`0`-不展示，`1`-展示 |
+| `--page-token` | string | — | — | 分页游标，从上一次响应中返回的 `next_page_token` 获取，首页不传 |
+| `--page-size` | int | — | `20` | 每页大小，默认 20，最大 20 |
 
 **示例：**
 
@@ -341,6 +394,9 @@ tmeet meeting list \
   --start "2026-04-01T00:00+08:00" \
   --end "2026-04-30T23:59+08:00" \
   --show-all-sub 1
+
+# 翻下一页
+tmeet meeting list --page-token "<next_page_token>" --page-size 20
 ```
 
 ---
@@ -357,8 +413,9 @@ tmeet meeting list-ended [选项]
 |------|------|:----:|--------|------|
 | `--start` | string | — | — | 查询开始时间，ISO 8601，如 `2026-03-12T15:00+08:00` |
 | `--end` | string | — | — | 查询结束时间，ISO 8601，如 `2026-03-12T15:00+08:00` |
-| `--page` | int | — | `1` | 页码，从 1 开始 |
-| `--page-size` | int | — | `10` | 每页大小，默认 10，最大 20 |
+| `--page-token` | string | — | — | 分页游标，从上一次响应中返回的 `next_page_token` 获取，首页不传 |
+| `--page-size` | int | — | `30` | 每页大小，默认 30，最大 30 |
+| `--page` | int | — | — | ⚠️ **已弃用**：页码（从 1 开始），请改用 `--page-token` |
 
 **示例：**
 
@@ -368,11 +425,11 @@ tmeet meeting list-ended \
   --start "2026-04-01T00:00+08:00" \
   --end "2026-04-30T23:59+08:00"
 
-# 分页查询
+# 分页查询（使用 page-token）
 tmeet meeting list-ended \
   --start "2026-04-01T00:00+08:00" \
   --end "2026-04-30T23:59+08:00" \
-  --page 2 --page-size 20
+  --page-token "<next_page_token>" --page-size 30
 ```
 
 ---
@@ -386,13 +443,19 @@ tmeet meeting invitees-list --meeting-id <会议ID> [选项]
 | 参数 | 类型 | 必填 | 默认值 | 说明 |
 |------|------|:----:|--------|------|
 | `--meeting-id` | string | ✅ | — | 会议 ID |
-| `--pos` | int | — | `0` | 分页获取受邀成员列表的查询起始位置值 |
+| `--page-token` | string | — | — | 分页游标，从上一次响应中返回的 `next_page_token` 获取，首页不传 |
+| `--page-size` | int | — | `30` | 每页大小，默认 30，最大 30 |
+| `--pos` | int | — | — | ⚠️ **已弃用**：分页起始位置值，请改用 `--page-token` |
 
 **示例：**
 
 ```bash
 tmeet meeting invitees-list --meeting-id "6953553464429888300"
-tmeet meeting invitees-list --meeting-id "6953553464429888300" --pos 20
+
+# 翻下一页
+tmeet meeting invitees-list \
+  --meeting-id "6953553464429888300" \
+  --page-token "<next_page_token>" --page-size 30
 ```
 
 ---
@@ -416,8 +479,9 @@ tmeet record list (--start <开始时间> --end <结束时间> | --meeting-id <I
 | `--end` | string | 三选一 | — | 查询结束时间，ISO 8601，如 `2026-03-12T14:00+08:00`（与 `--start` 配合使用） |
 | `--meeting-id` | string | 三选一 | — | 会议 ID |
 | `--meeting-code` | string | 三选一 | — | 会议号 |
-| `--page` | int | — | `1` | 页码，从 1 开始 |
-| `--page-size` | int | — | `10` | 每页大小，最大 `20` |
+| `--page-token` | string | — | — | 分页游标，从上一次响应中返回的 `next_page_token` 获取，首页不传 |
+| `--page-size` | int | — | `30` | 每页大小，默认 30，最大 30 |
+| `--page` | int | — | — | ⚠️ **已弃用**：页码（从 1 开始），请改用 `--page-token` |
 
 **示例：**
 
@@ -426,7 +490,7 @@ tmeet record list (--start <开始时间> --end <结束时间> | --meeting-id <I
 tmeet record list \
   --start "2026-04-01T00:00+08:00" \
   --end "2026-04-30T23:59+08:00" \
-  --page 1 --page-size 20
+  --page-token "<next_page_token>" --page-size 30
 
 # 按会议 ID 查询
 tmeet record list --meeting-id "6953553464429888300"
@@ -446,13 +510,19 @@ tmeet record address --meeting-record-id <录制ID> [选项]
 | 参数 | 类型 | 必填 | 默认值 | 说明 |
 |------|------|:----:|--------|------|
 | `--meeting-record-id` | string | ✅ | — | 会议录制 ID |
-| `--page` | int | — | `1` | 页码，从 1 开始 |
-| `--page-size` | int | — | `50` | 每页大小，最大 `50` |
+| `--page-token` | string | — | — | 分页游标，从上一次响应中返回的 `next_page_token` 获取，首页不传 |
+| `--page-size` | int | — | `30` | 每页大小，默认 30，最大 30 |
+| `--page` | int | — | — | ⚠️ **已弃用**：页码（从 1 开始），请改用 `--page-token` |
 
 **示例：**
 
 ```bash
 tmeet record address --meeting-record-id "record_abc123"
+
+# 翻下一页
+tmeet record address \
+  --meeting-record-id "record_abc123" \
+  --page-token "<next_page_token>" --page-size 30
 ```
 
 ---
@@ -493,7 +563,10 @@ tmeet record transcript-get --record-file-id <文件ID> [选项]
 **示例：**
 
 ```bash
-tmeet record transcript-get --record-file-id "file_abc123" --pid "para_001" --limit "50"
+tmeet record transcript-get --record-file-id "file_abc123"
+
+# 指定起始段落与数量
+tmeet record transcript-get --record-file-id "file_abc123" --pid "<paragraph_id>" --limit "30"
 ```
 
 ---
@@ -513,6 +586,11 @@ tmeet record transcript-paragraphs --record-file-id <文件ID> [选项]
 
 ```bash
 tmeet record transcript-paragraphs --record-file-id "file_abc123"
+
+# 指定会议 ID
+tmeet record transcript-paragraphs \
+  --record-file-id "file_abc123" \
+  --meeting-id "6953553464429888300"
 ```
 
 ---
@@ -545,23 +623,30 @@ tmeet record transcript-search --record-file-id "file_abc123" --text "季度目
 tmeet report participants --meeting-id <会议ID> [选项]
 ```
 
-| 参数 | 类型 | 必填 | 默认值 | 说明 |
-|------|------|:----:|--------|------|
-| `--meeting-id` | string | ✅ | — | 会议 ID |
-| `--sub-meeting-id` | string | — | — | 周期性会议子会议 ID |
-| `--pos` | int | — | `0` | 分页获取参会成员列表的查询起始位置值 |
-| `--size` | int | — | `20` | 拉取参会成员条数，目前每页支持最大 100 条 |
-| `--start` | string | — | — | 查询起始时间，ISO 8601，如 `2026-03-12T14:00+08:00` |
-| `--end` | string | — | — | 查询结束时间，ISO 8601，如 `2026-03-12T14:00+08:00` |
+| 参数 | 类型 | 必填 | 默认值   | 说明                                         |
+|------|------|:----:|-------|--------------------------------------------|
+| `--meeting-id` | string | ✅ | —     | 会议 ID                                      |
+| `--sub-meeting-id` | string | — | —     | 周期性会议子会议 ID                                |
+| `--start` | string | — | —     | 查询起始时间，ISO 8601，如 `2026-03-12T14:00+08:00` |
+| `--end` | string | — | —     | 查询结束时间，ISO 8601，如 `2026-03-12T14:00+08:00` |
+| `--page-token` | string | — | —     | 分页游标，从上一次响应中返回的 `next_page_token` 获取，首页不传  |
+| `--page-size` | int | — | `100` | 每页大小，默认 100，最大 100                         |
+| `--pos` | int | — | —     | ⚠️ **已弃用**：分页起始位置值，请改用 `--page-token`      |
+| `--size` | int | — | —     | ⚠️ **已弃用**：每页条数，请改用 `--page-size`          |
 
 **示例：**
 
 ```bash
-tmeet report participants --meeting-id "6953553464429888300" --size 50
+tmeet report participants --meeting-id "6953553464429888300" --page-size 50
 tmeet report participants \
   --meeting-id "6953553464429888300" \
   --start "2026-04-10T10:00+08:00" \
   --end "2026-04-10T11:00+08:00"
+
+# 翻下一页
+tmeet report participants \
+  --meeting-id "6953553464429888300" \
+  --page-token "<next_page_token>" --page-size 50
 ```
 
 ---
@@ -572,16 +657,62 @@ tmeet report participants \
 tmeet report waiting-room-log --meeting-id <会议ID> [选项]
 ```
 
+| 参数 | 类型 | 必填 | 默认值   | 说明                                        |
+|------|------|:----:|-------|-------------------------------------------|
+| `--meeting-id` | string | ✅ | —     | 会议 ID                                     |
+| `--page-token` | string | — | —     | 分页游标，从上一次响应中返回的 `next_page_token` 获取，首页不传 |
+| `--page-size` | int | — | `100` | 每页大小，默认 100，最大 100                        |
+| `--page` | int | — | —     | ⚠️ **已弃用**：页码，请改用 `--page-token`          |
+
+**示例：**
+
+```bash
+tmeet report waiting-room-log --meeting-id "6953553464429888300" --page-size 50
+
+# 翻下一页
+tmeet report waiting-room-log \
+  --meeting-id "6953553464429888300" \
+  --page-token "<next_page_token>" --page-size 50
+```
+
+---
+
+### tshoot — 问题排查
+
+#### `tshoot log` — 导出本地日志
+
+将本地日志打包为 zip 文件，输出到 `~/tmeet_ts_{datetime}.zip`，可用于问题排查。支持按时间范围过滤，不传时间参数则导出全部日志。
+
+```bash
+tmeet tshoot log [选项]
+```
+
 | 参数 | 类型 | 必填 | 默认值 | 说明 |
 |------|------|:----:|--------|------|
-| `--meeting-id` | string | ✅ | — | 会议 ID |
-| `--page` | int | — | `1` | 页码，默认为 1 |
-| `--page-size` | int | — | `20` | 每页数量，最大 `50` |
+| `--start` | string | 与 `--end` 同时使用 | — | 日志查询开始时间，ISO 8601，如 `2026-03-12T14:00+08:00` |
+| `--end` | string | 与 `--start` 同时使用 | — | 日志查询结束时间，ISO 8601，如 `2026-03-12T15:00+08:00` |
+| `--upload` | bool | 否 | `false` | 上传日志到服务器，需要登录 |
+
+> `--start` 和 `--end` 必须同时传入或同时不传。
 
 **示例：**
 
 ```bash
-tmeet report waiting-room-log --meeting-id "6953553464429888300" --page 1 --page-size 50
+# 导出全部日志
+tmeet tshoot log
+
+# 导出指定时间范围内的日志
+tmeet tshoot log \
+  --start "2026-04-10T00:00+08:00" \
+  --end "2026-04-10T23:59+08:00"
+
+# 导出日志并上传到服务器（需要登录）
+tmeet tshoot log --upload
+```
+
+输出示例：
+```
+output log saved to: ~/tmeet_ts_20260410_153000.zip
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencentcloud/tmeet",
-  "version": "v1.0.3",
+  "version": "v1.0.5",
   "description": "腾讯会议 CLI 工具",
   "bin": {
     "tmeet": "./scripts/tmeet.js"