MSRPilot 使用指南
MSRPilot 用于集中管理 Microsoft Rewards 账号、任务配置、运行环境和自动执行流程。本指南始终按照最新版 Windows 桌面端维护，覆盖首次启动、日常运行及常见故障处理。
开始前准备
- Windows 10/11。
- Node.js
24或更高版本；部署时软件会检测 Node.js，并通过npm安装运行依赖。 - 可正常登录 Microsoft Rewards 的账号。
- 稳定网络；如使用代理，请准备完整的代理地址和认证信息。
- 首次运行会开启 24 小时免费体验；体验结束后需使用授权码激活。
安全提示
账号密码、TOTP 密钥、恢复邮箱、代理密码和导出的 CSV 都属于敏感数据。不要将密码、验证码、Cookie、授权码或完整日志凭据提交到在线客服或公开平台。
界面模块
| 模块 | 用途 |
|---|---|
| 数据概览 | 汇总账号总积分、今日收益和最近运行结果 |
| 运行日志 | 查看部署、登录、任务执行、积分变化和错误信息 |
| 账号配置 | 添加、导入、启用或停用账号，设置 2FA、代理和指纹 |
| 脚本配置 | 控制任务类型、搜索行为、并发、日志和通知 |
| 系统设置 | 配置开机自启、定时任务、托盘行为及环境清理 |
| 在线客服 | 发起会话、补充信息、查看客服回复和处理状态 |
| 在线商城 | 购买或续期授权；地址由服务端动态下发 |
| 关于 | 查看版本、机器码、更新日志、联系方式和软件更新 |
左侧底部还提供主题切换、帮助和公告入口。客服有新回复、关于页发现新版本或公告未读时，界面会显示提示标记。
数据概览界面
运行日志界面
首次使用
推荐按以下顺序完成配置：
启动软件 → 确认试用或激活 → 保存账号 → 保存脚本配置 → 部署环境 → 运行任务 → 检查数据概览与日志
软件内置可移动、可收起的“新用户配置向导”。首次使用可跟随向导认识各模块，并依次完成“保存账号”“保存配置”和“部署环境”；以后也可在“关于”页面重新打开。
1. 确认授权状态
首次启动会自动开始 24 小时免费体验。左侧状态区和“关于”页面可查看：
- 当前授权或试用状态；
- 到期时间；
- 当前设备机器码；
- 当前软件版本。
体验结束后，在授权界面输入授权码激活。授权与设备机器码关联；更换电脑、重装系统或机器码变化时，按授权页面提示处理换绑。
2. 添加并保存账号
打开“账号配置”，点击“添加账号”或“导入 CSV”。每个账号支持以下字段：
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 邮箱 | 是 | Microsoft 账号邮箱 |
| 密码 | 是 | Microsoft 账号登录密码 |
| TOTP 密钥 | 否 | 开启 2FA 时填写的密钥，不是一次性验证码 |
| 恢复邮箱 | 否 | 登录验证可能使用的备用邮箱 |
| 地区 | 固定 | 国内版固定为 CN，不可编辑 |
| 语言 | 固定 | 国内版固定为 zh-CN，不可编辑 |
| 代理地址、端口 | 否 | 例如 http://127.0.0.1 和对应端口 |
| 代理用户名、密码 | 否 | 代理要求认证时填写 |
| 代理 HTTP 请求 | 否 | 让脚本的 HTTP 请求也通过账号代理 |
| 保存移动端/桌面端指纹 | 否 | 保留对应浏览器身份，默认建议开启 |
账号列表支持搜索、单独启停、批量启停和批量删除。只有启用且已保存的账号会参与运行。
必须保存并重新部署
账号页出现“有未保存修改”提示时，先点击“保存账号”。环境已经部署过的情况下，还要重新部署，运行目录才会得到最新配置。
CSV 导入与导出
当前版本的 CSV 字段顺序为：
email,password,totpSecret,recoveryEmail,geoLocale,langCode,proxyHttp,proxyUrl,proxyPort,proxyUsername,proxyPassword,fingerprintMobile,fingerprintDesktop,enabled
enabled控制账号是否参与运行。- 国内版导入后会统一使用
CN和zh-CN。 - 导入完成后仍需点击“保存账号”。
- 导出文件包含账号和代理凭据，请加密保存或用完后安全删除。
3. 检查脚本配置
普通用户首次运行建议保留默认值，只确认账号并发和浏览器显示方式。
基础运行
| 配置 | 默认值 | 说明 |
|---|---|---|
| Session 路径 | sessions | 保存浏览器登录会话；清空后需重新登录 |
| 无头模式 | 关闭 | 后台隐藏浏览器；首次登录或排障时保持关闭 |
| 并发账号数 | 1 | 普通电脑建议 1-2，过高会增加资源占用 |
| 全局超时 | 30sec | 单个页面操作的最长等待时间 |
| 错误诊断 | 关闭 | 异常时记录更多信息 |
| 连续签到保护 | 开启 | 确保连续签到保护功能启用 |
| 自动领取打卡奖励 | 关闭 | 打卡完成后领取可领取的最终奖励 |
| 跳过无积分任务 | 开启 | 跳过不直接奖励积分的任务 |
| 调试日志 | 关闭 | 仅排障时开启 |
任务开关
当前版本可分别控制：每日任务集、领取奖励积分、更多推广、打卡活动、应用推广、桌面搜索、移动搜索、奖励搜索、每日签到、阅读赚取、激活搜索特权，以及 URL Reward 和 SearchOnBing 活动。
建议
不确定任务作用时保持默认。一次只调整少量开关，保存并重新部署后再观察运行结果，便于定位问题。
搜索设置
- 随机滚动结果、随机点击结果：模拟更自然的浏览行为，但会延长运行时间。
- 零积分也搜索：当前搜索积分为零时仍继续搜索。
- 并行搜索：桌面和移动搜索并行执行，速度更快但资源占用更高。
- 最大额外搜索次数：仅在启用奖励搜索时生效。
- 查询引擎：国内版建议保留
china, local。 - 结果页停留、搜索延迟、阅读延迟：支持
30sec、1min等时间格式。 - API 搜索、API SearchOnBing：实验功能；出现不上分或行为异常时关闭。
日志与通知
控制台和 Webhook 均可设置白名单或黑名单过滤，并按日志级别、关键词或正则表达式匹配。远程通知支持：
- Discord Webhook；
- Ntfy（URL、主题、Token、标签和优先级）；
- PushPlus（Token、标题、模板和渠道）。
配置完成后点击“保存配置”。所有脚本配置变更都需重新部署后生效。
4. 部署环境
点击左侧“部署”。部署会：
- 写入最新账号和脚本配置；
- 检查 Node.js；
- 通过国内 npm 镜像安装项目依赖；
- 准备浏览器运行组件；
- 检查环境是否完整可用。
部署期间不要重复点击“运行”。看到环境状态为已部署、日志没有连续错误后再开始任务。
5. 运行任务
点击“运行”后，先在“运行日志”确认：
- 运行目录与 Node.js 正常；
- 浏览器成功启动；
- 启用账号开始登录；
- 各任务按顺序执行；
- 积分变化被记录；
- 任务结束后没有持续报错。
运行中可点击“停止”。执行完成后，到“数据概览”查看各账号总积分、今日收益和最近结果。
自动运行与系统设置
开机自启
| 选项 | 行为 |
|---|---|
| 启用开机自启 | 写入当前用户 HKCU Run，通常不需要管理员权限 |
| 开机后后台启动 | 隐藏主窗口，可从系统托盘恢复 |
| 开机后自动运行脚本 | 软件初始化且环境可用后自动运行 |
每日定时任务
启用后，软件通过 Windows 任务计划程序创建每日任务。设置每日时间，并按需启用“触发后自动运行脚本”和“定时触发时后台启动”。
权限提示
如果创建定时任务失败，请关闭软件，右键程序选择“以管理员身份运行”，再保存定时任务。部分系统策略仍可能阻止任务计划程序创建任务。
关闭与托盘行为
点击窗口关闭按钮时可选择：
- 每次询问；
- 直接关闭程序；
- 最小化到系统托盘。
选择托盘后脚本会继续运行；直接退出会停止当前脚本。还可开启“启动后直接最小化到托盘”，适合长期后台运行。托盘图标支持双击或右键恢复窗口。
环境清理
“系统设置 → 环境管理 → 多项删除”可分别清理：
| 项目 | 影响 |
|---|---|
| 浏览器运行时 | 删除 ms-playwright；需要重新下载 |
| 项目运行目录 | 删除 MSRPilot、依赖和其中的 sessions；需要重新部署 |
| 登录会话 | 仅清除 sessions；下次运行需重新登录 |
| 启动日志 | 仅删除本地 MSRPilotLogs |
删除项目前先停止脚本。选择项目运行目录时，登录会话会一并删除。
在线客服、公告与更新
在线客服
“在线客服”已升级为会话式界面：
- 选择“功能建议”或“问题反馈”；
- 填写标题、内容和可选联系方式；
- 发起会话；
- 在会话中继续补充信息并查看客服回复。
标题最多 80 字，联系方式最多 120 字，内容和单条回复最多 2000 字。会话状态包括新反馈、处理中、已采纳、已拒绝、已解决和已关闭；已关闭会话不能继续回复，需要重新发起。会话可删除，删除后软件和客服后台都不再显示。
新会话数量受服务端每日额度限制，具体以软件提示为准。客户端每 30 秒自动刷新会话，有新回复时导航栏会显示提醒。
公告与版本更新
下图分别展示在线商城和“关于”页面：
- 公告入口用于查看服务端发布的重要通知，未读公告会显示红点。
- 新版本首次启动时会显示一次更新说明，历史记录可在“关于”页查看。
- “关于 → 检查更新”会检查后台发布版本；发现更新时可使用自动更新。
- 若自动更新失败，检查网络、软件目录写入权限和安全软件拦截，再通过软件内官方入口手动下载。
常见问题
提示未检测到 Node.js
部署要求 Node.js 24 或更高版本。安装后完全退出并重新启动 MSRPilot，再点击“部署”。如果终端能执行 node --version，但软件仍检测不到，重启 Windows 以刷新系统环境变量。
ms-playwright 安装异常
- 停止当前脚本。
- 打开“系统设置 → 环境管理 → 多项删除”。
- 选择“浏览器运行时”；依赖也异常时同时选择“项目运行目录”。
- 删除后重新部署。
账号配置未保存
返回账号配置，确认账号已启用、邮箱和密码完整，点击“保存账号”，然后重新部署。
登录失败或反复验证
- 关闭无头模式，观察浏览器实际提示。
- 检查密码、TOTP 密钥和恢复邮箱。
- 确认代理可用，且 HTTP 请求代理设置符合实际网络。
- 单独启用问题账号并把并发设为
1。 - 必要时仅删除“登录会话”，重新部署后登录。
任务慢、卡顿或频繁失败
- 将并发账号数降为
1-2。 - 暂时关闭并行搜索、随机点击和调试日志。
- 检查网络及代理稳定性。
- 将搜索延迟恢复到默认范围，避免过短。
- 一次只运行少量账号定位问题。
开机或定时启动后没有运行
依次确认：
- 自动启动或每日定时任务已启用；
- 对应的“自动运行脚本”选项已开启；
- 系统设置已保存；
- 环境状态为已部署；
- 授权有效；
- 账号和脚本配置修改后已重新部署；
- 触发时电脑已开机且当前 Windows 用户环境可用。
关闭窗口后程序仍在运行
这是“最小化到系统托盘”的预期行为。双击托盘图标恢复；需要完全退出时，从托盘菜单退出，或将关闭行为改为“直接关闭程序”。
在线客服无法发消息
- 新会话达到当日额度时，按提示稍后再试。
- 已关闭会话不能继续回复，请新建会话。
- 授权或客户端身份校验未就绪时，先检查授权状态和网络。
- 不要提交空内容或超过 2000 字的消息。
日常维护建议
- 更新软件后先查看版本说明，再用单账号验证。
- 账号或脚本配置修改后始终执行“保存 → 重新部署”。
- 排障时先看最后几条错误日志，再关闭无头模式复现。
- 多账号运行时逐步增加并发，不要一次拉满。
- 定时和开机自动运行启用后的第二天，检查一次数据概览与日志。
- 只清理解决问题所需的环境项，避免无故删除登录会话。
- 反馈问题时提供软件版本、发生时间、复现步骤和脱敏日志，不提供敏感凭据。
获取支持
- 软件内：打开“在线客服”发起会话。
- 版本信息：打开“关于”查看当前版本与机器码。
- 购买或续期：优先使用软件内“在线商城”，也可访问授权商城。