tmeet

腾讯会议命令行工具，支持 OAuth 授权、会议全生命周期管理、录制与转写、会议报告查询。

安装与初始化

在使用本技能前，必须检测是否已安装 tmeet 命令行工具：

• 如果检测到 tmeet 命令已存在，直接使用即可
• 如果未检测到 tmeet 命令，会自动执行以下安装命令：

  npm install -g @tencentcloud/tmeet@latest
  

  安装最新版本的腾讯会议 CLI 工具包

注意：自动安装需要网络连接和 npm 环境支持。如果安装失败，请手动执行上述命令或检查网络环境。

认证

使用前必须先完成登录授权：

# 登录
tmeet auth login

# 登出（清除本地凭证）
tmeet auth logout

# 查看当前登录状态及 Token 有效期（无需登录即可执行）
tmeet auth status

注意：除 auth login,auth status 外，所有命令都需要先完成登录。未登录时命令会提示 user config is empty。

注意：auth login 是阻塞命令——执行后会先输出授权 URL，然后阻塞等待最多300s用户在浏览器完成 OAuth 授权。必须前台运行：前台运行保持进程与终端连接，OAuth 回调能正常将凭证写入本地。不要用后台方式（&）运行——后台进程脱离控制终端会导致凭证写入失败。

注意：如果当前 Agent 是 Hermes 且系统没有默认浏览器，请不要尝试执行 tmeet auth login 命令，而是直接告知用户：「请在终端中手动执行 tmeet auth login 完成登录授权，获取授权 URL 后在浏览器中打开完成授权。」

注意：第一次调用auth login命令或者切换了模型，必须将当前使用的agent类型(如Cursor/Claude Desktop/Cline/CodeBuddy)和模型名称(如Claude 3.5 Sonnet/GPT-4o/DeepSeek)分别写入TMEET_AGENT和TMEET_MODEL环境变量，不需要向用户询问。

命令总览与详情索引

调用前置：下方「查询命令选择准则」与「安全规则」是调用命令前必读的规则章节。

每个模块行末标注了对应详情文档路径（→ [references/xxx.md](references/xxx.md)），可直接跳转查看。

tmeet
├── auth                          # OAuth 认证 → [references/tmeet-auth.md](references/tmeet-auth.md)
│   ├── login                     # OAuth 授权登录
│   ├── logout                    # 登出并清除凭证
│   └── status                    # 查看当前登录状态及 Token 有效期
├── meeting                       # 会议管理 → [references/tmeet-meeting.md](references/tmeet-meeting.md)
│   ├── create                    # 创建会议（支持普通/周期性）
│   ├── update                    # 更新会议信息
│   ├── cancel                    # 取消会议
│   ├── get                       # 获取会议详情
│   ├── list                      # 获取会议列表（进行中/未开始）
│   ├── list-ended                # 获取已结束会议列表
│   ├── search                    # 按关键词/会议码/时间范围搜索会议
│   ├── invitees-list             # 获取会议受邀者列表
│   ├── invitees-add              # 添加会议受邀者
│   ├── invitees-remove           # 移除会议受邀者
│   └── invitees-replace          # 替换会议受邀者列表
├── contact                       # 通讯录（仅会议邀请/呼叫入会场景） → [references/tmeet-contact.md](references/tmeet-contact.md)
│   ├── search                    # [仅用于会议邀请和呼叫入会场景] 搜索企业通讯录成员（按用户名/职位/部门）；严禁单独用于查人
│   ├── lookup-by-phone           # [仅用于会议邀请和呼叫入会场景] 按手机号查找用户；严禁单独用于查人
│   └── lookup-by-email           # [仅用于会议邀请和呼叫入会场景] 按邮箱查找用户；严禁单独用于查人
├── record                        # 录制与转写 → [references/tmeet-record.md](references/tmeet-record.md)
│   ├── list                      # 查询录制列表
│   ├── address                   # 获取录制文件下载地址
│   ├── search                    # 按关键词/会议码/会议ID/时间范围/文件类型搜索录制
│   ├── smart-minutes             # 获取智能纪要
│   ├── transcript-get            # 获取转写详情
│   ├── transcript-paragraphs     # 获取转写段落列表
│   ├── transcript-search         # 搜索转写内容
│   ├── permission-apply-prepare  # 预览录制权限申请信息（申请前确认）
│   └── permission-apply-commit   # 提交录制权限申请（用户确认后执行）
├── report                        # 会议报告 → [references/tmeet-report.md](references/tmeet-report.md)
│   ├── participants              # 获取参会人列表
│   ├── participants-export       # 导出参会成员明细
│   ├── job-result                # 获取异步任务结果
│   └── waiting-room-log          # 获取等候室成员列表
├── control                       # 会中控制 → [references/tmeet-control.md](references/tmeet-control.md)
│   ├── call                      # 呼叫成员入会（会中邀请呼叫）
│   ├── kick                      # 踢出会议成员（会中踢人）
│   └── waiting-room              # 等候室管理（移入会议/移回等候室/移出踢出）
└── tshoot                        # 问题排查与反馈 → [references/tmeet-tshoot.md](references/tmeet-tshoot.md)
    ├── log                       # 导出本地日志（支持按时间范围过滤，可选 --upload 上传至服务器）
    └── feedback                  # 反馈工具缺失/失败/能力不足等问题至平台（Agent 自助上报）

