yule153604-zglt_script/README.md

中国联通自动化脚本

这是一个专为中国联通APP设计的高效自动化脚本，采用Python编写，旨在帮助用户自动完成日常签到、领现金、权益超市及各类专区活动。脚本基于异步IO架构，支持多账号并发运行，具有高度的稳定性和可扩展性。

🛠️ 代码结构详解

中国联通.py
├── 📂 青龙API操作函数
│   ├── ql_get_env .................. 获取青龙环境变量
│   ├── ql_update_env ............... 更新青龙环境变量
│   └── ql_update_cookie_to_token ... 账密登录后自动更新为Token格式
│
├── 📂 MarketRaffleState (全局奖池状态类)
│   ├── __init__ .................... 初始化奖池状态/锁
│   └── check_prizes ................ 查询奖池(全局单次,多账号共享)
│
├── 📂 Logger (日志管理类)
│   ├── __init__ .................... 初始化日志前缀
│   └── log ......................... 输出带时间戳的日志
│
├── 📂 HttpClient (网络请求类)
│   ├── __init__ .................... 初始化 Session/Headers
│   └── request ..................... 发送 HTTP 请求(含重试/Cookie管理)
│
├── 📂 RSAEncrypt (RSA加密类)
│   └── encrypt ..................... RSA加密(用于账密登录)
│
├── 📂 CustomUserService (核心业务类)
│   │
│   ├── 🔧 基础功能
│   ├── __init__ .................... 初始化账号信息(自动识别登录方式)
│   ├── _detect_login_mode .......... 检测登录模式(账密/Token)
│   ├── _generate_appid ............. 生成账密登录用appid
│   ├── online ...................... 登录调度器(自动选择登录方式)
│   ├── _login_with_password ........ 账号密码登录
│   ├── _login_with_token ........... Token登录
│   ├── open_plat_line_new .......... 获取业务 Ticket
│   ├── get_bizchannelinfo .......... 生成业务渠道 Header
│   └── get_epay_authinfo ........... 生成支付认证 Header
│   │
│   ├── 📝 日常签到 (Sign)
│   ├── sign_task ................... 签到任务入口
│   ├── sign_get_continuous ......... 获取签到状态
│   ├── sign_day_sign ............... 执行签到
│   ├── sign_task_center ............ 任务中心(自动完成任务并领取奖励)
│   ├── sign_do_task_from_list ...... 执行任务中心任务
│   └── sign_get_task_reward ........ 领取任务奖励
│   │
│   ├── 💰 天天领现金 (TTLXJ)
│   ├── ttlxj_task .................. 领现金任务入口
│   ├── ttlxj_authorize ............. 业务授权
│   ├── ttlxj_login ................. 业务登录
│   ├── ttlxj_unify_draw_new ........ 执行打卡/抽奖
│   └── ttlxj_query_available ....... 查询余额
│   │
│   ├── 🎁 联通祝福 (Wocare)
│   ├── ltzf_task ................... 祝福任务入口
│   ├── wocare_get_token ............ 获取 Token
│   ├── wocare_api .................. 通用 API 请求(含解密)
│   ├── wocare_get_draw_task ........ 获取任务列表
│   ├── wocare_complete_task ........ 完成任务
│   └── wocare_luck_draw ............ 执行抽奖
│   │
│   ├── 🛒 权益超市 (Market)
│   ├── market_task ................. 超市任务入口
│   ├── market_login ................ 超市登录
│   ├── market_share_task ........... 分享小红书任务(自动完成获取抽奖机会)
│   ├── market_watering_task ........ 浇花任务(支持多次浇花直到完成)
│   ├── market_watering ............. 执行浇花
│   ├── market_raffle_task .......... 抽奖任务(可选展示奖池信息)
│   ├── market_validate_captcha ..... 人机验证处理
│   └── market_raffle ............... 执行抽奖
│   │
│   ├── 🍇 新疆专区 (Xinjiang)
│   ├── xj_task ..................... 新疆任务入口(含归属地校验)
│   ├── xj_do_draw .................. 执行活动抽奖
│   ├── xj_usersday_task ............ 会员日任务入口
│   └── xj_usersday_draw ............ 会员日抽奖
│   │
│   ├── 🏙️ 商都福利 (ShangDu - 河南)
│   ├── shangdu_task ................ 商都任务入口(含归属地校验)
│   ├── shangdu_get_ticket .......... 获取 Ticket
│   ├── shangdu_login ............... 激活 Ticket
│   └── shangdu_signin .............. 执行签到
│   │
│   └── 📱 云手机活动 (Cloud Phone)
│       ├── wostore_cloud_task ........ 云手机任务入口
│       ├── wostore_cloud_login ....... 两步登录获取Token
│       ├── wostore_cloud_get_coupon .. 领取优惠券
│       ├── wostore_cloud_task_list ... 查询任务列表
│       ├── wostore_cloud_get_chance .. 领取抽奖次数
│       └── wostore_cloud_draw ........ 执行抽奖
│
│   ├── 🔒 联通安全管家 (Security Butler)
│   ├── security_butler_task .......... 安全管家任务入口
│   ├── _sec_get_ticket_by_native ..... 获取Ticket
│   ├── _sec_get_auth_token ........... 获取认证Token
│   ├── _sec_add_to_blacklist ......... 添加黑名单任务
│   ├── _sec_mark_phone_number ........ 号码标记任务
│   ├── _sec_sync_address_book ........ 同步通讯录任务
│   ├── _sec_set_interception_rules ... 设置拦截规则任务
│   ├── _sec_view_weekly_summary ...... 查看周报任务
│   ├── _sec_sign_in .................. 签到任务
│   ├── _sec_receive_points ........... 领取积分
│   └── _sec_get_user_info ............ 查询积分信息
│
│   └── ☁️ 联通云盘 (Cloud Disk)
│       ├── cloud_disk_task ........... 云盘任务入口
│       ├── _cloud_get_ticket_by_native 获取Ticket
│       ├── _cloud_get_dispatcher ..... 获取Token
│       ├── _cloud_get_user_info ...... 查询积分信息
│       ├── _cloud_get_task_detail .... 获取任务详情并执行
│       ├── _cloud_dosign ............. 签到任务
│       ├── _cloud_activity_list ...... 浏览活动中心任务
│       ├── _cloud_share_file ......... 分享文件任务
│       ├── _cloud_do_upload .......... 上传文件任务
│       ├── _cloud_do_ai_interaction .. AI通通互动任务
│       ├── _cloud_open_album_backup .. 打开相册备份任务
│       ├── _cloud_do_ai_query_for_lottery DeepSeek对话获取抽奖资格
│       ├── _cloud_check_lottery_times  查询抽奖次数
│       └── _cloud_lottery ............ 执行抽奖
│
│   └── 📚 联通阅读 (Woread)
│       ├── woread_task ............... 阅读任务入口
│       ├── woread_auth ............... 设备预登录获取accesstoken
│       ├── woread_login .............. 账号登录获取usertoken
│       ├── woread_get_book_info ...... 获取书籍信息
│       ├── woread_read_process ....... 模拟阅读任务
│       ├── _woread_heartbeat ......... 阅读心跳上报
│       ├── _woread_add_read_time ..... 添加阅读时长
│       ├── woread_draw_new ........... 抽奖(活动ID:8051)
│       └── woread_queryTicketAccount . 查询话费红包余额
│
└── 🚀 main (主程序入口) ............ 并发调度所有账号任务

