Skip to content

About

配方驱动 + CDP 的每日签到自动化:站点知识外置 YAML,凭证不出浏览器/客户端。WorkBuddy / Qoder CN + 国际版 / Trae / DuMate / 豆包工作 · recipe-driven daily check-in automation

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

智能体签到 · Agent Check-In

让 AI 助手(编程类与办公类)的每日签到自动化 —— 站点知识全部外置为数据,凭证永不离开浏览器 / 客户端。

Automate daily check-ins on AI assistant platforms — coding and office alike. Site knowledge lives in YAML data; credentials never leave the browser or desktop client.

English — what this is, at a glance

A Windows scheduler that automates the daily check-in of six AI-assistant desktop clients (WorkBuddy, Qoder CN, Qoder International, Trae CN, DuMate, DoubaoWork) — without ever touching your credentials.

  • Recipe-driven. Every site is one YAML file under recipes/. Adding a site needs zero code changes, and no product name appears in the source tree.
  • CDP, not scraping. It attaches to an already-running client over the Chrome DevTools Protocol and calls the client's own bridge (window.wb.http, window.vscode.ipcRenderer, electronAPI.bceConsoleRequest) — the same path the client walks when you click the button yourself.
  • Opens the page it needs. When a check-in page only exists after clicking through a menu (Radix dropdowns ignore synthetic clicks), the recipe declares a URL and the driver spawns a tab in the client's own profile via Target.createTarget — then closes it by target id, never the user's tab.
  • Credentials never leave the client. No token reverse-engineering, no password storage, no device-identity forgery — reading auth.machine-id / auth.v1.dat is explicitly out of scope.
  • Randomized schedule. A fixed 09:55 wake-up, then the real moment is sampled from a Beta(2,2) distribution inside the window. Never on the hour; never via the Task Scheduler's own -RandomDelay.
  • Failures are loud. Desktop toast + optional QQ push. "Done" is never printed next to failures, because a green summary beside a red row is the worst possible notification.
  • 333 offline tests, ~6 s, no network and no browser.

⚠ Automating check-ins likely violates those platforms' terms of service. Use your own single account, single device, single network — and read the risk section before you start.

Python Tests Sites License Platform Deps

当前状态:6 个站点(WorkBuddy / Qoder CN / Qoder 国际版 / Trae CN / DuMate / 豆包工作)每日全自动运行中, 连续天数最长 40 天。333 项测试全绿。最后更新 2026-11-02。

目录

想看踩坑细节:DESIGN_NOTES.md(设计决策与实测)、HANDOFF.md(每轮交接日志)、AGENTS.md(多 Agent 协作契约)。


⚠️ 先读这段:风险声明

本项目会自动化执行五个平台的每日签到,这可能违反它们的服务条款。请你自己权衡用哪个账号。

  • 自动签到违反 Qoder / WorkBuddy (CodeBuddy) / Trae / DuMate(百度搭子)/ 豆包工作(DoubaoWork)的服务条款。无论做得多"像人",都存在账号被限制或封禁的风险,本工具无法保证不封号。
  • 项目内置的降风险设计(见下文)只是把风险压低,不是消除。
  • 只用你自己的单一账号、单一设备、单一出口网络;绝不批量、多号、代理轮换 —— 那才是真正触发风控的模式。
  • 项目明确不做的一件事:不读取、不复刻客户端加密的 auth.machine-id / auth.v1.dat —— 那等于伪造设备身份,正踩风控红线。Qoder 走的是"CDP 驱动客户端自己点自己的按钮",不碰任何接口。

这个仓库的主要价值在于工程实现本身(配方驱动架构、CDP 自动化、多 Agent 协同开发),而不是"帮你多领 100 积分"。请把它当技术参考,自己判断是否值得承担风险。


这是什么

一个跑在本机的每日签到调度器:

  • 每天在你设定的时间窗口内,随机挑一个时刻执行(不是固定整点 —— 固定时刻在系统层面一眼可辨);
  • 用 Chrome DevTools Protocol (CDP) 接管一个已登录的专用浏览器(auto 站点)或已运行的桌面客户端(client 站点),完成签到;
  • 全程不碰账号密码、不逆向 token、不伪造设备指纹 —— 鉴权由浏览器 / 客户端自己携带;
  • 结果写入本地状态文件(不含任何凭证),并给出桌面通知与连续天数统计。

真实运行输出:

  站点            模式       连续     今日失败      今日
  ----------------------------------------------------------
  doubaowork    client   14      0         已完成
  dumate        client   14      0         已完成
  qoder-intl    client   1       0         已完成
  qoder         client   39      0         已完成
  trae          client   22      0         已完成
  workbuddy     client   40      0         已完成

五个技术硬骨头

这个项目里真正的难点不是"发个 HTTP 请求",而是下面五件事。它们的排查过程和结论都写进了 DESIGN_NOTES.md。

