DSH Plugins Marketplace

DSH Plugins

Plugins

/

Development & Infrastructure

/

dsh-healthkit

d

dsh-healthkit

Manifest valid

Read-only health check for DeepSeek Harness: scores the install 0–10 across seven weighted dimensions, lists findings with fix hints, and verifies whether previously reported findings were actually fi

UI (client)hasBundlePatch

DSH 体检(dsh-healthkit)

给 DeepSeek Harness 做只读体检:一句结论 → 最值得动的 3 条 → 其余收进观测库。

装完第一次跑,你会看到这样一段(真实输出,9.81 分的机器):

score=9.81/10 (raw 9.81, band 良好, P0=0, retired=3)

**整体健康,剩下的是打磨项**

最值得动的 3 条:
1. [P2] `R10` 高危扩展面未设白名单/黑名单 1 处
   → 逐项开通 allowlist/blocklist;无明确需求时保持空数组是显式接受风险
2. [P2] `R12` 插件声明了模型值,但无法静态核对运行时实际值(3 处)
   → 需在宿主内对照运行时注入值;静态审计只能标 UNKNOWN,不猜
3. [P2] `R16` 同时挂载 5 套记忆/上下文插件,每轮固定注入开销未量化
   → 需宿主内采样每轮注入 token;定主备后关掉其余自动注入

其余 14 条 INFO(不计分,观测用):`audit_findings` 或 `--findings` 看全量。

两种用法:看状态,还是当 CI 门

  • audit_check(或 --check)默认是基线门:只判「相对上一次快照的新增与回归」, 存量问题不阻塞;新增少于 3 条 WARN 时不下判(照 SonarQube 的 fudge 口径),新增 FAIL 永不放过。 想按绝对状态判,用 --absolute。
  • --check --remediation 会附一份有序修法清单([规则号] 修法),机器可读、缺席时字段不出现。

验回仪式(让它从「承诺」变成「证据」)

体检器最独特的能力是跨重启验回:上次说该修的三条,重启后回来看修好了没。 但它需要一次真实的回访才有数据——audit_read… 更准确地说:

  1. 跑一次体检(会写下待验清单与快照);
  2. 真去修掉其中一条;
  3. 重启宿主(插件开机时自动验回);
  4. 看 audit_digest 或面板里的结论采纳率——它从 0 变成非 0,这条能力才算被证明过。

它不做什么(这是它最值钱的部分):不改你的配置、不联网、不上传会话、不替你装/卸插件、 不提供「一键修复」——cordis.patch.yml 是整段替换,写错一个字段配置面就塌,而 82% 的发现 本身就没有确定修法。它给你命令与顺序,动手永远是你。

它和 dsh-plugin-doctor / 插件管理器有什么不同

  • doctor 查「单个插件是否合规」(三值 PASS/WARN/FAIL);本插件查整机:跨插件冗余、 装载面上限、上下文成本、磁盘卫生,以及「这些配置加起来是不是在拖慢你」。
  • 插件管理器只能开关;本插件给修复顺序与预期涨幅(先解 P0 封顶能涨多少)。
  • 真正独有的是三件治理机制:误报退役(说错了能记档,且撤销得了)、 跨次三分账(真修好 / 被静音 / 还在,静音不算修好)、跨重启验回 (上次说该修的三条,重启后回来核对)。详见 docs/COMPLEMENTARY.md。

安装

# 发布版(npm)
dsh plugin --profile <profile> add dsh-healthkit

# 开发版(符号链接,改源码重启即生效)
dsh plugin --profile <profile> add link:/path/to/dsh-healthkit

开发期用 link:(符号链接,改源码重启宿主即生效)。file: 是拷贝,改源码不生效, 得 dsh plugin --profile <profile> install --force 重装。装完重启宿主一次。

十六个工具(查手册用,不必先读)