✨ 功能特性

双模式登录

• Token登录: 推荐方式，使用抓包获取的token_online登录，稳定可靠
• 账密登录: 使用手机号+登录专用密码直接登录，无需抓包，但易触发风控
• 自动识别: 脚本自动检测输入格式，选择对应登录方式
• 自动转换: 账密登录成功后自动将环境变量更新为Token格式（青龙面板）

权益超市增强功能

• 接口自动解密: 自动处理权益超市接口的 AES 加密响应，修复任务列表获取失败的问题
• 分享任务自动完成: 自动完成分享小红书任务，获取额外抽奖机会
• 每日自动抽奖: 无条件执行抽奖，不受奖池状态影响
• 奖池信息展示: 可选功能，抽奖完成后展示今日奖池信息（默认关闭）
• 有效奖品识别: 自动标记有效奖品（包含月卡/周卡/季卡，排除5G宽视界/沃视频）
• 人机验证处理: 抽奖触发人机验证时自动处理并继续抽奖
• 浇花任务修复: 支持多次浇花直到完成目标次数（如60次）
• 全局奖池查询: 多账号只查询一次奖池，共享结果，节省资源

云手机活动

• 自动领券: 每日自动领取优惠券（如美团生活服务券）
• 任务状态同步: 自动触发任务状态同步，确保可领取抽奖次数
• 每日抽奖: 完成任务后自动执行抽奖

