bugmaker2/dsh-plugin-template 预览 preview

bugmaker2/dsh-plugin-template

插件Plugin 原生Native ⭐ 34 MIT

用于DeepSeek-Harness插件开发的模板。

项目介绍Project Overview

dsh-plugin-template 是一个极简的 TypeScript DeepSeek Harness 插件模板,加载时输出 hello world。它提供 package.json、cordis.patch.yml、src/index.ts 和 lib/index.js 等结构,演示如何将一个普通 Cordis 插件打包为可安装的 profile bundle。适合作为新插件的脚手架,通过 fork 后修改名称字段和源码即可扩展。注意模板故意未包含 React Client、Remote 契约或测试框架,仅在确有需要时再加入。

dsh-plugin-template is a minimal TypeScript DeepSeek Harness plugin bundle that prints hello world when loaded. It provides package.json, cordis.patch.yml, src/index.ts, and lib/index.js, showing how to package a Cordis plugin as an installable profile bundle. Use it as a starting scaffold by forking, renaming the required fields, and editing the source. Note that the template intentionally omits a React Client bundle, Remote contract, and test framework, so add them only when the plugin truly needs them.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

git clone https://github.com/bugmaker2/dsh-plugin-template.git

bugmaker2/dsh-plugin-template 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-plugin-template

English | 中文

A minimal TypeScript DeepSeek Harness plugin bundle. It prints hello world when Harness loads it.

Start from a fork

git clone https://github.com/YOUR-USER/dsh-plugin-template.git
cd dsh-plugin-template

pnpm install
pnpm run check
dsh plugin --profile hello add .
dsh --profile hello --dump-config | grep dsh-plugin-template
dsh --profile hello

A successful run includes this line in the Harness output:

[dsh-plugin-template] hello world

For development, edit src/index.ts, run pnpm run build, then restart the profile. The generated lib/ directory is included in the package so direct Git installs can load the built JavaScript entry.

If you rename the package, keep these values in sync:

  • package.jsonname
  • src/index.tsname
  • cordis.patch.yml → both id and name

Remove it with:

dsh plugin --profile hello remove dsh-plugin-template

The whole plugin

package.json       # declares the dsh.bundle patch and built entry
src/index.ts       # TypeScript Cordis plugin entry
lib/index.js       # generated Harness entry
cordis.patch.yml   # registers the package in a profile
tsconfig.json      # TypeScript type-checking configuration
pnpm-lock.yaml     # locked development dependencies

package.json is the only manifest Harness needs: dsh.bundle.patch makes the package an installable profile bundle. cordis.patch.yml inserts the plugin row, and src/index.ts is compiled to the ordinary Cordis name/apply entry point. This template uses TypeScript and tsdown, but intentionally has no React Client bundle, Remote contract, or test framework. Add those only when the plugin actually needs them.

Discoverability

Add the GitHub topic dsh-plugin to your fork. The topic is repository metadata, not a file in the repository:

gh api --method PUT repos/YOUR-USER/dsh-plugin-template/topics \
  -H 'Accept: application/vnd.github+json' \
  -f 'names[]=dsh-plugin'

License

MIT

上一个 Prev openguardrails 下一个 Next deepseek-harness-model-config