安装deepseek harness及插件

一、准备工作

1. 不管什么操作，都先安装npm和pnpm，下载安装即可，没难度。
   官网下载：https://nodejs.org/zh-cn

npm 是 node-js 的包管理和分发工具，当安装完成 node-js 后 npm 也随之安装完成，可以通过 npm -v 来校验是否安装成功

如果安装完成后系统提示如下

那么意味着PowerShell 执行策略（Execution Policy） 仍旧是默认禁止运行 .ps1 脚本，输入下面的命令就可以了。

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

2. 安装完npm后确认或修改缓存位置
   打开命令窗输入：

// 根据配置获得缓存位置
npm config get cache

// 如果不满意，更换缓存位置
npm config set cache "D:\Temp\npm-cache"

3. 安装pnpm，打开命令窗输入：
   此刻不安装pnpm也已经能安装dsh了，但是插件安装必须使用pnpm，所以还是要安装pnpm。
   打开命令窗输入：

npm install -g pnpm

二、临时安装做测试

（一）临时安装主体

打开命令窗输入：

// 临时安装
npx @deepseek-ai/dsh web

打开 http://127.0.0.1:3080 即可使用。

因为是临时安装，所以dsh被安装在新设置的缓存目录中：D:\Temp\npm-cache

升级命令

npx update @deepseek-ai/dsh web

（二）临时安装插件

比如安装https://github.com/aaaaaa/dsh-bbbbbbb，那么找到你刚才安装dsh的临时目录中的.bin目录，用命令安装。

来到这个临时.bin目录的原因是为了使用dsh命令，否则由于是装在缓存里的，其它目录中系统不认识dsh命令。

打开命令窗输入：

dsh plugin --profile web add @aaaaaa/dsh-bbbbbbb

反馈中提到了pnpm。

接着按 Ctrl+C 停掉当前 DSH，重新运行 npx @deepseek-ai/dsh web 即可。

此刻在deepseek harenss中就能搜到这个插件了。

如果在.bin目录里还是无法执行，那么可能需要执行类似

./dsh.ps1 plugin --profile web add @aaaaaa/dsh-bbbbbbb

如果插件就在本地，那么就执行

./dsh plugin --profile web add E:\Projects\Deepseek\plugin\dsh-bbbbbbb

三、正式安装

那就不再安装缓存里了，执行正式安装命令：

npm install -g @deepseek-ai/dsh

安装插件也可以直接使用dsh命令

dsh plugin --profile web add github:aaaaaa/dsh-bbbbbbb

因为已经正式安装了dsh，所以直接用这个命令启动运行即可

dsh web

四、检查插件

正确安装位置

C:\Users\Administrator\.dsh\profiles\web\      ← 目标 profile
└── node_modules\@aaaaaa\dsh-bbbbbbb\        ← 插件包本体
    ├── package.json
    ├── cordis.patch.yml
    ├── lib\host.js
    ├── lib\client.js
    └── locales\...  icons.js  scripts\

以及两个必须同步修改的配置文件(就在上面 profile 目录里):

① package.json — 加依赖 + 注册 bundle:

{
  "dependencies": {
    "@aaaaaa/dsh-bbbbbbb": "file:./node_modules/@aaaaaa/dsh-bbbbbbb"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "@aaaaaa/dsh-bbbbbbb"
      ]
    }
  }
}

② cordis.patch.yml — 插入插件行:

- insert:
    - id: dsh-workbench
      name: '@aaaaaa/dsh-bbbbbbb'

然后在该目录跑 pnpm install,重启 dsh 进程,刷新浏览器(关掉旧标签重开,别用缓存页)。

两种安装方式

方式 A(推荐,用 DSH 官方命令) —— 自动完成复制 + 注册 + 安装,最不容易出错:

dsh plugin --profile web add E:\Projects\Deepseek\plugin\dsh-bbbbbbb

方式 B(按 README 手动) —— 上面列的复制目录 + 改两个配置文件 + pnpm install。

这两种都会修改 C:\Users\Administrator\.dsh\...(在当前工作区之外)