WorkBuddy Toolkit: Multi-Account Manager & Automated Check-in

WorkBuddy (腾讯开源/商业化 AI 编程助手) 多账号无缝轮换、全域工作区打通、自动化静默签到、容灾路由网关、独立免登扫码与沙盒日志自愈治理工具箱。
深入逆向底层 SQLite 存储隔离机制、腾讯云鉴权、5.6+ 本地凭证加密协议、/v2/chat/completions SSE 流式协议与沙盒日志生命周期，原生全面适配 macOS、Linux 与 Windows 三大操作系统，打造零侵入、高内聚、零打扰的本地自动化工作流。

---

🤖 复制发给你的 AI Agent：一键全自动安装与自适应调度

只需将下方提示词直接复制并发送给你的终端 AI Coding Agent（如 Antigravity、WorkBuddy、Claude Code、Hermes、OpenCode、Codex 或 Cursor），Agent 将自动识别当前操作系统（macOS / Linux / Windows）、全自动拉取仓库、安装配置、智能探测自身的 schedule 调度能力并向你输出交付报告：

请帮我安装并配置 WorkBuddy 多账号管理与自动化签到工具包 (workbuddy-toolkit)：
1. 识别当前操作系统平台（macOS、Linux 或 Windows），克隆开源仓库：
   git clone https://github.com/FlapPearLabs/workbuddy-toolkit.git ~/.workbuddy/toolkit
2. 进入目录并执行适配当前系统的一键安装程序：
   - 跨平台通用推荐方式（任何操作系统均可用）：
     cd ~/.workbuddy/toolkit && python3 install.py   (Windows 下执行: python install.py)
   - 或使用系统原生安装脚本：
     macOS / Linux : cd ~/.workbuddy/toolkit && ./install.sh
     Windows (PowerShell) : cd ~\.workbuddy\toolkit ; .\install.ps1
3. 执行 `workbuddy init` 确保全域工作区打通触发器已激活；
4. 执行 `workbuddy doctor` 诊断本地凭证格式与解密运行时兼容性；
5. 执行 `workbuddy status` 检查当前账号状态与已存凭证库；
6. 智能探测你自身（当前 AI Agent）是否拥有内置的 `schedule` / cron 调度功能：
   - 【若拥有 schedule 功能】（如 Antigravity、WorkBuddy 等内置调度器）：
     默认使用你的 schedule 工具注册一个每日定时任务（Cron: 0 9 * * *, 触发时运行 workbuddy checkin 自动执行签到与每日对话保活，并向我汇总汇报收益）。
     同时询问我：“已为您默认配置每天早晨 09:00 自动打卡（含每日签到积分与连续对话保活）并汇报，请问您是否需要调整打卡时间或汇报偏好？”
   - 【若没有 schedule 功能】（如部分普通 CLI Agent）：
     如实告诉我当前环境没有内置 Agent 调度能力，并请我选择签到方式：
     ① 采用安装脚本已配置的系统原生守护定时打卡（macOS launchd / Linux systemd timer / Windows 任务计划程序，每天 09:00 静默打卡写入日志）；
     ② 完全关闭后台自动打卡，后续每次由我手动在终端输入 `wb-checkin` 随时打卡。
7. 向我汇报最终安装与配置结果，并指导我如何使用 `wb-help`（查看可用命令与功能列表）、`wb-login`（免打开客户端扫码入库）、`wb-list` / `wb-status`（账号状态全景与 JSON）、`wb-switch`（免扫码秒切账号）、`wb-checkin`（签到+对话）、`wb-chat`（CLI 直接调用模型）、`wb-router`（容灾轮换路由）、`wb-models`（模型透视）以及 `wb-doctor`（兼容诊断）。

---

⭐ 核心优势：多账号快速轮换与 WorkBuddy 5.6+ 加密凭据原生兼容

💡 【薅算力经济学：10 分钟配置，月领 10,500 积分，立省 140+！省下的钱开 GPT Plus 多带劲！】

