dsh-plugin-guide 0.1.1 → 0.2.0

package/package.json

@@ -1,11 +1,21 @@
 {
   "name": "dsh-plugin-guide",
-  "version": "0.1.1",
-  "description": "The dsh-plugin-guide knowledge base as an installable DeepSeek Harness plugin: official docs, Cordis primer, community deep-dives, and battle-tested pitfalls registered as an on-demand agent skill.",
+  "version": "0.2.0",
+  "description": "The dsh-plugin-guide knowledge base plus the dsh-plugin-dev CLI toolchain: official docs, Cordis primer, community deep-dives, and battle-tested pitfalls registered as an on-demand agent skill, with a scaffolder, static checker, and pack verifier for building DSH plugins.",
   "type": "module",
   "main": "index.js",
+  "bin": {
+    "dsh-plugin-dev": "./bin/dsh-plugin-dev.js"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./package.json": "./package.json"
+  },
   "files": [
     "index.js",
+    "bin",
+    "dist",
+    "templates",
     "cordis.patch.yml",
     "SKILL.md",
     "guide",
@@ -26,13 +36,35 @@
     "cordis",
     "agent-skill",
     "plugin-development",
-    "knowledge-base"
+    "knowledge-base",
+    "cli",
+    "scaffold",
+    "checker"
   ],
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/PerryLink/dsh-plugin-guide.git"
   },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "typecheck:ci": "tsc --noEmit --pretty false",
+    "test": "vitest run",
+    "check:kit": "pwsh -File scripts/verify-kit.ps1",
+    "verify:artifacts": "node scripts/verify-artifacts.mjs",
+    "verify:self-contained": "pnpm run build && node dist/dsh-plugin-dev.js verify",
+    "prepare": "tsdown",
+    "prepack": "tsdown"
+  },
+  "dependencies": {
+    "tsdown": "^0.22.14",
+    "typescript": "^5.9.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "vitest": "^3.2.7"
+  },
   "peerDependencies": {
     "@deepseek-ai/dsh": ">=0.1.0-rc.8 <0.2.0"
   },
