flying-hero/openclaw-monitor
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit: 龙虾舰队监控中心

Browse Source
This commit is contained in:
flying-hero
2026-04-01 20:40:32 +08:00
commit d80dc01bca
10 changed files with 881 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

123
docs/API 文档.md Normal file
View File

@@ -0,0 +1,123 @@
# Django 后端 API 文档
## 📋 API 接口
### 基础 URL
```
http://localhost:8000/api
```
### 龙虾相关
#### 获取所有龙虾状态
```
GET /api/lobsters/
```
**响应示例**:
```json
[
{
"id": 1,
"name": "飞行侠",
"emoji": "🦸",
"status": "healthy",
"specialty": "主力/通用",
"port": 18789,
"container": "openclaw-instance2"
}
]
```
#### 获取单个龙虾详情
```
GET /api/lobsters/{id}/
```
### 记忆相关
#### 获取记忆日期列表
```
GET /api/lobsters/{id}/memory/dates/
```
**响应示例**:
```json
{
"dates": ["2026-04-01", "2026-03-31", "2026-03-30"]
}
```
#### 获取指定日期记忆
```
GET /api/lobsters/{id}/memory/{date}/
```
**响应示例**:
```json
{
"date": "2026-04-01",
"content": "# 2026-04-01 记忆\n\n..."
}
```
### 搜索相关
#### 全文检索
```
GET /api/lobsters/{id}/search/?q=关键词
```
**响应示例**:
```json
{
"results": [
{
"title": "文档标题",
"snippet": "包含关键词的片段...",
"url": "http://..."
}
]
}
```
### 工具相关
#### 获取工具列表
```
GET /api/tools/
```
---
## 🔧 开发说明
### 技术栈
- **后端**: Django 4.x
- **数据库**: SQLite (开发) / PostgreSQL (生产)
- **API**: Django REST Framework
### 项目结构
```
backend/
├── manage.py
├── backend/
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
├── api/ # API 接口
├── lobsters/ # 龙虾管理
├── memory/ # 记忆管理
├── search/ # 搜索功能
└── tools/ # 工具管理
```
### 运行后端
```bash
cd backend
python manage.py runserver 0.0.0.0:8000
```
---
**最后更新**: 2026-04-01

77
docs/README.md Normal file
View File

@@ -0,0 +1,77 @@
# 监控网站项目
## 📋 项目信息
- **项目名称**: 龙虾舰队监控中心
- **创建时间**: 2026-04-01
- **类型**: Web 监控面板
- **状态**: 🟢 运行中
- **访问地址**: http://localhost:18001
---
## 🎯 需求文档
### 核心需求
1. **状态监控** ⭐⭐⭐
- 显示所有龙虾的运行状态
- 健康状态用颜色区分（绿色/红色）
- 每 5 秒自动刷新
2. **基本信息展示** ⭐⭐⭐
- 龙虾名称
- 专长描述
- 监听端口
- 运行状态
3. **记忆查看** ⭐⭐
- 查看每个龙虾的 MEMORY.md
- 查看最近的每日记忆文件
### 技术需求
- 轻量级，不需要复杂框架
- 内网访问即可
- 自动刷新状态
---
## 📁 项目结构
```
monitor-dashboard/
├── frontend/ # 前端监控面板
│ └── index.html # 主页面
├── backend/ # 后端 API（Django）
│ └── memory-api/ # 记忆 API 服务
├── projects/ # 项目文档
│ └── monitoring-website/ # 本项目文档
└── archive/ # 归档
└── chat-logs/ # 聊天记录
```
---
## 🚀 服务端口
| 服务 | 端口 | 说明 |
|------|------|------|
| 监控面板 | 18001 | 前端静态页面 |
| 记忆 API | 18081 | Django 后端 API |
---
## 📝 变更记录
| 日期 | 变更内容 | 状态 |
|------|----------|------|
| 2026-04-01 | 初始部署监控面板 | ✅ |
| 2026-04-01 | 添加记忆 API | ✅ |
| 2026-04-01 | 创建项目文档 | ✅ |
---
## 📞 相关文档
- [运维手册](运维手册.md)
- [聊天记录](../../archive/chat-logs/2026-04-01.md)

127
docs/任务跟踪.md Normal file
View File

