前言¶

在 DeepSeek Harness（DSH）里長時間調試智能體、跑插件或盯終端輸出時，切到瀏覽器另開標籤找小遊戲，往往會打斷當前工作區上下文。常見做法是書籤裏堆一堆 H5 遊戲鏈接，或在本地再裝一套娛樂應用——和「Harness 裏一切皆插件」的用法並不一致。

GameHub Arcade（倉庫 bihong2026/dsh-arcade）把遊戲中心掛進 DSH Web 側邊欄：安裝後多一個遊戲入口，在沙箱 iframe 裏打開經收錄管線驗證過的開源網頁遊戲，無需爲每款遊戲單獨裝依賴。下面介紹它是什麼、能做什麼，以及如何安裝與日常使用。

這是什麼¶

GameHub Arcade 是面向 DeepSeek Harness 的 Web 側欄插件，由維護者 bihong2026 發佈，倉庫採用 MIT 許可證（npm 包名 @gamehub/dsh-arcade）。

插件本身較薄：負責在側邊欄註冊標籤並用沙箱 iframe 嵌入同一套靜態遊戲站點；遊戲列表、搜索與分類 UI 在 site/ 目錄中，與可獨立部署的遊戲網站共用一份 site/data/games.json 目錄。SkillHub 等社區目錄將其歸類爲「趣味換裝」等標籤時，以目錄頁展示爲準；功能上它是小遊戲 / 街機合集，不是 DSH 或 DeepSeek 官方應用。

當前 README 寫明：94 款遊戲已逐個實測可嵌入、可運行（如貪喫蛇、2048、俄羅斯方塊、喫豆人、掃雷、圍棋、Hextris 等），來源爲開源社區（MIT 等）；路線圖目標是持續擴充 toward 1000+。線上全量自託管示例如：https://122.51.206.118/（94 款，不依賴代碼託管平臺拉取遊戲資源）。

核心功能¶

側邊欄遊戲中心¶

安裝並重啓 DSH Web 後，側邊欄會出現 遊戲 標籤（README 中爲「🎮 遊戲」）。點開即進入完整遊戲中心：瀏覽、搜索、按分類篩選、收藏、隨機選款，並在播放器中全屏或緊湊模式遊玩。

即點即玩與沙箱¶

遊戲在沙箱 iframe 中運行，不授予 same-origin，按 README 說明遊戲邏輯無法訪問 DSH 會話數據。玩家側不需要爲插件或單款遊戲安裝 Node、Python 等本地運行時。

目錄與分類¶

唯一數據源是 site/data/games.json。站點與插件只讀該 JSON；新增遊戲在數據層追加條目即可，無需爲每款遊戲改插件發版。README 列出約 10 大分類（如棋盤、街機、益智、3D 等），並支持明暗主題（跟隨系統）。

收錄與校驗¶

scripts/ingest.py 會從上游 registry 拉取候選遊戲，檢查 X-Frame-Options / CSP frame-ancestors 等是否允許 iframe 嵌入；不可嵌入的不會寫入目錄。收錄標準還包括：無強制廣告/跳轉、開源或已授權、內容健康。每條記錄可帶 source_repo、license 便於溯源；第三方遊戲版權歸上游作者。

可選：獨立網站¶

同一 site/ 可單獨靜態託管（nginx、GitHub Pages、Cloudflare Pages 等），與 DSH 插件共享目錄與流量邏輯；插件只是把該站點嵌進側邊欄。

安裝與啓用¶

在 DSH 終端執行安裝時，將 <profile> 換成你的 profile 名（示例爲 web）。以下命令均來自倉庫 README。

方式 A — 本地目錄（README 推薦）

先從 GitHub 或 Gitee 取得含 package.json 的源碼目錄，再指向該目錄安裝：

# GitHub
git clone https://github.com/bihong2026/dsh-arcade.git
# 或 Gitee（國內更快）
git clone https://gitee.com/bihong2023/dsh-arcade.git

dsh plugin --profile web add ./dsh-arcade

方式 B — 從 Git 倉庫安裝

dsh plugin add 會把參數交給 pnpm，僅接受 pnpm 認識的源格式：

# GitHub（簡寫）
dsh plugin --profile web add "github:bihong2026/dsh-arcade#v0.1.2"

# Gitee（完整 git URL）
dsh plugin --profile web add "git+https://gitee.com/bihong2023/dsh-arcade.git#v0.1.2"

# 跟蹤 main 分支
dsh plugin --profile web add "github:bihong2026/dsh-arcade#main"
dsh plugin --profile web add "git+https://gitee.com/bihong2023/dsh-arcade.git#main"

若從 Git 源安裝且 pnpm 10+ 提示 Ignored build scripts，可按提示執行 pnpm approve-builds；倉庫已提交 lib/ 構建產物，也可優先用方式 A 或方式 C 跳過構建。

方式 C — tarball（適合離線）

dsh plugin add ./dsh-arcade-0.1.2.tgz

安裝完成後重啓 dsh web 並刷新頁面，側邊欄應出現遊戲標籤。

典型用法¶

在 Harness 裏玩遊戲¶

1、完成上述任一安裝方式並重啓 Web 界面。
2、打開側邊欄 遊戲 標籤。
3、用搜索或分類找到遊戲，點擊進入；在 iframe 播放器中操作即可。

本地預覽獨立站點¶

不經過 DSH 也可先看同一套 UI 與目錄：

python3 -m http.server 8080 --directory site

瀏覽器訪問對應端口即可預覽 site/。

手動追加一款遊戲（維護者 / 貢獻者）¶

在 site/data/games.json 的 games 數組中追加條目，例如：

{
  "id": "manual:my-game",
  "slug": "my-game",
  "name": "我的遊戲",
  "category": "puzzle",
  "tags": ["classic"],
  "description": "一句話介紹",
  "tech": "html5",
  "embed": "https://<game-url>",
  "embed_ok": true,
  "source_repo": "https://github.com/...",
  "license": "MIT"
}

批量重建目錄並校驗可嵌入性：

python3 scripts/ingest.py

可選：鏡像全部遊戲靜態文件¶

若希望自建環境不依賴外網遊戲 URL：

python3 scripts/mirror2.py /path/to/mirror

適用場景與注意¶

適合誰： 已在用 DSH Web、希望在同一工作區短暫放鬆而不離開 Harness 的開發者；也需要在團隊內網部署靜態遊戲站、並與 DSH 共用同一份 games.json 的場景。

權限與安全： 插件隨當前 DSH 進程與用戶環境運行；安裝前建議閱讀倉庫源碼、cordis.patch.yml 與 MIT 許可證，並理解 iframe 仍會從 embed URL 加載第三方頁面——只安裝你信任的來源。

版權： 倉庫代碼 MIT；收錄的每款遊戲遵循 games.json 中的 license 與上游倉庫政策，勿將合集誤當作統一版權轉讓。

生態說明： DSH 社區插件目錄（如 SkillHub）與 DeepSeek / 幻方無官方從屬關係；發現、安裝、審閱源碼仍應以 GitHub 倉庫與維護者說明爲準。

鏈接與延伸¶

• 社區目錄頁：https://www.skillhub.cn/plugins/bihong2026/dsh-arcade
• 源碼與完整說明：https://github.com/bihong2026/dsh-arcade
• Gitee 鏡像：https://gitee.com/bihong2023/dsh-arcade

路線圖（README）中已完成側邊欄、收錄管線、94 款自託管鏡像等；進行中包括擴充遊戲數量、排行榜、中英文元數據、DSH 主題 token 適配等。若你維護失效鏈接或新遊戲 PR，貢獻指南建議先跑 python3 scripts/ingest.py 確認通過可嵌入性校驗。