docs: add Auto Memory documentation

- guides/memory.md: new dedicated guide for Auto Memory system
- guides/slash-commands.md: add /memory command with subcommands
- reference/tool-list.md: add MemoryRead/MemoryWrite tools
- changelog.md: add Unreleased section with all changes
- _sidebar.md: add Auto Memory link to navigation

Author: echoVic

docs/_sidebar.md

@@ -12,6 +12,7 @@
 
 * 使用指南
   * [Slash 命令](guides/slash-commands.md)
+  * [Auto Memory](guides/memory.md)
   * [Subagents 系统](guides/subagents.md)
   * [Skills 系统](guides/skills.md)
   * [Hooks 钩子](guides/hooks.md)

docs/changelog.md

@@ -3,6 +3,31 @@
 All notable changes to this project will be documented in this file.
 
 
+## [Unreleased]
+
+### ✨ 新功能
+
+- **Auto Memory 系统** — Agent 跨会话持久化项目知识（构建命令、代码模式、调试洞察）
+  - `MemoryRead` / `MemoryWrite` 工具：Agent 自动读写记忆文件，内置敏感数据过滤
+  - `/memory` 命令：`list` / `show` / `edit` / `clear` 管理记忆文件
+  - 启动时自动注入 MEMORY.md 前 200 行到 system prompt
+  - 环境变量 `BLADE_AUTO_MEMORY=0` 可禁用
+
+### 🐛 问题修复
+
+- `createTool.execute()` 现在正确传递 `ExecutionContext` 到工具函数，修复 `context.workspaceRoot` 等始终为 undefined 的问题
+
+### ♻️ 代码重构
+
+- 清理 `PersistentStore` 废弃方法（`saveContext` / `saveSession` / `saveConversation`）
+- 新增 `ContextAssembler`：集中 JSONL 事件流到 ContextData 的重建逻辑，修复 tool calls 和 compaction summary 丢失问题
+- 修复 `ContextManager.saveCurrentSession()` 重复写入 JSONL 的问题
+
+### ✅ 测试相关
+
+- 新增 58 个单元测试（AutoMemoryManager 20 + MemoryTools 18 + ContextAssembler 20）
+
+
 ## [0.2.5] - 2026-02-16
 
 ### 🔧 其他更改

docs/guides/memory.md

@@ -0,0 +1,100 @@
+# 🧠 Auto Memory
+
+Auto Memory 让 Agent 在工作中自动记录项目知识，跨会话持久化。新会话启动时自动加载历史记忆，Agent 不再"失忆"。
+
+## 工作原理
+
+1. **启动时加载** — 会话开始时，MEMORY.md 前 200 行自动注入 system prompt
+2. **工作中记录** — Agent 发现有价值的知识时，通过 MemoryWrite 工具保存
+3. **按需检索** — Agent 需要特定主题的详细信息时，通过 MemoryRead 工具读取
+
+## 存储结构
+
+记忆文件存储在项目专属目录下：
+
+```
+~/.blade/projects/{escaped-path}/memory/
+├── MEMORY.md          # 入口索引（启动时加载前 200 行）
+├── patterns.md        # 项目模式（构建命令、代码风格）
+├── debugging.md       # 调试洞察
+├── architecture.md    # 架构笔记
+└── ...                # Agent 按需创建的主题文件
+```
+
+每个项目有独立的记忆空间，互不干扰。
+
+## Agent 会记住什么
+
+- 项目的构建、测试、lint 命令
+- 代码模式和约定
+- 调试过程中发现的解决方案
+- 架构决策和关键文件关系
+- 用户偏好和工作流习惯
+
+## 安全机制
+
+- **敏感数据过滤** — 自动拒绝包含 password、token、secret、api_key、private_key 的内容
+- **路径遍历防护** — 主题名不允许包含 `..` 或 `/`，防止写入任意路径
+- **索引行数限制** — MEMORY.md 加载上限 200 行，避免 system prompt 膨胀
+
+## /memory 命令
+
+在会话中使用 `/memory` 管理记忆文件：
+
+| 命令 | 说明 |
+|------|------|
+| `/memory` | 列出所有记忆文件（等同于 `/memory list`） |
+| `/memory list` | 列出所有记忆文件及大小 |
+| `/memory show` | 显示 MEMORY.md 索引内容 |
+| `/memory show <topic>` | 显示指定主题文件内容 |
+| `/memory edit` | 用 `$EDITOR` 编辑 MEMORY.md |
+| `/memory edit <topic>` | 用 `$EDITOR` 编辑指定主题文件 |
+| `/memory clear` | 清空所有记忆文件 |
+
+## 工具
+
+### MemoryRead
+
+读取记忆文件，Agent 在需要时自动调用。
+
+```
+topic: "debugging"     → 读取 debugging.md
+topic: "MEMORY"        → 读取 MEMORY.md 索引
+topic: "_list"         → 列出所有记忆文件
+```
+
+### MemoryWrite
+
+保存记忆内容，支持追加和覆盖模式。
+
+```
+topic: "patterns"
+content: "## Build\npnpm build"
+mode: "append"         → 追加到 patterns.md
+mode: "overwrite"      → 覆盖 patterns.md
+```
+
+## 配置
+
+### 环境变量
+
+```bash
+# 禁用 Auto Memory
+BLADE_AUTO_MEMORY=0
+
+# 启用（默认）
+BLADE_AUTO_MEMORY=1
+```
+
+## 最佳实践
+
+- **MEMORY.md 是索引** — 保持简洁，详细内容放到主题文件
+- **让 Agent 自己学** — 不需要手动写记忆，Agent 会在工作中自动发现和记录
+- **定期检查** — 用 `/memory show` 看看 Agent 记了什么，用 `/memory edit` 修正不准确的内容
+- **项目初始化后** — 第一次在新项目中使用时，Agent 会逐步积累知识，几次会话后效果最佳
+
+## 相关资源
+
+- [Slash 命令](slash-commands.md) — 所有内置命令
+- [工具列表](../reference/tool-list.md) — MemoryRead / MemoryWrite 参数详情
+- [配置系统](../configuration/config-system.md) — 全局和项目级配置

