[!IMPORTANT] AI agent： 这是尚未初始化的模板。请先读 AGENTS.md，再按 playbooks/00-init.md 执行。初始化前不要编写插件功能。

30 秒上手

把下面这句话发给 Claude Code、Codex、Cursor 或任何编程 agent，把功能换成你想要的：

用 https://github.com/exoticknight/dsh-plugin-template 建一个 DSH 插件 dsh-foo，
功能是……，发布到 npm。

agent 会创建你的仓库、完成初始化、实现功能、配置 GitHub 和 npm、发布第一个版本，再帮你提交到插件目录。只有登录 npm、首次发布这类必须由你本人完成的步骤，它才会停下来问你。

从一句话到上架

flowchart LR
  A["一句话需求"] --> B["建仓 + 初始化<br/>00-init"]
  B --> C["实现功能<br/>pnpm verify"]
  C --> D["GitHub 配置<br/>10-github"]
  D --> E["npm 首发<br/>20-npm"]
  E --> F["推 tag 发布<br/>30-release"]
  F --> G["目录收录 + badge<br/>50-listings"]

每一步都有一份 playbook：写明目标、前置条件、可以直接执行的命令和完成标准。之后的升级、发版和维护也按同样的方式进行。

你会得到

🧩 开箱即用的插件骨架

• Host 入口运行在 DSH 的 Node 进程中，由 Cordis 挂载，带配置 schema
• Client 入口运行在 DSH 页面中，打包成 DSH 模块加载器使用的格式；纯服务插件可以一键去掉
• esbuild 构建：@deepseek-ai/* 由 DSH 提供，插件名和版本号在构建时注入

✅ 不会坏的质量关卡

• TypeScript strict，契约测试覆盖包元数据、Cordis 挂载与卸载、client 注册
• 检查 npm 包内容，确保入口文件齐全、源码和测试不会混入
• 发布前把关：tag 与版本一致、仓库地址正确、没有残留占位符

🚀 一个 tag 完成发布

• CI 覆盖 Ubuntu / Windows × Node 22.19 / 24
• npm Trusted Publishing，并自动创建 GitHub Release：按 PR 标签分类变更、标注贡献者，可附加版本重点与升级说明
• 预发布版本自动走 npm next 通道；每一步都能安全重跑
• 也可以只发布到 GitHub（--no-npm）

🧪 不污染日常环境的本地调试

• pnpm dev 把当前源码链接进仓库内的隔离目录 .dsh-dev 并启动 DSH；pnpm smoke 在一次性目录中按用户的方式安装已发布版本并验证。两者都会校验隔离是否生效，绝不改动你日常使用的 DSH

🤖 写给 AI 的操作手册

📦 完整的仓库规范

• Dependabot、Bug 报告模板、中英双语 README、CONTRIBUTING、SECURITY；版本历史统一保存在 GitHub Releases，插件 README 提供链接
• 使用 RED 管理研究、变更与文档

需要你本人完成的事

手册会让 agent 在这些步骤停下来，交给你操作：

• npm login 和首次 npm publish（需要你的账号和两步验证码）
• 在 npmjs.com 上配置 Trusted Publisher
• 批准以你的名义向插件目录提交收录

其余步骤都由 agent 完成。

其他用法

手动复制，再交给 agent。 点击上方的 Use this template（或 clone 仓库），用 agent 打开后说「初始化这个插件」。

完全手动。 环境要求：Node.js ^22.19.0 || >=24、pnpm、git、已登录的 GitHub CLI；本地测试需要 DSH CLI。

node scripts/init.mjs --name dsh-foo --owner <github-user> --dsh-version <dsh 版本> \
  --title "Foo" --description "Foo for DeepSeek Harness."
pnpm install
pnpm hooks:install
pnpm verify

然后依次按 10-github、20-npm、30-release、50-listings 操作。

由 exoticknight 创建和维护 · Apache License 2.0