TrulyMEM-TrueHumanMEM/docs/一键启动指南.md

一键启动指南

🚀 快速开始

Windows

# 方法1: 双击运行
双击 start.bat

# 方法2: 命令行
start.bat

# 方法3: Python
python start.py

Linux / macOS

# 方法1: Shell脚本
chmod +x start.sh
./start.sh

# 方法2: Python
python3 start.py

📋 启动流程

[Step 1/3] 检查 Python
    ↓
[Step 2/3] 设置虚拟环境
    - 创建venv（如果不存在）
    - 安装依赖
    ↓
[Step 3/3] 启动应用
    ↓
✅ 系统初始化成功！

⏱️ 启动时间

• 首次启动: 约1-2分钟（安装依赖）
• 后续启动: 约30秒

🔧 系统要求

必需

• Python 3.8+
• DeepSeek API Key

可选

• Git - 用于克隆仓库

📝 首次使用

1. 启动应用

start.bat  # Windows
./start.sh # Linux/macOS

2. 配置 API Key

1. 按 F2 展开侧边栏
2. 点击 "配置"
3. 输入 DeepSeek API Key
4. 按 Enter 保存

3. 开始对话

• 输入消息
• 按 Enter 发送

🌐 获取 API Key

DeepSeek

1. 访问：https://platform.deepseek.com/
2. 注册账号
3. 创建 API Key
4. 复制密钥

其他兼容API

• OpenAI
• 其他兼容OpenAI格式的API

⚠️ 常见问题

Q: Python 未找到

A: 安装 Python 3.8+

• Windows: https://www.python.org/downloads/
• Linux: sudo apt install python3
• macOS: brew install python3

Q: 依赖安装失败

A: 手动安装

python -m venv venv
venv\Scripts\activate  # Windows
source venv/bin/activate  # Linux/macOS
pip install -r requirements.txt

Q: API Key 无效

A: 检查API Key格式

• 应以 sk- 开头
• 无多余空格
• 正确复制

🎯 快捷键

快捷键	功能
F1	帮助
F2	侧边栏
F3	工具详情
F5	清屏
F6	退出

📊 数据存储

• 数据库: graph_memory.db
• 位置: 应用目录
• 格式: SQLite
• 可备份: 是

🔄 更新应用

# 拉取最新代码
git pull

# 重新启动
start.bat

🗑️ 清理数据

# 删除数据库
rm graph_memory.db

# 重新启动会创建新数据库
start.bat

💡 提示

• 首次启动需要安装依赖，请耐心等待
• API Key 只需配置一次
• 数据自动保存，无需手动操作
• 可以随时按F6退出

开始使用吧！