Wang-Lin-Chang/dsh-witness

README 摘要

dsh-witness Crash-surviving background jobs for DeepSeek Harness, where the filesystem is the source of truth . Cross-restart adoption, autopsy reports, sandboxed execution, event sourcing — battle-tested on Windows 11 NTFS. 给 DeepSeek Harness 的崩溃存活后台任务： 文件系统即真相源 。跨重启收养、尸检报告、沙箱执行、事件溯源——Windows 11 NTFS 实测。 为什么存在 / Why this exists Harness 内核自带的后台 jobs 是 fire-and-forget 工具执行（能读输出、能杀，不能对话、不能跨崩溃收养）。真实世界里的长程会话踩过这些公开的坑： 公开的痛点 dsh-witness 的答案 Force-kill 丢弃未刷盘的 write-behind 尾部（ 483） 零缓冲。 每次状态转移立即落盘——目录结构本身就是状态机。 一条损坏的日志事件让会话永久死亡、无修复路径（ 1593） 双真相源。 目录=真相；SQLite=可重建的只读索引缓存（游标+mtime 失效）。缓存坏了永远不挡恢复——从目录重建即可。 两个任务挤在一个文件夹互相覆盖；40 分钟长跑交付坏产物（第三方实测报告） 每任务一个隔离目录 + O EXCL 锁 + 每任务沙箱化 cwd。 "恢复意味着知道最后完成的步骤和证明输出的证据"（专家建议） 尸检报告。 每任务 autopsy.json ：死因、主证据、判决、死因代码。 调度任务静默失败、无审查路径 事件溯源。 events/ .jsonl 记录每个任务的 started/output/done/adopted/tampered。 谁适合用它 / Who is this for - 在 DeepSeek Harness 里跑 长后台任务 （几分钟以上的构建、批处理、数据搬运），被"会话一死任务就死"坑过的人； - 被 force-kill 丢输出尾部 坑过的人——输出游标续读，跨重启不重不漏； - 需要事后知道 任务到底怎么死的 的人—— autopsy.json 尸检：死因、主证据、判决、死因代码； - 需要 防伪造留痕 的人——任务自救改证据会被判 tampered ，而不是被默默信任。 不适合 ：几秒就结束的短命令——官方内置 jobs 已经够用，不必上这套目录协议。 Runs long background jobs that must survive session/process death, with an autopsy trail inste…

分类