mirror of
https://gitcode.com/JianFeeeee/TrulyMEM-TrueHumanMEM.git
synced 2026-10-15 12:15:32 +00:00
904661d73f
- Add TypeScript graph memory module (GraphDatabase, MemoryService) - Add GraphMemoryTool for WaterFlow Tool interface - Add bundled-skills for graph_memory, persona, task - Remove Python code (core/, ui/, tests/, etc.) - Remove redundant docs and build files - Keep only ts/, docs/integration/, .gitignore, LICENSE
118 lines
3.3 KiB
Markdown
118 lines
3.3 KiB
Markdown
# TrulyMEM → WaterFlow 迁移计划
|
||
|
||
> ⚠️ **修改只在 TrulyMEM 的 waterflow 分支执行** ⚠️
|
||
>
|
||
> 所有代码修改仅应用于 TrulyMEM 仓库的 `waterflow` 分支，作为 WaterFlow 框架的适配版本。
|
||
|
||
---
|
||
|
||
## 迁移目标
|
||
|
||
将 TrulyMEM 的图记忆能力从 Python 迁移到 TypeScript，适配 WaterFlow 框架。
|
||
|
||
**代码位置**: `/home/program/TrulyMEM-TrueHumanMEM/` (waterflow 分支)
|
||
|
||
---
|
||
|
||
## 迁移策略
|
||
|
||
将图记忆能力作为 TypeScript 模块添加到 waterflow 分支：
|
||
|
||
| TrulyMEM (Python) | WaterFlow (TypeScript) |
|
||
|-------------------|------------------------|
|
||
| `EmbeddedGraphDB` | `GraphDatabase` |
|
||
| `GraphMemoryClient` | `MemoryService` |
|
||
| 12 个记忆工具 | `GraphMemoryTool` + Skills |
|
||
|
||
---
|
||
|
||
## 实施步骤
|
||
|
||
### Phase 1: 项目结构
|
||
|
||
- [x] 1.1 创建 `ts/` 目录 - TypeScript 项目
|
||
- [x] 1.2 创建 `package.json` - 项目配置
|
||
- [x] 1.3 创建 `tsconfig.json` - TypeScript 配置
|
||
|
||
### Phase 2: 核心库
|
||
|
||
- [x] 2.1 创建 `ts/src/runtime/core/graph_memory/types.ts` - 类型定义
|
||
- [x] 2.2 创建 `ts/src/runtime/core/graph_memory/graph_database.ts` - 图数据库
|
||
- [x] 2.3 创建 `ts/src/runtime/core/graph_memory/memory_service.ts` - 记忆服务
|
||
- [x] 2.4 创建 `ts/src/runtime/core/graph_memory/index.ts` - 模块导出
|
||
|
||
### Phase 3: Tool 接口
|
||
|
||
- [x] 3.1 创建 `ts/src/runtime/core/tools/builtin/graph_memory_tool.ts` - Tool 实现
|
||
- [x] 3.2 注册 Tool (作为独立模块导出)
|
||
|
||
### Phase 4: Skill 定义
|
||
|
||
- [x] 4.1 创建 `ts/bundled-skills/graph_memory/SKILL.md` - 主 Skill
|
||
- [x] 4.2 创建 `ts/bundled-skills/graph_memory/persona/SKILL.md` - Persona
|
||
- [x] 4.3 创建 `ts/bundled-skills/graph_memory/task/SKILL.md` - 任务管理
|
||
|
||
### Phase 5: 验证
|
||
|
||
- [x] 5.1 编译 TypeScript - 无错误
|
||
- [ ] 5.2 运行测试
|
||
|
||
---
|
||
|
||
## 目录结构 (在 TrulyMEM waterflow 分支)
|
||
|
||
```
|
||
TrulyMEM-TrueHumanMEM/
|
||
├── ts/ # TypeScript 项目 (保留)
|
||
│ ├── src/
|
||
│ │ └── runtime/core/
|
||
│ │ ├── graph_memory/ # 图记忆模块
|
||
│ │ │ ├── index.ts
|
||
│ │ │ ├── types.ts
|
||
│ │ │ ├── graph_database.ts
|
||
│ │ │ └── memory_service.ts
|
||
│ │ └── tools/
|
||
│ │ └── builtin/
|
||
│ │ └── graph_memory_tool.ts
|
||
│ ├── bundled-skills/
|
||
│ │ └── graph_memory/
|
||
│ │ ├── SKILL.md
|
||
│ │ ├── persona/SKILL.md
|
||
│ │ └── task/SKILL.md
|
||
│ ├── package.json
|
||
│ └── tsconfig.json
|
||
│
|
||
├── docs/integration/waterflow-design.md # 迁移设计文档 (保留)
|
||
│
|
||
└── (其他文件迁移后删除)
|
||
```
|
||
|
||
---
|
||
|
||
## 迁移后清理
|
||
|
||
迁移完成后，waterflow 分支将删除以下文件：
|
||
|
||
- `core/` - Python 核心代码
|
||
- `ui/` - Python UI 代码
|
||
- `tests/` - Python 测试
|
||
- `tools/` - Python 工具
|
||
- `trulymem_entry.py` - Python 入口
|
||
- `build/` - 构建脚本
|
||
- `pic/` - 图片资源 (除图标外)
|
||
- `requirements.txt` - Python 依赖
|
||
- `TrulyMEM.spec` - Python 打包配置
|
||
|
||
只保留：
|
||
- `ts/` - TypeScript 源码
|
||
- `docs/integration/waterflow-design.md` - 迁移文档
|
||
- `.gitignore`, `LICENSE`
|
||
|
||
---
|
||
|
||
## 工作追踪
|
||
|
||
工作进度记录在: `todo_progress.md`
|
||
|
||
每次修改文件前后请查看此文件并更新进度。
|