@@ -0,0 +1,127 @@
# 任务跟踪文档
## 📋 任务列表
### ✅ 已完成
#### 1. 监控面板基础功能
- [x] 龙虾状态卡片展示
- [x] 健康状态指示器
- [x] 5 秒自动刷新
- [x] 统计卡片（总数/健康/警告/异常）
#### 2. 记忆 API 服务
- [x] `/api/status` - 获取所有龙虾状态
- [x] `/api/memory/{name}` - 获取特定龙虾记忆
- [x] `/api/memory/{name}/dates` - 获取记忆日期列表
- [x] `/api/memory/{name}/{date}` - 获取指定日期记忆
- [x] 飞书应用名称获取
#### 3. Git 服务
- [x] Gitea 安装和配置
- [x] 端口设置为 18003
- [x] Git 访问指南页面
#### 4. 文档
- [x] README.md
- [x] 项目说明
- [x] 需求文档
---
### ⚠️ 有问题/待修复
#### 1. 记忆查看功能
- [ ] 点击"记忆"按钮后显示详情弹窗
- [ ] 显示长期记忆 (MEMORY.md)
- [ ] 显示每日记忆列表
- [ ] 记忆日历组件
#### 2. 龙虾详情页面
- [ ] 每只龙虾的独立详情页
- [ ] 记录关键信息（工作目录、配置、历史等）
- [ ] 任务完成记录
---
### ❌ 未开始
#### 1. 日志查看功能
- [ ] 查看各龙虾的运行日志
- [ ] 日志实时更新
#### 2. 重启功能
- [ ] 调用 Docker API 重启龙虾
- [ ] 重启确认对话框
---
## 🦞 龙虾关键信息记录
### 飞行侠 🦸
- **端口**: 18789
- **工作目录**: `/home/node/.openclaw/workspace/flying-hero`
- **飞书应用**: IT 项目推广运营平台 (`cli_a92413cfb0791bce`)
- **用户**: 北极星 ⭐
- **状态**: 健康
- **备注**: 主力龙虾，负责通用任务
### 道童 ☯️
- **端口**: 18889
- **工作目录**: `/home/node/.openclaw/workspace/daotong`
- **飞书应用**: 道德经新解 (`cli_a9439b614f38dbd2`)
- **用户**: 逍遥子
- **状态**: 健康
- **备注**: 道德经注解专用
### 墨子 🔧
- **端口**: 18689
- **工作目录**: `/home/node/.openclaw/workspace/coder`
- **飞书应用**: 未配置
- **状态**: 健康
- **备注**: 代码专家
### 织网者 🕸️
- **端口**: 18589
- **工作目录**: `/home/node/.openclaw-docker/data-web/.openclaw/workspace`
- **飞书应用**: 未配置
- **状态**: 健康
- **备注**: 网站制作
### 费曼 ⚛️
- **端口**: 18989
- **工作目录**: `/home/node/.openclaw-docker/data-physics/workspace`
- **飞书应用**: 未配置
- **状态**: 健康
- **备注**: 物理研究
### 守望者 👁️
- **端口**: 18080
- **工作目录**: `/home/phospher/openclaw-docker/monitor-dashboard/.openclaw/workspace`
- **飞书应用**: 未配置
- **状态**: 健康
- **备注**: 舰队监控（就是这个监控面板）
---
## 📝 变更记录
| 日期 | 变更内容 | 负责人 |
|------|----------|--------|
| 2026-04-01 | 初始部署监控面板 | AI |
| 2026-04-01 | 添加记忆 API | AI |
| 2026-04-01 | 安装 Gitea (端口 18003) | AI |
| 2026-04-01 | 创建项目文档 | AI |
| 2026-04-01 | 创建运维文档 | AI |
| 2026-04-01 | 创建 Git 服务文档 | AI |
---
## 🔧 服务状态
| 服务 | 端口 | 状态 |
|------|------|------|
| 监控面板前端 | 18001 | ✅ 运行中 |
| Gitea | 18003 | ✅ 运行中 |
| 记忆 API | 18081 | ✅ 运行中 |
| Git Daemon | 9418 | ✅ 运行中 |

90
docs/使用说明.md Normal file
View File

