dsh-workspace-change-awareness

在 DeepSeek Harness 中，agent 一边修改文件，一边面临人类开发者、IDE 或外部脚本对同一仓库的并发编辑。没有外部感知机制时，agent 会持续依赖已失效的缓存内容，产出基于错误前提的结果。dsh-workspace-change-awareness 为弥合这一盲区而设计：它在每次模型请求之前，通过共享的 Chokidar 监听器失效相关路径，并经 ctx.fs 重新解析与 stat 验证，确保模型看到的是真实的工作区状态。

插件的核心防护分三层。第一层是 pre-step 通知：检测到 session 已确认基线之外的文件变更后，插件在 agent/pre-step 节点注入一条 user-role 提示，要求模型重新读取受影响文件并检查当前 diff，提示在模型可见前已完成持久化。第二层是 turn-stopping 终检：若模型推理期间又有新状态到达或监听器边界降级，agent/turn-stopping 会执行一次额外步骤将最新状态喂给模型。第三层是降级与恢复：监听器出错时先向模型发出覆盖降级警告，再尝试重建；已确认路径在后续 step 中仍通过 ctx.fs.stat() 重新验证，短暂中断不会静默丢失变更。

这套机制适合多角色并发编辑的真实工程环境——人的终端、IDE 自动保存、CI 钩子与 harness agent 同时操作同一组文件。新 agent 从当前状态起步，不会把初始文件误报为变更；恢复或压缩的 session 会收到保守的重新读取提醒。插件无需额外配置即可工作，MIT 协议，适合想给 harness 工作流加一层外部变更感知的团队和个人。