# 会议录音文字处理 - 输入输出模板

## 输入模板

### 快速模式（推荐）

```
【学术会议录音整理】

**说话人映射**：
- 说话人1 = [姓名]（[身份]）
- 说话人2 = [姓名]（[身份]）
- 说话人3 = [姓名]（[身份]）

【录音内容】
[粘贴录音转文字内容]
```

### 详细模式

```
【学术会议录音整理 - 详细模式】

**会议信息**：
- 会议主题：[主题]
- 会议时间：[日期时间]
- 会议时长：[时长]

**说话人映射**：
- 说话人1 = [姓名]（[身份]，[研究方向/职责]）
- 说话人2 = [姓名]（[身份]，[研究方向/职责]）
- 说话人3 = [姓名]（[身份]，[研究方向/职责]）
- 说话人4 = [未知，请推断]

**会议背景**：
[会议的主要议题、讨论重点]

**录音内容**：
[粘贴完整录音转文字内容]

**特殊要求**：
- 文风：[简洁/详细/学术性]
- 重点：[需要重点关注的内容]
- 格式：[特殊格式要求]
```

### 混合模式（部分映射 + 部分推断）

```
【学术会议录音整理】

**说话人映射**：
- 说话人1 = [姓名]（[身份]）
- 说话人2 = [未知，请推断]
- 说话人3 = [未知，请推断]

【录音内容】
[粘贴录音转文字内容]
```

---

## 同音词自动替换

### 预设参与人员列表

本技能预设了常见的课题组参与人员，AI会自动识别并匹配：

| 常用称呼 | 真实姓名 | 身份 | 备注 |
|---------|---------|------|------|
| 徐老师 | 徐明 | 资深教授/导师 | 课题组负责人 |
| Ming | 徐明 | 资深教授/导师 | 英文名/别名，统一替换 |
| 黄老师 | 黄河 | 课题组长 | 脂质组学方向 |
| 一鸣 | 赵逸民 | 统计学专家 | 负责流病统计学 |
| 逸民 | 赵逸民 | 统计学专家 | 同音词，自动替换 |
| Angus | Chenyu | 团队成员 | 英文名，统一替换为规范名 |
| 小狍 | Kuangyi | 团队成员 | 昵称，统一替换为规范名 |
| 陈宇 | 范晨宇 | 数据管理员 | 语音识别错误，自动替换 |
| 晨宇 | 范晨宇 | 数据管理员 | 同音词，自动替换 |

### 同音词替换列表

| 错误识别 | 正确姓名 | 替换原因 |
|---------|---------|---------|
| Ming | 徐明 | 英文名/别名，统一替换为规范姓名 |
| Angus | Chenyu | 英文名，统一替换为规范姓名 |
| 小狍 | Kuangyi | 昵称，统一替换为规范姓名 |
| 陈宇 | 范晨宇 | 语音识别错误，"陈宇"应为"范晨宇" |
| 晨宇 | 范晨宇 | 同音词，自动替换 |
| 一鸣 | 赵逸民 | 语音识别错误，"一鸣"应为"赵逸民" |
| 逸民 | 赵逸民 | 同音词，自动替换 |
| 徐老师 | 徐明 | 称呼替换为真实姓名 |
| 黄老师 | 黄河 | 称呼替换为真实姓名 |

### 规范姓名优先规则

- 先把同一人的英文名、昵称、老师称呼统一到一个规范名字，再进行说话人映射和观点汇总。
- 当前团队默认规范如下：
  - `Ming`、`徐老师` → `徐明`
  - `Angus` → `Chenyu`
  - `小狍` → `Kuangyi`
- 若用户在当前任务中明确指定了新映射，优先使用用户映射覆盖这里的预设。

### 替换示例

**输入**：
```
说话人5：我们膳食的话主要是祭献的时候收集了各个校区它的一个菜谱...
说话人6：我手头可能有几篇文章，关于这种干预临床试验中干预响应跟不响应的分层...
```

