Files
TrulyMEM-TrueHumanMEM-local/docs/项目结构.md
JianFeeeee 6689f08456 feat: Add embedded SQLite database and web interface
- Implement EmbeddedGraphDB with full Neo4j compatibility
- Add web interface for browser access
- Fix input box display issue
- Add comprehensive database tests (15/15 passed)
- Simplify startup script (3 steps, no Docker needed)
- Add multi-language support
- Add .gitignore for clean repository
- Update documentation

All tests passed. Ready for production.
2026-04-10 15:43:22 +08:00

2.6 KiB

项目结构

graph_enable_ability/
├── docs/                      # 文档目录
│   ├── 架构.md               # 架构设计文档
│   ├── 一键启动指南.md       # 启动脚本使用指南
│   └── API配置指南.md        # API Key配置说明
│
├── graph_memory_tui/         # TUI应用主目录
│   ├── widgets/              # UI组件
│   ├── models/               # 数据模型
│   ├── core/                 # 核心逻辑
│   ├── styles/               # 样式文件
│   └── app.py                # 主应用
│
├── tests/                    # 测试目录
├── scripts/                  # 脚本目录
├── docker/                   # Docker配置
│
├── graph_memory_demo.py      # 命令行Demo
├── start.bat                 # Windows启动脚本
├── start.sh                  # Linux/macOS启动脚本
├── start.py                  # 跨平台Python启动脚本
├── start_neo4j.bat           # Neo4j启动脚本
├── quick_start.bat           # 快速启动脚本
│
├── requirements.txt          # Python依赖
├── README.md                 # 项目说明
└── 图数据库结构设计          # 数据库设计文档

核心文件说明

启动脚本

  • start.bat - Windows一键启动脚本

    • 自动启动Docker (优先WSL)
    • 自动启动Neo4j
    • 自动安装依赖
    • 启动TUI应用
  • start.sh - Linux/macOS启动脚本

    • 功能同start.bat
    • 支持systemctl启动Docker
  • start.py - 跨平台Python启动脚本

    • 自动检测系统语言
    • 自动选择最佳Docker启动方式
    • 支持Windows/Linux/macOS

应用文件

  • graph_memory_tui/ - TUI应用目录

    • 基于Textual框架
    • 现代化终端界面
    • 实时消息显示
    • 工具调用可视化
  • graph_memory_demo.py - 命令行Demo

    • 简单的命令行界面
    • 用于测试和调试

文档

  • docs/ - 文档目录

    • 架构设计
    • 使用指南
    • 配置说明
  • README.md - 项目主文档

    • 项目介绍
    • 快速开始
    • 功能说明

使用流程

  1. 首次使用

    # Windows
    start.bat
    
    # Linux/macOS
    ./start.sh
    
  2. 配置API Key

    • 按F2打开侧边栏
    • 输入API Key
    • 按Enter保存
  3. 开始对话

    • 输入消息
    • 按Enter发送
    • 查看响应

开发相关

运行测试

python run_tests.py

安装依赖

pip install -r requirements.txt

手动启动Neo4j

# Windows
start_neo4j.bat

# Linux/macOS
docker start neo4j