① Qoder 的领取页不是网页,是"宿主驱动的 iframe"

官方口径是"领取渠道仅限 Qoder CN 桌面端"。那个 openapi.qoder.com.cn/growth-page/activity-iframe 看着像个网页,实测:

观察 结果
独立打开 渲染"活动加载失败",请求 GET /sash/api/v1/me/campaigns → 401 TOKEN_INVALID
该域下的 cookie 只有 arms_uid / isg / tfstk(风控基建),无任何登录态
通信方式 postMessage,且父窗口白名单限定 *.qoder.cn / qoder-cn: 等
源码行为 window.parent === window 时忽略所有消息,永远等不到数据

⇒ 浏览器自动化这条路根本不成立(登录也换不来数据)。

解法:既然只能在客户端里点,那就驱动客户端自己点。该 iframe 在 CDP 的 /json 里是一个独立的 OOPIF target,附着上去、派发一次完整 pointer 事件序列即可 —— 即 mode: client。

顺带一个坑:这种 UI 绑的是 pointerdown,el.click() 静默无效,必须派发完整事件序列。

② "客户端一直开着"时,自动化无从下手

调试端口只能在进程启动时绑定(Chromium 架构约束),而 Qoder 的单实例锁是全局的 —— 实测用隔离 --user-data-dir 起第二个实例,那个临时目录连一个文件都没写出来进程就没了。

解法:改造日常启动入口,让客户端启动时就带上 --remote-debugging-port。实测 Qoder 的 Launcher 会透传未知开关,于是把三个快捷方式入口都加上参数(工具:tools/win_shortcut_args.py,含备份与 --revert)。

⚠ 只改快捷方式不够 —— 还要改"开机自启"那条路(2026-10-10 真漏签)。客户端自己有自启动项时,开机后它由注册表 Run 键拉起,根本不经过快捷方式,于是那个实例没有调试端口,驱动只能降级为提醒。实测 WorkBuddy 5.7.7(10-08 升级)就带上了 HKCU\...\Run :: WorkBuddy.WorkBuddy。工具已支持:

python tools\win_shortcut_args.py --app workbuddy --autostart            REM 给 Run 键补端口
python tools\win_shortcut_args.py --app workbuddy --autostart --revert   REM 还原

端口值不写死在工具里 —— 以各站点配方的 client.debug_port 为单一事实源(换端口 = 改配方 → 重跑 --app <站点>;工具已泛化为 --app qoder|qoder-intl|workbuddy|trae|dumate|doubaowork,旧的 --qoder 仍兼容;--autostart 同样读配方)。备份只取最早那一份(不会被二次改造覆盖),所以任何一次改造都能 --revert 回到真正干净的状态。改完必须重启客户端才生效。

驱动随之采用四分支决策,核心原则是 不轻易动用户正在用的客户端 (2026-10-14 起有一处窄口例外,见下表 ③):

分支 条件 动作
① 读客户端日志,本窗口已领 连客户端都不启动
② 调试端口已就绪 直接接管;入口没自动出现就按配方把入口点出来,领完不关闭客户端
③ 客户端在跑但没开端口 按配方 wait_port_sec 守候(用户中途重启带上端口即接管);若命令行已带端口参数却连不上(listen() 失败,不会自愈)⇒ 配方开启 restart_on_bind_failure 时,先过"忙闲"关(有任务在执行就不重启,改为挂载监测等它跑完;看不清同样不重启),再自行重启并当场重试。⚠ 10-10 栽在"守候"缺失,10-14 栽在"绑定失败"
④ 客户端没在跑 才由我们拉起 → 领取 → 关掉自己起的那个

② 这一行藏着一个反直觉的坑(2026-09-26 实测踩到,当天没能自动领到): 业务入口是否自动打开由「应用启动那一刻」的服务端状态决定 —— 客户端整天开着时, 次日状态翻成"可领"后入口不会自己出现,"端口已开"于是反而成了唯一拿到空窗口的路径。 所以②分支在等待入口失败后,会按配方声明的一串入口逐级点击把它调出来 (client.open_entry_labels,代码里不出现产品名),再等一轮; 点不到就静默退回原来的判定,行为不劣化。

⚠️ 代价(知情后接受):端口常开意味着本机任何进程都能连上接管该客户端的渲染进程。

③ Agent 的运行环境会"毒化" GUI 进程

在 AI Agent(或它派生的 shell)里启动 Electron 应用,环境里往往带着 ELECTRON_RUN_AS_NODE=1 —— 应用会退化成 Node 进程:不初始化 Chromium、不建窗口、不绑调试端口,跑完脚本就退出。

症状极具误导性:只剩一个 native-messaging 宿主进程、日志目录不产生新 session、报错来自 Node 的参数解析器。

解法:core/procenv.py 在派生子进程前清洗环境(剥离 ELECTRON_RUN_AS_NODE / NODE_OPTIONS / 各类 Agent 命名空间变量)。

