为 DSH Web 添加戏仿广告和复古门户视觉效果

<!-- BEGIN REVIEWED GUIDE SUPPLEMENT -->

2026-10-02 更新到 DSH Ads 0.1.2，适配 DSH 0.2.0-rc.2

本页安装目标更新为 @nagi-ovo/[email protected]，命令固定使用 DSH 0.2.0-rc.2。新版本声明兼容 0.2.0-rc.2；本站只做了固定版本的源码与发布包静态复核，没有安装或运行。

• 推理激励广告会在回答流式输出约 1.8 秒后冻结当前回答并隐藏后续输出和工具调用行，直到完成抽奖才一次性显示；模型在后台继续运行，需要关注工具执行时可在设置中关闭该广告位。
• 服务端会以子进程调用本机 gh（或读取 GITHUB_TOKEN/GH_TOKEN）搜索 GitHub 上的 dsh-plugin 仓库，并在用户点击“验证修复”时查询当前账号是否 Star 本仓库；不希望借用 GitHub 登录时应在无 gh 登录、无令牌的环境运行。
• 0.1.2 改名为 npm 包 @nagi-ovo/dsh-ads，旧 GitHub 提交安装的包名是 @dsh-external/dsh-ads，升级时应先移除旧插件行再安装新版本。

仍在使用 DSH 0.1.x： 仍使用 DSH 0.1.x 的用户也可直接安装 0.1.2（作者声明兼容 0.1.1-rc.2 起）；旧提交 3a2ba704bc38（0.1.0）依赖上游已移除的 dsh-client-runtime 和旧版链式 turnTail 插槽，只适合 DSH 0.1.5 及更早版本。

依据：固定证据 1 ↗（外部链接，在新标签页打开）、固定证据 2 ↗（外部链接，在新标签页打开）、固定证据 3 ↗（外部链接，在新标签页打开）。

<!-- END REVIEWED GUIDE SUPPLEMENT -->

dsh-ads 0.1.2 在 DSH Web 侧栏、对话轮次尾部、推理过程中和右下角插入虚构的戏仿广告、假杀毒弹窗、抽奖转盘与假游戏海报，并把 GitHub 上带 dsh-plugin topic 且近两周更新的公开插件做成推荐横幅；每个广告位可在 设置 → 广告（非官方）单独关闭。

如果你的目标是为 DSH Web 加入复古门户广告、小游戏和弹窗视觉效果，本教程会说明如何在 DeepSeek Harness（DSH）中准备、安装、配置、验证和回退 dsh-ads。本文锁定作者仓库提交 c24ca58a978b；已复核固定提交的原始资料，未进行运行实测。

对应插件：查看 dsh-ads 的功能、权限与兼容性说明。先确认它适合你的工作流，再执行安装。

先确认是否适合你

• 分类：界面交互
• 风险等级：medium
• 核验证据：source_reviewed
• 兼容性边界：唯一受 DSH 检查的 peer @deepseek-ai/dsh-client-locale 声明 ^0.1.0-rc.6 || ^0.2.0-rc.1，按 semver includePrerelease 判定满足 0.2.0-rc.2；README 声明兼容 DSH 0.1.1-rc.2 到 0.2.0-rc.2。52DSH 未运行实测；旧 0.1.0 的 peer ^0.1.0-rc.6 不满足 0.2.0-rc.2。
• 主要权限关注：注入 Web 客户端 conversation.input.dock、conversation.chat.turnTail 与 settings.section 插槽；服务端在 DSH Web 服务器注册两个无鉴权 JSON 路由，并以子进程调用本机 gh CLI（或读取 GITHUB_TOKEN/GH_TOKEN）查询 GitHub；不注册 Agent 工具，不读写工作区文件。

如果你准备在重要工作区使用，先阅读插件详情页的权限和数据流说明；“源码已审阅”或“资料已整理”都不等于安全认证。

安装前准备

本页 DSH 命令版本： 0.2.0-rc.2。0.1.2 声明的 DSH 版本范围包含 0.2.0-rc.2，本页固定 DSH 0.2.0-rc.2。仅静态复核，未在本站运行验证。

