# 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