# AI Agent 会话记录系统

> **用途**: 完整记录每个 AI Agent 的对话过程，用于分享和教学
> **与场景文档的区别**:
> - `agent-scenes.html` = 精炼的使用场景（结构化、教学导向）
> - `conversation-logs/` = 完整会话记录（原始对话、操作步骤、决策过程）
> **创建时间**: 2026-07-22

---

## 文件结构

```
D:\baidu-pan\conversation-logs\
├── README.md                          ← 本文件
├── dumate\
│   ├── 2026-07-21_网盘整理.md
│   ├── 2026-07-22_战略分析.md
│   └── ...
├── marvis\
│   ├── 2026-07-20_儿童干预研究.md
│   └── ...
├── workbuddy\
│   ├── 2026-07-15_新豪轩审单.md
│   └── ...
└── hermes\
    ├── 2026-07-18_架构方案.md
    └── ...
```

**命名规则**: `YYYY-MM-DD_主题简述.md`

---

## 四个 Agent 的能力差异与记录方式

### DuMate（全能型）

| 能力 | 支持 |
|------|------|
| 读写文件 | ✅ 可以直接读写本地文件 |
| 执行命令 | ✅ 可以执行 bash/powershell |
| 读取会话历史 | ✅ 可以看到完整对话 |
| 记录方式 | **自动记录** — 任务完成后自行生成会话记录文件 |

DuMate 在任务完成后，自己生成会话记录文件到 `conversation-logs/dumate/` 目录。
同时，DuMate 负责将精炼的场景追加到 `agent-scenes.html`。

### Marvis（对话型 / 可能无法写文件）

| 能力 | 支持 |
|------|------|
| 读写文件 | ❓ 视具体环境而定 |
| 执行命令 | ❓ 视具体环境而定 |
| 读取会话历史 | ✅ 可以看到完整对话 |

**记录方式 A — 如果 Marvis 可以写文件**:
Marvis 在对话结束前，自己生成会话记录文件到 `conversation-logs/marvis/` 目录。

**记录方式 B — 如果 Marvis 不能写文件**:
Marvis 在对话结束前，输出完整的会话记录为 Markdown 格式的文本。
用户将 Marvis 输出的文本复制，保存为 `.md` 文件放到 `conversation-logs/marvis/` 目录。
或者：用户把 Marvis 输出的文本发给 DuMate，让 DuMate 保存到文件。

### WorkBuddy（企业型 / 可能无法访问本地文件系统）

| 能力 | 支持 |
|------|------|
| 读写文件 | ❓ 可能在沙箱环境中运行 |
| 执行命令 | ❓ 视具体环境而定 |
| 读取会话历史 | ✅ 可以看到完整对话 |

**记录方式**:
WorkBuddy 在对话结束前，输出完整的会话记录为 Markdown 格式的文本。
用户将文本复制保存，或转发给 DuMate 保存。

### Hermes（架构型 / 可能无法看到完整历史）

| 能力 | 支持 |
|------|------|
| 读写文件 | ❓ 视具体环境而定 |
| 执行命令 | ❓ 视具体环境而定 |
| 读取会话历史 | ❓ 可能只看到部分上下文 |

**记录方式**:
Hermes 在对话结束前，根据它能看到的内容输出会话记录。
如果 Hermes 无法看到完整历史，用户手动补充缺失部分。
或者：用户把对话全文发给 DuMate，让 DuMate 整理后保存。

---

## 会话记录格式（统一 Markdown）

```markdown
# 会话记录 · Agent名称 · YYYY-MM-DD

## 基本信息
- **Agent**: DuMate / Marvis / WorkBuddy / Hermes
- **日期**: YYYY-MM-DD
- **主题**: 一句话描述本次会话的主题
- **场景标签**: 标签1, 标签2, 标签3
- **会话轮次**: N 轮

## 会话摘要
3-5 句话概括本次会话做了什么、达成了什么结果。

## 完整对话记录

### 第 1 轮

**用户**:
> 用户的原始消息

**Agent**:
> Agent 的回复要点（不是全文复制，而是提炼关键操作和决策）

关键操作:
- 操作1
- 操作2

---

### 第 2 轮

**用户**:
> 用户消息

**Agent**:
> Agent 回复要点

关键操作:
- 操作1

---

（以此类推）

## 产出文件
- `文件路径1` — 说明
- `文件路径2` — 说明

## 关键决策记录
1. **决策点1**: 什么决策、为什么、结果
2. **决策点2**: 什么决策、为什么、结果

## 经验教训
- 教训1
- 教训2
```

