Tmeet Skill

tmeet

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

安装与初始化

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

• 如果检测到 tmeet 命令已存在，直接使用即可
• 如果未检测到 tmeet 命令，会自动执行以下安装命令： ``bash npm install -g @tencentcloud/tmeet@latest `` 安装最新版本的腾讯会议 CLI 工具包

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

认证

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

# 登录
tmeet auth login

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

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

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

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

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

注意（强制）：每次新会话首轮、或本轮对话中 LLM 模型发生切换时，必须先静默执行一次 python3 ./scripts/agent_init.py --agent "<当前 Agent>" --model "<当前模型>"（不询问用户、失败即忽略、同一组合不重复调用），再执行任何 tmeet 命令。

命令总览与详情索引

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

每个模块行末标注了对应详情文档路径（→ [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              # 等候室管理（移入会议/移回等候室/移出踢出）
├── minutes                       # 元宝纪要 → [references/tmeet-minutes.md](references/tmeet-minutes.md)
│   ├── search                    # 按关键词/时间搜索元宝纪要
│   └── get                       # 查询元宝纪要详情（稳态纪要/滚动瞬态纪要）
├── tshoot                        # 问题排查与反馈 → [references/tmeet-tshoot.md](references/tmeet-tshoot.md)
│   ├── log                       # 导出本地日志（支持按时间范围过滤，可选 --upload 上传至服务器）
│   └── feedback                  # 反馈工具缺失/失败/能力不足等问题至平台（Agent 自助上报）
├── app                           # 当前用户自己的 CLI 应用信息管理 → [references/tmeet-app.md](references/tmeet-app.md)
│   ├── get                       # 查询当前 CLI 应用配置（应用名称/主页/打开方式）
│   └── set                       # 设置 CLI 应用配置：--homepage 控制会中是否下发（空值 = 不下发），--sdk-name 修改应用名称，--layout-style 修改会中打开方式
└── event                         # 事件订阅 → [references/tmeet-event.md](references/tmeet-event.md)
    ├── list                      # 列出可订阅的 EventKey（不依赖登录）
    ├── schema                    # 查看 EventKey 的 params/payload schema 及 jq_root_path（不依赖登录）
    ├── consume                   # 订阅事件并按 NDJSON 流式输出（需登录；批处理/常驻两种模式）
    ├── status                    # 查看本机 bus 守护进程状态（不依赖登录）
    └── stop                      # 停止本机 bus 守护进程（不依赖登录；--force 为写操作，需二次确认）

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

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

⚠️ 上表仅适用于「查会议本身」。若用户要的是「纪要 / 总结 / 会议要点 / 待办 / 会上讲过什么」， 先按下表选链路，不要套用上表： | 用户要什么 | 走哪条链路 | |---|---| | 纪要 / 总结 / 要点 / 待办（AI 加工后的内容） | 先判录制权限：有权限 → record smart-minutes；无权限 → minutes get / minutes search（详见「元宝纪要查询」） | | 发言原话 / 逐字稿 / 谁说了哪句 | record transcript-*（录制链路，需权限） | | 会议本身（时间 / 主题 / 参会人 / 会议号） | meeting list / list-ended / search | 「按时间找纪要」应走 `minutes search --start/--end`，不是 `meeting list-ended` —— minutes search 原生支持时间范围检索，一次即可返回多场纪要； 用 meeting list-ended 再逐场取纪要会造成 N+1 次调用。

会议查询

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

录制查询

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

⚠️ 本条不含「纪要查询」：纪要类请求（含跨会议搜纪要内容）的路由一律按下方「元宝纪要查询」节执行，该节自包含、无需先读本文档。 本条的「内容级搜索」指转写原文检索（用户要发言原话/逐字稿），不含元宝纪要文本检索。 若「元宝纪要查询」节的第 ② 类要求同时搜转写（record search --query-field transcript_content），可直接执行该一条命令，无需为此先读本文档。

元宝纪要查询

本节自包含 —— 路由决策直接按本节执行，不需要先读 reference。 （仅当需要具体参数/响应字段时再读 `references/tmeet-minutes.md`）

腾讯会议一场会议可能产生两类独立纪要：元宝纪要（基于会中 ASR、参会者人人可取无需权限、无逐字稿）、录制纪要（基于录制文件、创建者所有、需权限、有逐字稿）。不得仅凭命令名字面匹配。

第一步：先判请求属于哪一类

① 已知会议 —— 权限决定链路

先 meeting get 拿 permission_status（顺带返回，零额外调用成本）：

• can_view → 录制纪要 record smart-minutes（内容更全，含逐字稿）
• can_apply / closed / 无录制 → 元宝纪要 minutes get
• 录制侧取不到内容时（权限被拒/文件异常）→ 降级 `minutes get`，并告知用户实际用的是元宝纪要

② 跨会议检索 —— 两条都搜，不能只搜一条

此类请求无法先查权限（还不知道是哪些会），因此：

• minutes search --query（搜元宝纪要文本：概览/要点/待办/滚动总结）
• record search --query-field transcript_content（搜录制转写原文）
• 两条都要执行，按会议去重（同一会议多个录制文件只算一场），每条标注来源

⚠️ 一条搜空 ≠ 内容不存在，必须双向兜底： 元宝纪要是 AI 总结，细节（具体数字、某人某句、一次性提及）常被概括掉，但逐字稿里可能有； 反之转写侧无果时，元宝的概览/待办里也可能有归纳后的表述。 两条都搜完仍无结果，才可告知用户「未找到」，并说明已检索范围（元宝纪要文本 + 录制转写原文） 以及是否存在无权限的录制未能覆盖。

通用规则（两类都适用）

• 用户明确指定纪要类型时以用户为准，不再按上述判据推断。
• 要「原话 / 逐字稿 / 谁说了哪句」→ record transcript-*；无权限则降级元宝 short_summaries 并标注「非原话 / AI 加工版」。
• 用户要求「准确 / 原始 / 不要 AI 编的」→ 元宝纪要本身即 AI 产物，不满足该要求；须走 record transcript-*，无权限时先询问用户是否接受元宝内容，不得擅自充当原始材料。
• 双诉求（同时要「纪要 + 原话」）→ 两条链路并取，不是二选一；一侧取不到时先交付另一侧，再说明原因与申请入口。

使用准则

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

安全规则

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