腾讯会议智能管控 Skill · V1.3.0

> 重新定义会议体验：从"被动开会"到"主动管理"，让每一场会议都有准备、有产出、有闭环。

⛔ 强制使用说明（每次加载 Skill 时请先阅读此项）

> ⚠️ 使用本 Skill 前，请务必逐条确认以下内容。不满足条件时禁止执行任何指令。

✅ 开机自检（不通过则不能使用）

□ [1/3] tmeet CLI 已安装并可用           → tmeet --version
□ [2/3] OAuth 已登录且会话未过期          → tmeet auth status
□ [3/3] 已知悉自己的角色权限               → tmeet-plus auth permission list

> 三项全部通过后方可继续。任何一项失败 → 先解决再操作。

🔥 操作铁律（任何时候不得违反）

> 以上铁律在下方每个模块的使用说明中会以 ⚠️ 标记再次提醒，此处是总纲。

🎯 当前想做什么？—— 定位你需要的模块

前置条件与通用约定

环境要求

指令前缀规范

原生 CLI：   tmeet meeting create
二创 Skill： tmeet-plus meeting create

> 本文所有指令统一使用 tmeet-plus 前缀。

⚠️ 通用安全提醒

• 高危操作（批量取消、全员踢出、修改录制权限）仅管理员可执行，执行前需 --confirm 二次确认
• 所有指令操作记录全量留存日志，可追溯
• 正式/测试环境严格隔离，测试指令加 --env test

① 会前准备

⛔ 本模块使用说明（进入此模块请先阅读）

适用的场景：
> 你要创建一场会议 / 检查议程是否规范 / 确认参会人时间 / 挂载会前资料 / 批量清理无效会议

开始前请确认：

□ 是否已确定会议主题和议程？（无议程 → 禁止创建）
□ 是否已筛选核心参会人？（全员拉入 → 建议先 filter）
□ 是否已检查时段是否合理？（午休/下班时段 → 拦截）
□ 是否已挂载必读资料？（需要参会人提前阅读的 → 标记 required）

本模块的操作流程：

Step 1 → 模板建会或手动创建
Step 2 → 校验：日程冲突 + 时段合理 + 查重
Step 3 → 管理参会人：筛选 / 分组 / 请假登记
Step 4 → 挂资料 + 设提醒
Step 5 → （可选）治理无效会议

⚠️ 必须人工操作的环节： 核心人缺席确认、批量取消二次确认、清理前预览

能力边界

触发方式

⚠️ 需要人工介入的环节

使用说明书

Step 1：日常建会 — 模板走起

# 周例会（30分钟，固定议程，自动循环）
tmeet-plus meeting create --template weekly \
  --user @产品部 --agenda "本周需求评审" --remind 30,10
# 执行效果：
# 📋 使用模板 [weekly]: 周例会（30分钟）
# 📅 正在创建周例会...
# ├─ 主题: 本周需求评审
# ├─ 参会人: @产品部（共8人）
# ├─ 时长: 30 分钟
# ├─ 提醒: 30分钟前, 10分钟前
# └─ ✅ 会议创建成功: 123456789

# 项目专项会（45分钟，必须挂资料）
tmeet-plus meeting create --template project \
  --user @项目组 --agenda "版本发布方案评审" \
  --file-url "https://docs.qq.com/doc/xxx" --file-type required
# 执行效果：
# 📋 使用模板 [project]: 项目专项会（45分钟）
# 📅 正在创建项目会...
# ├─ 主题: 版本发布方案评审
# ├─ 参会人: @项目组（共5人）
# ├─ 时长: 45 分钟
# ├─ 资料: 必读（1份）
# └─ ✅ 会议创建成功: 987654321

# 临时紧急会（20分钟，自动缩短提醒间隔）
tmeet-plus meeting create --template urgent \
  --user @研发,测试 --agenda "线上故障复盘" --tag urgent
# 执行效果：
# 📋 使用模板 [urgent]: 临时紧急会（20分钟）
# 📅 正在创建紧急会议...
# ├─ 主题: 线上故障复盘
# ├─ 参会人: @研发,@测试（共3人）
# ├─ 时长: 20 分钟
# ├─ 标签: urgent
# └─ ✅ 会议创建成功: 555666777

Step 2：会前检查清单

# 0️⃣ 检查是否有重复会议
tmeet-plus meeting check-duplicate --time "2026-07-22 14:00" --title "周例会"
# 执行效果：
# ✅ 未发现重复会议（主题"周例会"×时段"14:00" 无冲突）

# 1️⃣ 检查参会人日程冲突
tmeet-plus meeting check-conflict --users @产品部,@设计部 --time "2026-07-22 14:00-15:00"
# 执行效果：
# 📅 日程冲突检测结果
#   ├─ 产品部（8人）
#   │   ├─ 张伟 ✅ 空闲
#   │   ├─ 李芳 ⚠️ 14:30-15:00 已有会议
#   │   └─ 其他6人 ✅ 空闲
#   ├─ 设计部（5人）
#   │   └─ 全部 ✅ 空闲
#   └─ 🟢 核心参会人（required）无冲突，建议保留当前时段

