插件套装安装器 Aceared0829/dsh-kit

dsh-kit

这是我的 DeepSeek Harness 插件套装，也是我日常在用的一套。

我把它们整理成了一个可以直接安装的仓库：你在自己的 Harness 上跑一条命令，就能装上我配置的这些插件和版本。想改什么，fork 我这个仓库自己维护，或者只装其中几个。

找更多 Harness 插件？GitHub 上搜 dsh-plugin 话题。

这里有什么

我自己写的这几个（源码在这个仓库里）：

| 插件 | 做什么 |
| dsh-connect-grok | 用你的 xAI 账号登录，把 Grok 模型走 SuperGrok 额度。设置页里登录一次就能用 |
| desktop-extras | 一次开三个 Desktop 能力：Git worktree、有头 Playwright 浏览器、桌面控制 |
| dsh-image-viewer | 点开对话里的图片和工具截图，缩放、拖动查看 |
| harness-eval | 会话证据面板：一轮活干坏在哪儿、花了多少、重试长什么样 |
| dsh-pet-lifecycle | 让桌宠跟着 Harness 一起起停：启动时拉起，退出时关掉。装到别人机器上要自己配 petDir（见 plugins/dsh-pet-lifecycle/LOCAL-CHANGES.md） |

我改过的这些（上游在 npm，我改的地方源码也放进来了，装的是我这份）：

| 插件 | 相对上游改了什么 |
| dsh-connect-workbuddy | 中文本地构建（5.12.4-zh.2）：固定的中文系统提示、Web GUI 段的中文版、把上游那些会触发网关拒答的英文指纹换成中文；另外在提示词正文中段还会被网关拦的那句 harness 说明也换成中文（11128 的真根因，实测定位到 111 字符）；另加 retryPolicy 配置项（默认码表不含 MALFORMED_RESPONSE）。改法与升级流程见 plugins/dsh-connect-workbuddy/LOCAL-CHANGES.md |

别人做的这些（从 npm 装，清单里锁了版本，我没把源码再拷一份）：

dsh-context、@modusensus/dsh-mneme（长期记忆）、dsh-better-sidebar、@changfenhuang/dsh-genui（界面组件）、@goodandready/ 两个（dsh-context-lens、dsh-time-machine）、@linxin666/ 三个（session-archive、usage、client-ui-model-capabilities）、billion-context、dsh-claude-style、dsh-super-code、ds-bot、dsh-github-connect、@tt-a1i/archify-dsh、@deepseek-ai/dsh-subagent-claude-code、@michengai/dsh-skills-manager。

完整清单和版本在 manifest.json。

本机开着、但不归这个库管的两个：kaoyan-workbench（自己的仓库 Aceared0829/kaoyan-workbench，用 link: 挂进 profile）、@local/dsh-turn-autocontinue（只在 default-workspace/bundles/ 里的本地 bundle，没有单独仓库）。这两个不在清单里，安装器不会去动它们。

Harness 自带、默认关着的实验包，我这套里也开了：agent team、语音输入、自动评审、inspector、worktree 工具、CoT 翻译、终端、会话搜索、会话标题、badge skill、ralph、插件市场、个性化推荐。装的时候会自动检查你那边有没有这些包，没有就跳过，不会为了装上而改你的 Harness。

装到你的机器上

前提：你已经装好 DeepSeek Harness，dsh 能在终端里跑。这个仓库不装 Harness 本身。

Desktop 用户注意：先在应用里注册「管理 dsh 命令」，然后从托盘完全退出。只关窗口不够——Host 还在后台跑的时候装不了 desktop profile。

git clone https://github.com/Aceared0829/dsh-kit.git
cd dsh-kit
.\install.ps1

macOS / Linux：

git clone https://github.com/Aceared0829/dsh-kit.git
cd dsh-kit
chmod +x install.sh
./install.sh --profile web

装完重新打开 Harness。

常用参数：

- -Profile desktop / --profile desktop：装进 Desktop 的 profile。没找到 Desktop 自带的 dsh 会拒绝，免得用普通 CLI 把 desktop profile 改坏
- -Profile web：装进 Web / 终端 profile
- -DryRun：只打印要跑的命令，不动 profile。想先看看会改什么就用这个
- -SkipPreferences：不套用我的设置模板
- -Home <dir>：指定 Harness home。默认用 DSH_HOME，再没有就是 ~/.dsh

