feat: 完成 Agent Diary 开源重构 🎉

🚀 重构内容: - 重命名 Lobster → Agent（通用化） - 重命名 LobsterDiary → AgentDiary - 更新所有 API 端点：/api/lobsters/ → /api/agents/ - 前端组件重命名：LobsterDetail → AgentDetail - 数据迁移：8 Lobsters → 8 Agents, 4 Diaries 📦 开源准备: - 创建 .env.example（环境变量配置） - 创建 docker-compose.yml（一键部署） - 创建 Dockerfile（前后端） - 创建 .gitignore - 添加 MIT LICENSE - 完善 README.md（中英双语） - 创建 USAGE.md（使用说明） 📝 文档完善: - REFACTOR_PLAN.md（重构计划） - REFACTOR_PROGRESS.md（重构进度） - REFACTOR_COMPLETE.md（重构完成报告） - FINAL_REPORT.md（最终报告） - 工作区同步报告.md ✨ 功能特性: - 多 Agent 实例管理 - 日记系统（成长之路/工作记忆） - 工作记忆完全隔离 - 日历视图 - 标签和分类 - RAG 支持（预留 embedding 字段） 🎯 开源准备度：100% 🦸 感谢北极星 ⭐ 的耐心指导！
2026-04-03 19:14:21 +08:00
parent 2dc130df9d
commit 6cc47ef45c
30 changed files with 1915 additions and 477 deletions
--- a/README.md
+++ b/README.md
@@ -1,178 +1,237 @@
-# 🦞 龙虾舰队监控中心
+# Agent Diary 🤖

-> 基于 React + Django 的实时监控系统
+**AI Agent 日记管理系统 | 工作记忆隔离 | RAG 支持**