# 2️⃣ 检查时段是否合理
tmeet-plus meeting check-time --time "2026-07-22 12:30"
# 执行效果：
# ⚠️ 午休时段（12:00-14:00），建议避开
#   推荐: 14:00-15:00 / 10:00-11:00

# 3️⃣ 查看建议时段（自动推荐空闲时段）
tmeet-plus meeting suggest-time --users @产品部,@设计部
# 执行效果：
# 🕐 推荐空闲时段（2026-07-22）
#   1️⃣ 10:00-11:00 ✅ 全员空闲（推荐）
#   2️⃣ 14:00-15:00 ✅ 6/7 人空闲
#   3️⃣ 15:30-16:30 ✅ 5/7 人空闲
#   4️⃣ 09:00-10:00 ⚠️ 2 人标记为"非工作时间"

Step 3：参会人管理

# 按部门筛选参会人
tmeet-plus meeting filter-attendees --department 产品部 --required 张伟

# 请假登记（自动通知会议发起人）
tmeet-plus attendee leave --user 王芳 --replace 李强

# 大型会议分会场分组
tmeet-plus attendee group --id [会议ID] --group "需求评审" --users @产品组
tmeet-plus attendee group --id [会议ID] --group "技术评审" --users @研发组

Step 4：资料与提醒

# 区分必读/参考资料
tmeet-plus meeting create --file-url "链接A" --file-type required
tmeet-plus meeting create --file-url "链接B" --file-type reference

# 多轮提醒（30分钟前 + 15分钟前 + 5分钟前）
tmeet-plus meeting remind --id [会议ID] --times 30,15,5

Step 5：会后清理前预览

# 先看哪些会议可以清理（预览模式）
tmeet-plus meeting list --tag regular --stat
tmeet-plus user load --name 张伟 --range week

# 确认后批量清理（需要二次确认）
tmeet-plus meeting cancel --batch [ID列表] --ignore-error --confirm

常见问题

② 会中提效

⛔ 本模块使用说明（进入此模块请先阅读）

适用的场景：
> 你正在主持会议 / 会议经常超时 / 有人霸麦或冷场 / 讨论跑题了 / 有访客在等候室

开始前请确认：

□ 是否已在会前设置时长监控？（未设置 → 不会自动计时）
□ 是否已设置议程关键词？（跑题识别依赖关键词质量）
□ 主持人是否在场？（多数操作需要主持人身份）

本模块的自动/手动分工：

🔄 自动运行（无需操作）：
   - 倒计时提醒（结束前 5min/2min/1min）
   - 跑题后台静默检测
   - 会议结束自动收尾（关录制、收权限）

👆 需要你操作的：
   - 严重跑题 → 执行拉回指令
   - 接近超时 → 决定是否延长
   - 沉默成员 → 选择私密提醒或公开呼叫
   - 等候室访客 → 放行/拒绝

⚠️ 必须人工操作的环节： 跑题拉回、是否延长、等候室决策、权限回收

能力边界

触发方式

⚠️ 需要人工介入的环节

使用说明书

会前准备（主持人操作）

# 会议开始前设置总时长，开启监控（会后自动启动）
tmeet-plus meeting monitor --id [会议ID] --duration 30

# 如果议程有多个环节，开启逐环节计时
tmeet-plus agenda monitor --id [会议ID] --step-timing

时长控制（会议进行中）

# 状态 ① 正常进行 — 倒计时自动运行，结束前 5min/2min/1min 推送提醒
tmeet-plus meeting monitor --id 123456789 --duration 30
# 执行效果：
# ⏱️ 时长监控已启动
#   ├─ 会议ID: 123456789
#   ├─ 设定时长: 30 分钟
#   ├─ 状态: 🟢 监控中（倒计时自动运行）
#   └─ 提醒节点: 结束前 5min / 2min / 1min 自动推送

# 状态 ② 接近超时 — ⚠️ 主持人收到"即将超时"提示
#                    → 如果议题讨论到关键处，可以延长一次
tmeet-plus meeting extend --id 123456789 --time 10
# 执行效果：
# ⏱️ 延长请求已提交
#   ├─ 延长时长: 10 分钟
#   ├─ 剩余延长次数: 0 次（已达上限）
#   └─ ✅ 会议已延长至 XX:XX 结束
#      ⚠️ 延长次数有限，请合理分配延长时间

# 状态 ③ 超时收尾 — 自动关闭录制、收回全员发言权限
#                    主持人可手动保留录制

发言与麦位管控

# 防止霸麦：限制每人单次最长发言（单位：分钟）
tmeet-plus meeting mic limit --id [会议ID] --max-time 5

# 实时查看转写内容，判断是否跑题
tmeet-plus record trans --id [会议ID] --real-time

# 轻度跑题：后台静默提醒主持人
# 严重跑题：⚠️ 弹窗提示，主持人执行拉回操作
tmeet-plus meeting remind-focus --id [会议ID] --message "请回归议程"

