插件发布向导 fgg01-code/dsh-plugin-publish

dsh-plugin-publish · DSH 技能

从零做一个 DeepSeek Harness（dsh）插件并发布：package.json 声明 → cordis.patch.yml 挂载 → Host/Web 双半侧 → profile 登记 → 打包分发。

这是 DeepSeek Harness 的一个技能。装进 ~/.agents/skills/ 后，当你写插件、改插件、或遇到「装了没反应 / 白屏 / pnpm 证书报错」时会自动加载。

它解决什么

做 dsh 插件最容易卡在四处，且都不报错、只是「没效果」：

1. dsh.bundle.patch 路径写错 → 插件静默不生效；
2. dsh.client.inject 里的 UI 插件名写错 → Web 半侧加载不到；
3. profile 只加了 dependencies 没加 dsh.profile.bundles → 装了不加载；
4. pnpm pack 的 files 白名单漏了 cordis.patch.yml → 用户装上就是「没反应」。

这个技能把四处都写成可核对项，而不是靠记忆。

覆盖内容

| 主题 | 要点 |
| 插件解剖 | 六类文件的职责：index.js（Host）、client.js（Web）、patch、icon、locale、assets |
| package.json | type: module、main、exports、dsh.bundle.patch、dsh.client、files 白名单、peerDependencies |
| cordis.patch.yml | 插件自带 - insert: 与 profile 侧 - id/name/config: 两种写法；cordis.yml 是空数组，不要改 |
| 安装 | 四种来源：npm、github:user/repo、Release 的 tgz URL、link:本地路径 |
| profile 登记 | dependencies + dsh.profile.bundles 两处必须同时改 |
| 打包发布 | 语法与乱码自检 → pnpm pack → 源码推 GitHub / tgz 挂 Release / 发 npm |
| 市场曝光 | dsh-plugin 关键词 + awesome-dsh-plugin 提 PR |
| 六个坑 | CA 证书、link 与 tgz 混淆、inject 写错、媒体体积、Windows 路径、不重启就下结论 |

安装

Windows
New-Item -ItemType Directory -Force "$env:USERPROFILE\.agents\skills\dsh-plugin-publish" | Out-Null
Copy-Item .\SKILL.md "$env:USERPROFILE\.agents\skills\dsh-plugin-publish\SKILL.md"

macOS / Linux
mkdir -p ~/.agents/skills/dsh-plugin-publish
cp SKILL.md ~/.agents/skills/dsh-plugin-publish/SKILL.md

装好后新开一次会话（或等技能目录刷新），即可在技能列表里看到 dsh-plugin-publish。

触发场景

- 要写一个新的 dsh 插件（主题、面板、启动动画、工具栏……）；
- 改现有插件，但改完看不到效果；
- dsh plugin add 之后重启仍不生效；
- pnpm pack / pnpm install 报 UNABLE_TO_VERIFY_LEAF_SIGNATURE；
- 插件包体积失控（媒体资源占了八成）；
- 想把插件发到 npm 或 GitHub Release。

依据

内容不是凭空写的，来自三个真实插件仓库与本机 profile 配置：

- cyber-red-ui（主题类插件：dsh.bundle + dsh.client.inject + 大量媒体资源）；
- dsh-startup-secret（启动动画：自述安装方式、patch 注释最完整）；
- dsh-market（市场插件：关键词与索引线索）；
- 本机 profiles/desktop/ 下的 cordis.yml、cordis.patch.yml、package.json、.npmrc（CA 证书）。

边界

- 不替代官方文档。插件 API 会随 dsh 版本演进，命令与字段以 dsh plugin --help、@deepseek-ai/cordis 的类型声明为准。
- dshmarket 的索引来源未经本机验证（包内无 registry 相关代码，推测走远端 API）——「发 GitHub 就自动上架」不可信，先发 npm 并带 dsh-plugin 关键词。
- 本机 dsh 命令不在 PATH，list / remove 等子命令写法未实测，文档里已标注「以 --help 为准」。

本技能由实际插件开发与发布过程整理而成，与 maoxuan-work-method、github-rest-publish 属同一套技能库。