Mnemosyne

Mnemosyne 是一个基于 Rust 的智能记忆系统,具有多层架构设计。

项目结构

本项目采用 Cargo Workspace 架构,包含以下模块:

• nemo_core - 核心层,提供共享组件(事件总线、状态机、配置管理等)
• nemo_brain - 认知层,Nemo 的大脑
• nemo_memory - 记忆层,负责记忆存储和检索
• nemo_senses - 感知层,用于收集外部输入
• nemo_hands - 执行层,处理工具调用和执行
• nemo_agent - 代理层,管理插件和任务
• nemo_onebot - OneBot 11 SDK 实现
• nemo_voice - 表达层

文档

详细的项目文档位于 docs/ 目录下：

• 01-项目概览 - 项目背景、核心特性、技术栈和设计理念
• 02-架构设计 - 系统架构、核心组件详解、数据流和扩展性
• 03-核心模块参考 - 各模块的 API 文档、使用示例和测试指南
• 04-功能特性详解 - 双系统思维、记忆系统、工具系统等深度解析
• 05-配置指南 - 完整配置参数说明、示例和最佳实践

开发要求

• Rust nightly (edition 2024)
• cargo-nextest (用于运行测试)

构建和测试

# 构建项目
cargo build

# 运行测试
cargo nextest run --all-features --workspace

# 运行基准测试
cargo bench

# 格式化代码
cargo fmt --all

# 代码检查
cargo clippy --all-targets --all-features

许可证

本项目采用 LGPL-3.0-only 许可证。详见 LICENSE.md。

作者

Xyber Nova [email protected]