@tencentcloud/tmeet 1.0.4 → 1.0.6

package/README.md

@@ -95,6 +95,7 @@ tmeet auth logout
 | 标志 | 简写 | 默认值 | 说明 |
 |------|------|--------|------|
 | `--format` | — | `json` | 输出格式：`json`（紧凑格式）\| `json-pretty`（缩进格式） |
+| `--compact` | — | `false` | 精简输出模式：仅保留关键字段，过滤冗余字段以降低响应体积，适用于查询/列表类命令 |
 | `--version` | `-V` | — | 查看版本号 |
 
 **示例：**
@@ -105,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         # 登出并清除凭证
@@ -136,7 +184,8 @@ tmeet [--format json] [-V]
 │   ├── participants      # 获取参会人列表
 │   └── waiting-room-log  # 获取等候室成员列表
 └── tshoot
-    └── log               # 导出本地日志（支持按时间范围过滤，可选 --upload 上传至服务器）
+    ├── log               # 导出本地日志（支持按时间范围过滤，可选 --upload 上传至服务器）
+    └── feedback          # 上报问题排查反馈到服务器
 ```
 
 ---
@@ -335,6 +384,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 |
 
 **示例：**
 
@@ -344,6 +395,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
 ```
 
 ---
@@ -360,8 +414,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` |
 
 **示例：**
 
@@ -371,11 +426,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
 ```
 
 ---
@@ -389,13 +444,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
 ```
 
 ---
@@ -419,8 +480,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` |
 
 **示例：**
 
@@ -429,7 +491,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"
@@ -449,13 +511,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
 ```
 
 ---
@@ -496,7 +564,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"
 ```
 
 ---
@@ -516,6 +587,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"
 ```
 
 ---
@@ -548,23 +624,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
 ```
 
 ---
@@ -575,16 +658,22 @@ tmeet report participants \
 tmeet report waiting-room-log --meeting-id <会议ID> [选项]
 ```
 
-| 参数 | 类型 | 必填 | 默认值 | 说明 |
-|------|------|:----:|--------|------|
-| `--meeting-id` | string | ✅ | — | 会议 ID |
-| `--page` | int | — | `1` | 页码，默认为 1 |
-| `--page-size` | int | — | `20` | 每页数量，最大 `50` |
+| 参数 | 类型 | 必填 | 默认值   | 说明                                        |
+|------|------|:----:|-------|-------------------------------------------|
+| `--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 1 --page-size 50
+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
 ```
 
 ---
@@ -629,6 +718,51 @@ output log saved to: ~/tmeet_ts_20260410_153000.zip
 
 ---
 
+#### `tshoot feedback` — 上报问题排查反馈
+
+将 Agent 在使用 CLI 过程中遇到的问题或建议上报至服务器，便于后续优化工具能力。
+
+```bash
+tmeet tshoot feedback --category <分类> --intent <原始意图> [选项]
+```
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|:----:|--------|------|
+| `--category` | string | ✅ | — | 反馈分类，可选值：`tool_not_found`（想做某事但找不到匹配工具）、`tool_error`（调用工具但返回错误）、`tool_inadequate`（工具存在但能力/参数不足）、`unexpected_result`（调用成功但结果未达预期）、`suggestion`（一般性建议或改进想法） |
+| `--intent` | string | ✅ | — | Agent 的原始意图，最多 200 字符 |
+| `--actions-tried` | string | — | — | Agent 已尝试过的动作，最多 500 字符 |
+| `--result` | string | — | — | 已尝试动作的结果或阻塞点，最多 500 字符 |
+| `--tool-name` | string | — | — | 使用的工具/命令名 |
+| `--error-code` | string | — | — | 工具返回的错误码 |
+
+**示例：**
+
+```bash
+# 反馈：找不到匹配工具
+tmeet tshoot feedback \
+  --category "tool_not_found" \
+  --intent "想批量导出某个时间段的所有会议纪要" \
+  --actions-tried "查看了 record 和 meeting 子命令" \
+  --result "未找到批量导出纪要的命令"
+
+# 反馈：工具调用返回错误
+tmeet tshoot feedback \
+  --category "tool_error" \
+  --intent "获取录制下载地址" \
+  --tool-name "record address" \
+  --error-code "200003" \
+  --result "接口返回权限不足"
+
+# 反馈：一般性建议
+tmeet tshoot feedback \
+  --category "suggestion" \
+  --intent "希望支持按主题模糊搜索会议"
+```
+
+> 该命令需要登录后才能使用。
+
+---
+
 ## 安全与风险提示（使用前必读）
 
 ---

package/package.json

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