本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-ads

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:Nagi-ovo/dsh-ads

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

常见问题

安装后必须重启 DSH 才能看到广告吗?

是的。README 明确说"如果 dsh web 正在运行,重启后刷新页面";装完不重启,设置面板里看不到"广告(非官方)"入口,广告层也不会挂载。

安装之后这些广告能不能逐个关掉?

能。装好后会在 DSH 设置面板多出一个"广告(非官方)"标签页,里面每种广告位都有独立开关,包括侧栏横幅、对话推荐、推理转盘、右下弹窗、跑分中心、假杀毒、贪玩蓝鲸海报和提示音,选择会写进本机浏览器存储,下次启动依然生效。

想立刻全部关掉、不改上面那些开关怎么办?

设置页底部有一个"立刻关闭所有广告(刷新后恢复)"按钮,它只在本次会话生效,不会被持久化,刷新页面后按上面的开关恢复——这是插件有意为之,避免一次误点把长期设置清空。

对话里那种能点进真实仓库的"插件推荐"是怎么挑出来的?

节点端通过宿主注册的 HTTP 路由发现:优先用本机的 gh CLI,再用 GITHUB_TOKEN/GH_TOKEN,最后落到匿名 GitHub API;在 GitHub 上搜索 topic=dsh-plugin is:public archived:false 的仓库,过滤掉 archived/disabled/fork 和自己,然后按最近两周内有 push 的标准筛一遍。结果按"本机每个 slug 看到次数最少优先"分配,所以每个插件会先被轮过一遍才会重复。

推理中途那个"V4 Pro 转盘"是真的卡住模型了吗?

没有。模型一直在后台继续生成,只是把当前助手那一行的可视高度冻结、把后面所有未完成的行藏起来,转盘结束后一次性放出来。源码里它只是修改 maxHeight/overflow,并把 data-chat-flow-kind=assistant-step 之外的行 hide 掉,不会真的中断 session。

我装了以后,这个插件会往我机器上读文件或写文件吗?

不会。README 的免责声明和代码里都没有任何文件扫描或读写:节点端只调 gh CLI/匿名 API 查仓库;浏览器端的所有偏好(哪些广告位开着、海报拖到哪里)都只写到 localStorage 的 dsh-ads:* 键下,关闭浏览器数据就清空。

这个插件能卸载干净吗?

能。关掉所有开关只是让它什么都不显示,插件本身还在,设置页面会明说这一点。要彻底移除,按普通 DSH 插件卸载流程移除即可,localStorage 里的键如果想立刻清掉,可以在浏览器开发者工具里手动删 dsh-ads: 开头的项。

自己的插件也想被轮播到,需要做什么?

只要在 GitHub 仓库上加上 dsh-plugin topic、保持最近两周内有过 push 即可。如果对自动生成的图不满意,可以发 PR 在 contrib 目录下加一份 <插件名>.json,可选自定义 headline/sub/badge/palette,甚至附带 .webp/.png/.gif 替换整张图,跑 pnpm run assets 后生效。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+ (dsh.client.runtime/locale ^0.1.0-rc.6)
• Node: 未声明 (源码使用 Node 22+ 的 ESM,推荐与 DSH 一致)
• Platforms: 跨平台 (浏览器侧广告层), macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则