工具干什么
audit_run只读体检:总分、分档、P0/P1/P2 条数与清单(只读指不碰被检对象;记账本与快照可 record=false 关)
audit_report同上,并把完整 Markdown 报告写成文件(缺省落本会话工作区 AUDIT-<日期>.md)
audit_clean清理可再生垃圾:默认只预览,执行先移入回收区,7 天内可还原
audit_trend分数历史:次数、最新分与变化、均值、最好/最差、P0 未关、sparkline
audit_digest差异驱动的周报摘要:与上次相比变了什么、上次说该修的现在怎样;没变化就一句话
audit_feedback首次价值信号:这条发现我原先知不知道(只记本机、不外发),用来算首次价值率
audit_findings问题清单(按严重度排序,带指纹与修法),可按 severity 过滤
audit_explain解释某一条:维度、证据、测到的值、置信度、修法
audit_plan修复顺序:先解 P0 封顶,再按单条增量排,给出全修完的终点
audit_trim装载面瘦身:同能力多实现、超 bundles 上限、记忆插件叠放,给主备候选
audit_capabilities能力域矩阵:20 个域 × 六态(有/多/冲突/失效/无/未知),每缺口给四级补救阶梯
audit_retire误报记档(原因必填),之后不再计分;action=restore 撤销记档
audit_diff跨次差异归因:新增了什么、真修好了什么、哪些只是被退役(不算修好)
audit_verify跨重启验回:上次体检说该修的,修好了没、有没有把别的东西搞坏(只报告不修)
audit_checkCI 门禁形态:PASS/WARN/FAIL 三值 + 退出码 0/1/2(与 dsh-plugin-doctor 同契约)
audit_recommend能力域推荐源:20 域的补救阶梯与「去哪找」(不联网、不给包名)

不想用工具、只想在终端跑:

dsh-healthkit                 # 人读的报告(= node bin/audit.mjs)
dsh-healthkit --help          # 全部动作(不跑体检、不记账)
dsh-healthkit --json          # 机读
dsh-healthkit --why           # 每条问题修掉能涨多少
dsh-healthkit --trend         # 分数历史
dsh-healthkit --findings      # 问题清单 / --explain <fp> 解释一条 / --plan 修复顺序
dsh-healthkit --trim          # 装载面瘦身候选(只给建议,不改配置)
dsh-healthkit --init          # 接入自检:报环境/装没装/还差哪一步
dsh-healthkit --retire <fp> --reason "原因"   # 误报记档(--list-retired 查看)
dsh-healthkit --unretire <fp>                # 撤销记档(重新计分)
dsh-healthkit --diff              # 与上一次快照比:新增 / 真修好 / 新退役
dsh-healthkit --verify             # 验回:修好了没 / 还在 / 被静音 / 回归
dsh-healthkit --check              # CI 门禁:三值契约 + 退出码 0/1/2
dsh-healthkit --recommend          # 能力域推荐源(20 域阶梯 + 去哪找)
dsh-healthkit --format json       # 全量 JSON 报告(机器可读,schema: dsh-healthkit/report/v1)

面板

原生侧边栏面板(推荐):装上并重启后,右侧栏会出现「体检」标签——总分、分档、 P0/P1/P2/INFO、未解决/已退役、可清理空间、服务插件水位、最新分与记账,以及按严重度排的前 8 条 (带修法提示与指纹)。走 sidebarRightTabs + slots,不占端口、不用记地址、不经过 iframe。

独立网页(备用):http://127.0.0.1:<宿主端口>/dsh-healthkit-panel (端口跟宿主 GUI 一致)。服务端渲染、页面零 JS、每 60 秒自刷新;数据接口 /dsh-healthkit-panel/api/summary 可程序化读取。

  • 侧边栏的 iframe 浏览器不执行页面脚本,所以网页面板直接塞进侧边栏会空白——要么用原生标签, 要么在系统浏览器里打开。0.5.3 起网页面板也改成了服务端渲染,禁脚本环境照样能显示。
  • 只读:GET 不记账、不写状态,浏览器预取/刷新都安全;每分钟缓存一次。
  • 只认回环:非 127.0.0.1/::1 的请求直接 403。
  • 面板挂不上不影响工具面(降级成没有面板,结果写进 plugin-status.json 的 panel 字段)。