• 算力倒赚：三个号花 10 分钟配置下我们的工具，每日自动化静默签到就是 3000 * 3 + 500 * 3 = 10,500 积分，大于每个月 140 订阅高级版的 9,000 积分还多 1,500 积分，立省 140+！
• 重度耐用（成本为 0）：假设使用高性价比主力模型 DeepSeek V4.1 Flash 干活，每小时约消耗 60 积分，10,500 / 60 = 175 小时 不间断运行！相当于全月每天长达 5.8 小时 重度使用不间断才能用完。3 个号直接覆盖绝大多数普通开发者的日常 Token 需求，价格为 0，配置只需 10 分钟！
• 降维消费：每个月省下来的 140 块钱拿去开个 ChatGPT Plus，又是每个月多出几个亿的高质量 Token 额度，还附带顶级 GPT 网页端对话与 GPT Live 实时语音（全天候陪聊、沉浸式练外语口语），多带劲！

| 对比维度 | 传统 WorkBuddy 官方体验 | 使用 WorkBuddy Toolkit | | :--- | :--- | :--- | | 多账号录入 | 必须打开臃肿 Electron 客户端、退出当前账号、掏出手机扫码，极易顶掉旧账号 | 独立免登终端扫码 (wb-login)：无需启动客户端 UI，终端直接呈现高清 QR 码，扫码即自动入库，智能消解别名冲突 | | 多账号切换 | 每次换号必须在微信上重新掏出手机扫码，频繁中断思考 | 免除微信反复扫码：保存已登录凭据 Profile 后随时秒级直切，即切即用！ | | 账号状态与列表 | 官方无全景透视，无法感知 Token 与 RefreshToken 剩余有效期与健康度 | 多维全景与程序化透视 (wb-list / wb-status)：支持文本清单与 --json 规范输出，UID、存储格式与双到期时间一览无余 | | 凭证健康巡检 | 账号静默失效毫无感知，直到任务报错中断才发现已登出 | 零感知自愈与桌面通知 (wb-audit)：防风控三级审计，临期自动续期，失效触发 macOS / Windows 原生桌面通知 | | 远端双端监控 | 无法跨机器监控远程服务器/CI 机上的账号健康度 | 双 Runner 原生告警 (workbuddy-monitor.yml)：跨 macOS / Windows 双矩阵每日巡检，官方邮件零配置秒级送达 | | 加密凭据兼容 | 5.6+ 采用 $wbEncrypted 加密敏感字段，普通脚本直接失效 | 原生解密兼容 (v0.3.1+)：运行时透明兼容明文与加密凭据，严格内存级解密，不降级、不落盘 | | 工作区与会话 | 换号后历史对话列表变空，工作区关联折叠，需重新拉取项目 | 全域穿透打通：无论怎么切号，所有账号看到同一个物理工作区与全量对话历史 | | Token 生命周期 | 切换账号后旧 Token 容易被覆盖导致失效过期 | 自动双向回存 (Sync-before-switch)：切号前自动回写最新 Token，保持凭证新鲜 | | 每日签到积分 | 需每天打开图形界面、手动点开活动、逐个切号点击 | 极速静默打卡 (wb-checkin)：0.5 秒遍历所有账号统一领积分，三端原生系统调度自动运行。（3 个号花 10 分钟配置，月领 10,500 积分，超越 140 订阅高级版的 9,000 积分还多 1,500 分，立省 145！） | | 每日连续对话 | 需打开图形界面手动输入聊天以维持连击奖励 | 全账号自动联动保活：打卡后自动优先使用免费/超低倍率模型（Hy3/Flash）完成每日对话，维持连击兑换资格 | | 终端 CLI 问答 | 官方需打开臃肿 Electron 窗口或配置复杂环境 | 原生秒级直接对话 (wb-chat)：直接在终端向 WorkBuddy 模型提问并流式输出，零 UI 内存占用 | | 模型容灾与自愈 | 官方上游模型故障/限流直接报错中断任务 | 透明容灾轮换网关 (wb-router)：:8047 代理中介，支持 DeepSeek / Space Bunny / Hy3 瞬态故障自动降级轮换 | | 模型资产透视 | 官方隐藏模型实际扣费倍率与调用计费明细 | 动态全景资产透视 (wb-models)：动态拉取全量模型、实时倍率审计与轻量级交互式终端选择器 (TUI) | | 沙盒日志暴走 | sandbox-core 狂写 PTY 日志无淘汰机制，几天吞噬 15GB+ 磁盘 | 智能物理看门狗 (workbuddy-log-guard)：36h TTL、2GB 目录硬顶、30MB 物理熔断，lsof 句柄感知，只 truncate 不删活动文件 | | 规则雪崩与并发撕裂 | 漏配临时目录导致 1.7 万行规则膨胀卡死 120s SIGKILL；多进程并发自愈易破坏规则文件 | Single-Flight 内核锁防撕裂 (wb-sandbox heal)：动态通配规则降至 48 条，跨进程排他锁 (fcntl.flock / msvcrt) + 锁内回读校验，并发 0 冲突 | | IPC 慢连接与头阻塞 | 传统 IPC 无全局超时与帧长限制，遇慢响应或超长 Payload 拖死命令执行 | 全链路 Monotonic Deadline + 4MB 硬熔断：覆盖连接、发送与分片接收全时钟周期，100% Fail-Open 绝不卡死用户命令 | | 子进程与转储隔离 | 子进程默认继承父进程打开句柄；意外崩溃转储 (Core Dump) 泄露内存解密 Token | 物理沙盒隔离 (close_fds=True + RLIMIT_CORE=0)：全闭关句柄，POSIX 下锁定 RLIMIT_CORE=0 与私有 umask(0o077)，物理阻断泄露 |

