# Long-term Memory Agent **Repository Path**: hiczz/long-term-memory-agent ## Basic Information - **Project Name**: Long-term Memory Agent - **Description**: Long-term Memory Agent：专注于长期记忆管理的智能学习系统，支持持续学习与数据持久化，适用于复杂任务处理与个性化服务场景。 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-04-05 - **Last Updated**: 2026-10-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: AI, Agent, JavaScript ## README # Long-term Memory Agent #### 介绍 Long-term Memory Agent：专注于长期记忆管理的智能学习系统，支持持续学习与数据持久化，适用于复杂任务处理与个性化服务场景。 欢迎各位开发者贡献 ## 永久记忆AI项目架构 **[重构进行中]** **项目状态**: 🔄 **重构阶段 - 基于历史版本重新设计** **创建日期**: 2026-03-29 **最后更新**: 2026-04-05 **核心目标**: 构建具有类人学习能力的独立AI智能体，但以简洁、清晰、教育友好为核心原则 ### 合作模式确认 - **标准**: 功能完整 + 结构清晰 + 架构明了 + 教育友好 - **特别要求**: 1. 严禁测试数据残留，所有前端数据必须是真实功能实现 2. 代码需适合程序员学习AI智能体开发，注释充分，逻辑清晰 3. 避免过度工程，保持架构简洁直观 ### 项目演进 - **历史版本**（2026-03-29至2026-04-04）: 完成了功能完整的三层架构实现 - **重构版本**（2026-04-04起）: 基于历史版本的所有功能，但重新围绕初心设计 - 简单易用、体验驱动、教育友好、架构清晰 - **V2版本**修改了部分错误，还不够完整 ### 重构核心原则 1. **极致清晰性**: 每个文件一个职责，函数命名即文档，数据流向直观 2. **教育友好性**: 代码即教程，注释解释"为什么"，避免过度工程 3. **真正人性化**: 记忆有温度，交互自然，智能谦逊 4. **简单直接**: 前端输入直接到后端处理，不玩弯弯绕绕 ### 详细功能需求清单 #### 1. 基础架构调整 - **移除本地模型依赖**：改用云端API调用（OpenAI标准格式） - **用户配置**：提供API key、base URL、模型名输入界面 - **UI方案**：沿用浏览器界面，无需额外客户端 #### 2. 聊天系统（标准AI网页版体验） - 正常聊天对话功能 - 历史对话记录查询与管理 - 创建新对话 / 继续旧对话 - 参照主流AI厂商网页版交互体验 #### 3. 自动知识库系统（类似ima但更智能） - **自动获取**：AI空闲时主动从知识网站抓取内容 - **自动整理**：构建层级分明的知识结构体系 - **目录描述**：每个子目录包含README文档，详细说明各子文件夹/文档的功能用途 - **自我完善**：持续阅读优化知识库文档质量 #### 4. 分层记忆库系统（LV 1-10重要性等级） - **LV 10**（最高）：身份描述、性格特征 - **中等级**：用户日程、个人信息等 - **LV 1**（最低）：常识性对话、随口聊天 - **记忆提取**：从聊天记录截取关联段落，自动生成包含日期、内容、结果和等级的摘要 - **并行存储**：所有记忆独立存储，便于高效检索 #### 5. 自主学习机制 - 空闲时自动整理知识库和记忆库 - 持续完善文档质量和结构 - 具备类人长期记忆能力和知识管理能力 ### 项目文件结构设计 ``` permanent_memory_ai/ ├── README.md # 项目总览和快速开始指南 ├── package.json # 依赖管理（如果使用Node.js） ├── config/ # 配置相关 │ ├── default.config.js # 默认配置 │ └── schema.json # 配置验证schema ├── public/ # 静态资源 │ ├── index.html # 主页面入口 │ ├── favicon.ico │ └── assets/ # 图片、图标等 │ ├── icons/ │ └── styles/ ├── src/ # 源代码主目录 │ ├── main.js # 应用入口点 │ │ │ ├── ui/ # 用户界面层 │ │ ├── components/ # UI组件 │ │ │ ├── ChatInterface.vue # 聊天主界面 │ │ │ ├── SettingsPanel.vue # 设置面板 │ │ │ ├── KnowledgeBrowser.vue # 知识库浏览器 │ │ │ ├── MemoryViewer.vue # 记忆库查看器 │ │ │ └── common/ # 通用组件 │ │ │ ├── Header.vue │ │ │ ├── Sidebar.vue │ │ │ └── LoadingSpinner.vue │ │ └── styles/ # 样式文件 │ │ ├── main.css │ │ └── themes/ │ │ │ ├── services/ # 应用服务层 │ │ ├── ChatService.js # 聊天服务 │ │ ├── KnowledgeService.js # 知识库服务 │ │ ├── MemoryService.js # 记忆库服务 │ │ └── ConfigService.js # 配置服务 │ │ │ ├── core/ # 核心引擎层 │ │ ├── AIClient.js # AI客户端封装 │ │ ├── LearningEngine.js # 自主学习引擎 │ │ └── DataProcessor.js # 数据处理器 │ │ │ ├── data/ # 数据存储层 │ │ ├── storage/ # 本地存储实现 │ │ │ ├── ConversationDB.js # 对话数据库 │ │ │ ├── MemoryDB.js # 记忆数据库 │ │ │ └── FileSystem.js # 文件系统操作 │ │ └── models/ # 数据模型 │ │ ├── Conversation.js │ │ ├── KnowledgeItem.js │ │ └── MemoryItem.js │ │ │ ├── utils/ # 工具函数 │ │ ├── EventBus.js # 事件总线 │ │ ├── Logger.js # 日志工具 │ │ └── helpers.js # 通用辅助函数 │ │ │ └── constants/ # 常量定义 │ ├── config.js # 配置常量 │ └── events.js # 事件类型常量 │ ├── data/ # 运行时数据存储（.gitignore） │ ├── conversations/ # 对话记录存储 │ ├── knowledge/ # 知识库文件系统 │ │ └── README.md # 知识库根目录说明 │ ├── memories/ # 记忆库存储 │ └── config.json # 用户配置文件 │ └── docs/ # 文档 ├── architecture.md # 架构说明 ├── api-reference.md # API参考 └── user-guide.md # 用户指南 ``` ### 特殊目录结构说明 #### 知识库目录结构 ``` data/knowledge/ ├── README.md # 知识库总览 ├── level1_topic/ │ ├── README.md # 该主题的详细说明 │ ├── subtopic1/ │ │ ├── README.md │ │ └── documents/ │ └── subtopic2/ │ ├── README.md │ └── documents/ └── level2_topic/ ├── README.md └── ... ``` #### 记忆库存储格式 ``` data/memories/ ├── lv10_identity/ # LV10: 身份描述 ├── lv5_personal/ # LV5: 个人信息 ├── lv1_general/ # LV1: 常识对话 └── memory_index.json # 记忆索引文件 ``` ### 开发计划与进度 作为唯一开发者，我已按以下顺序自主完成全部开发： #### 第一阶段：基础架构搭建（✅ 已完成） - ✅ 项目需求分析与架构设计 - ✅ 文件结构创建 - ✅ 基础文件初始化（README.md, index.html） #### 第二阶段：核心引擎开发（✅ 已完成） - ✅ **AIClient.js**: 实现OpenAI标准格式的API调用封装 - ✅ **ConfigService.js**: 用户配置管理（API key、base URL、模型名） - ✅ **SettingsPanel.vue**: 配置界面组件 - ✅ **EventBus.js**: 事件总线实现 #### 第三阶段：聊天系统实现（✅ 已完成） - ✅ **ChatInterface.vue**: 聊天主界面 - ✅ **ChatService.js**: 聊天业务逻辑 - ✅ **ConversationDB.js**: 对话存储 - ✅ **Conversation.js**: 对话数据模型 #### 第四阶段：记忆库系统（✅ 已完成） - ✅ **MemoryService.js**: 记忆管理服务 - ✅ **MemoryDB.js**: 记忆存储实现 - ✅ **MemoryItem.js**: 记忆数据模型 - ✅ **MemoryViewer.vue**: 记忆查看器 #### 第五阶段：知识库系统（✅ 已完成） - ✅ **KnowledgeService.js**: 知识库服务 - ✅ **FileSystem.js**: 文件系统操作 - ✅ **KnowledgeBrowser.vue**: 知识库浏览器 - ✅ **LearningEngine.js**: 自主学习引擎 #### 第六阶段：集成与优化（✅ 已完成） - ✅ 各模块集成测试 - ✅ 性能优化 - ✅ 用户体验完善 - ✅ 完整文档编写（架构说明、用户指南、API参考） - ✅ 依赖安装和生产就绪配置 --- **记录时间**: 2026-04-05 12:38 **项目状态**: 🎉 **待完成** - 永久记忆AI智能体正在完善 **核心特性**: - 标准AI网页版聊天体验 - LV 1-10分层记忆系统 - 自动知识库整理（类似ima但更智能） - 自主学习引擎（空闲时自动优化） - 完整文档体系（适合学习和二次开发）