# TrulyMEM 一键启动指南

## 快速开始

### Windows

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

# 方法2: 命令行
start.bat

# 方法3: Python
python trulymem_entry.py
```

### Linux / macOS

```bash
# 方法1: Python直接运行
python3 trulymem_entry.py

# 方法2: 打包后的可执行文件
chmod +x TrulyMEM
./TrulyMEM
```

## 启动流程

```
[Step 1/3] 检查 Python
    ↓
[Step 2/3] 安装依赖
    - 安装 requirements.txt 中的依赖
    ↓
[Step 3/3] 启动应用
    ↓
✅ 系统初始化成功！
```

## 启动时间

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

## 系统要求

### 必需

- **Python 3.8+**
- **DeepSeek API Key** (或 OpenAI 兼容 API Key)

### 可选

- **Git** - 用于克隆仓库

## 首次使用

### 1. 启动应用

```bash
python trulymem_entry.py
```

### 2. 配置 API Key

1. 按 **F2** 展开侧边栏
2. 在 API Key 输入框输入密钥
3. 按 **Enter** 保存

### 3. 开始对话

- 在底部输入框输入消息
- 按 **Enter** 发送

## 获取 API Key

### DeepSeek

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

### 其他兼容API

- OpenAI
- 其他兼容OpenAI格式的API（如 Azure OpenAI）

## 常见问题

### Q: Python 未找到

**A:** 安装 Python 3.8+
- Windows: https://www.python.org/downloads/
- Linux: `sudo apt install python3`
- macOS: `brew install python3`

### Q: 依赖安装失败

**A:** 手动安装
```bash
python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate  # Windows
pip install -r requirements.txt
```

### Q: API Key 无效

**A:** 检查API Key格式
- 应以 `sk-` 开头（DeepSeek/OpenAI）
- 无多余空格
- 正确复制

### Q: 提示"请先配置API Key"

**A:** 按 F2 展开侧边栏，在 API Key 输入框中输入密钥后按 Enter

## 快捷键

| 快捷键 | 功能 |
|--------|------|
| F1 | 帮助 |
| F2 | 切换侧边栏 |
| F3 | 工具详情 |
| F4 | 聚焦查询框 |
| F5 | 清屏 |
| F6 | 退出 |

## 数据存储

- **数据库**: `graph_memory.db`
- **位置**: 应用目录
- **格式**: SQLite（内嵌，无需外部数据库）
- **可备份**: 是，直接复制文件即可

## 更新应用

```bash
# 拉取最新代码
git pull

# 重新安装依赖（如有更新）
pip install -r requirements.txt

# 重新启动
python trulymem_entry.py
```

## 清理数据

```bash
# 删除数据库
rm graph_memory.db

# 重新启动会创建新数据库
python trulymem_entry.py
```

## 提示

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

## 从源码运行

```bash
# 克隆仓库
git clone https://github.com/yourusername/trulymem.git
cd trulymem

# 安装依赖
pip install -r requirements.txt

# 运行
python -m graph_memory_tui.main
# 或
python trulymem_entry.py
```

## 打包应用

### Windows

```bash
python build_windows.bat
```

### Linux

```bash
bash build_linux.sh
```

开始使用吧！