A/B 实测对照:不清 → 40 秒端口未就绪;清了 → 2 秒就绪。

④ WorkBuddy 的网页登录态只有 7 天 —— 于是也搬进了客户端

WorkBuddy 原本走 auto(在浏览器页面上下文里 fetch),但网页侧的 session cookie 实测有效期 168 小时(恰好 7 天),到期只能人工重登,天天访问也并不能无限续期。 实测 09-28 重登 → 10-06 又过期,是周期性发生的结构性成本 —— 每次过期都靠"主动提醒"才不至于静默漏签。

解法:改走 mode: client,用客户端自己的 http 通道(window.wb.http)调同一个接口 (客户端日志实证 check-in outgoing path=/v2/billing/meter/daily-checkin hasToken=true)—— token 由客户端主进程注入并自行续期,我们不再需要维护任何登录态。 这条路不点 UI 而是直接调接口(签到横幅是按需渲染的,今天已签时根本不挂载), 不受 shadow DOM 与服务端下发文案变化影响,比点按钮稳;判定仍完全复用配方的 verdict 业务词表。

⑤ 猜 UI 不如先找桥(2026-10-12 接入 Trae CN)

这是最新的一条,也是最"反直觉"的一条。接 Trae CN 时先按惯常套路写了套 DOM 方案 —— 两条假设全错,而且错得悄无声息:

当时猜的 实测
它是 VSCode 内核 ⇒ 主窗口 URL 是 workbench.html 跑的是 Solo Lite 新 UI,真实 URL 是 vscode-file://vscode-app/... ⇒ 这个串永不命中
点左下角账号头像 → 找「每日签到」 button.accountTrigger-*(class 带构建期 hash、无 aria-label)点开的是付费页(z=9999「升级权益」全屏面板)

⚠️ 注意这两种错的失效方式:_wait_target 匹配不到就返回 None,驱动报 no_action —— 不报错、不弹窗、不提醒,只会每天安安静静地什么都不干。这正是本项目最怕的失效模式。

解法:Trae 把接口桥在了 renderer 里,于是不再去点 UI,直接调客户端自己的 IPC 通道:

workbench.action.icubeClaimCheckinCredits
  → claimIdeCheckinCredits → claimCheckinCredits()
  → ipcRenderer.invoke('vscode:sandbox::main-invoke-claimCheckinCredits')
  → 主进程 ttnet → POST /trae/api/v2/ug/checkin_credits/claim

这正是客户端自己点签到按钮时走的同一条路(window.vscode 是 Electron preload 经 contextBridge 暴露的桥)—— 不伪造请求、不碰 token、不读设备身份文件。

准则:客户端把接口桥在 renderer 里时,先找桥,别猜 UI。 桥找不到,再谈 DOM。 配套守卫:test_bridge_sites_declare_a_reachable_target —— bridge 站点的 target_match 必须非空且为实测值(这条守卫就是这次栽出来的)。

同一准则第二次奏效(2026-10-20 接入 DuMate):它的前端是 file:// origin, 页面里直接 fetch 会被 CORS 拦掉,所以"先找桥"不是偏好而是唯一出路 —— 最终在 preload 里找到 window.electronAPI.bceConsoleRequest,正是它日志里 [BceConsoleRequest][fe] 走的同一条通道。 ⇒ 一条准则能被两个独立站点各自验证一次,才值得写进文档。


支持的平台

平台 模式 做法 为什么
WorkBuddy (codebuddy.cn) client CDP bridge:在客户端页面上下文里调用它自己的 http 通道(window.wb.http),走 /v2 桌面端前缀 免维护登录态 —— 客户端自己持有并续期 token;网页侧 cookie 只有 168 小时(7 天) 就会过期,周期性要求人工重登
Qoder CN client CDP 驱动桌面客户端点它自己的按钮 网页入口不存在(见上文 ①);且不伪造设备指纹
Qoder 国际版(qoder.sh) client 同国区,但走英文 UI:用户菜单(Open user menu)→ Rewards center → Claim 与国区同因(活动页是宿主注入 token 的 OOPIF,独立打开收不到消息);判据与文案全在配方里 —— 国际版 UI 是英文,照抄国区中文入口会每天静默漏签
Trae CN client CDP bridge:调客户端自己的 IPC 通道(window.vscode.ipcRenderer.invoke('vscode:sandbox::main-invoke-claimCheckinCredits')) 签到入口藏在新版 Solo Lite UI 的账号菜单里(点开还会落到付费页);IPC 是客户端自己点签到按钮时走的同一条路,不碰 token / 设备身份文件
DuMate(百度搭子) client CDP bridge:调 preload 暴露的 window.electronAPI.bceConsoleRequest(客户端自己的请求通道) 前端是 file:// origin,页面里直接 fetch 会被 CORS 拦掉,必须走它自己的桥;判据是 loginBonusInfo 的 hasIssued,500 分/天
豆包工作(DoubaoWork) client CDP bridge + 自建页面:Target.createTarget 在客户端同一个 profile 里开活动页(doubao.com/pc/agent-explore),在页面里 fetch 活动接口;接口被拒时改点页面自己的按钮,用完关掉 签到入口是内置浏览器里的一个活动页,平时根本不存在(点菜单「免费领额度」才打开);判据是 daily_signin 任务的 task_status==3,200 额度/天(周一翻倍 400)。⚠ 直连接口必须带 SDK 生成的 AgwCommonParam/biz_params,我们不伪造签名 ⇒ 用按钮兜底