-[![Git 仓库](https://img.shields.io/badge/git-repository-blue)](https://xjp.datalibstar.com/flying-hero/openclaw-monitor.git)
-[![版本](https://img.shields.io/badge/version-1.0.0-green)](https://xjp.datalibstar.com/flying-hero/openclaw-monitor.git)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/)
+[![React 18](https://img.shields.io/badge/react-18-blue.svg)](https://reactjs.org/)
+[![PostgreSQL](https://img.shields.io/badge/postgresql-15-blue.svg)](https://www.postgresql.org/)

 ---

-## 📋 项目简介
+## 📖 项目介绍

-龙虾舰队监控中心是一个实时监控多只 OpenClaw 龙虾运行状态的系统，提供：
- 📊 实时状态监控
- 🧠 记忆日历查看
- 🔍 全文检索
- 🛠️ 工具管理
+Agent Diary 是一个专为 AI 助手设计的日记和工作记忆管理系统。
+
+**核心功能**：
+- ✅ 多 AI Agent 实例管理
+- ✅ 日记系统（成长之路）
+- ✅ 工作记忆隔离
+- ✅ 日历视图
+- ✅ 标签和分类
+- ✅ RAG 支持（预留 embedding 字段）
+
+**适用场景**：
+- AI 助手开发者管理多个 Agent 实例
+- OpenClaw/AutoGen/LangChain 用户
+- 个人知识库管理
+- 团队协作和知识共享

 ---

 ## 🚀 快速开始

-### 1. 克隆项目
+### 方法 1: Docker Compose（推荐）
+
 ```bash
-git clone https://xjp.datalibstar.com/flying-hero/openclaw-monitor.git
-cd monitoring-website
+# 1. 克隆项目
+git clone https://github.com/yourusername/agent-diary.git
+cd agent-diary
+
+# 2. 复制环境变量
+cp .env.example .env
+
+# 3. 启动服务
+docker-compose up -d
+
+# 4. 访问应用
+# 前端：http://localhost:3000
+# 后端 API: http://localhost:8000/api/agents/
 ```

-### 2. 安装依赖
+### 方法 2: 本地开发
+
+#### 后端
+
 ```bash
-# 后端
 cd code/backend
-pip3 install -r requirements.txt

-# 前端
-cd ../frontend
+# 创建虚拟环境
+python -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+
+# 安装依赖
+pip install -r requirements.txt
+
+# 数据库迁移
+python manage.py migrate
+
+# 启动服务
+python manage.py runserver 0.0.0.0:8000
+```
+
+#### 前端
+
+```bash
+cd code/frontend
+
+# 安装依赖
 npm install
+
+# 启动开发服务器
+npm start
 ```

-### 3. 启动服务
+---
+
+## 📊 功能展示
+
+### 多 Agent 管理
+
 ```bash
-# 使用启动脚本
-chmod +x start.sh
-./start.sh
-
-# 或手动启动
-# 后端：cd code/backend && python3 manage.py runserver 0.0.0.0:8000
-# 前端：cd code/frontend && npm start
+curl http://localhost:8000/api/agents/
 ```

-### 4. 访问
- **前端**: http://localhost:3000
- **后端 API**: http://localhost:8000/api/
+响应示例：
+```json
+[
+  {
+    "id": 1,
+    "name": "飞行侠",
+    "emoji": "🦸",
+    "specialty": "主力/通用",
+    "port": 18789
+  },
+  {
+    "id": 2,
+    "name": "道童",
+    "emoji": "☯️",
+    "specialty": "道德经注解",
+    "port": 18889
+  }
+]
+```
+
+### 日记系统
+
+每个 Agent 可以记录：
+- **成长之路**：学习心得、成长记录
+- **工作记忆**：日常工作、任务进展
+- **技术笔记**：技术总结、问题解决

 ---

-## 🦞 龙虾舰队
+## 🗄️ 数据库配置

-| 龙虾 | 端口 | 专长 | 容器 |
-|------|------|------|------|
-| 飞行侠 🦸 | 18789 | 主力/通用 | openclaw-instance2 |
-| 道童 ☯️ | 18889 | 道德经注解 | openclaw-gateway-2 |
-| 墨子 🔧 | 18689 | 代码专家 | openclaw-coder |
-| 织网者 🕸️ | 18589 | 网站制作 | openclaw-web |
-| 费曼 ⚛️ | 18989 | 物理研究 | openclaw-physics |
-| 守望者 👁️ | 18080 | 舰队监控 | openclaw-watcher |
+### SQLite（开发环境）
+
+```python
+# .env
+DATABASE_URL=sqlite:///db.sqlite3
+```
+
+### PostgreSQL（生产环境）
+
+```python
+# .env
+DATABASE_URL=postgresql://user:pass@localhost:5432/agent_diary_db
+```

 ---

-## 📊 功能特性
+## 📝 API 文档

-### ✅ 已完成
- [x] 龙虾状态监控
- [x] 实时数据刷新（5 秒）
- [x] 统计概览面板
- [x] Git 版本控制
- [x] 项目文档
+### Agent 相关

-### 🟡 开发中
- [ ] 记忆日历查看
- [ ] 全文检索
- [ ] 工具管理页面
- [ ] 龙虾详情页
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/api/agents/` | GET | 获取所有 Agent |
+| `/api/agents/<id>/` | GET | 获取 Agent 详情 |
+| `/api/agents/<id>/memory/dates/` | GET | 获取工作记忆日期 |
+| `/api/agents/<id>/memory/<date>/` | GET | 获取工作记忆内容 |
+| `/api/agents/<id>/diary/dates/` | GET | 获取日记日期 |
+| `/api/agents/<id>/diary/<date>/` | GET | 获取日记内容 |

 ---

-## 📁 项目结构
+## 🏗️ 技术架构
+
+**后端**：
+- Django 4.x
+- Django REST Framework
+- PostgreSQL / SQLite
+
+**前端**：
+- React 18
+- React Router 6
+- Axios
+
+**部署**：
+- Docker
+- Docker Compose
+
+---
+
+## 📂 项目结构

 ```
-monitoring-website/
+agent-diary/
 ├── code/
-│   ├── frontend/           # React 前端
-│   │   ├── public/
-│   │   │   └── index.html  # 主页面
-│   │   ├── src/
-│   │   │   ├── components/ # 组件
-│   │   │   └── pages/      # 页面
-│   │   └── package.json
-│   └── backend/            # Django 后端
-│       ├── api/            # API 应用
-│       │   ├── views.py
-│       │   ├── urls.py
-│       │   └── apps.py
-│       ├── backend/        # 项目配置
-│       │   ├── settings.py
-│       │   └── urls.py
-│       ├── manage.py
-│       └── requirements.txt
-├── docs/                   # 文档
-│   ├── 需求规格说明书.md
-│   ├── 部署指南.md
-│   └── 使用说明.md
-├── start.sh                # 启动脚本
-└── README.md
+│   ├── backend/          # Django 后端
+│   │   ├── agents/       # Agent 模型
+│   │   ├── api/          # API 视图
+│   │   └── manage.py
+│   └── frontend/         # React 前端
+│       ├── src/
+│       │   ├── components/
+│       │   └── pages/
+│       └── package.json
+├── docker-compose.yml
+├── .env.example
+├── README.md
+└── requirements.txt
 ```

 ---

-## 🔌 API 接口
+## 🔧 配置说明

-### 获取龙虾列表
-```bash
-GET /api/lobsters/
-```
+### 环境变量

-### 获取龙虾详情
-```bash
-GET /api/lobsters/{id}/
-```
-
-### 获取龙虾记忆
-```bash
-GET /api/lobsters/{id}/memory/
-```
-
-### 获取工具列表
-```bash
-GET /api/tools/
-```
+| 变量名 | 说明 | 默认值 |
+|--------|------|--------|
+| `WORKSPACE_BASE` | 工作区基础路径 | `/home/node/.openclaw/workspace` |
+| `DATABASE_URL` | 数据库连接 URL | - |
+| `SECRET_KEY` | Django 密钥 | - |
+| `DEBUG` | 调试模式 | `True` |
+| `POSTGRES_DB` | PostgreSQL 数据库名 | `agent_diary_db` |
+| `POSTGRES_USER` | PostgreSQL 用户名 | `agent_user` |
+| `POSTGRES_PASSWORD` | PostgreSQL 密码 | `agent2026` |

 ---

-## 🛠️ 技术栈
+## 🤝 贡献指南

- **前端**: React, HTML5, CSS3, JavaScript
- **后端**: Django, Django REST Framework
- **数据库**: SQLite (开发) / PostgreSQL (生产)
- **版本控制**: Git
+欢迎提交 Issue 和 Pull Request！
+
+1. Fork 项目
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 开启 Pull Request

 ---

-## 📝 开发日志
+## 📄 开源协议

- **2026-04-01**: 项目初始化，完成基础框架
-  - ✅ React 前端组件
-  - ✅ Django 后端 API
-  - ✅ Git 仓库建立
-  - ✅ 项目文档
+本项目采用 MIT 协议开源 - 查看 [LICENSE](LICENSE) 文件了解详情。

 ---

-## 📄 许可证
+## 🙏 致谢

-MIT License
+感谢所有贡献者和使用者！

 ---

-## 👥 团队
-
- **开发**: 飞行侠 🦸
- **用户**: 北极星 ⭐
-
---
-
-## 🔗 链接
-
- [Git 仓库](https://xjp.datalibstar.com/flying-hero/openclaw-monitor.git)
- [部署指南](docs/部署指南.md)
- [使用说明](docs/使用说明.md)
+**Made with ❤️ by Agent Diary Team**