50 lines
1.6 KiB
Markdown
50 lines
1.6 KiB
Markdown
|
---
|
|||
|
|
title: Todo 会话任务系统
|
|||
|
|
created: 2026-04-14
|
|||
|
|
updated: 2026-04-14
|
|||
|
|
type: entity
|
|||
|
|
tags: [agent, runtime, tool]
|
|||
|
|
sources: [packages/backend/src/modules/netaclaw/runtime/todo_store.ts, packages/backend/src/modules/netaclaw/tools/builtin/todo.ts]
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Todo 会话任务系统
|
|||
|
|
|
|||
|
|
Agent 会话级的任务规划和跟踪机制，Agent 通过 `todo` 工具管理任务列表，前端实时展示进度。
|
|||
|
|
|
|||
|
|
## 数据结构
|
|||
|
|
|
|||
|
|
```typescript
|
|||
|
|
interface TodoItem {
|
|||
|
|
id: string;
|
|||
|
|
content: string;
|
|||
|
|
status: 'pending' | 'in_progress' | 'completed' | 'cancelled';
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## TodoStore（runtime/todo_store.ts）
|
|||
|
|
|
|||
|
|
每个 Agent 会话创建一个 TodoStore 实例。
|
|||
|
|
|
|||
|
|
| 方法 | 功能 |
|
|||
|
|
|------|------|
|
|||
|
|
| `write(todos, merge)` | 写入 todo 列表（merge=false 全量替换，merge=true 增量更新） |
|
|||
|
|
| `read()` | 读取完整列表 |
|
|||
|
|
| `hasItems()` | 检查是否有任务 |
|
|||
|
|
| `getSummary()` | 统计摘要（total/pending/in_progress/completed/cancelled） |
|
|||
|
|
| `formatForInjection()` | 格式化为上下文注入（仅保留 pending + in_progress） |
|
|||
|
|
| `hydrateFromHistory()` | 从历史消息恢复 todo 状态 |
|
|||
|
|
|
|||
|
|
## 集成点
|
|||
|
|
|
|||
|
|
- **Agent 运行时**：自动创建 TodoStore 实例
|
|||
|
|
- **todo 工具**：Agent 通过 tool_use 调用管理任务
|
|||
|
|
- **上下文压缩**：压缩后保留活跃任务（formatForInjection）
|
|||
|
|
- **WebSocket**：推送 `todo_update` 事件到前端
|
|||
|
|
- **前端**：`todo-card.vue` 组件展示任务列表和进度
|
|||
|
|
|
|||
|
|
## 相关页面
|
|||
|
|
|
|||
|
|
- [[tool-system]] — todo 工具定义
|
|||
|
|
- [[agent-runtime]] — 运行时集成
|
|||
|
|
- [[websocket-gateway]] — todo_update 事件推送
|