新增站点不需要改一行代码 —— 在 recipes/ 放一个 YAML 即可。

⚠ 豆包工作这条最特别:它的签到页不是你随便能打开的一个 URL —— 平时它不存在, 只有用户点开左下角菜单的「免费领额度」,客户端才会用内置浏览器打开它。 那个菜单是 Radix 组件(合成 click() 无效,只能发真实鼠标事件,坐标还随窗口尺寸变)。 ⇒ 配方用 open_target.url 声明"我自己开一个":驱动走 CDP Target.createTarget, 在**同一个 profile(同一份登录态)**里开页面,用完按 targetId 关掉 —— 不点 UI、不赌"用户此刻正好开着那个标签页"、也不会误关用户自己那个。 判据同样是服务端的 task_status,不是 claim 的返回值。

⚠ DuMate 有个反直觉的点:loginBonus 返回 result: true 不代表今天新领到了 —— 当天已领时再 POST 服务端照样回 true,但积分和 signInDays 一动不动。 所以判据只能落在「领取后重读一次状态」上(驱动 _claim_via_bridge 第 3 步就是干这个的)。 只看 claim 的返回值,会每天错误地报告成功。

⚠ 还有一个"看起来没签上"的坑:客户端的签到状态只在页面加载时拉一次 (useEffect 挂载时调 hydrateStatus();focus / visibilitychange 都实测过,零重拉)。 我们走 bridge 把接口调完了,它的 store 一无所知 ⇒ 侧边卡片仍写"立即签到", 用户会以为没签上,手动再点一次 —— 而 UI 的 claim 是本地乐观 +500,服务端不会再加, 账面反而比实际多 500。 ⇒ 配方开关 refresh_ui_after_claim: true:真新领取 + 客户端空闲时让页面重载一次 (_cpu_busy 返回 None 也算忙 —— 宁可界面滞后,也不打断正在跑的会话)。 判据永远是服务端的 hasIssued,界面只是显示。

auto(在已登录浏览器页面上下文里 fetch)与 manual(只发提醒)两种模式仍然保留、可用; 只是当前六个站点都走 client —— 桌面客户端的登录态由客户端自己续期,免维护,最省心。

接入一个新站点的两条路(2026-10-12 补)

路径 适用 做法
bridge 客户端把接口桥在了 renderer 里(WorkBuddy 的 window.wb.http、Trae 的 window.vscode.ipcRenderer、DuMate 的 window.electronAPI.bceConsoleRequest) 配方写 client.bridge.status_js / claim_js 两段 JS;驱动只负责执行与判定,不认识任何产品名
DOM 签到是客户端里一个独立活动页 target(Qoder 的 growth-page iframe) 配方给 target_match + claim_button + claimed_markers,驱动等 target → 点按钮 → 读确认文案

⚠ bridge 站点的 target_match 必须写实测值。Trae 接入时就栽在这上面:曾凭直觉写成 workbench.html, 而它真实的 renderer URL 是 vscode-file://vscode-app/... —— 空 match / 错 match 在 _wait_target 里 永不命中,结果是每天静默 no_action(不报错、不提醒)。已立守卫 test_bridge_sites_declare_a_reachable_target。


快速开始

环境:Windows + Python 3.9+(脚本会自动建 venv 装依赖)。用 Edge 或 Chrome 均可。

REM 0) client 站点(当前四站都是):让客户端启动即带上调试端口
python tools\win_shortcut_args.py --app doubaowork     REM qoder | workbuddy | trae | dumate | doubaowork
REM    ↑ 改完必须【重启客户端】才生效 —— 调试端口只能在进程启动时绑定

REM 1) 首次:打开"签到专用浏览器",在里面人工登录一次(登录态长期复用)
run_checkin.bat --login

REM 2) 日常:执行签到(会先等到窗口内的随机时刻)
run_checkin.bat

REM 3) 注册每日计划任务(推荐,自动处理引号 / 中文路径 / 编码)
run_checkin.bat --install-task
  • 专用浏览器使用独立 profile(%LOCALAPPDATA%\AgentCheckIn\chrome-profile),与你日常浏览器完全隔离。
  • 本机没装 Chrome 时会自动退回 Edge —— 属正常降级。
  • 登录成功的硬证据在 cookie 里(codebuddy.cn 域下会出现 KEYCLOUD_SESSION / session)—— 这一步只有新增 auto 站点时才需要;当前六个站点都走 client,登录态由客户端自己维护。

