Skip to content

29-team-memory-sync-and-shared-repo-memory.md

Latest commit

 

History

History
88 lines (59 loc) · 3.3 KB

29-team-memory-sync-and-shared-repo-memory.md

File metadata and controls

88 lines (59 loc) · 3.3 KB

29. Team Memory Sync 与 Shared Repo Memory

所属专题簇：协作型长期记忆

建议前读：21. 记忆系统：CLAUDE.md、Session Memory 与 Agent Memory

建议后读：20. Coordinator、Swarm 与 Teammate 协作

研究问题

Claude Code 的记忆为什么会进一步扩展到 team memory？它和本地 memory 有什么不同？

一句话结论

team memory 不是本地记忆文件的简单同步，而是按仓库范围、按组织成员共享、带 secret scanning 和服务端优先语义的协作型记忆层。

这篇讲什么

这一章解释 team memory sync 如何把 Claude Code 的记忆体系从“个人 / 会话 / agent”扩展到“团队 / 仓库”范围。

如果你不看源码，只看这一章，应该记住什么

  • team memory 是 repo-scoped 的共享记忆。
  • 它默认面向组织协作，而不是个人偏好。
  • 它在同步前就考虑了 secret scanning 和路径安全。

源码依据

Mermaid 图：团队记忆同步语义

flowchart TD
    A["本地 team memory files"] --> B["validate path / scan secrets"]
    B --> C["repo identity"]
    C --> D["TeamMemorySync service"]
    D --> E["server checksums / delta upload"]
    E --> F["shared repo memory on server"]
    F --> G["pull overwrite local"]
Loading

这层语义和普通 memory 完全不同

src/services/teamMemorySync/index.ts 顶部注释直接写明：

  • team memory 按 repo 范围识别
  • 共享给 authenticated org members
  • pull 以 server 内容覆盖本地
  • push 只上传 checksum 有变化的键
  • 删除本地文件不会删除服务端条目

这是一套协作同步协议，不是单机 memory 存档。

为什么 secret scanning 很重要

同一目录里有：

  • secretScanner.ts
  • teamMemSecretGuard.ts

这说明 Anthropic 已经意识到“团队共享记忆”天然会引入更高的敏感信息泄露风险，因此同步前必须做专门防护。

这体现了怎样的记忆观

到这一步，Claude Code 的记忆已经至少分成：

  • 工作区规则记忆
  • 会话滚动记忆
  • agent 长期经验记忆
  • 团队仓库共享记忆

这说明它的“记忆”概念不是单一模型特性，而是一整套围绕长期工程协作设计的分层机制。

你真正应该记住的点

  • team memory 是协作机制，不只是 memory 的多设备同步版。
  • 服务端优先和 secret scanning 说明这层已经进入组织治理范畴。
  • 研究 Claude Code 的长期记忆设计时，不能停留在 CLAUDE.md 和 session memory。

延伸阅读