前言¶

在 DSH 里做智能体或桌面助手，常见做法是用户主动发截图、或每次切到聊天窗口提问。打游戏时手在键鼠上，很难维持这种节奏。社区仓库 bigk5780/dsh 中的 dsh-game-pet（npm 包名，目录页归类为「趣味换装」、简介「鲸鱼娘陪玩」）把重点放在「前台是否是游戏」：后台按间隔截屏、识图、出建议，由透明置顶小窗里的桌宠用气泡说出来，全程不需要点插件或反复丢图。

下面介绍它是什么、怎么装、怎么配，以及使用时要注意的限制。

这是什么¶

dsh-game-pet 由维护者 bigk5780 发布，MIT 许可证，当前 package 版本 0.1.0。定位是打游戏时的桌宠参谋：在你玩游戏时自动开口，不需要点任何东西，也不需要每次丢截图。

它在后台每隔若干秒检查前台窗口是否为游戏；若是，则按配置的节奏执行：

自动截屏（默认只截游戏窗口，可按需截整屏）
  → 第 1 步：识图，只抽取「哪款游戏 + 当前关键局势」，不做画面描述
  → 第 2 步：结合「这款游戏该怎么打」生成一句建议（内置活泼小鲸鱼娘口吻，不念屏幕）
  → 透明置顶小窗里的桌宠弹气泡显示

切走游戏或关闭总开关后，不再截屏、不再调模型。README 说明：识图与出话拆成两步，是为避免模型把界面逐项翻译给用户听，而不是给出打法建议。

形象方面复用 dsh-pet 同源的一批透明 .webm 动画；本插件在 assets/webm/ 自带约 4.4 MB 常用动画（素材取自 dsh-pet，许可为开源可用、禁止商用），dsh-pet 未安装时仍可显示桌宠。默认住在独立透明置顶小窗（可拖动，位置会记住）；也可改为只在网页里绘制。DSH 页面侧默认不再注册浮层 overlay，只保留设置页。

核心功能¶

窗口与交互¶

• 置顶小窗可盖在窗口化 / 无边框游戏之上；全屏独占模式下任何窗口都无法置顶（系统限制）。
• 仅桌宠身体区域可交互，其余透明区域点击穿透；按住桌宠拖动窗口，位置写入配置。
• 气泡停留约 14 秒；失败时用小字说明原因。

游戏检测与截图¶

• 通过白名单（进程名或窗口标题关键字）限定「哪些算游戏」；白名单为空时，任何前台窗口都可能触发（看视频、写文档也可能被当成目标）。
• 可配置检测频率、开场预热时间、多久说一句、最短间隔、单次超时、是否要求全屏、是否忽略最小化、截图是否复用等。

视觉与对话¶

• 识图与出话可走 DSH 会话模型、注册表里支持图像的模型、自定义「视觉模型 API」，或文档中的免 Key 匿名视觉兜底（有速率限制）。
• 设置页可单独配置 OpenAI 兼容或 Anthropic 风格的视觉接口；启用后识图与出话可共用同一 Key，出话失败会回落会话模型。
• 支持人设、上下文句数等；提供「立刻试一轮」、探测当前前台窗口、识图连通性测试等操作。

运行期 HTTP 接口（本机）¶

同一台机器、需应用会话凭证，例如：

完整列表见仓库 README。

安装与启用¶

安装命令以 README 为准（--profile 按你实际环境选 desktop 或 web）：

# --profile 填你实际在用的那个：桌面应用 → desktop；dsh web → web
dsh plugin --profile desktop add dsh-game-pet

装完后重启桌面应用（dsh web 用户重启 dsh web）才生效。插件自带组合补丁 dsh.bundle.patch，add 时会挂载插件并注册浏览器半侧，无需手改 profile 文件。

卸载：

dsh plugin --profile desktop remove dsh-game-pet

package.json 标明 Node >=22.12.0，与 DSH 0.2.0-rc.2 标记为 compatible。安装前建议自行查看仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，会周期性截屏并调用你配置的模型接口。

典型用法¶

首次配置¶

1. 打开 DSH 设置 → 桌宠参谋 → 视觉模型 API。
2. 填写接口地址与模型名。任意 OpenAI 兼容（或 Anthropic 风格）视觉服务均可，例如本地 Ollama：地址 http://127.0.0.1:11434/v1，模型 qwen2.5vl。
3. 需要鉴权时填写 API Key，点击 测一下通不通（会真发测试图）。
4. 若不填写，会退到免 Key 的匿名视觉模型兜底（有限速，README 建议自备接口）。

限制「只在打游戏时说话」¶

在设置页「哪些游戏算」中填写白名单，或在 cordis.patch.yml 的 config.games 中配置。进程名示例：EldenRing、GenshinImpact（带不带 .exe、大小写均可）；也可写窗口标题关键字。留空则前台几乎任何应用都可能触发。

配置落盘位置¶

推荐用 DSH 设置 → 桌宠参谋 图形化修改，写入 $DSH_HOME/dsh-game-pet.json，保存即生效（浮层形态与小窗位置变更需重启）。与 profile 里 cordis.patch.yml 的 config 叠加：patch 为默认，设置页覆盖在上。

出厂默认片段（节选）：

        enabled: true
        games: []
        checkIntervalMs: 5000
        warmupMs: 15000
        intervalSec: 45
        captureFullScreen: false
        overlay: window

intervalSec 控制多久说一句，也直接影响调用模型的频率与成本。

自定义视觉 API 示例¶

README 给出的 visionApi 结构示例（需替换为你自己的地址与 Key）：

"visionApi": {
  "enabled": true,
  "baseURL": "https://<你的工作空间>.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
  "model": "qwen3.8-flash",
  "apiKey": "sk-ws-...",
  "format": "openai",
  "maxTokens": 1024
}

填完后在设置页用「测一下通不通」验证；README 提醒勿把 deepseek-vision 这类依赖工具调用的包装填作识图模型，否则气泡可能出现工具调用标记类正文。

适用场景与注意¶

适合：希望在窗口化 / 无边框游戏中获得间歇性打法提示、又不想频繁切出游戏发图的 DSH 桌面用户；愿意自备或接受限速兜底的视觉 API。

注意：

• 截屏与模型调用发生在本机，API Key 存于 $DSH_HOME/dsh-game-pet.json（明文），设置页不回显明文。
• 白名单为空时非游戏场景也可能被打扰，应按需配置 games。
• 与 SkillHub 目录页 的「趣味换装」标签相比，README 强调的是游戏陪玩与视觉参谋能力；以仓库文档为准理解功能边界。
• 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本插件是社区维护的独立包 dsh-game-pet。

结尾¶

dsh-game-pet 把「认游戏 → 识局势 → 给建议」做成后台循环，并用置顶小窗桌宠承载输出，适合作为 DSH 桌面侧的轻量游戏搭子。安装使用 dsh plugin --profile desktop add dsh-game-pet，配置集中在 DSH 设置 → 桌宠参谋。

• 目录页：https://www.skillhub.cn/plugins/bigk5780/dsh
• 源码与文档：https://github.com/bigk5780/dsh