feat: migrate to TypeScript for WaterFlow framework

- 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
2026-10-15 12:15:32 +00:00 · 2026-04-15 15:45:12 +08:00
parent 43172e257a
commit 904661d73f
98 changed files with 2584 additions and 9701 deletions
--- a/.sisyphus/plans/migration_plan.md
+++ b/.sisyphus/plans/migration_plan.md
@ -0,0 +1,117 @@
+# 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`
+
+每次修改文件前后请查看此文件并更新进度。
--- a/.sisyphus/plans/todo_progress.md
+++ b/.sisyphus/plans/todo_progress.md
@ -0,0 +1,81 @@
+# 迁移工作进度追踪
+
+> ⚠️ **修改只在 TrulyMEM 的 waterflow 分支执行** ⚠️
+
+---
+
+## 当前状态
+
+- **开始时间**: 2026-04-15
+- **当前任务**: 迁移完成，等待测试
+- **最后更新**: 2026-04-15
+- **状态**: TypeScript 编译通过
+
+---
+
+## Phase 完成状态
+
+### Phase 1: 项目结构
+
+| 任务 | 状态 | 备注 |
+|------|------|------|
+| 1.1 ts/ 目录 | ✅ done | |
+| 1.2 package.json | ✅ done | |
+| 1.3 tsconfig.json | ✅ done | |
+
+### Phase 2: 核心库
+
+| 任务 | 状态 | 备注 |
+|------|------|------|
+| 2.1 types.ts | ✅ done | |
+| 2.2 graph_database.ts | ✅ done | |
+| 2.3 memory_service.ts | ✅ done | |
+| 2.4 index.ts | ✅ done | |
+
+### Phase 3: Tool 接口
+
+| 任务 | 状态 | 备注 |
+|------|------|------|
+| 3.1 graph_memory_tool.ts | ✅ done | |
+| 3.2 tool_interface.ts | ✅ done | |
+
+### Phase 4: Skill 定义
+
+| 任务 | 状态 | 备注 |
+|------|------|------|
+| 4.1 SKILL.md (主) | ✅ done | |
+| 4.2 persona/SKILL.md | ✅ done | |
+| 4.3 task/SKILL.md | ✅ done | |
+
+### Phase 5: 验证
+
+| 任务 | 状态 | 备注 |
+|------|------|------|
+| 5.1 编译 | ✅ done | TypeScript 编译通过 |
+| 5.2 测试 | ⏳ pending | |
+
+---
+
+## 创建的文件
+
+| 文件 | 说明 |
+|------|------|
+| `ts/package.json` | 项目配置 |
+| `ts/tsconfig.json` | TypeScript 配置 |
+| `ts/src/runtime/core/graph_memory/types.ts` | 类型定义 |
+| `ts/src/runtime/core/graph_memory/graph_database.ts` | 图数据库 |
+| `ts/src/runtime/core/graph_memory/memory_service.ts` | 记忆服务 |
+| `ts/src/runtime/core/graph_memory/index.ts` | 模块导出 |
+| `ts/src/runtime/core/tools/tool_interface.ts` | Tool 接口 |
+| `ts/src/runtime/core/tools/builtin/graph_memory_tool.ts` | GraphMemory Tool |
+| `ts/bundled-skills/graph_memory/SKILL.md` | 主 Skill |
+| `ts/bundled-skills/graph_memory/persona/SKILL.md` | Persona Skill |
+| `ts/bundled-skills/graph_memory/task/SKILL.md` | Task Skill |
+
+---
+
+## 说明
+
+- 每次修改文件前后更新此文件
+- 记录每次修改的文件和操作
+- 方便意外终止后恢复任务