@@ -0,0 +1,90 @@
# 龙虾舰队监控中心 - 使用说明
## 🚀 快速开始
### 访问地址
- **监控面板**: http://localhost:3000
- **Gitea**: http://localhost:18003
---
## 📊 功能说明
### 1. 查看龙虾状态
1. 打开监控面板首页
2. 看到所有龙虾的状态卡片
3. 绿色 = 健康，红色 = 异常
4. 状态每 5 秒自动刷新
### 2. 查看龙虾详情
1. 点击任意龙虾卡片的"📊 详情"按钮
2. 查看该龙虾的详细信息：
- 运行状态
- 监听端口
- 容器名称
- 工作目录
- 飞书应用信息
### 3. 查看记忆
1. 点击龙虾卡片的"🧠 记忆"按钮
2. 进入记忆页面
3. 使用日历选择日期
4. 点击有标记的日期查看当日记忆
### 4. 搜索文档
1. 在龙虾详情页找到搜索框
2. 输入关键词
3. 点击"🔍 搜索"
4. 查看搜索结果
---
## 🛠️ 工具使用
### Git 版本控制
#### 访问方式
- **Web 界面**: http://localhost:18003
- **Git 协议**: `git://127.0.0.1:9418/monitor-dashboard.git`
- **HTTP 协议**: `http://localhost:18003/monitor-dashboard.git`
#### 使用方法
**克隆仓库**:
```bash
git clone http://localhost:18003/monitor-dashboard.git
```
**提交更改**:
```bash
cd monitor-dashboard
git add .
git commit -m "修改说明"
git push origin master
```
**查看历史**:
```bash
git log --oneline
```
---
## ❓ 常见问题
### Q: 状态显示异常怎么办？
A: 检查龙虾容器是否正常运行：`docker ps | grep openclaw`
### Q: 记忆加载失败？
A: 检查记忆 API 服务：`curl http://localhost:8000/api/lobsters/`
### Q: Git 推送失败？
A: 检查 Git 服务状态：`ps aux | grep gitea`
---
**最后更新**: 2026-04-01

79
docs/功能需求.md Normal file
View File

@@ -0,0 +1,79 @@
# 监控网站功能需求
## 📋 项目信息
- **项目名称**: 龙虾舰队监控中心
- **创建日期**: 2026-04-01
- **当前状态**: 🟡 需求讨论中
---
## 🎯 你需要什么功能？
### 请用✔️勾选你需要的功能
#### 1. 龙虾状态监控
- [ ] 显示所有龙虾（飞行侠、道童、墨子等）
- [ ] 每个龙虾显示运行状态（健康/异常）
- [ ] 状态用颜色区分（绿色=正常，红色=异常）
- [ ] 自动刷新状态
#### 2. 龙虾基本信息
- [ ] 龙虾名称
- [ ] 龙虾的专长（做什么的）
- [ ] 监听端口
- [ ] 当前状态
#### 3. 记忆查看
- [ ] 点击龙虾可以查看它的记忆
- [ ] 查看长期记忆（MEMORY.md）
- [ ] 查看每日记忆（最近记录了什么）
- [ ] 按日期查看历史记忆
#### 4. 其他功能
- [ ] 重启龙虾
- [ ] 查看龙虾日志
- [ ] 查看龙虾的详细信息页
- [ ] 显示飞书应用名称
- [ ] 记忆日历（按日历查看记忆）
- [ ] 技能列表展示
---
## ❓ 几个问题
### 问题 1
你现在打开监控页面，最常用的是什么功能？
（比如：看状态、查记忆、其他）
### 问题 2
昨天的监控页面有什么功能，是今天没有的？
（请具体描述，比如"点击卡片后能看到 xxx"）
### 问题 3
现在的页面有什么功能，是你觉得没用/多余的？
（比如：Gitea、Git 指南、其他）
### 问题 4
你希望监控页面长成什么样？
（简单描述即可，比如"只要能看到状态和记忆就行"）
---
## 📝 你来填写
**我需要的功能是：**
1. _________________
2. _________________
3. _________________
**我不需要的功能是：**
1. _________________
2. _________________
---
**确认人**: 北极星 ⭐
**日期**: ___________

69
docs/工具列表.md Normal file
View File

@@ -0,0 +1,69 @@
# 工具列表
## 🛠️ 已部署工具
### 1. Git 版本控制服务
**状态**: 🟢 运行中
#### 服务信息
| 服务 | 端口 | 访问地址 |
|------|------|----------|
| Gitea Web | 18003 | http://localhost:18003 |
| Git Daemon | 9418 | git://127.0.0.1:9418 |
#### 仓库列表
- **monitor-dashboard.git** - 监控网站代码仓库
#### 使用方法
**克隆仓库**:
```bash
# HTTP 方式（推荐）
git clone http://localhost:18003/monitor-dashboard.git
# Git 协议方式
git clone git://127.0.0.1:9418/monitor-dashboard.git
```
**提交代码**:
```bash
cd monitor-dashboard
git add .
git commit -m "修改说明"
git push origin master
```
**查看状态**:
```bash
git status
git log --oneline
```
#### 管理命令
**启动 Gitea**:
```bash
cd /home/phospher/gitea
./gitea web
```
**启动 Git Daemon**:
```bash
cd /home/phospher/git-repos
git daemon --reuseaddr --base-path=/home/phospher/git-repos \
--export-all --enable=receive-pack --listen=0.0.0.0 --port=9418 \
/home/phospher/git-repos &
```
---
## 📋 待部署工具
- [ ] CI/CD 工具
- [ ] 日志管理工具
- [ ] 监控告警工具
---
**最后更新**: 2026-04-01

