前言¶
用 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。