**自动处理**：
- 检测到"说话人5"可能是"陈宇"（根据发言内容）
- 自动替换为"范晨宇"
- 检测到"说话人6"可能是"一鸣"（根据发言内容）
- 自动替换为"赵逸民"

**输出**：
```markdown
## 👥 说话人映射

| 原始标注 | 真实姓名 | 身份 | 备注 |
|---------|---------|---------|------|
| 说话人5 | 范晨宇 | 数据管理员 | 同音词替换：陈宇→范晨宇 |
| 说话人6 | 赵逸民 | 统计学专家 | 同音词替换：一鸣→赵逸民 |
```

---

## 输出模板（Markdown + HTML 双产物）

### 文件产物约定

- `学术会议纪要_YYYY-MM-DD.md`：结构化主稿，作为唯一源文件
- `学术会议纪要_YYYY-MM-DD.html`：使用 `ai-results-html` 渲染的本地展示页
- 推荐流程：**先整理 Markdown，再立即顺手渲染 HTML**

### 默认一步到位工作流

#### 默认规则

- 只要用户没有明确说“只要 Markdown / 不要 HTML”，就默认交付双产物
- Markdown 写完后应**立即**渲染 HTML，不额外等待下一轮指令
- `.md` 与 `.html` 默认放在同一目录，使用相同主文件名
- Markdown 是唯一源稿；HTML 始终由 Markdown 渲染生成

#### 执行顺序

1. 选择输出目录与 basename  
   例如：`/absolute/path/学术会议纪要_2026-03-11`
2. 写入 Markdown 主稿  
   文件为 `/absolute/path/学术会议纪要_2026-03-11.md`
3. 立即运行渲染命令  
   输出 `/absolute/path/学术会议纪要_2026-03-11.html`
4. 检查 HTML 关键结构  
   `.nav`、`.hero`、`.sidebar-toc`、`.mobile-toc`、`.footer`
5. 一次性回复两个文件绝对路径  
   并说明 Markdown 是源稿、HTML 是展示页

### 优先使用包装脚本（推荐）

最省事的方式是直接运行：

```bash
python3 $HOME/.claude/skills/meeting-transcript/scripts/render_meeting_transcript_bundle.py \
  "/absolute/path/学术会议纪要_YYYY-MM-DD.md"
```

默认行为：

- 自动在同目录生成同名 `.html`
- 自动从 Markdown 提取 `会议主题`、`会议时间`、`会议时长`
- 自动生成标题、副标题、导航链接和常用 meta pills
- 自动执行基础 HTML 校验

常用参数：

```bash
python3 $HOME/.claude/skills/meeting-transcript/scripts/render_meeting_transcript_bundle.py \
  "/absolute/path/学术会议纪要_YYYY-MM-DD.md" \
  --output-html "/absolute/path/custom-name.html" \
  --title "学术会议纪要｜HFpEF课题推进会" \
  --subtitle "2026-03-11 19:00 · 90分钟 · 基于录音转文字整理"
```

只有在需要彻底自定义底层参数时，再退回直接调用 `render_review_html.py`。

### 完整输出模板

