# 飞书多维表格实时监控 - 使用说明

## 文件说明

| 文件 | 说明 |
|------|------|
| `server.py` | HTTP 服务器，代理飞书 API 请求（Python 标准库） |
| `admin.html` | 管理后台页面（HTML 结构） |
| `style.css` | 样式表（暗色主题） |
| `app.js` | 前端业务逻辑（数据加载、渲染、交互） |
| `feishu_config.json` | 飞书应用配置（app_id 和 app_secret） |
| `.gitignore` | Git 忽略规则（保护 feishu_config.json 不被提交） |
| `启动服务.bat` | Windows 一键启动脚本 |
| `start.sh` | Linux 一键启动脚本 |
| `诊断工具.bat` | Windows 诊断工具 |
| `diagnose.sh` | Linux 诊断工具 |

---

## 快速启动

### Windows

1. 确保 `feishu_config.json` 已正确配置
2. 双击 `启动服务.bat`
3. 打开浏览器访问：`http://localhost:8080/admin.html`

### Linux

```bash
chmod +x start.sh
bash start.sh
```

---

## 局域网访问

1. 查看本机 IP：
   - Windows: `ipconfig`
   - Linux: `ifconfig` 或 `hostname -I`
2. 其他电脑访问：`http://你的IP:8080/admin.html`

---

## 功能说明

### 注册实时监控
- 整体总览：运行数、完成数、失败数、未开始数、进度条
- 按设备查看：成功率、失败率、异常率、状态分布
- 异常详情表：列出运行异常的记录

### 提取店铺
- 可提取店铺 / 已提取店铺：表格展示、搜索过滤、分页浏览

### 自动刷新
- 监控页面每 3 秒自动刷新
- 提取店铺页面每 30 秒自动刷新
- 取消勾选"自动刷新"可停止

---

## 常见问题

### 1. 端口 8080 被占用

**解决方法**：
- 方法 A：关闭占用端口的程序
  ```bash
  # Windows
  netstat -ano | findstr :8080
  taskkill /PID <PID> /F
  
  # Linux
  ss -tlnp | grep 8080
  kill <PID>
  ```
- 方法 B：修改 `server.py` 中的 `PORT = 8080` 改为其他端口

### 2. feishu_config.json 未找到

确认 `feishu_config.json` 文件存在于项目目录，格式如下：
```json
{"app_id": "你的app_id", "app_secret": "你的app_secret"}
```

### 3. 页面打开后没有数据

**可能原因**：
- `feishu_config.json` 配置不正确
- 飞书 API 权限不足或频次限制
- 网络问题

**解决方法**：
1. 运行诊断工具排查（`诊断工具.bat` 或 `bash diagnose.sh`）
2. 查看命令行输出的错误信息

---

## 停止服务器

在命令行窗口按 `Ctrl + C`。

---

## 部署到 Linux 服务器（Debian 11）

1. 安装 Python 3：
   ```bash
   sudo apt update && sudo apt install python3 -y
   ```
2. 将整个项目目录上传到服务器
3. 配置 `feishu_config.json`
4. 运行 `bash start.sh`
5. （可选）配置 systemd 服务实现开机自启
6. （可选）配置 Nginx 反向代理

---

## 安全提示

- `feishu_config.json` 包含敏感凭据，已通过 `.gitignore` 排除
- 请勿将 `feishu_config.json` 提交到版本控制系统
- 部署到服务器时，建议设置文件权限：`chmod 600 feishu_config.json`