ds-ledger 解决的是长跑任务"忘记自己为何这么做"的问题。它通过一份简短的书面账本让目标始终可见，并让审查者能够信任运行结果。
用途
适用于多阶段任务或无人值守的长时运行。核心做法是维持一个每行对应一次决策的日志文件，并在每个步骤前回读，以避免偏离目标。
主要能力与格式
创建一个 TSV 文件，例如 .ds-ledger.tsv，表头为：ts、phase、decision、why、evidence、result。第一行写入目标与完成条件。每个真实决策后追加一行：
- ts：ISO 8601 时间。
- phase：阶段或工作流。
- decision：所选或所做之事，一行。
- why：用平实语言说明原因。
- evidence：仅放指针，绝不写散文式描述。可以是提交哈希、file:line、命令及其结果，或产物路径。
- result：结果，例如“测试通过”“已回退”“待定”。 每个单元格保持单行且不含制表符。
使用方式
每个步骤前，回读目标行与最近十行，确认下一步仍服务于目标；若不服务，记录偏离并纠正方向。回退与放弃的工作也要记录并说明原因，失败往往是最有用的行。结束时追加一行总结，并告知用户文件位置；仅在审查者需要时才提交该文件。
停止条件
运行结束且总结行已写入即停止。若连续三行显示对目标没有进展，停止运行并报告。
规则与限制
每行都需要可打开或可重跑的证据，“看起来没问题”不算证据。行文应像对同事讲述那样平实具体。不得改写旧行，更正以追加方式进行。