# 跑题片段自动标记，写入会议日志 ✅

冷场 / 一言堂 激活（精细化发言分析）

# 查询互动状态（按发言类型分类）
tmeet-plus meeting attendee status --id [会议ID]

# ⚠️ 输出示例（三类发言分类）：
# ┌─ 有效发言 ─────────────────────────────┐
# │ 张伟(3次观点) 李强(2次方案)             │
# ├─ 简短插话 ─────────────────────────────┤
# │ 王芳(1次附和) 赵六(2次提问)             │
# ├─ 全程沉默 ─────────────────────────────┤
# │ 陈静(0次) 周明(0次)                    │
# └─────────────────────────────────────────┘

#  → 推荐操作：私密提醒沉默成员（仅对方可见，不打断会议）
tmeet-plus meeting whisper --user [账号] --message "张工，想听听你的看法"

# 或者按部门定向引导
#  → 如果设计部全程沉默：
#  → 私密提醒 @设计部全员

等候室 / 访客管理

# ⚠️ 访客进入等候室 → 提示管理员
tmeet-plus meeting waiting --id [会议ID] --allow-all    # 全部放行
tmeet-plus meeting waiting --id [会议ID] --reject-all   # 全部拒绝
tmeet-plus meeting waiting --id [会议ID] --allow [账号] # 单个放行

# 查看当前等候室列表
tmeet-plus attendee list --guest

常见问题

③ 会后跟进

⛔ 本模块使用说明（进入此模块请先阅读）

适用的场景：
> 会议刚结束 / 需要导出纪要和任务 / 想设置任务督办 / 存储空间快满了

开始前请确认：

□ 会议是否已结束？（尚未结束 → 纪要未生成）
□ 会议是否开启了录制？（未录制 → 无转写内容）
□ 您是会议发起人或管理员？（参会人只有查看权限）

本模块的自动/手动分工：

🔄 自动运行（无需操作）：
   - 会议结束 → 自动生成智能纪要
   - 任务逾期 → 自动告警责任人+上级
   - 督办提醒 → 按周期自动推送

👆 需要你操作的：
   - 人工复核纪要准确性
   - 确认/补录任务分配
   - 回传任务完成状态
   - 清理过期文件

⏳ 关键时间线：
   会议结束 → 1-5min 纪要生成 → 人工复核 → 拆分结构化
   → 确认任务 → 设督办 → 跟踪进度 → 归档清理

⚠️ 必须人工操作的环节： 纪要复核、任务确认、口头决议补录、完成标记、清理前预览

能力边界

触发方式

⚠️ 需要人工介入的环节

使用说明书

Step 1：会议结束后 🔔 自动纪要

会议结束 → 系统自动生成智能纪要 → 推送通知给所有参会人

# 查看并下载纪要
tmeet-plus record summary --id 123456789
# 执行效果：
# 📝 智能纪要 #123456789
#   ├─ 会议主题: 本周需求评审 (2026-07-21 14:00-14:30)
#   ├─ 参会人: 张伟(主持人) / 李芳 / 王强 / 赵六
#   │
#   ├─ 📌 核心结论
#   │   ├─ 1. 确定 Q3 版本发布时间为 8月15日
#   │   ├─ 2. 放弃旧方案，采用微服务新架构
#   │   └─ 3. 下周追加一次技术预审
#   │
#   ├─ 📋 待办事项
#   │   ├─ [高] 张伟 - 8/1前输出技术方案 (截止: 2026-07-28)
#   │   ├─ [中] 李芳 - 协调设计资源 (截止: 2026-07-25)
#   │   └─ [低] 王强 - 整理会议纪要 (截止: 2026-07-22)
#   │
#   └─ ⚠️ 建议人工复核
#       └─ AI 提取的任务无法保证 100% 准确，请发起人确认后再分发

Step 2：⚠️ 人工复核纪要

输出的纪要会包含原始转写全文 + AI 提炼内容。
发起人需做：

1. 修正转写中的明显错别字/漏记
2. 补充口头讨论但转写没捕捉到的关键结论
3. 确认 AI 提取的任务是否准确

Step 3：结构化拆分（结论/待办/风险）

# 自动拆分为三大模块
tmeet-plus summary split --id [纪要ID]

# 输出示例：
# ┌─ 结论项 ──────────────────────────┐
# │ 1. 确定 Q3 版本发布时间为 8月15日   │
# │ 2. 放弃旧方案，采用新架构           │
# ├─ 待办项 ──────────────────────────┤
# │ 1. [高] 张伟 - 完成架构设计文档 - 7/25 │
# │ 2. [中] 李强 - 通知合作方改期     - 7/23 │
# ├─ 风险项 ──────────────────────────┤
# │ 1. 第三方 SDK 尚未完成兼容测试      │
# └────────────────────────────────────┘

Step 4：⚠️ 确认 + 补录任务

