tmeet
腾讯会议命令行工具,支持 OAuth 授权、会议全生命周期管理、录制与转写、会议报告查询。
安装与初始化
在使用本技能前,系统会自动检测是否已安装 tmeet 命令行工具:
- 如果检测到
tmeet命令已存在,直接使用即可 - 如果未检测到
tmeet命令,会自动执行以下安装命令:
bash npm install -g @tencentcloud/tmeet@latest
安装最新版本的腾讯会议 CLI 工具包
> 注意:自动安装需要网络连接和 npm 环境支持。如果安装失败,请手动执行上述命令或检查网络环境。
核心概念
- 会议(Meeting):腾讯会议实例,通过
meeting_id或meeting_code标识。meeting_id仅用于命令行参数传递,向用户展示会议信息时必须使用meeting_code(会议号),不得将meeting_id暴露给用户。 - 周期性会议(Recurring Meeting):
meeting_type=1的重复会议,包含多个子会议(sub_meeting_id)。 - 录制(Record):会议结束后生成的录制文件,通过
meeting_record_id和record_file_id标识。 - 智能纪要(Smart Minutes):基于录制文件生成的 AI 纪要。
- 转写(Transcript):录制文件的逐字转写内容,支持段落查询和关键词搜索。
- 报告(Report):会议结束后的统计数据,包含参会人列表和等候室成员。
认证
使用前必须先完成登录授权:
# 登录(必须后台运行,以便立即捕获授权 URL)
tmeet auth login 2>&1 &
# 登出(清除本地凭证)
tmeet auth logout
# 查看当前登录状态及 Token 有效期(无需登录即可执行)
tmeet auth status
> 注意:除 auth login,auth status 外,所有命令都需要先完成登录。未登录时命令会提示 user config is empty。
> 注意:auth login 是阻塞命令,必须以后台方式运行(命令末尾加 2>&1 &),否则命令会一直阻塞等待,模型无法捕获输出中的授权 URL。执行后从输出中提取授权 URL,必须将该链接完整展示给用户,并明确提示用户在浏览器中打开完成授权,不得省略或仅提示"已生成链接"等模糊描述。
> 注意:如果当前 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环境变量,不需要向用户询问。
时间格式
所有时间参数均使用 ISO 8601 格式,支持以下两种:
| 格式 | 示例 |
|---|---|
| 带时区(有秒) | 2026-03-12T14:00:00+08:00 |
| 带时区(无秒) | 2026-03-12T14:00+08:00 |
> 注意:不支持仅日期格式(如 2026-03-12),必须包含时间和时区信息。
> 时间逻辑校验:若用户提供的结束时间 ≤ 开始时间(如"4点到3点"),不得自行推断用户意图,必须先向用户确认是否跨天或存在笔误,再执行命令。
全局参数
所有子命令均继承以下全局参数。
--format:输出 JSON 形态
用于控制输出 JSON 的排版形态,不改变字段内容。输出结构统一为 {trace_id, message, data}。
| 取值 | 含义 | 适用场景 |
|---|---|---|
json(默认) |
单行紧凑 JSON,体积小、便于管道传递 | 模型解析、脚本处理、jq 过滤 |
json-pretty |
多行缩进 JSON,可读性强 | 需要将原始结果直接呈现给用户阅读时 |
使用示例:
# 默认紧凑格式(模型解析场景推荐,省略 --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 方案;原有的 --page / --pos / --pid / --size / --limit 参数均已标记为 已弃用,仅为兼容保留,模型不得主动使用。
| 参数 | 说明 |
|---|---|
--page-token <token> |
分页游标。首次查询不传;翻页时将上一次响应 data.next_page_token 的值原样传入 |
--page-size <n> |
每页数量,不同命令默认值与上限不同,详见各子命令文档 |
使用准则:
- 优先使用
--page-token翻页:调用下一页时,必须从上一次响应的data.next_page_token字段取值传入--page-token,不得自行拼接、递增或猜测该值。 - 到达末页的判定:当响应中的
next_page_token为空字符串或字段缺失时,即为最后一页,不再继续翻页。 - 禁止使用已弃用参数:即便用户对话中使用了"第 X 页"、"偏移 Y 条"等表达,也应以
--page-token分页策略实现(首次查询 → 读取next_page_token→ 继续翻页),不得使用--page/--pos/--pid/--size/--limit。 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
命令总览
tmeet
├── auth
│ ├── login # OAuth 授权登录
│ ├── logout # 登出并清除凭证
│ └── status # 查看当前登录状态及 Token 有效期
├── meeting
│ ├── create # 创建会议(支持普通/周期性)
│ ├── update # 更新会议信息
│ ├── cancel # 取消会议
│ ├── get # 获取会议详情
│ ├── list # 获取会议列表(进行中/未开始)
│ ├── list-ended # 获取已结束会议列表
│ ├── invitees-list # 获取会议受邀者列表
│ ├── invitees-add # 添加会议受邀者
│ ├── invitees-remove # 移除会议受邀者
│ └── invitees-replace # 替换会议受邀者列表
├── contact
│ ├── search # 搜索企业通讯录成员(按用户名/职位/部门,仅用于会议邀请和呼叫入会场景)
│ ├── lookup-by-phone # 按手机号查找用户
│ └── lookup-by-email # 按邮箱查找用户
├── record
│ ├── list # 查询录制列表
│ ├── address # 获取录制文件下载地址
│ ├── smart-minutes # 获取智能纪要
│ ├── transcript-get # 获取转写详情
│ ├── transcript-paragraphs # 获取转写段落列表
│ ├── transcript-search # 搜索转写内容
│ ├── permission-apply-prepare # 预览录制权限申请信息(申请前确认)
│ └── permission-apply-commit # 提交录制权限申请(用户确认后执行)
├── report
│ ├── participants # 获取参会人列表
│ └── waiting-room-log # 获取等候室成员列表
├── control
│ ├── call # 呼叫成员入会(会中邀请呼叫)
│ └── kick # 踢出会议成员(会中踢人)
├── tshoot
│ ├── log # 导出本地日志(支持按时间范围过滤,可选 --upload 上传至服务器)
│ └── feedback # 反馈工具缺失/失败/能力不足等问题至平台(Agent 自助上报)
└── ai # 【Agent 工作流,非 tmeet CLI 子命令】智能会议内容生成(含会议类型识别与场景化模板)
├── briefing # 会前:根据主题与用户想法生成发言稿(按会议类型场景化)
├── live # 会中:用户分段粘贴转写/口述 → 动态调整发言稿并提醒补充(手动模式,不依赖实时流)
├── capture # 会中:用户粘贴片段/术语 → 捕捉热点与冷僻知识点并生成解析卡(手动模式)
├── report # 会后:生成个人专属报告(热点地图+知识图谱+场景特色萃取)
├── series # 系列会议:跨多场同主题会议聚合知识图谱与演进时间线
└── export # 导出 PPT/PDF/日历(.ics)(用户主动要求)
子命令详情
- 认证:
references/tmeet-auth.md - 会议管理:
references/tmeet-meeting.md - 录制管理:
references/tmeet-record.md - 会议报告:
references/tmeet-report.md - 通讯录:
references/tmeet-contact.md - 会中控制:
references/tmeet-control.md - 问题排查:
references/tmeet-tshoot.md - 智能会议内容生成(AI 助手):
references/tmeet-ai.md
智能会议内容生成(AI 助手)
> 定位说明:本章节描述的是 Agent 侧 AI 工作流,不是 tmeet CLI 子命令。tmeet CLI 仅作为数据来源(读取会议主题、转写、纪要、参会人),实际的内容生成(发言稿、热点解析、知识图谱、报告)由 Agent 调用自身能力完成。所有产物默认输出为 HTML 预览,仅在用户主动要求时导出 PPT / PDF。
> 会中实时(手动模式)说明:live / capture 为会中手动模式——当前 tmeet CLI 不提供会议实时转写流,因此由用户在会议进行中分段粘贴腾讯会议字幕 / 自己的口述要点,Agent 据此动态更新发言稿、适时提醒补充、并即时生成热点与知识点解析卡。无需安装任何额外组件,也不调用会议控制命令。若未来 tmeet / 腾讯会议开放平台支持实时转写推送,本能力可无缝升级为自动流式捕捉(数据源由"用户粘贴"切换为"流式推送",工作流不变)。
能力总览
| 子能力 | 阶段 | 触发示例 | 输入来源(tmeet 命令) | 产物 |
|---|---|---|---|---|
briefing 会前发言稿 |
会前 | "根据'Q2 复盘会'主题帮我写个发言稿" | meeting get(主题/时间)+ 用户想法 |
发言稿 HTML |
live 会中动态调整 |
会中(手动) | "开会了,帮我看发言稿到哪了" / "接下来该说啥" | 会前发言稿 + 用户分段粘贴的转写/口述 | 更新后的发言稿 + 补充提醒(对话消息) |
capture 会中热点捕捉 |
会中(手动) | "刚那段没懂,帮我解析下" / "捕捉下当前热点" | 用户粘贴的转写片段 / 术语 + 可选 meeting get 主题 |
热点/知识点解析卡 HTML |
report 会后个人报告 |
会后 | "会开完了,给我出个个人总结" | record smart-minutes / transcript-* / report participants |
个人专属报告 HTML(热点地图 + 知识图谱) |
series 系列会议聚合 |
会后(跨多场) | "把这几场会串起来做个总图" | 系列内各场 report.html / record smart-minutes |
跨会议聚合知识图谱 HTML(实体演进 + 时间线) |
export 导出 |
按需 | "导出 PPT / 导出日历" | 已生成的 HTML 报告 / 报告中的决策·行动项 | PPTX / PDF / .ics 日历文件 |
会议类型识别与适用性判定
本技能的 AI 模块定位为 「专业会议增强器」,面向内容沉淀与知识萃取型会议;对以行政指令 / 人事评价为主的会议不适用或需降级。这是硬性定位,不是可选优化——Agent 在触发 briefing / report 前必须先做类型判定。
类型识别:基于 meeting get 返回的 subject、会议描述,结合 report participants / invitees-list 推断的参会人构成,做初步分类。可用以下关键词路由(命中多个时取权重最高者):
| 类型 | 典型关键词 | 适用性 |
|---|---|---|
| 学术研讨 | 研讨 / 论坛 / 论文 / 课题 / 综述 / 评审 / 学术 / 研究 / 研讨会 | ✅ 适用 |
| 疑难问题研讨 | 疑难 / 攻关 / 根因 / 问题诊断 / 技术研讨 / 务虚研讨 / 专题研讨 | ✅ 适用(学术子类,强化根因分析与方案对比) |
| 商业交流 | 商务 / 洽谈 / 合作 / 融资 / 客户 / 供应商 / 谈判 / 交流会 | ✅ 适用 |
| 重要路演 | 路演 / 推介 / 融资路演 / 招股 / pitching / Demo Day / 发布 | ✅ 适用(商业子类,强化融资/估值/里程碑) |
| 新事务探索 | 新事务 / 探索 / 立项 / 新方向 / 机会评估 / 务虚 / 前瞻 | ✅ 适用(商业子类,强化机会/风险/待决事项) |
| 争议纠纷解决 | 争议 / 纠纷 / 调解 / 协商 / 和解 / 仲裁 / 谈判化解 | ✅ 适用(商业子类,强化立场/共识/协议结构化) |
| 技术培训 | 培训 / 教程 / 实操 / 演练 / 讲授 / Workshop / 内训 / 讲座 | ✅ 适用 |
| 高校教学 / 大型公开课 | 公开课 / 高校教学 / 慕课 / 课程 / 授课 / 学堂 / 大班课 | ✅ 适用(培训子类,受众为学生/大众,强化教学覆盖与互动) |
| 新技术研讨 | 新技术 / 技术研讨 / 技术选型 / 架构 / 前沿技术 / 技术评审 / 可行性论证 | ✅ 适用(培训子类,强化技术优劣对比与落地路径) |
| 经济论坛 | 经济论坛 / 经济形势 / 宏观 / 产业政策 / 市场趋势 / 财经 / 行业峰会 | ✅ 适用(商业子类,强化研判/机会/风险与待跟踪指标) |
| 任务布置 | 周会 / 晨会 / 布置 / 派活 / 同步进度 / 站会 / 例行性 | ⚠️ 降级 |
| 内部赏罚 | 绩效 / 考核 / 评优 / 奖惩 / 述职 / 人事 / 晋升 / 表彰 | ⛔ 禁用图谱 |
> 覆盖说明:大型公开课、高校教学归入技术培训场景(受众为学生 / 大众,强化教学覆盖图与课堂互动);新技术研讨归入技术培训场景(强化技术优劣对比与落地路径);重要路演、新事务探索、争议纠纷解决、经济论坛归入商业交流场景(分别强化融资诉求/估值/里程碑、机会/风险/待决事项、立场/共识/协议结构化、研判/机会/风险与待跟踪指标);疑难问题研讨归入学术研讨场景(强化根因分析与方案对比)。上述子类均使用对应模板(见 references/tmeet-ai.md 的「会议类型路由与场景化模板」)。
适用性判定与降级规则:
- 命中「适用」 → 走完整流程:
briefing用对应场景化模板(见references/tmeet-ai.md)+report完整生成(热点地图 + 知识图谱 + 特色萃取);报告还须满足结构清晰、层次分明、图文并茂、定性定量结合、行文专业严谨、过渡自然连贯,并深度分析会议中的争议、新要素(N新,不限数量)、热点(见references/tmeet-ai.md的「深度分析」规范与「质量要求 · 行文质量」)。 - 命中「任务布置」等降级类 → 先提示用户再降级:
briefing退化为议程草案(仅议题列表 + 时间盒,不做观点 / 论据展开);report退化为行动项 / 纪要(仅待办清单 + 责任归属,不生成热点地图、不生成知识图谱)。- 命中「内部赏罚」等禁用类 → 仅生成内部执行清单(评分维度 / 结论 / 待沟通项);强制本地脱敏、绝不上传、不生成热点地图与知识图谱;若用户要求图谱类产物,明确告知「此类会议不适用知识萃取,已按内部清单输出」。
- 拿不准时 → 向用户确认会议性质后再决定走完整流程还是降级,不得默认套用完整图谱模板。
> 三套场景化模板(briefing 骨架 / report 特色萃取)的触发词、生成结构、示例见 references/tmeet-ai.md 的「会议类型路由与场景化模板」章节。
通用生成规范
- 默认 HTML + 场景化视觉风格:所有生成物先产出 HTML 文件(内联 CSS,单文件可直接浏览器打开),并通过预览面板展示;HTML 须按识别出的会议场景套用对应视觉皮肤(配色/字体/版式/可视化偏好见
references/tmeet-ai.md的「场景化视觉风格系统」),风格与场景不匹配视为不满足需求;每份 HTML 预览后主动提示用户:如需 Word 版或 PDF 版,可再次指令导出。 - 行文质量:所有产物(briefing / live / capture / report / series 及导出稿)文字须满足「专业术语、逻辑严谨、过渡自然」三项要求(见
references/tmeet-ai.md的「质量要求 · 行文质量」):优先使用领域公认术语与约定缩写;每个论断给出依据与推理路径、区分事实与观点;章节与段落间以承上启下的过渡句自然衔接,避免跳跃与堆砌。 - PPT / PDF 仅按需:仅当用户明确要求"生成 PPT / 课件 / PDF"时才导出;默认不生成。导出流程见
references/tmeet-ai.md。 - 隐私:参会人仅以姓名 / 脱敏标识呈现;生成物默认保存到本地工作区,不外传;严禁在产物中写入令牌 / 手机号 / 邮箱等内部标识。
- 落盘路径:建议保存到当前工作区
./meeting-assets/<meeting_code>/,同一会议的相关产物归入同一目录,便于会后汇总与导出。 - 产物署名(作者标识):所有产物(含导出的 Word / PPT / PDF / 日历)末尾必须固定呈现作者署名——上官卿雲(建议含邮箱
shangguanqinyun@agent.qq.com,可用TMEET_AUTHOR_EMAIL覆盖)。本 skill 原创的完整法律声明(版权归属 / 禁止篡改 / 禁止未授权分发 / 禁止商业应用 / 引用规范 / 免责)见本文档末尾「版权声明(skill 原创)」,不要求在每份生成物中重复铺陈。
典型工作流
会前:meeting get → 取主题/时间 → [briefing] 生成发言稿 HTML → 展示给用户
会中(手动模式):用户分段粘贴转写/口述 → [live] 动态更新发言稿 + 到点提醒;[capture] 热点/知识点解析卡(提示用户:tmeet 无实时流,请把字幕/口述粘贴进来)
会后:record smart-minutes + transcript + report participants → [report] 生成个人报告 HTML(热点地图+知识图谱)
系列:同一主题多场会议 → 收集各场 report → [series] 聚合知识图谱 HTML(实体演进+时间线)
导出:用户明确要求 → [export] HTML → PPTX/PDF(本机为主,腾讯文档兜底);或报告含带日期决策/行动项 → 导出 .ics 日历(离线)
> 各子能力的触发词、详细流程、参数与示例见 references/tmeet-ai.md。
安全规则
-
禁止输出 AccessToken / RefreshToken 到终端明文。
-
写操作必须二次确认,严禁直接执行:以下命令会对数据产生不可逆或高风险影响,在调用命令前必须先向用户展示将要执行的操作详情,并明确获得用户确认后才能执行,不得跳过确认步骤:
| 命令 | 风险说明 |
|---|---|
meeting cancel |
取消会议,不可恢复 |
meeting update |
修改会议信息(时间、主题等),影响所有参会人 |
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. 若用户未明确确认或表示取消,则终止操作。
-
必填参数缺失时,必须向用户确认补充,禁止自行填充:若执行命令所需的必填参数未由用户提供,不得自行推断或填充默认值,必须明确告知用户缺少哪些参数并请求补充,待用户提供后再执行命令。
-
通讯录搜索仅限特定场景使用:
contact search仅可用于“会议邀请”(如meeting invitees-add、meeting invitees-replace)、“呼叫成员入会”(control call),以及“为成员变更操作的回复回填受邀人姓名”三类场景,用于将用户名解析为对应的openId或将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等)。必须将候选项的关键信息以清晰列表形式展示给用户(contact search场景下严格按上一条规则仅展示姓名/部门/职位),并明确询问"请确认要选择哪一项",待用户明确指定后再继续执行。即便其中某条结果看起来"明显更匹配",也必须等待用户确认,不得跳过该步骤。 -
AI 生成内容(发言稿 / 个人报告)的隐私与安全:
-
PPT / PDF 导出必须用户主动要求:默认仅生成 HTML 预览报告;仅当用户明确表达"生成 PPT / 生成 PDF / 导出课件"等意图时才调用导出流程(见
references/tmeet-ai.md),不得自行推断用户需要 PPT/PDF。 - 生成物本地落盘、脱敏展示:发言稿、个人报告等含用户隐私,默认保存到用户工作区 / 本地,不得上传至任何外部服务;向用户展示时参会人仅以姓名(或脱敏标识)呈现,严禁输出
open_id/ 手机号 / 邮箱等内部标识。 - 禁止注入凭证:AI 生成内容中严禁出现 AccessToken / RefreshToken 等任何敏感凭证。
-
会中粘贴内容仅用于本会议辅助:
live/capture中用户粘贴的转写 / 口述 / 术语仅用于生成本次会议的发言稿动态调整与知识点解析,会议结束后按用户要求清理临时内容,不得另作他用、不上传至任何外部服务、不经由tshoot feedback上报其内容。 -
会议类型适用性护栏(硬约束):AI 模块仅面向学术研讨 / 商业交流 / 技术培训等内容沉淀型会议。对单纯任务布置、内部赏罚等行政 / 人事类会议,必须按上文「会议类型识别与适用性判定」降级或禁用图谱类产物,不得为不适用的会议生成热点地图 / 知识图谱。内部赏罚类会议产物强制本地脱敏、绝不上传、不调用
tshoot feedback上报其内容。
响应处理规则
- 只展示关键信息:在用户没有明确要求的前提下,仅展示与用户问题直接相关的核心字段,不得输出冗余字段。
- 禁止擅自聚合或排序:未经用户要求,不得对返回结果进行任何聚合统计或排序操作,按原始结果如实呈现。
-
会议成员变更操作的回复模板(强约束):执行
meeting invitees-add/meeting invitees-remove/meeting invitees-replace成功后,回复必须严格按以下模板组织字段,且仅展示这些字段: -
会议主题
- 会议时间(开始时间 ~ 结束时间,含时区)
- 会议号(
meeting_code,严禁展示meeting_id) - 入会链接(
join_url) - 已邀请成员(操作完成后当前完整的受邀成员列表)
「已邀请成员」展示规则(严格遵守):
1. 必须展示通讯录中的姓名(如 张三),严禁直接展示 open_id / userid / ms_open_id / 花名 / 邮箱前缀等任何内部标识;
2. 若手头没有 open_id → 姓名 的映射,先调用 meeting invitees-list 获取最新受邀列表,再用 contact search(仅在该场景下允许)将 open_id 解析为姓名;若某个 open_id 解析失败,标注为 未知成员,禁止回退到打印 open_id;
3. 当且仅当用户明确要求“展示 ID / 原始字段”时,才可附带展示 open_id;
4. 会议主题、会议号、入会链接等基础字段若响应未直接返回,应通过 meeting get --meeting-id 补齐,不得遗漏字段或用 - / N/A 占位。
自动反馈规则
当 Agent 在使用 tmeet CLI 过程中遇到下列任一情况时,应识别并准备调用 tmeet tshoot feedback 将问题上报至平台,但在实际执行上报前必须先向用户二次确认,获得明确同意后再执行;详细参数与示例见 references/tmeet-tshoot.md。
触发条件(满足任一即上报)
--category |
触发场景 |
|---|---|
tool_not_found |
用户想做某事,但 tmeet 当前没有匹配的命令/子命令可完成 |
tool_error |
调用某个 tmeet 命令返回了错误(业务错误码 / 参数错误 / 执行异常) |
tool_inadequate |
命令存在,但其参数或能力无法满足用户当前诉求 |
unexpected_result |
命令调用成功,但返回结果与用户/Agent 期望明显不一致 |
suggestion |
在交互中识别到通用性改进建议或新增能力提议 |
调用准则
- 必须二次确认后再上报:识别到上述触发条件后,先向用户展示将要反馈的内容(包括
--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等字段。 - 字符长度约束:
--intent ≤ 200/--actions-tried ≤ 500/--result ≤ 500,超长会被客户端直接拒绝,请精炼描述。 - 登录前置:本命令依赖登录态,若用户尚未登录,先引导执行
tmeet auth login,登录成功后再发起反馈。 - 去重与节制:同一用户会话中针对同一问题只上报一次,避免重复刷屏;不同问题分别独立上报。
典型示例
# 用户希望批量导出某月所有会议的智能纪要,但 tmeet 暂无批量命令
tmeet tshoot feedback \
--category "tool_not_found" \
--intent "批量导出 2026-04 整月所有会议的智能纪要" \
--actions-tried "查阅 record list / record smart-minutes" \
--result "未找到批量导出命令"
常见错误
| 错误现象 | 原因 | 解决方案 |
|---|---|---|
user config is empty |
未登录 | 执行 tmeet auth login |
--start format error |
时间格式不合法(如缺少时区) | 改用 2026-03-12T14:00:00+08:00 格式 |
--meeting-id is required |
缺少必填参数 | 补充对应必填参数 |
user has been initialized |
已登录,重复执行 login | 直接使用,或先 logout 再 login |
版权声明(skill 原创)
tmeet-skill(含「智能会议内容生成(AI 助手)」模块及其全部模板、规范与示例)为作者上官卿雲之原创作品,著作权归上官卿雲所有,受《中华人民共和国著作权法》及适用的国际版权条约保护。
- 版权归属:本 skill 及其全部内容(文档、模板、代码、示例)著作权归上官卿雲所有。
- 禁止篡改:不得擅自修改、篡改、去除署名或本声明;任何修改须完整保留原始署名与声明,并显著标注「已修改」。
- 禁止未授权分发:未经作者书面许可,不得以任何形式复制、转载、二次分发、上传至公开平台或转发给无关第三方。
- 禁止商业应用:不得用于任何商业用途(含售卖、转售、作为收费服务或产品之一部、商业培训、引流变现);商业使用须事先取得作者授权。
- 引用规范:合法引用须注明出处与作者姓名,且不得引申、曲解为作者之立场或背书。
- 免责声明:本 skill 及生成内容(尤其模拟 / 示例数据)仅供研究与参考,不构成专业法律、投资或工程意见;使用者须自行评估并承担应用后果。
作者:上官卿雲 | 联系渠道(授权 / 侵权举报):shangguanqinyun@agent.qq.com | 本作品含作者数字署名,任何篡改将破坏其完整性。
完整性校验(防篡改)
本 skill 在发布时由 scripts/build_skill.py 计算目录内容 SHA-256 指纹,存于 _meta.json 的 integrity.contentHash。安装后或分发前,可运行:
python scripts/verify_skill.py <skill 目录>
若输出「完整性校验通过」即未被篡改;若哈希不符,则提示文件已被篡改或版本不匹配。注意:自行修改 skill 内容(含正常升级)会改变指纹,属预期行为,重新执行 build 即可更新基准。