概述
ECHO_loop 是 Minecraft AI 伙伴项目的一条技术路径，采用 React Agent Loop 工程化思路实现。项目通过 LLM 编排 + Mineflayer 游戏交互 + 本地记忆存储的架构，让 AI 成为游戏中独立的玩家角色。
平台范围：仅支持 Windows 10/11 x64。
技术架构
┌─────────────────────────────────────────────────────────────┐
│ Electron 桌面应用 │
├─────────────────────────────────────────────────────────────┤
│ Vue 3 前端（对话界面 / 记忆面板 / 设置） │
├─────────────────────────────────────────────────────────────┤
│ IPC 通信层 │
├─────────────────────────────────────────────────────────────┤
│ Node.js 主进程 │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ LangChain Agent (Tool-Calling) │ │
│ └─────────────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Mineflayer 机器人控制器 │ │
│ └─────────────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 本地向量数据库（sql.js） │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
与其他 ECHO 系列的对比
| 项目 | 实现思路 |
|---|---|
| ECHO_feeling | 内驱涌现（七层认知、PAD/OCC情感、BDI意图） |
| ECHO_loop | React Agent Loop 工程化（本项目） |
| ECHO_CLAW | 上下文 + Skill 调用，类似 Claude Code CLI |
核心流程
玩家输入指令 → Mineflayer 监听 → LangChain Agent
→ 生成 JavaScript 代码块 → 本地沙箱批量执行
→ 存储记忆 → 回复玩家
开发脚本
| 命令 | 说明 |
|---|---|
npm run dev | 开发模式 |
npm run build | 编译到 out/ |
npm run typecheck | TypeScript 检查 |
npm test | 单元测试 |
npm run e2e | 轻量冒烟测试 |
npm run pack | 生成 Windows 安装包 |
当前状态
设计阶段，架构规划中。