插件中心 Lin-A1/dsh-hub

dsh-hub

DeepSeek Harness 的插件中心。

这个仓库把官方 harness 固定为 git 子模块，并按能力族归类我们的插件（以及精选的第三方插件）。每个插件都是 plugins/<category>/<name> 下的独立子模块，因此每个插件都是可独立版本化的单元。

目录结构

dsh-hub/
├── deepseek-harness/ # 官方 harness，跟踪 master（见「子模块」） ├── packagers/dsh-packager/ # 桌面打包器（仓库内）— 指定 DSH_DIR，开箱即用的安装包 └── plugins/ ├── browser/ memory/ sandbox/ skill/ └── vision/ web/ workflow/ workspace/

桌面打包器（开箱即用，支持多个 DSH 版本）

packagers/dsh-packager 放在仓库内（不是子模块）：把 DSH_DIR 指向任意 deepseek-harness 检出/标签，就能拿到桌面安装包，无需给 dsh 打补丁。插件热插拔（dsh plugin add）仍然走 ~/.dsh。

npm --prefix packagers/dsh-packager install
npm --prefix packagers/dsh-packager run build -- --dsh-dir deepseek-harness # submodule HEAD, e.g. 0.1.2-rc.1
npm --prefix packagers/dsh-packager run build -- --dsh-dir /tmp/dsh-rc7 # specific tag
npm --prefix packagers/dsh-packager run dist:win # or dist / npx electron-packager

图标取自 deepseek-harness/apps/web/public/favicon.svg → packagers/dsh-packager/build/icon.*，无边框 frame:false + Tray（关闭时隐藏到托盘，双击恢复）。

支持不同的 DSH 版本：scripts/build.mjs 会打印 @deepseek-ai/dsh-root@x.y.z，并把该版本的 resources/dsh/package.json 复制进应用。dsh-hub 的 deepseek-harness 跟踪 master，但 DSH_DIR 可以覆盖为任意标签/提交。

下载（Notes 中标注 DSH 版本）

- dsh-hub releases：https://github.com/Lin-A1/dsh-hub/releases — dsh-desktop-win32-x64.zip（便携版，dsh-desktop.exe）+ NSIS 安装程序（需要管理员权限/开发者模式以支持 winCodeSign）

每个 Release 都会注明打包的 DSH 版本，例如 DSH @deepseek-ai/dsh-root@0.1.0-rc.8。

插件归入其能力所属的类别，与维护者是谁无关。类别对应官方 packages/README.md 的分组列表。

子模块

deepseek-harness 跟踪上游 master 分支。当前指针固定在克隆时的 master HEAD；升级方式：

git submodule update --remote deepseek-harness
git add deepseek-harness
git commit -m "chore: bump deepseek-harness"

插件是独立子模块，固定到各自的默认分支（或由你决定的具体提交/标签）。

克隆

git clone --recursive https://github.com/Lin-A1/dsh-hub.git

如果已经克隆但没加 --recursive：

git submodule update --init --recursive

添加插件

对于你自己维护的插件：

在 harness 子模块内部，如果你的插件依赖 packages/
git submodule add https://github.com/<your-org>/<your-plugin>.git \
plugins/<category>/<your-plugin>
git commit -m "feat: add <your-plugin> under plugins/<category>/"

如果是第三方插件：

git submodule add https://github.com/<owner>/<plugin>.git \
plugins/<category>/<plugin>

分类由插件提供的能力决定——比如 LLM 适配器放在 plugins/llm/ 下，shell 执行器放在 plugins/shell/ 下。完整分类表见 plugins/README.md。

使用插件

本仓库里的插件，要装进真实 dsh 部署上的 配置档：

dsh plugin --profile <name> add ./deepseek-harness/plugins/<category>/<plugin>

（或者用 add github:<owner>/<plugin> 直接从 GitHub 安装）。

从源码构建 harness

cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

完整工具链和测试命令见官方 README。

更新全部内容

git submodule update --remote --recursive

然后提交所有指针变更。

约定

- 每个插件都是独立的 npm 包，有自己的 dsh manifest，而不是往 deepseek-harness/ 里加 monorepo 内容。
- 插件 README 要声明自己的能力、配置 schema，以及发出或监听的事件。
- 本仓库本身不含任何代码——它只是一个指针索引。

学习 wiki（dsh 内部机制与 LLM 知识）

一套分步技术 wiki，讲解 dsh 如何构建，以及背后的 LLM 知识，面向 AI 应用开发者。第一辑——图像如何到达模型（归一化、确定性投影缓存、Files API 与 base64、预算闸门、历史上下文管理），并与 opencode、OpenAI Codex、Claude Code 做四方对比：

- docs/dsh-image-pipeline-wiki.md（Markdown）
- docs/dsh-image-pipeline-wiki.html（HTML）
- docs/dsh-image-pipeline-wiki.pdf（PDF）

第二辑——dsh 如何插件化（Cordis 五大理念、插件形态、loader 与 cordis.yml、插件树与 fiber 状态机、配置档 / bundle / 层、能力接缝、HMR），基于 deepseek-harness 源码和 dsh-hub 插件规范：

- docs/dsh-plugin-architecture-wiki.md（Markdown）
- docs/dsh-plugin-architecture-wiki.html（HTML）
- docs/dsh-plugin-architecture-wiki.pdf（PDF）

许可证

各插件保留自己的许可证。见每个插件的仓库。