---

🛡️ 官方更新兼容性、冲突防范与安全回退保障 (Upstream Compatibility & Zero-Conflict Guarantee)

极简结论：WorkBuddy Toolkit 采用零侵入外挂（Non-invasive Sidecar）与运行态接缝设计，绝对不修改官方任何二进制执行体与 asar 安装包。官方后续任何版本迭代均默认零冲突、具备完全自愈能力；若遇底层破坏性重构，Toolkit 内置 Fail-Safe 快速熔断与主动体检预警 (wb-doctor)，并支持秒级零残留一键回退。

1. 为什么默认绝不破坏且 100% 零冲突？（非侵入设计准则）

1. 零文件篡改（Zero In-Place Binary Mutation）：
   • Toolkit 从不 patch、不替换、不劫持 /Applications/WorkBuddy.app（或 Windows/Linux 安装目录）内的任何官方执行体、只读脚本或 asar 归档。官方应用包哈希与签名 100% 保持官方原版。
2. 运行态接缝与幂等注入（Idempotent IPC Seam）：
   • 沙盒 Seatbelt 规则治理通过官方运行时自身开放的 Unix Domain Socket 注入。规则集合求并集具备天然的数学幂等性（Idempotent Set）：即便未来官方版本在 tsbx_rules.json 中原生补齐了 temp 规则，规则合并依然保持 $O(1)$，绝不冲突、绝不重复报错。
3. 跨进程 Single-Flight 内核文件锁与回读校验（Single-Flight Lock & Read-back Verification）：
   • 当多终端或多进程并发触发自愈（wb-sandbox heal）时，通过 fcntl.flock（POSIX）或 msvcrt.locking（Windows）抢占跨进程排他锁，并在锁内二次回读规则文件。若竞争并发进程已先行完成治愈，直接优雅退出，彻底杜绝并发写引发的规则文件损坏或半成品撕裂。
4. 全链路 Monotonic Deadline 统一时钟与 4MB 硬熔断（UDS Deadline & Fail-Open）：
   • 与沙盒进程间通信（Unix Domain Socket / Windows Named Pipe）全面基于 time.monotonic() 建立贯穿连接、发送、分片接收全周期的统一 Deadline。协议层强制注入 4MB 帧接收/发送硬熔断，任何异常挂起或畸形大包均触发 100% Fail-Open 优雅降级，绝对不挂死用户命令。
