如何让你的DSH插件被dsh-ads免费广告:GitHub dsh-plugin Topic加标签与投稿PR全流程
如何让你的DSH插件被dsh-ads免费广告:GitHub dsh-plugin Topic加标签与投稿PR全流程
dsh-ads 是一款面向 DSH(DeepSeek Harness)Web UI 的免费恶搞广告插件,会把界面变成 2005 年互联网门户。它还有一个「社区广告位」:任何带 dsh-plugin topic 的公开插件都会自动进入它的广告轮播。这篇文章带你走完全流程:加 topic 标签,再发 PR 定制自己的广告文案。
dsh-ads 的免费广告位长什么样?
dsh-ads 装进 DSH 的 web profile 后,界面会被页游横幅、假弹窗和「鲸鱼量化」广告全面接管。其中「赞助插件」广告位是真的:插件会定期搜索 GitHub 的 dsh-plugin topic,把命中的插件自动画成一张 2005 风格 SVG 横幅——标题、副标题、闪烁角标、安装按钮全部自动排版,点击广告直达该插件仓库。
进入轮播的三个硬性条件(见 src/catalog.ts):
- 仓库公开,且带
dsh-plugintopic; - 最近 14 天内有推送(默认 14 天,可用
freshDays调整); - fork 和已归档仓库不参与。
横幅配色和文案模板由仓库名的稳定哈希决定,同一个插件每次看起来都一样,「那个紫色的」一眼就能认出来。切到英文模式后,整套广告换成假杀毒、假游戏风格,「SPONSORED PLUGIN」横幅更加离谱:
第一步:加 dsh-plugin topic,零成本进轮播
这一步是「最小可行广告」,不用发 PR,不用出图:
- 在插件仓库的 About → Topics 里添加
dsh-plugin,或直接在终端执行gh repo edit --add-topic dsh-plugin; - 加完标签后推一次更新(任意 commit 即可),让仓库进入「最近两周有更新」窗口;
- 完成。30 分钟的缓存窗口一过,dsh-ads 的下次搜索就会收录你并自动画出横幅。
自动横幅的副标题取自你仓库的一句话简介,所以把 description 写好,等于免费写好了广告语 ✅
第二步:发 PR 定制广告文案(推荐)
自动排版不够满意?dsh-ads 仓库内置了投稿目录 contrib/,说明见 contrib/README.md。最常见的投稿是「只改文案」:先克隆仓库,在 contrib/ 下加一个 <你的插件名>.json:
git clone https://gitcode.com/gh_mirrors/ds/dsh-ads
cd dsh-ads
{
"repo": "your-name/your-plugin",
"headline": "你的插件一句话卖点",
"sub": "别让人去翻 README",
"badge": "今日热门",
"button": "立即安装",
"palette": 2
}
repo 必填(owner/name 形式),其余字段都可省,缺省的回退到自动生成:
| 字段 | 必填 | 说明 |
|---|---|---|
repo |
是 | 仓库标识,如 Nagi-ovo/dsh-visualize |
headline |
否 | 横幅主标题 |
sub |
否 | 副标题,替代仓库简介 |
badge |
否 | 左上角闪烁角标 |
button |
否 | 按钮文案 |
palette |
否 | 配色 0–5,超出范围自动回绕 |
image |
否 | 自定义图片文件名,见下文 |
真实参考可看 contrib/dsh-visualize.json——作者用自己的同款插件霸占了广告位。
想自己出图?
把图片放在 contrib/ 下、与 JSON 同名,再用 image 字段声明即可。三条底线:
- 格式
.webp/.png/.gif(动图也能动),尺寸二选一:横幅约 720×112 或 竖版约 300×480; - 单张 200 KB 以内——素材会 base64 内联进前端包,太大所有人都要跟着下载;
- 图里不要出现真实人物和真实品牌,具体域名请打码:这是个玩梗插件,别让它看起来像真有这么个服务。
第三步:重新生成素材,再提交 PR
contrib/ 目录不会被前端直接读取。改完文件后执行:
pnpm run assets
scripts/build-contrib.mjs 会校验每条 JSON、内联图片,并重写 src/client/contrib-ads.generated.ts。这个生成文件必须和 JSON 一起提交,否则广告不会生效。
审核标准很简单,就两点:图不违反上面那条底线、图能正常显示。文案多离谱都行 🎯
为什么我的插件没上横幅?
按顺序排查:
- 仓库是否公开、是否真的加上了
dsh-plugintopic? - 最近 14 天内有没有推送?没有的话推个空 commit 就能复活;
- 是不是 fork 或已归档仓库?这两类不参与搜索;
- 至少等 30 分钟——搜索结果有缓存窗口。
另外不用担心仓库改名或从组织转到个人账号:dsh-ads 只看 topic 和更新状态,不看归属。
关键文件一览
| 文件 | 作用 |
|---|---|
| contrib/README.md | 投稿说明 |
| contrib/dsh-visualize.json | 投稿样例 |
| scripts/build-contrib.mjs | 素材生成脚本 |
| src/catalog.ts | dsh-plugin topic 搜索逻辑 |
| src/client/contrib-ads.generated.ts | 生成结果(需随 PR 提交) |
加个 topic 就有免费广告,加个 JSON 就有定制横幅——这可能是 DSH 插件生态里成本最低的免费曝光渠道。


