CC源码剖析 #10 · 状态管理：memdir 与会话持久化

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

export function getMemoryBaseDir(): string {
  // 优先级：
  // 1. CLAUDE_CODE_REMOTE_MEMORY_DIR 环境变量（CCR 远程模式）
  // 2. ~/.claude（默认配置目录）
}

// 内存目录布局
~/.claude/
└── memory/
    └── projects/
        └── {sanitized-cwd}/
            └── memory/
                ├── MEMORY.md          # 主入口
                ├── {topic}.md        # 主题记忆文件
                └── {session}/        # 按会话的记录

1
2
3
4
5
6
7
8

// SECURITY: 验证内存路径，防止路径遍历攻击
function validateMemoryPath(raw: string | undefined): string | undefined {
  // 拒绝：
  // - 相对路径（可能被解释为 CWD 相对）
  // - 根目录（"/", "C:"）
  // - UNC 路径（\\server\share）
  // - 含 null 字节
}

1
2
3
4
5
6
7

export function isAutoMemoryEnabled(): boolean {
  // 1. CLAUDE_CODE_DISABLE_AUTO_MEMORY = 1 → 关闭
  // 2. CLAUDE_CODE_SIMPLE (--bare) → 关闭
  // 3. CCR 无持久化 → 关闭
  // 4. settings.json autoMemoryEnabled
  // 5. 默认：开启
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

---
name: "memory"
description: "Auto memory for Claude Code sessions"
---

# Memory

## Index
- [[topic-a]] — Topic A summary
- [[topic-b]] — Topic B summary

## Individual

### Topic A
Topic A detail...

## What Not to Save
- API keys
- Passwords
- Tokens

## When to Access
Use for context on user's project and preferences.

1
2
3
4
5
6
7
8
9

const MAX_ENTRYPOINT_LINES = 200
const MAX_ENTRYPOINT_BYTES = 25_000

// 超限时截断并添加警告
function truncateEntrypointContent(raw: string): EntrypointTruncation {
  // 1. 先按行截断（200行）
  // 2. 再按字节截断（25KB）
  // 3. 添加警告信息
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

const MEMORY_FRONTMATTER_EXAMPLE = `
# 记忆类型说明

## Index（索引）
短条目，每个一行，格式：- [[topic]] — 摘要
用于快速浏览和检索

## Individual（个体记忆）
详细记忆，每个主题一个文件
格式：### Topic Name\n\n详细描述...

## What Not to Save（禁止保存）
敏感信息列表
- API 密钥
- 密码
- Token

## When to Access（访问时机）
说明何时应该访问这些记忆
`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

// 应该保存：
// - 项目结构
// - 用户偏好
// - 重要的决策和结论
// - 上下文信息（当前任务、目标）

// 不应该保存：
// - API 密钥
// - 密码
// - 敏感凭证
// - 训练数据（版权问题）

1
2
3
4
5

// 会话结束时，背景 Agent 提取新记忆
export function isExtractModeActive(): boolean {
  // GrowthBook flag: tengu_passport_quail
  // 只有交互式会话才能提取
}

1
2
3
4

// 1. 分析会话消息
// 2. 识别有价值的信息点
// 3. 更新 MEMORY.md 索引
// 4. 创建或更新主题文件

1
2

// 只更新新增内容，不重复已有记忆
// hasMemoryWritesSince() 检查是否有新的写入

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

interface SessionStorage {
  sessionId: string
  messages: Message[]
  metadata: {
    title: string
    createdAt: number
    lastActiveAt: number
    model: string
    tools: string[]
  }
  attachments: Attachment[]
}

// 保存
saveSession(sessionId, messages, metadata)

// 加载
loadSession(sessionId): SessionStorage

// 搜索
searchSessions(query: string): SessionSummary[]

1
2
3
4
5

// resume 时重建消息历史
loadConversationForResume(sessionId: string): Message[]

// 处理恢复后的会话
processResumedConversation(sessionId: string): Promise<Message[]>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

interface FileHistoryState {
  files: Map<string, FileState>
  sessions: SessionHistory[]
}

interface FileState = {
  path: string
  changes: FileChange[]
  lastSeen: number
}

interface FileChange = {
  type: 'edit' | 'create' | 'delete'
  timestamp: number
  sessionId: string
  diff?: string
}

1
2
3
4
5

// 检测文件是否被外部修改
// 如果是，提供重新加载选项

fileHistoryMakeSnapshot(): FileHistorySnapshot
fileHistoryRewind(snapshot: FileHistorySnapshot): void

1
2
3

const teamMemPaths = feature('TEAMMEM')
  ? require('./teamMemPaths.js')
  : null

1
2
3

// 团队成员共享的记忆
// 存储在共享位置
// 所有团队成员可见

1
2
3
4
5
6
7
8

// 将 MEMORY.md 内容注入系统提示
function buildMemoryPrompt(): string {
  const memoryFiles = getMemoryFiles()
  const memoryContent = memoryFiles
    .map(f => readFile(f))
    .join('\n\n')
  return `## Memory\n\n${memoryContent}`
}

1
2
3

// 每次新会话开始时加载
// Turn 开始时加载相关记忆
// 显式请求时加载（/remember 命令）