context-handoff

# Context Handoff

把“账号切换 / session 清理”和“项目上下文延续”拆开处理。
不要依赖聊天窗口历史天然保留；需要延续的内容必须落盘到本地文件。

## 使用目标

支持两类本地文件：

1. **会话级上下文**：绑定某个具体聊天窗口/对话用途
2. **项目级摘要**：绑定某个项目本身，与具体聊天窗口解耦

推荐目录：

- 会话级：`/root/.openclaw/workspace/handoffs/sessions/`
- 项目级：`/root/.openclaw/workspace/projects/`

## 何时使用哪一种

### 会话级上下文

当用户表达下面这些意思时，保存到：

- “保存当前对话摘要”
- “把这个会话记下来”
- “切号前保存一下上下文”
- “下次回这个聊天框继续”

会话级文件建议命名：

- `handoffs/sessions/<slot>.md`

如果拿不到系统级 session id，不要假装知道“当前聊天窗口是谁”。
让用户自己给一个 **上下文槽位名**，例如：

- `main-chat`
- `oauth-switch-chat`
- `project-a-thread`

### 项目级摘要

当用户表达下面这些意思时，保存到：

- “保存这个项目的进展”
- “记一下这个项目目前做到哪了”
- “以后恢复这个项目”
- “做个项目摘要”

项目级文件建议命名：

- `projects/<project-name>.md`

项目名由用户指定；如果没有指定，先问。

## 执行动作

### A. 列出会话级上下文槽位

当用户要求列出已有会话级上下文时：

1. 查看目录：
   - `/root/.openclaw/workspace/handoffs/sessions/`
2. 列出其中所有 `.md` 文件
3. 按文件最后修改时间倒序排序（最近更新的放前面）
4. 返回时优先给出：
   - 槽位名
   - 最后更新时间
   - 文件路径
5. 如果目录不存在或为空，明确告诉用户还没有已保存的会话级上下文

实现时优先使用能直接读到文件 mtime 的方式；不要按文件名排序来冒充“最近更新”。

### B. 保存会话级上下文

当用户要求保存会话级上下文时：

1. 如果用户没有给 `slot` 名，先问一个简短问题：
   - “要保存到哪个上下文槽位名？例如 `main-chat` / `oauth-switch-chat`”
2. 生成结构化摘要，不要直接整段复制聊天记录
3. 写入：
   - `/root/.openclaw/workspace/handoffs/sessions/<slot>.md`
4. 如果目录不存在，先创建
5. 覆盖写入为最新版本（默认不做历史堆叠，除非用户明确要求追加）

推荐内容结构：

```md
# 会话级上下文

- 槽位名：
- 保存时间：
- 当前讨论主题：
- 已完成：
- 当前决定：
- 未完成 / 下一步：
- 关键文件：
- 关键命令：
- 备注：
```

### C. 恢复会话级上下文

当用户要求恢复会话级上下文时：

1. 如果没有给 `slot` 名，先问
2. 读取：
   - `/root/.openclaw/workspace/handoffs/sessions/<slot>.md`
3. 用简洁方式把内容总结给用户
4. 不要把整份 markdown 原样全贴，除非用户要求“完整显示”

### D. 列出项目级摘要

当用户要求列出已有项目摘要时：

1. 查看目录：
   - `/root/.openclaw/workspace/projects/`
2. 列出其中 `.md` 文件
3. 排除明显不是项目摘要的全局说明文件（例如通用 README，可按上下文判断）
4. 按文件最后修改时间倒序排序（最近更新的放前面）
5. 返回时优先给出：
   - 项目名
   - 最后更新时间
   - 文件路径
6. 如果没有合适结果，明确告诉用户还没有已保存的项目摘要

实现时优先使用能直接读到文件 mtime 的方式；不要按文件名排序来冒充“最近更新”。

### E. 保存项目级摘要

当用户要求保存项目级摘要时：

1. 如果没有给项目名，先问
2. 生成结构化项目摘要
3. 写入：
   - `/root/.openclaw/workspace/projects/<project-name>.md`
4. 默认覆盖更新为“当前项目最新状态”

推荐内容结构：

```md
# <项目名>

- 更新时间：
- 项目目标：
- 当前进展：
- 已完成：
- 关键决定：
- 风险 / 注意事项：
- 关键文件：
- 关键命令：
- 下一步：
```

### F. 恢复项目级摘要

当用户要求恢复项目级摘要时：

1. 如果没有给项目名，先问
2. 读取：
   - `/root/.openclaw/workspace/projects/<project-name>.md`
3. 优先返回：
   - 当前进展
   - 已完成
   - 下一步
   - 风险 / 注意事项

## 写作要求

- 用中文写摘要
- 以“恢复工作状态”为目标，不要写成长篇会议纪要
- 重点保留决定、文件、命令、下一步
- 不要把敏感 token、密钥、cookie、完整账号凭据写进去

## 回答风格

### 保存成功时

告诉用户：

- 已保存什么类型（会话级 / 项目级）
- 保存到哪个文件
- 后续恢复该用什么关键词

例如：

- “已把当前会话上下文保存到 `handoffs/sessions/main-chat.md`。下次你说‘恢复 main-chat 上下文’就行。”
- “已把项目摘要保存到 `projects/oauth-switch.md`。下次你说‘恢复 oauth-switch 项目摘要’即可。”

### 恢复时

优先给用户一个压缩版恢复结果，例如：

- 当前在做什么
- 已完成什么
- 下一步是什么

必要时再补充文件路径和命令。

## 重要约束

- 不要假设终端脚本知道“当前聊天窗口”是谁
- 如果用户没有提供槽位名或项目名，先问
- 默认覆盖更新，不要无限追加导致文件越来越乱
- 如果文件不存在，明确告诉用户“还没有保存过这份上下文”