5. 子进程派生脱敏与核心转储隔离（Subprocess FD & Core Dump Isolation）：
   • 所有内部派生的工具子进程强制开启 close_fds=True 阻断父进程泄漏文件描述符，POSIX 环境下前置注入 preexec_fn 锁死 RLIMIT_CORE=0 并设置私有 umask(0o077)，彻底杜绝进程意外崩溃时生成 Core Dump 泄露内存中已解密的敏感 Token。
6. 旁路看门狗阈值休眠（Passive Threshold Guard）：
   • 日志与快照治理（workbuddy-log-guard）仅在目录突破 2GB 硬顶或单文件突破 30MB 熔断线时才介入；若官方后续版本自愈了日志轮转，看门狗纯内核休眠，对系统零任何副作用。
7. Toolchain 独立解耦：
   • sccache 编译缓存挂载在全局 ~/.cargo/config.toml，为 Rust 标准生态规范，WorkBuddy 客户端如何更新均无法影响该层。

---

2. WorkBuddy 官方版本更新时的 3 种演进场景与表现

| 官方更新场景 | 现场表现与 Toolkit 行为 | 用户影响与应对方式 | | :--- | :--- | :--- | | 场景 A：官方合入原生修复<br>(官方在 tsbx_rules.json 补齐了 temp 规则，或增加了会话清理) | 1. Toolkit 注入的规则自动与官方规则幂等求并集，规则数保持两位数。<br>2. wb-doctor 自动感知并报告：Upstream sandbox spec: NATIVELY_PATCHED。 | 零破坏、零冲突。<br>用户可继续保留 Toolkit 作为双重防腐保底，亦可随时执行 uninstall.py 优雅退场。 | | 场景 B：官方常规业务更新<br>(新增模型、更新 UI 等，但未修复底层缺陷) | Toolkit 后台守护与动态接缝继续透明无感生效，阻断规则膨胀与日志无限吃盘。 | 无感自愈。<br>完全不受影响，正常使用即可。 | | 场景 C：官方破坏性重构<br>(彻底废弃沙盒架构、修改 IPC Socket 路径或变更协议格式) | 1. Fail-Safe 快速熔断：所有 IPC 调用均设置 1.5s 硬超时与静默降级，绝不会卡死终端或中断构建任务。<br>2. 主动体检预警：wb-doctor 会明确标黄/标红捕获：IPC_MISMATCH / DAEMON_NOT_FOUND，向用户打印清晰的升级排查指引。 | 拒绝不知情。<br>wb-doctor 第一时间精准指出异常；用户可一键回退原生，或等待 Toolkit 发布适配版本。 |

---

3. 如何自检冲突与秒级安全回退？

🔍 冲突检测与版本体检（一键诊断）

升级 WorkBuddy 后，随时在终端执行：

workbuddy doctor   # 或别名 wb-doctor

doctor 会全方位输出上游规格、运行时状态与冲突预警：

=== WorkBuddy Toolkit Doctor ===

Auth file             : OK (~/Library/.../workbuddy-desktop.info)
Credential format     : encrypted
Encrypted scheme      : detected (sym-v1 / suite 1)
WorkBuddy runtime     : FOUND (/Applications/WorkBuddy.app/Contents/MacOS/Electron)
WorkBuddy version     : 5.6.2
Credential resolver   : AVAILABLE (Electron 37.10.3)
Profile count         : 3
API capability        : READY
Upstream sandbox spec : VULNERABLE (Upstream 5.6.10 omits macOS temp rules; sidecar heal active)
Sandbox & Seatbelt    : HEALTHY (48 rules, temp wildcards active)
Log guard daemon      : ACTIVE (LaunchAgent loaded, 1800s periodic watch)
Cargo sccache reuse   : CONFIGURED (sccache enabled)

