dsh-time-travel

AI 模型在多轮工具调用中会修改文件、执行 shell 命令或发起网络请求，一旦某轮操作出了错，工作区往往很难干净地回到之前的状态。dsh-time-travel 正是为解决这个问题而生：它为 fs.write、fs.delete、bash、http.request 四类工具建立前状态快照与补偿操作链路，让每一步文件副作用都变得可逆。

核心能力围绕 ctx.timeTravel 服务展开。rewindTo(turnId) 可按轮次倒序执行补偿，将工作区恢复到指定轮次之前的状态；rewindAll 则一键回滚所有已记录的副作用。对于无法自动补偿的操作（如任意 bash 命令、HTTP 请求），插件不会冒险猜测，而是显式标记为 manual 并交由人工处理。同时，内置的审计规则引擎会检测危险 shell、敏感路径写入、不可补偿写操作等场景，命中后追加一行 JSON 到 audit-log.jsonl，确保每一次高风险操作都有据可查。

适合使用 DSH 多步 Agent 工作流、需要文件级可逆操作与审计留痕的开发者。它与会话层面的重放或回退插件互补——本插件聚焦工作区文件系统副作用本身，而非对话消息历史。