README.md

August 30, 2026 · View on GitHub

dsh-plugins

DeepSeek Harness (dsh) 自定义插件集合 — 每个插件可独立安装，也可通过集合 patch 一次性全部安装。
license

简介

dsh-plugins 是面向 DeepSeek Harness 的 插件集合仓库。集合内每个插件都是独立的 npm 包（纯 cordis 插件形态，0811 官方规范）， 挂在 dsh web profile 上：

  • 独立安装：只想用一个插件时，按该插件 README 安装单个包 + insert 行；
  • 全部安装：应用本仓库根 cordis.patch.yml（一次性插入所有插件行），dsh web --patch 即挂载全部。

插件目录

插件功能安装
dsh-web-auth内网/LAN/Tailscale 访问密码认证 + 信任：非回环 /api 与 WebSocket 需密码登录，认证后设置/凭据等特权页在内网可用独立 / 全部
dsh-sidebar右侧边栏：pidance Chamber Native 风格工作区面板（文件树与文件操作 / Git 更改 / 会话信息 / 终端 + 44px 常驻轨道）独立 / 全部
dsh-web-mobile手机视口：默认会话页，顶栏开关左右侧栏；独立可用，探测到 auth/sidebar 时自动接上独立 / 全部
dsh-web-terminal侧栏用户 PTY 终端：多标签 xterm 面板，经 WebSocket 流式收发独立 / 全部
dsh-vision-fallback视觉回退链：主模型不支持图片时自动切换到配置的视觉模型独立 / 全部
dsh-auto-update一键更新 dsh 运行时：检查 npm 正式版/预览版，后台升级 + 校验后重启 + 一键回退独立 / 全部

平台兼容

  • Linux / macOS / Windows：全部插件跨平台（路径经 node:path / homedir / XDG / %APPDATA% 解析，无 /root 等硬编码；终端默认目录按平台回退）。
  • dsh-desktop（anywhere-labs/dsh-desktop）： 插件作为普通 DSH 插件在桌面壳内照常工作；dsh-auto-update 检测到内嵌部署时 自动禁用命令行升级（由桌面宿主自带更新机制管理）。

安装

全部安装（一次性）

dsh web --patch /path/to/dsh-plugins/cordis.patch.yml

或把 cordis.patch.yml 的内容并入你的 profile 的 $DSH_HOME/profiles/web/cordis.patch.yml（配置 HMR 实时生效，无需重启）。

独立安装（单个插件）

dsh plugin --profile web add /path/to/dsh-plugins/plugins/<name>

然后在 $DSH_HOME/profiles/web/cordis.patch.yml 加对应 insert 行（见各插件 README）， 配置 HMR 实时生效。详细步骤见 docs/INSTALL.md。

注意：插件依赖的 @deepseek-ai/* / cordis 由 dsh 官方运行时经 profile pnpm 闭包注入， 不要在插件 package.json 里声明这些依赖（官方未发布到公共 npm，声明反而解析失败）。

仓库结构

dsh-plugins/
├── cordis.patch.yml         # 一次性全部安装的 patch 层（insert 所有插件）
├── docs/
│   ├── INSTALL.md           # 安装指南（独立 / 全部 / 配置）
│   └── CONTRIBUTING.md      # 新增插件规范
├── examples/                # 各插件独立安装示例
└── plugins/
    └── <name>/              # 每个插件 = 独立 npm 包
        ├── package.json     # main/exports + dsh.client 声明
        ├── src/index.js     # Node half（Cordis entry）
        ├── src/client.js    # Client half（__ModuleLoader__.load）
        └── README.md        # 该插件文档

开发 / 新增插件

新增插件遵循官方 0811 插件规范（纯 cordis 或 bundle 形态），详见 docs/CONTRIBUTING.md 与官方 make-dsh-plugin 引导。

插件管理

已装插件推荐用 plugin-registry 的薄控制台 （浏览器面板）管理安装态（bundle 层栈 + insert 行 + 启停），无需手改配置：

dsh plugin --profile web add "github:vlln/plugin-registry#main&path:/packages/plugin/console"

License

MIT © 2026 Henry Li