4.0 KiB
4.0 KiB
监控网站需求文档
📋 项目信息
- 项目名称: 龙虾舰队监控中心
- 创建日期: 2026-04-01
- 当前状态: 🟡 需求讨论中
- 访问地址: http://localhost:18001
🎯 核心需求（请确认）
1. 状态监控 ⭐⭐⭐
- 显示所有龙虾的运行状态
- 健康状态用颜色区分（绿色=健康，红色=异常）
- 每 5 秒自动刷新
- 统计卡片（总数/健康/警告/异常）
2. 基本信息展示 ⭐⭐⭐
- 龙虾名称
- 专长描述
- 监听端口
- 运行状态
3. 记忆查看 ⭐⭐
- 点击龙虾卡片查看详情
- 查看每个龙虾的 MEMORY.md
- 查看最近的每日记忆文件
- 支持按日期查看记忆
🦞 龙虾列表（请确认）
| 龙虾 | 端口 | 专长 | 飞书应用 | 状态 |
|---|---|---|---|---|
| 飞行侠 | 18789 | 主力/通用 | IT 项目推广运营平台 | ✅ |
| 道童 | 18889 | 道德经注解 | 道德经新解 | ✅ |
| 墨子 | 18689 | 代码专家 | - | ✅ |
| 织网者 | 18589 | 网站制作 | - | ✅ |
| 费曼 | 18989 | 物理研究 | - | ✅ |
| 守望者 | 18080 | 舰队监控 | - | ✅ |
📁 功能需求（请确认）
必需功能
- 龙虾状态卡片展示
- 点击卡片查看记忆详情
- 记忆弹窗/详情页
- 长期记忆 (MEMORY.md) 显示
- 每日记忆列表显示
可选功能（需要确认是否需要）
- 记忆日历组件
- 技能列表显示
- 飞书应用名称显示
- 龙虾详情独立页面
- 重启龙虾按钮
- 查看日志按钮
不需要功能（已确认移除）
- Gitea Git 服务（独立项目）
- Git 访问指南页面
- 复杂的动画效果
🎨 界面需求（请确认）
布局
- 顶部：标题 + 统计卡片
- 中部：龙虾卡片网格
- 底部：更新时间
卡片设计
- 龙虾名称 + 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 | 创建需求文档 | 🟡 讨论中 |