docs/guides/slash-commands.md

@@ -23,6 +23,7 @@ Slash 命令是 Blade 的快捷操作入口，输入 `/` 触发建议，`Tab` 
 | `/hooks` | - | 管理 Hooks |
 | `/resume` | - | 恢复历史会话 |
 | `/compact` | - | 手动压缩上下文 |
+| `/memory` | - | 管理项目记忆 |
 | `/git` | `/g` | Git 操作 |
 | `/login` | - | 登录 OAuth 服务 |
 | `/logout` | - | 登出 OAuth 服务 |
@@ -96,6 +97,24 @@ Git 仓库查询和 AI 辅助：
 /compact
 ```
 
+### /memory
+
+管理项目的自动记忆系统。Agent 在工作中自动记录的项目知识（构建命令、代码模式、调试洞察等）会跨会话持久化。
+
+```bash
+/memory              # 等同于 /memory list
+/memory list         # 列出所有记忆文件
+/memory show         # 显示 MEMORY.md 索引内容
+/memory show <topic> # 显示指定主题文件内容
+/memory edit         # 用 $EDITOR 编辑 MEMORY.md
+/memory edit <topic> # 用 $EDITOR 编辑指定主题文件
+/memory clear        # 清空所有记忆文件
+```
+
+记忆文件存储在 `~/.blade/projects/{project}/memory/` 目录下。
+
+可通过环境变量 `BLADE_AUTO_MEMORY=0` 禁用自动记忆功能。
+
 ### /login
 
 登录 OAuth 服务（Antigravity / Copilot）：

docs/reference/tool-list.md

@@ -282,6 +282,30 @@
 
 ## 系统工具
 
+### MemoryRead
+
+读取项目记忆文件。Agent 自动记录的项目知识跨会话持久化。
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `topic` | string | ✅ | 主题名（如 "debugging"）或 "_list" 列出所有文件，"MEMORY" 读取索引 |
+
+**类型**: ReadOnly  
+**返回**: 记忆文件内容或文件列表
+
+### MemoryWrite
+
+保存项目记忆。支持敏感数据过滤（password/token/secret/api_key/private_key）。
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `topic` | string | ✅ | 主题名（如 "patterns"），"MEMORY" 写入索引 |
+| `content` | string | ✅ | 要保存的内容 |
+| `mode` | string | | 写入模式：overwrite / append（默认 append） |
+
+**类型**: Write  
+**特性**: 自动过滤敏感数据，防止路径遍历
+
 ### AskUserQuestion
 
 向用户提问并等待回复。
@@ -363,6 +387,8 @@ blade mcp list
 | Spec | UpdateTaskStatus | Write | 更新任务状态 |
 | Spec | ValidateSpec | ReadOnly | 验证 Spec 完整性 |
 | Spec | ExitSpecMode | Write | 退出 Spec 模式 |
+| 系统 | MemoryRead | ReadOnly | 读取项目记忆文件 |
+| 系统 | MemoryWrite | Write | 保存项目记忆 |
 | 系统 | AskUserQuestion | ReadOnly | 向用户提问 |
 | 系统 | Skill | Execute | 调用已注册的 Skill |
 | 系统 | SlashCommand | Execute | 执行 Slash 命令 |