排查用(全部只读,绝不触发签到)

python -m checkin --status      REM 各站点状态、连续天数、今日失败次数
python -m checkin --probe       REM 探针:报登录态与真实签到状态
python -m checkin --plan        REM 今天计划几点执行
python -m checkin --dry-run     REM 演练:走完整流程但不触发、不记状态

命令

run_checkin.bat 与 python -m checkin 是同一套参数(前者是后者的包装,会自动建 venv 装依赖)。

python -m checkin --login              # 打开专用浏览器,人工登录一次
python -m checkin                      # 执行签到(先等到窗口内的随机时刻)
python -m checkin --now                # 立刻执行,不等窗口(人工补跑用;计划任务不走这条)
python -m checkin --only-site workbuddy
python -m checkin --status [--json]    # 状态报表
python -m checkin --install-task       # 注册每日计划任务
python -m checkin --uninstall-task
python -m checkin --print-task         # 打印等价的手写注册命令

注意:run_checkin.bat 结尾带 pause,不要直接放进计划任务。用 --install-task。

必须用 --install-task 注册。计划任务的工作目录是 C:\Windows\System32,用 python -m checkin 会以 No module named checkin 每天准时失败且不弹窗。现在改为直接执行 src/checkin/__main__.py(它自己会挂 sys.path),与工作目录无关。

任务用 pythonw.exe(无控制台) 运行,随机时刻由程序自己在窗口内采样后等待(core/scheduler.py 的 Beta(2,2) 采样)—— 所以运行期间不会出现黑框。

⚠ 不要给触发器加 -RandomDelay:那会让当日 occurrence 被调度器静默判为 missed 后跳次日(2026-10-10 因此真漏签一天,见下)。随机性必须留在进程内。


结果通知:桌面 toast +(可选)推送到 QQ

跑完一轮后默认做两件事:控制台摘要 + Windows 桌面 toast。出问题时标题必然换掉 ("签到我处理不了"),因为"完成"配一堆失败是最坏的通知 —— 看到"完成"人就不会去查。

想让结果直接到手机上,可以开启 QQ 推送(2026-10-14 新增,纯标准库实现、无新依赖):

REM 0) 从模板起步(含分步说明)
copy tools\notify.example.json data\notify.json
REM 1) 只填 app_id / app_secret:
REM    { "qq_bot": { "app_id": "你的AppID", "app_secret": "你的AppSecret" } }
REM    机器人还没上架时,**先在后台开通私聊**:开发管理 → 沙箱配置 → 单独聊天
REM    → 选「在消息列表配置」→ 添加成员(填你自己的 QQ 号)→ 用手机 QQ 扫码添加机器人。
REM    漏掉这一步,QQ 里根本不会出现这个机器人,发什么都没反应。
REM 2) 抓接收方标识(运行后按提示给机器人发一条**私信**即可,或拉群)
.venv\Scripts\python.exe tools\qq_bot_openid.py

配好之后,"今天有没有需要我处理的"会自己推到你手机上 —— 不用再翻日志。 一天十几次机会里,同一份结论只推一条:结论没变就不打扰(notify 同日去重), 变了(比如某个站点终于领到)才发。

之后每天签到跑完,你会收到一条这样的消息:

【每日签到 10-14】已签到 qoder、trae、workbuddy
为什么这么绕 说明
为什么不直接用 WorkBuddy 的 QQ 通道 签到是 Windows 计划任务跑的,WorkBuddy 全程不参与;而 WorkBuddy 的「定时任务结果通知」只支持企微 bot / 小程序。它那个「QQ 机器人」是助理远程通道(方向是 你→WorkBuddy,用来远程下指令),不是结果通知出口
单聊还是群聊 推荐单聊:给机器人发条私信就能拿到 openid,不用建群。二者限额同级 —— 官文(消息收发概述)当期版本写明单聊主动消息每日 1000 条/用户、群聊每日 1000 条/群。早期版本写死了"必须群聊",依据是"私聊每月 4 条",那出自过时资料,害得多折腾三轮。⇒ 限制类结论一定要回官文当期版本核对
为什么消息里没有 emoji 消息可能经过 GBK 环境(Windows 控制台/日志),emoji 会触发 UnicodeEncodeError(接入时踩过)
凭据放哪 data/notify.json —— .gitignore 已覆盖 data/,绝不进开源仓库。文件不存在 = 未开启,对没配的人零影响
连接正常、心跳正常,就是收不到事件 按这个顺序排:①是不是同时起了两个监听进程 —— 同一 AppID 的 WS 全平台只允许一条,两个都在重连循环里会互相挤掉,谁都活不长;症状与"被别人抢线"一模一样,所以很容易被甩锅给平台。排查前先 Get-CimInstance Win32_Process 看命令行里有没有第二个 qq_bot_openid.py ②后台「开发管理 → 事件订阅」勾了没 ③机器人是否「已上线」 ④未上架的机器人在「沙箱配置」里有没有把你加成成员并扫码
连上正好第 60 秒必断 没有发应用层心跳。本机会话注入了代理(getpeername() 返回 127.0.0.1:<随机端口>),代理对空闲隧道有 60 秒超时,且掐掉时不给关闭帧 —— 看着像被抢占,其实是自己没发包。TCP keepalive 救不了这条(只到代理那一跳),必须按 HELLO 下发的 heartbeat_interval 发应用层心跳
通知会不会影响签到 不会。推送链路上任何一步失败都只记日志(有守卫 test_qq_failure_never_breaks_checkin 钉住)