```markdown
# 学术会议纪要

## 📋 会议基本信息
- **会议主题**：[自动提取]
- **会议时间**：[如有]
- **会议时长**：[如有]
- **参会人员**：[列表，使用真实姓名]

---

## 👥 说话人映射

| 原始标注 | 真实姓名 | 身份 | 备注 |
|---------|---------|---------|------|
| 说话人1 | 张淑贤 | 研究生 | - |
| 说话人2 | 黄河 | 课题组长 | 称呼替换：黄老师→黄河 |
| 说话人3 | 徐明 | 资深教授 | 称呼替换：徐老师→徐明 |
| 说话人4 | [未识别] | - | 发言较少，无法确定 |
| 说话人5 | 范晨宇 | 数据管理员 | 同音词替换：陈宇→范晨宇 |
| 说话人6 | 赵逸民 | 统计学专家 | 同音词替换：一鸣→赵逸民 |

---

## 🎤 说话人观点汇总

### 张淑贤（研究生）

#### 💡 核心观点
1. **关于研究设计**：
   - 原文："12周干预时间可能不够，建议延长到16周"
   - 要点：干预时间需要延长

2. **关于数据分析**：
   - 原文："脂质组学数据要先做批次效应校正"
   - 要点：需要进行批次效应校正

#### ✅ 提出的建议
- 延长干预时间至16周
- 脂质组学数据做批次效应校正
- 增加中期评估节点

#### ❓ 提出的问题
- 如何处理失访率较高的问题？
- 预测模型的验证集如何划分？

#### 📌 下一步行动
- [ ] 查阅溶血磷脂和鞘脂与炎症相关文献 - 截止：本周 - 优先级：高
- [ ] 与范晨宇讨论预测模型优化方法 - 截止：本周 - 优先级：高

---

### 黄河（课题组长）

#### 💡 核心观点
1. **关于脂质类别解释**：
   - 原文："脂质一般来说特别是像磷脂或者说是甘油三酯..."
   - 要点：脂质分子由头基和尾链组成

2. **关于验证方法**：
   - 原文："我们现在的话可能是需要思考的一个点，就在于因为我们其实是没有做RNA的..."
   - 要点：缺乏基因和组织数据，只能从侧面验证

#### ✅ 提出的建议
- 将溶血磷脂和鞘脂与炎症相关性纳入分析
- 联系瑞金的季秋老师，看能否提供数据库验证支持

#### 📌 下一步行动
- [ ] 联系瑞金医院季秋老师寻求数据库支持 - 截止：本周 - 优先级：高
- [ ] 协调周立英文章的合作问题 - 截止：本周 - 优先级：高

---

### 徐明（资深教授）

#### 💡 核心观点
1. **关于运动响应的临床意义**：
   - 原文："我是想问，比如说在肝脏不反应的不是在肝脏，就是说在运动就是这种反应比较差的组里头..."
   - 要点：关注运动无响应组的临床指导意义

2. **关于预测指标**：
   - 原文："对因为这里头咱们看看创新点其实预测很重要..."
   - 要点：需要找到基线预测指标

#### 📌 下一步行动
- [ ] 协调黄河、赵逸民的文章分工 - 优先级：高 - 🔄 进行中
- [ ] 确保文章在结题答辩前发表 - 优先级：高

---

### 赵逸民（统计学专家）

#### 💡 核心观点
1. **关于响应分组方法**：
   - 原文："我手头可能有几篇文章，关于这种干预临床试验中干预响应跟不响应的分层"
   - 要点：提供文献参考，建议使用瀑布图和直方图展示

2. **关于预测模型**：
   - 原文："你最好再换几个方法，因为常见的比如说像随机森林、XGBoost、LASSO，你也试一下"
   - 要点：尝试多种机器学习方法，选择最优

#### 📌 下一步行动
- [ ] 整理响应分组文献发给张淑贤 - 截止：本周 - 优先级：高
- [ ] 完成基金本子后立即投入文章工作 - 截止：基金本子完成后 - 优先级：高

---

### 范晨宇（数据管理员）

#### 💡 核心观点
1. **关于数据管理**：
   - 原文："我们膳食的话主要是祭献的时候收集了各个校区它的一个菜谱..."
   - 要点：基线有膳食数据，后续无

2. **关于超声数据**：
   - 原文："我问了全友，因为全友是负责咱们肝脏超声和心脏超声的整理..."
   - 要点：PWV数据少，但有FMD数据

#### 📌 下一步行动
- [ ] 共享胸壁皮褶厚度数据 - 截止：立即 - 优先级：高
- [ ] 整理FMD数据 - 截止：本周 - 优先级：中
- [ ] 协助张淑贤优化预测模型 - 优先级：高 - 🔄 进行中

---

## ⚖️ 争议与共识

### 议题：干预时间长度

**观点对比**：

| 说话人 | 观点 | 理由 |
|--------|------|------|
| 张淑贤 | 使用ΔBMI百分位数变化>0或<0分组 | 参考CDC官网建议 |
| 赵逸民 | 建议参考高分文献的分组方法 | 港大徐安明老师用ΔHOMA-IR>2倍SE分组 |

**最终决策**：
- ✅ 保留当前分组方法
- ✅ 补充瀑布图展示个体差异
- ✅ 补充直方图检验异质性
- ✅ 参考赵逸民提供的文献

---

## 📌 行动计划总表

### 按责任人分类

#### 张淑贤（研究生）
- [ ] 查阅溶血磷脂和鞘脂与炎症相关文献 - 截止：本周 - 优先级：高
- [ ] 与范晨宇讨论预测模型优化方法 - 截止：本周 - 优先级：高
- [ ] 画瀑布图展示个体差异 - 截止：本周 - 优先级：高
- [ ] 画直方图检验响应异质性 - 截止：本周 - 优先级：高
- [ ] 尝试多种预测模型（随机森林、XGBoost等） - 截止：下周 - 优先级：高

#### 黄河（课题组长）
- [ ] 联系瑞金医院季秋老师寻求数据库支持 - 截止：本周 - 优先级：高
- [ ] 协调周立英文章的合作问题 - 截止：本周 - 优先级：高
- [ ] 指导张淑贤优化预测模型 - 优先级：高 - 🔄 进行中

#### 徐明（资深教授）
- [ ] 协调黄河、赵逸民的文章分工 - 优先级：高 - 🔄 进行中
- [ ] 确保文章在结题答辩前发表 - 优先级：高

#### 赵逸民（统计学专家）
- [ ] 整理响应分组文献发给张淑贤 - 截止：本周 - 优先级：高
- [ ] 完成基金本子 - 截止：本周 - 优先级：高 - 🔄 进行中
- [ ] 投入文章工作 - 截止：基金本子完成后 - 优先级：高

#### 范晨宇（数据管理员）
- [ ] 共享胸壁皮褶厚度数据 - 截止：立即 - 优先级：高
- [ ] 整理FMD数据 - 截止：本周 - 优先级：中
- [ ] 协助张淑贤优化预测模型 - 优先级：高 - 🔄 进行中

---

### 按主题分类

#### 数据整理
- [ ] 胸壁皮褶厚度数据 - 负责人：范晨宇 → 张淑贤 - 截止：立即
- [ ] PWV数据（血管硬化指标） - 负责人：张淑贤 - 截止：本周
- [ ] CSI数据（肝脏弹性指数） - 负责人：张淑贤 - 截止：本周
- [ ] FMD数据（血管内皮功能） - 负责人：范晨宇 - 截止：本周

#### 预测模型
- [ ] 尝试多种机器学习方法，提升AUC到75%+ - 负责人：张淑贤、范晨宇 - 截止：下周

#### 可视化
- [ ] 瀑布图（waterfall plot） - 负责人：张淑贤 - 截止：本周
- [ ] 直方图检验响应异质性 - 负责人：张淑贤 - 截止：本周

#### 文献调研
- [ ] 溶血磷脂/鞘脂与炎症相关性 - 负责人：张淑贤 - 截止：本周
- [ ] 响应分组方法文献 - 负责人：赵逸民 - 截止：本周

#### 外部验证
- [ ] 联系瑞金医院季秋老师 - 负责人：黄河 - 截止：本周

#### 膳食因素
- [ ] 检查基线膳食PUFA摄入差异 - 负责人：张淑贤 - 截止：本周

#### 文章协调
- [ ] 周立英文章合作问题 - 负责人：黄河 - 截止：本周
- [ ] 不同文章结论一致性 - 负责人：黄河、赵逸民 - 🔄 持续

---

## 💡 关键决策
- [决策1] 先进行12周干预，效果不显著再延长 - 达成方式：共识
- [决策2] 优先使用LC-MS，预算不足则用GC-MS备选 - 达成方式：共识

---

## ❓ 待解决问题
1. **如何处理失访率较高的问题？** - 提出人：张淑贤 - 后续安排：下次会议讨论
2. **预测模型的验证集如何划分？** - 提出人：张淑贤 - 后续安排：赵逸民提供方案

---

## 📨 可直接发送汇报（可选）
**可直接发送：**

> 老师您好，今天会议已整理完成。核心决策包括：1）[决策一]；2）[决策二]。当前待推进事项主要有：[事项一]、[事项二]。如您方便，请帮忙确认 [待确认问题]。

---

## 📎 附录
- 相关文档链接
- 参考资料
- 数据表格（如有）

---

**纪要整理人**：范晨宇
**整理时间**：[当前日期]
**版本**：v1.0
```

