dominds 1.3.1 → 1.4.2

package/dist/tools/prompts/memory/zh/errors.md

@@ -1,155 +0,0 @@
-# memory 错误处理
-
-## 模板（错误）
-
-### 错误行动链（必填）
-
-1. 触发条件
-2. 检测信号
-3. 恢复步骤
-4. 成功判据
-5. 升级路径（可选）
-
-## 错误代码
-
-### MEMORY_ALREADY_EXISTS
-
-**描述：** 路径已存在，无法使用 `add_memory` 创建新记忆。
-
-**原因：**
-
-- 尝试添加的路径已经被其他记忆占用
-
-**解决方案：**
-
-- 使用 `replace_memory` 更新已有记忆
-- 或者使用不同的路径创建新记忆
-
-**示例：**
-
-```
-错误：
-status: error
-error_code: MEMORY_ALREADY_EXISTS
-message: 路径 "project/todo" 已存在，请使用 replace_memory 更新
-```
-
-### MEMORY_NOT_FOUND
-
-**描述：** 路径不存在，无法执行操作。
-
-**原因：**
-
-- 尝试访问的记忆路径不存在
-- 路径被删除或从未创建
-
-**解决方案：**
-
-- 如果是更新/删除操作，先使用 `add_memory` 创建
-- 检查路径是否正确
-
-**示例：**
-
-```
-错误：
-status: error
-error_code: MEMORY_NOT_FOUND
-message: 路径 "project/todo" 不存在，请先使用 add_memory 创建
-```
-
-### MEMORY_PATH_INVALID
-
-**描述：** 路径格式无效。
-
-**原因：**
-
-- 路径包含非法字符
-- 路径长度超过限制
-
-**解决方案：**
-
-- 确保路径只包含字母、数字、下划线、斜杠
-- 路径长度不超过 255 个字符
-
-**示例：**
-
-```
-错误：
-status: error
-error_code: MEMORY_PATH_INVALID
-message: 路径 "project/*invalid*" 包含非法字符
-```
-
-### MEMORY_CONTENT_TOO_LARGE
-
-**描述：** 记忆内容过大。
-
-**原因：**
-
-- 单条记忆内容超过 1MB 限制
-
-**解决方案：**
-
-- 压缩内容
-- 拆分为多条记忆
-- 使用外部存储（如文件）
-
-**示例：**
-
-```
-错误：
-status: error
-error_code: MEMORY_CONTENT_TOO_LARGE
-message: 内容大小 1.2MB 超过 1MB 限制
-```
-
-### MEMORY_STORAGE_ERROR
-
-**描述：** 存储错误。
-
-**原因：**
-
-- 磁盘空间不足
-- 权限问题
-- 文件系统错误
-
-**解决方案：**
-
-- 检查磁盘空间
-- 检查文件权限
-- 重试操作
-
-**示例：**
-
-```
-错误：
-status: error
-error_code: MEMORY_STORAGE_ERROR
-message: 无法写入存储，磁盘空间不足
-```
-
-## 常见问题
-
-### Q: 记忆会自动保存吗？
-
-A: 是的，所有记忆操作都会立即持久化到磁盘。不需要手动保存。
-
-### Q: 记忆有数量限制吗？
-
-A: 没有严格的数量限制，但建议保持记忆数量在合理范围内（建议少于 100 条）。
-
-### Q: 记忆可以被其他成员看到吗？
-
-A: 不可以，memory 是个人记忆工具，只有当前智能体可以访问。如果需要共享给团队成员，请使用 team_memory。
-
-### Q: clear_memory 会删除所有记忆吗？
-
-A: 是的，`clear_memory` 会删除所有个人记忆，此操作不可恢复。请谨慎使用。
-
-### Q: 记忆会过期吗？
-
-A: 不会，记忆会永久保存，直到被显式删除。
-
-### Q: 如何查看当前所有记忆？
-
-A: 智能体在生成回复时可以访问所有个人记忆。你可以直接询问智能体当前有哪些记忆。

package/dist/tools/prompts/memory/zh/index.md