工作方式

配方驱动:站点知识是数据,不是代码

recipes/*.yaml 描述一个站点的全部知识(URL、接口、判定规则、模式),代码里不出现任何产品名。停用站点把 enabled 改成 false 即可。

id: workbuddy
mode: auto              # auto | client | manual | disabled
session: { start_url: ..., tab_match: ... }
actions: { status: {method: POST, path: ...}, trigger: {...} }
verdict:                # 把业务码映射到统一语义,而不是看 HTTP 状态码
  rules: { ... }
  unknown_result: no_action     # 前端改版时不乱枪调用

判定哲学:宁可"什么都不做",也不猜成功

  • 不信 HTTP 状态码。签到成功时接口可能返回 HTTP 400,同时业务 code = 0。
  • 只看响应体业务码,并且再看 data.today_checked_in 确认"今天到底领没领"。
  • 读 data.status 的业务词表(claimed / already_claimed / event_ended…),未知取值一律 no_action。
  • 已签就收手 —— 状态接口声明今日已签时,不再发那一次写请求。少一次交互就少一分被注意的理由。

降风险设计(对应实现位置)

措施 实现
凭证不出浏览器 不逆向加密 token、不存账号密码;请求在已登录页面上下文里 fetch,浏览器自动带鉴权与真实 TLS/HTTP2 指纹(browser/page_script.py)
随机执行时刻 计划任务在固定的 09:55(窗口开始前 10 分钟)唤醒;真正的执行时刻由 core/scheduler.py 在窗口内按 Beta(2,2) 采样后等待到点 —— 向窗口中部聚集、两端稀疏。不是固定整点。窗口写在 config.yaml 的 schedule.window_start/end(当前 10:05–11:00,是唯一真值,改一处即可)。⚠ 刻意不用计划任务的 -RandomDelay —— 它会让当日 occurrence 被静默跳过(2026-10-10 事故)
不弹窗 任务用 pythonw.exe(无控制台)运行;派生的 powershell 子进程一律带 CREATE_NO_WINDOW,sys.stdout/stderr 为 None 时有兜底 —— 全程无可见窗口(进程会静默等待,但看不见)
一天 11 次机会(主触发 + 30 分钟重试网格 + 收尾) 计划任务触发:09:55(主,窗口内随机)+ 11:00–15:00 每 30 分钟一次(共 9 次)+ 21:00(收尾)。网格是为豆包工作加的——它的签到闸门每天在随机时刻开放(客户端气泡实证 11:01 / 13:28 / 14:32,业务码 710010702),窗口太稀就必然慢一步,11-06~11-08 连续三天都是用户看到气泡自己点的。已成功的站点被幂等拦下;同一天内容相同的结论只推一条(notify 同日去重),所以多跑几次不会变成噪音。⚠ 改了窗口必须重跑 --install-task:兜底时刻是从窗口推导的,但它写死在注册好的任务里,不会自己跟着变(2026-10-20 压窗口时踩过:任务里还挂着 13:00)
单实例运行锁 core/lock.py:系统级文件锁,防"计划任务 + 手动双击"并发导致重复打接口;进程退出自动释放。⚠ 进程被杀时 release() 不会执行,所以判陈旧先看持锁 PID 在不在(procenv.pid_alive),不在就立即接管 —— 只按时间戳判的话会白压 30 分钟、期间每次运行都被整轮跳过
整轮预算 + 两遍扫描 core/models.RunBudget + engine.py:一轮有总预算(默认 30 分钟)。第一遍每个站点最多等 first_pass_wait_cap_sec(25s),卡住的立刻让位;跑完一遍后用剩余预算回头补领。这条是 2026-10-17 三站全军覆没的根因修复 —— 那时站点串行,第一个卡住就把后面的全饿死,连通知都发不出来
昨日缺口补报 StateStore.missed_days() + __main__._collect_gaps():每天第一次运行会回头看上次完成之后到昨天为止有没有洞。计划任务 missed / 程序卡住 / 机器没开机 —— 任何一种都会让"昨天"整体消失,而第二天照常报"今日已完成",那个洞永远不提。现在会明确播报(昨天漏签了 / 漏签 N 天),一天只报一次。⚠ 缺口必须在引擎跑之前取:今天一签上 last_done_date 就变成今天,那时回溯只会得到"没有缺口"
进程判活看退出码 procenv.pid_alive():OpenProcess 对已退出但句柄还被父进程握着的僵尸进程照样返回句柄(实测 6/6)⇒ 只看句柄会恒判"活着",运行锁的判活就成了摆设。必须再调 GetExitCodeProcess,只有退出码仍是 259(STILL_ACTIVE) 才算活着
当日幂等 core/state.py + engine.py:已成功/已签的站点当天不再打接口
拟人节奏 触发前随机延迟 1.5–6s、站点间随机间隔 25–90s(core/jitter.py)
失败即停不轰炸 仅未知错误指数退避重试(默认 2 次);401 / 需登录 直接转人工、绝不硬刚;连败 3 次当日熔断
日志脱敏 core/log.py 的 RedactFilter:token / cookie / Authorization 打码;状态文件不含任何凭证
进程环境清洗 core/procenv.py:剥离 Agent 注入的 ELECTRON_RUN_AS_NODE 等变量

目录结构

.
├─ run_checkin.bat            # 日常入口(自动建 venv、装依赖、跑主程序)
├─ config.yaml                # 全局运行参数 + 安全策略(端口、随机窗口、延迟、熔断阈值…)
├─ recipes/                   # ★ 站点配方:站点知识全部是数据,不是代码
│   ├─ workbuddy.yaml         #   mode: client(bridge 调客户端 http 通道 + verdict.rules 业务码判定)
│   ├─ qoder.yaml             #   mode: client(CDP 驱动桌面客户端自己点按钮领)
│   ├─ trae.yaml              #   mode: client(bridge 调客户端 IPC 通道,不点 DOM)
│   ├─ dumate.yaml            #   mode: client(bridge 调 electronAPI.bceConsoleRequest,读 hasIssued 判据)
│   └─ doubaowork.yaml        #   mode: client(open_target 自建活动页 + bridge 调活动接口,读 task_status)
├─ tools/
│   ├─ qoder_cdp_probe.py     # 只读侦察(定位活动入口,不点击)
│   ├─ trae_cdp_probe.py      # 只读侦察(穿透 ShadowRoot;VSCode 系 UI 大量藏在里面)
│   ├─ qoder_cdp_claim.py     # client 驱动的薄封装(launch / status / claim / close)
│   ├─ qq_bot_openid.py       # 一次性抓接收方 openid(**私信优先**,抓完就再也用不到长连接)
│   └─ win_shortcut_args.py   # 读写启动入口参数(.lnk + 自启动 Run 键):让客户端启动即带调试端口(含备份/回滚)
├─ src/checkin/
│   ├─ __main__.py            # 唯一 CLI 入口
│   ├─ core/                  # models / config / engine / scheduler / lock / state
│   │                         #   / jitter / procenv / log / notify
│   ├─ browser/               # launcher(拉起带调试端口的浏览器)/ cdp(极简 CDP 客户端)
│   │                         #   / page_script(注入页面的 JS)
│   └─ drivers/               # browser_page(auto)/ client_claim(client)/ reminder(manual)
├─ tests/
│   ├─ test_core.py           # 离线单元测试(不联网、不开浏览器)
│   └─ test_architecture.py   # 架构守卫:孤儿模块 / 签名漂移 / 入口唯一性
├─ AGENTS.md                  # ★ 多 Agent 协作契约
├─ HANDOFF.md                 # ★ 交接日志
├─ DESIGN_NOTES.md            # 设计决策与实测记录
└─ README.md

多 Agent 协同:这个项目本身的另一条主线

这个项目是两个 AI Agent 在同一个目录里并行写出来的(Qoder 侧开发 Agent + WorkBuddy 侧 Agent)。而这件事一开始翻车了:

一方按"自己版本的入口文件没有引用它"判定某个模块是死代码,把它删掉 —— 而另一方正在用它。 结果是 ModuleNotFoundError 的中间态。

于是固化了三个东西,把"靠自觉"变成"靠机制":

文件 / 机制 作用
AGENTS.md 协作契约。6 条铁律、冻结接口清单、文件所有权表。最关键的一条:「入口没引用」≠「死代码」,删除必须走审批(grep 全仓 → 登记 → 改名观察一回合)
HANDOFF.md 交接日志。每轮收工追加一条,最新在最上。开工先读第一条
tests/test_architecture.py 机械守卫。把契约变成断言 —— 违约时测试直接红,不靠自觉

如果你也在做多 Agent 同目录协作,这部分可能比签到功能本身更有参考价值。


测试

.venv\Scripts\python.exe -m unittest discover -s tests -v

333 项(319 单元 + 14 架构守卫),全部离线(不联网、不开浏览器),约 6 秒跑完:

  • 单元测试:业务码与状态位判定、随机时刻分布、幂等 / 熔断 / 连续天数、退避抖动、 注入 JS 的转义与脱敏、运行锁互斥与持锁进程判活、配置加载、引擎各闸门分支、 bridge 路径(三段判定与降级)、昨日缺口补报、心跳周期。
  • 架构守卫(14 项):入口可导入、无孤儿模块、冻结接口签名不漂移、CLI 参数集不变。
  • 读真实配置文件的守卫:例如 TestScheduleWindowConsistency 直接读 config.yaml 比对 ScheduleConfig / load_config / window_bounds 三方窗口值 —— 只改一处就会红。 这类守卫存在的理由:同一个值散写多处时,失同步只在"键缺失"时才显形,正常跑永远看不出来。
  • 另有多项针对实测接口的回归断言(例如"status 必须 POST、不得使用已废弃的僵尸接口"), 它们的作用是防止有人把踩过的坑改回去。

已知限制(诚实记录)

这个项目在文档里保留了被推翻的中间结论和未验证项 —— 我认为这比粉饰更有价值。

  1. auto(网页 cookie 路径)的写接口响应仍未直接观测过 —— 现在六个站点都走 client, 网页侧浏览器当前没有站点在用。client 路径下的写响应已实测观测 (2026-10-06 起 WorkBuddy bridge 路线跑通,data.status 业务词表已在真机验证); auto 侧仍保留双保险(业务词表 + code 规则),首次真跑前不做额外"验证性"写请求 (多发一次就多一分风险)。
  2. Qoder 客户端升级可能改版:若按钮文案 / DOM 变化,驱动返回 no_action 并提示人工查看, 不会静默假成功。 ⚠ 判断"客户端是哪个版本"不能看卸载登记里的 DisplayVersion —— 2026-10-21 实测: 登记为 0.4.8,而实际运行的是 0.2.5。真实版本只在两处: ① main.log 里更新请求 URL 的 .../stable/<版本>;② .qoder-versions\<版本>\ 目录。 (0.2.5 → 0.4.8 是 2026-10-21 客户端自己更新上去的;更新前的 24 天连续签到都是在 0.2.5 上跑通的,0.4.8 上的首跑尚未发生。)后续每次升级都要重新确认按钮文案。 ⚠ 另外:Qoder 每次启动都会自动检查更新,而我们因为"没端口"每天要重启它一次 —— 所以"一签到就提示升级版本"是这两件事叠在一起,不是签到逻辑触发的。 更新装完它会自己再重启一次,这一次不带调试端口,于是次日又走一遍重启自愈。
  3. 客户端升级会同时动三处(2026-09-27 实测 0.4.2 → 0.4.3;2026-10-08 5.7.6 → 5.7.7 又动了一处):
    • 快捷方式参数可能被重置:开始菜单 那个入口会被应用回写成无参数版 (已加只读保护挡住;升级时它若重建失败属正常,data/shortcut_backup/ 有原始备份)。
    • 新增"自启动 Run 键"(2026-10-08 WorkBuddy 5.7.7 实测):升级后应用把自己装进 HKCU\...\Run,开机自启的实例绕过快捷方式、没有调试端口。
    • 更难查的一种:升级时启动器会自己把应用重启一遍(state.ini 的 updatedAt 与应用的启动时刻重合,且同一刻 targetVersion 发生切换),这一次重启不带 透传的调试开关 ⇒ 端口没开,驱动只能走 ③ 降级提醒。 ⇒ 升级后:重跑 python tools/win_shortcut_args.py --app qoder|qoder-intl|workbuddy|trae|dumate|doubaowork 以及 ... --app workbuddy --autostart,再从快捷方式重启客户端。
  4. 调试端口是一次性资源:被僵尸句柄占住后(症状:netstat 显示 LISTENING, 但连不上也绑不了,netstat 里记的 PID 已不存在)只能换端口或重启机器, 重启客户端也拿不回。所以端口值以各站点配方的 client.debug_port 为单一事实源 (Qoder=9340 / WorkBuddy=9336 / Trae=9338 / DuMate=9341 / 豆包工作=9342), 换端口是改一行的事。 ⚠ 9233/9334/9335/9337 等旧值已作废(被僵尸句柄占过),不要照抄旧文档。
  5. 计划任务只在有登录会话时运行(锁屏算、未登录不算)—— 开浏览器需要桌面会话。

许可

MIT —— 随便用,但风险自担。

再次提醒:使用本工具产生的任何后果(包括账号被封禁)由使用者自行承担。

About

配方驱动 + CDP 的每日签到自动化:站点知识外置 YAML,凭证不出浏览器/客户端。WorkBuddy / Qoder CN + 国际版 / Trae / DuMate / 豆包工作 · recipe-driven daily check-in automation

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages