# TrulyMEM 启动指南

## 运行方式

### 从源码运行

```bash
# 克隆仓库
git clone <repo-url>
cd TrulyMEM-TrueHumanMEM

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

# 运行
python trulymem_entry.py
```

### 打包后运行

打包后会生成可执行文件（Windows: TrulyMEM.exe, Linux/macOS: TrulyMEM）：

```bash
# Linux/macOS
chmod +x TrulyMEM
./TrulyMEM

# Windows
TrulyMEM.exe
```

## 系统要求

- **Python 3.8+**
- **API Key**（DeepSeek、OpenAI 或其他兼容 API）

## 首次配置

1. 运行应用
2. 按 **F2** 展开侧边栏
3. 输入 **API Key**
4. 按 **Enter** 保存

## 快捷键

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

## 数据存储

- **数据库**: `graph_memory.db`（应用目录）
- **配置**: `config.json`（应用目录）
- **格式**: SQLite

## 常见问题

### Python 未找到

安装 Python 3.8+：https://www.python.org/downloads/

### 依赖安装失败

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

### API Key 无效

检查 API Key 格式，确保无多余空格。

## 开发命令

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

# 运行测试
pytest tests/

# 打包（需 PyInstaller）
python build_windows.bat   # Windows
bash build_linux.sh       # Linux
```