My-Dream-Moments 开源项目快速上手指南

1. 核心功能概览

My-Dream-Moments 是一款基于 LLM 的情感陪伴程序，支持微信与 QQBot 接入，内置 Atri-My dear moments 对话模板。项目通过模块化设计实现情感交互、记忆管理、任务自动化等核心能力，适合希望搭建个性化 AI 陪伴系统的开发者使用。

2. 环境准备

2.1 依赖安装

1. 克隆项目代码库：
   git clone https://gitcode.com/gh_mirrors/my/My-Dream-Moments
2. 进入项目根目录并安装依赖：
   cd My-Dream-Moments && pip install -r requirements.txt

💡 小贴士：建议使用 Python 3.8+ 环境，通过虚拟环境隔离项目依赖可避免版本冲突。

3. 零基础启动步骤

3.1 基础配置

1. 复制配置模板文件：
   将 data/config/config.json.template 重命名为 config.json
2. 编辑核心参数：
   • 填写 API 服务配置（如 LLM 接口地址、API Key）
   • 设置消息接收渠道（微信/QQBot 接入信息）

3.2 启动程序

• Windows 系统：双击运行根目录下的 run.bat
• 其他系统：在终端执行 python run.py

💡 小贴士：首次启动会自动生成必要的数据目录，若出现端口占用可修改配置文件中的 PORT 参数。

4. 关键模块解析

4.1 记忆管理系统

核心功能：存储与处理对话历史、用户偏好等数据
关键文件路径：modules/memory/

• memory_service.py：提供记忆数据的增删改查接口
• content_generator.py：实现基于记忆的对话内容生成逻辑

4.2 自动任务系统

核心功能：定时执行预设任务（如消息推送、状态检查）
关键文件路径：src/AutoTasker/
配置入口：data/tasks.json 定义任务调度规则

💡 小贴士：任务配置支持 cron 表达式，修改后需重启服务使新任务生效。

4.3 WebUI 配置工具

启动方式：执行 python run_config_web.py 打开可视化配置界面
功能：通过浏览器修改系统参数、管理对话模板、监控服务状态

5. 模块配置指南

5.1 核心配置文件说明

路径：data/config/config.json
关键配置项：

• LLM_PROVIDER：指定 AI 服务提供商（如 DeepSeekV3）
• MAX_MEMORY_LENGTH：设置上下文记忆长度上限
• RESPONSE_TIMEOUT：API 调用超时时间（单位：秒）

5.2 对话模板管理

模板文件存放路径：src/base/prompts/
支持自定义模板类型：日记（diary.md）、信件（letter.md）、购物清单（shopping.md）等

💡 小贴士：修改模板后无需重启服务，下次对话将自动应用更新内容。

6. 常见问题解决

• 启动失败：检查端口占用情况，确保配置文件中 API_KEY 等必填项已正确填写
• 记忆功能异常：清理 data/ 目录下的缓存文件后重试
• WebUI 无法访问：确认 run_config_web.py 已启动，默认访问地址为 http://localhost:8080

通过以上步骤，您已完成 My-Dream-Moments 项目的基础部署与配置。如需深入定制功能，可参考 src/services/ 目录下的 AI 服务接口实现，或通过 Plugins/ 目录扩展新功能模块。