#WorkBuddy# 定时任务「没跑」和「跑一半卡住」，多半不是调度器的问题：9 个中断点体检清单（附 macOS 零依赖脚本）

# 终端里（你在的环境）
command -v ffmpeg

# 模拟 cron 的环境
PATH=/usr/bin:/bin command -v ffmpeg

sudo -n true; echo "退出码=$?"
# 返回 1 = 需要输密码 = 无人值守必卡

pmset -g | grep -E "^(sleep|disksleep|standby|hibernatemode)"
df -k /          # 根分区已用百分比
date "+%Z %z"    # cron 用的是系统本地时区

crontab -l
ls ~/Library/LaunchAgents | wc -l

python3 unattended_probe.py --check
python3 unattended_probe.py --check --job daily-report   # 确认目标任务登记没
python3 unattended_probe.py --check --cmd ffmpeg --cmd ollama
python3 unattended_probe.py --demo                        # 对照组，强烈建议先看这个
python3 unattended_probe.py --check --json                # 机器可读

python3 unattended_probe.py --demo

python3 unattended_probe.py --check --job daily-report || {
  echo "环境中检未通过，任务终止"; exit 1;
}

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
unattended_probe_mini.py —— 无人值守任务中断点体检器（最小可用版，5 项）
完整版 9 项见同目录 unattended_probe.py。零第三方依赖，macOS / Python 3.9+。
用法：python3 unattended_probe_mini.py
退出码：0=无 FAIL；1=至少一项 FAIL（可直接做流水线门禁）
"""
import os, subprocess, sys, time

CRON_PATH = "/usr/bin:/bin"          # macOS 上 cron 的默认 PATH
CHECKS = ["python3", "git", "curl", "ffmpeg", "ollama", "node"]

def run(cmd, timeout=5.0, env=None):
    try:
        p = subprocess.run(cmd, shell=True, capture_output=True,
                           text=True, timeout=timeout, env=env)
        return p.returncode, (p.stdout + p.stderr).strip()
    except subprocess.TimeoutExpired:
        return 124, "TIMEOUT"
    except Exception as e:                      # noqa: BLE001
        return 127, "%s: %s" % (type(e).__name__, e)

def which(cmd, path):
    rc, out = run("command -v " + cmd, env={"PATH": path})
    return out if rc == 0 and out else None

def main():
    res = []

    # 1 PATH：当前找得到、cron 找不到的命令
    cur = os.environ.get("PATH", "")
    missing = [c for c in CHECKS if which(c, cur) and not which(c, CRON_PATH)]
    res.append(("PATH(cron)", "FAIL" if missing else "OK",
                ("cron 下找不到：" + ", ".join(missing)) if missing
                else "%d 个命令在 %s 下均可解析" % (len(CHECKS), CRON_PATH)))

    # 2 TTY：无人值守环境下任何交互提示都会卡死
    atty = sys.stdin.isatty()
    res.append(("TTY", "WARN" if atty else "OK",
                "isatty=%s（True=有人盯，False=无人值守）" % atty))

    # 3 sudo 免密：无人值守下必然卡在密码提示
    rc, out = run("sudo -n true")
    res.append(("sudo免密", "OK" if rc == 0 else "FAIL",
                "sudo -n true rc=%d %s" % (rc, "" if rc == 0 else out[:40])))

    # 4 睡眠：sleep 非 0 就可能在任务中途睡过去
    rc, out = run("pmset -g")
    kv = {}
    for line in out.splitlines():
        p = line.split()
        if len(p) >= 2:
            kv[p[0]] = p[1]
    try:
        mins = int(kv.get("sleep", "-1"))
        lvl, val = ("OK", "sleep=0（不睡）") if mins == 0 else ("WARN", "sleep=%s 分钟" % mins)
    except ValueError:
        lvl, val = "WARN", "sleep=%s（非数值）" % kv.get("sleep", "?")
    res.append(("睡眠/休眠", lvl, val))

    # 5 磁盘：产出写不进去，任务会在最后一步失败
    rc, out = run("df -k /")
    tail = out.splitlines()[-1].split()
    try:
        pct = int(tail[4].rstrip("%"))
    except (ValueError, IndexError):
        pct = -1
    res.append(("磁盘空间",
                "FAIL" if pct >= 90 else ("WARN" if pct < 0 else "OK"),
                "根分区已用 %s%%" % pct))

    print("%-14s %-6s %s" % ("检查项", "级别", "实测值"))
    print("-" * 60)
    for name, lvl, val in res:
        print("%-14s %-6s %s" % (name, lvl, val))
    print("-" * 60)
    nf = sum(1 for r in res if r[1] == "FAIL")
    print("FAIL %d 项" % nf)
    return 1 if nf else 0

if __name__ == "__main__":
    sys.exit(main())

检查项            级别     实测值
------------------------------------------------------------
PATH(cron)     FAIL   cron 下找不到：ffmpeg, ollama, node
TTY            OK     isatty=False（True=有人盯，False=无人值守）
sudo免密         FAIL   sudo -n true rc=1 sudo: a password is required
睡眠/休眠          OK     sleep=0（不睡）
磁盘空间           OK     根分区已用 2%
------------------------------------------------------------
FAIL 2 项