情侣自习室（Couple Study Room）

这是一个基于 WebSocket 实时同步的情侣学习计时器网页应用，支持两个人在线同步显示各自的学习时长和状态，方便互相监督学习。

---

功能特色

• 两个独立计时器，分别代表“我”和“她”
• 实时同步计时状态（开始、暂停、重置）
• 通过 WebSocket 实现前后端即时通讯，状态变更即时广播给双方
• 支持 HTTPS 和安全的 WSS WebSocket 连接
• 界面简洁，操作直观，适合情侣或好友共同学习互相监督

---

技术栈

• 前端：HTML + CSS + JavaScript（原生）
• 后端：Node.js + ws WebSocket 库
• 反向代理：Nginx（支持 HTTPS 和 WSS）
• 服务器环境：宝塔面板部署（可选）

---

目录结构示例

/project-root
├── index.html          # 前端页面
├── server.js           # Node.js WebSocket 服务端
├── README.md           # 项目说明文档
└── /static             # 可能的静态资源文件夹（图片、样式等）

---

快速开始

1. 安装依赖

确保服务器已安装 Node.js，然后执行：

npm install ws

2. 启动 WebSocket 服务器

node server.js

服务器监听本地 8080 端口，等待客户端 WebSocket 连接。

3. 配置 Nginx 反向代理（示例）

server {
    listen 80;
    server_name your.domain.com;

    # 跳转 HTTP 到 HTTPS
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name your.domain.com;

    ssl_certificate /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

    root /path/to/your/project-root;
    index index.html;

    location /ws {
        proxy_pass http://127.0.0.1:8080/ws;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    location / {
        try_files $uri $uri/ /index.html;
    }
}

4. 打开浏览器访问

访问 https://your.domain.com 即可看到情侣自习室界面。

---

使用说明

• 点击“开始”按钮开始计时
• 点击“暂停”按钮暂停计时
• 点击“重置”按钮会将计时清零并暂停计时
• 所有操作实时同步给对方浏览器

---

常见问题

• Q：为什么计时器显示不更新？ A：请确保 WebSocket 连接成功，查看浏览器控制台和 Node.js 服务端日志。

• Q：如何部署到自己的服务器？ A：请确保服务器安装了 Node.js，启动服务后配置好 Nginx 反向代理支持 WebSocket。

---