feat: 添加 Dashboard 完整日志监控系统 v1.1.0
✨ 新增功能 - 完整的日志记录系统(6 种日志级别) - 日志配置功能(可通过 config.json 控制) - 性能监控装饰器和请求日志中间件 - 7 个管理工具脚本 - 完整的文档和使用指南 🛠️ 管理工具 - start-with-log.sh: 启动脚本(带日志) - stop-dashboard.sh: 停止脚本 - view-logs.sh: 日志查看器 - monitor-logs.sh: 实时监控工具(支持多种过滤器) - analyze-logs.sh: 日志分析工具(自动生成报告) - demo-logging.sh: 功能演示脚本 - test-logging-config.sh: 配置测试工具 📊 日志特性 - 支持 INFO/SUCCESS/WARN/ERROR/DEBUG/PERF 6 种级别 - 自动记录启动过程、API 请求、性能统计 - 缓存命中情况追踪 - 分步性能监控 - 智能过滤器 ⚙️ 配置功能 - 可控制是否启用日志(默认:true) - 可设置日志级别(默认:INFO) - 可控制文件/控制台输出 - 支持动态配置(重启生效) 📚 文档 - LOGGING_GUIDE.md: 完整使用指南 - LOGGING_CONFIG.md: 配置说明文档 - LOGGING_CONFIG_QUICK.md: 快速配置指南 - 多个中文说明文档 🔒 安全 - 添加 .gitignore 排除敏感信息 - config.json(含 Token)不提交 - 日志文件不提交 - 示例配置使用占位符 ✅ 测试 - 语法检查通过 - 功能完整性验证 - 配置控制测试通过 - 文档完整性检查 详见 CHANGELOG_v1.1.0.md Made-with: Cursor
This commit is contained in:
220
dashboard/FEATURES.md
Normal file
220
dashboard/FEATURES.md
Normal file
@@ -0,0 +1,220 @@
|
||||
# Dashboard 功能特性
|
||||
|
||||
## 📋 核心功能
|
||||
|
||||
### 1. 总览面板
|
||||
- 三列布局显示所有 Bot 状态
|
||||
- 任务分配情况和完成进度
|
||||
- 代码提交记录(最近 5 条)
|
||||
- 技能仓库内容展示
|
||||
- 定时任务状态和倒计时
|
||||
- 在线/离线状态监控
|
||||
|
||||
### 2. 实时监控
|
||||
- Leader Bot 对话流(思考过程 + 回复内容)
|
||||
- Worker Bot 执行日志
|
||||
- 系统资源监控(CPU、内存)
|
||||
- 会话详情查看
|
||||
|
||||
### 3. 数据统计 ⭐ 新增
|
||||
- API 调用次数统计
|
||||
- Token 使用量监控(输入/输出分布)
|
||||
- 会话上下文长度显示
|
||||
- 支持每个 Bot 独立统计
|
||||
|
||||
### 4. 每日记忆 ⭐ 新增
|
||||
- 今日事件记录
|
||||
- 学习笔记整理
|
||||
- 每日总结(完成的工作、遇到的问题)
|
||||
- 教训与反思(错误分析、改进措施)
|
||||
- 待跟进事项
|
||||
|
||||
## 🎨 UI/UX 特性
|
||||
|
||||
### 主题与布局
|
||||
- **暗色/亮色主题**:一键切换
|
||||
- **响应式设计**:自适应不同屏幕尺寸
|
||||
- **App Store 模式**:类 macOS 左右布局
|
||||
|
||||
### 交互优化
|
||||
- **骨架屏加载**:首屏加载动画
|
||||
- **实时刷新**:自动轮询更新数据
|
||||
- **平滑滚动**:优化滚动体验,防止穿透
|
||||
- **悬停效果**:按钮和卡片交互反馈
|
||||
|
||||
### 视觉设计
|
||||
- 现代化卡片式布局
|
||||
- 渐变色背景和警示色
|
||||
- Emoji 图标增强可读性
|
||||
- 清晰的数据可视化
|
||||
|
||||
## ⚡ 性能特性
|
||||
|
||||
### 快速加载
|
||||
- **快速状态接口**:首屏 < 1 秒加载
|
||||
- **分步加载策略**:先显示本地数据,再补全远程数据
|
||||
- **超时保护**:5 秒超时自动降级
|
||||
|
||||
### 智能缓存
|
||||
- **GitHub API 缓存**:30 秒 TTL
|
||||
- **Worker 统计缓存**:5 分钟 TTL
|
||||
- **会话数据限制**:默认返回 20 个,最多显示 10 个
|
||||
|
||||
### 优化策略
|
||||
- 限制 DOM 节点数量
|
||||
- 减少重复 API 调用
|
||||
- 按需加载数据
|
||||
|
||||
## 🔧 管理功能
|
||||
|
||||
### 服务器管理 ⭐ 新增
|
||||
- **Web 重启按钮**:右上角 🔄 一键重启
|
||||
- **守护进程**:自动监控和重启
|
||||
- **管理脚本**:`start.sh`、`stop.sh`
|
||||
- **测试脚本**:`test-restart.sh` 功能验证
|
||||
|
||||
### Bot 管理
|
||||
- 单个 Bot 重启功能
|
||||
- 详情查看(任务、日志、技能)
|
||||
- 状态实时监控
|
||||
|
||||
## 📊 数据统计详情
|
||||
|
||||
### 统计维度
|
||||
- **总览**:总调用次数、总 Token、平均每次
|
||||
- **每个 Bot**:
|
||||
- API 调用次数
|
||||
- 输入 Token(带百分比和进度条)
|
||||
- 输出 Token(带百分比和进度条)
|
||||
- 平均每次 Token 消耗
|
||||
|
||||
### 会话监控
|
||||
每个 Bot 显示:
|
||||
- 会话 ID(前 8 位)
|
||||
- 上下文长度(token 数)
|
||||
- 输入/输出 Token 分解
|
||||
- 最后活动时间(相对时间)
|
||||
- 消息数量
|
||||
|
||||
### 成本分析
|
||||
- 基于通义千问定价
|
||||
- 输入:$0.004/1K tokens
|
||||
- 输出:$0.016/1K tokens
|
||||
|
||||
## 🧠 每日记忆详情
|
||||
|
||||
### 支持的模块
|
||||
1. **📅 日期摘要**:基本信息和天气
|
||||
2. **📝 今日事件**:重要事件列表
|
||||
3. **📌 每日总结** ⭐ 新增:工作总结、问题记录、数据统计
|
||||
4. **⚠️ 教训与反思** ⭐ 新增:错误分析、经验教训、改进措施
|
||||
5. **🧠 学习笔记**:技术学习和知识点
|
||||
6. **🔄 待跟进**:未完成事项
|
||||
7. **📄 完整内容**:原始 Markdown(可展开)
|
||||
|
||||
### 历史查看
|
||||
- 日期选择器:查看任意日期的记忆
|
||||
- "今天"按钮:快速返回今日记忆
|
||||
- 自动刷新:定时更新(30 秒)
|
||||
|
||||
## 🔌 API 接口
|
||||
|
||||
### 状态接口
|
||||
- `/api/status/quick` - 快速状态(仅本地数据)
|
||||
- `/api/status` - 完整状态(含 GitHub 数据)
|
||||
- `/api/monitor` - 监控数据
|
||||
|
||||
### Bot 接口
|
||||
- `/api/bot/:id` - Bot 详情
|
||||
- `/api/bot/:id/logs` - Bot 日志
|
||||
- `/api/bot/:id/restart` - Bot 重启
|
||||
|
||||
### 统计接口
|
||||
- `/api/stats` - 所有 Bot 统计
|
||||
- `/api/stats/:botId` - 单个 Bot 统计
|
||||
- `/api/sessions/:botId` - Bot 会话列表
|
||||
|
||||
### 记忆接口
|
||||
- `/api/memory` - 所有记忆
|
||||
- `/api/memory/:botId?date=YYYY-MM-DD` - 指定日期记忆
|
||||
- `/api/memory/:botId/history?days=7` - 历史记忆
|
||||
|
||||
### 管理接口
|
||||
- `POST /api/dashboard/restart` - Dashboard 重启
|
||||
- `/api/task/:number` - 任务详情
|
||||
|
||||
## 🎯 使用场景
|
||||
|
||||
### 日常监控
|
||||
- 查看所有 Bot 运行状态
|
||||
- 监控任务完成进度
|
||||
- 查看最新代码提交
|
||||
|
||||
### 性能诊断
|
||||
- 识别占用大量 token 的会话
|
||||
- 发现异常 API 调用
|
||||
- 定位需要优化的长对话
|
||||
|
||||
### 成本分析
|
||||
- 评估每个 Bot 的 token 成本
|
||||
- 对比不同 Bot 的使用模式
|
||||
- 辅助资源分配决策
|
||||
|
||||
### 复盘总结
|
||||
- 查看每日完成的工作
|
||||
- 整理学到的经验教训
|
||||
- 记录待跟进事项
|
||||
|
||||
## 🛡️ 安全特性
|
||||
|
||||
### 数据保护
|
||||
- 本地运行,数据不上传
|
||||
- GitHub Token 本地存储
|
||||
- 敏感信息不显示在界面
|
||||
|
||||
### 访问控制
|
||||
- 默认仅 localhost 访问
|
||||
- 可配置端口和绑定地址
|
||||
|
||||
## 🔄 自动化特性
|
||||
|
||||
### 定时刷新
|
||||
- 总览面板:30 秒
|
||||
- 实时监控:5 秒
|
||||
- 数据统计:10 秒
|
||||
- 每日记忆:30 秒
|
||||
|
||||
### 智能轮询
|
||||
- Worker Bot 轮询状态显示
|
||||
- 倒计时动态更新
|
||||
- 自动检测服务恢复
|
||||
|
||||
## 📱 跨平台支持
|
||||
|
||||
### 浏览器兼容
|
||||
- Chrome 90+
|
||||
- Firefox 88+
|
||||
- Safari 14+
|
||||
- Edge 90+
|
||||
|
||||
### 操作系统
|
||||
- macOS
|
||||
- Linux
|
||||
- Windows(部分功能需调整)
|
||||
|
||||
## 🚀 扩展性
|
||||
|
||||
### 易于定制
|
||||
- 配置文件驱动
|
||||
- 模块化设计
|
||||
- 清晰的 API 接口
|
||||
|
||||
### 可扩展
|
||||
- 支持添加更多 Bot
|
||||
- 自定义主题颜色
|
||||
- 扩展统计维度
|
||||
|
||||
---
|
||||
|
||||
**最后更新**: 2026-03-10
|
||||
**当前版本**: v1.5.0
|
||||
Reference in New Issue
Block a user