# team_memory 团队共享记忆工具手册

## 模板（概述）

### 一句话定位

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

### 工具清单

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

### 30 秒上手

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

### 导航

- principles / tools / scenarios / errors

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

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

team_memory 是 Dominds 的**团队共享记忆工具集**，用于管理团队成员之间共享的记忆：

- **共享性**：记忆对所有团队成员可见
- **持久化**：记忆会持久化到磁盘，在对话重启后仍然保留
- **协作性**：支持团队成员之间的信息共享
- **边界**：优先承接团队共享的长期约定 / 不变量 / 共识原则，而不是某次任务的临时状态

## 快速导航

| 主题                          | 描述                             |
| ----------------------------- | -------------------------------- |
| [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`

## 与 memory 的区别

| 特性     | memory                 | team_memory              |
| -------- | ---------------------- | ------------------------ |
| 可见性   | 仅当前智能体           | 所有团队成员             |
| 使用场景 | 个人长期经验与工作索引 | 团队长期约定、共享不变量 |
