ZhijiangTang/dsh-plugin-template
ZhijiangTang★ 0ShellLast synced: 2026-08-15
Template repository for creating DSH plugins (npm bundle + scaffold script)
README excerpt
dsh-plugin-template DSH 组合包(bundle)插件模板 :脚手架一个新工具插件的最小可用骨架。 本仓库本身 不是可安装插件 ( package.json 里 private: true ,keywords 是 dsh-plugin-template ,不发布 npm)。 - 纯 ESM、零依赖、无构建步骤 - 一个 hello world 占位工具(含参数 / 输出 schema / render / execute) - mount 自检走 ctx.tools.execute 真实管道(CallId 来自 @deepseek-ai/dsh-llm ) 开发前必读: ../notes/plugin-development.md (本 hub 的实测笔记,所有结论均已验证)。官方文档本地副本在 ../reference/ ,发布教程见 https://deepseek-harness.github.io/deepseek-harness/develop/basic/publish.html 使用步骤 以下示例以新包名 dsh-mytool 为例。 1. 克隆 / 复制模板 2. 改 package.json(哪些字段要改) 字段 模板值 要改成 name dsh-plugin-template 你的 npm 包名(如 dsh-mytool ) private true 删除 (要发布 npm) keywords ["dsh-plugin-template"] ["dsh-plugin", " "] description 模板描述 你的插件一句话描述 version 0.1.0 按语义化版本维护 用脚手架 scaffold.sh 会自动完成前两项(删 private + 改写 name / keywords )。 3. 改 cordis.patch.yml 的 id / name cordis.patch.yml 里 id: 是稳定身份(不带 id 的行每次启动重新挂载); name: 按 npm 包名 引用代码。 4. 改 index.js 的工具 index.js 里所有「改这里」注释:插件名 export const name 、工具名 name: 'hello world' 、参数 / 输出 schema / execute 逻辑。 5. 验证配方(本地实测) 6. 发布 GitHub:建仓库并打 dsh-plugin topic(详见 ../notes/plugin-development.md §7)。 第一批实测坑速查(务必先读) 1. 本地安装必须 file: : dsh plugin add ./目录 生成 link: 符号链接,Node 按真实路径解析 @deepseek-ai/ → ERR MODULE NOT F…
View full README on GitHub →