# 电信金豆

**Repository Path**: tl566/telecom-golden-bean

## Basic Information

- **Project Name**: 电信金豆
- **Description**: 翼支付APP金豆自动兑换话费青龙脚本
- **Primary Language**: Unknown
- **License**: AFL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-18
- **Last Updated**: 2025-11-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 翼支付金豆0点抢兑话费青龙脚本 - 完整解决方案

## 📁 文件清单

### 核心脚本文件
- **`yifupay_jindou_exchange.js`** - 基础版本脚本
- **`yifupay_jindou_exchange_enhanced.js`** - 增强版本脚本（推荐使用）

### 配置和说明文档
- **`yifupay_script_guide.md`** - 详细使用说明
- **`qinglong_deployment.md`** - 青龙面板部署指南
- **`environment_variables_example.env`** - 环境变量配置示例
- **`deploy.sh`** - 一键部署脚本

## 🚀 快速开始

### 方法一：手动部署（推荐）

1. **上传脚本文件**
   ```bash
   # 将脚本文件上传到青龙面板的scripts目录
   cp yifupay_jindou_exchange_enhanced.js /ql/scripts/
   ```

2. **配置环境变量**
   在青龙面板的环境变量页面添加：
   ```bash
   YIFUPAY_PHONE=你的手机号
   YIFUPAY_PASSWORD=你的密码
   YIFUPAY_EXCHANGE_AMOUNTS=5,10,20
   YIFUPAY_MIN_JINDOU=100
   ```

3. **创建定时任务**
   - 任务名称：`翼支付金豆0点抢兑话费`
   - 命令：`node /ql/scripts/yifupay_jindou_exchange_enhanced.js`
   - 定时规则：`0 0 * * *`

### 方法二：使用部署脚本

```bash
# 给脚本执行权限
chmod +x deploy.sh

# 运行部署脚本
./deploy.sh
```

## ✨ 功能特性

### 基础功能
- ✅ 自动登录翼支付APP
- ✅ 实时查询金豆数量
- ✅ 0点准时抢兑话费
- ✅ 智能重试机制
- ✅ 详细执行日志

### 增强功能（增强版）
- 🎯 多金额智能尝试（5元→10元→20元）
- ⏰ 精确时间控制（23:55-00:05时间窗口）
- 🔄 智能重试策略
- 📢 多渠道通知支持
- 🐛 详细调试信息
- 📊 执行时间统计
- 🛡️ 完善的错误处理

## 🔧 配置选项

### 基础配置
| 变量名 | 说明 | 默认值 | 必填 |
|--------|------|--------|------|
| `YIFUPAY_PHONE` | 手机号 | - | ✅ |
| `YIFUPAY_PASSWORD` | 密码 | - | ✅ |

### 兑换配置
| 变量名 | 说明 | 默认值 |
|--------|------|--------|
| `YIFUPAY_EXCHANGE_AMOUNTS` | 尝试兑换金额 | `5,10,20` |
| `YIFUPAY_MIN_JINDOU` | 最低金豆要求 | `100` |
| `YIFUPAY_START_TIME` | 开始准备时间 | `23:55` |
| `YIFUPAY_END_TIME` | 结束时间窗口 | `00:05` |

### 重试配置
| 变量名 | 说明 | 默认值 |
|--------|------|--------|
| `YIFUPAY_RETRY_COUNT` | 重试次数 | `3` |
| `YIFUPAY_RETRY_DELAY` | 重试间隔(ms) | `1000` |

### 通知配置
| 变量名 | 说明 | 默认值 |
|--------|------|--------|
| `YIFUPAY_NOTIFY_SUCCESS` | 成功通知 | `true` |
| `YIFUPAY_NOTIFY_FAILURE` | 失败通知 | `true` |
| `YIFUPAY_DEBUG` | 调试模式 | `false` |

## 📱 支持的通知方式

### 企业微信
```bash
WECOM_WEBHOOK=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=your_key
```

### 钉钉
```bash
DINGTALK_WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token=your_token
```

### 飞书
```bash
FEISHU_WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/your_hook_id
```

## 🕒 执行流程

1. **23:55** - 脚本开始监控时间窗口
2. **检查配置** - 验证手机号、密码等必要配置
3. **登录验证** - 使用账号密码登录翼支付
4. **查询金豆** - 获取当前金豆数量
5. **条件检查** - 验证金豆是否足够兑换
6. **00:00** - 准时开始兑换流程
7. **智能尝试** - 按金额顺序尝试兑换
8. **重试机制** - 失败时自动重试
9. **结果通知** - 发送执行结果通知

## 🔍 监控和调试

### 查看执行日志
```bash
# 实时查看日志
tail -f /ql/log/yifupay/execution.log

# 查看最近100行日志
tail -100 /ql/log/yifupay/execution.log
```

### 手动测试
```bash
# 手动执行脚本
node /ql/scripts/yifupay/yifupay_jindou_exchange_enhanced.js

# 调试模式执行
YIFUPAY_DEBUG=true node /ql/scripts/yifupay/yifupay_jindou_exchange_enhanced.js
```

### 查看定时任务
```bash
# 查看当前定时任务
crontab -l

# 查看青龙面板任务状态
# 在青龙面板的"定时任务"页面查看
```

## ⚠️ 注意事项

### 安全提醒
- 🔐 请妥善保管账号密码，不要在公共环境暴露
- 🔄 建议定期更换密码
- 🛡️ 可以考虑使用应用专用密码

### 使用建议
- 📅 脚本会在0点前5分钟开始准备执行
- 🧪 建议提前测试脚本功能是否正常
- 📊 关注脚本执行日志，及时处理异常情况
- 💰 金豆数量不足时会自动跳过执行

### 故障排除
- **登录失败**: 检查手机号和密码是否正确
- **网络错误**: 检查网络连接，脚本会自动重试
- **兑换失败**: 可能因为金豆不足或网络延迟
- **权限错误**: 检查青龙面板权限设置

## 📈 性能优化

1. **网络优化**: 使用稳定的网络环境
2. **时间同步**: 确保服务器时间准确
3. **资源监控**: 监控CPU和内存使用情况
4. **日志管理**: 定期清理历史日志文件

## 🆘 技术支持

如果遇到问题：

1. **查看文档**: 先查看详细的使用说明文档
2. **检查日志**: 查看脚本执行日志定位问题
3. **调试模式**: 开启调试模式获取更多信息
4. **手动测试**: 先手动执行脚本测试功能

## 📄 免责声明

本脚本仅供学习和研究使用，请遵守翼支付APP的使用条款和相关法律法规。使用本脚本产生的任何风险由使用者自行承担。

## 🔄 更新日志

- **v1.0.0** - 初始版本，基本的登录、查询、兑换功能
- **v1.1.0** - 添加重试机制和详细日志
- **v1.2.0** - 优化时间控制和错误处理
- **v2.0.0** - 增强版发布，支持多金额尝试、智能重试、通知功能

---

🎉 **祝您使用愉快，成功抢到心仪的话费！**