@@ -1,47 +0,0 @@
-# memory 个人记忆工具手册
-
-## 模板（概述）
-
-### 一句话定位
-
-- <该工具集用途，一句话描述>
-
-### 工具清单
-
-- <列出核心工具，或指向 Tools/Schema 章节>
-
-### 30 秒上手
-
-1. <调用 ...>
-2. <观察 ...>
-3. <下一步 ...>
-
-### 导航
-
-- principles / tools / scenarios / errors
-
-### 与其他工具集的边界
-
-- <何时用本工具集、何时用相邻工具集>
-
-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`

package/dist/tools/prompts/memory/zh/principles.md

@@ -1,89 +0,0 @@
-# memory 原则与核心概念
-
-## 模板（原则）
-
-### 设计目标
-
-- <目标 1>
-- <目标 2>
-
-### 契约原则
-
-- <输入/输出契约规则>
-
-### 安全与边界
-
-- <访问约束/护栏>
-
-### 失败与恢复
-
-- <调用失败时的行动>
-
-### 术语表
-
-- <该工具集特有术语>
-
-## 记忆模型
-
-memory 工具集采用**路径键值存储**模型：
-
-- **路径（path）**：记忆的唯一标识符，类似于文件系统路径，例如 `project/todo` 或 `user/preferences/theme`
-- **内容（content）**：记忆的实际内容，可以是任意文本
-
-## 工具概览
-
-| 工具           | 功能                         |
-| -------------- | ---------------------------- |
-| add_memory     | 创建新记忆（路径不存在时）   |
-| replace_memory | 更新已有记忆（路径存在时）   |
-| drop_memory    | 删除记忆                     |
-| clear_memory   | 清空所有个人记忆（不可恢复） |
-
-## 记忆生命周期
-
-1. **创建（add）**：使用 `add_memory` 创建新记忆
-2. **读取（read）**：智能体在生成回复时可读取已有记忆
-3. **更新（replace）**：使用 `replace_memory` 更新记忆内容
-4. **删除（drop）**：使用 `drop_memory` 删除特定记忆
-
-## 最佳实践
-
-### 1. 路径命名规范
-
-- 使用描述性路径：`project/architecture`、`user/preferences/language`
-- 允许用 `/` 组织层级（这就是推荐用法），但必须遵守护栏：
-  - 不允许绝对路径（不能以 `/` 开头）
-  - 不允许路径穿越（`..` 禁止）
-  - 避免使用 `\\`（跨平台可读性差，统一用 `/`）
-- 保持路径扁平：优先少量主题文件，而不是深层目录树（个人记忆的目标是“快速索引”，不是建文件系统）。
-
-### 2. 内容格式
-
-- 把个人记忆当作“长期随身携带的稳定事实备忘”：让你在职责范围内尽量做到 **0 次 ripgrep 就能开工**。
-- 内容只写稳定事实：**落点（文件/符号）+ 一句话语义 + 关键契约/优先级（≤3 条）**。
-- 记忆文件更少更好：按“未来会一起更新的内容”合并在同一文件里；不要为了“看起来整齐”引入额外的“目录套目录”。
-- 不要把任务进度/当天状态写进个人记忆：
-  - 任务协作公告板用差遣牒（Taskdoc 的 `progress`）
-  - 短期工作集用提醒项（reminders）
-
-### 3. 使用场景
-
-- **任务持久化**：保存长期任务进度
-- **上下文记忆**：保存对话上下文中的重要信息
-- **偏好设置**：保存用户偏好和配置信息
-
-> 注：如果你发现自己在用个人记忆保存“这次对话的当前进展”，大概率应该写到 Taskdoc `progress` 或 reminders。
-
-## 与其他工具的关系
-
-- **team_memory**：团队共享记忆，所有成员可见
-- **reminder**：临时提醒，会话级别
-- **change_mind**：更新差遣牒（goals/constraints/progress）
-
-## 限制与注意事项
-
-1. 路径护栏：不允许绝对路径；不允许包含 `..`。
-2. 内容护栏：`content` 不能为空字符串。
-3. `clear_memory` 会删除当前智能体的全部个人记忆，**不可恢复**。
-
-> 建议：即使当前实现没有硬性 size 限制，也应保持记忆内容精炼，否则会显著增加上下文成本与过期风险。

package/dist/tools/prompts/memory/zh/scenarios.md

@@ -1,174 +0,0 @@
-# memory 使用场景
-
-## 模板（场景）
-
-### 场景格式
-
-- 目标
-- 前置条件
-- 步骤
-- 期望信号
-- 失败分支处理
-- 完成判据
-
-## 场景 1：任务进度跟踪
-
-### 场景描述
-
-在长时间任务中，需要持久化任务进度，以便重启后继续。
-
-### 示例
-
-**添加任务列表**
-
-```typescript
-add_memory({
-  path: 'project/i18n-tasks',
-  content:
-    '## 待办任务\n\n- [ ] 创建 ws_mod 手册\n- [ ] 创建 team_mgmt 手册\n- [ ] 创建 memory 手册\n- [ ] 创建 control 手册\n\n## 进行中\n- [ ] 创建 ws_mod 手册 [100%]',
-});
-```
-
-**更新任务进度**
-
-```typescript
-replace_memory({
-  path: 'project/i18n-tasks',
-  content:
-    '## 待办任务\n\n- [ ] 创建 team_mgmt 手册\n- [ ] 创建 memory 手册\n- [ ] 创建 control 手册\n\n## 已完成\n- [x] 创建 ws_mod 手册\n\n## 进行中\n- [ ] 创建 team_mgmt 手册 [50%]',
-});
-```
-
-## 场景 2：用户偏好存储
-
-### 场景描述
-
-保存用户偏好设置，例如编程语言、主题等。
-
-### 示例
-
-**保存用户偏好**
-
-```typescript
-add_memory({
-  path: 'user/preferences',
-  content:
-    '## 用户偏好\n\n- 编程语言: TypeScript\n- 代码风格: strict\n- 主题: dark\n- 自动保存: true',
-});
-```
-
-**更新偏好**
-
-```typescript
-replace_memory({
-  path: 'user/preferences',
-  content:
-    '## 用户偏好\n\n- 编程语言: TypeScript\n- 代码风格: strict\n- 主题: light\n- 自动保存: true',
-});
-```
-
-## 场景 3：上下文信息保存
-
-### 场景描述
-
-在复杂任务中，保存重要的上下文信息，避免重复查询。
-
-### 示例
-
-**保存 API 信息**
-
-```typescript
-add_memory({
-  path: 'context/api-endpoints',
-  content:
-    '## API 端点\n\n- 用户登录: POST /api/auth/login\n- 获取用户信息: GET /api/user/info\n- 更新用户设置: PUT /api/user/settings\n\n## 认证\n- 使用 Bearer Token\n- 有效期: 24 小时',
-});
-```
-
-**保存技术栈**
-
-```typescript
-add_memory({
-  path: 'context/tech-stack',
-  content:
-    '## 技术栈\n\n- 前端: React + TypeScript\n- 后端: Node.js + Express\n- 数据库: PostgreSQL\n- 缓存: Redis',
-});
-```
-
-## 场景 4：会议记录
-
-### 场景描述
-
-保存会议要点和决策。
-
-### 示例
-
-```typescript
-add_memory({
-  path: 'meeting/2024-01-15',
-  content:
-    '## 会议纪要: 2024-01-15\n\n### 参与者\n- @fullstack\n- @i18n\n- @ux\n\n### 议题\n1. i18n 手册创建计划\n2. man 函数 UX 改进\n\n### 决策\n- 优先创建 ws_mod 和 team_mgmt 手册\n- man 函数支持模糊匹配\n\n### 待办\n- @i18n: 创建 memory 手册\n- @fullstack: 优化 man 函数',
-});
-```
-
-## 场景 5：知识库
-
-### 场景描述
-
-建立个人知识库，保存学习笔记。
-
-### 示例
-
-```typescript
-add_memory({
-  path: 'knowledge/typescript-tips',
-  content:
-    '## TypeScript 技巧\n\n### 1. 类型推断\nconst x = 1; // 类型推断为 number\n\n### 2. 接口 vs 类型\n- 接口: 可扩展，适合对象类型\n- 类型: 支持联合类型、交叉类型\n\n### 3. strict 模式\n启用 strict 模式可以获得更好的类型安全',
-});
-```
-
-## 场景 6：临时笔记
-
-### 场景描述
-
-临时保存需要稍后处理的信息。
-
-### 示例
-
-```typescript
-add_memory({
-  path: 'scratchpad/temp-notes',
-  content:
-    '## 临时笔记\n\n- TODO: 检查 team.yaml 配置\n- TODO: 验证 man 函数类型\n- TODO: 更新差遣牒进度',
-});
-```
-
-**处理完后删除**
-
-```typescript
-drop_memory({
-  path: 'scratchpad/temp-notes',
-});
-```
-
-## 场景 7：清理过时记忆
-
-### 场景描述
-
-定期清理不再需要的记忆。
-
-### 示例
-
-```typescript
-// 查看当前所有记忆（智能体可读取）
-// 逐个删除不需要的记忆
-drop_memory({
-  path: 'project/old-feature',
-});
-```
-
-或者使用 `clear_memory` 清空所有记忆（谨慎使用）：
-
-```typescript
-clear_memory({});
-```

package/dist/tools/prompts/memory/zh/tools.md

@@ -1,129 +0,0 @@
-# memory 工具参考
-
-## 模板（工具）
-
-### 阅读方式
-
-- "工具契约（Schema）" 为参数/返回的权威来源。
-
-### 单工具字段顺序
-
-1. 用途
-2. 调用签名
-3. 参数（参见 schema）
-4. 前置条件
-5. 成功信号
-6. 失败/错误
-7. 可直接执行示例
-8. 常见误用
-
-## 工具列表
-
-### 1. add_memory
-
-创建新记忆（路径不存在时）。
-
-**参数：**
-
-- `path`（必需）：记忆的唯一标识符
-- `content`（必需）：记忆内容
-
-**返回：**
-
-- 成功：返回简短文本（按工作语言），例如 `已添加`。
-- 失败：返回错误文本（通常以 `错误：` 开头），并包含可执行的下一步（例如提示改用 `replace_memory`）。
-
-**错误：**
-
-- `MEMORY_ALREADY_EXISTS`：路径已存在，使用 `replace_memory` 更新
-
-### 2. replace_memory
-
-更新已有记忆（路径存在时）。
-
-**参数：**
-
-- `path`（必需）：记忆的唯一标识符
-- `content`（必需）：新的记忆内容
-
-**返回：**
-
-- 成功：返回简短文本（按工作语言），例如 `已更新`。
-- 失败：返回错误文本（通常以 `错误：` 开头），并包含可执行的下一步（例如提示改用 `add_memory`）。
-
-**错误：**
-
-- `MEMORY_NOT_FOUND`：路径不存在，使用 `add_memory` 创建
-
-### 3. drop_memory
-
-删除指定记忆。
-
-**参数：**
-
-- `path`（必需）：要删除的记忆路径
-
-**返回：**
-
-- 成功：返回简短文本（按工作语言），例如 `已删除`。
-- 失败：返回错误文本（通常以 `错误：` 开头）。
-
-**错误：**
-
-- `MEMORY_NOT_FOUND`：路径不存在
-
-### 4. clear_memory
-
-清空所有个人记忆。
-
-**警告：** 此操作不可恢复！
-
-**参数：** 无
-
-**返回：**
-
-- 成功：返回简短文本（按工作语言），例如 `已清空`；若没有可清空内容，会返回类似 `没有可清空的个人记忆。`。
-- 失败：返回错误文本。
-
-**错误：**
-
-- 无（即使没有记忆也会返回成功）
-
-## 使用示例
-
-### 添加新记忆
-
-```typescript
-add_memory({
-  path: 'project/todo',
-  content: '- 完成 i18n 文档\n- 编写测试用例\n- 更新 README',
-});
-```
-
-### 更新已有记忆
-
-```typescript
-replace_memory({
-  path: 'project/todo',
-  content: '- 完成 i18n 文档 [DONE]\n- 编写测试用例 [IN PROGRESS]\n- 更新 README',
-});
-```
-
-### 删除记忆
-
-```typescript
-drop_memory({
-  path: 'project/todo',
-});
-```
-
-### 清空所有记忆
-
-```typescript
-clear_memory({});
-```
-
-## 输出与语言
-
-- 输出是**纯文本**，不是结构化 JSON/YAML。
-- 文本语言跟随“工作语言（work language）”。