helibeiqi/dsh-time-travel

README 摘要

dsh-time-travel 给 DeepSeek Harness (DSH) 的 Cordis 插件： 可逆时间旅行与审计 —— 为工具副作用建立「前状态快照 → 执行 → 补偿操作」链路，提供 rewindTo(turnId) 按轮次倒序恢复工作区，并内置审计规则引擎把危险操作落盘 audit-log.jsonl 。 兼容 DSH 0.1.0-rc.6 （cordis 4.x / schemastery 3.x ）。 请勿裸装 @latest ，以本仓库版本为准。 功能定位 一句话： 把"模型用工具改坏了工作区"这件事变得可逆且可审计 。 - 监听 tools/pre-execute / tools/result 工具管线事件，对 fs.write / fs.delete / bash / http.request 四类工具建立快照与补偿； - ctx.timeTravel.rewindTo(turnId) ：按轮次 倒序 执行补偿，恢复工作区到指定轮次之前； - 审计规则引擎：命中危险 shell、敏感路径写、不可补偿写操作后，追加一行 JSON 到 audit-log.jsonl ； - 全部副作用经 ctx.on() 注册，插件卸载时自动撤销，不污染 dsh 工具管线（快照/审计失败都会被包含，绝不影响工具执行）。 安装 安装后重启 dsh web（端口 3080 ）生效。插件挂载后： - ctx.timeTravel 可用（ rewindTo / rewindAll / records / clear ）； - 当前目录生成 audit-log.jsonl （可用 audit.logPath 配置）。 配置 插件导出 schemastery Config ，可在 dsh 的插件配置面板 / profile 中覆盖： 配置项 类型 默认值 说明 turnGapMs number 5000 同一会话内两次工具调用超过该间隔（ms）则开启新轮次； 0 = 每次调用独立成轮 audit.enabled boolean true 是否启用审计规则引擎 audit.logPath string audit-log.jsonl 审计日志输出路径（JSON Lines，相对 cwd） audit.rules dict\ 全部 true 按规则 id 开关： dangerous-shell / sensitive-path-write / non-compensable-write / delete-whole-dir watchTools dict\ 见下表 工具名 → 补偿器类别映射 maxRecords number 10000 内存保留的最大工具记录数（超出丢弃最旧；审计日志不受影响） dryRun boolean false true 时 rewind…

分类