dsh-plugin-creator

August 28, 2026 · View on GitHub

一个用于创建和迭代 DSH（DeepSeek Harness）Web 插件的 Agent skill。

它把经过实践验证的插件开发流程、运行时边界与常见踩坑固化成一份可执行清单，覆盖从脚手架、Host/Client 装配、GUI 设置卡片、TDD 到发布验收的完整路径。

这个 skill 能帮你做什么

  • 规划插件范围：判断只要 Host 半区（后台逻辑/工具/命令/定时任务），还是需要 GUI（设置卡片/侧栏徽标）。
  • 生成脚手架：package.json、tsconfig.json、cordis.patch.yml，默认使用 TypeScript。
  • 装配 Host 半区：事件监听、工具、命令、settings namespace，并规避事件模型与生命周期泄漏等高频错误。
  • 装配 Client 半区：通过 settings RPC 桥接把 Host 配置暴露到 Web 设置页，并复用宿主视觉规范。
  • 测试与发布：TDD seam 划分、构建产物校验、pnpm pack + tgz 安装、CHANGELOG 演进。
  • GUI 交互分区：settings 卡片、会话视图 tab、工具行、侧栏等 slot 选型（reference/SLOTS.md）。
  • 确定性自检：i18n 键对齐、Host ESM 范式、干净 checkout 测试命令三套脚本（scripts/）。
  • 收录：发布后进 awesome-dsh-plugin 的门槛与 PR 流程，含 dshmarket 卡片截图自助声明（见 reference/AWESOME_LISTING.md）。

快速开始

  1. 把本仓库放到 Agent 可识别的 skills 目录（例如 ~/.agents/skills/dsh-plugin-creator）。
  2. 在对话中要求「创建一个 DSH 插件 / 给插件加设置页 / 排查插件问题」，Agent 会加载 SKILL.md。
  3. 按工作流逐条推进：范围 -> 脚手架 -> 纯逻辑层 -> Host 装配 ->（可选）GUI -> 安装验证 -> code review -> CHANGELOG。

目录结构

dsh-plugin-creator/
├── SKILL.md                      # 主流程与必查清单
├── templates/                   # package.json / tsconfig.json / cordis.patch.yml / client.js 骨架
├── scripts/                     # 确定性自检脚本：check-i18n / check-esm / check-checkout
├── examples/minimal-plugin/     # 最小可运行插件示例（Host + settings RPC + Client 卡片）
└── reference/                   # 各专题深度参考
    ├── BUILD_CONVENTIONS.md     # 语言与构建约定：TS 默认、Host ESM 范式
    ├── I18N.md                  # 国际化：locale 服务接入、README 双语、实现要点
    ├── SLOTS.md                 # Client 可注入 slot 清单（GUI 交互分区）
    ├── EVENT_MODEL.md           # DSH agent 事件模型：全局 vs per-agent、effect 生命周期
    ├── CLIENT_BUNDLE.md         # client bundle 格式、settings RPC 桥接、GUI 排版规范
    ├── UI_COMPONENTS.md         # 官方 client UI 组件目录（种子包、primitives 清单）
    ├── RELEASE_WORKFLOW.md      # pnpm pack + tgz 安装、CHANGELOG 模板
    ├── TDD_SEAMS.md             # 插件的 TDD seam 划分方式
    ├── LLM_SEMANTIC_LAYER.md    # 插件内嵌 LLM 语义判定（初筛->prompt->子代理->解析）
    └── AWESOME_LISTING.md       # 发布后收录：主渠道 + 社区 awesome 列表

语言与构建约定

  • 新插件代码首选 TypeScript：源码放在 src/，通过 tsc 输出 lib/，DSH 运行时加载编译后的 lib/*.js。
  • 只有明确要求使用 JavaScript 时，才改用 templates/client.js.template 等 JS 模板。

国际化（i18n）约定

  • 默认只做中英双语（zh-CN + en），MVP 之后在迭代中作为 P1 TODO 完成。
  • GUI 文案语言读 Host locale 服务（ctx.get('locale') → register/bind/subscribe，跟随 locale.preference），不是 navigator.language（浏览器语言不跟随 DSH Web UI 切换）；locale 不可用时兜底浏览器检测。
  • 零配置，不做手动设置项。响应切换用 React.useSyncExternalStore 订阅。
  • README 分文件双语（强制）：README.md（英文）+ README.zh.md（中文）两份独立文档，顶部语言切换行互指，禁止单文件混排（发布自检项，细则见 reference/I18N.md）。
  • Client bundle 内置 zh/en 文案表（I18N = { zh: {...}, en: {...} }），JSX 不散落中文字符串；标点/分隔符也 i18n 化。

适用对象

面向 DSH cordis 插件开发者，尤其是需要 Web UI 设置卡片的插件。使用前建议先阅读 SKILL.md，并在需要细节时跳转 reference/ 对应专题。

许可证

MIT