智能会议助手 · 会议全链路效率引擎

双模式支持：① 腾讯会议模式（推荐）：安装「腾讯会议」技能后，通过API自动拉取会议数据，实现全链路自动化分析；② 独立模式（standalone）：无需安装任何依赖，直接粘贴或上传会议记录文本即可完成分析。未安装腾讯会议时自动引导使用独立模式。

这能干啥

智能会议助手覆盖会议全生命周期，解决三个核心痛点：

此外还支持面试记录结构化（场景11）和决策看板（场景14）。

交互式使用引导

不知道该用哪个场景？跟着引导走 👇

💬 你想做什么？
│
├─ 🎯 准备会议 ────→ 场景7（会前完整准备包）
│   口语触发：「帮我准备明天的会」「会前要做什么」「全面准备一下」
│
├─ 📊 分析会议 ────→ 场景3（会议效率分析）
│   口语触发：「这场会开得怎么样」「效率高不高」「帮我评一下会议」
│
├─ ✅ 提取待办 ────→ 场景4（待办提取与追踪）
│   口语触发：「这场会定了什么」「有什么要做的」「帮我整理待办」
│
├─ 📝 写报告 ──────→ 场景5 / 场景8 / 场景9
│   ├─ 复盘报告 ──→ 场景5 口语触发：「帮我总结一下」「写个复盘报告」
│   ├─ 周报 ──────→ 场景8 口语触发：「帮我写周报」「这周干了啥」
│   └─ 月报 ──────→ 场景9 口语触发：「帮我写月报」「这个月忙了啥」
│
├─ 🔍 查历史 ──────→ 场景6（跨会议知识串联）
│   口语触发：「上次那个事后来怎样」「之前说的跟进了吗」
│
├─ 🔄 做复盘 ──────→ 场景10（项目复盘材料）
│   口语触发：「帮我做项目总结」「经验教训梳理」
│
─ 📋 排议程 ──────→ 场景1 / 场景12
│   ├─ 详细议程 ──→ 场景1 口语触发：「帮我排个议程」「会议怎么开」
│   └─ 快速议程 ─→ 场景12 口语触发：「简单排个议程」「快速搞个议程」
│
├─ 👥 了解参会人 ──→ 场景2（参会人背景简报）
│   口语触发：「帮我了解下参会人」「谁要来开会」
│
├─ 🎯 智能摘要 ────→ 场景13（智能摘要引擎）
│   口语触发：「一句话概括会议」「帮我提炼精华」「对比两场会议」
│
└─ 📊 决策看板 ────→ 场景14（决策看板）
    口语触发：「看看所有决策」「决策执行了吗」「决策追踪」

快速开始

腾讯会议模式（推荐，全功能）

Step 1 → 安装腾讯会议 Skill，完成配置
Step 2 → 验证连接：对智能会议助手说「帮我查一下最近的会议」
Step 3 → 开始使用：说「帮我准备明天下午的产品评审会」即可
         → 自动触发场景7，生成议程 + 参会人简报 + 遗留议题

独立模式（无需安装，粘贴即用）

# Step 1: 粘贴会议记录，直接分析
python main.py standalone --input "张三：讨论Q3预算n李四：我同意" --mode analyze

# Step 2: 或从文件分析
python main.py standalone --input meeting_notes.txt --mode todos

# Step 3: 生成报告
python main.py standalone --input meeting.md --mode report

支持粘贴文本、.txt、.md、.json 文件输入。自动识别 【张三】/[张三]/张三： 等发言人格式。

💡 独立模式下效率分析、待办提取、报告生成等核心功能完全可用，但跨会议串联、参会人简报、周报/月报等需API数据的功能不可用。

场景触发速查表

14个场景详情

每个场景的详细数据流、流程要点和注意事项见 references/scenes_detail.md 文件

项目结构

