dsh-failure-capsule

DeepSeek Harness 的本地优先故障证据包插件：当工具或 Agent 失败时，自动把失败前发生了什么、项目当时是什么状态、运行环境和插件组合是什么整理成一个经过脱敏的 ZIP。

English

当前状态： 可作为标准 Profile Bundle 安装；面向 @deepseek-ai/dsh@0.1.0-rc.6 的原生 session/event 与 agent/error 接口实现。插件不修改 Harness 核心，不上传数据，也不调用模型诊断故障。

快速开始

为使用中的 profile 安装插件。Web 与 headless 是两个独立 profile，需要分别安装：

dsh plugin --profile web add dsh-failure-capsule
dsh plugin --profile headless add dsh-failure-capsule

验证组合层：

dsh --profile web --dump-config
# 输出中应出现 id: failure-capsule / name: dsh-failure-capsule

随后正常使用 DSH。失败发生时，插件默认把证据包写入当前项目：

.dsh/failure-capsules/
└── 2026-08-14T08-20-31-123Z__tool-error_event-42.zip

它解决什么问题

普通错误日志往往只有“最后哪里炸了”，但 Coding Agent 的失败通常依赖一整段过程：模型请求、工具调用、权限、工作树变化、运行时以及插件组合。Failure Capsule 把这些信号放在同一个离线证据包里：

flowchart LR
  A[Harness session events] --> D[Failure detector]
  B[Git evidence] --> E[Evidence builder]
  C[Runtime and plugins] --> E
  D --> F[Bounded failure window]
  F --> E
  E --> R[Secret redaction]
  R --> Z[failure-capsule.zip]

默认捕获以下故障：

信号	默认	说明
tool/result 且 isError=true	✅	每个失败工具调用各生成一份
turn/end / error	✅	模型、传输或 Agent 回合失败
turn/end /