它量什么

分维度看:安全、一致性、装载整洁、模型成本、可维护性等。每条问题带指纹,修好记成 verified,下次不会又冒出来当新问题。

P0 会封顶总分(≥1 条封 5.0,≥3 条封 4.0)——所以分数涨得快,通常意味着 P0 真被修掉了, 而不是规则变宽松。

体检是只读的:不写配置、不联网、不读你的会话内容。

清理为什么敢按

  • 永不直删:一律进 $DSH_HOME/dsh-healthkit/trash/<批次>/,带 manifest,7 天内搬回原样
  • 今天的备份绝不动:_backup 只淘汰 ≥14 天的
  • 护栏硬挡:node_modules / sessions / attachments / skills / data / .git / credentials 一律拒绝;apply 必须给具体 ids,没有「全清」
  • 需确认档(远程工作区镜像)不给 confirm 就不动

现状

R1–R24 全跑;31 组测试全绿(Windows、WSL、CI 的 node 20/22 四份环境):夹具回归、不变量、 报告落点 8/8、版本号守卫、数据目录迁移守卫 4/4、工具形状(16 个)、面板路由与回环守卫、 apply() 注入路径(假 ctx 跑出 16 工具 + 3 路由 + 重复回调不重复挂)、能力域矩阵、误报退役区、 降级 9 场景、快照差分、可移植性、本地依赖 P0、跨重启验回、JSON 报告三值契约、能力域推荐源、 回收区符号链接、清理护栏 8×3 矩阵、坏 profile 上报、评分数学、事实缓存、 分层守门(规则层零 FS)、基线门与 fudge、首屏/周报/指标、locale 元数据; 真宿主 failures: []。

数据目录 $DSH_HOME/dsh-healthkit/:插件首次启动会把旧的 dsh-auditkit 整目录 rename 过来(账本、退役库、回收区一起带走),rename 失败则回落旧目录继续用,不半搬。

规划与取舍见 docs/。宿主契约(注册工具的四个坑、process.cwd 陷阱)与探针手法见 docs/NOTES-host-contract.md,修过的 bug 见 docs/ISSUES.md, 权限预设的四层(defaultPreset 为什么不改存量会话)见 docs/PRESET-LAYER.md。

License

MIT © 2026 zuoyunlai

Comments

Loading…

Similar plugins

dsh-perfscope

by Evhye38496

One-click health check for DeepSeek Harness: 0-100 score, plain-language issue list, and safe reversible fixes via the profile's cordis.patch.yml.

Development & InfrastructureManifest valid

★ 2

↓ 118/wk

MIT

TypeScript

Aug 29, 2026

dsh plugin --profile web add dsh-perfscope

by taxueseek

Read-only DSH environment health check: disk, memory, latency, ~/.dsh bloat and outdated-plugin detection with graded reports and baseline trend comparison. Deletes nothing.

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 1

MIT

TypeScript

Oct 25, 2026

dsh plugin --profile web add dsh-healthcheck

by laa1991

Declarative health readout for DSH: declare where to read, what counts as healthy, and which verdict each reading maps to. Read-only.

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Oct 3, 2026

dsh plugin --profile web add dsh-health-readout

Read-only health clinic for the installed DSH plugin set: loader health, dependency integrity, version compatibility, install-script risk, duplicates and patch integrity, delivered as a model tool, a

Development & InfrastructureManifest valid

★ 0

dsh plugin --profile web add dsh-plugin-clinic

Diagnostics for DeepSeek Harness plugins: finds plugins that failed to load, rows a failed update left behind, unmanaged entries - plus a disk scan for update leftovers.

Development & InfrastructureManifest valid

★ 0

MIT

TypeScript

dsh plugin --profile web add @ragnoryok1/dsh-plugin-doctor

by neufagents

Runtime health check for DeepSeek Harness: session-library scan + crash-tail inspection. Read-only.

Development & InfrastructureSessions & MessagesManifest valid

★ 0

MIT

TypeScript

Sep 18, 2026

dsh plugin --profile web add dsh-healthcheck