查询命令选择准则（list vs search）

查询会议或录制时，需根据用户提供的筛选条件，正确选择 list 类命令还是 search 命令：

会议查询

• 仅时间 → 使用 tmeet meeting list（待开始/进行中）或 tmeet meeting list-ended（已结束）
• 含关键词（主题 / 会议号 / 创建人 / 备注等） → 使用 tmeet meeting search，并通过对应参数指定关键词；可与时间范围组合

录制查询

CRITICAL — 涉及录制/回放/转写查询前，MUST 先用 Read 工具读取 references/tmeet-record.md，其「录制查询路由总则」定义了 meeting get / meeting search / meeting list-ended / record list / record search / record transcript-search 的分流规则与 permission_status 权限判断。录制查询涉及会议级/录制级两套入口、无权限录制、内容级搜索、单文件内定位等多层级，路由复杂，不读将导致命令选择、录制产物定位、权限边界判断错误，不得仅凭本节直接决策。

使用准则

• 不要在 list 命令上"硬塞"关键词条件：list 类命令仅支持时间窗口和分页，无法按主题、创建人、参会人等关键词过滤；遇到此类需求必须切换到 search。
• 不要把关键词当作时间使用：当用户输入"上周和张三的会议"这类复合条件时，应识别出"张三"为关键词、"上周"为时间，统一走 search。
• 歧义时先澄清：若用户表述既不像时间也不像明确关键词（如仅给出一个数字），需先确认是会议号、会议 ID 还是其他，再选择对应命令与参数，不得擅自推断。

安全规则

• 禁止输出 AccessToken / RefreshToken 到终端明文。

• 严禁向用户暴露 meeting_id，必须使用 meeting_code（会议号）：meeting_id 是仅用于命令行参数传递的内部标识，属于隐私字段；向用户展示、复述、总结会议信息时，统一使用 meeting_code（会议号），不得在回复中出现 meeting_id（例如响应模板、二次确认展示、错误反馈等所有面向用户的输出场景均需遵守）。

• 以下命令操作必须二次确认：下列命令会对数据产生不可逆影响或对真人产生打扰/通知，在调用命令前必须先向用户展示将要执行的操作详情，并在获得用户明确确认后才能执行，不得跳过确认步骤：

  命令	风险说明
  meeting cancel	取消会议，不可恢复
  meeting update	修改会议信息（时间、主题等），影响所有参会人
  meeting invitees-add	向会议中添加受邀成员，被邀请者会收到会议通知；执行前必须展示目标会议与成员名单并获得明确确认
  meeting invitees-remove	从会议中移除受邀成员
  meeting invitees-replace	整体替换会议受邀成员列表（未在新列表中的成员会被移除）
  control call	主动呼叫成员入会，会向目标成员发起会议邀请通话，对其产生实际打扰
  control kick	将成员踢出会议，立即生效；目标成员的 open_id / ms_open_id 必须来自 report participants，严禁使用 contact search 结果
  auth logout	清除本地登录凭证
  record permission-apply-commit	正式提交录制权限申请，会触发审批流程（必须先执行 record permission-apply-prepare 并向用户展示申请信息确认）

  确认流程：

  1. 向用户展示即将执行的操作及关键信息（使用 meeting_code 会议号标识会议，不得展示 meeting_id）；涉及成员时，成员的回显格式遵循「响应处理规则」中的「成员回显格式」；
  2. 展示完信息后必须结束本轮回复，等待用户明确回复"确认"、"是"、"yes"等肯定指令；不得在同一回合内继续执行写操作；
  3. 收到确认后再执行命令；
  4. 若用户未明确确认或表示取消，则终止操作。

  "等待"是硬要求 —— 以下三种做法均属违规，等同于跳过确认：

  违规做法	表现
  自问自答	在同一次回复里既提出「是否确认？」又自行接上「—— 同意，提交」然后调用命令
  虚构用户指令	声称「基于您的明确指令…」而该指令在对话历史中不存在
  默认代选	列出候选项后自行「默认选择选项 N」并继续执行

  确认必须来自用户的下一条真实输入，不得由模型自行生成、推断或代填。