# 1. 复核 AI 提取的任务，确认责任人
# 2. 补录遗漏的口头任务
tmeet-plus summary add-task --person 王芳 --deadline "2026-07-28" --priority high

# 3. 设置任务优先级
tmeet-plus task set-priority --task-id [任务ID] --level high

# 4. 设置阶梯督办
tmeet-plus task remind --summary-id [纪要ID] --cycle daily

Step 5：跟踪进度（会后持续）

# 随时查询任务进度
tmeet-plus task progress --summary-id [纪要ID]

# 输出：
# 任务                    责任人  截止日期   状态
# 完成架构设计文档         张伟    2026-07-25 ✅ 已完成
# 通知合作方改期           李强    2026-07-23 ⏳ 逾期！
# 协调测试资源             王芳    2026-07-28 🔄 进行中

# 一站式检索历史会议+纪要+任务
tmeet-plus search --keyword "Q3版本" --type all

Step 6：录制与存储管理

# 导出转写（多种格式，支持语种切换）
tmeet-plus record transcript --id [会议ID] --format xlsx
tmeet-plus record transcript --id [会议ID] --format md --lang zh/en   # 指定语种
tmeet-plus record transcript --id [会议ID] --format txt --lang auto    # 自动识别

# 查看存储空间
tmeet-plus storage stats

# ⚠️ 先预览，再清理
tmeet-plus storage clean --before "2026-06-01" --dry-run
# 确认后执行
tmeet-plus storage clean --before "2026-06-01" --confirm

常见问题

📦 数据迁移与配置备份

跨环境迁移或重装时，按以下步骤完整迁移配置：

# 1. 导出权限配置（源环境）
tmeet-plus auth role export --format csv > roles_backup.csv

# 2. 导出操作日志（用于审计追溯）
tmeet-plus log export --module command > commands_backup.log

# 3. 在目标环境导入权限配置
tmeet-plus auth role import --file roles_backup.csv

# 4. 验证迁移结果
tmeet-plus auth permission list
tmeet-plus meeting list --stat

> ⚠️ 迁移前确保目标环境已完成 tmeet auth login。迁移后建议执行 quickstart.sh 做完整验证。

④ 效率洞察

⛔ 本模块使用说明（进入此模块请先阅读）

适用的场景：
> 想看看团队开会效率 / 查某个人是不是会太多 / 生成周报 / 搜索历史会议和任务

开始前请确认：

□ 您是管理员或部门负责人？（普通参会人只看自己的数据）
□ 是否已给会议打标签？（未打标签 → 归类到"未分类"）
□ 需要什么时间范围？（周/月）

📌 首次使用须知：

- 首次报表的"环比上周"会显示为「—」（无历史基准数据）
- 等运行 1-2 周后，环比数据会自动生成可对比趋势
- 建议先运行一周积累数据，再做效率分析
- 标签越完整，报表越准确

本模块使用方式：

📊 数据全是自动生成的，你只需要执行查询指令即可
   但数据的解读和后续行动需要人工完成

输出格式：Markdown（默认） / CSV
支持范围：week / month / custom

⚠️ 需要人工决策的环节：
- 看到超时率高 → 人工排查具体是哪些会议超时
- 看到某员工负荷超标 → 管理者判断是否需要减负
- 看到任务逾期 → 人工介入催办（非自动）

能力边界

触发方式

⚠️ 需要人工介入的环节

使用说明书

日常查询

# 本周会议概况
tmeet-plus report meeting --range week --format markdown

# 输出示例：
# 📊 本周会议健康报表 (2026-07-15 ~ 2026-07-21)
# ├─ 会议总数：42 场 (+15% vs 上周)    ← 首次使用显示「—」
# ├─ 平均时长：34 分钟
# ├─ 超时会占比：28% ⚠️
# ├─ 无纪要会议：12 场 (29%) ⚠️
# ├─ 有议程会议占比：71%
# ├─ 任务完成率：62%
# └─ 逾期率：18%

个人负荷分析

# 查询自己的一周负荷
tmeet-plus report user-load --name 张伟 --range week

# 输出：
# 📋 张伟 - 本周会议负荷
# ├─ 会议场次：22 场
# ├─ 总时长：18 小时
# ├─ 日均会议：4.4 场 / 3.6 小时
# ├─ 占用时段：9:00-11:00(40%) 14:00-17:00(50%)
# ⚠️ 建议：周四最密集(7场)，建议分散排期

部门健康度

tmeet-plus report department --dept 产品部 --range month

# 输出包含：
# 📊 产品部 - 月度会议健康度
# ├─ 人均会议场次：16 场 (公司平均 12 场)
# ├─ 人均会议时长：12 小时
# ├─ 任务完成率：78% (排名第 2)
# ├─ 逾期率：8%
# └─ 建议减少部门例会频次，合并沟通

全数据检索

# 按人/时间/关键词一站式查询
tmeet-plus search --keyword "Q3版本" --type all
# 执行效果：
# 会议：Q3版本规划评审 2026-07-20
# 纪要：版本发布方案确认
# 任务：完成架构设计(张伟/进行中)