---

## 给每个 Agent 的提示词

### 1. 给 DuMate 的提示词

```
你的任务完成后，请做两件事：

【第一件：记录完整会话】
将本次会话的完整记录保存到 D:\baidu-pan\conversation-logs\dumate\ 目录下。
文件命名格式：YYYY-MM-DD_主题简述.md（用今天的日期）
记录格式参见 D:\baidu-pan\conversation-logs\README.md

【第二件：追加场景到场景文档】
将本次对话中涉及的 AI Agent 使用场景追加到 D:\baidu-pan\agent-scenes.html。
⚠️ 一个会话可能包含多个独立的场景，需要逐一识别和记录。
追加规则和模板参见 D:\baidu-pan\AGENT_SCENES_APPEND_PROMPT.md
```

### 2. 给 Marvis 的提示词

```
你的任务完成后，请记录本次会话。

如果你可以读写文件：
将本次会话的完整记录保存到 D:\baidu-pan\conversation-logs\marvis\ 目录下。
文件命名格式：YYYY-MM-DD_主题简述.md
记录格式：先读取 D:\baidu-pan\conversation-logs\README.md 参考格式

如果你不能写文件：
请输出完整的会话记录为 Markdown 格式文本，我会保存到文件中。
格式如下：
# 会话记录 · Marvis · YYYY-MM-DD
## 基本信息（Agent、日期、主题、标签、轮次）
## 会话摘要（3-5句话）
## 完整对话记录（按轮次记录用户消息和你的回复要点、关键操作）
## 产出文件
## 关键决策记录
## 经验教训
```

### 3. 给 WorkBuddy 的提示词

```
你的任务完成后，请记录本次会话。

请输出完整的会话记录为 Markdown 格式文本，我会保存到文件中。
格式如下：
# 会话记录 · WorkBuddy · YYYY-MM-DD
## 基本信息（Agent、日期、主题、标签、轮次）
## 会话摘要（3-5句话）
## 完整对话记录（按轮次记录用户消息和你的回复要点、关键操作）
## 产出文件
## 关键决策记录
## 经验教训

如果对话内容涉及敏感信息（客户名称、报价等），请用 [客户A]、[金额X] 等脱敏处理。
```

### 4. 给 Hermes 的提示词

```
你的任务完成后，请记录本次会话。

如果你能看到完整对话历史：
请输出完整的会话记录为 Markdown 格式文本。

如果你只能看到部分对话：
请根据你能看到的内容输出会话记录，并在末尾标注"⚠️ 本记录可能不完整，Hermes 可能无法看到全部对话历史，缺失部分需用户补充"。

格式如下：
# 会话记录 · Hermes · YYYY-MM-DD
## 基本信息（Agent、日期、主题、标签、轮次）
## 会话摘要（3-5句话）
## 完整对话记录（按轮次记录用户消息和你的回复要点、关键操作）
## 产出文件
## 关键决策记录
## 经验教训
```

---

## 用户操作流程

### 情况 1：和 DuMate 对话（最简单）

1. 完成任务后，把"给 DuMate 的提示词"发给 DuMate
2. DuMate 自动完成会话记录 + 场景追加
3. 无需用户额外操作

### 情况 2：和 Marvis / WorkBuddy / Hermes 对话

1. 完成任务后，把对应的提示词发给该 Agent
2. Agent 输出 Markdown 格式的会话记录文本
3. 用户复制文本，保存为 `.md` 文件到 `conversation-logs/对应agent/` 目录
4. （可选）把会话记录文本发给 DuMate，让 DuMate：
   - 保存文件
   - 提炼场景追加到 `agent-scenes.html`

### 情况 3：Agent 无法识别完整会话内容

1. 在对话过程中，用户主动收集关键信息（截图、复制文本）
2. 对话结束后，把收集的信息发给 DuMate
3. 让 DuMate 整理为会话记录 + 场景文档