会话记忆

src/services/SessionMemory/
├── SessionMemory.ts       # 核心记忆服务
└── ...

type MemoryType = 
  | 'user'       // 用户信息：角色、偏好、知识
  | 'feedback'   // 反馈：行为纠正、确认的做法
  | 'project'    // 项目：工作上下文、目标、状态
  | 'reference'  // 参考：外部资源指针

.claude/memory/
├── user_role.md           # 用户角色记忆
├── feedback_testing.md    # 测试反馈
├── project_auth.md        # 项目上下文
├── reference_dashboards.md # 外部参考
└── MEMORY.md              # 记忆索引

---
name: 测试策略
description: 关于测试方法的用户反馈
type: feedback
---
 
集成测试必须连接真实数据库，不要使用 mock。
**Why:** 上季度 mock 测试通过但生产迁移失败
**How to apply:** 涉及数据库的测试必须用真实连接

- [用户角色](user_role.md) — 后端工程师，偏好 Go
- [测试策略](feedback_testing.md) — 必须用真实数据库
- [认证重写](project_auth.md) — 合规驱动的中间件重写

1. 触发保存
   │
   ├── 用户明确要求 ("记住这个")
   ├── AI 自主判断有价值
   └── 反馈模式触发
   │
   ▼
2. 选择记忆类型
   │
   ├── 用户信息 → user
   ├── 行为纠正 → feedback
   ├── 项目上下文 → project
   └── 外部资源 → reference
   │
   ▼
3. 写入记忆文件
   │
   ├── 生成文件名 (类型_主题.md)
   ├── 写入 frontmatter
   ├── 写入内容
   └── 更新 MEMORY.md 索引
   │
   ▼
4. 读取与使用
   │
   ├── 会话启动时加载 MEMORY.md
   ├── 按需读取具体记忆文件
   └── 注入到系统提示词中

async function saveMemory(params: {
  type: MemoryType
  name: string
  description: string
  content: string
}) {
  const filename = `${params.type}_${slugify(params.name)}.md`
  const filepath = path.join(MEMORY_DIR, filename)
  
  const fileContent = `---
name: ${params.name}
description: ${params.description}
type: ${params.type}
---
 
${params.content}
`
  await writeFile(filepath, fileContent)
  await updateMemoryIndex()
}

async function loadMemory(): Promise<string> {
  const indexPath = path.join(MEMORY_DIR, 'MEMORY.md')
  
  if (!await exists(indexPath)) return ''
  
  const index = await readFile(indexPath)
  
  // 只加载索引到上下文
  // 具体记忆文件按需读取
  return index
}

async function updateMemory(name: string, content: string) {
  const filename = findMemoryFile(name)
  if (!filename) {
    // 记忆不存在，创建新的
    return saveMemory({ type: 'user', name, description: '', content })
  }
  
  // 更新现有记忆
  const filepath = path.join(MEMORY_DIR, filename)
  await writeFile(filepath, content)
}

// 在构建系统提示词时注入记忆
async function buildSystemPrompt(options: ContextOptions) {
  const parts = []
  
  // ... 其他部分
  
  // 注入记忆
  const memory = await loadMemory()
  if (memory) {
    parts.push(`<memory>\n${memory}\n</memory>`)
  }
  
  return parts.join('\n\n')
}

// 记忆修剪策略
async function pruneStaleMemories() {
  const memories = await listAllMemories()
  
  for (const memory of memories) {
    // 检查记忆是否过期
    if (isStale(memory)) {
      // 不自动删除，标记为可能过时
      await markAsStale(memory)
    }
  }
}

// services/extractMemories/
async function extractMemories(conversation: Message[]) {
  // 分析对话，识别值得保存的信息
  const candidates = await analyzeConversation(conversation)
  
  for (const candidate of candidates) {
    if (candidate.confidence > CONFIDENCE_THRESHOLD) {
      await saveMemory(candidate)
    }
  }
}