Skip to content

SkyBlue997/MicrosoftRewardsPilot

BranchesTags

Repository files navigation

中文 | English | 日本語

MicrosoftRewardsPilot 自动化脚本

智能化 Microsoft Rewards 积分自动获取工具

GitHub License Docker

目录

  1. 快速开始
  2. 主要配置
  3. 故障排除与测试
  4. 核心功能
  5. 完整配置示例
  6. 重要提醒

快速开始

本地运行 （点击展开） 
# 1. 克隆项目
git clone https://github.com/SkyBlue997/MicrosoftRewardsPilot
cd MicrosoftRewardsPilot

# 2. 安装依赖
npm i

# 3. 配置文件
# 复制示例配置文件并编辑
cp config/config.json.example config/config.json
cp config/accounts.json.example config/accounts.json

# 4. 构建运行
npm run build
npm start
Docker 部署（推荐） （点击展开） 
# 1. 准备配置文件
# 复制示例配置文件并编辑
cp config/config.json.example config/config.json
cp config/accounts.json.example config/accounts.json

# 2. 构建
npm run build

# 3. 启动容器
docker compose up -d

# 4. 查看日志(可选)
docker logs -f microsoftrewardspilot

Docker Compose 配置示例：

services:
  microsoftrewardspilot:
    build: .
    container_name: microsoftrewardspilot
    restart: unless-stopped
    volumes:
      - ./config/accounts.json:/usr/src/microsoftrewardspilot/dist/config/accounts.json
      - ./config/config.json:/usr/src/microsoftrewardspilot/dist/config/config.json
      - ./sessions:/usr/src/microsoftrewardspilot/sessions  # 保存登录会话
    environment:
      - NODE_ENV=production
      - TZ=Asia/Tokyo  # 根据地理位置设置
      - CRON_SCHEDULE=0 9,16 * * *  # 建议改成不那么"整点"的分散时间，避免每天同一时刻扎堆；run_daily.sh 还会再叠加 3-85 分钟随机抖动
      - RUN_ON_START=true  # 容器启动时立即跑一次
      # 反检测：启用 rebrowser 的 Runtime.enable 修复（src/rebrowser-env.ts 已内置默认值，这里显式声明便于覆盖）
      - REBROWSER_PATCHES_RUNTIME_FIX_MODE=addBinding
      - REBROWSER_PATCHES_UTILITY_WORLD_NAME=util

地理位置/时区由 config.json 的 searchSettings.multiLanguage.autoDetectLocation 与 searchSettings.autoTimezone 控制（不是环境变量）。

主要配置

基础设置

{
  "headless": true,           // 无头模式运行
  "parallel": true,           // 并行执行任务
  "clusters": 1,              // 集群数量
  "globalTimeout": "45min",   // 全局超时时间
  "runOnZeroPoints": false,   // 零积分时不运行
  "accountDelay": {           // 多账户间隔时间
    "min": "5min",            // 最小间隔5分钟
    "max": "15min"            // 最大间隔15分钟
  }
}

智能搜索配置

搜索间隔（对数正态延迟）与拟人打字均为内置；查询语言按账户市场自动本地化（ja/en/zh-CN/vi 有完整查询库）。可调键：

{
  "searchSettings": {
    "useGeoLocaleQueries": true,    // 仅影响请求头 X-Rewards-Country/Language
    "multiLanguage": {
      "enabled": true,              // 多语言支持
      "autoDetectLocation": true    // 自动检测位置（决定查询与时区本地化）
    },
    "autoTimezone": {
      "enabled": true,              // 自动时区
      "setOnStartup": true          // 启动时设置
    }
  }
}

任务配置

其余可领活动（每日任务集、签到、阅读赚取、谜题等）会自动领取，无需开关。

{
  "workers": {
    "doDesktopSearch": true,   // 桌面端搜索
    "doMobileSearch": true,    // 移动端搜索（L2 起）
    "doMorePromotions": true   // Explore on Bing / 推广任务
  }
}

弹窗处理配置

