YiHarvest/dsh-failure-capsule 预览 preview

YiHarvest/dsh-failure-capsule

Plugin插件 Native原生 ⭐ 7 MIT Sessions & Context会话与上下文

DeepSeek Harness会话的本地优先故障证据胶囊

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that captures failure evidence when an agent run fails. It integrates with DSH’s native APIs for session events, agent errors, and loader inventory without modifying the DSH core. All data collection happens locally on the user’s machine, with no remote model calls, no telemetry backend, and no external network requests of any kind. It is currently verified to work with DSH version 0.1.5-rc.2, and can be installed to either the web or headless DSH profile depending on your use case. After installation, the plugin runs automatically in the background whenever you use DSH normally.

To install the plugin, you can run a simple one-line command via DSH’s CLI tool to pull the package directly from npm. If you prefer to install the scoped version from GitHub Packages, you will first need to log in with a classic personal access token that has the read:packages permission. After installation completes, you can verify that the plugin loaded correctly by running dsh --profile [your-profile] --dump-config and checking for the failure-capsule entry. The plugin is configured with sensible defaults out of the box, but you can adjust all settings via a YAML configuration patch.

The plugin automatically redacts common sensitive information like credentials, private keys, and local home directory paths from the generated ZIP archive. However, the plugin’s author notes that redaction is a defense-in-depth measure, and users should manually inspect capsules before sharing them outside trusted circles. The project is released under the permissive MIT license, so it is free to use, modify, and distribute without any cost or restriction. Local development for contributors requires Node.js version 22.19.0 or newer, and contributors can run full validation checks with the npm run check command.

这是一款专为 DeepSeek Harness (DSH) 开发的原生插件,作用是在Agent运行失败后、上下文消失之前,将失败相关的证据采集整理为经过脱敏、可审阅的本地ZIP压缩包。它通过DSH原生的事件、错误和加载器接口工作,不修改DSH核心代码,全程只在本地采集数据,不调用大模型,也没有遥测后端服务。

安装时可以根据需要选择web或headless配置文件,通过dsh plugin命令直接从npm或GitHub Packages安装,安装后无需额外操作,正常使用DSH即可。当匹配的失败事件触发时,插件会自动在会话工作目录下生成带时间戳的证据包,支持用户自定义输出路径、采集范围、触发条件等多项配置。

证据包包含结构化失败信息、会话时间线、运行环境、插件状态、脱敏报告、Git状态、源码映射栈等完整内容,采用MIT许可证开源,供开发者免费使用。分享证据包到外部前需要人工检查,脱敏仅作为纵深防御,不能保证完全消除所有业务敏感信息。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 7 stars - very few users, little community feedback星标只有 7,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 YiHarvest/dsh-failure-capsule 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-failure-capsule

在上下文消失之前,封存失败证据。

一个本地优先的 DeepSeek Harness 插件,把失败的 Agent 工作整理成经过脱敏、可审阅的证据 ZIP。

npm CI DeepSeek Harness License: MIT

npm · GitHub Packages · 更新记录 · English

发布状态: 当前源码是标准 Profile Bundle,已针对 DeepSeek Harness @deepseek-ai/dsh@0.2.0-rc.2 验证。它通过原生 session/event、agent/error 和 Loader inventory 接口工作,不修改 Harness 核心。采集只在本地进行,不调用模型,也没有遥测后端。

Harness 失败事件被采集、在本地脱敏,并封装为包含时间线、Git 状态、运行时、插件和源码映射栈的 Failure Capsule ZIP。

体验当前版本

Web 和 headless 是彼此独立的 profile。需要在哪个 profile 捕获失败,就在哪个 profile 安装:

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

同一版本也会以 @yiharvest/dsh-failure-capsule 发布到 GitHub Packages。先使用具备 read:packages 权限的 classic personal access token 登录,再安装 scoped bundle:

npm login --scope=@yiharvest --auth-type=legacy --registry=https://npm.pkg.github.com
dsh plugin --profile web add @yiharvest/dsh-failure-capsule

确认组合层已经生效:

dsh --profile web --dump-config
# 查找:id: failure-capsule / name: dsh-failure-capsule

安装后不需要运行额外命令。继续正常使用 Harness;匹配的失败会在 Session 工作目录下写入证据包:

.dsh/failure-capsules/
└── 2026-08-31T01-23-45-678Z_<session>_tool-error_event-87.zip

核心想法

最后一行报错通常解释不了 Agent 为什么失败。真正有用的上下文散落在此前的工具调用、回合边界、仓库状态、运行环境、活动插件里,有时还藏在一段压缩后的 JavaScript 栈中。

Failure Capsule 会在这些上下文仍然存在时把它们保存下来:

  1. 监听 Harness 原生的持久化或实时失败信号。
  2. 截取有界的 Session 与环境证据窗口。
  3. 存在 JavaScript 栈时,使用本地 source map 还原源码位置。
  4. 只对导出副本中的凭据、本机路径和敏感字段进行脱敏。
  5. 写出一份确定性、自带索引、便于审阅或分享的 ZIP。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugins-store 下一个 Next dsh-oh-my-theme →