如何让你的DSH插件被dsh-ads免费广告:GitHub dsh-plugin Topic加标签与投稿PR全流程

原创2026-11-01 12:38:15945 阅读

如何让你的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 横幅——标题、副标题、闪烁角标、安装按钮全部自动排版,点击广告直达该插件仓库。

dsh-ads 中文模式实机:两侧广告栏与对话内插件推荐广告

进入轮播的三个硬性条件(见 src/catalog.ts):

  • 仓库公开,且带 dsh-plugin topic;
  • 最近 14 天内有推送(默认 14 天,可用 freshDays 调整);
  • fork 和已归档仓库不参与。

横幅配色和文案模板由仓库名的稳定哈希决定,同一个插件每次看起来都一样,「那个紫色的」一眼就能认出来。切到英文模式后,整套广告换成假杀毒、假游戏风格,「SPONSORED PLUGIN」横幅更加离谱:

dsh-ads 英文模式实机:SPONSORED PLUGIN 社区插件推荐横幅与假杀毒弹窗

第一步:加 dsh-plugin topic,零成本进轮播

这一步是「最小可行广告」,不用发 PR,不用出图:

  1. 在插件仓库的 About → Topics 里添加 dsh-plugin,或直接在终端执行 gh repo edit --add-topic dsh-plugin;
  2. 加完标签后推一次更新(任意 commit 即可),让仓库进入「最近两周有更新」窗口;
  3. 完成。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 一起提交,否则广告不会生效。

审核标准很简单,就两点:图不违反上面那条底线、图能正常显示。文案多离谱都行 🎯

为什么我的插件没上横幅?

按顺序排查:

  1. 仓库是否公开、是否真的加上了 dsh-plugin topic?
  2. 最近 14 天内有没有推送?没有的话推个空 commit 就能复活;
  3. 是不是 fork 或已归档仓库?这两类不参与搜索;
  4. 至少等 30 分钟——搜索结果有缓存窗口。

另外不用担心仓库改名或从组织转到个人账号:dsh-ads 只看 topic 和更新状态,不看归属。

dsh-ads 英文模式假弹窗:标题党风格的恶搞广告美术

关键文件一览

文件 作用
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 插件生态里成本最低的免费曝光渠道。

登录后查看全文
dsh-ads