### HTML 渲染命令模板

将上面的 Markdown 主稿落盘后，再执行：

```bash
python3 $HOME/.claude/skills/ai-results-html/scripts/render_review_html.py \
  "/absolute/path/学术会议纪要_YYYY-MM-DD.md" \
  "/absolute/path/学术会议纪要_YYYY-MM-DD.html" \
  --title "学术会议纪要｜[会议主题]" \
  --subtitle "[会议时间/场景] · 基于录音转文字整理" \
  --badge "会议纪要" \
  --meta-pill "说话人映射" \
  --meta-pill "行动计划" \
  --meta-pill "Markdown + HTML" \
  --nav-link "打开 Markdown|/absolute/path/学术会议纪要_YYYY-MM-DD.md" \
  --toolbar-link "源文件 Markdown|/absolute/path/学术会议纪要_YYYY-MM-DD.md" \
  --footer-link "会议目录|/absolute/path"
```

### 更省事的整套命令模板

如果已经确定输出目录和文件名，可以直接按下面的变量模板一口气完成：

```bash
OUT_DIR="/absolute/path"
BASENAME="学术会议纪要_YYYY-MM-DD"
MD="$OUT_DIR/$BASENAME.md"
HTML="$OUT_DIR/$BASENAME.html"

# 先写好 $MD，再立即渲染 $HTML
python3 $HOME/.claude/skills/ai-results-html/scripts/render_review_html.py \
  "$MD" \
  "$HTML" \
  --title "学术会议纪要｜[会议主题]" \
  --subtitle "[会议时间/场景] · 基于录音转文字整理" \
  --badge "会议纪要" \
  --meta-pill "说话人映射" \
  --meta-pill "行动计划" \
  --meta-pill "Markdown + HTML" \
  --nav-link "打开 Markdown|$MD" \
  --toolbar-link "源文件 Markdown|$MD" \
  --footer-link "会议目录|$OUT_DIR"
```

