file-planning

多步任务中最难的部分往往不是写计划，而是会话中断、上下文被压缩、或者重开窗口后不知道进度停在哪里。file-planning（Trail Map）把计划、执行状态、现场笔记和总结全部持久化到工作区的 .trail/ 目录里，恢复时只需读取状态即可继续，不需要重新梳理思路。

核心由一个轻量状态机驱动：每个步骤经历 todo、进行中、已完成三种状态，可取消可重开；步骤之间可声明依赖，未满足的依赖自动阻塞下游，循环依赖会被检测并拒绝。模板生成器可根据任务类型（研究、开发、文档、空白）一次性搭好里程碑骨架并自动连线，创建后仍可随意修改。每次状态变更都会追加到不可篡改的事件日志中，收尾时 debrief 命令自动汇总里程碑、步骤、取消项和时间线，手写回顾段落也会跨次保留。最终的确定性检查确保所有步骤已关闭且结构完整，避免"以为做完了"的情况。

适合跑多步 agent 工作流、厌倦上下文丢失的 DSH 插件用户。零运行时依赖，全部落盘为纯文件，既可通过轻量 CLI 独立使用，也可通过 dsh tools 接口无缝集成。