前言¶
在 DSH(DeepSeek Harness)里用 skill 插件约束模型产出时,文档、README、PR 或 MR 往往需要统一的署名方式,让读者知道内容是在哪套工具链下生成的。DeepSeek 官方已有 @deepseek-ai/dsh-skill-badge 一类 skill provider,用 Markdown 片段和资源图说明如何摆放徽章。若你主要用深鲸桌面(DeepWhale Desktop)写文档或走 PR/MR 流程,希望产出物带上与官方徽章格式一致、但标识为深鲸的署名,可以单独装一个只做这件事的插件,而不是手写每份文档里的图片链接和尺寸说明。
下面介绍社区插件 @deepwhale-cn/dsh-badge(仓库 feely0208/dsh-badge),它把徽章规则写进 skill,装好后由模型按说明自动或按需加徽章。
这是什么¶
@deepwhale-cn/dsh-badge 是 DSH 的 skill provider 插件,分类为工作流。维护者标识为 feely0208,包作者为温州深鲸智能科技有限公司;当前版本 0.1.1,许可证 MIT。
它解决的问题很具体:给用深鲸桌面产出的文档、PR、MR 等内容加上 「powered by dwh」 署名徽章。实现方式与官方 @deepseek-ai/dsh-skill-badge 对齐——正文说明在 assets/deepwhale-badge.md,静态资源在 assets/ 目录,会话里会出现名为 deepwhale-badge 的 skill,模型在生成内容时可按该 skill 的说明插入徽章。
目录页:https://www.skillhub.cn/plugins/feely0208/dsh-badge
核心功能¶
根据仓库 README 与 package.json,已核实的能力如下。
- Skill 内容:
assets/deepwhale-badge.md描述徽章用法,包括 Markdown 片段、尺寸、摆放规则和免责说明。 - 徽章图片:
assets/deepwhale-badge.png为 726×120 源图,展示时按 121×20(胶囊圆角、透明背景)。 - 默认行为:包描述写明面向文档/README/PR 的署名,并注明「默认自动署名」——具体触发条件以 skill 正文为准,安装后可在会话 skill 目录中查看
deepwhale-badge全文。 - 运行环境:要求 Node.js ≥ 18,DSH 版本
>=0.1.0-rc.6且<0.3.0;依赖@deepseek-ai/dsh-skill(peer)。
README 明确:徽章只表示「内容用深鲸桌面生成」,不代表 DeepSeek 官方或深鲸官方的背书。
安装与启用¶
安装前请自行查看 GitHub 源码与 LICENSE;插件以当前 DSH 进程权限运行,只安装你信任的包。
指定 profile 安装(命令来自 README):
dsh plugin --profile <你的 profile> add @deepwhale-cn/dsh-badge
也可以在组合配置里手动插入一行:
- insert:
- id: deepwhale-badge
name: '@deepwhale-cn/dsh-badge'
装好后,会话的 skill 目录里会出现 deepwhale-badge;后续模型产出文档或 PR 描述时,可依据该 skill 的说明加入徽章 Markdown 与图片引用。
典型用法¶
典型流程不依赖额外 CLI,而是 安装插件 → 在 DSH 会话中正常让模型写文档或 PR 正文 → 模型读取 deepwhale-badge skill。
- 按上一节完成
dsh plugin ... add @deepwhale-cn/dsh-badge。 - 在同 profile 下开启需要写 README、技术文档或 PR/MR 描述的会话。
- 若需确认规则,在会话 skill 目录打开
deepwhale-badge,对照assets/deepwhale-badge.md中的片段、尺寸(121×20)与摆放要求。
仓库未提供独立示例仓库或截图案例;复现方式即以 README 安装命令为准,并在本地检查 assets/deepwhale-badge.md 中的 Markdown 片段。
适用场景与注意¶
适合谁:已在用或计划用深鲸桌面生成文档、PR/MR,且希望署名样式与 DSH 官方 badge skill 同一套「provider + assets」模式,只需换成深鲸标识的团队或个人。
注意:
- 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系;安装来源以 npm 包名
@deepwhale-cn/dsh-badge与上述 GitHub 仓库为准。 - 安装前阅读源码与 MIT 许可;插件能力边界以 README 与 skill 正文为准,不要假设徽章会带来平台侧自动展示或审核通过。
- DSH 与 Node 版本需满足
package.json中的engines,否则可能在加载 patch 或 skill 时失败。
结尾¶
@deepwhale-cn/dsh-badge 把深鲸桌面的「powered by dwh」署名收成可安装的 DSH skill,与官方 dsh-skill-badge 同构,适合工作流里统一文档与 PR 的出处标识。需要细节时查目录页与仓库 README 即可。
- 目录页:https://www.skillhub.cn/plugins/feely0208/dsh-badge
- GitHub:https://github.com/feely0208/dsh-badge