dsh-delivery-ledger

在本地跑一条定时 shell 命令，执行完就没了——没有台账可查、失败无法补发、进程抖动还会重复触发。dsh-delivery-ledger 用一份 append-only 的 JSONL 台账把这三件事一次性解决：每次窗口执行都落一行记录，状态分为 ok、failed、abandoned，同窗口去重保证抖动期不重复跑，失败窗口可用 ledger_retry 按原始 dueAt 递增 attempt 补发（Hermes redeliver 语义），而不是重新跑当前时刻。

核心能力围绕三个动作展开：ledger_create 注册一条命令加间隔秒，插件自带调度器按窗口对齐触发，不依赖 dsh-schedule；ledger_list 按状态过滤查台账；ledger_retry 补发最近的失败或放弃窗口。全链路零网络、零 LLM，命令经 /bin/sh -c 执行并带 10 秒超时，台账存于 $DSH_HOME/ledger/ 下的 .jsonl 文件，单测行覆盖 100%，并经真实 headless e2e 验证了去重与补发场景。

适合需要在 CI 流水线、容器内部或单机脚本中运行轻量定时命令，同时要求执行可审计、失败可追溯可补发、重复窗口自动去重的开发者与运维工程师。注意 v1 的任务注册表存于内存，跨进程不持久调度，适合单一进程生命周期内的轻量调度场景。