前言¶
用 DeepSeek Harness 跑智能体时，长时间盯着日志和聊天窗口是常态。有人会在另一个标签页开小窗消遣，也有人会保持 DSH 界面常驻，但不想在输入框里误触快捷键。把轻量游戏做进侧栏面板、并且能完全离线运行，是社区里一类常见做法；dsh-shooter（目录名「枪战精英」）走的就是这条路径：Canvas 自绘竞技场、波次与局内强化，还带有「大肥鱼」观战托管与可选桌宠解说，同一进程里即可完成安装与游玩。
这是什么¶
dsh-shooter 是由 huangxn29 维护的 DSH 插件（npm 包名 dsh-shooter，当前版本 1.2.0，MIT 许可）。它在 Harness 左侧栏以准星图标出现，打开后占满一块 Web 侧栏面板，运行俯视角波次制射击：清怪、保血条、冲分，直到本局结束再重开。
面板外壳（标题栏、按钮、遮罩）使用 Harness 主题 token，随亮/暗主题变化；战场区域保持自带的深色配色。文案走 harness 客户端语言服务，支持英文与简体中文。游戏本体不发外网请求；进度、排行榜、成就、皮肤等仅存浏览器 localStorage。
社区目录 SkillHub 将其归为「趣味换装」类；仓库 huangxn29/dsh-shooter 在撰写时 GitHub 星标为 1。
核心功能¶
下面按 README 已说明的能力分组介绍，便于对照是否满足你的使用方式。
战斗与波次¶
- 每一波敌人数量递增，清场后进入下一波；每第 5 波追加 Boss（冲锋、环形弹幕、顶栏血条，击杀必掉两个血包）。
- 除普通小兵外，还有冲锋波（一侧压上的疾行者队列）、会换边包抄的枪手，以及小兵、疾行者、重装、枪手四类常态敌人。
- 3 秒内连续击杀触发连杀倍率：第 3 个起 ×2，第 6 个起 ×3，停手 3 秒回到 ×1。
- 每清掉偶数波暂停并弹出三选一强化（伤害、射速、双管、穿透、移速、冲刺冷却、连杀窗口、血包磁力、护盾、生命上限等）；点卡片或按
1/2/3，选择叠层显示在左下角。 Shift短距冲刺带短暂无敌；击败敌人有小概率掉落血包。
观战模式与桌面小鱼¶
开始界面提供「让大肥鱼玩（观战）」与「自己玩」。观战时 AI 托管移动、开火、躲弹、吃血，阵亡约两秒后自动开新局；玩家精灵变为持枪的圆蓝鱼「大肥鱼」，顶栏可随时收回控制权。
托管期间键鼠战斗输入被忽略，点击鱼身可「摸鱼」：连摸三次触发 5 秒射速 +25% 的 cheer buff。播放速度可在 0.25× / 0.5× / 1× / 2× 间切换，AI 档位为菜鸟 / 正常 / 宗师；「安静摸鱼」会降低音量与 HUD 刺激，1× 观战时会自动降到 0.5×。
切到其他面板时，对局可缩为右下角小鱼挂件或 300×236 可拖小窗继续运行；支持大屏观战、暂停/退出本局（不影响最高分与档案）。固定 1/60 s 步长，避免高刷新率双倍速。
可选：dsh-pet 解说¶
若本机已安装并启用 dsh-pet，观战会把战报 POST 到本机 Harness 端点（如 /dsh-pet-7340/broadcast?pet=main&surface=any），并可经 /dsh-pet-7340/voice/speak 合成语音在页面播放。未装桌宠或 id 不匹配时消息静默跳过，不阻塞游戏。宠物 id 默认 main，可在 client.js 的 PET_BROADCAST_URL 中修改。
本机档案：排行榜、成就、皮肤¶
数据不上传、不建账号：
| 存储键 | 作用 |
|---|---|
dsh-shooter:leaderboard |
本机前五局（分数、波次、日期） |
dsh-shooter:achievements |
八项成就（首杀、波次、单局分数、五连杀、观战、累计局数等） |
dsh-shooter:skin |
五款大肥鱼外观（含波次/分数/连杀解锁条件） |
dsh-shooter:best / dsh-shooter:runs 等 |
最高分、局数、静音、速度/AI 档位、摸鱼统计等 |
开始界面用标签页切换排行榜 / 成就 / 皮肤，避免侧栏过长。
操作一览¶
仅在射击面板处于前台时，下列输入才会进游戏（聊天打字不会误动角色）：
| 输入 | 动作 |
|---|---|
W A S D |
移动 |
| 鼠标 | 瞄准 |
| 按住左键 | 射击 |
Shift |
冲刺 |
1 2 3 |
选择强化卡 |
Esc |
暂停/继续，或退出大屏 |
安装与启用¶
环境要求（摘自 README 与 package.json）：DeepSeek Harness 0.2.0 及以上 Web 客户端（开发与测试标注为 0.2.2-rc.1，桌面版与 dsh web 均可）；插件为纯 ES 模块，无额外依赖与构建步骤。package.json 中 engines 还要求 Node >=22.19.0 || >=24.0.0（主要供维护者跑离线仿真脚本）。
社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；安装前请自行审阅源码与 MIT 许可证。插件随当前 DSH 进程权限运行，与本机其他插件相同。
方式一：插件市场¶
已安装 dshmarket，或在 Harness「发现」页添加索引源 https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json 后，搜索 dsh-shooter / 枪战精英 一键安装，刷新页面即可。
方式二：命令行（推荐摘录）¶
桌面版与普通 dsh web 使用对应 profile：
# 桌面版
dsh plugin --profile desktop add dsh-shooter
# 普通 dsh web
dsh plugin --profile web add dsh-shooter
方式三：发布包直链（npm 不通时）¶
dsh plugin --profile desktop add https://github.com/huangxn29/dsh-shooter/releases/download/v1.2.0/dsh-shooter-1.2.0.tgz
经过上面的步骤，打开 设置 → 插件，启用 Shooter elite（中文界面为「枪战精英」），再刷新一次页面；左侧栏面板列表底部出现准星入口。
若看不到入口：确认当前 profile 下插件已启用并刷新；面板黑屏多见于 DSH 低于 0.2.0。无音效需先在页面内点击一次（浏览器手势策略）；桌宠语音依赖 Edge TTS 时需联网。
卸载示例：
dsh plugin --profile desktop remove dsh-shooter
或在插件页禁用/移除；除浏览器 localStorage 存档外，插件不在包目录外写文件。
典型用法¶
- 装妥并启用插件后，点侧栏准星，在开始界面选「让大肥鱼玩（观战）」——适合等 Agent 长跑任务时在角落挂小鱼或开小窗。
- 需要亲手操作时选「自己玩」，用
WASD+ 鼠标完成波次；偶数波停表选强化，争取冲高连杀与 Boss 波。 - 已装 dsh-pet 且宠物 id 为
main时，观战会自动推送解说；要改台词可编辑client.js中game.report.*键值。 - 开始界面底部调整播放速度与 AI 档位，「安静摸鱼」适合长时间后台观战；档案页查看本机排行并切换已解锁皮肤。
维护者在仓库内可用 Node 加载真实 client.js 做离线回归，例如：
npm run check
等同于依次执行语法检查与 sim-ai / sim-ui / sim-pet 等脚本（详见 README「Offline tests」）。
适用场景与注意¶
适合谁：已在用 DSH 做智能体开发或日常对话，希望在同一界面内放一块不联网的消遣面板；尤其是愿意用观战托管 + 桌宠解说「陪跑」长任务的用户。
注意：
- 进度绑定当前浏览器配置，换浏览器或清站点数据会从零开始。
- 解说与 TTS 只访问本机 Harness；游戏逻辑本身无出站网络，但语音合成失败时可能只有气泡、没有声音。
- 趣味插件不涉及 Agent 能力增强；安装前像对待任意第三方插件一样检查源码与许可。
结尾¶
dsh-shooter 把完整波次射击、观战 AI、本机排行/成就/皮肤，以及可选的 dsh-pet 解说收进 DSH 侧栏，且默认离线运行。若要浏览分类与简介，可打开社区目录页 https://www.skillhub.cn/plugins/huangxn29/dsh-shooter；安装细节、故障表与中文说明以 GitHub 为准：https://github.com/huangxn29/dsh-shooter。
