| name | rewards-server-actions |
| description | 抓取并更新微软 Rewards 新版 dashboard 的 Next.js Server Action hash（连击保护 toggleStreakProtection、领取奖励积分 claimBonusPoints）。当用户要更新连击保护、更新领取 dashboard 奖励积分、提到 Server Action hash 失效/过期、领取积分功能挂了、领积分 400/失败、或想重新抓 hash 时触发。开发维护微软 Rewards 脚本的 Server Action 适配时使用。 |
Rewards Server Actions:抓取并更新 hash
新版微软 Rewards dashboard（modern UI）基于 Next.js App Router,业务操作走 Server Action:
POST https://rewards.bing.com/dashboard,请求头 next-action: <hash> 标识具体动作。
hash 在 Next.js 编译时生成,微软重新部署后可能变化。本 skill 引导你重新抓取 hash 并写回代码。
涉及两个 Server Action:
toggleStreakProtection — 连击保护开关,body [true] 开 / [false] 关claimBonusPoints — 领取奖励积分,body []
工作流
第一步:读取当前代码状态
读 src/browser/BrowserFunc.ts 开头的两个常量,作为对照基准(执行时再读,不要凭记忆):
SUPPORTED_DEPLOYMENT_ID — hash 抓录时的部署版本(参考值)SERVER_ACTION_HASHES.toggleStreakProtection 和 .claimBonusPoints — 当前内置 hash
第二步:抓取新 hash
用 agent-browser 连接浏览器,在真实 dashboard 上触发动作,从 POST /dashboard 请求头里提取 next-action。详细步骤和踩坑提示见 references/capture-walkthrough.md,执行抓包前先读它。
抓包要点:
- 用独立 session(如
--session msr)启动 agent-browser,登录到 rewards.bing.com/dashboard
- 触发动作前先
network requests --clear + network har start
- 触发动作 → 抓
POST /dashboard 请求 → 解析其 next-action 头和 x-deployment-id 头
- 用 HAR 文件解析提取(不要靠目测),HAR 路径由
network har stop <path> 指定
第三步:对比并判断改不改
把抓到的 hash、x-deployment-id 和代码里的对照:
| 情况 | 处理 |
|---|
| hash 不变,只有 deployment-id 变 | hash 不用改;SUPPORTED_DEPLOYMENT_ID 可更新为参考(方案 A 后非必需,但保持准确更好) |
| hash 变了 | 更新 SERVER_ACTION_HASHES 对应键 |
| 完全抓不到请求 | 不是 hash 问题。常见是 cookie/session 过期、页面改版、网络问题,按 references/capture-walkthrough.md 的排障节排查 |
关键判断:hash 没变就不要改 hash。hash 是 Next.js 函数级标识,函数没改它就不变;微软多数重新部署只是重打包,hash 往往不变。盲目改对的 hash 反而会改坏。
第四步:更新代码并验证
改 src/browser/BrowserFunc.ts 对应常量后:
npm run build 编译,必须无错误- 确认
dist/browser/BrowserFunc.js 里新值已写入
- 告知用户改了什么、为何改(或为何不改),附上抓包对照表
重要约束
- 代码是单一来源:session 路径、常量行号、当前 hash 值等都从代码现读,不写进 skill。skill 只承载方法论。
- 幂等安全:两个 Server Action 都幂等(
toggleStreakProtection 已开启再调无害,claimBonusPoints 无积分时返回成功但不加分),抓包时反复触发不会损害账号。
- 方案 A 已落地:
SUPPORTED_DEPLOYMENT_ID 不匹配不再拦截调用(只记 warning),所以"部署版本不匹配"这条日志本身不是故障——只有 Server Action 真返回非 2xx 才需重新抓 hash。
- 遵循
AGENTS.md:中文输出,改代码前确认方案,代码改完更新相关文档/注释。