### 包装脚本 vs 底层渲染器

| 场景 | 推荐方式 |
|------|---------|
| 标准会议纪要双产物输出 | `render_meeting_transcript_bundle.py` |
| 需要自动推断标题/副标题/输出路径 | `render_meeting_transcript_bundle.py` |
| 想少写参数、直接一步到位 | `render_meeting_transcript_bundle.py` |
| 需要高度自定义 nav / toolbar / footer / template | `render_review_html.py` |

如果 Markdown 中有以下段落标签，HTML 页面可自动带复制按钮：

- `可直接发送`
- `汇报模板`
- `推荐回复`
- `发言模板`

### HTML 渲染失败时的回退

如果出现 `pandoc not found`、模板缺失、渲染器报错等情况，按下面的顺序处理：

1. **保留 Markdown 主稿**，不要回滚或覆盖
2. 明确告知：`HTML 渲染失败`
3. 在回复中写清：
   - 已成功生成的 Markdown 路径
   - HTML 未生成的原因
   - 建议下一步（如补装 `pandoc` 后重跑渲染命令）

推荐回复示例：

```text
会议纪要 Markdown 已生成：
- /absolute/path/学术会议纪要_YYYY-MM-DD.md

但 HTML 渲染失败，原因：pandoc not found in PATH。
建议先安装 pandoc，再重新运行 render_review_html.py 生成 HTML 展示页。
```