{
  "popupHandling": {
    "enabled": false,                    // 是否启用弹窗处理（默认禁用）
    "handleReferralPopups": true,        // 处理推荐弹窗
    "handleStreakProtectionPopups": true,// 处理连击保护弹窗
    "handleStreakRestorePopups": true,   // 处理连击恢复弹窗
    "handleGenericModals": true,         // 处理通用模态框
    "logPopupHandling": true             // 记录弹窗处理日志
  }
}

Passkey处理配置

{
  "passkeyHandling": {
    "enabled": true,              // 是否启用Passkey处理
    "maxAttempts": 5              // 最大尝试次数
  }
}

故障排除与测试

移动端2FA验证问题

问题： 移动端任务执行时提示需要双因素认证

解决方案： 使用专门的2FA验证助手工具

# 运行2FA验证助手
npx ts-node src/helpers/manual-2fa-helper.ts

使用流程：

  1. 运行命令后选择语言
  2. 输入需要验证的邮箱和密码
  3. 在打开的浏览器中完成2FA验证步骤
  4. 等待OAuth授权完成
  5. 工具自动保存移动端会话数据
  6. 重新运行自动化程序，移动端任务将跳过2FA验证

弹窗处理问题

问题： 程序在弹窗处理时卡住不动，出现无限循环

现象： 日志显示重复的弹窗检测信息

[REWARDS-POPUP]  Detected Streak Protection Popup
[REWARDS-POPUP]  Detected Streak Protection Popup

解决方案：

  1. 立即解决：在 config/config.json 中禁用弹窗处理
{
  "popupHandling": {
    "enabled": false
  }
}
  1. 选择性启用：只启用需要的弹窗类型
{
  "popupHandling": {
    "enabled": true,
    "handleReferralPopups": true,
    "handleStreakProtectionPopups": false,
    "handleStreakRestorePopups": false
  }
}

Passkey设置循环问题

问题： 登录后被重定向到Passkey设置页面，点击"Skip for now"后形成无限循环

现象： 程序在 "Starting login process!" 后卡住

解决方案： 系统已自动处理Passkey循环问题

  • 自动检测：检测Passkey设置页面
  • 多种绕过：跳过按钮、ESC键、直接导航
  • 智能重试：最多5次尝试，防止无限循环
  • 配置控制：可通过配置调整处理策略

配置选项：

{
  "passkeyHandling": {
    "enabled": true,
    "maxAttempts": 5
  }
}

常见问题

积分获取受限/检测到自动化行为

现象： 连续多次搜索无积分，或积分获取不完整 说明： 多数情况并非被检测，而是：

  • 奖励日重置边界（约当地午夜前后）：dapi 会返回不一致的快照（搜索/阅读在"已重置"和"旧值"间抖动），此时不要跑——在稳定时段（如脚本 cron 的早/晚）运行即可
  • 当日活动已完成：当天第二次运行多为 +0（正确的幂等表现）
  • 真被风控时：降低运行频率、避免短时间多次登录，本项目的反检测（rebrowser 补丁、指纹一致性、对数正态延迟、本地化查询）会随正常使用恢复
地理位置检测失败

解决方案： 检查网络连接，确保能访问地理位置API服务

时区不匹配

解决方案： 检查 TZ 环境变量设置是否正确

内存不足

解决方案： 重启容器或检查系统资源使用情况

Docker问题排查

# 查看日志
docker logs microsoftrewardspilot

# 测试网络连接
docker exec microsoftrewardspilot ping google.com

# 检查地理位置（与代码 GeoLanguage.ts 使用的服务一致）
docker exec microsoftrewardspilot curl -s https://ipapi.co/json

核心功能

支持任务

新版 rewards.bing.com 已迁移为 Next.js SPA，旧的 DOM 抓取失效；本项目改为对接 dapi 后端 API（活动直接领取）+ 真实搜索/视觉搜索。

  • 每日任务集 / 每日活动 / 推广任务 - 经 dapi API 自动领取「点击即完成」类活动（urlreward / 阅读赚取 / 签到，含每日一言等 urlreward 卡片）；需作答的互动 Quiz 不会被自动完成
  • 桌面端搜索 - 真实、拟人节奏的必应搜索，进度读自 dapi
  • 移动端搜索 - 移动设备模拟（Level 2 起，与 PC 共享当日搜索上限）
  • Explore on Bing - 经奖励 flyout 的类目搜索完成
  • 视觉搜索 - 自动完成必应视觉搜索活动
  • 每日签到 - 网页签到 + 必应应用签到（两种独立签到）
  • 阅读赚取 - 阅读文章获取积分

