返回目录

dsh-plugin-template

维护状态: 活跃

bugmaker2/dsh-plugin-template

DeepSeek Harness 插件开发模板,帮助快速搭建插件工程。

前往 GitHub
$ dsh plugin --profile web add .

104

星标

1

Fork

TypeScript

语言

MIT

许可证

2026-08-13

创建于

2026-08-27

最近推送

MIT 许可的 DeepSeek Harness 插件脚手架(TypeScript),生成一对主机+客户端插件并暴露 Typert Remote,已预置构建、测试与 CI。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-08-30

许可证

MIT

01它能帮你完成什么?

  • Scaffold a dual-side DeepSeek Harness plugin (host + client) from a working reference

    A ready-to-build template that registers a `greet` Remote — the host composes `"Hello, <name>"` and the client renders it in a new "Greet" tab

    Plugin developers building for the DeepSeek Harness runtime who want the full plugin surface wired up (type-checking, linting, tests, CI, publishing)

  • Learn how a DeepSeek Harness host plugin and Web client plugin connect end to end

    Annotated `src/` layout, `dsh.plugin.json` registry manifest, `cordis.patch.yml` profile mount, and `build.mjs` dual build

    Developers who want a concrete reference for the Harness plugin surface before writing their own plugin

02如何接入 DeepSeek Harness?

前置条件

  • Node.js >= 22.19 (or >= 24)
  • pnpm >= 9
  • DeepSeek Harness >=0.1.0-rc.6

安装步骤

  1. 01

    pnpm install

  2. 02

    pnpm run build

  3. 03

    $ dsh plugin --profile web add .

  4. 04

    Restart the Web Harness after rebuilding the plugin

验证接入成功

  • A "Greet" tab appears in the session view ring showing `Hello, DSH`

回滚

  • dsh plugin --profile web remove dsh-plugin-template

03DSH 适配与能力边界

DSH 适配原生运行时

Built for the DeepSeek Harness runtime: a host plugin exposes a Typert `greet` Remote and a client plugin mounts it into a React view; install via `dsh plugin --profile web add .`.

  • Host plugin: greet Remote (Typert)

    configurable prefix via the Config schema→composes `"Hello, <name>"` string from the prefix and the name

  • Client plugin: Greet tab (React view)

    the greet Remote result→renders `Hello, <name>` in a new "Greet" tab of the session view ring

    mounts the Remote into the Web harness module loader and adds a "Greet" tab to the session view ring
  • Dual build & CI

    TypeScript sources in src/ and tests/→host ESM + client CJS bundles plus type declarations; vitest unit tests; CI on push

04适合谁?何时不该用?

适合

  • Plugin developers building for the DeepSeek Harness runtime who want the full plugin surface wired up (type-checking, linting, tests, CI, publishing)
  • Developers who want a concrete reference for the Harness plugin surface before writing their own plugin

不适合

  • A Git install (`dsh plugin --profile web add github:...`) fetches sources, not built artifacts, so pnpm runs `prepare` to build `lib/`. pnpm >=10 blocks that build until you set `allowBuilds`; that allowance lets the package run code at install time, so only allow packages you trust and pin a commit.

05兼容性、维护与安全提示

  • A Git install (`dsh plugin --profile web add github:...`) fetches sources, not built artifacts, so pnpm runs `prepare` to build `lib/`. pnpm >=10 blocks that build until you set `allowBuilds`; that allowance lets the package run code at install time, so only allow packages you trust and pin a commit.
2026-08-132026-08-27作者未说明

MIT licensed DeepSeek Harness plugin template (sources: ours); last push 2026-08-27; no tagged GitHub release

06常见问题

如何用 DeepSeek Harness 安装 dsh-plugin-template?

在本地仓库中运行 `pnpm install`、`pnpm run build`,然后 `dsh plugin --profile web add .` 并重启 Web Harness。会出现一个显示 `Hello, DSH` 的「Greet」标签页。

安装前提是什么?

Node.js >= 22.19(或 >= 24)、pnpm >= 9,以及 DeepSeek Harness >=0.1.0-rc.6。

模板如何接入 DeepSeek Harness?

它包含一个暴露 Typert Remote(greet)的主机插件,以及一个把该 Remote 挂载到 React 视图的客户端插件;Harness 只需要 `package.json` 这一个清单,外加用于 dsh.so 注册表的 `dsh.plugin.json`。

如何卸载?

运行 `dsh plugin --profile web remove dsh-plugin-template`。

Git 安装为什么要求设置 allowBuilds?

Git 安装拉取的是源码而非构建产物,因此 pnpm 会运行 `prepare` 脚本来构建 `lib/`。pnpm >= 10 默认会阻止该构建,直到你在 profile 的 `pnpm-workspace.yaml` 中加入 `allowBuilds: dsh-plugin-template: true`;该授权允许包在安装时执行代码,因此只授权你信任的包,并固定提交。

08数据与来源

  • 作者声明github.com31af7ebeb8d0…

    A complete dual-side [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugin template.

  • 作者声明github.com31af7ebeb8d0…

    a **host** plugin exposing a Typert Remote, and a **client** plugin mounting that Remote into a React view

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-30。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。