签到区-任务中心

• 任务自动完成: 自动浏览任务页面并完成任务
• 奖励自动领取: 任务完成后自动领取奖励
• 循环执行: 持续执行直到所有可完成任务都已处理

联通安全管家

• 每日签到: 自动完成安全管家签到任务
• 积分任务: 自动完成添加黑名单、号码标记、同步通讯录、骚扰拦截设置、查看周报等任务
• 积分领取: 任务完成后自动领取积分奖励
• 积分统计: 显示本次运行获得的积分数量

联通云盘

• 每日签到: 自动完成云盘签到任务
• 多项任务: 支持浏览活动中心、分享文件、上传文件、AI通通互动、打开相册备份等任务
• 积分领取: 任务完成后自动领取积分奖励
• DeepSeek抽奖: 通过DeepSeek对话获取抽奖资格并自动抽奖
• 积分统计: 显示本次运行获得的积分数量

联通阅读

• 自动登录: 设备预登录+账号登录双重认证
• 模拟阅读: 自动获取书籍信息并模拟阅读（心跳上报+阅读时长）
• 每日抽奖: 完成阅读任务后自动执行抽奖
• 余额查询: 显示话费红包余额

🚀 快速开始

1. 安装依赖

pip install httpx

# 必需安装（用于权益超市接口解密及账密登录）：
pip install pycryptodome

2. 配置账号

脚本通过环境变量 chinaUnicomCookie 获取用户登录信息。支持多账号，多个账号之间使用 @ 符号分隔。

方式一：Token登录（推荐）

格式：token_online字符串 或 token_online#appid

1. 使用抓包工具（如Stream、Fiddler）抓取中国联通APP的请求
2. 找到 https://m.client.10010.com/mobileService/onLine.htm 请求
3. 提取请求体中的 token_online 值（可选：同时提取 appId）

# 仅 token_online
export chinaUnicomCookie="your_token_online_string"

# token_online + appid（更稳定）
export chinaUnicomCookie="your_token_online#your_appid"

方式二：账密登录

⚠️ 注意: 账密登录容易触发安全风控，建议优先使用Token登录

💡 自动转换: 在青龙面板中使用账密登录成功后，脚本会自动将环境变量更新为 token_online#appid 格式，后续运行将使用Token登录

格式：手机号#登录专用密码

# 单账号
export chinaUnicomCookie="18812345678#yourpassword"

# 多账号
export chinaUnicomCookie="18812345678#password1@18887654321#password2"

登录专用密码需要在联通APP中设置，不是服务密码。

方式三：混合使用

可以同时使用两种登录方式：

export chinaUnicomCookie="token_string@18812345678#password"

3. 可选配置

编辑 中国联通.py 文件顶部的常量：

SHOW_PRIZE_POOL = False  # 是否显示权益超市奖品池信息，默认关闭

