用途
Claude Soul 是一个为 Claude Code 构建的自校正学习引擎，解决 Claude Code 在会话之间遗忘一切的问题。它让 Claude 拥有持久身份、行为模式追踪以及跨会话记忆能力，并随时间发展出判断力。
主要能力
跨会话记忆
提供跨会话记忆与语义搜索。事实、决策、经验教训都按含义而非仅关键词被检索。使用本地 SQLite，并可选配合 Ollama 嵌入实现语义搜索。
追踪纠正
每当用户纠正 Claude（如“那不对”“你漏了这个”“别再那样做”）时，系统会检测该模式、对其分类，并追踪它是变好还是变差。模式经历生命周期阶段：new → active → improving → internalized。官方称在 200 次会话的真实数据后，robot_mode 从每会话 0.8 次纠正降至零。
发展判断力
系统从每次会话中提取行为信号并定期反思。持续有效的框架被提升，不好的被淘汰。数周后，Claude 会反驳坏主意、发现自己的虚构，并发展出用户从未提示过的技巧。
使用方式
快速开始
无需额外依赖。将指定片段添加到 CLAUDE.md 即可，此后记忆以关键词搜索工作，其余部分自动运行。
带语义记忆
语义搜索按含义查找记忆，例如“auth decision”能找到存储为“chose JWT tokens for login”的记忆。不启用时搜索基于关键词，仍可用但灵活性较低。系统会自动检测 Ollama，无需配置。
面向智能体（非交互）
跳过名称/上下文问题。将 CLAUDE.md 片段添加到智能体的工作目录，工作方式相同——记忆、纠正追踪和框架演化都通过 Claude Code 的钩子和 MCP 服务器运行，无论由人输入还是智能体运行。
已安装后升级
灵魂文件、框架和数据保持不变。升级会以最新版本重新注册钩子和 MCP 服务器，并添加新功能。升级后运行 claude-soul index 一次，将现有数据回填到记忆系统。
新增与 CLI
- 记忆系统：6 个新的 MCP 工具（memory_save、memory_search、recall 等），用于跨会话事实存储与语义搜索。
- 纠正追踪：自动检测用户对 Claude 的纠正并分类该模式。
- 影子分析：claude-soul shadow 展示带趋势箭头和生命周期阶段的行为模式。
- 索引：claude-soul index 将现有日志和灵魂文件加载到记忆数据库。 这些是可选的，系统会自动运行。CLI 用于从终端查看收集的数据。
架构与配置
一切通过 Claude Code 官方扩展点运行：一个 MCP 服务器（15 个工具）和钩子（信号提取、日志记录、记忆索引、纠正追踪）。身份与学习的所有设置位于 ~/.soul/config.json。
设计原则
- 证据优于断言：框架通过反复确认获得其地位。
- 本地优先：无云、无账户、无遥测。
- 工作时不可见：自动提取信号，在后台反思。
限制
官方资料未提供关于平台支持范围、数据迁移细节、与其他工具兼容性、性能上限或收费模式的更多说明，这些事实暂未提供。
