什么是Soul Sharing
agent-soul 是一个专为 AI 智能体设计的去中心化记忆与身份共享系统，其核心理念是让多个运行实例、设备或会话中的 AI 能够拥有统一的持久化身份和跨会话的记忆能力。该系统完全基于 Git 工作流构建，摒弃了传统数据库和第三方记忆 API，通过纯文本文件和版本控制机制实现数据的可靠存储与同步。每个智能体都拥有一个独特的‘灵魂’（SOUL），由 SOUL.md、IDENTITY.md、USER.md 和 VOICE.md 四个核心文件定义，这些文件共同构成了智能体的基本人格特征和行为模式。整个系统采用分层加载协议，将记忆分为 L0（灵魂层）、L1（稳定记忆层）和 L2（项目上下文层），确保关键信息始终可用，而项目相关细节按需加载。所有记忆事件都以追加方式写入 sources/ 目录下的 NDJSON 文件，并通过编译脚本自动生成 canonical/ 目录中的统一读取视图，保证数据的一致性和可检索性。
核心功能特点
- 基于 Git 的版本化记忆存储，无需数据库，实现真正的数据自主权与零供应商锁定
- 分层加载协议支持 L0/L1/L2 三级记忆访问，兼顾性能与上下文完整性
- 多智能体共享同一身份体系，支持跨平台、跨设备的统一人格延续
- 事件驱动架构，所有记忆变更均以结构化事件形式记录，具备完整溯源能力
- 内置时间衰减机制，可为记忆项设置有效期，自动清理过时信息
- 提供命令行工具链用于事件添加、记忆编译、搜索与清理，集成于开发流程
适用场景
agent-soul 最适合那些需要长期记忆保持且跨越多个运行环境或用户终端的 AI 应用场景。例如，当用户同时在 Windows 电脑上使用 Claude Code，在 macOS 上使用 OpenClaw，或在云端部署多个代理实例时，这些不同的执行体可以通过 agent-soul 共享同一个‘灵魂’，从而形成一致的用户交互体验。无论是记录用户的个人偏好（如主题色设置）、重要决策（如功能冻结策略），还是临时任务状态（如当前调试的 CORS 问题），系统都能将其转化为结构化事件并持久保存。由于所有内容均托管在用户私有的 GitHub 仓库中，企业或开发者可以完全掌控数据主权，避免依赖外部记忆服务带来的隐私与合规风险。此外，该方案特别适合团队协作型 AI 应用，多个代理协同工作时可实时同步彼此学到的知识，提升整体协作效率。