智能特性

  • 多账户支持 - 集群并行处理
  • 会话存储 - 免重复登录，支持2FA
  • dapi 后端对接 - 新版 SPA 已无可抓取 DOM，改走 Rewards 后端 API（prod.rewardsplatform.microsoft.com/dapi）；rewards.bing.com 仅为登录落地页
  • 地理位置检测 - IP 检测地区 / 坐标 / 时区
  • 时区同步 - 自动设置匹配时区
  • 本地化 - 按账户市场本地化查询，并发送对应 X-Rewards-Language
  • rebrowser 反检测 - 启用补丁，消除 Playwright 的 Runtime.enable CDP 泄漏
  • 指纹一致性 - fingerprint-injector 注入 + UA/Client-Hints(GREASE) 对齐
  • 拟人行为 - 逐字打字、可变方向滚动、结果点击与停留
  • 拟人延迟 - 对数正态分布的搜索间隔（无区间硬边界）
  • 节奏随机化 - 账户顺序洗牌、运行启动时间抖动
  • 弹窗智能处理 - 自动检测和关闭各种Microsoft Rewards弹窗
  • Passkey循环绕过 - 自动处理Passkey设置循环问题
  • Docker支持 - 容器化部署
  • 自动重试 - 失败任务智能重试
  • 详细日志 - 完整的执行记录
  • 灵活配置 - 丰富的自定义选项
  • 中文本地化 - 中国账户使用 zh-CN 查询库搜索（与日/英/越同为完整本地化语言）

完整配置示例

完整模板见仓库的 config/config.json.example（快速开始已让你 cp 它）。下面仅列出实际生效的键：

有效配置项 （点击展开） 
{
  "baseURL": "https://rewards.bing.com",
  "sessionPath": "sessions",
  "headless": true,
  "parallel": false,
  "runOnZeroPoints": false,
  "clusters": 1,
  "saveFingerprint": {
    "mobile": true,
    "desktop": true
  },
  "workers": {
    "doDesktopSearch": true,
    "doMobileSearch": true,
    "doMorePromotions": true
  },
  "searchOnBingLocalQueries": true,
  "globalTimeout": "180min",
  "accountDelay": {
    "min": "8min",
    "max": "20min"
  },
  "searchSettings": {
    "useGeoLocaleQueries": true,
    "multiLanguage": {
      "enabled": true,
      "autoDetectLocation": true
    },
    "autoTimezone": {
      "enabled": true,
      "setOnStartup": true,
      "validateMatch": true,
      "logChanges": true
    }
  },
  "logExcludeFunc": [
    "SEARCH-CLOSE-TABS"
  ],
  "webhookLogExcludeFunc": [
    "SEARCH-CLOSE-TABS"
  ],
  "proxy": {
    "proxyGoogleTrends": true,
    "proxyBingTerms": true
  },
  "webhook": {
    "enabled": false,
    "url": ""
  },
  "popupHandling": {
    "enabled": false,
    "handleReferralPopups": true,
    "handleStreakProtectionPopups": true,
    "handleStreakRestorePopups": true,
    "handleGenericModals": true,
    "logPopupHandling": true
  },
  "passkeyHandling": {
    "enabled": true,
    "maxAttempts": 5
  }
}

重要提醒

风险警告 使用自动化脚本可能导致账户被封禁

安全建议 适度使用，系统已自动启用所有反检测功能

定期更新 保持脚本为最新版本

祝您使用愉快！

Star History Chart

如果这个项目对您有帮助，请考虑给一个 Star！

About

Self-hosted MicrosoftRewards engine, lightweight | 微软奖励自动答题搜索，多账号托管 | 自己ホスト型MicrosoftRewardsエンジン、軽量

Topics

bot docker automation typescript cron microsoft-rewards playwright

Resources

Readme
Activity

Stars

52 stars

Watchers

1 watching

Forks

8 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages