# 工商银行黄金价格监控与推送脚本

这是一个基于 Node.js 的自动化脚本，用于定时监控中国工商银行（ICBC）官网的黄金递延（T+D）价格，并通过 ServerChan（方糖服务）将价格提醒推送至微信。脚本支持价格突破报警、多维度趋势分析、防骚扰冷却机制以及收盘价记录等功能。

## ✨ 核心功能

*   **定时抓取**：自动请求工商银行黄金价格页面，并使用 `axios + cheerio` 解析实时价格（无需浏览器）。
*   **智能推送**：
    *   **变化触发**：当价格在设定时间窗口内波动超过阈值时推送。
    *   **特殊价位**：可设置一组目标价位，当价格“穿过”任一目标价时立即推送特殊提醒。
    *   **收盘推送**：在每日收盘时段（可配置）自动记录并推送收盘价。
*   **趋势分析**：自动计算并报告一小时变化量、七日变化量，以及七日、十四日、二十八日的价格趋势（上涨/下跌/持平）。
*   **灵活配置**：所有运行参数（如采样间隔、价格阈值、禁用时段、冷却时间等）均在脚本内 `CONFIG` 对象中集中管理，易于修改。
*   **数据持久化**：自动将价格历史、收盘价、开盘价及推送状态保存至本地 JSON 文件。
*   **多Key推送**：支持配置多个 ServerChan SendKey，向多个微信终端同时推送消息。

## 🚀 快速开始

### 1. 获取项目
```bash
git clone http://43.135.34.133:53000/LiuEnder/goldworm_js
cd gold-price-monitor
```

### 2. 安装项目依赖
```bash
npm install
```
此步骤将安装 `axios`、`cheerio` 和 `serverchan-sdk`。

### 3. 配置环境变量
脚本运行需要一个关键环境变量：

1.  **ServerChan 推送密钥 (`PUSH_KEYT`)**：
    *   前往 https://sc3.ft07.com/ 登录并获取您的 `SendKey`。
    *   **设置环境变量**（以下为Linux/macOS示例，永久生效请添加到 `~/.bashrc` 或 `~/.zshrc`）：
    ```bash
    export PUSH_KEYT="SCTxxxxxx...你的SendKey"
    # 如果需要配置多个Key，用分号(;)分隔
    # export PUSH_KEYT="Key1;Key2;Key3"
    ```

### 4. 运行脚本
```bash
# 直接运行一次（测试用）
node GoldPriceV6cooldown.js

# 或使用 npm 脚本
npm start
```
首次运行会创建数据文件 `gold_data.json` 并开始监控。检查控制台输出以确认运行成功。

## ⚙️ 详细配置

脚本的主要行为由文件顶部的 `CONFIG` 对象控制。您可以根据需要修改：

```javascript
const CONFIG = {
  changeThresholdYuan: 1.0, // 触发普通推送的1小时价格变化阈值（元/克）
  changeWindowMinutes: 60,  // 计算变化量的时间窗口（分钟）
  sampleIntervalMinutes: 2, // 抓取价格的采样间隔（分钟）
  pricePrecisionDigits: 2,  // 价格显示和计算的小数位数
  enableTimedPush: true,    // 是否启用定时推送（变化触发和收盘推送）
  enableSpecialAlert: true, // 是否启用特殊价格提醒
  pushIntervalMinutes: 60,  // 普通推送的最小间隔（分钟），防骚扰
  forcePushTest: false,     // 设为 true 可测试推送功能，运行一次即退出
  disabledWindows: [12001500], // 禁止推送的时间段，格式 [开始时间结束时间]，如 12001500 表示 12:00-15:00
  enableSpecialForcePush: true, // 特殊价格提醒是否忽略禁用时间段
  enableSpecialBypassInterval: true, // 特殊价格提醒是否忽略推送间隔限制
  coolDownMinutesForSinglePrice: 90, // 单个特殊价位的默认冷却时间（分钟）
  resetOtherSpecialCooldownOnHit: true, // 触发一个特殊价位时，是否重置其他价位的冷却
  // 为特定价位设置独立的冷却时间（分钟），未配置的价位使用默认值
  specialPriceCoolDownMinutes: {
    // “600”: 120, // 例如，当价格达到600元时，冷却时间设为120分钟
  },
};
```

**特殊价格目标设置**：
在 `CONFIG` 对象下方，找到 `SPECIAL_PRICE_TARGETS` 数组，将您关心的价位填入。
```javascript
const SPECIAL_PRICE_TARGETS = [500, 520, 550]; // 例如，设置500、520、550元为目标价位
```

## 🏃 生产环境部署

建议使用进程管理工具（如 **PM2**）来保证脚本持续运行。

1.  **全局安装 PM2**：
    ```bash
    npm install -g pm2
    ```

2.  **使用 PM2 启动服务**（确保已在项目目录中）：
    ```bash
    # 启动并命名进程
    pm2 start GoldPriceV6cooldown.js --name gold-monitor
    # 设置开机自启（根据PM2提示操作）
    pm2 startup
    pm2 save
    ```

3.  **常用 PM2 命令**：
    ```bash
    pm2 logs gold-monitor      # 查看实时日志
    pm2 status                 # 查看所有进程状态
    pm2 stop gold-monitor     # 停止服务
    pm2 restart gold-monitor  # 重启服务
    pm2 monit                 # 打开监控面板
    ```

**通过 Crontab 或青龙面板调度**：
如果您希望脚本在特定时间运行（而非持续后台运行），可以配置定时任务。例如，每天在交易时间运行：
```bash
# 每天9点到22点，每30分钟运行一次
*/30 9-22 * * * cd /path/to/your/project && node GoldPriceV6cooldown.js >> /tmp/gold_monitor.log 2>&1
```
请注意，脚本内部已包含定时循环逻辑 (`sampleIntervalMinutes`)，如果通过外部Cron调用，通常只需调用一次，脚本会自行循环并在收盘时间退出。

## 📁 文件说明

- `GoldPriceV6cooldown.js` - 主脚本文件
- `gold_data.json` - 运行时自动生成的数据文件（记录价格历史、推送状态等）
- `package.json` - 项目依赖定义
- `.gitignore` - Git忽略文件配置
- `README.md` - 本说明文件

## ⚠️ 重要注意事项

1.  **合规使用**：本工具仅用于个人学习与技术研究。请合理设置请求频率，避免对工商银行服务器造成不必要的压力。使用请遵守网站相关规定。
2.  **选择器更新**：如果目标网页结构改版，可能需要更新脚本中的 `PRICE_SELECTOR` 变量。您可以使用浏览器的开发者工具检查元素。
3.  **推送频率限制**：免费版 ServerChan 有推送次数限制，请合理配置 `pushIntervalMinutes` 和 `coolDownMinutesForSinglePrice` 等参数。
4.  **环境变量安全**：务必通过环境变量设置 `PUSH_KEYT`，切勿将其直接写入代码或提交至版本库。

## 🔧 故障排查

- **抓取失败/解析失败**：确认网络可访问目标页面；如果网页结构改版，检查并更新脚本中的 `PRICE_SELECTOR`。
- **无推送**：检查 `PUSH_KEYT` 环境变量是否设置正确；查看控制台日志确认价格是否成功抓取及触发条件是否满足。
- **推送过于频繁**：调整 `CONFIG.pushIntervalMinutes` 和 `CONFIG.changeThresholdYuan` 参数。

## 📄 开源协议

本项目基于 GPLv3 协议开源。