PrepMaster v2.0 · 智能备会助手

概述

CLI 端智能备会工具。输入会议主题，输出结构化备会报告：议程 / 准备清单 / 参会人分析 / 历史材料 / 风险提示 / 纪要模板。支持 14 种会议类型模糊匹配、3 种语调切换、20+ 人自动分组。零网络依赖，纯本地 Python 3.8+。

快速开始

python scripts/prepmaster.py "Q3 战略复盘会" --attendees 张三,李四,王五
python scripts/prepmaster.py "项目周会" --material ./notes/
python scripts/prepmaster.py --demo          # 一键演示
python scripts/prepmaster.py --types         # 查看全部 14 种类型

14 种会议类型

完整输入规范与场景示例见 EXTEND.md。

工作流

输入会议主题
    │
    ├─ 模糊匹配 → 识别会议类型
    │   ├─ 高置信度：使用对应模板
    │   └─ 低置信度：降级为「通用会议」+ 提示选择
    │
    ├─ 解析参会人（可选）
    │   ├─ 1 人：个人准备建议
    │   ├─ 2-20 人：协作分析
    │   └─ 20+ 人：自动分组
    │
    ├─ 扫描材料目录（可选）
    │   ├─ 找到：列出文件清单
    │   └─ 未找到：优雅降级
    │
    └─ 生成报告（按指定语调）
        ├─ 议程安排
        ├─ 准备清单
        ├─ 参会人分析
        ├─ 历史材料分析
        ├─ 风险提示
        └─ 纪要模板

错误码体系

常见错误码：

• E1001 未提供会议主题 → 打印使用示例
• E1003 材料目录不存在 → 退出并提示路径
• E2002 参会人超过 20 人 → 自动分组
• E2003 模糊匹配置信度 < 50% → 降级 + 列出类型
• E3001 未提供材料 → 继续生成基于类型的议程

完整错误码表与修复指南见 EXTEND.md。

三种语调

避坑指南（FAQ 集中区）

Q1: 我只输入会议主题能用吗？ A: 能。议程、准备清单、风险提示、纪要模板都会输出。只是不会有参会人分析和历史材料分析。

Q2: 主题不匹配任何类型怎么办？ A: 自动降级为「通用会议」模板，并提示你从 14 种类型中指定一个。如「年终活动筹备」会落到「通用会议」。

Q3: 会议主题用英文可以吗？ A: 可以。中英文 alias 都能匹配，如 pitch 匹配「投资人路演」，brainstorm 匹配「头脑风暴」。

Q4: 参会人超过 20 人怎么分组？ A: 按 8 人/组自动拆分，每组指定一位发言人。报告里会显示分组建议。

Q5: 材料目录里有很多格式，工具支持哪些？ A: .txt / .md / .csv / .json / .log。.docx / .pdf 当前不支持（可考虑后续扩展）。

Q6: 我想定制议程怎么办？ A: 编辑 scripts/prepmaster.py 中的 MEETING_TYPES 字典，修改议程项或时长。详见 EXTEND.md 扩展指南。

Q7: 报告生成后排版乱了怎么办？ A: 在支持等宽字体的终端运行（cmd/PowerShell/Terminal/iTerm）。如需导入文档，可使用 --tone friendly 输出文本最易复制。

Q8: 为什么不支持导出 PDF/Word？ A: 保持纯本地 + 零依赖。报告以纯文本输出，可直接复制到任何文档工具。