DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-plugin-doctor

l

dsh-plugin-doctor

Manifest valid

DSH Plugin Health Check: Verify peer version compatibility before installation to prevent crashes from rc mismatches 🩺

hasBundlePatch

🩺 dsh-plugin-doctor

DSH 插件体检工具 —— 安装任何 DSH 插件之前,先体检再装,防止 rc 版本不匹配导致的启动崩溃。

为什么需要它

DSH 插件生态发展很快,很多插件还在快速迭代(rc 版本阶段)。插件声明的 peerDependencies(如 @deepseek-ai/dsh-tools@^0.0.1)与你本机的 DSH 版本 (如 0.1.0-rc.6)不匹配时,装进去轻则工具不工作,重则 web 界面直接起不来。

本插件把"装之前先检查"变成一条命令,输出一份体检报告:

检查项说明
🏥 本地环境读取本机 DSH / cordis / dsh-tools / dsh-workflow 版本
🔗 仓库可访问插件仓库是否公开(404 直接拦下,防止装"幽灵插件")
📦 bundle 声明是否声明 dsh.bundle.patch(官方可安装格式)
⚖️ peer 兼容性核心:插件要求的版本 vs 本机实际版本逐项对比(semver 匹配)
🏗️ 构建产物main 指向的入口文件是否已提交到仓库

体检结论三档:🟢 ok(可以装)· 🟡 warn(谨慎,注意风险项)· 🔴 danger(别装,装了会崩)。

安装

# 从 GitHub 安装(发布后)
dsh plugin --profile web add "github:<你的用户名>/dsh-plugin-doctor"

# 或从本地源码安装
dsh plugin --profile web add "file:/path/to/dsh-plugin-doctor"

重启 profile 后生效:

dsh --profile web

使用

安装后,向 DSH 说一句人话即可,例如:

帮我用 plugin_doctor 检查一下 dsh-external/dsh-deep-research

工具接受三种输入:

  • GitHub 仓库 URL:https://github.com/owner/repo
  • owner/repo 简写:owner/repo
  • npm 包名:@scope/name 或 name

输出示例(节选):

{
  "target": "dsh-external/dsh-deep-research",
  "verdict": "danger",
  "summary": "体检不通过,不要安装",
  "checks": [
    { "name": "本地环境", "status": "pass", "detail": "DSH 0.1.0-rc.6 · cordis 4.0.1 · dsh-tools 0.1.0-rc.6 ..." },
    { "name": "仓库可访问", "status": "pass", "detail": "github.com/dsh-external/dsh-deep-research 可访问" },
    {
      "name": "peer 兼容性",
      "status": "fail",
      "detail": "2 个 peer 依赖与本地版本不匹配(rc 不匹配风险!)",
      "items": [
        { "dep": "@deepseek-ai/dsh-tools", "required": "^0.0.1", "installed": "0.1.0-rc.6", "ok": false },
        { "dep": "@deepseek-ai/dsh-workflow", "required": "^0.0.1", "installed": "0.1.0-rc.6", "ok": false }
      ]
    }
  ],
  "recommendation": "不要安装:存在不兼容项,装进去可能导致启动崩溃。等插件更新适配后再装。"
}

工作原理

  • 网络检查走 DSH 内置 web 服务(ctx.web.fetch),不需要额外权限
  • 本机版本走 fs 服务读取全局安装的 DSH 包清单
  • semver 匹配为内置纯函数实现(零依赖),支持 ^ ~ >= <= > < = * 与多条件范围, 正确处理 prerelease(rc)版本规则
  • 工具通过 ctx.tools.register(defineTool(...)) 注册,随 profile 加载/卸载

开发

npm install --legacy-peer-deps   # 安装 typescript(跳过未发布的 @deepseek-ai peer)
npm run build                    # tsc → lib/

类型解析依赖本机 DSH 安装中的 @deepseek-ai/cordis 与 @deepseek-ai/dsh-tools:

ln -sfn <dsh安装>/node_modules/@deepseek-ai/cordis  node_modules/@deepseek-ai/cordis
ln -sfn <dsh安装>/node_modules/@deepseek-ai/dsh-tools node_modules/@deepseek-ai/dsh-tools

许可

MIT

Compatibility

DSH 0.2.1-alpha.1: failedDSH 0.2.0-rc.1: failedDSH 0.2.0-rc.2: failed

Versions

Latest versionPublishedSize
0.1.0——
0.1.1——

Comments

Loading…

Similar plugins

dsh-plugin-healthcheck

by chenw2759-wq

害怕插件装了就崩溃?用这个插件帮你检测插件是否正常/是否含木马!

Development & InfrastructureManifest valid

★ 14

MIT

JavaScript

Aug 15, 2026

dsh plugin --profile web add dsh-plugin-healthcheck

by 618527

DeepSeek Harness 插件安装前兼容性预检守卫:检查 Node/engines、@deepseek-ai 核心包 peer 版本与 dsh 清单,支持隔离试启动与确认后修复安装,防止版本不兼容导致崩溃。

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Aug 30, 2026

dsh plugin --profile web add dsh-install-guard

by liujianqiao701

DSH(DeepSeek Harness)插件兼容性体检:预警下次启动会被拒绝加载的插件,并在页面上按键一键隔离/卸载修掉它(改前自动备份、失败自动回滚)。Plugin compatibility vet for DeepSeek Harness.

Development & InfrastructureManifest valid

★ 0

MIT

JavaScript

Sep 30, 2026

dsh plugin --profile web add dsh-compat-vet

by omdsh-dev

DSH 插件健康检查工具:扫描插件仓库的清单协议 / patch 格式 / 构建陷阱 / hub 收录状态,零依赖只读,注册 plugin_check 工具

Tools & CapabilitiesManifest valid

★ 26

MIT

TypeScript

Sep 10, 2026

dsh plugin --profile agent add @omdsh-dev/dsh-plugin-check

by bbaz123

DSH 自安装插件管理器:在 设置 → 插件 中新增「自安装插件」页签,给出本 profile 自行安装插件的权威归属、运行健康与宿主兼容信息,并提供经 DPIP 前置校验的更新与回滚。

Terminal & ClientsManifest valid

★ 0

Apache-2.0

JavaScript

Oct 22, 2026

dsh plugin --profile web add dsh-self-plugin-manager

by BaqiF2

该仓库暂未提供项目说明。

Security & AuditDevelopment & InfrastructureTerminal & ClientsManifest valid

★ 1

↓ 217/wk

MIT

JavaScript

Oct 4, 2026

dsh plugin --profile web add dsh-plugin-precheck