让 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.datis 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.
当前状态: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 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,代码里不出现产品名),再等一轮;
点不到就静默退回原来的判定,行为不劣化。
在 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 原本走 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 业务词表。
这是最新的一条,也是最"反直觉"的一条。接 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声明"我自己开一个":驱动走 CDPTarget.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—— 桌面客户端的登录态由客户端自己续期,免维护,最省心。
| 路径 | 适用 | 做法 |
|---|---|---|
| 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 因此真漏签一天,见下)。随机性必须留在进程内。
跑完一轮后默认做两件事:控制台摘要 + 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
这个项目是两个 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 -v333 项(319 单元 + 14 架构守卫),全部离线(不联网、不开浏览器),约 6 秒跑完:
- 单元测试:业务码与状态位判定、随机时刻分布、幂等 / 熔断 / 连续天数、退避抖动、 注入 JS 的转义与脱敏、运行锁互斥与持锁进程判活、配置加载、引擎各闸门分支、 bridge 路径(三段判定与降级)、昨日缺口补报、心跳周期。
- 架构守卫(14 项):入口可导入、无孤儿模块、冻结接口签名不漂移、CLI 参数集不变。
- 读真实配置文件的守卫:例如
TestScheduleWindowConsistency直接读config.yaml比对ScheduleConfig/load_config/window_bounds三方窗口值 —— 只改一处就会红。 这类守卫存在的理由:同一个值散写多处时,失同步只在"键缺失"时才显形,正常跑永远看不出来。 - 另有多项针对实测接口的回归断言(例如"status 必须 POST、不得使用已废弃的僵尸接口"), 它们的作用是防止有人把踩过的坑改回去。
这个项目在文档里保留了被推翻的中间结论和未验证项 —— 我认为这比粉饰更有价值。
auto(网页 cookie 路径)的写接口响应仍未直接观测过 —— 现在六个站点都走client, 网页侧浏览器当前没有站点在用。client路径下的写响应已实测观测 (2026-10-06 起 WorkBuddy bridge 路线跑通,data.status业务词表已在真机验证);auto侧仍保留双保险(业务词表 + code 规则),首次真跑前不做额外"验证性"写请求 (多发一次就多一分风险)。- 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 每次启动都会自动检查更新,而我们因为"没端口"每天要重启它一次 —— 所以"一签到就提示升级版本"是这两件事叠在一起,不是签到逻辑触发的。 更新装完它会自己再重启一次,这一次不带调试端口,于是次日又走一遍重启自愈。 - 客户端升级会同时动三处(2026-09-27 实测
0.4.2 → 0.4.3;2026-10-085.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,再从快捷方式重启客户端。
- 快捷方式参数可能被重置:
- 调试端口是一次性资源:被僵尸句柄占住后(症状:
netstat显示LISTENING, 但连不上也绑不了,netstat里记的 PID 已不存在)只能换端口或重启机器, 重启客户端也拿不回。所以端口值以各站点配方的client.debug_port为单一事实源 (Qoder=9340 / WorkBuddy=9336 / Trae=9338 / DuMate=9341 / 豆包工作=9342), 换端口是改一行的事。 ⚠ 9233/9334/9335/9337 等旧值已作废(被僵尸句柄占过),不要照抄旧文档。 - 计划任务只在有登录会话时运行(锁屏算、未登录不算)—— 开浏览器需要桌面会话。
MIT —— 随便用,但风险自担。
再次提醒:使用本工具产生的任何后果(包括账号被封禁)由使用者自行承担。