Skip to content
dsh marketplace

dsh-plugin-devkit

Verified

dsh-plugin-devkit · v0.3.0 · MIT · Web UI

开发者工具包：一键生成合规 dsh 插件脚手架（默认 TypeScript，可选 JavaScript）、按三条硬规则校验 schema、生成社区注册表发布条目。

Install

dsh plugin add dsh-plugin-devkit

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

🇨🇳 简体中文 | 🇬🇧 English

dsh-plugin-devkit

用于开发 DeepSeek Harness（dsh）插件的开发者工具包。一键生成合规脚手架、按三条硬规则校验 schema、生成发布到社区注册表的条目。

安装

# 方式一（推荐）：从 npm 安装（包名即 dsh-plugin-devkit）
dsh plugin --profile web add dsh-plugin-devkit

# 方式二：从 GitHub 安装
dsh plugin --profile web add github:d-ouyang/dsh-plugin-devkit

# 本地开发：dsh plugin --profile web add ./dsh-plugin-devkit

装完重启 web 服务（:3080）。

工具

scaffold_plugin —— 生成合规脚手架

对话里说：「帮我生成一个 dsh 插件，名字 my-tool，品类 tools，作者 d-ouyang」 → 在 ~/dsh-plugin-my-tool/ 生成入口文件（默认 TypeScript：index.ts + <name>-core.ts + tsconfig.json）、package.json、cordis.patch.yml、README.md、test.ts、examples/。 → 想生成纯 JavaScript，传 language: "js"，则为 index.js + <name>-core.js + test.mjs。 → TypeScript 插件运行时由 dsh 的 tsx 即时转译（零构建），且能在编辑器/tsc 阶段对 cordis ctx 与 tool schema 做类型检查。

lint_plugin —— 校验三条硬规则

对话里说：「检查 ~/dsh-plugin-my-tool 的 schema 是否合规」 → 用 harness 真实的 defineTool 编译器编译你的工具，把天书错误翻译成「你违反了第几条规则 + 怎么改」。

explain_rules —— 三条规则讲解

对话里说：「dsh 工具 schema 有哪三条硬规则？」

publish_plugin —— 产出注册表条目 + 步骤

对话里说：「把 ~/dsh-plugin-my-tool 发布到社区注册表」 → 生成 awesome-dsh-plugin 注册表条目 JSON 与提交步骤。不会自动推送。

open_landscape —— 插件生态画像仪表盘

对话里说：「看看 dsh 插件市场情况」「打开插件画像」 → 生成并打开一个可视化仪表盘：各品类插件数量/平均星/最高星、高星 Top25、竞争空白扫描。每个方向都有「创建此方向插件」按钮，点一下复制一段带市场参考的提示词，直接粘到聊天框即可让智能体用 scaffold_plugin 帮你生成该方向的插件。

  • 浏览器直接打开：file://~/.dsh/devkit/landscape.html
  • 若 dsh web 已加载本插件（端口以实际为准）：http://localhost:3080/devkit/landscape

三条硬规则

  1. required 要么省略，要么为 true——绝不写 false。
  2. type 只能是单一字符串——不接受数组（可空用 type: 'json'）。
  3. 每个 object（含数组 items 内嵌套 object）必须写 additionalProperties: true|false。

完整工作流：USAGE.md（中文） · USAGE.md (EN)