✨ 一键周报草稿

> 对应"五个方面"→ 场景洞察→周报自动起草。基于本周会议数据组合输出周报模板，不需要 AI。

tmeet-plus report week-summary
# 执行效果：
# 📝 周报草稿（week）
# ━━━ 一、本周会议概况 ━━━
#   📊 本周会议 8 场，平均时长 35 分钟
#   ├─ 超时会占比 12%（较上周下降 5% ✅）
#   └─ 有议程会议占比 87%
#
# ━━━ 二、个人工作要点 ━━━
#   📅 本周会议操作: 11 次
#   🔧 系统运维操作: 3 次
#   📊 报表查询操作: 5 次
#   最近操作：需求评审 / 版本发布复盘 / 技术预审
#
# ━━━ 三、本周成果 ━━━
#   任务完成率 78%，逾期率 8%
#   已完成：架构设计文档、测试方案评审
#   进行中：资源协调、排期确认
#
# ━━━ 四、下周计划（待填写）━━━
#   1. [请填写重点工作项]
#   2. [请填写重点工作项]
#   3. [请填写重点工作项]
#   💡 自动生成的周报草稿，请补充人工内容后发送

✨ 参会人洞察

> 对应"五个方面"→ 会前准备→参会人画像。建会前查一下核心参会人的历史参与情况。

tmeet-plus report attendee-insight --name 张伟
# 执行效果：
# 👤 参会人洞察: 张伟
# ━━━ 会议负荷 ━━━
#   本月参会 18 场，日均 3.6 场
#   占用时段：上午 40% / 下午 50% / 晚上 10%
#
# ━━━ 操作活跃度 ━━━
#   最近 30 天关联操作: 23 条
#   操作分布:
#     meeting（会议管理）        ████████████ 12次
#     record（录制与转写）       ██████ 6次
#     report（数据统计）         █████ 5次
#
# ━━━ 推荐关注 ━━━
#   🔴 活跃用户——参与度高，适合担任会议核心角色
#
# ━━━ 关联议题（基于操作记录） ━━━
#   · 需求评审
#   · 版本发布方案
#   · 架构评审
#   💡 建会前使用本功能查看核心参会人的历史参与情况

常见问题

⑤ 场景洞察

⛔ 本模块使用说明（进入此模块请先阅读）

适用的场景：
> 第一次部署本 Skill / 需要给团队成员分配角色 / 切换环境 / 遇到故障不知道怎么排查

开始前请确认：

□ 您是否是管理员？（角色配置需要管理员权限）
□ 当前处于什么阶段？（首次部署 / 日常使用 / 故障处理）
□ 目标环境是正式还是测试？（默认 prod）

不同角色的操作边界：

👑 管理员 → 全部指令可用（含角色分配、批量操作、日志导出）
👤 操作员 → 创建/管理自己的会议、会中控制、会后管理
👀 查看员 → 只能查询会议、查看纪要、查看任务进度

本模块使用路径：

首次使用 → 阅读部署模式 → 分配角色 → 验证环境 → 开始使用
日常使用 → 查看角色指令 → 按需执行
遇到问题 → 对照故障排查表

⚠️ 必须人工操作的环节： 角色分配、模板配置、环境切换、版本升级验证

能力边界

触发方式

⚠️ 需要人工介入的环节

使用说明书

角色指南

> 使用前先确认自己的角色，不同角色看到的指令范围不同。

👑 超级管理员 / 会议管理员 — 我的工作台

# 1. 角色分配
tmeet-plus auth role set --user 王芳 --role admin
# 执行效果：
# 👑 角色分配成功
#   ├─ 用户: 王芳
#   ├─ 新角色: admin（超级管理员）
#   └─ ⚠️ 用户需要重新登录才能生效

tmeet-plus auth role set --user 李强 --role operator
# 执行效果：
# 👑 角色分配成功
#   ├─ 用户: 李强
#   └─ 新角色: operator（会议操作员）

tmeet-plus auth role set --user 赵六 --role view
# 执行效果：
# 👑 角色分配成功
#   ├─ 用户: 赵六
#   └─ 新角色: view（查看员）

# 查看自己的权限
tmeet-plus auth permission list
# 执行效果：
# 👤 当前用户权限
#   ├─ 角色: admin（超级管理员）
#   ├─ 可用模块: meeting / auth / record / report / system
#   ├─ 高危操作: 批量取消 / 删除录制 / 全员踢出（需 --confirm）
#   └─ 环境: prod（可通过 --env test 切换）

# 2. 导出/导入权限表
tmeet-plus auth role export --format csv   # 导出备份
tmeet-plus auth role import --file 权限表.csv  # 批量导入

# 3. 配置会议模板
#    → 预制 3 套内置模板已可用，需要自定义请联系开发

# 4. 查看全团队会议健康度
tmeet-plus report department --dept 全部 --range week

# 5. 处理异常反馈
tmeet-plus log export --module command
tmeet-plus feedback --content "用户反馈" --auto-log