安装器会往你的 profile 里补几个 pnpm 设置

首次安装时，安装器会往 profile 的 pnpm-workspace.yaml 里补几项，否则装不上：

- allowBuilds：放行 Harness 运行时的原生包（node-pty、koffi、protobufjs、@deepseek-ai/dsh-subprocess-local、@google/genai），外加 ssh2、cpu-features——这两个只有装 dsh-ssh 这类插件时才会用到，先放行，省得你之后自己加插件又被 pnpm 拦住。pnpm 11 只要见到没批准的构建脚本就整次中止
- nodeLinker: hoisted 和 autoInstallPeers: false：跟 Harness 自己的 profile 布局保持一致

只补你没有的。已经在用的 profile 不会被重写，改之前会备份成 pnpm-workspace.yaml.bak-dsh-kit。

想自己维护

fork 这个仓库，或者直接改你 clone 下来的那份。

改插件源码：plugins/ 下面就是。装的时候是 link: 到 clone 的目录，所以改完 git pull（别人）或直接重启（你自己）就生效，不用重新打包。

改装哪些插件：编辑 manifest.json。npm 里放包名和版本，local 里放 plugins/ 下的相对路径，shippedOptional 里放 Harness 自带的可选包名。

改我的设置模板：settings/preferences.patch.yml。现在里面是中文界面、详细对话视图、默认 grok-4.7 + xhigh 推理、加了一个插件市场索引。只在你的 cordis.patch.yml 还是空模板时才写入，你已经配置过就不动。

发布前跑一下公开检查，它会把本机路径、账号令牌这类不该进仓库的东西拦下来：

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/check-public.ps1
git add -A
git commit -m "更新插件清单"
git push

需要注意的

- cordis.patch.yml 不在这里。那是你自己的运行时配置，需要的话单独拷
- WorkBuddy 要自己登录。形状看 settings/workbuddy.example.yml，填好的别提交
- 版本是照我这台机器锁的。装到别人机器上，npm 那些是同样的版本，我改过的和自建的（dsh-connect-workbuddy、dsh-image-viewer、harness-eval 等）是同一个仓库里的同一份源码，装出来跟我这边一致。升级 WorkBuddy 上游时按 plugins/dsh-connect-workbuddy/LOCAL-CHANGES.md 的流程走，别直接 dsh plugin add 覆盖
- 版本是按我这台机器锁的。你那边 Harness 如果缺某个实验包，会跳过；版本不兼容时 dsh 会拒绝安装，安装器不会自动做版本豁免——真要装得自己处理
- link: 插件的路径必须前后一致。profile 的 package.json 写绝对 link: 时，pnpm-lock.yaml 里那条 version 也必须是同一个绝对路径。它一旦变成 link:../../..，pnpm 按相对层级重建成指向别处的悬空软链接，DSH 启动就报 cannot resolve profile bundle——此时按提示重跑 dsh plugin install 没用，会把同一条坏记录再建一遍。要改锁文件里那行 version，再重建链接
- DSH home 是 junction 时，相对软链接只能活一半。这是同一个坑更难看见的形态：~/.dsh 指向别处（比如 D:/DSH-Home）时，profile 有两条路能到——应用按 ~/.dsh 启动，pnpm 在真实的盘上装。同盘的 link: 目标被 pnpm 写成相对路径（..\..\..\..\deepseek-harness\plugins\harness-eval），而相对路径是按「用哪条路走到它」解析的：从真实盘走能解开，从 ~/.dsh 走就悬空。表现是插件列表显示包不可用 / 包元信息错误，插件静悄悄地不再加载，但一切看起来都装好了。修法是把该链接换成绝对 junction：cmd /c rmdir "" 再 cmd /c mklink /J "" "<绝对目标>"
- 装完会自动查这件事。安装器最后跑 scripts/check-plugin-links.mjs：只要某条链接只在一条路上活着，就中止安装并给出修复命令。平时也可以直接跑它自查，一条命令看清每个 profile 的每条链接在两条路上是否都通
- Desktop 和官方包 appId 一样。已经在用自建包的机器，别再装官方安装包，会盖掉自建那份

