简体中文 | English

SoulMem是一个专为角色扮演任务设计的记忆系统，它旨在使LLM的输出更拟人化成为可能，让模拟角色像人一样记住重要的、情感相关的、可驱动行为的事件，并建立关联。它不旨在精确无误地记忆事件的细节，或事实性知识。

请注意！：SoulMem是针对于个人用户，在家用电脑上运行的记忆系统，并非企业级解决方案。

• 记忆的整合与进化：记忆会随着时间推移进行整合、概括，形成更高层次的认知。

• 主动遗忘机制：模拟人类的遗忘曲线，保留重要记忆，淡化琐碎细节。

• 基于图谱的联想：通过工作记忆子图实现记忆的主动联想。

• 动态记忆更新：支持在交互过程中实时添加和更新记忆。

• 短期记忆抽象：通过摘要机制处理短期上下文，防止信息过载。

SoulMem 的核心设计哲学是：“一切特征和事件都属于记忆”。

与传统角色扮演系统依赖静态的“角色卡”不同，SoulMem 认为角色的性格、口癖、行为习惯等都是长期记忆交互演化的结果。这种设计旨在更好地支持角色性格的动态演变，并保持高度的角色一致性。

当前状态：积极开发中

> 🚧 SoulMem 正在活跃开发中，尚未发布稳定版本。我们欢迎感兴趣的开发者关注、讨论甚至参与贡献！最新的架构设计和开发进展请参考 docs 目录。

• 重要通知：项目已进行架构重构。main 分支为最新版本，旧的 alpha 版本代码可在 alpha_deprecated 分支找到。

• 详细架构：请参阅 docs/architecture/beta_ver.md 了解最新的技术架构说明。

目前项目处于早期开发阶段。当有可用版本时，这里将提供安装和基本使用教程。

我们非常欢迎任何形式的贡献！无论是代码、文档、创意还是测试，都能帮助 SoulMem 成长。

1. Fork 本仓库
2. 创建您的功能分支
3. 提交您的更改
4. 推送到分支
5. 开启一个 Pull Request

请确保您的代码遵循项目已有的风格。

本项目采用 MIT 许可证。详见 LICENSE 文件。

感谢所有为这个项目提供想法和帮助的贡献者。