---

## Checkbox使用说明

### 基本语法

- **未完成**：`- [ ] 任务描述`
- **已完成**：`- [x] 任务描述`
- **带详细信息**：`- [ ] 任务描述 - 截止：[时间] - 优先级：[高/中/低]`

### 示例

```markdown
## 待办事项

- [ ] 完成数据分析报告
- [x] 整理会议纪要
- [ ] 联系合作单位 - 截止：本周五 - 优先级：高
- [x] 提交伦理审查 - 截止：上周三 - 优先级：高 - ✅ 已完成
```

### Markdown 预览与 HTML 导出

在支持checkbox的Markdown编辑器中，这些checkbox可以点击交互：
- [ ] 这是一个未完成的任务
- [x] 这是一个已完成的任务

配套生成的 HTML 页面建议具备：

- 顶部导航（`.nav`）
- Hero 区（`.hero`）
- 侧边目录（`.sidebar-toc`）
- 移动端目录（`.mobile-toc`）
- 页脚文件链接（`.footer`）
- 可选复制按钮（`.copy-example-btn`）

### 推荐编辑器

- **Typora** - 所见即所得，checkbox可点击
- **Obsidian** - 支持checkbox交互、标签
- **VS Code** + Markdown Preview Enhanced插件
- **Notion** - 支持checkbox和数据库功能
- **GitHub/GitLab** - Markdown渲染支持checkbox

---

## 输出文件格式要求

### 必须满足

1. **Markdown 文件扩展名**：`.md`
2. **HTML 文件扩展名**：`.html`
3. **编码格式**：UTF-8
4. **换行符**：LF（Unix风格）
5. **Checkbox语法**：使用 `- [ ]` 和 `- [x]`
6. **表格语法**：使用标准Markdown表格
7. **标题层级**：# ## ### ####
8. **真实姓名**：全文统一使用真实姓名，不使用称呼或错误识别
9. **HTML 来源**：必须由 `render_review_html.py` 从 Markdown 渲染，不直接手写

### 最终交付回复模板

```text
已完成会议纪要双产物输出：
- Markdown：/absolute/path/学术会议纪要_YYYY-MM-DD.md
- HTML：/absolute/path/学术会议纪要_YYYY-MM-DD.html

说明：Markdown 为后续修改和再渲染的源稿；HTML 已按 ai-results-html 风格生成，适合直接打开或转发。
```

### 姓名使用规范

- ✅ 使用规范姓名：徐明、黄河、赵逸民、范晨宇、Chenyu、Kuangyi
- ❌ 避免使用称呼：徐老师、黄老师、一鸣老师
- ❌ 避免使用英文名/昵称混写：Ming、Angus、小狍（除非用户明确要求保留原始叫法）
- ❌ 避免使用错误识别：陈宇、晨宇、一鸣

---

## 质量检查清单

在输出前，请确保：

- [ ] 所有说话人已正确映射
- [ ] 同音词/别名已自动替换（陈宇→范晨宇，一鸣→赵逸民，Ming→徐明，Angus→Chenyu，小狍→Kuangyi）
- [ ] 称呼已替换为规范姓名（徐老师→徐明，黄老师→黄河）
- [ ] 每人至少有3个核心观点
- [ ] 待办事项使用checkbox格式
- [ ] 表格格式正确
- [ ] 标题层级清晰
- [ ] 争议与共识已识别
- [ ] Markdown 文件为标准 Markdown，HTML 已由 ai-results-html 渲染
- [ ] Markdown 完成后已立即顺手渲染 HTML
- [ ] `.md` 与 `.html` 位于同一目录且主文件名一致
- [ ] HTML 页面包含 `.nav`、`.hero`、`.sidebar-toc`、`.mobile-toc`、`.footer`
- [ ] 全文使用真实姓名，不混用称呼和错误识别
- [ ] Emoji图标增强可读性（可选）