• 独立 web Profile：插件只在 Web 客户端生效，TUI、ACP 和 headless 下不显示广告层；建议先装到单独的 web Profile 试用。
• GitHub CLI 或令牌（可选）：服务端会优先调用本机 gh 搜索 dsh-plugin 插件并检查 Star；若不希望插件借用 gh 登录或 GITHUB_TOKEN/GH_TOKEN，请在未登录 gh、未设置这些变量的环境中运行，插件会退回匿名 API 或内置快照。

1. 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本，并确认 pnpm 可用。
2. 使用独立的 web Profile 和可丢弃测试工作区，不直接连接生产目录。
3. 备份当前 Profile 配置，并记录安装前的 --dump-config 输出。
4. 核对固定来源中的外部服务、账号、运行时和平台限制。
5. 需要凭据时只准备测试凭据；本页识别到的候选变量包括 GITHUB_TOKEN、GH_TOKEN。

安装 dsh-ads

52DSH 使用目录中记录的精确安装目标，避免直接跟随可能变化的默认分支：

npx --yes @deepseek-ai/[email protected] plugin --profile web add @nagi-ovo/[email protected]

GitHub 源码插件如果被 pnpm 拦截构建脚本，先检查终端提示的具体包和脚本。只在 web Profile 中放行确实需要的构建项，不要全局放行未知依赖。

插件专属配置

配置目标

• 设置 → 广告（非官方）：分别开关两侧广告栏、对话里的推荐、推理激励广告、右下角弹窗、跑分中心、安全中心、贪玩蓝鲸海报和音效；选择保存在浏览器 localStorage。
• $DSH_HOME/profiles/web/cordis.patch.yml：插件行 id: dsh-ads；源码支持在 config 中设置 freshDays（推荐位的更新天数窗口，默认 14）与 cacheMinutes（GitHub 搜索缓存分钟数，默认 30），README 未记载这两项。
• 设置 → 语言：切换中文或 English 后，当前页面立即更换整套广告素材与文案，无需刷新。

环境变量

• GITHUB_TOKEN（可选），敏感：gh 不可用时，服务端用它作为 Bearer 令牌搜索 dsh-plugin 仓库并检查当前账号是否 Star 本仓库；不设置则使用匿名 API。
• GH_TOKEN（可选），敏感：GITHUB_TOKEN 未设置时的备选令牌，用途同上。

固定版本安装与配置检查

证据：固定来源 ↗（外部链接，在新标签页打开）。将路径、账号和凭据占位符替换为测试值。

npx --yes @deepseek-ai/[email protected] plugin --profile web add @nagi-ovo/[email protected]
npx --yes @deepseek-ai/[email protected] --profile web --dump-config

$DSH_HOME/profiles/web/cordis.patch.yml（可选：调整推荐位窗口与缓存，源码默认值）

证据：固定来源 ↗（外部链接，在新标签页打开）。将路径、账号和凭据占位符替换为测试值。

- id: dsh-ads
  config:
    freshDays: 14
    cacheMinutes: 30

安装后设置

1. 如果 DSH Web 正在运行，重启后刷新浏览器页面。
2. 打开 设置 → 广告（非官方），关闭不想要的广告位；需要正常阅读回答时建议先关闭“推理激励广告”。
3. 确认是否允许插件借用本机 gh 登录或 GITHUB_TOKEN/GH_TOKEN 查询 GitHub；不允许时在未登录 gh、未设置令牌的环境启动 DSH。

配置验证与成功结果

先导出配置，再启动同一版本的 DSH Web：

npx --yes @deepseek-ai/[email protected] --profile web --dump-config
npx --yes @deepseek-ai/[email protected] web

1. 确认 web Profile 中出现 id 为 dsh-ads、name 为 @nagi-ovo/dsh-ads 的插件行。

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config
   

   期望结果：插件行存在且没有加载错误；只证明配置写入，不代表界面效果已验证。

2. 刷新 DSH Web，打开 设置 页面查找“广告（非官方）”分区。

   期望结果：分区内列出各广告位开关，侧栏或对话中开始出现戏仿广告。

3. 在测试会话连续进行几轮对话，观察对话推荐与推理激励广告。

   期望结果：每隔数轮出现对话内推荐；推理激励广告出现时后续输出暂时隐藏，完成后一次性显示，关闭该开关后不再出现。

