dsh-plugin

DeepSeek Harness（DSH）插件，每个插件是 plugins/<包名>/ 下独立的 npm 包。

插件

插件	说明
dsh-pairing-entry	给 DSH Web 一个固定入口 /entry/<key>：访问它自动换取当前启动 token，收藏的地址不再随重启失效。key 在 Web 设置面板里配置。
dsh-sleep-guard	拦截以 sleep N 开头的 Bash 命令，改为提示 Agent 用后台 Job 与 job_output(wait=true) 等结果。

使用前提

• Node.js ^22.19.0 || >=24.0.0。
• 能运行 dsh web。profile 目录位于 $DSH_HOME/profiles/<name>，未设置 DSH_HOME 时为 ~/.dsh/profiles/<name>。

安装插件

从本仓库安装单个插件：

dsh plugin --profile web add \
  "github:Xinglei-dev/dsh-plugin#path:/plugins/<包名>"

需要锁定版本时在 # 后写 tag 或 commit，并用 & 连接 path: 片段：

dsh plugin --profile web add \
  "git+https://github.com/Xinglei-dev/dsh-plugin.git#<tag>&path:/plugins/<包名>"

需要注意：

• 不能省略 path: 片段。仓库根没有 package.json，省略后 pnpm 会把整个仓库当成一个包安装。
• 安装或删除插件后重启 DSH 进程，新配置才会生效。

各插件的配置方法写在该插件目录的 README 里。

仓库结构

plugins/<包名>/
├── package.json          # 包名与目录名一致，dsh.bundle.patch 指向同目录的 cordis.patch.yml
├── cordis.patch.yml      # 安装时向 profile 插入的 loader entry
├── lib/index.js          # 插件本体
├── test/                 # 离线测试
└── README.md             # 安装、配置、排障与适用的 DSH 版本

仓库的开发约定见 AGENTS.md。

兼容性

每个插件针对具体的 DSH 版本开发，适用的版本写在插件自己的 README 里。DSH 处于 0.2.x 预发布阶段，内部接口仍会变化；插件依赖的非公开接口一旦变化，插件会在加载阶段报错，不会继续按旧行为运行。升级 DSH 后先看插件 README 的版本范围，不兼容时升级插件。

反馈

问题和建议提到 Issues。

许可

MIT