👤 普通操作员（会议发起人）— 我的常用指令

# 日常：模板建会
tmeet-plus meeting create --template weekly --user @部门全员

# 会前检查
tmeet-plus meeting check-conflict --users @部门全员 --time "14:00-15:00"

# 会中控制
tmeet-plus meeting monitor --id [ID] --duration 30
tmeet-plus meeting mic limit --id [ID] --max-time 5

# 会后管理
tmeet-plus record summary --id [ID] --download
tmeet-plus summary add-task --person 张三 --deadline "2026-07-28"
tmeet-plus task remind --summary-id [ID] --cycle daily

👀 只读查看员（参会人）— 只能看的指令

tmeet-plus meeting list               # 查看会议列表
tmeet-plus record summary --id [ID]    # 查看纪要
tmeet-plus task progress --id [ID]     # 查看任务进度
tmeet-plus search --keyword [关键字]   # 检索

三套部署模式

模式 A：个人轻量模式（一个人 / 小团队）

特点：无需服务器，一键脚本，开箱即用
适用：个人开发者、创业团队、小部门

部署：
1. 安装 tmeet CLI
2. tmeet auth login
3. 直接用本文档的指令
4. 可配合 crontab 做定时任务
   # 每周一早 9 点统计上周会议
   0 9 * * 1 tmeet-plus report meeting --range week

模式 B：团队标准模式（中型团队）

特点：CLI + Agent 调度，支持权限管控
适用：10-100 人团队

部署：
1. 安装 tmeet CLI + 配置 OAuth
2. 管理员分配角色权限
3. 启用会前校验规则（强制议题、冲突检测）
4. 配置定时督办提醒
5. 可选：对接企业微信/钉钉通知

模式 C：企业托管模式（大型组织）

特点：完整权限+环境隔离+数据看板
适用：100 人以上 / 多部门

部署：
1. 完整五层架构落地
2. 正式/测试环境隔离
3. 运行批量任务采用容错模式
4. 全量日志留存
5. 每周自动化会议健康报表

上线三步走

阶段 1：试运行（1-2 周）

✅ 开放的功能：会前模板、资料挂载、基础提醒
❌ 暂不启用：强制校验、自动清理、高危操作
📢 目标：收集使用反馈

阶段 2：全面推广（2-4 周）

✅ 强制启用：重要会议使用模板、必填议题
✅ 启用会中监控、会后纪要
⚠️ 安排专人解答使用问题

阶段 3：流程固化（长期）

✅ Skill 规则融入团队会议制度
✅ 每周自动输出《会议健康报表》
✅ 持续收集反馈迭代

版本规划

故障排查指南

⑥ 异常处理与运行保障

⛔ 本模块使用说明（进入此模块请先阅读）

适用的场景：
> 指令执行报错了 / 网络不稳定导致操作中断 / 需要排查系统是否正常运行 / 想了解系统有哪些自我保护机制

开始前请确认：

□ 是否已确认当前网络环境稳定？（网络波动是异常的第一大来源）
□ 是否已确认 tmeet 服务状态正常？（tmeet auth status）
□ 是否已开启操作日志记录？（默认开启，log export 可查）

本模块的自动/手动分工：

🔄 自动运行（无需操作）：
   - 异常分类与自动匹配处理策略
   - 指令超时自愈（60s 无响应自动重试）
   - 连续失败熔断（5 次失败自动暂停 30s）
   - 操作日志实时记录

👆 需要你操作的：
   - 熔断恢复后手动确认
   - 批量任务失败项手动重试
   - 严重异常的反馈上报

6.1 异常分类体系

全量异常类型与处理策略

6.2 熔断与自愈机制

熔断保护（防止雪崩）

监听到连续失败
     ↓
┌─ 失败次数 < 3 次 ─→ 正常重试
│
└─ 失败次数 ≥ 3 次 ─→ ⛔ 触发熔断
     ↓
进入「熔断开启」状态（持续 30s）
     ↓
熔断期间：
  · 同类操作直接拒绝执行
  · 输出提示："⛔ 检测到连续失败，已自动熔断，请 30s 后重试"
  · 记录熔断事件到操作日志
     ↓
30s 后进入「半开」状态
     ↓
┌─ 单次尝试成功 ─→ 熔断解除，恢复正常
│
└─ 单次尝试失败 ─→ 再次熔断 60s
                    （每次翻倍：30s → 60s → 120s）

指令超时自愈

自愈执行日志

每次自愈动作都会记录到操作日志：

# 查看自愈记录
tmeet-plus log export --module heal

# 输出示例：
# [2026-07-21 17:30:15] 🔄 meeting create 超时重试 → 成功
# [2026-07-21 17:32:40] 🔄 record summary 超时重试 → 成功
# [2026-07-21 17:35:00] ⛔ meeting cancel 连续失败 3 次 → 熔断开启(30s)
# [2026-07-21 17:35:30] ✅ meeting cancel 熔断解除 → 恢复正常

6.3 任务队列与并发控制

任务队列