• 必填参数缺失时，必须向用户确认补充，禁止自行填充：若执行命令所需的必填参数未由用户提供，不得自行推断或填充默认值，必须明确告知用户缺少哪些参数并请求补充，待用户提供后再执行命令。

• 通讯录搜索仅限特定场景使用：contact_search / contact_lookup_by_phone / contact_lookup_by_email 仅可用于“会议邀请”（如 meeting invitees-add、meeting invitees-replace）、“呼叫成员入会”（control call）两类场景，用于将用户名解析为对应的 openId。严禁在其他场景下调用 contact search（例如：仅为查看某人部门/职位、查询联系方式、好奇某人信息等与会议邀请/呼叫无关的场景），不得将通讯录作为通用人员信息查询接口使用。

• 会中踢人（control kick）的成员来源硬约束：control kick 的 --users / --sip-users / --pstn-users 参数值（即 open_id / ms_open_id）必须从 tmeet report participants 返回的会中参会人列表中获取，严禁使用 contact search / contact lookup-by-phone / contact lookup-by-email 等通讯录查询结果作为踢人来源。原因：通讯录返回的是组织成员名录，并不代表他们已加入当前会议；且踢人需要区分普通成员 / Sip / Pstn 三类身份，这些信息只有 report participants 能准确提供。正确调用顺序：tmeet report participants → 按姓名等描述筛选出目标参会人 → 向用户确认 → tmeet control kick。

• 多结果必须由用户确认，禁止自行猜测：当任一查询/搜索类命令返回 多条候选结果（典型如 contact search 命中多名同名/同部门成员）时，严禁模型基于职位、部门、入职时间、匹配度等任何维度自行选择某一条继续后续操作（如 meeting invitees-add、control call、control kick 等）。必须将候选项的关键信息以清晰列表形式展示给用户，并明确询问"请确认要选择哪一项"，待用户明确指定后再继续执行。即便其中某条结果看起来"明显更匹配"，也必须等待用户确认，不得跳过该步骤。

参数规范

以下参数规则为所有命令通用，包括时间参数格式、输出控制参数（--format / --compact）以及分页参数。

时间格式

所有时间参数均使用 ISO 8601 格式，支持以下两种：

注意：不支持仅日期格式（如 2026-03-12），必须包含时间和时区信息。

时间逻辑校验：若用户提供的结束时间 ≤ 开始时间（如"4点到3点"），不得自行推断用户意图，必须先向用户确认是否跨天或存在笔误，再执行命令。

--format：输出 JSON 形态

用于控制输出 JSON 的排版形态，不改变字段内容。输出结构统一为 {trace_id, message, data}。

使用示例：

# 默认紧凑格式（模型解析场景推荐，省略 --format 即可）
tmeet meeting get --meeting-id 123456789

# 美化缩进格式（需要直接展示给用户阅读时使用）
tmeet meeting list --start 2026-03-12T00:00:00+08:00 --end 2026-03-12T23:59:59+08:00 --format json-pretty

使用准则：

• 模型在解析工具输出时优先使用默认 json，无需显式传入 --format；
• 仅当用户明确要求"以美化/格式化 JSON 展示"或需要把原始 JSON 完整呈现给用户时，才追加 --format json-pretty；
• 即便使用 json-pretty，响应处理规则仍然适用——只展示关键信息，不得擅自聚合或排序。

--compact：精简响应字段

布尔开关（默认 false），用于裁剪响应体 data 中的字段，只保留该命令业务上必要的少量字段，从而显著降低输出 token 量。

