前言¶
DeepSeek Harness(DSH)采用「一切皆插件」的方式扩展能力。profile 里插件一多,常见问题会变成:某个插件装在哪个 profile、有没有进 bundle、是否实际启用;桌宠、记忆、主题这类能力是否重复装了多套;npm 上是否有新版本;哪个包最占磁盘。手工翻 ~/.dsh/profiles 下的 package.json 可以回答部分问题,但分类和汇总仍然费时。
dsh-plugin-checkup(维护者 lls578)把上述问题收成三个只读工具:扫描本地 profile,不修改任何安装或配置。查更新时仅向 npm registry 请求插件名(公开信息),失败则跳过;其余数据不上传。
这是什么¶
- 定位:DSH 插件「插件体检」——按「治什么病」分类、查重复能力、查未启用、查可更新版本、看体积。
- 版本:0.1.0(见仓库
package.json)。 - 许可证:MIT。
- 运行环境:Node.js >= 22;peer 依赖
@deepseek-ai/dsh-tools、@deepseek-ai/schemastery(可选)。
社区目录页:https://www.skillhub.cn/plugins/lls578/dsh-plugin-checkup。目录站点为独立社区索引,与 DeepSeek / 幻方无官方从属关系。
核心功能¶
插件暴露三个工具(均只读本地):
| 工具 | 作用 |
|---|---|
plugin_list(profile?) |
列出已装插件:版本、描述、安装方式、是否在 bundles、体积 |
plugin_checkup() |
体检:按「治什么病」分类、重复能力、装了未启用、体积 top5、可更新版本及建议 |
plugin_why(name) |
查单个插件:版本、来源、安装方式、所在 profile、是否启用、体积 |
自动分类维度(依据插件名/描述):记忆/上下文 · 语音/字幕 · 界面/主题/桌宠 · 远程/连接 · 媒体/下载 · 插件管理/市场 · 安全/沙箱 · 会话/进度/任务 · 搜索/网络工具 · 模型/推理。
README 中的示例输出片段如下(完整 JSON 见仓库 docs/example-output.json):
profiles: desktop, headless | 插件数: 11
=== 按「治什么病」分类 ===
界面 / 主题 / 桌宠(4): dsh-whale-widget@0.3.18、…
...
=== 体检 ===
重复能力: 界面 / 主题 / 桌宠×4
建议:
· 有 1 类能力装了 3 个以上(界面 / 主题 / 桌宠×4),考虑留最顺手的 1-2 个。
仓库 README 附有分类、重复能力、可更新版本等截图(docs/categories.jpg 等),并链接 B 站介绍视频:https://www.bilibili.com/video/BV1ufxT6TEMj。
安装与启用¶
官方 README 给出的安装方式示例:
dsh plugin --profile desktop add link:C:\path\to\dsh-plugin-checkup
# 或 GitHub / npm
装完后重启 DSH。具体 add 子命令以你本机 DSH 文档为准;安装前建议阅读仓库源码与 MIT 许可证——插件以当前 DSH 进程权限运行。
典型用法¶
在 DSH 对话或工具调用中按需使用:
- 先看全局:
plugin_checkup(),得到分类、重复能力、未启用、体积 top5、可更新项与文字建议。 - 按 profile 列清单:
plugin_list()或plugin_list("desktop")。 - 核对单个包:
plugin_why("dsh-plugin-checkup")一类调用,确认版本、来源与各 profile 启用状态。
开发侧可在克隆后的仓库根目录运行(README「开发」一节):
node test/plugin.test.mjs # 单元测试(临时目录造数据,不联网)
node scripts/demo.mjs # 真实 profile 演示
隐私与注意¶
- 只读本地
~/.dsh/profiles/**/package.json及插件包信息。 - 查更新仅请求 npm 上对应插件名;网络失败自动跳过。
适合:已安装多个 DSH 插件、需要定期梳理 profile 的开发者。不适合替代官方插件管理器的安装/卸载操作——本插件 deliberately 不改本地状态。
相关链接¶
- 目录页:https://www.skillhub.cn/plugins/lls578/dsh-plugin-checkup
- 源码与说明:https://github.com/lls578/dsh-plugin-checkup
维护者同生态下的其它项目(README「相关项目」):dsh-fish-radar、dsh-bili-manager、dsh-meme-library 等,与本插件无依赖关系,可按需单独了解。