jianf/TrulyMEM-TrueHumanMEM-local
1
0
Fork 0
Code Issues Pull Requests Actions 10 Packages Projects Releases Wiki Activity
Files
c742a30e1b85faac6141a5852c11365017d367be
TrulyMEM-TrueHumanMEM-local/docs/一键启动指南.md
root c742a30e1b refactor: 统一 Packet 通信协议 + 后端配置管理 + UI 清理 
- 合并 server.py 到 core/__init__.py，使用统一 Packet 协议
- 后端管理配置持久化 (~/.trulymem/config.json)
- 前端移除 ConfigService，通过 BackendClient 与后端通信
- 删除 UI 中冗余的 AI 推理逻辑 (chat_service, tool_service, message_handler)
- 删除 core/tools 重复文件 (tool_executor, tool_limiter)
- 提示词管理器支持用户自定义 (~/.trulyemem/system_prompt.md)
- 启动入口优化配置路径逻辑
- 更新测试覆盖 (42 tests)
- 更新文档
2026-04-14 11:49:39 +08:00

1.9 KiB
Raw Blame History

TrulyMEM 启动指南

运行方式

从源码运行

git clone <repo-url>
cd TrulyMEM-TrueHumanMEM

pip install -r requirements.txt

python trulymem_entry.py

打包后运行

打包后会生成可执行文件：

# Linux/macOS
chmod +x TrulyMEM
./TrulyMEM

# Windows
TrulyMEM.exe

系统要求

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

首次配置

  1. 运行应用
  2. 按 F2 展开侧边栏
  3. 输入 API Key、模型、Base URL
  4. 按 Enter 保存

配置会自动保存到 ~/.trulymem/config.json，下次启动自动加载。

快捷键

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

数据存储

数据 位置
图数据库 graph_memory.db（应用目录）
配置文件 ~/.trulymem/config.json
数据库格式 SQLite

架构说明

通信协议

UI 与后端通过 Packet 协议 通信：

UI (Textual TUI)
    ↓ BackendClient
Packet → queue.Queue → BackendServer (独立线程)
    ↓
处理请求 → 返回响应

配置管理

  • 存储位置: ~/.trulymem/config.json
  • 自动加载: 启动时从文件读取配置
  • 动态更新: 运行时修改配置立即生效
  • 持久化: 修改后自动保存到文件

常见问题

Python 未找到

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

依赖安装失败

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

API Key 无效

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

开发命令

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

# 运行测试
pytest tests/

# 打包
bash build/build_windows.bat   # Windows
bash build/build_linux.sh       # Linux