插件健康体检Evhye38496/dsh-perfscope

⚡ dsh-perfscope

PerfScope for DeepSeek Harness —— 一键体检你的 DeepSeek Harness

扫描 → 评分 → 一键修复 → 分享，全程本地完成。你的 Harness 健康吗？一键便知。

version license stars dsh-plugin

dsh plugin --profile web add dsh-perfscope

（dsh-market 收录审核中，详见项目规划）

为什么需要它

DeepSeek Harness 很年轻，插件生态正以每周数千的量级爆发——工具、皮肤、预设层出不穷。装多了之后，问题立刻出现：

- 哪个插件其实已经坏了、还在悄悄报错？
- 哪些插件拖慢每次会话、吃光 token？
- 是不是装了重复、冲突或早就忘掉的旧插件？
- 我的安装真的可信吗，还是一堆凑标题的仓库？

生态里还没有人做「健康体检」。dsh-perfscope 来补上这个空位：一键就能拿到 0–100 健康分、看得懂的问题清单，以及随时可撤销的安全一键修复。

与 VS Code 工具 PerfScope 同源的方法论——只是搬到了 agent harness 世界。而在这里，每次运行都有迹可循（every run is traceable），运行时数据比任何 IDE 都更丰富。

检查什么

健康分 = 三个维度，权重可配置（默认 0.6 / 0.25 / 0.15）：

| 维度 | 问的问题 | 信号示例 |
| --- | --- | --- |
| 硬健康 | 能不能用？ | 挂载失败、依赖缺失、核心包冲突、配置校验失败、与当前 dsh rc 不兼容 |
| 运行健康 | 快不快、稳不稳？ | 工具错误/超时率、平均耗时 vs 基线、token/上下文占用 |
| 治理健康 | 乱不乱、可不可信？ | 能力重复、插件久未更新、来源不在 curated 清单 |

严重度分级 严重 / 警告 / 建议——每条问题都是人话，一句话就能行动。

安全第一

- 读取插件树与会话/遥测统计，默认全程本地，绝不上传。
- 修复只写 cordis.patch.yml 的 patch 行（- id: … + disabled: true，官方 patch 层）——绝不卸载、删除或改源码。
- 每次写入先预览、记入Doctor 变更日志、一键可撤销。
- 宿主关键插件与手工编辑过的 patch 行受保护，不被一键开关误伤。

安装

dsh plugin --profile web add dsh-perfscope

重启 dsh web 后，打开 设置 → dsh-perfscope。

环境要求：Node ^22.19.0 或 24+。目标版本 dsh 0.1.0-rc.8（SPIKE 后锁定；预览阶段版本迭代很快，见路线图）。

使用

Web 界面 —— 设置 → dsh-perfscope：一键体检、查看分数卡、带预览地应用安全修复、撤销任意修复、导出报告。（v1.0 提供）

无头 / CI —— 扫描真实宿主、修复、撤销：

扫描真实 dsh profile（只读，无需模型 key）
npx dsh-perfscope scan --profile web --format markdown --out report.md
可分享的分数卡
npx dsh-perfscope scan --profile web --format html --out scorecard.html
一键安全修复（写 cordis.patch.yml，HMR 约 1s 生效）与撤销
npx dsh-perfscope fix --profile web --disable broken-plugin
npx dsh-perfscope fix --profile web --undo
离线快照模式（无需宿主，适合 CI/夹具）
dsh-perfscope --input test/fixtures/scan-input.json --format markdown --out report.md

可选参数：--registry（联网查询 npm 发布时间 / curated 状态）、--sessions-dir、--dsh-cli、--dsh-home。

开发

pnpm install
pnpm test          # 纯引擎 + 变更日志测试
pnpm run typecheck
pnpm run build     # tsup 打包

仓库布局与宿主接入的 SPIKE 决策门见 PROJECT.md（§5）。dsh 侧胶水层（scanner/、ui/、bootstrap）在 SPIKE 确认数据契约前为占位。

路线图

- S1 SPIKE — 已完成（2026-08-20）：dump-config 还原与 patch+HMR 闭环已在源码层确证；会话级运行时统计免费可得，插件级归因需自建映射（纳入 v1.1）。详见 SPIKE-S1.md。
- S2 v0.1 — 已完成（2026-08-23）：真实宿主扫描（scan）、无头 fix/undo（写 cordis.patch.yml）、离线 JSONL 会话分析（支持 zstd）、报告与分数卡。npm 包名定为 dsh-perfscope。
- S3 上架 —— awesome-dsh-plugin registry PR、dsh-plugin 话题、收录目录。
- v1.0 —— Web 设置面板，运行健康维度接入会话日志。
- v1.1 —— 插件级运行时归因（工具名→插件映射）。

社区

- 反馈与功能建议：GitHub Discussions（链接待定）。
- 可发现性：dsh-plugin 话题；awesome-dsh-plugin registry 收录（待审）。

License

MIT © 2026 Evhye（与 PerfScope 项目同许可）。

非官方开源项目，与 DeepSeek AI 无关。