• 启用后，中间件会根据当前命令的 API 注解从远端拉取"精简字段列表"（compact fields），并对响应 data 按该列表进行字段保留；trace_id、message 等顶层字段不受影响。
• 若当前命令未声明 API 注解、或远端拉取失败，中间件会透明放行，不会阻塞主流程，此时输出等同于未开启 --compact 的结果。
• 与 --format 相互独立：--format 决定 JSON 排版，--compact 决定返回字段的数量，两者可同时使用。

使用示例：

# 仅返回必要字段（推荐模型解析场景使用，节省 token）
tmeet meeting list --start 2026-03-12T00:00:00+08:00 --end 2026-03-12T23:59:59+08:00 --compact

# 同时启用精简字段 + 美化排版（便于用户直接阅读关键信息）
tmeet record list --meeting-id 123456789 --compact --format json-pretty

使用准则：

• 查询类命令优先启用：模型在调用查询/读取类命令时，默认追加 --compact 以降低上下文占用；
• 何时不使用：当用户明确要求"完整结果"、"原始字段"或需要某个非必要字段时，不要使用 --compact。

分页

所有支持分页的查询/列表类命令统一采用 --page-token + --page-size 方案。

注意：record transcript-get 命令的 --pid（起始段落 ID）和 --limit（查询段落数）不属于通用分页参数，是该命令用于段落定位的独立参数，未被弃用，可正常使用。

<details>
<summary>已弃用参数（兼容保留，模型不得主动使用）</summary>

原有的 --page / --pos / --size 参数均已标记为已弃用，仅为兼容保留。即便用户对话中使用了"第 X 页"、"偏移 Y 条"等表达，也应以 --page-token 分页策略实现，不得使用已弃用参数。

</details>

使用准则：

• 优先使用 --page-token 翻页：调用下一页时，必须从上一次响应的 data.next_page_token 字段取值传入 --page-token，不得自行拼接、递增或猜测该值。
• 到达末页的判定：当响应中的 next_page_token 为空字符串或字段缺失时，即为最后一页，不再继续翻页。
• 数据过多时必须先询问用户是否继续翻页，禁止擅自连续翻页：若首次查询返回的结果中 next_page_token 非空（即仍有后续数据），且用户原始诉求未明确要求"全部 / 所有 / 完整"等穷尽式表达，不得自行连续调用下一页，必须先向用户展示当前页关键信息与"还有更多结果"的提示，并询问用户是否需要继续翻页（例如「当前已展示前 N 条结果，还有更多数据，是否继续查看下一页？」），收到用户明确肯定指令（如"继续"、"是"、"下一页"、"全部"等）后，再使用上一页的 next_page_token 发起下一次查询；若用户表示停止或未明确确认，则终止翻页。当用户已明确要求"全部 / 所有"时，可连续翻页直至 next_page_token 为空；但当已连续翻页超过 5 页或累计条数超过 200 条时，必须主动提示并征询用户是否继续。
• record transcript-search 暂不支持分页，无需传入分页参数。

典型翻页流程：

# 1) 首次查询（不传 --page-token）
tmeet record list --meeting-id "100000000" --page-size 30 --compact

# 2) 从响应中取出 data.next_page_token，继续翻页
tmeet record list \
  --meeting-id "100000000" \
  --page-token "<next_page_token>" \
  --page-size 30 --compact

响应处理规则

• 只展示关键信息：在用户没有明确要求的前提下，仅展示与用户问题直接相关的核心字段，不得输出冗余字段。

• 禁止擅自聚合或排序：未经用户要求，不得对返回结果进行任何聚合统计或排序操作，按原始结果如实呈现。

• 成员回显格式（涉及成员的输出硬约束）：当输出对象包含"人"时（包括但不限于二次确认展示、查询结果展示、操作成功后的成员列表回显等所有面向用户的成员输出场景），每一名成员必须按 姓名（<标识>） 格式回显：

  • 姓名按以下优先级取值：① 通讯录 / 参会人列表响应中的显示名字段；② 若响应未返回姓名字段（典型如 contact search 唯一命中仅返回 open_id、contact lookup-by-phone/email 仅返回 open_id），沿用用户本次输入的搜索关键词（如 --username 的值）作为姓名；③ 两者都取不到时标注为 未知成员。严禁用 open_id / ms_open_id / userid / 邮箱前缀 / 花名 替代姓名；
  • 括号内标识从 部门、职位、open_id 中任选一项填入（有则填，全无时才允许省略括号），不强求齐全，优先级：部门 > 职位 > open_id；
  • 若某成员姓名缺失（走上文分支 ③），标注为 未知成员（<open_id>），不得省略标识；
  • 示例：张三（技术工程事业群/腾讯会议）、李四（高级工程师）、张三（ou_abc123...）。

