在开发 DeepSeek Harness (DSH) 插件时,通常需要配置构建流程或管理依赖。这里提供一个极简的参考实现,它不依赖额外的运行时,也不需要编译步骤,适合作为插件开发的起点。
插件概述¶
这是一个 DeepSeek Harness (DSH) 的最小插件示例。由 LuwendiWuyi 维护。它通过 JavaScript 实现,在启动终端输出一条问候语。插件不增加模型工具或聊天界面元素,仅用于演示插件加载机制。
安装与启用¶
使用已安装的 DSH 运行以下命令安装:
dsh plugin --profile web add github:LuwendiWuyi/dsh-hello-plugin
需要满足的运行环境是 Node.js 22.19+ 或 24+,以及可用的 pnpm。
安装或卸载之后,需要重启对应的 profile。
典型用法¶
源码版验证¶
如果使用 DeepSeek Harness 源码版,在源码仓库根目录将 dsh 替换为 pnpm dsh:
pnpm dsh plugin --profile hello-demo add github:LuwendiWuyi/dsh-hello-plugin
安装后,使用 --dump-config 检查配置是否生效。输出结果中应包含 # == dsh-hello-plugin。
启动 profile:
pnpm dsh --profile hello-demo
启动后终端应出现 [hello-plugin] Hello, DSH! 插件加载成功。,按 Ctrl+C 退出。
打包与卸载¶
在插件目录运行 pnpm pack 可生成 .tgz 文件,然后使用绝对路径安装:
dsh plugin --profile web add /absolute/path/to/dsh-hello-plugin-0.1.0.tgz
卸载命令:
dsh plugin --profile web remove dsh-hello-plugin
注意事项¶
该插件将输出写入 stderr,确保 stdout 保留给宿主应用。
总结¶
这个插件展示了如何在 DSH 生态中创建一个无依赖的扩展。通过查看其 index.js 和 cordis.patch.yml 文件,可以了解插件激活的入口与配置方式。