# personal_memory 个人记忆工具手册

## 模板（概述）

### 一句话定位

- <该工具集用途，一句话描述>

### 工具清单

- <列出核心工具，或指向工具章节>

### 30 秒上手

1. <调用 ...>
2. <观察 ...>
3. <下一步 ...>

### 导航

- principles / tools / scenarios / errors

### 与其他工具集的边界

- <何时用本工具集、何时用相邻工具集>

personal_memory 是 Dominds 的**个人记忆工具集**，用于管理智能体的私有记忆：

- **私有性**：记忆仅对当前智能体可见，不会共享给其他成员
- **持久化**：记忆会持久化到磁盘，在对话重启后仍然保留
- **结构化**：支持按路径组织记忆，便于分类和检索
- **边界**：优先承接成员自己的长期可复用经验与个人工作索引，而不是当前任务状态

关键提示：

- 个人记忆会自动隔离到磁盘路径：`.minds/memory/individual/<member-id>/...`。
- `path` 不应包含你的成员 id（不要写 `<member-id>/...`）。
- 如果你还没有任何个人记忆条目，直接调用 `add_personal_memory` 即可：目录会由系统自动创建。
- 如果你想写的是角色长期职责/方法/正反例，请改去 `persona / knowhow / pitfalls`；如果你想向全队同步当前有效状态、关键决策、下一步或仍成立阻塞，请改去 Taskdoc `progress` 这一准实时任务公告牌；如果只是当前任务/当前对话短期手头工作与接续细节，请改去 reminders。

## 快速导航

| 主题                          | 描述                             |
| ----------------------------- | -------------------------------- |
| [principles](./principles.md) | 核心概念、记忆生命周期、最佳实践 |
| [tools](./tools.md)           | 使用指导、边界说明与示例         |
| [scenarios](./scenarios.md)   | 常见使用场景与示例（复制即用）   |
| [errors](./errors.md)         | 错误代码与解决方案               |

## 状态

- 状态：已实现
- 主要实现文件：
  - 工具实现：`dominds/main/tools/mem.ts`
  - toolset 元信息：`dominds/main/tools/builtins.ts`、`dominds/main/tools/registry.ts`