不会放进来的

整个 profile、node_modules（唯一的例外是 plugins/dsh-connect-workbuddy/node_modules/@deepseek-ai/schemastery——这个包不在 profile 根上，不带就得自己装）、锁文件、WorkBuddy 账号、本机绝对路径、Harness 源码，都不在这个库。

我 fork 的 Harness 是 Aceared0829/deepseek-harness，引擎相关的改动在那里；这个库只管插件。

这是我日常在用的 DeepSeek Harness 插件集，打包好之后你可以直接装到自己的 Harness 上。

我把它维护成一个仓库，一条命令就能装。你可以整套拿走，也可以只挑几个插件，或者 fork 一份维护自己的清单。

想找更多 Harness 插件？在 GitHub 上搜 dsh-plugin 话题。

这里有什么

我写的插件（源码就在本仓库）：

| 插件 | 作用 |
| dsh-connect-grok | 用 xAI 账号登录，让 Grok 模型走你的 SuperGrok 额度。在设置里登录一次即可 |
| desktop-extras | 一次给 Desktop 加三项能力：Git worktree、带界面的 Playwright 浏览器、原生桌面控制 |
| dsh-image-viewer | 从对话记录里打开图片或工具截图，可缩放、平移 |
| harness-eval | 会话证据标签页：一次运行在哪里卡住、花了多少、重试长什么样 |
| dsh-pet-lifecycle | 随 Harness 启动桌面宠物，退出时关掉。换机器时自己设置 petDir（见 plugins/dsh-pet-lifecycle/LOCAL-CHANGES.md） |

我改过的插件（上游在 npm 上；改过的源码也在这里，实际安装的是我这份）：

| 插件 | 与上游的差异 |
| dsh-connect-workbuddy | 中文本地构建（5.12.4-zh.2）：修好中文系统提示词，Web GUI 那段改成中文渲染，网关拒绝的上游英文指纹换成中文，另外——11128 的实测根因——提示词中间一句 harness 句子（111 个字符）换成中文；还加了 retryPolicy 选项，因为默认可重试错误码列表漏了 MALFORMED_RESPONSE。改动内容和升级步骤见 plugins/dsh-connect-workbuddy/LOCAL-CHANGES.md |

别人写的插件，按我锁定的版本从 npm 安装——我不重新托管它们的源码：

dsh-context、@modusensus/dsh-mneme（长期记忆）、dsh-better-sidebar、@changfenhuang/dsh-genui（UI 组件）、@goodandready/ 的两个（dsh-context-lens、dsh-time-machine）、@linxin666/ 的三个（session-archive、usage、client-ui-model-capabilities），外加 billion-context、dsh-claude-style、dsh-super-code、ds-bot、dsh-github-connect、@tt-a1i/archify-dsh、@deepseek-ai/dsh-subagent-claude-code 和 @michengai/dsh-skills-manager。

完整列表和版本在 manifest.json 里。

有两个跑在我机器上，但不归这套东西管： kaoyan-workbench（自己的仓库 Aceared0829/kaoyan-workbench，链接进配置档）和 @local/dsh-turn-autocontinue（default-workspace/bundles/ 下的本地 bundle，没有自己的仓库）。两个都不在 manifest 里，安装器不会碰它们。

Harness 默认关掉的实验性 bundle，我这套里都打开了：智能体团队、语音输入、自动审查、inspector、worktree 工具、CoT 翻译、终端、会话搜索、会话标题、badge 技能、ralph、插件市场、个性化推荐。安装器会检查你的安装里实际有没有每一项，缺了就跳过——不会为了强行塞进去而改你的 Harness。

安装

你需要先装好 DeepSeek Harness，并确保终端里能调用 dsh。这个仓库不负责安装 Harness 本身。

桌面端用户： 先在应用里注册 dsh 命令，然后从托盘彻底退出。只关窗口不够——Host 还在后台跑，只要它没停，桌面配置档就写不进去。

