1实现原理 · 为什么它能做到
利用 5 小时窗口的起算语义：窗口从『窗口内第一条请求』起算而非固定时刻轮转，所以额度耗尽后没人发消息窗口就不开始计时；重置后立刻由定时任务代发一条极简消息，把窗口计时的起点藏进睡眠时间。
daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
Claude 订阅的 5 小时用量窗口从**窗口内第一条请求**开始计时，而不是按固定时刻轮转。
注：这里在做什么：把『睡觉期间额度重置』这个空档转化为收益——用户睡醒时新窗口已经消耗掉大半时长而几乎没消耗额度；'一次戳的成本极小：一条 `claude -p` 单轮消息。2026-08-29 实测全流程成功。'
定时器本体是一条 detached 后台进程链：caffeinate -is 防睡眠撑住等待期 → sleep N 秒 → cd $HOME → claude -p 发『Reply with exactly: ok』单轮消息，由 Bash run_in_background 启动。
daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
caffeinate -is /bin/sh -c 'sleep <SLEEP_SECONDS> && cd "$HOME" && claude -p "Reply with exactly: ok"'
注：命令解剖表解释每个组件为什么在：caffeinate 防 idle/插电睡眠（进程结束自动释放，防不了物理合盖）；sleep 是最简一次性载体（macOS 别依赖 at，ScheduleWakeup 上限 3600s 不够）；cd $HOME 避免加载项目 CLAUDE.md/hooks 白烧 token；claude -p 回一个词就退出的真实 API 请求。
run_in_background 是关键语义：前台 sleep 会被 harness 拦截；后台 detached 进程不依赖会话存活，且退出时会唤醒原会话形成『双保险』。
daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
**必须 run_in_background**：前台 sleep 会被 harness 拦截；后台任务是 detached 进程，且退出时会重新唤醒当前会话（见 Step 5）。
注：『被唤醒这件事本身也是一次 API 请求，与 `claude -p` 互为双保险——任何一个发生都能开窗。』这是设计亮点：唤醒通知=宿主发起的请求，与定时戳互为冗余。
幂等与读回验证：启动前 ps 检查是否已有同款定时器（有则报告并问是否替换）；启动后用 ps 验证进程链三行（sh/caffeinate/sleep）都在。
daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
ps -ef | grep -E 'claude -p "Reply with exactly: ok"' | grep -v grep
注：『启动回执不算数，用 ps 确认进程链真的存在』是独立读回验证；预期至少三行，少了 sleep 行说明进程没起来。
时间换算公式化：等待分钟数 = 距重置分钟数 + 5 分钟缓冲；绝对时刻早于/等于当前时间按次日同刻理解（深夜跨零点是常态输入）；SLEEP_SECONDS = 等待分钟数 × 60。
daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
换算公式（占位符全文统一）：`等待分钟数 = 距重置分钟数 + 5`；`SLEEP_SECONDS = 等待分钟数 × 60`。
注：+5 分钟缓冲的理由：『重置时刻按用户口述估算有误差；早于重置时刻戳到的是旧窗口，纯浪费』。目标钟面时刻要报告给用户（'用户睡前想知道的是墙钟时刻'），并解释跨零点『6 点 15 重置』指明早的语义。
收尾核实与取消纪律：到点被唤醒后读任务 output 文件，预期 'ok' + '[exited with code 0]'；实际触发时刻以 output 文件 mtime 为准（stat -f '%Sm'）；取消用特征串 pkill 且明令禁止按秒数杀。
daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
**禁止按秒数 `pkill -f 'sleep <SLEEP_SECONDS>'`**：本机长驻脚本的心跳 sleep 可能恰好同秒数，实测发生过误杀
注：取消命令为 pkill -f 'Reply with exactly: ok'（2026-08-29 实测可杀 caffeinate 与 sh；残留孤儿 sleep 无害，sh 已死 && 后不会执行）；output 文件路径在 Step 4 交代时写入对话历史，作为『通知丢失/上下文压缩』后的兜底（'路径也丢了就 ps 查进程链…读不到任何本地证据时如实说「无法本地确认」'——禁谎报）。
2核心能力
01一次性延迟触发额度窗口（caffeinate 防睡 + sleep 定时 + claude -p 单轮戳）
02幂等：启动前检测已有定时器并询问是否替换（不默默叠加第二个）
03进程链独立读回验证（ps 三行预期）
04任务 output 路径持久化交代 + 唤醒收尾核实（ok/exit 0/实际时刻 stat）
05特征串安全取消（pkill 'Reply with exactly: ok'；禁止按秒数杀）
06相对/绝对时间换算 + 跨零点次日语义 + 5 分钟缓冲
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | claude（官方 Claude Code CLI；claude -p 单轮 print 模式） |
| cli | caffeinate（macOS 防睡眠） |
| cli | sleep / date / ps / pkill / stat（macOS/BSD 系统工具） |
| cli | 宿主 Bash 的 run_in_background 后台任务 + task-notification 唤醒（harness 能力） |
4风险提醒 风险提醒：黄色 · 留意使用
风险提醒：黄色 · 留意使用
- pkill 特征串存在误杀面 — pkill -f 'Reply with exactly: ok' 会杀掉本机任何命令行含该串的进程；虽比按秒数杀安全，但误杀概率非零，且取消后需 ps 确认。
- dangerouslyDisableSandbox 建议属安全降级 — 沙箱拦截 caffeinate 时 SKILL.md 指示用 dangerouslyDisableSandbox: true 重试——在宿主沙箱被关闭的情况下执行命令链，用户应清楚该路径的授权含义。
- 计时准确性依赖本机状态 — 机器睡眠/合盖/关机会使触发顺延或失效（caffeinate 防不住物理合盖）；时间差超几分钟时新窗口重置时刻要按实际触发时刻重算。
- 消耗真实订阅调用 — 若用户口述重置时刻偏早或缓冲不足，戳到旧窗口会白消耗一次调用且不开新窗口（有补戳 10-15 分钟短定时器的处置，但仍需用户在场判断）。
- 机制依赖宿主后台任务语义 — run_in_background detached + task-notification 唤醒是 Claude Code harness 特性；换宿主（Codex 等）无对应语义时本 skill 的『双保险/唤醒核实』不成立（skill 明示 Claude Code 场景）。
风险提醒：黄色，留意使用。按统一分档：无脚本资产、无凭证接触（claude CLI 用自己的登录态，skill 不读 key/cookie/env）、无直接网络代码——本地系统 CLI/进程管理为主（偏蓝）。抬到黄色的理由：① 经官方 claude CLI 产生真实网络 API 外发（对象 Anthropic，可预期但会消耗订阅与开启计时窗口）；② 指令含『沙箱拦截时用 dangerouslyDisableSandbox: true 重试』——在特定故障路径下建议关闭宿主沙箱执行 caffeinate/claude，属安全降级提示需用户知情；③ 后台长驻进程 + pkill 特征串取消存在误杀其他进程的残余面（skill 已有防误杀纪律但非零概率）。
5第二遍独立确认
- [ok] 无自带脚本/资产（纯指令 skill） — glob 确认目录仅 SKILL.md；external_deps/internal_assets 不夸大（asset 列表为空）。
- [ok] caffeinate/sleep/claude -p 命令链存在且为固定模板 — Step 2 代码块逐字存在；命令解剖表逐组件解释；无 shell 拼接注入（数字换算后入占位符）。
- [ok] run_in_background 语义与双保险 — SKILL.md 原文『后台任务是 detached 进程，且退出时会重新唤醒当前会话』与 Step 5『被唤醒本身也是一次 API 请求』一致。
- [ok] 幂等检查与 ps 读回验证 — Step 0 的 ps grep 命令与 Step 3 的三行预期存在；Step 4 交代 output 路径进对话历史。
- [ok] 凭证接触面为零 — token 扫描（API_KEY/token/cookie/secret/Authorization）零命中；无 env/keychain/文件读取。
- [ok] pkill 取消纪律（防误杀） — 禁止按秒数 pkill 的原文与实测误杀背景存在；特征串 pkill 为唯一取消路径。
- [ok] 功能声明 vs 夸大检查 — 『5 小时窗口从窗口内第一条请求起算』是描述性机制声明（对 Claude 订阅语义的表述，标注 2026-08-29 实测）；skill 边界（macOS/一次性/不查询重置时刻）自我声明清晰，无越界承诺。
- [ok] 元数据（license/stars/commit） — 仓库级 MIT、stars=1385、pushed_at=2026-09-09T12:33:29Z；本地 HEAD==pin d5c4678cb5d4fd6acc9c922690df035dbd33d247。
6结论
适合：适合：Claude 订阅额度耗尽且即将在数小时内重置、想睡觉/离开前把 5 小时窗口起点藏进空档的 macOS 本机用户；接受一次性定时器语义、愿意在启动后 ps 核验并把 output 路径记下来的场景。触发场景即 description 里的中文口令（「还有 X 小时重置」「我去睡觉了到点 ping」等）。
不适合：不适合：非 macOS（Linux caffeinate/date -v 不可用且未验证）；需要周期性保活/每日定时（应用 /loop 或 cron）；需要查询/预测 ChatGPT/Codex 重置时刻（转 tibo-reset-codex）；关机/合盖常态化的设备（无法履约）；对『关闭沙箱重试』或后台进程面不适的用户。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-09
方式 A · 人下载镜像包下载 claude-code-ping-start-5h-quota.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agentc6f9d07b09144f82…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库daymade / daymade/claude-code-skills
原始 GitHubdaymade/claude-code-skills ↗
Stars1385
最近推送2026-09-09
本 skill commit
d5c4678cb5许可MIT（仓库根 LICENSE 文件；GitHub API spdx MIT；Copyright (c) 2025 daymade）
本站信息
收录日期2026-09-06
分类基础工具与工作流
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。