# 监控网站需求文档

## 📋 项目信息

- **项目名称**: 龙虾舰队监控中心
- **创建日期**: 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 | 创建需求文档 | 🟡 讨论中 |