4. 执行模式切换

脚本默认采用并行模式运行多个账号，如需改为顺序执行（一个账号完成后再执行下一个），修改 main() 函数：

并行模式（默认）：

tasks = []
for i, cookie in enumerate(cookies.split('@')):
    if not cookie.strip():
        continue
    user = CustomUserService(cookie, index=i+1)
    tasks.append(user.user_task())

if tasks:
    await asyncio.gather(*tasks)

顺序模式：

for i, cookie in enumerate(cookies.split('@')):
    if not cookie.strip():
        continue
    user = CustomUserService(cookie, index=i+1)
    await user.user_task()

5. 运行脚本

python 中国联通.py

6. 查看运行结果

脚本运行后，将在控制台输出详细的执行日志。

• 登录状态: 显示登录成功/失败及脱敏后的手机号（如 138****5678）
• 登录方式: 显示使用的是账密登录还是Token登录
• 任务进度: 实时显示各个任务的执行情况（如"签到成功"、"获得0.87元立减金"）
• 抽奖结果: 显示具体的奖品名称（如"5元话费券"、"未中奖"）

奖池查询输出示例（开启 SHOW_PRIZE_POOL 时）

============================================================
权益超市奖品池查询
============================================================
今日奖池共 16 个奖品:

  ✅ [01] 爱奇艺VIP月卡
       今日投放: 100 | 总库存: 5000 | 概率: 5.00%
  ❌ [02] 5G宽视界黄金会员月卡
       今日投放: 50 | 总库存: 3000 | 概率: 3.00%
  ❌ [03] 茶百道6元免配券
       今日投放: 5000 | 总库存: 0 | 概率: 15.00%
  ...

============================================================
结论: 当前已放水！有效奖品 3/16 个，可以抽奖
============================================================

❓ 常见问题与故障排除

1. 账密登录相关

错误信息	原因	解决方案
密码错误	登录专用密码不正确	在联通APP中重置登录专用密码
未设置登录专用密码	账号未开启登录专用密码	前往联通APP设置登录专用密码
触发安全风控	登录频率过高或异常	手动打开联通APP登录一次解除
账密登录需要pycryptodome	缺少加密库	pip install pycryptodome

2. Token登录失败处理

如果遇到Token登录失败的情况，请尝试以下步骤：

1. 使用抓包工具获取本机实际的 device_id 和 device_code
2. 打开 中国联通.py 文件，找到 _login_with_token 函数
3. 将代码中的 device_id 和 device_code 替换为抓包获取的实际值

3. 权益超市相关

• 浇花状态异常: 已修复只浇花一次的问题，现在会持续浇花直到完成目标次数
• 奖池信息: 设置 SHOW_PRIZE_POOL = True 可在抽奖后展示今日奖池
• 人机验证: 触发人机验证时会自动处理，无需手动干预

注意事项

• HTTP/2: 为保证稳定性，脚本默认关闭了HTTP/2支持
• 异常处理: 脚本内置了完善的异常捕获机制，单个任务的失败不会影响其他任务或账号的执行
• 隐私安全: 所有敏感信息（如手机号）在日志输出时均会自动脱敏，保障用户隐私
• 奖池共享: 权益超市奖池查询只执行一次，所有账号共享结果，避免重复请求

⚠️ 免责声明

1. 仅供学习交流：本项目仅供编程学习和技术交流使用，请勿用于任何商业用途。
2. 合法使用：请勿将本脚本用于任何非法目的，包括但不限于恶意攻击、刷单等行为。
3. 风险自担：使用本脚本产生的任何后果（包括但不限于账号封禁、财产损失等）由使用者自行承担，开发者不承担任何责任。
4. 隐私保护：本项目不会收集用户的任何敏感信息，所有数据均保存在用户本地。
5. 侵权联系：如果本项目侵犯了您的权益，请及时联系开发者进行处理。