# Meeting Summary Lab

这是从 Meetily 提取出的纯 Python 长会议总结测试项目。输入是**已经得到的会议文字稿**；不含 ASR、音频、数据库、录音或界面。

它严格复现原项目的核心路线：

```text
完整文字稿
  -> 估算 token 数
  -> 超过阈值则按窗口切块（相邻块重叠 100 tokens）
  -> 每个块提取关键点、决策、行动项、人员
  -> 一次性合并各块摘要
  -> 按 Markdown 模板生成最终会议纪要
```

默认采用与原项目一致的粗略估算：`字符数 * 0.35`。块切分优先在句末（`. `）或空格处断开。

## 安装

项目依赖 PyYAML，用于加载可编辑的 YAML 提示词配置。可直接用源码运行：

```powershell
cd meeting-summary-lab
$env:PYTHONPATH = "src"
python -m meeting_summary_lab chunk --input .\examples\meeting.txt --context-tokens 4096
python -m meeting_summary_lab summarize --input .\examples\meeting.txt --fake --output .\report.md
```

也可以安装为本地命令：

```powershell
python -m pip install -e .
meeting-summary-lab summarize --input .\examples\meeting.txt --fake
```

## 可独立测试的功能单元

| 单元 | 命令 / API | 用途 |
| --- | --- | --- |
| Token 估算 | `rough_token_count(text)` | 验证触发分块的阈值 |
| 切块 | `chunk_text(text, size, overlap)` 或 `chunk` | 验证块尺寸、重叠与边界 |
| 单块摘要 | `SummarizationPipeline.summarize_chunk()` | 验证 map prompt |
| 摘要合并 | `combine_chunk_summaries()` | 验证 reduce prompt |
| 模板报告 | `render_final_report()` | 验证 Markdown 模板化 |
| 全链路 | `summarize` | 验证单次/分块两种路径 |

## 调整提示词

默认中文提示词位于 `prompt/zh/base.yaml`。其中 `system` 管理各阶段系统提示词，`prompts` 管理 map、reduce 和最终报告的用户提示词模板，`templates.final_output` 管理默认 Markdown 结构。修改 YAML 后，下次启动程序即可生效，无需改动 Python 代码。

## 使用真实本地模型（Ollama）

先启动 Ollama 并准备模型，例如：

```powershell
ollama pull qwen3:4b
$env:PYTHONPATH = "src"
python -m meeting_summary_lab summarize `
  --input .\examples\meeting.txt `
  --endpoint http://localhost:11434/v1 `
  --model qwen3:4b `
  --context-tokens 8192 `
  --output .\report.md
```

客户端使用 OpenAI 兼容的 `/chat/completions` 协议，因此也可以指向 vLLM、LM Studio 或企业内部兼容网关。`--api-key` 是可选的；默认从 `OPENAI_API_KEY` 读取。

## 离线全流程测试

加入 `--fake` 可使用确定性测试模型：它不会调用任何网络，而是记录每一步 prompt 并生成可检查的占位结果。这适合验证切块、调用次数和模板结构；不代表真实模型质量。

```powershell
$env:PYTHONPATH = "src"
python -m unittest discover -s tests -v
python -m meeting_summary_lab summarize --input .\examples\meeting.txt --fake --context-tokens 500
```

## 与 Meetily 原实现一致的限制

这是**单层 Map-Reduce**：块摘要会在一次请求中统一合并，随后再执行一次模板化请求。极端长会议可能使“摘要合并”或“最终模板化”仍超出上下文；该项目刻意保留这一行为，方便复现和测试。若你要消除该限制，可在 `combine_chunk_summaries()` 外再套递归分组归并。