前言¶

在 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 确认通过可嵌入性校验。