dsh-plugin-template
双端（主机端 + 客户端）DeepSeek Harness 插件模板，包含 Typert Remote、React 视图、测试、代码检查和 CI。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:bugmaker2/dsh-plugin-template#31af7ebeb8d07cff73253f52f9a9f530cde9de9aPlugin Template 以 dsh-plugin-template 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →English | 中文
A complete dual-side DeepSeek Harness plugin template. It demonstrates the full plugin surface — a host plugin exposing a Typert Remote, and a client plugin mounting that Remote into a React view — with type-checking, linting, unit tests, CI, and publishing metadata wired up.
Out of the box it registers a greet Remote: the host composes "Hello, <name>" from a configurable prefix, and the client renders the result in a new "Greet" tab.
package.json # dsh.bundle + dsh.client manifests, scripts, peer deps
cordis.patch.yml # mounts the host plugin row into a profile
dsh.plugin.json # dsh.so registry manifest
src/index.ts # host entry: Config schema + Typert manifest registration
src/runtime.ts # host Remote service (TypertRemoteService)
src/typert.ts # Typert model manifest
src/contract.ts # strict wire contract shared by host and client
src/types.ts # shared host/client types
src/client/index.tsx # client entry: mounts Remote + registers the view slot
src/client/remote.ts # client Remote contribution + typed namespace
src/client/locales.ts # zh / en dictionaries
src/client/view.tsx # minimal React view
src/client/styles.ts # theme-token stylesheet
tests/ # vitest unit tests (contract + runtime)
build.mjs # esbuild dual build (host ESM + client CJS)
.github/workflows/ci.yml
package.json is the only manifest Harness needs. dsh.bundle.patch makes the package an installable profile bundle; dsh.client declares the Web client bundle and the client packages it injects. The host entry is the ordinary Cordis name/apply export; the client entry is bundled to lib/client.js and loaded by the Web harness module loader.
>= 22.19 (or >= 24)>= 9>=0.1.0-rc.6pnpm install
pnpm run build
dsh plugin --profile web add .
Restart the Web Harness after rebuilding the plugin. A "Greet" tab appears in the session view ring showing Hello, DSH.
Remove it with:
dsh plugin --profile web remove dsh-plugin-template
dsh plugin --profile web add github:you/dsh-plugin-template
A Git install fetches sources, not built artifacts, so pnpm runs the prepare script to build lib/. pnpm ≥10 blocks that build until you allow it; on the first failed add, dsh prints the fix — copy the package key it shows into the profile's pnpm-workspace.yaml:
allowBuilds:
dsh-plugin-template: true
then re-run the add. That allowance lets the package run code at install time, so only allow packages you trust (and pin a commit).
pnpm run check
check runs typecheck, lint, test, and build. CI runs the same command after pnpm install --frozen-lockfile.
Individual scripts:
pnpm run build # esbuild dual bundle + declaration emit
pnpm run typecheck # tsc over src and tests
pnpm run lint # eslint
pnpm run test # vitest
Keep these values in sync when you rename:
package.json → name, exports, filesbuild.mjs → the __ModuleLoader__.load idsrc/index.ts → namesrc/client/remote.ts → package id and the TypertRemoteNamespace$… hex of the service keysrc/client/locales.ts → locale namespace keysrc/client/index.tsx → slot idsrc/typert.ts → packagesrc/contract.ts → invocation idscordis.patch.yml → id and namedsh.plugin.json → idAdd the GitHub topic dsh-plugin to your fork:
gh api --method PUT repos/YOUR-USER/dsh-plugin-template/topics \
-H 'Accept: application/vnd.github+json' \
-f 'names[]=dsh-plugin'
MIT