170
docs/需求文档.md Normal file
View File

@@ -0,0 +1,170 @@
# 监控网站需求文档
## 📋 项目信息
- **项目名称**: 龙虾舰队监控中心
- **创建日期**: 2026-04-01
- **当前状态**: 🟡 需求讨论中
- **访问地址**: http://localhost:18001
---
## 🎯 核心需求（请确认）
### 1. 状态监控 ⭐⭐⭐
- [ ] 显示所有龙虾的运行状态
- [ ] 健康状态用颜色区分（绿色=健康，红色=异常）
- [ ] 每 5 秒自动刷新
- [ ] 统计卡片（总数/健康/警告/异常）
### 2. 基本信息展示 ⭐⭐⭐
- [ ] 龙虾名称
- [ ] 专长描述
- [ ] 监听端口
- [ ] 运行状态
### 3. 记忆查看 ⭐⭐
- [ ] 点击龙虾卡片查看详情
- [ ] 查看每个龙虾的 MEMORY.md
- [ ] 查看最近的每日记忆文件
- [ ] 支持按日期查看记忆
---
## 🦞 龙虾列表（请确认）
| 龙虾 | 端口 | 专长 | 飞书应用 | 状态 |
|------|------|------|----------|------|
| 飞行侠 | 18789 | 主力/通用 | IT 项目推广运营平台 | ✅ |
| 道童 | 18889 | 道德经注解 | 道德经新解 | ✅ |
| 墨子 | 18689 | 代码专家 | - | ✅ |
| 织网者 | 18589 | 网站制作 | - | ✅ |
| 费曼 | 18989 | 物理研究 | - | ✅ |
| 守望者 | 18080 | 舰队监控 | - | ✅ |
---
## 📁 功能需求（请确认）
### 必需功能
- [ ] 龙虾状态卡片展示
- [ ] 点击卡片查看记忆详情
- [ ] 记忆弹窗/详情页
- [ ] 长期记忆 (MEMORY.md) 显示
- [ ] 每日记忆列表显示
### 可选功能（需要确认是否需要）
- [ ] 记忆日历组件
- [ ] 技能列表显示
- [ ] 飞书应用名称显示
- [ ] 龙虾详情独立页面
- [ ] 重启龙虾按钮
- [ ] 查看日志按钮
### 不需要功能（已确认移除）
- [x] Gitea Git 服务（独立项目）
- [x] Git 访问指南页面
- [x] 复杂的动画效果
---
## 🎨 界面需求（请确认）
### 布局
- [ ] 顶部：标题 + 统计卡片
- [ ] 中部：龙虾卡片网格
- [ ] 底部：更新时间
### 卡片设计
- [ ] 龙虾名称 + Emoji
- [ ] 状态指示器（颜色圆点）
- [ ] 信息行：专长、端口、状态
- [ ] 操作按钮：记忆、日志、重启
### 弹窗/详情页
- [ ] 龙虾名称标题
- [ ] 长期记忆内容
- [ ] 每日记忆列表
- [ ] 关闭按钮
---
## 🔧 技术需求（请确认）
### 前端
- [ ] 纯 HTML/CSS/JavaScript
- [ ] 不需要复杂框架
- [ ] 自动刷新（5 秒）
- [ ] 内网访问
### 后端 API
- [ ] Django REST API
- [ ] 端口：18081
- [ ] 接口：
- `GET /api/status` - 获取所有龙虾状态
- `GET /api/memory/{name}` - 获取特定龙虾记忆
- `GET /api/memory/{name}/dates` - 获取记忆日期列表
- `GET /api/memory/{name}/{date}` - 获取指定日期记忆
### 服务管理
- [ ] 前端服务：18001
- [ ] 记忆 API: 18081
- [ ] 日志文件：`/tmp/frontend.log`, `/tmp/memory-api.log`
---
## 📝 待确认问题
### 问题 1: Gitea 服务
**现状**: 已安装 Gitea（端口 18003）
**问题**: 是否需要保留？
- [ ] 保留（作为独立项目）
- [ ] 移除（只保留监控功能）
### 问题 2: 记忆查看方式
**现状**: 点击卡片打开弹窗
**问题**: 是否需要独立详情页？
- [ ] 弹窗（当前方式）
- [ ] 独立页面
- [ ] 两者都要
### 问题 3: 龙虾详情
**现状**: 已创建飞行侠详情页
**问题**: 是否需要为每只龙虾创建独立页面？
- [ ] 需要
- [ ] 不需要（弹窗即可）
### 问题 4: 飞书应用信息
**现状**: 显示飞书应用名称
**问题**: 是否需要显示？
- [ ] 显示
- [ ] 不显示（超出原始需求）
---
## 📊 当前问题（需要修复）
- [ ] 记忆功能可能无法正常使用
- [ ] 页面过于复杂
- [ ] 添加了超出需求的功能
---
## ✅ 确认签字
**待确认**:
- [ ] 核心需求确认
- [ ] 功能列表确认
- [ ] 界面设计确认
- [ ] 技术方案确认
**确认人**: 北极星 ⭐
**确认日期**: ___________
---
## 📝 变更记录
| 日期 | 变更内容 | 状态 |
|------|----------|------|
| 2026-04-01 | 创建需求文档 | 🟡 讨论中 |

