ℹ️ 分支选择建议

• main 分支（v3，稳定版）：已兼容微软新版 UI，实测未发现明显异常，可放心日常使用。
• V4-china 分支（v4 新架构，基本可用）：搜索、活动、签到、Read-to-Earn、微信推送（PushPlus / ClawBot）等核心功能已实测通过（2026-08），可以切换日常使用；新架构仍在迭代，偶发小问题属正常，追求稳定可继续留在 main 分支。

两分支配置文件结构不同，互不兼容；迁移 V4-china 请按其 README 重新配置 .env / config.json。

• ✨ 核心特性
• 🚀 快速开始
• 📦 Windows 部署
• 🐳 Docker 部署
• ⚙️ 配置参考
• 🔔 通知渠道
• ❓ 常见问题
• ⚠️ 注意事项
• 📜 同步与致谢
• ⚠️ 免责声明

账户管理

• ✅ 多账户支持
• ✅ 会话存储与持久化
• ✅ 2FA 支持
• ✅ 无密码登录支持

自动化与控制

• ✅ 无头浏览器操作
• ✅ 集群支持（同时多个账户）
• ✅ 可配置任务选择
• ✅ 代理支持
• ✅ 自动调度（Docker）

搜索与活动

• ✅ 桌面与移动搜索（Microsoft Edge 模拟）
• ✅ 地理定位搜索查询
• ✅ 模拟滚动与链接点击
• ✅ 每日集 / 促销活动 / 打卡 / 每日签到 / 阅读赚取
• ✅ 连击保护 & 领取 dashboard 奖励积分（新版 UI 走 Server Action）

搜索词来源（中国地区）

• ✅ 中国热搜（百度/头条/抖音/微博/知乎，多源聚合 + 限流退避）
• ✅ Bing Suggestions / Related Terms 扩展（日志聚合输出）
• ✅ 本地查询词兜底（search-queries.json，392 个标准词）

测验与互动内容

• ✅ 测验解答（10 分与 30-40 分变体）
• ✅ 此或彼测验（随机答案）
• ✅ ABC 测验解答
• ✅ 投票完成
• ✅ 点击奖励

通知与监控

• ✅ Discord Webhook 集成
• ✅ ntfy 推送支持
• ✅ PushPlus 推送支持（国内微信推送）
• ✅ 全面日志记录（带日志过滤、本地文件持久化）
• ✅ Docker 支持与监控

本脚本支持两种部署方式，按你的场景二选一即可：

详细步骤见下方对应章节。

⚠️ 本项目所有改动基于 Win11 系统测试，其他系统请参考原项目相关配置。

1. 下载或克隆源代码
2. Win 系统运行 setup.bat 部署环境（若 setup.bat 报错，请参考下方手动设置）
3. 在 dist 目录的 accounts.json 添加你的账户信息
4. 按照你的喜好修改 dist 目录的 config.json 文件
5. 运行 npm start 或运行 run.bat 启动构建好的脚本

1. 下载或克隆源代码

2. 下载安装 Node.js 24 和 npm 环境

3. 运行 npm install 安装依赖包

4. 若出现 Error: browserType.launch: Executable doesn't exist 报错，执行：

   npx patchright install chromium

5. 将 accounts.example.json 重命名为 accounts.json，并添加你的账户信息

6. 按照你的喜好修改 config.json 文件

7. 运行预构建脚本：

   npm run pre-build

8. 构建脚本：

   npm run build

9. 启动：

   npm start

从模板复制并填写：

cp env.example .env

编辑 .env，至少填一个账号：

ACCOUNT_1_EMAIL=you@example.com
ACCOUNT_1_PASSWORD=your_password
# 国内账号推荐加：
ACCOUNT_1_GEO_LOCALE=cn
ACCOUNT_1_LANG_CODE=zh

多账号按 ACCOUNT_2_*、ACCOUNT_3_* 递增，编号必须连续。完整字段见 env.example。

默认配置开箱即用，如需调整取消对应行注释即可：

• TZ：时区（默认 Asia/Shanghai）
• CRON_SCHEDULE：调度（默认 0 7 * * *，每天 7 点）
• RUN_ON_START：容器启动时是否立即跑一次（默认 true）
• CONFIG_QUERY_ENGINES：查询源，国内推荐 china,local
• CONFIG_CHINA_API_APPKEY：gmya.net appkey，配合 china 查询源解除免费档限流（留空走免费档）
• CONFIG_PUSHPLUS_*：PushPlus 微信推送

完整的 CONFIG_* 环境变量列表见 scripts/docker/entrypoint.sh 顶部注释。

无需手动设置。Docker 环境下 headless 被容器入口强制设为 true（容器内无显示器，无法开窗口模式）。

docker compose up -d --build

重要：改了代码或 Dockerfile 后，必须加 --build 参数重建镜像，否则跑的还是旧镜像。首次部署也建议带 --build。

容器挂载了两个目录，重建容器不丢数据：

• ./config/：配置和账号文件
• ./sessions/：登录会话（首次登录后 cookie 存这里，后续自动复用）

docker compose up -d --build   # 构建+启动
docker compose logs -f          # 查看日志
docker compose down             # 停止并删除容器
docker compose restart          # 重启（不重建）

编辑 src/config.json（Windows）或通过 CONFIG_* 环境变量（Docker）自定义行为。 下面按功能分组，点击各 summary 展开详情。

📌 注：示例配置 config.example.json 里 searchDelay 为 6-12min、readDelay 为 6-11min、searchResultVisitTime 为 20sec，比 Validator 默认值更保守，适合长时间挂机场景。