• 受邀人管理类写操作的二次确认模板（ 强约束）：执行 meeting invitees-add / meeting invitees-remove / meeting invitees-replace 上述三条命令前，必须按下列模板向用户展示，缺一不可；模板中的成员严格遵循上文「成员回显格式」（姓名（<标识>）），会议一律使用 meeting_code（会议号），严禁出现 meeting_id。

  • 操作： 将 <待邀请成员，严格遵守上文「成员回显格式」，多人用中文顿号「、」分隔> <动作描述> 「<会议主题>」（会议号 <meeting_code>）<对象描述>
  • 影响： <按命令选择对应影响说明>

• 会议成员变更操作的回复模板（强约束）：执行 meeting invitees-add / meeting invitees-remove / meeting invitees-replace 成功后，回复必须严格按以下模板组织字段，且仅展示这些字段：

  • 会议主题
  • 会议时间（开始时间 ~ 结束时间，含时区）
  • 会议号（meeting_code，严禁展示 meeting_id）
  • 入会链接（join_url）
  • 已邀请成员（操作完成后当前完整的受邀成员列表）

  展示规则（严格遵守）：

  1. 「已邀请成员」的每一名成员严格遵循上文「成员回显格式」（姓名（<标识>）），若手头没有 open_id → 姓名 的映射，先调用 meeting invitees-list 获取最新受邀列表再回显；
  2. 会议主题、会议号、入会链接等基础字段若响应未直接返回，应通过 meeting get --meeting-id 补齐，不得遗漏字段或用 - / N/A 占位。

自动反馈规则

当 Agent 在使用 tmeet CLI 过程中遇到下列任一情况时，应识别并准备调用 tmeet tshoot feedback 将问题上报至平台，但在实际执行上报前必须先向用户二次确认，获得明确同意后再执行。

命令参数、--category 枚举的完整触发场景、字符长度约束与示例：详见 references/tmeet-tshoot.md。

触发时机（5 种 category）

Agent 应识别以下 5 种场景之一并触发反馈：tool_not_found（工具缺失）/ tool_error（工具报错）/ tool_inadequate（能力不足）/ unexpected_result（结果异常）/ suggestion（改进建议）。各 category 的详细触发场景与判定标准，见 references/tmeet-tshoot.md «--category 枚举值» 一表。

调用准则（决策层强约束）

• 必须二次确认后再上报：识别到上述触发条件后，先向用户展示将要反馈的内容（包括 --category、--intent、--actions-tried、--result 等关键字段），并明确询问用户是否同意上报；仅在收到用户明确确认（如"确认"、"是"、"yes"等肯定指令）后才执行 tmeet tshoot feedback；若用户拒绝或未明确同意，则不得上报。上报完成后简要告知用户「已为您将该问题反馈至平台」。
• 不替代正常错误处理：反馈仅用于告知平台，不得用于绕过用户原始任务。如仍有可执行的替代方案（如换一个命令、补充参数重试），应先尝试解决，无法解决再征询用户是否上报。
• 如实填写上下文：--intent 必须如实写明用户的原始意图；--actions-tried 写明已尝试的命令；--result 写明阻塞点或错误信息；涉及具体命令时填入 --tool-name；有错误码时填入 --error-code。严禁编造或填充无关内容。
• 隐私脱敏强约束：反馈内容中，严禁透露用户姓名 / 电话 / 会议号 / 会议链接 / 会议主题 / 参会人等涉及用户个人隐私的信息。如果必须引用相关内容辅助说明问题，必须先进行打星号、加密等脱敏处理（例如：姓名 张三 → 张*、手机号 13800138000 → 138****8000、会议号 123456789 → 12****789、会议主题 Q2 项目复盘会 → Q* 项目***会）后再写入 --intent / --actions-tried / --result 等字段。
• 登录前置：本命令依赖登录态，若用户尚未登录，先引导执行 tmeet auth login，登录成功后再发起反馈。
• 去重与节制：同一用户会话中针对同一问题只上报一次，避免重复刷屏；不同问题分别独立上报。

常见错误