131
docs/需求规格说明书.md Normal file
View File

@@ -0,0 +1,131 @@
# 龙虾舰队监控中心 - 需求规格说明书
## 📋 项目信息
- **项目名称**: 龙虾舰队监控中心
- **创建日期**: 2026-04-01
- **技术栈**: React + Django
- **状态**: 🟡 开发中
---
## 🎯 功能需求
### 1. 龙虾监控功能
#### 1.1 运行状态监控
- 显示所有龙虾的运行状态（健康/异常/离线）
- 实时刷新状态（每 5 秒）
- 状态指示器（颜色区分）
#### 1.2 关键信息展示
- 龙虾名称和 Emoji
- 专长描述
- 监听端口
- 容器名称
- 工作目录
- 飞书应用信息（如配置）
- 运行时长
- CPU/内存使用率（可选）
#### 1.3 日历查看每日记忆
- 日历组件展示
- 有记忆的日期标记
- 点击日期查看当日记忆
- 支持月份切换
#### 1.4 全文检索
- 搜索龙虾工作生成的文档
- 支持关键词搜索
- 搜索结果高亮
- 按时间排序
### 2. 工具列表
#### 2.1 Git 服务
- Git 仓库列表
- 仓库访问方式（HTTP/Git 协议）
- 使用指南
- 快速复制命令
#### 2.2 其他工具（未来扩展）
- 待添加
### 3. 使用说明
#### 3.1 监控面板使用
- 如何查看龙虾状态
- 如何查看记忆
- 如何使用搜索
#### 3.2 快速入门
- 访问地址
- 基本操作
---
## 📁 项目结构
```
monitoring-website/
├── frontend/ # React 前端
│ ├── src/
│ │ ├── components/ # 组件
│ │ │ ├── LobsterCard/
│ │ │ ├── MemoryCalendar/
│ │ │ ├── SearchBox/
│ │ │ └── ToolList/
│ │ ├── pages/
│ │ │ ├── Dashboard/
│ │ │ ├── LobsterDetail/
│ │ │ └── Tools/
│ │ ├── api/ # API 调用
│ │ └── utils/ # 工具函数
│ └── package.json
│
├── backend/ # Django 后端
│ ├── api/ # API 接口
│ ├── models/ # 数据模型
│ └── settings.py
│
└── docs/ # 文档
├── 需求文档.md
├── 使用说明.md
└── 工具列表.md
```
---
## 🚀 开发计划
### 阶段 1: 基础框架
- [ ] Django 后端 API
- [ ] React 前端框架
- [ ] 龙虾状态接口
### 阶段 2: 核心功能
- [ ] 龙虾状态监控
- [ ] 记忆日历组件
- [ ] 记忆查看功能
### 阶段 3: 高级功能
- [ ] 全文检索
- [ ] 工具列表页面
- [ ] 使用说明文档
---
## 📊 龙虾列表
| 龙虾 | 端口 | 专长 | 状态 |
|------|------|------|------|
| 飞行侠 | 18789 | 主力/通用 | 🟢 |
| 道童 | 18889 | 道德经注解 | 🟢 |
| 墨子 | 18689 | 代码专家 | 🟢 |
| 织网者 | 18589 | 网站制作 | 🟢 |
| 费曼 | 18989 | 物理研究 | 🟢 |
| 守望者 | 18080 | 舰队监控 | 🟢 |
---
**最后更新**: 2026-04-01 19:48