所有批量/异步操作走任务队列，避免系统过载：

用户提交批量指令
     ↓
任务进入队列 → 分配 task-id
     ↓
┌─ 队列深度 ≤ 10 → 立即执行
│
└─ 队列深度 > 10 → 排队等待，输出预计等待时间
     ↓
执行中 → 实时更新进度
     ↓
执行完成 → 输出执行报告

# 提交批量指令（自动进入队列）
tmeet-plus meeting cancel --batch [ID列表] --ignore-error

# 查看队列状态
tmeet-plus batch status --task-id [任务ID]

# 输出：
# 📋 批量任务 #T-20260721-003
# ├─ 状态：执行中 (8/15)
# ├─ 已用时间：12s
# ├─ 预计剩余：10s
# ├─ 成功：8 | 失败：0
# └─ 排队中的任务：2

并发控制

6.4 健康检查与运行监控

系统健康检查

# 一键健康检查
tmeet-plus system health

# 输出示例：
# 📊 系统健康状态 (2026-07-21 17:40:00)
# ├─ 🔴 网络状态：正常 (延迟 23ms)
# ├─ 🟢 tmeet 服务：在线
# ├─ 🟢 OAuth 会话：有效 (剩余 2h 15min)
# ├─ 🟢 操作队列：空闲
# ├─ 🟡 存储空间：78% (建议清理)
# │   └─ 存储明细：录制 6.2G / 纪要 1.1G / 日志 0.4G
# ├─ 🟢 指令缓存：正常
# ├─ 🟢 异常计数(24h)：12 次 (已自愈 11 次)
# └─ 🟢 熔断状态：未触发

运行监控指令

# 查看近期异常
tmeet-plus system anomalies --range 24h

# 查看自愈统计
tmeet-plus system heal-stats --range 7d

# 输出：
# 📈 本周自愈统计
# ├─ 总自愈次数：47 次
# ├─ 自愈成功率：93.6% (44/47)
# ├─ 未自愈：3 次 (需人工介入)
# └─ 平均自愈耗时：4.2s

# 查看熔断历史
tmeet-plus system circuit-breaker --range 7d

告警规则

6.5 数据安全与容灾

三副本容错

每个批量操作都有三层保护：
L1：执行前 → 自动备份操作清单到本地缓存
L2：执行中 → 逐条记录状态，断点可续
L3：执行后 → 生成执行报告，可追溯回查

# 查看最近 7 天的操作历史
tmeet-plus system history --range 7d

# 从缓存恢复中断的任务
tmeet-plus batch restore --task-id [任务ID]

自我保护规则

6.6 运营保障建议

6.7 版本规划（更新版）

6.8 异常处理速查

附录

A. 指令全景图

tmeet-plus
├── meeting                  # 会议管理
│   ├── create               # 创建会议（支持模板）
│   ├── list                 # 查询会议列表
│   ├── cancel               # 取消会议
│   ├── reschedule           # 调整时间
│   ├── check-conflict       # ⚠️ 日程冲突检测
│   ├── check-time           # ⚠️ 时段合理性
│   ├── check-duplicate      # 查重
│   ├── suggest-time         # 推荐时段
│   ├── monitor              # 时长监控
│   ├── extend               # 延长会议
│   ├── remind               # 提醒设置
│   ├── remind-focus         # 拉回主题
│   ├── mic limit            # 麦位限制
│   ├── call                 # 呼叫发言
│   ├── whisper              # 私密提醒
│   └── waiting              # 等候室管理
│
├── attendee                 # 参会人管理
│   ├── list                 # 查看参会人
│   ├── filter-attendees     # 筛选参会人
│   ├── group                # 会场分组
│   ├── leave                # 请假登记
│   └── status               # 互动状态
│
├── record                   # 录制与转写
│   ├── summary              # 智能纪要
│   ├── trans                # 实时转写
│   ├── transcript           # 导出转写
│   └── control              # 录制开关
│
├── summary                  # 纪要管理
│   ├── split                # 结构化拆分
│   ├── add-task             # 追加任务
│   └── list                 # 纪要列表
│
├── task                     # 任务督办
│   ├── remind               # 设置督办
│   ├── progress             # 进度查询
│   └── set-priority         # 优先级
│
├── auth                     # 权限管理
│   ├── role set             # 设置角色
│   ├── permission list      # 查看权限
│   └── role import/export   # 导入/导出权限表
│
├── report                   # 数据统计
│   ├── meeting              # 会议报表
│   ├── user-load            # 个人负荷
│   ├── task-completion      # 任务完成率
│   └── department           # 部门健康度
│
├── storage                  # 存储管理
│   ├── stats                # 存储统计
│   └── clean                # 清理文件
│
├── search                   # 全数据检索
│
├── batch                    # 批量任务
│   ├── status               # 任务状态
│   └── retry                # 重试失败项
│
├── log export               # 日志导出
│
└── feedback                 # 问题反馈

B. 运行保障清单