@@ -46,6 +78,10 @@
       "patch": "./cordis.patch.yml"
     }
   },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "packageManager": "pnpm@11.7.0",
   "dshWorkshop": {
     "schema": "omdsh-workshop-package/v1",
     "type": "plugin",
@@ -65,7 +101,7 @@
     },
     "permissions": ["filesystem:read"],
     "compatibility": {
-      "dshVersions": ["0.1.0-rc.8"]
+      "dshVersions": ["0.1.1-rc.2"]
     },
     "capability": {
       "id": "dsh-plugin-guide",

package/references/official-docs/CLAUDE.md

@@ -1 +1 @@
-AGENTS.md
+AGENTS.md

package/references/official-docs/SNAPSHOT.md

@@ -1,16 +1,16 @@
-# official-docs snapshot (SNAPSHOT.md)
-
-> Generated by `scripts/sync-official-docs.ps1`. This file is the single authority for how `references/official-docs/` lines up with upstream deepseek-harness.
-> The "last verified" dates and commit SHAs in README/guide must cite this file; do not hand-edit them.
-
-| Item | Value |
-|---|---|
-| Source checkout | `D:\deepseek-harness` |
-| Source ref | `origin/master` |
-| Source commit | `47f943859bef60e4160492346772ded9b24f765a` |
-| Synced at (UTC) | 2026-08-14T15:13:50Z |
-| Scope | tracked files at the ref: `docs/`, root `AGENTS.md`, `BENCHMARK.md`, `CLAUDE.md`(symlink 目标文本), `CONTRIBUTING.md`/`.zh.md`/`.i18n.yaml`, `README.zh.md`/`.i18n.yaml`（上游英文 `README.md` 不在本目录，快照见 `downloads/github/harness/README.md`）, `THIRD_PARTY_NOTICES.md`, `LICENSE`, `packages/AGENTS.md`, `examples/AGENTS.md`, `packages/README.md`, `vendor/README.md`, `website/docs.ts` |
-| File counts | docs/: 215 md files (105 .zh.md pairs) |
-| Pruned this run | 107 个不在范围内/上游已删除的条目 |
-
-Drift check: `pwsh -File scripts/verify-kit.ps1 -Checkout <checkout>` (tracked files only).
+# official-docs snapshot (SNAPSHOT.md)
+
+> Generated by `scripts/sync-official-docs.ps1`. This file is the single authority for how `references/official-docs/` lines up with upstream deepseek-harness.
+> The "last verified" dates and commit SHAs in README/guide must cite this file; do not hand-edit them.
+
+| Item | Value |
+|---|---|
+| Source checkout | `D:\deepseek-harness` |
+| Source ref | `origin/master` |
+| Source commit | `47f943859bef60e4160492346772ded9b24f765a` |
+| Synced at (UTC) | 2026-08-14T15:13:50Z |
+| Scope | tracked files at the ref: `docs/`, root `AGENTS.md`, `BENCHMARK.md`, `CLAUDE.md`(symlink 目标文本), `CONTRIBUTING.md`/`.zh.md`/`.i18n.yaml`, `README.zh.md`/`.i18n.yaml`（上游英文 `README.md` 不在本目录，快照见 `downloads/github/harness/README.md`）, `THIRD_PARTY_NOTICES.md`, `LICENSE`, `packages/AGENTS.md`, `examples/AGENTS.md`, `packages/README.md`, `vendor/README.md`, `website/docs.ts` |
+| File counts | docs/: 215 md files (105 .zh.md pairs) |
+| Pruned this run | 107 个不在范围内/上游已删除的条目 |
+
+Drift check: `pwsh -File scripts/verify-kit.ps1 -Checkout <checkout>` (tracked files only).

package/scripts/verify-artifacts.mjs

@@ -0,0 +1,70 @@
+// Artifact gate for the dsh-plugin-guide CLI. Runs after `pnpm run build` and
+// verifies the shipped surfaces without any network access:
+//   1. the built CLI, bin shim, and template trees exist;
+//   2. the CLI self-checks this repo (dogfood) and reports `ok: true`;
+//   3. the scaffolder produces TS and JS skeletons inside a mkdtemp sandbox
+//      (never touching a real home directory), which are then removed.
+import { spawnSync } from 'node:child_process'
+import { existsSync, mkdtempSync, rmSync, readdirSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const failures = []
+
+function check(condition, message) {
+  if (condition) {
+    console.log(`ok - ${message}`)
+  } else {
+    failures.push(message)
+    console.error(`FAIL - ${message}`)
+  }
+}
+
+function runNode(args, options = {}) {
+  return spawnSync(process.execPath, args, { cwd: root, encoding: 'utf8', ...options })
+}
+
+// 1. Shipped surfaces.
+check(existsSync(join(root, 'dist', 'dsh-plugin-dev.js')), 'dist/dsh-plugin-dev.js exists (run pnpm run build first)')
+check(existsSync(join(root, 'bin', 'dsh-plugin-dev.js')), 'bin/dsh-plugin-dev.js exists')
+check(existsSync(join(root, 'templates', 'ts')), 'templates/ts exists')
+check(existsSync(join(root, 'templates', 'js')), 'templates/js exists')
+
+// 2. Version + dogfood self-check.
+const version = runNode(['dist/dsh-plugin-dev.js', '--version'])
+check(version.status === 0 && /\d+\.\d+\.\d+/.test(version.stdout.trim()), `--version prints a semver (${version.stdout.trim()})`)
+
+const selfCheck = runNode(['dist/dsh-plugin-dev.js', 'check', '--json'], { stdio: ['ignore', 'pipe', 'pipe'] })
+let ok = false
+if (selfCheck.status === 0) {
+  try {
+    ok = JSON.parse(selfCheck.stdout).ok === true
+  } catch {
+    ok = false
+  }
+}
+check(selfCheck.status === 0 && ok, `self-check (dogfood) reports ok (exit ${selfCheck.status})`)
+
+// 3. Scaffold smoke in a mkdtemp sandbox.
+const sandbox = mkdtempSync(join(tmpdir(), 'dsh-pd-artifacts-'))
+try {
+  for (const lang of ['ts', 'js']) {
+    const target = join(sandbox, lang, 'demo-plugin')
+    const result = runNode(['dist/dsh-plugin-dev.js', 'new', 'demo-plugin', '--lang', lang, '--dir', target])
+    const hasEntry = lang === 'ts' ? existsSync(join(target, 'src', 'index.ts')) : existsSync(join(target, 'index.js'))
+    const hasPatch = existsSync(join(target, 'cordis.patch.yml'))
+    const readmeCount = readdirSync(target).filter((f) => /^README(\.\w{2})?\.md$/.test(f)).length
+    check(result.status === 0 && hasEntry && hasPatch, `${lang} scaffold produces entry + cordis.patch.yml (exit ${result.status})`)
+    check(readmeCount === 5, `${lang} scaffold produces 5 README languages (${readmeCount})`)
+  }
+} finally {
+  rmSync(sandbox, { recursive: true, force: true })
+}
+
+if (failures.length > 0) {
+  console.error(`\nverify:artifacts FAILED (${failures.length})`)
+  process.exit(1)
+}
+console.log('\nverify:artifacts OK')

package/templates/js/LICENSE

@@ -0,0 +1,15 @@
+Apache License 2.0
+
+Copyright (c) {{year}} {{pkgName}} contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/templates/js/README.es.md

@@ -0,0 +1,42 @@
+# {{pkgName}}
+
+Un plugin de DeepSeek Harness (DSH) generado con [`dsh-plugin-dev new`](https://github.com/PerryLink/dsh-plugin-guide).
+
+## Compatibility
+
+| Superficie | Estado |
+|---|---|
+| Harness | DeepSeek Harness `0.1.1-rc.2` |
+| Node | `^22.19.0 || >=24.0.0` |
+| Plataformas | Todas (ESM puro; sin código nativo, sin red) |
+
+## What it does
+
+Registra la herramienta `{{name}}_echo`. Al llamarla responde `<greeting>: <text>`, donde `<greeting>` proviene de la configuración del plugin y `<text>` es el argumento.
+
+## Install
+
+```sh
+pnpm pack
+dsh plugin --profile <name> add ./{{pkgName}}-{{version}}.tgz
+dsh --profile <name> --dump-config | grep '{{pkgName}}'
+```
+
+## Configuration
+
+| Clave | Tipo | Valor por defecto | Descripción |
+|---|---|---|---|
+| `greeting` | string | `Hello` | Prefijo de la respuesta echo |
+
+La configuración se valida con el esquema Schemastery `Config` de `index.js`; ningún ajuste está codificado de forma fija.
+
+## Development
+
+```sh
+pnpm install
+pnpm test
+```
+
+## License
+
+[Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/js/README.hi.md

@@ -0,0 +1,42 @@
+# {{pkgName}}
+
+[`dsh-plugin-dev new`](https://github.com/PerryLink/dsh-plugin-guide) से बनाया गया एक DeepSeek Harness (DSH) प्लगइन।
+
+## Compatibility
+
+| सतह | स्थिति |
+|---|---|
+| Harness | DeepSeek Harness `0.1.1-rc.2` |
+| Node | `^22.19.0 || >=24.0.0` |
+| प्लेटफ़ॉर्म | सभी (शुद्ध ESM; कोई नेटिव कोड नहीं, कोई नेटवर्क नहीं) |
+
+## What it does
+
+`{{name}}_echo` टूल पंजीकृत करता है। इसे बुलाने पर `<greeting>: <text>` लौटाता है, जहाँ `<greeting>` प्लगइन कॉन्फ़िग से आता है और `<text>` आर्गुमेंट है।
+
+## Install
+
+```sh
+pnpm pack
+dsh plugin --profile <name> add ./{{pkgName}}-{{version}}.tgz
+dsh --profile <name> --dump-config | grep '{{pkgName}}'
+```
+
+## Configuration
+
+| कुंजी | प्रकार | डिफ़ॉल्ट | विवरण |
+|---|---|---|---|
+| `greeting` | string | `Hello` | echo उत्तर का उपसर्ग |
+
+कॉन्फ़िगरेशन `index.js` में Schemastery `Config` स्कीमा से मान्य होता है; कोई भी सेटिंग हार्डकोडेड नहीं है।
+
+## Development
+
+```sh
+pnpm install
+pnpm test
+```
+
+## License
+
+[Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/js/README.md

@@ -0,0 +1,42 @@
+# {{pkgName}}
+
+A DeepSeek Harness (DSH) plugin scaffolded by [`dsh-plugin-dev new`](https://github.com/PerryLink/dsh-plugin-guide).
+
+## Compatibility
+
+| Surface | Status |
+|---|---|
+| Harness | DeepSeek Harness `0.1.1-rc.2` |
+| Node | `^22.19.0 || >=24.0.0` |
+| Platforms | All (plain ESM; no native code, no network) |
+
+## What it does
+
+Registers the `{{name}}_echo` tool. Calling it replies with `<greeting>: <text>`, where `<greeting>` comes from the plugin config and `<text>` is the argument.
+
+## Install
+
+```sh
+pnpm pack
+dsh plugin --profile <name> add ./{{pkgName}}-{{version}}.tgz
+dsh --profile <name> --dump-config | grep '{{pkgName}}'
+```
+
+## Configuration
+
+| Key | Type | Default | Description |
+|---|---|---|---|
+| `greeting` | string | `Hello` | Prefix for the echo reply |
+
+Configuration is validated by the Schemastery `Config` schema in `index.js`; no tunable is hardcoded.
+
+## Development
+
+```sh
+pnpm install
+pnpm test
+```
+
+## License
+
+[Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/js/README.pt.md

@@ -0,0 +1,42 @@
+# {{pkgName}}
+
+Um plugin do DeepSeek Harness (DSH) gerado com [`dsh-plugin-dev new`](https://github.com/PerryLink/dsh-plugin-guide).
+
+## Compatibility
+
+| Superfície | Estado |
+|---|---|
+| Harness | DeepSeek Harness `0.1.1-rc.2` |
+| Node | `^22.19.0 || >=24.0.0` |
+| Plataformas | Todas (ESM puro; sem código nativo, sem rede) |
+
+## What it does
+
+Registra a ferramenta `{{name}}_echo`. Ao chamá-la, responde `<greeting>: <text>`, em que `<greeting>` vem da configuração do plugin e `<text>` é o argumento.
+
+## Install
+
+```sh
+pnpm pack
+dsh plugin --profile <name> add ./{{pkgName}}-{{version}}.tgz
+dsh --profile <name> --dump-config | grep '{{pkgName}}'
+```
+
+## Configuration
+
+| Chave | Tipo | Padrão | Descrição |
+|---|---|---|---|
+| `greeting` | string | `Hello` | Prefixo da resposta echo |
+
+A configuração é validada pelo schema Schemastery `Config` em `index.js`; nenhum ajuste fica fixo no código.
+
+## Development
+
+```sh
+pnpm install
+pnpm test
+```
+
+## License
+
+[Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/js/README.zh.md

@@ -0,0 +1,42 @@
+# {{pkgName}}
+
+由 [`dsh-plugin-dev new`](https://github.com/PerryLink/dsh-plugin-guide) 脚手架生成的 DeepSeek Harness（DSH）插件。
+
+## Compatibility
+
+| 项目 | 状态 |
+|---|---|
+| Harness | DeepSeek Harness `0.1.1-rc.2` |
+| Node | `^22.19.0 || >=24.0.0` |
+| 平台 | 全部（纯 ESM；无原生代码、无网络） |
+
+## What it does
+
+注册 `{{name}}_echo` 工具。调用它时返回 `<greeting>: <text>`，其中 `<greeting>` 来自插件配置，`<text>` 是入参。
+
+## Install
+
+```sh
+pnpm pack
+dsh plugin --profile <name> add ./{{pkgName}}-{{version}}.tgz
+dsh --profile <name> --dump-config | grep '{{pkgName}}'
+```
+
+## Configuration
+
+| 键 | 类型 | 默认值 | 说明 |
+|---|---|---|---|
+| `greeting` | string | `Hello` | echo 回复的前缀 |
+
+配置由 `index.js` 中的 Schemastery `Config` 模式校验；没有任何硬编码可调参数。
+
+## Development
+
+```sh
+pnpm install
+pnpm test
+```
+
+## License
+
+[Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/js/cordis.patch.yml

@@ -0,0 +1,10 @@
+# {{pkgName}} bundle layer: register the scaffolded plugin as a bundle row.
+# This file is the `dsh.bundle.patch` layer (see package.json#dsh.bundle.patch).
+# Layer semantics: a YAML array of row verbs; `insert` adds plugin rows to the
+# composed config. A row's `id` must be unique within the layer stack; `name`
+# resolves the plugin module through the installed package (package.json#main).
+- insert:
+    # `id`: stable row identifier used by later layers to override this row.
+    - id: {{pkgName}}
+      # `name`: the module the loader imports; resolves to this package entry.
+      name: {{pkgName}}

package/templates/js/index.js

@@ -0,0 +1,38 @@
+import { defineTool } from '@deepseek-ai/dsh-tools'
+import Schema from '@deepseek-ai/schemastery'
+
+export const name = '{{pkgName}}'
+export const inject = ['tools']
+
+// Tunable configuration must be a Schemastery Schema, never a plain object:
+// the harness validates it at load time and fails loud on invalid values, and
+// every key can be changed from cordis.yml without editing code (guide §3.6).
+export const Config = Schema.object({
+  greeting: Schema.string().default('Hello').description('Greeting prefix for the echo tool.'),
+})
+
+/** Pure greeting builder kept separate from the tool so tests stay keyless. */
+export function buildGreeting(greeting, text) {
+  return `${greeting}: ${text}`
+}
+
+// Every registration is an effect: `ctx.tools.register` returns the disposer that
+// removes the tool on unload, so the plugin stays hot-reloadable (guide §3.3).
+export function apply(ctx, config) {
+  ctx.tools.register(
+    defineTool({
+      name: '{{name}}_echo',
+      description: 'Echo a greeting back to the caller.',
+      parameters: {
+        text: { type: 'string', required: true, description: 'Text to echo.' },
+      },
+      output: {
+        schema: { type: 'string' },
+        render: (_args, value) => [{ type: 'text', text: value }],
+      },
+      async execute(args) {
+        return buildGreeting(config.greeting, args.text)
+      },
+    }),
+  )
+}

package/templates/js/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "{{pkgName}}",
+  "version": "{{version}}",
+  "description": "A DeepSeek Harness (DSH) plugin scaffolded by dsh-plugin-dev.",
+  "type": "module",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "cordis.patch.yml"
+  ],
+  "scripts": {
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.8 <0.2.0",
+    "@deepseek-ai/schemastery": "^3.18.0",
+    "vitest": "^3.2.7"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.8 <0.2.0",
+    "@deepseek-ai/schemastery": "^3.18.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "packageManager": "pnpm@11.7.0",
+  "license": "Apache-2.0"
+}

package/templates/js/tests/index.test.js

@@ -0,0 +1,12 @@
+import { describe, expect, it } from 'vitest'
+import { buildGreeting } from '../index.js'
+
+describe('{{pkgName}}', () => {
+  it('builds a greeting from the configured prefix', () => {
+    expect(buildGreeting('Hello', 'world')).toBe('Hello: world')
+  })
+
+  it('keeps the text verbatim after the prefix', () => {
+    expect(buildGreeting('Hi', 'a b:c')).toBe('Hi: a b:c')
+  })
+})

package/templates/ts/LICENSE

@@ -0,0 +1,15 @@
+Apache License 2.0
+
+Copyright (c) {{year}} {{pkgName}} contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/templates/ts/README.es.md

@@ -0,0 +1,44 @@
+# {{pkgName}}
+
+Un plugin de DeepSeek Harness (DSH) generado con [`dsh-plugin-dev new`](https://github.com/PerryLink/dsh-plugin-guide).
+
+## Compatibility
+
+| Superficie | Estado |
+|---|---|
+| Harness | DeepSeek Harness `0.1.1-rc.2` |
+| Node | `^22.19.0 || >=24.0.0` |
+| Plataformas | Todas (ESM puro; sin código nativo, sin red) |
+
+## What it does
+
+Registra la herramienta `{{name}}_echo`. Al llamarla responde `<greeting>: <text>`, donde `<greeting>` proviene de la configuración del plugin y `<text>` es el argumento.
+
+## Install
+
+```sh
+pnpm pack
+dsh plugin --profile <name> add ./{{pkgName}}-{{version}}.tgz
+dsh --profile <name> --dump-config | grep '{{pkgName}}'
+```
+
+## Configuration
+
+| Clave | Tipo | Valor por defecto | Descripción |
+|---|---|---|---|
+| `greeting` | string | `Hello` | Prefijo de la respuesta echo |
+
+La configuración se valida con el esquema Schemastery `Config` de `src/config.ts`; ningún ajuste está codificado de forma fija.
+
+## Development
+
+```sh
+pnpm install
+pnpm run typecheck
+pnpm test
+pnpm run build
+```
+
+## License
+
+[Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/ts/README.hi.md

@@ -0,0 +1,44 @@
+# {{pkgName}}
+
+[`dsh-plugin-dev new`](https://github.com/PerryLink/dsh-plugin-guide) से बनाया गया एक DeepSeek Harness (DSH) प्लगइन।
+
+## Compatibility
+
+| सतह | स्थिति |
+|---|---|
+| Harness | DeepSeek Harness `0.1.1-rc.2` |
+| Node | `^22.19.0 || >=24.0.0` |
+| प्लेटफ़ॉर्म | सभी (शुद्ध ESM; कोई नेटिव कोड नहीं, कोई नेटवर्क नहीं) |
+
+## What it does
+
+`{{name}}_echo` टूल पंजीकृत करता है। इसे बुलाने पर `<greeting>: <text>` लौटाता है, जहाँ `<greeting>` प्लगइन कॉन्फ़िग से आता है और `<text>` आर्गुमेंट है।
+
+## Install
+
+```sh
+pnpm pack
+dsh plugin --profile <name> add ./{{pkgName}}-{{version}}.tgz
+dsh --profile <name> --dump-config | grep '{{pkgName}}'
+```
+
+## Configuration
+
+| कुंजी | प्रकार | डिफ़ॉल्ट | विवरण |
+|---|---|---|---|
+| `greeting` | string | `Hello` | echo उत्तर का उपसर्ग |
+
+कॉन्फ़िगरेशन `src/config.ts` में Schemastery `Config` स्कीमा से मान्य होता है; कोई भी सेटिंग हार्डकोडेड नहीं है।
+
+## Development
+
+```sh
+pnpm install
+pnpm run typecheck
+pnpm test
+pnpm run build
+```
+
+## License
+
+[Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/ts/README.md

@@ -0,0 +1,44 @@
+# {{pkgName}}
+
+A DeepSeek Harness (DSH) plugin scaffolded by [`dsh-plugin-dev new`](https://github.com/PerryLink/dsh-plugin-guide).
+
+## Compatibility
+
+| Surface | Status |
+|---|---|
+| Harness | DeepSeek Harness `0.1.1-rc.2` |
+| Node | `^22.19.0 || >=24.0.0` |
+| Platforms | All (plain ESM; no native code, no network) |
+
+## What it does
+
+Registers the `{{name}}_echo` tool. Calling it replies with `<greeting>: <text>`, where `<greeting>` comes from the plugin config and `<text>` is the argument.
+
+## Install
+
+```sh
+pnpm pack
+dsh plugin --profile <name> add ./{{pkgName}}-{{version}}.tgz
+dsh --profile <name> --dump-config | grep '{{pkgName}}'
+```
+
+## Configuration
+
+| Key | Type | Default | Description |
+|---|---|---|---|
+| `greeting` | string | `Hello` | Prefix for the echo reply |
+
+Configuration is validated by the Schemastery `Config` schema in `src/config.ts`; no tunable is hardcoded.
+
+## Development
+
+```sh
+pnpm install
+pnpm run typecheck
+pnpm test
+pnpm run build
+```
+
+## License
+
+[Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.