Files

root aefaea7b90 docs: 更新 README 适配多用户+Admin 角色系统

- 移除旧的 web_config.example.json 指引（已替换为首次访问自动设置）
- 新增 TUI 登录引导描述
- 新增多用户隔离目录结构说明
- 新增 Admin/User 角色权限说明
- 新增打包构建双入口说明

2026-04-28 10:42:53 +08:00

6.3 KiB

Raw Blame History

TrulyMEM - TrueHumanMEM

📜 开源协议: GNU General Public License v3.0 (GPLv3)
本项目自由开源，可自由使用、修改和分发，但修改后的作品必须以相同许可证发布。

English: Switch to English version

让 AI 拥有自知、可塑、有分寸感的长期记忆

The More Human Choice.

故事的开头

行业普遍认为，LLM 海量参数让其涌现了智能。但这个智能是「死的」——它不会真的记住，也不理解「记住」的概念。它输出的一切，都是当前输入的全部文本经历无数次前向传播计算出的概率最优解。LLM 不会因为某次对话意识到错误而去修正权重，也无法因此针对模型进行一次反向传播。它的意识是被冻结的，展现出的智能只是冻结的意识的回响。

现在的所谓记忆系统，只是将记忆外化，让「系统」去替 LLM 记住。或者就是粗暴地将一切上下文文本丢给 LLM。这就是对模型输入的浪费。

TrulyMEM 想，既然 LLM 无法实时纠正模型权重，为什么不把记忆权交还给 LLM 呢？

我们提供一系列机制，让 LLM 决定它要记住什么、遗忘，什么是重点、什么是糟粕。LLM 推理的过程，就是思考的过程，也是回忆的过程。完全摒弃传统的 messages 数组上下文，将全部记忆以**三元组（图）**的形式保存在图数据库中。在 LLM 思考时，可以按照图数据库的链接自主跳转、联想相关关系，让 LLM 自然地实现联想与回忆。

赋予 LLM 真正的记忆。

快速开始

方式一：打包后的可执行文件

# Windows: TrulyMEM.exe
# Linux/macOS: TrulyMEM
chmod +x TrulyMEM
./TrulyMEM

方式二：从源码运行

git clone <repo-url>
cd TrulyMEM-TrueHumanMEM

pip install -r requirements.txt

python trulymem_entry.py

首次使用（TUI 登录）

首次运行时会检测数据库状态，引导你完成：

TUI 登录页面 — 如果是新部署或无迁移需求，直接设置账号密码
旧版自动迁移 — 如果检测到旧版 ~/.trulymem/config.json，自动引导迁移为多用户模式
首个用户自动成为管理员

登录后进入聊天界面：

按 F2 展开右侧配置面板
输入 API Key（支持 DeepSeek、OpenAI 等兼容 API）
按 Enter 保存配置
开始对话！

📌 管理员 可在右侧面板管理 Web 服务开关、修改 Web 登录凭据。 📌 普通用户 只能配置 API Key 和模型参数。

多用户系统

TrulyMEM 支持多用户隔离，每个用户拥有独立的配置和数据目录：

~/.trulymem/
├── trulymem.db          # 全局用户数据库
├── .migrated            # 旧版迁移标记
├── admin/
│   ├── config.json      # 管理员配置
│   └── admin_graph.db   # 管理员知识图谱
└── user2/
    ├── config.json      # user2 配置
    └── user2_graph.db   # user2 知识图谱

首个注册用户自动成为管理员
管理员可在 Web 设置页添加/删除用户
普通用户无法看到用户管理区域

Web 可视化界面

TUI 启动后，管理员可在右侧面板勾选「启用 Web 服务」自动启动，或手动运行：

# 手动启动 Web 服务
python web_api.py --port 4096

然后打开浏览器访问 http://localhost:4096。

首次访问 → 自动跳转至设置页，创建管理员账号 → 跳转至星图可视化页面。

Web 功能：

🌟 星图可视化浏览知识图谱
⚙ 设置页：修改密码、管理用户（管理员专属）
🔒 会话认证，多用户安全隔离

打包构建

项目支持 PyInstaller 打包为单文件可执行文件：

# Linux
bash build/build_linux.sh

# macOS
bash build/build_macos.sh

# Windows
build\build_windows.bat

# AppImage（Linux 通用打包）
bash build/build_appimage.sh

构建产出在 dist/ 目录：

文件	用途
`TrulyMEM`	TUI 主程序（含 Web 子进程启动能力）
`trulymem-web`	Web 服务独立二进制（TUI 启动子进程时自动使用）

Web 启动优先级（TUI 内）

同目录 trulymem-web 二进制（打包环境）
sys._MEIPASS/web_api.py（PyInstaller 数据文件回退）
python3 web_api.py（开发环境回退）

文档索引

详细技术文档请参阅 docs/zh/ 目录：

文档	内容
docs/zh/architecture.md	系统架构和技术设计
docs/zh/quick_start.md	完整启动指南与配置说明
docs/zh/memory.md	内部记忆工作机制
docs/zh/persona.md	人设图机制
docs/zh/working_memory.md	连续性任务处理机制
docs/zh/api.md	后端 API 接口（供扩展开发）
docs/zh/prompts.md	提示词管理模块

贡献

欢迎提交 Issue 和 Pull Request！

Fork 本仓库
创建特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
创建 Pull Request

许可证

本项目采用 GNU General Public License v3.0 (GPLv3) 许可证开源。
详见 LICENSE 文件。

特别鸣谢

Prof. Meiting Wang — 学术指导
逝水秋生白 — 架构支持
anzhitinglan — 测试资源支持
崔莉萍老师 — 理论指导
Annie — 专业指导
王梓沣、马悦华、隆梦婷 — 神经科学理论支持

6.3 KiB Raw Blame History Unescape Escape