插件开发

从克隆 deepseek-harness 仓库起步，理解 DSH-Plugin 装进 profile 后由 pnpm 管依赖、dsh plugin 转发命令；用独立 profile 隔离调试，再 dsh --dump-config 验证加载。

本分类面向想扩展 DeepSeek Harness Plugin（DSH plugin）生态的开发者：从项目结构、开发环境与调试方法讲起，演示如何把一个新插件加入 profile、如何用 dsh --dump-config 与 why 命令验证加载、以及如何对照官方示例推进开发。开发中的插件建议先用独立 profile 隔离，避免影响日常使用的 web 环境。

DSH-Plugin 教程列表

全部8概念与架构1安装与快速上手2配置与使用1更新与升级1卸载与清理1故障排查1插件开发1
插件开发2026-08-19

DSH 插件怎么开发？从最小插件到打包安装

DSH pluginDeepSeek Harness插件开发Cordisbundle

DSH 插件是一个导出 apply 函数的 TypeScript 模块，基于 Cordis：通过 name 命名、inject 声明依赖、ctx 注册能力、Config schema 接受配置。本文从最小插件写起，讲清打包成 bundle、用 dsh plugin add 装进 profile 的完整流程。

DSH plugin 开发常见问题

开发 DSH plugin 需要什么环境？

与使用 DSH 相同，需要 Node.js 与 pnpm；建议克隆官方 deepseek-harness 仓库作参考，并准备一个独立的 profile 用于调试插件。

dsh plugin 命令和 pnpm 是什么关系？

dsh plugin --profile <名字> 之后的参数会原样转发给该 profile 目录里的 pnpm，相当于在 ~/.dsh/profiles/<名字> 下执行 pnpm 命令，所以动作词要写在最后。

怎么验证我开发的插件被正确加载？

安装后用 dsh --dump-config 查看配置树，用 dsh plugin --profile <名字> why <包名> 确认依赖，再启动 dsh web 在界面里查看插件能力是否出现。

开发中的插件怎么不干扰日常使用？

创建一个独立的 profile（例如 --profile dev），把开发中的 DSH plugin 装进去；日常的 web profile 保持稳定，两者互不影响。

有没有官方示例可以参考？

有。deepseek-ai/deepseek-harness 仓库的 apps 目录包含官方实现，dsh-plugin.org 的插件详情页也会给出安装命令与仓库链接，可以对照学习结构。