tomevault-io LLM Memory 使用指南
智能工作流管理助手，实现跨对话的上下文持久化。
核心概念
三层数据模型
| 层级 | 用途 | 命名格式 | 生命周期 |
|---|---|---|---|
| Plan | 长期项目计划（>3步骤） | plan-<项目> |
数天~数周 |
| Todo | 短期任务（<1天） | todo-<项目>-<任务> |
数小时~1天 |
| Memory | 知识库/决策记录 | mem-<主题> |
永久 |
状态定义
Todo 状态：
0= 待处理1= 进行中2= 已完成3= 已取消
Plan 状态（根据 progress 自动转换）：
0%→ pending（待开始）1-99%→ in_progress（进行中）100%→ completed（已完成）
优先级
4= 🔴 紧急（Bug/阻塞）3= 🟠 高（核心功能）2= 🟡 中（默认）1= 🟢 低（优化/文档）
新对话初始化
每次新对话必须执行以下步骤：
// Step 1: 加载计划列表
const plans = await plan_list({ scope: "all" });
// Step 2: 加载任务列表
const todos = await todo_list({ scope: "all" });
// Step 3: 展示当前状态
// - 进行中的计划
// - 待处理/进行中的任务
// - 相关记忆（如需要）
输出格式示例：
📊 项目状态
📋 计划 (2 进行中):
• [plan-user-auth] 用户认证系统 (45%)
• [plan-api-refactor] API 重构 (20%)
📝 待办 (5 待处理):
🔴 [todo-auth-jwt] JWT 集成 - 进行中
🟠 [todo-auth-test] 集成测试 - 待处理
...
MCP 工具概览
Plan 管理
plan_list- 列出所有计划plan_create- 创建新计划plan_get- 获取计划详情plan_update- 更新计划进度
Todo 管理
todo_list- 列出所有任务todo_batch_create- 批量创建任务todo_batch_start- 批量开始任务todo_batch_complete- 批量完成任务todo_batch_cancel- 批量取消任务todo_batch_update- 批量更新任务todo_final- 清理所有任务
Memory 管理
memory_list- 列出所有记忆memory_search- 搜索记忆memory_create- 创建记忆memory_get- 获取记忆详情memory_update- 更新记忆memory_delete- 删除记忆
Group 管理
group_add_path- 添加路径到组
详见：MCP 工具详解
命名规范
Plan: plan-<项目> → plan-user-auth
Todo: todo-<项目>-<任务> → todo-auth-login, todo-auth-jwt
Memory: mem-<主题> → mem-jwt-decision, mem-api-standard
规则：
- 全小写
- 使用连字符 `-` 分隔
- 最少 3 个字符
- 禁止特殊字符
关联规则
Plan 与 Todo 通过 code 前缀关联：
plan-auth ↔ todo-auth-*（所有以 todo-auth- 开头的任务）
进度计算 = 已完成 Todo 数 / 总 Todo 数 × 100%
作用域
创建时
- 默认：项目级别（当前路径）
- 不要使用
global: true除非确实需要全局可见
查询时
- 使用
scope: "all"获取当前可见的所有数据 scope: "personal"- 仅当前路径scope: "group"- 仅当前小组scope: "global"- 仅全局数据
Agent 协作
任务分配标注
在 todo description 中标注负责的 Agent：
[Task-A] 任务描述 → Task Agent A 负责
[Task-B] 任务描述 → Task Agent B 负责
[Main] 任务描述 → 主 Agent 负责
并发执行原则
- 文件隔离：不同 Agent 处理不同文件，避免冲突
- 状态隔离：通过
todo_batch_start锁定任务 - 进度同步：完成后统一更新 Plan 进度
详见：工作流指南
典型工作流
1. 新项目启动
// 1. 创建计划
await plan_create({
code: "plan-user-auth",
title: "用户认证系统",
description: "实现完整的用户认证功能",
content: "## 目标\n- 登录/注册\n- JWT 认证\n- 权限管理"
});
// 2. 创建任务列表
await todo_batch_create({
items: [
{ code: "todo-auth-login", title: "实现登录功能", priority: 3 },
{ code: "todo-auth-register", title: "实现注册功能", priority: 3 },
{ code: "todo-auth-jwt", title: "JWT 集成", priority: 2 },
{ code: "todo-auth-test", title: "集成测试", priority: 2 }
]
});
2. 执行任务
// 开始任务
await todo_batch_start({ codes: ["todo-auth-login"] });
// ... 执行代码编写 ...
// 完成任务
await todo_batch_complete({ codes: ["todo-auth-login"] });
// 更新计划进度
await plan_update({ code: "plan-user-auth", progress: 25 });
3. 记录知识
// 记录技术决策
await memory_create({
code: "mem-auth-jwt-decision",
title: "JWT vs Session 选型决策",
content: "## 决策\n选择 JWT\n\n## 原因\n- 无状态\n- 分布式友好\n- 前后端分离",
category: "技术决策",
tags: ["auth", "jwt", "session"]
});
4. 查询历史
// 搜索相关记忆
const results = await memory_search({ keyword: "jwt" });
// 获取详情
const detail = await memory_get({ code: "mem-auth-jwt-decision" });
详见：使用示例
最佳实践
- 新对话必初始化：始终先调用
plan_list+todo_list - 及时更新状态：任务开始/完成时立即更新
- 进度同步：批量完成任务后更新 Plan 进度
- 知识沉淀：重要决策和经验及时记录到 Memory
- 命名一致：遵循命名规范，保持关联性
Converted and distributed by TomeVault — claim your Tome and manage your conversions.