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 种会议类型
| 类型 | 典型场景 | 建议时长 |
|---|---|---|
| 战略复盘 | 季度/年度复盘 | 90-120分 |
| 项目周会 | 团队周例会 | 30-45分 |
| 产品评审 | PRD/设计评审 | 60分 |
| 1v1面谈 | 一对一面谈 | 30分 |
| 头脑风暴 | 创意发散 | 60-90分 |
| 客户提案 | 销售/投标 | 45-60分 |
| 危机应对 | 紧急事故 | 30分 |
| 跨部门协作 | 多团队联动 | 60分 |
| 投资人路演 | 融资 pitch | 45分 |
| 回顾复盘 | Sprint 回顾 | 60分 |
| 新闻发布会 | 媒体活动 | 按实际 |
| 每日站会 | Standup | 15分 |
| 技术研讨会 | 架构/选型 | 60-90分 |
| 通用会议 | 其他 | 45分 |
完整输入规范与场景示例见 EXTEND.md。
工作流
输入会议主题
│
├─ 模糊匹配 → 识别会议类型
│ ├─ 高置信度：使用对应模板
│ └─ 低置信度：降级为「通用会议」+ 提示选择
│
├─ 解析参会人（可选）
│ ├─ 1 人：个人准备建议
│ ├─ 2-20 人：协作分析
│ └─ 20+ 人：自动分组
│
├─ 扫描材料目录（可选）
│ ├─ 找到：列出文件清单
│ └─ 未找到：优雅降级
│
└─ 生成报告（按指定语调）
├─ 议程安排
├─ 准备清单
├─ 参会人分析
├─ 历史材料分析
├─ 风险提示
└─ 纪要模板
错误码体系
| 等级 | 编码范围 | 含义 | 行为 |
|---|---|---|---|
| 阻断 | E1xxx | 输入不合法 | 退出并打印示例 |
| 警告 | E2xxx | 边界情况 | 继续执行 + 提示 |
| 提示 | E3xxx | 信息缺失 | 静默降级 |
常见错误码：
- E1001 未提供会议主题 → 打印使用示例
- E1003 材料目录不存在 → 退出并提示路径
- E2002 参会人超过 20 人 → 自动分组
- E2003 模糊匹配置信度 < 50% → 降级 + 列出类型
- E3001 未提供材料 → 继续生成基于类型的议程
完整错误码表与修复指南见 EXTEND.md。
三种语调
| 语调 | 适用场景 | 风格 |
|---|---|---|
business |
正式会议、跨公司沟通、董事会 | 商务正式 |
friendly（默认） |
内部团队会议、协作沟通 | 业务友好 |
casual |
头脑风暴、轻松讨论、小团队 | 轻松随意 |
避坑指南（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: 保持纯本地 + 零依赖。报告以纯文本输出，可直接复制到任何文档工具。