smart-meeting-engine/
├── main.py                     # CLI 入口程序（命令解析、路由分发）
├── __init__.py                 # 包初始化（版本信息）
├── requirements.txt            # 依赖声明（纯标准库，无额外依赖）
├── SKILL.md                    # 本文件 · 技能定义文档
├── README.md                   # 项目说明文档
├── FAQ.md                      # 常见问题汇总
├── TROUBLESHOOTING.md          # 故障排查指南
│
├── scripts/                    # 核心脚本目录（每个文件对应一个场景）
│   ├── __init__.py
│   ├── utils.py                # 通用工具（重试/错误处理/安全执行）
│   ├── generate_agenda.py      # 场景1/12：议程生成
│   ├── participant_brief.py    # 场景2：参会人背景简报
│   ├── analyze_efficiency.py   # 场景3：会议效率分析
│   ├── extract_todos.py        # 场景4：待办提取与追踪
│   ├── generate_report.py      # 场景5/8/9/10/11：各类报告生成
│   ├── cross_meeting_link.py   # 场景6：跨会议知识串联
│   ├── standalone_mode.py      # 独立模式（无需腾讯会议）
│   ├── smart_summary.py        # 场景13：智能摘要引擎
│   ├── decision_board.py       # 场景14：决策看板
│   └── benchmarking/           # 效率基准对比
│       ├── __init__.py
│       └── efficiency_benchmark.py
│
├── templates/                  # 输出模板目录（Jinja2 风格）
│   ├── agenda/                 # 议程模板（7种会议类型）
│   │   ├── standup.md          #   站会 15min
│   │   ├── weekly.md           #   周会 60min
│   │   ├── decision.md         #   决策评审 45min
│   │   ├── brainstorm.md       #   头脑风暴 60min
│   │   ├── retro.md            #   复盘回顾 45min
│   │   ├── training.md         #   培训分享 60min
│   │   └── quick_agenda.md     #   一句话快速议程
│   ├── reports/                # 报告模板（7种报告类型）
│   │   ├── efficiency.md / review.md / cross_meeting.md
│   │   ├── weekly_report.md / monthly_report.md
│   │   ├── project_review.md / interview_record.md
│   └── brief/
│       └── participant.md      # 参会人简报模板
│
├── data/                       # 数据文件
│   ├── data_dict.md            # 腾讯会议 API 数据字典
│   ├── meeting_keywords.json   # 会议分析关键词库
│   ├── speaker_patterns.json   # 发言人模式识别
│   └── topic_clusters.json     # 议题聚类关键词库
│
├── assets/                     # 参考资料
│   ├── agenda-templates.md     # 议程模板库（6种会议类型详细模板）
│   └── efficiency-analysis.md  # 效率分析算法文档
│
└── references/                 # 技术参考文档（深入细节）
    ├── scenes_detail.md        # 14个场景的详细数据流和注意事项
    ├── algorithm.md            # 效率分析算法公式与评级标准
    ├── templates_guide.md      # 模板变量、渲染流程与自定义方法
    └── standalone_detail.md    # 独立模式完整使用说明

核心规范

连接检查（自动降级）

1. 调用 convert_timestamp 验证腾讯会议工具可用性
2. 成功 → 进入腾讯会议模式；失败 → 引导到独立模式

时间与会议号处理

• 默认时区 Asia/Shanghai (UTC+8)，相对时间先调用 convert_timestamp 获取当前时间再推算
• 用户提供会议号时先通过 get_meeting_by_code 转换为 meeting_id

输出规范

• 分析结果默认在对话中展示，报告类产物较长时先给概览再询问是否需完整版
• 仅返回参会人昵称，不返回用户ID
• 所有工具返回的 X-Tc-Trace 必须展示给用户

深入阅读

模式选择建议

我该用哪个模式？

🤔 你的情况是？
│
├─ 用腾讯会议开会，想自动拉取数据 ──→ 腾讯会议模式
│   （需要安装腾讯会议插件，全功能）
│
─ 有现成的会议记录/转写文本 ─────→ 独立模式
│   （无需安装任何插件，粘贴即用）
│
└─ 不确定 ─→ 先用独立模式试试，不够再装插件

功能对比表

💡 独立模式能做什么：分析你提供的会议文本，提取待办、分析效率、生成报告

❌ 独立模式不能做什么：自动获取腾讯会议的转写/参会人/历史数据，这些需要腾讯会议插件

快速开始示例

# 独立模式：直接粘贴文本分析
python main.py standalone --input "张三：讨论Q3预算n李四：我同意" --mode analyze

# 独立模式：从文件分析
python main.py standalone --input meeting_notes.txt --mode todos

# 腾讯会议模式：自动拉取最近会议
python main.py analyze --latest

使用限制

错误处理

完整错误代码和排查步骤见 TROUBLESHOOTING.md 文件