zhang66633/dsh-plugin-installer ↗★ 1

dsh-plugin-installer

安装并排除 DeepSeek Harness (dsh) 插件的故障 — 即使是完全初学者也能轻松上手。作为捆绑的技能提供者插件发布。

skillsAgent 协作integrations

包名: dsh-plugin-installer
版本: 1.1.0
许可证: MIT
最近更新: 2026年8月14日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:zhang66633/dsh-plugin-installer

说明文档

阅读完整 README ↗

dsh-plugin-installer

在 DeepSeek Harness（dsh） 里安装与排查插件——小白也能装得明明白白。

简体中文 · English

这是什么

dsh-plugin-installer 是一个技能（agent 指令包），把 DeepSeek Harness 的 agent 变成可靠的插件安装器与报错诊断器。你描述想要的插件，agent 理解需求、定位来源（npm 或 GitHub）、选最稳的安装路径、安装、验证、回报。

这里的每一条流程都经过实战验证（2026-08，dsh 0.1.0-rc.6 生态，真实机器）。

为什么需要它

手装 dsh 插件坑很多，官方文档没写：

npm 的 latest dist-tag 还指向旧版 0.0.1-rc.1，范围安装直接装错。
GitHub clone 的插件不带 node_modules，要靠共享依赖层解析 @deepseek-ai/*。
cordis.patch.yml 是 patch 层——新增插件实例必须包在 - insert: 里，否则被静默跳过。
皮肤系统（@linxin666）有上游 bug，需要版本条件化的补丁。
pnpm 9.15 会悄悄忽略 nodeLinker: hoisted。

这个技能把这些全部沉淀下来，你不需要重新踩一遍。

特性

✅ npm 直装，钉精确版本（防 stale dist-tag）
✅ GitHub clone + 注册，一条命令搭共享依赖层
✅ MCP 服务器 / 技能 / 皮肤 的安装路径
✅ patch-skins.sh —— 检测先于打补丁、版本条件化、幂等可重跑的皮肤修复
✅ diagnose.sh —— 一键体检"插件装没装对"
✅ 13 个坑的完整配方（references/edge-cases.md，症状 → 根因 → 修复）
✅ 小白安全：每个关键决策点停下来问你
✅ 打包成技能提供方插件（ctx.skills provider；可 dsh plugin add 安装，进目录就绪）

快速开始

1. 安装技能

路线 A —— 作为技能（文件系统发现，零配置）：

git clone --depth 1 https://github.com/zhang66633/dsh-plugin-installer ~/.dsh/skills/dsh-plugin-installer

dsh-plugin-installer · DSH Hub

# 发布到 npm 后：
dsh plugin --profile 
 add dsh-plugin-installer
# 本地开发直接 link：
#   ~/.dsh/profiles/
/package.json → "dependencies": { "dsh-plugin-installer": "link:" }
#   + dsh.profile.bundles 加 "dsh-plugin-installer"
cd ~/.dsh/profiles/
 && pnpm install

bash /scripts/bootstrap.sh
# 插件目录默认 ~/.dsh/plugins，可用 DSH_PLUGINS_DIR 覆盖

git clone --depth 1 https://github.com//.git 
/
cd 
/
node -e "const p=require('./package.json'); console.log(JSON.stringify({name:p.name, main:p.main, dsh:p.dsh, deps:p.dependencies},null,1))"
ls lib/ 2>/dev/null

grep -rhoE "from ['\"](https://github.com/zhang66633/dsh-plugin-installer/blob/9a422131ae8b24e13b7719ca7c39e3ccf8595971/[%5E./][%5E'/%22]*)" lib/ | sed "s/from ['\"]//" | sed 's#/.*##' | sort -u
cd 
 && npm install   # 把缺的包加进 package.json 后

{
  "dependencies": {
    "": "link:
/"
  },
  "dsh": {
    "profile": {
      "bundles": [""]
    }
  }
}

cd ~/.dsh/profiles/
 && pnpm install

dsh --profile 
 --dump-config 2>&1 | grep -A2    # 出现在组合树里
dsh web                                                       # 启动干净
bash /scripts/diagnose.sh                      # 全项体检

- insert:
    - id: mcp-context7
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: context7
        transport: stdio
        command: npx
        args: ['-y', '@upstash/context7-mcp']

bash /scripts/patch-skins.sh          # 检测 → 打补丁（幂等）
bash /scripts/patch-skins.sh --check  # 只报告，不打


## 工作原理

核心是**共享依赖层**。GitHub clone 的插件通过 `link:` 注册进 profile；运行时 Node 从插件真实路径向上解析 `@deepseek-ai/*`，于是共同的祖先目录里的一个 `
/node_modules` 就满足所有插件。新插件装进来，只需把缺的依赖加进那一个 `package.json` 再 `npm install`。

补丁管理**版本条件化**：每个补丁在已装文件里留标记；脚本动手前先检测 *已打 / 上游已修 / 需打*，升级或重装后下一次运行即自动收敛。

## 兼容性

- **dsh 生态**：`0.1.0-rc.6`——**最后验证 2026-08-14**（技能本体 + 插件加载 + `dsh --dump-config`）。npm `latest` tag 是旧的——永远钉精确版本
- **系统**：Windows（Git Bash）、macOS、Linux——脚本是 POSIX `bash`
- **pnpm**：处理了 9.15 `nodeLinker` 的坑（需要 hoist 时用 `pnpm install --config.nodeLinker=hoisted`）

## 目录结构


## 权限与数据

本技能在你的机器上安装和管理 dsh 插件。涉及范围：

- **读写的文件**：你的 dsh profile（`~/.dsh/profiles/
/package.json`）、patch 层（`~/.dsh/cordis.patch.yml`）、`
` 下的插件目录。会编辑 profile 清单来注册插件。
- **网络**：npm registry（安装/更新插件）与 GitHub（源码插件 git clone）。无统计、无遥测。
- **凭据**：不存储任何东西——从不读 `.credentials.yaml` 或任何 API key。
- **执行**：自带脚本（`bootstrap.sh`、`patch-skins.sh`、`diagnose.sh`）会在你的机器上运行 shell 命令（`npm`、`pnpm`、`git`、`node`）。

本地、用户可控：没有你在 🔴 决策点点头，什么都不会替你做。

## 排查

- 跑 `bash /scripts/diagnose.sh ` 做结构化体检。
- 查 `references/edge-cases.md`：13 个真实坑的 症状 → 根因 → 修复（stale dist-tag、pnpm nodeLinker、`- insert:` 要求、坏发布、GitHub SSL、缺 `httpServer`、皮肤 bug 等）。
- 踩到新坑？加进 `edge-cases.md`——这个技能是活的配方本。

## 贡献

发现新坑或更好的修复？欢迎 PR。`references/edge-cases.md` 保持三段式（症状 → 根因 → 修复）；上游更新时记得更新皮肤一节的版本表。

## 许可证与安全

[MIT](https://github.com/zhang66633/dsh-plugin-installer/blob/9a422131ae8b24e13b7719ca7c39e3ccf8595971/LICENSE) © 2026 zhang66633

要私下报告安全问题，请在本仓库开 GitHub security advisory，而不是公开 issue。