git clone https://github.com/Aceared0829/dsh-kit.git
cd dsh-kit
.\install.ps1

macOS / Linux：

git clone https://github.com/Aceared0829/dsh-kit.git
cd dsh-kit
chmod +x install.sh
./install.sh --profile web

装完后重新打开 Harness。

常用参数：

- -Profile desktop / --profile desktop —— 装进桌面配置档。找不到桌面版自带的 dsh 时它会拒绝执行，这样普通命令行就不会误伤这个配置档
- -Profile web —— 装进 Web / 终端配置档
- -DryRun —— 只打印命令，不动配置档。想先看看会改什么，就用这个
- -SkipPreferences —— 不套用我的设置模板
- -Home <dir> —— 指定 Harness home。默认取 DSH_HOME，没有就用 ~/.dsh

安装器会往你的配置档里加几项 pnpm 设置

首次安装时，它会往配置档的 pnpm-workspace.yaml 里写几个键，不写安装就跑不完：

- allowBuilds —— 放行 Harness 运行时的原生包（node-pty、koffi、protobufjs、@deepseek-ai/dsh-subprocess-local、@google/genai），外加 ssh2 和 cpu-features。后两个只有你之后加了 dsh-ssh 这类插件才用得上，提前批准，免得以后加插件被卡住。pnpm 11 一旦发现没批准的构建脚本，整个安装就直接中止
- nodeLinker: hoisted 和 autoInstallPeers: false —— 跟 Harness 自己给配置档用的目录布局保持一致

它只补你缺的。已有配置档不会被重写，原文件保留为 pnpm-workspace.yaml.bak-dsh-kit。

维护你自己的副本

Fork 这个仓库，或者直接改你手上这份克隆。

改插件： 源码在 plugins/ 下。它们以 link: 方式装进你的克隆，改完重启就生效，不用重新构建。

改装哪些插件： 编辑 manifest.json。包名和版本写在 npm 下，仓库内相对路径写在 local 下，Harness 自带的可选包名字写在 shippedOptional 下。

改我的设置模板： settings/preferences.patch.yml。目前它设了中文界面、详细会话记录视图、grok-4.7 配 xhigh 推理强度，还有一个插件市场索引。只有你的 cordis.patch.yml 还是空模板时它才会生效；你已经配过的内容一律不动。

发布前跑一遍公开检查——它会拦下不该进公开仓库的机器路径、账号和 token：

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/check-public.ps1
git add -A
git commit -m "Update the plugin list"
git push

值得注意的地方

- 没有包含 cordis.patch.yml。 那是你自己的运行时配置；需要的话单独复制
- WorkBuddy 需要单独登录。 配置模板在 settings/workbuddy.example.yml；不要提交填好的副本
- 版本号是按我这台机器锁定的。 换到别人的机器上，npm 条目会解析到同样的版本，我自己改过或写的那些（dsh-connect-workbuddy、dsh-image-viewer、harness-eval 等）来自本仓库中的同一来源，所以安装后跑的就是我这套。升级 WorkBuddy 上游时，按 plugins/dsh-connect-workbuddy/LOCAL-CHANGES.md 操作——不要用 dsh plugin add 覆盖它
- link: 插件在各处必须用同一路径。 配置档的 package.json 里声明了绝对路径的 link: 时，pnpm-lock.yaml 中对应的 version 也必须是同一个绝对路径。一旦它变成 link:../../..，pnpm 会按相对层级重建，在别处留下悬空符号链接，DSH 启动时报 cannot resolve profile bundle 拒绝启动；按提示重跑 dsh plugin install 只会重新生成同样错误的记录。改掉那行 version，再重建链接
- 桌面版和官方包共用同一个 appId。 如果你已经在跑自编译的包，不要再装官方版本覆盖它

刻意不放的东西

整个配置档、node_modules（有一个例外：plugins/dsh-connect-workbuddy/node_modules/@deepseek-ai/schemastery，它不在配置档根目录下，否则得单独安装）、锁文件、WorkBuddy 账号、机器绝对路径，以及 Harness 源码，都不进这个仓库。

我跑的 Harness 是我的分支 Aceared0829/deepseek-harness。引擎改动去那边；这个仓库只管插件。