第一次使用

• 在 设置 → 语言 切换到 English，观察广告素材和弹窗即时切换为英文戏仿风格。
• 点击对话里的插件推荐横幅，打开对应的真实 GitHub 插件仓库。
• 在 设置 → 广告（非官方）只保留贪玩蓝鲸海报，其余广告位全部关闭。

数据、权限与凭据

**数据流：*服务端：/dsh-ads/registry.json 依次用 gh api search/repositories、GITHUB_TOKEN/GH_TOKEN 或匿名 api.github.com 搜索 topic:dsh-plugin 公开仓库，结果在进程内缓存 30 分钟，失败时用内置快照；/dsh-ads/star-check.json 在用户点击“验证修复”后用 gh api user/starred/Nagi-ovo/dsh-ads 或令牌查询当前 GitHub 账号是否 Star 本仓库，仅返回 starred/absent/unavailable。浏览器：可能匿名请求 api.github.com 的 stargazers 列表比对用户输入的 GitHub ID；开关、轮播曝光记录和 ID 只存于 localStorage 的 dsh-ads: 键。

**权限关注：**注入 Web 客户端 conversation.input.dock、conversation.chat.turnTail 与 settings.section 插槽；服务端在 DSH Web 服务器注册两个无鉴权 JSON 路由，并以子进程调用本机 gh CLI（或读取 GITHUB_TOKEN/GH_TOKEN）查询 GitHub；不注册 Agent 工具，不读写工作区文件。

**数据存储：*开关、轮播曝光记录和在假安全中心输入的 GitHub ID 只保存在浏览器 localStorage 的 dsh-ads: 键中；服务端只在进程内存缓存 GitHub 搜索结果与 Star 结果，不写入磁盘；GitHub 查询经本机 gh、环境令牌或匿名 api.github.com 发出。

真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。

卸载、回退与清理

停止 DSH 后，从同一个 Profile 移除包：

npx --yes @deepseek-ai/[email protected] plugin --profile web remove @nagi-ovo/dsh-ads

1. 执行 npx --yes @deepseek-ai/[email protected] plugin --profile web remove @nagi-ovo/dsh-ads，再用 --dump-config 确认 dsh-ads 插件行已消失。
2. 重启 DSH Web 并刷新页面，确认广告层和“广告（非官方）”设置分区消失。
3. 在浏览器开发者工具中删除以 dsh-ads: 开头的 localStorage 键，清除开关、曝光记录和输入过的 GitHub ID。

常见问题

安装后看不到任何广告

确认使用的是 Web 客户端且已重启并刷新；用 --dump-config 检查插件行；广告层不在 TUI、ACP 或 headless 中显示。

回答和工具调用迟迟不显示

这是推理激励广告的设计：模型仍在后台运行，完成抽奖后一次性显示；可在 设置 → 广告（非官方）关闭“推理激励广告”。

推荐位只显示少量或旧插件

GitHub 匿名 API 有速率限制，失败时插件改用内置快照；登录 gh 或调大 cacheMinutes 可减少请求，freshDays 设为 0 则展示全部 topic 插件。

关闭开关后贪玩蓝鲸海报仍在

0.1.1 起已修复设置页开关无法移除已显示海报的问题（issue #14）；确认已升级到 0.1.2。

安装成功但页面或命令没有出现

先运行 --dump-config 确认 Bundle 已进入 web Profile，再重启 DSH Web 并硬刷新浏览器。不要通过反复扩大权限来解决加载问题。

插件运行后没有得到预期结果

把问题缩小到本页的最小验证任务，检查作者文档要求的变量、外部服务和平台限制。保存终端错误原文，并核对当前安装目标是否仍对应本页固定提交。

作者固定资料中未识别到独立故障章节。遇到插件特有错误时，应先停止 DSH、保留日志并回退插件。

固定来源证据

以下资料是本文配置结论的依据：

• README.md ↗（外部链接，在新标签页打开）
• contrib/README.md ↗（外部链接，在新标签页打开）

继续查看：返回 dsh-ads 插件详情页，重新核对兼容性、权限、同类插件和来源状态。