#WorkBuddy# 人不在电脑前，任务却卡在「等你点一下」：远程控制开通 + 30 秒交接包模板（附 macOS 体检脚本）

defaults read /Applications/WorkBuddy.app/Contents/Info.plist CFBundleShortVersionString
# 实测输出：5.9.3

## 需要你出手（约 30 秒）

**卡在第几步**：第 3 步 · 读取外部数据源
**卡的原因**：登录态过期，需要扫一次码
**你要做的动作**：打开 Safari → 登录 → 回到窗口点「继续」
**做完之后**：任务从断点继续，不用重跑。

> 不方便就直接关掉，任务停在原地，不会自动重试烧额度。

python3 remote_handoff.py --probe      # 体检
python3 remote_handoff.py --selftest   # 验证判定逻辑
python3 remote_handoff.py --pack --step "第3步" --need "登录态过期" --action "扫码登录" --eta "约30秒"

import os, re, plistlib, subprocess, sqlite3

APP = "/Applications/WorkBuddy.app"
MIN_DESKTOP = (5, 9, 3)          # 官方门槛
TCC = ["/Library/Application Support/com.apple.TCC/TCC.db",
       os.path.expanduser("~/Library/Application Support/com.apple.TCC/TCC.db")]

def parse_version(t):
    m = re.match(r"^(\d+)\.(\d+)(?:\.(\d+))?", str(t).strip())
    return tuple(int(x) if x else 0 for x in m.groups()) if m else None

def cmp_version(a, b):           # 必须元组比较，字符串比较会把 5.9.10 判成小于 5.9.3
    return (a > b) - (a < b)

def version_ok(path=APP + "/Contents/Info.plist"):
    with open(path, "rb") as fh:
        raw = str(plistlib.load(fh).get("CFBundleShortVersionString", ""))
    v = parse_version(raw)
    return v is not None and cmp_version(v, MIN_DESKTOP) >= 0, raw

def online():
    out = subprocess.run(["ps", "-eo", "args="], capture_output=True,
                         text=True, timeout=5).stdout
    return "WorkBuddy.app" in out

def tcc_granted():
    """读不到不等于没授权——这是 macOS 的保护机制，必须降级而不是报错。"""
    for db in TCC:
        if not os.path.exists(db):
            continue
        try:
            con = sqlite3.connect("file:%s?mode=ro" % db, uri=True, timeout=2)
            rows = con.execute(
                "SELECT service, client, auth_value FROM access "
                "WHERE service IN ('kTCCServiceScreenCapture','kTCCServiceAccessibility')"
            ).fetchall()
            con.close()
        except Exception:
            return None          # 无 Full Disk Access，未知
        hit = {s: a for s, c, a in rows if "workbuddy" in c.lower()}
        if hit:
            return all(v == 2 for v in hit.values())   # 0=拒绝 2=允许
    return None

if __name__ == "__main__":
    ok, raw = version_ok()
    print(f"版本 {raw} → {'达标' if ok else '不达标'}")
    print(f"客户端在线 → {'是' if online() else '否'}")
    g = tcc_granted()
    print(f"系统权限 → {'已授权' if g else ('未授权' if g is False else '未知，请目视确认')}")

远程控制前置体检 · 2026-10-30 10:01:35

桌面端版本              5.9.3                         [PASS]
客户端在线              运行中                          [PASS]
系统权限（屏幕录制 / 辅助功能）  屏幕录制=是 辅助功能=是           [PASS]
自动化任务数（仅计数，不含名称）   4 个                          [INFO]

结论：前置条件满足，可以去手机端发起连接

[PASS] 版本号 5.9.3 应判为达标
[PASS] 版本号 5.9.2 应判为不达标
[PASS] 版本号 6.0.0 应判为达标
[PASS] 字符串比较会把 5.9.10 判成小于 5.9.3（反例）
[PASS] 元组比较下 5.9.10 正确大于 5.9.3
[PASS] 畸形版本 'beta' 解析为 None
[PASS] 交接包含四要素
[PASS] 版本号带后缀 5.9.3-beta.1 可解析