运行稳定：
□ 熔断保护          → 连续失败 3 次自动熔断 30s
□ 超时自愈          → 指令超时自动重试
□ 任务队列          → 批量操作排队执行，防过载
□ 并发控制          → 不同操作类型不同上限
□ 健康检查          → system health 一键诊断
□ 频率限制          → 单用户每分钟 ≤ 30 次

异常处理：
□ 异常分类          → 5 大类 16 种异常分级处理
□ 自动重试          → 网络/服务异常默认重试 2 次
□ 断点续跑          → 批量任务中断可恢复
□ 异常日志          → heal 模块专项记录自愈事件
□ 熔断告警          → 严重/致命级别阻断+通知

操作安全：
□ 高危指令二次确认  → --confirm 参数
□ 操作日志全留存    → log export 可追溯
□ 环境隔离          → --env prod/test
□ 批量容错          → --ignore-error
□ 数据合规          → 纪要/录制限制外传
□ 自动清理周期      → storage clean 管理
□ 备份恢复          → auth role export/import + 目录还原

C. 使用前检查清单

首次使用请逐项确认：
□ 1. tmeet CLI 已安装并正常运行
□ 2. 已完成 tmeet auth login 登录
□ 3. 已分配角色（管理员执行 auth role set）
□ 4. 已确认运行环境（默认 prod）
□ 5. 已阅读各模块的 ⚠️ 人工提醒
□ 6. 测试环境验证通过后再正式使用

❓ 常见问题知识库（FAQ）

> 遇到报错了先来这里查。 按"容易犯的错" + "症状" + "决策树"三层入口，不管你是"犯了什么错"还是"遇到了什么报错"都能找到答案。
> 如果这里没有覆盖你的问题，执行 tmeet-plus feedback --content "[你的问题]" --auto-log 一键上报。

⚠️ 容易犯的错（按阶段分类）

> 以下是实际使用中最容易踩的坑——不是报错才叫问题，有些操作做错了不会报错，但结果不对。

会前阶段常犯的错

会中阶段常犯的错

会后阶段常犯的错

系统运维常犯的错

📌 全局速查：常见报错对照表

🔍 实际操作场景排查

如果你不是"看了报错来找答案"，而是在实际使用中遇到了问题，按场景找到你的情况：

场景 1：我建了个会，但好像哪不对

场景 2：会开完了，但纪要不生效

场景 3：我想查数据，但报表不对

场景 4：系统好像出了点问题

场景 5：我做了操作，但不确定做没做对

🧭 自检决策树

不知道是什么问题？按这个决策树一步步排查：

遇到报错
│
├─ 指令找不到
│   ├─ tmeet-plus: command not found  → 重新安装或配置 PATH
│   └─ tmeet: command not found       → 先装 tmeet CLI
│
├─ 指令能找到但执行报错
│   ├─ 提示 Auth / 401 / 403
│   │   ├─ 还没登录        → tmeet auth login
│   │   ├─ 会话过期        → tmeet auth login 重新登录
│   │   └─ 权限不足        → 联系管理员升级角色
│   │
│   ├─ 提示 Timeout
│   ├─ 网络问题            → ping/tmeet auth status 确认连通
│   └─ 确认网络正常        → tmeet 服务波动，稍后重试
│
│   ├─ 提示 Not found / Invalid
│   │   ├─ Meeting not found       → 检查会议 ID
│   │   ├─ Invalid time            → 检查时间格式和合理性
│   │   └─ Environment mismatch    → 检查 --env 参数
│   │
│   ├─ 提示 --confirm required     → 高危操作加 --confirm
│   ├─ 提示 --dry-run required     → 清理操作先 --dry-run
│   │
│   ├─ 没有任何输出
│   │   ├─ 等 10 秒              → 超时自动报错
│   │   └─ 还是没输出            → tmeet-plus system history 查是否已执行
│   │
│   └─ 以上都不符合
│       └─ → tmeet-plus feedback --content "[描述]" --auto-log
│
└─ 指令执行成功但结果不对
    ├─ 会议查不到           → 检查环境 (prod/test)
    ├─ 纪要没有生成         → 检查录制状态
    ├─ 报表数据为空         → 首次使用 / 范围不对
    ├─ 报了错但指令看起来没错 → 检查参数是不是"长得像但不对"
    │   （比如 --tmeet 和 --time，--ID 和 --id）
    └─ 以上都不符合         → 人工复核，如果确实是工具问题则 feedback 上报

⚡ 快速恢复指令

📮 你遇到的报错这里没有？

两种情况：

1. 这条指令从未被执行过 → tmeet-plus system history 确认指令是否正确发送
2. 确实报错了但这里没覆盖 → 执行以下指令自动上报，我会把新问题补进 FAQ：

tmeet-plus feedback --content "[请描述你做了什么 + 看到了什么报错]" --auto-log

上报后系统会自动附带操作日志，帮助你快速定位问题。

> 设计原则： 完全复用 tmeet 现有接口与 CLI 能力，不改造腾讯会议底层，仅做指令封装、规则串联、自动化逻辑，二次开发落地成本极低。