RESULT: COMPATIBLE

--- Upstream Compatibility & Safe Rollback ---
Non-invasive Sidecar  : ACTIVE (Zero app-bundle modifications; 100% fail-safe)
Conflict Status       : ZERO CONFLICTS DETECTED (Idempotent rules & passive monitoring)
Rollback Instruction  : Safe 0-residue rollback available anytime via: python3 uninstall.py

若官方协议变更，输出将精准变为 IPC_MISMATCH 或 POTENTIAL DRIFT DETECTED，并给出即时指引，彻底杜绝用户在不知情状态下盲目运行。

💡 命令假死与 exit 137 专项取证：若在日常开发中遇到终端执行命令卡死或报 exit 137，可直接运行 wb-doctor --inspect-137（或 --json）获取法医级事故现场指纹分析，详见 7. 事故现场指纹分析。

↩️ 安全回退与零残留卸载（0 Residue Rollback）

若需要临时或永久回退至系统原生状态，直接在 Toolkit 目录运行：

# 跨平台通用 Python 卸载
python3 uninstall.py

# 或使用系统原生脚本:
# macOS / Linux : ./uninstall.sh
# Windows (PS)   : .\uninstall.ps1

卸载动作包含：

• 秒级注销并删除后台守护服务（macOS launchd / Linux systemd / Windows 计划任务）；
• 移除 CLI 软链与 PATH 配置；
• 还原 ~/.cargo/config.toml；
• 系统 100% 还原至纯净原生状态，零进程驻留、零文件污染。

---

目录

• 🛡️ 官方更新兼容性、冲突防范与安全回退保障
• 一、支持平台与系统要求
• 二、架构与底层逆向原理解析
  • 1. 工作区与会话“假丢失”根因剖析
  • 2. SQLite 触发器穿透与全域共享机制
  • 3. 账号快速轮换与双向 Token 同步
  • 4. 🔥 核心攻坚：WorkBuddy 5.6+ 本地加密凭据逆向与安全兼容层
    • (1) 逆向背景：$wbEncrypted 加密信封结构剖析
    • (2) 攻坚过程：发现客户端内置原生 Node 绑定扩展
    • (3) 架构设计原则：DO NOT DECRYPT FOR STORAGE（透传不落地）
    • (4) 稳健性保障：昵称字典防御降级链与 Fail-Closed 阻断机制
    • (5) 物理取证与测试验证：本地实测 + 跨平台 CI 矩阵 + 平台真实可用度
    • (6) 智能诊断体系：wb-doctor 全方位自检
  • 5. 每日签到协议逆向与幂等领取架构
  • 6. 每日连续对话协议逆向与模型倍率智能梯队
  • 7. 三端原生后台定时调度与自适应探测
  • 8. 容灾轮换路由网关架构 (Failover Router :8047)
  • 9. 模型全景资产透视与倍率审计 (Model Inventory)
  • 10. 🔥 沙盒日志暴走根因与无感物理看门狗治理 (Log Guardian)
  • 11. 独立免登扫码录入机制逆向与终端二维码渲染 (Decoupled QR Login)
  • 12. 账号状态多维呈现与程序化 JSON 架构 (Status & Inventory Architecture)
  • 13. 账号健康度定时巡检与双端原生桌面通知 (Health Audit & Desktop Notification)
  • 14. 远端 CI 跨机双端健康监控与零配置邮件告警 (Dual-Runner CI Monitor)
  • 15. 🔥 深度踩坑记录与底层逆向突破全景 ("问题→原因→解决")
  • 16. 🔥 生产事故深水排查与白盒物理凭证库 (事故一、二、三、四)
    • 📁 docs/incidents/ 事故排查与白盒凭证总库
    • ⚡ 事故一：沙盒 PTY 日志无底洞与 32 万快照文件瘫痪系统 I/O (P0) ➔ 📄 深度取证报告
    • [⚡ 事故二：多 Agent 并发构建缺乏全局编译缓存 sccache (P1)](#事故二ca