mirror of
https://github.com/agentscope-ai/ReMe.git
synced 2026-10-05 02:41:43 +00:00
5b801c0d3e
* refactor(file_io): update file I/O operations and truncation logic * refactor(memory): update file-based memory compaction logic
122 lines
4.4 KiB
Markdown
122 lines
4.4 KiB
Markdown
## Copaw Context Management V2
|
||
|
||
> 注：不涉及长期记忆
|
||
|
||
### 上下文数据结构
|
||
|
||
#### 1. 上下文-内存
|
||
|
||
- **compact_summary**（可选）：
|
||
- **历史对话原始数据引导**：存储于 `dialog/YYYY-MM-DD.jsonl`，共 N 行，按时间顺序排列；回顾时建议从后往前读。
|
||
- **历史对话摘要**：包含 `Goal + Constraints + Progress + KeyDecisions + NextSteps`。
|
||
- **messages**：当前对话上下文（完整消息列表）。
|
||
|
||
#### 2. 上下文-缓存到文件系统
|
||
|
||
- **历史对话原始数据**：`dialog/YYYY-MM-DD.jsonl`
|
||
- **工具调用结果原始数据**：`tool_result/{uuid}.txt`（保留 N 天）
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
A[Context] --> B[compact_summary]
|
||
B --> C[dialog path guide + Goal/Constraints/Progress/KeyDecisions/NextSteps]
|
||
A --> E[messages: full dialogue history]
|
||
A --> F[File System Cache] --> G[dialog/YYYY-MM-DD.jsonl]
|
||
F --> H[tool_result/uuid.txt N-day TTL]
|
||
```
|
||
|
||
---
|
||
|
||
### 上下文机制（Pre-Reasoning Hook）
|
||
|
||
1. **工具结果 Offload** (`ToolCallResultCompact`)
|
||
2. **上下文检查** (`ContextChecker`)
|
||
3. **若 Token 超阈值**：
|
||
- 保留最近 **X%** 的 Token（保障连贯性）
|
||
- 其余历史对话生成摘要 (`Compactor`)
|
||
4. **被摘要的上下文 Offload 到文件系统** (`SaveDialog`)
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
A[Pre-Reasoning Hook] --> B[ToolCallResultCompact]
|
||
B --> C[ContextChecker]
|
||
C --> D{Token > Threshold?}
|
||
D -->|Yes| E[Keep recent X% tokens]
|
||
E --> F[Compact & Summary old context]
|
||
F --> G[SaveDialog: offload to file]
|
||
D -->|No| H[Proceed normally]
|
||
```
|
||
|
||
---
|
||
|
||
### 工具结果 Offload 机制
|
||
|
||
1. 所有工具调用结果先放入上下文，等待 Pre-Reasoning Hook 处理。
|
||
2. 根据是否属于 **recent_n** 范围，决定截断策略：
|
||
- **recent_n 内**：近期内容 → 低截断比例
|
||
- **recent_n 外**：远期内容 → 高截断比例
|
||
|
||
#### 示例：Browser Use 类工具
|
||
|
||
| 阶段 | 行为 |
|
||
|----|------------------------------------------------------------------------------|
|
||
| 1 | 原始工具调用结果 |
|
||
| 2 | 保存原始内容到文件：– 若在 recent_n 内：截断较少– 附注：“FullText saved to xxxx”– 提示：“请从第 N 行开始读” |
|
||
| 3 | 若再次引用且超出 recent_n：– 二次截断（更激进）– 仍指向原文件路径 |
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
A[Tool Call Result] --> B{Within recent_n?}
|
||
B -->|Yes| C[Low truncation<br>Save full text to tool_result/uuid.txt<br>Hint: 'Read from line N']
|
||
B -->|No| D[High truncation<br>Reference existing file<br>More aggressive truncation]
|
||
C --> E[Context includes snippet + file ref]
|
||
D --> E
|
||
```
|
||
|
||
---
|
||
|
||
### ReadFile 工具调用结果变化示例
|
||
|
||
| 阶段 | 行为 |
|
||
|----|---------------------------------------------|
|
||
| 1 | 原始工具调用结果 |
|
||
| 2 | 若在 recent_n 内：– 不截断– 不保存文件（因内容已由用户指定） |
|
||
| 3 | 若超出 recent_n：– 二次截断（更小）– 保存 FullText 到文件并引用 |
|
||
|
||
> 注：ReadFile 本身读取的是外部文件，因此首次调用通常无需重复保存。
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
A[ReadFile Result] --> B{Within recent_n?}
|
||
B -->|Yes| C[No truncation<br>No file save needed]
|
||
B -->|No| D[Apply secondary truncation<br>Save FullText to tool_result/uuid.txt]
|
||
C --> E[Include full content in context]
|
||
D --> F[Include snippet + file ref]
|
||
```
|
||
|
||
---
|
||
|
||
## Copaw Memory
|
||
|
||
### 触发逻辑
|
||
|
||
1. **主 Agent 主动写入**：
|
||
- `Memory.md`（长期记忆主干）
|
||
- `YYYY-MM-DD.md`（当日日志）
|
||
2. **触发阈值时**，由 **Summarizer（React Agent）** 写日志：
|
||
- 个性化信息（如偏好、习惯）
|
||
- Try-error 信息（失败尝试与修正）
|
||
3. **定时任务**（每日 00:00）：
|
||
- 汇总最近的 `YYYY-MM-DD.md` 文件
|
||
- 更新 `Memory.md`
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
A[Main Agent] --> B[Write Memory.md]
|
||
A --> C[Write YYYY-MM-DD.md]
|
||
D[Context Threshold Reached?] -->|Yes| E[Summarizer Agent]
|
||
E --> F[Log: Personalization]
|
||
E --> G[Log: Try-Error Info]
|
||
H[Cron @ 00:00 daily] --> I[Aggregate recent YYYY-MM-DD.md]
|
||
I --> J[Update Memory.md]
|
||
```
|