searchSettings.queryEngines 决定从哪些源获取搜索词，按数组顺序尝试。可选值：

国内推荐配置：["china", "local"]（示例配置默认值），无需代理即可获取丰富搜索词。

当 queryEngines 包含 china 时，搜索词从中国热搜获取：

• 数据源：gmya.net 热门词 API（百度/头条/抖音/微博/知乎热搜榜）
• 策略：随机打乱 5 个源，取前 N 个聚合去重（避免每个账号都用同一个源）。N 由是否配置 chinaApi.appkey 决定：有 appkey 取 2 个；免费档取 1 个。首选源全部失败时自动 fallback 到剩余源
• 限流处理：免费档（无 appkey）对连续请求有频率限制，会触发 403。本脚本在源与源之间插入随机退避（1.2~2.5s），命中限流后指数退避 ×1.5，并将限流错误如实上报（不再误报为"格式异常"）。想彻底避免限流，在 searchSettings.chinaApi.appkey 填入 gmya.net appkey
• 扩展：对每个热搜词调用 Bing Suggestions/Related Terms 扩展查询多样性（命中率取决于词的特性 —— 短词高、长句低），扩展进度采样输出，结尾输出"热搜词使用清单"（INFO 级别）
• 本地兜底：src/functions/search-queries.json 提供 392 个标准查询词作为补充

两个字段结构相同，用于过滤输出到控制台 / webhook 的日志：

{
    "enabled": false,
    "mode": "whitelist",
    "levels": ["error", "warn"],
    "keywords": ["starting account"],
    "regexPatterns": []
}

• mode：whitelist（只输出匹配的）或 blacklist（排除匹配的）
• levels：日志级别筛选（debug/info/warn/error）
• keywords：日志消息包含这些关键词则命中
• regexPatterns：正则匹配

微软新版 dashboard（modern UI）改用 Next.js App Router，部分功能不再有对外 REST API，旧版 API（togglestreakasync、claimallpointsasync）在新版 UI 下因取不到 requestToken 会返回 400 Bad Request。

版本守卫机制：next-action hash 在编译时生成、绑定到具体部署版本（dpl）。脚本启动时从 dashboard HTML 提取当前部署 ID，与脚本内置的支持版本（20260612-3）比对：

• ✅ 匹配 → 走 Server Action（新版 UI）
• ⚠️ 不匹配 → 微软可能更新了 dashboard，内置 hash 可能失效，相关功能自动降级跳过（不会 400，不影响其他任务）
• 旧版 UI（legacy）→ 仍走原 REST API（需要 requestToken）

如果降级跳过频繁出现，说明微软更新了部署，需要重新更新 hash。

本项目支持三种推送渠道（均在 webhook 对象下，可同时开启多个）：

💡 国内推荐：PushPlus（微信推送，无需翻墙）。Discord / ntfy 需要能访问对应服务。

Chromium 没装上，手动安装：

npx patchright install chromium

首次运行时请手动完成网页登录一次，等待脚本自动接管剩余流程。登录后的 cookie 会保存到 sessions/ 目录，后续运行会自动复用。

⚠️ sessions/ 目录需要多备份，丢了就要重新登录。

改完 compose.yaml 或代码后，必须加 --build 重建镜像：

docker compose up -d --build

不加 --build 跑的是旧镜像。

免费档对连续请求有频率限制。解决方法：

到 gmya.net 申请 appkey，填入 searchSettings.chinaApi.appkey（Docker 用 CONFIG_CHINA_API_APPKEY 环境变量），即可解除限流。

• Win 环境：必须运行 npm run build 重新构建脚本
• Docker 环境：不要手动改容器内的 config 文件（重启会被 entrypoint 覆盖），改 .env 或 compose.yaml 后用 docker compose up -d --build 生效

不能。之前的版本与当前版本不兼容，必须重新基于 accounts.example.json / config.example.json 生成。

• Win 环境：复制或重命名 src/accounts.example.json 为 src/accounts.json 并添加凭据；同样 src/config.example.json → src/config.json

• 如果出现无法自动登录情况，请在代码执行登录过程中手动完成网页的登录，等待代码自动完成剩下流程。登录信息保存在 sessions/ 目录（需要多备份），后续运行根据该目录的会话文件来运行。
• Win 环境：复制或重命名 src/accounts.example.json 为 src/accounts.json 并添加您的凭据。
• Win 环境：复制或重命名 src/config.example.json 为 src/config.json 并自定义您的偏好。
• 不要跳过配置这一步。之前的 accounts.json 和 config.json 版本与当前版本不兼容。
• Win 环境：修改 accounts.json 或 config.json 后，必须运行 npm run build 重新构建脚本。
• Docker 环境：账号和行为配置通过 .env 和 compose.yaml 传入，不要手动改容器内的 config 文件（重启会被 entrypoint 覆盖）。改 compose.yaml 后用 docker compose up -d --build 生效。

本项目 fork 自 TheNetsky/Microsoft-Rewards-Script，感谢原作者的付出。

本项目不定时同步原项目代码，主要内容为本地化处理：

• 针对国内用户无法访问 Google 等外网的问题，提供中国热搜查询源（百度/头条/抖音/微博/知乎）
• 输出日志的简单中文翻译
• 在原有基础上完善功能

若有侵权请联系删除。

本项目所有改动基于 Win11 系统和委托他人 Docker 环境测试。其他系统未测试，请根据原项目相关配置设置。

风险自负！ 使用自动化脚本时，您的 Microsoft Rewards 账户可能会被暂停或禁止。

此脚本仅供教育目的。作者对 Microsoft 采取的任何账户操作不承担责任。