← 返回列表
需源码安装
单机游戏内 AI 同伴「小汤圆」｜DeepSeek Harness
暂不能直接安装（需源码编译或环境不满足）：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。 · 最近上游提交 2026/8/26 · 已提供中文文档
综合分
34.4
GitHub 分
34.4
用户评分
—
★ Stars
10
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add qimidandapigu/dsh-xiaotangyuan-game缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装，改用 GitHub 源安装
数据截至 2026/9/17（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查需源码安装
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包dsh-xiaotangyuan-game-workspace（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明
缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/18 05:20:51
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
dsh-xiaotangyuan-game [!IMPORTANT] 本项目已停止独立维护。 源码、文档、后续版本和新功能已经合并到 AI Native Game Harness。本仓库仅作为历史快照，并继续保留既有 Release 下载；请勿在这里开始新的开发或提交功能改动。 小汤圆游戏 AI 的单仓库。DeepSeek Harness 插件承载通用 Agent、模型、多模态、语音、媒体和安装能力；每个游戏只保留必须调用游戏 API 的薄 Bridge，游戏知识与专属工具放进可选 Adapter。 玩家文字 / 麦克风 / 游戏窗口 ↓ DeepSeek Harness + 小汤圆插件 Agent、视觉、ASR、TTS、工具、安装器、媒体 Host ↓ protocol/v1 可选游戏 Adapter 游戏知识、专属工具、协议翻译与安装器 ↓ 本机桥协议 游戏 Bridge / Mod 读取状态、调用游戏 API、呈现回复 当前版本 | 组件 | 版本 | 状态与说明 | |---|---:|---| | Harness 插件 | 0.7.6 | 当前源码版本；隔离长期记忆、游玩统计、阶段总结、记忆管理、真实文字流和流式语音 | | 最新公开 Harness Release | 0.5.1 | 已发布稳定版，只包含此前的星露谷链路 | | 星露谷适配器 | 0.5.1 | SMAPI 薄桥接、存档隔离与小汤圆外观包 | | 饥荒联机版 Mod | 0.2.22 | Lua Mod、轻量 Python Adapter、游玩心跳与 Jingling 动画 | | 缺氧 Adapter | 0.1.4 | 可选 Harness 插件；游戏专属动作、知识与安装器不进入通用包 | | 缺氧 C# Bridge | 0.6.5 | 游戏观察、动作执行、文件桥与固定复制人跟随精灵 UI | | Content Patcher | 2.9.1 | 官方第三方资源加载组件 | | TrinketTinker | 1.9.0 | 官方第三方宠物跟随与渲染组件 | Harness 插件和游戏包独立发版，所以版本号不要求完全相同。仓库版本不等于已公开 Release；发布前不要把尚未存在的 Release URL 当成安装入口。 多模态能力路由 小汤圆依赖的是能力，不绑定某一家模型厂商： vision.observe 看当前游戏窗口 speech.transcribe 把玩家语音转成文字 speech.synthesize 把 Agent 回复合成为语音 游戏 Agent、视觉、ASR 和 TTS 可以由不同实现提供。插件通过能力注册表自动选择已经就绪的实现，也允许分别指定语音识别和语音合成 Provider；新增 Provider 不需要修改任何游戏 Adapter 或 Bridge。 云端凭据统一由 DeepSeek Harness 管理。小汤圆配置只保存 credentialRef 等凭据名称，在每次调用开始时向 DSH 解析，不在插件配置、游戏目录或协议消息中保存真实 Key。视觉模型必须在 DSH 中声明支持图片输入；当前内置语音实现仍是火山引擎，但能力接口本身不依赖火山、智谱或其他特定厂商。 快速开始 公开稳定版目前使用： dsh plugin --profile web add "https://github.com/qimidandapigu/dsh-xiaotangyuan-game/releases/download/plugin-v0.5.1/qimidandapigu-dsh-xiaotangyuan-game-0.5.1.tgz" 上面的公开稳定版可以使用星露谷安装指令： 小汤圆，帮我检测并安装星露谷物语的 AI MOD 当前 0.7.6 开发版需要从本仓库构建并安装生成的 .tgz；完成对应 Release 后再切换为公开下载地址。安装 0.6.1 或更新版本后才可以使用饥荒安装指令： 检测并安装《饥荒联机版》的小汤圆 AI Mod 安装或升级插件后，都要重启 DeepSeek Harness、刷新页面并新建对话。 缺氧还需要独立安装 ONI Adapter，然后可直接让 Harness 安装 C# Bridge： dsh plugin --profile web add "https://github.com/qimidandapigu/dsh-xiaotangyuan-game/releases/download/oni-v0.6.1/qimidandapigu-oni-adapter-0.1.3.tgz" 检测并安装《缺氧》的 AI 精灵 Mod 星露谷安装完成后通过 SMAPI 启动游戏；饥荒安装完成后，把 Harness 返回的一行内容复制到 Steam 启动选项，再从 Steam 启动游戏。 进入存档后： - 星露谷按 T 输入文字并发送给小汤圆。 - 支持的游戏保持前台时，按住配置的 Push-to-Talk 键录音，松开后进行 ASR、单次多模态 Agent 回复和 TTS 播放。 - 饥荒按 Shift+V 可重新生成上一条回答。 通用源码默认键是 F8（Virtual-Key 119）。当前版本每个 Harness profile 只有一个全局语音键；可将 media.pushToTalkVirtualKey 设为 81 使用 Q，或设为 86 使用 V。按前台游戏自动切换 Q/V 尚未实现，文档不会把它描述成现有能力。 完整前置条件、凭据配置和升级说明见安装指南。 仓库目录 apps/ harness-plugin/ DeepSeek Harness 插件 src/gateway/ 游戏连接与请求路由 src/runtime/ Agent、多模态、语音、媒体能力 src/installation/ 游戏检测、下载、校验、安装与备份 src/tools/ 暴露给模型的安装工具 test/ 插件测试 windows-media-host/ Windows 麦克风与音频播放 Host feedback-receiver/ 官方 Harness 签名校验与私有 GitHub Issue 接收端 protocol/ v1/ 与语言无关的 JSON-RPC 协议 games/ stardew-valley/ adapter/ 轻量 SMAPI AI 桥接 content-pack/ 小汤圆外观与 TrinketTinker 配置 dont-starve-together/ 饥荒 Lua Mod、Python Adapter、Jingling 动画与构建脚本 oxygen-not-included/ adapter/ 可选 ONI Harness Adapter bridge/ 缺氧 C# 游戏桥接 distribution/ stardew-valley-v2.json 星露谷固定来源与校验值 dont-starve-together-v1.json 饥荒安装包固定来源与校验值 oxygen-not-included-v1.json 缺氧安装包固定来源与校验值 docs/ 中文安装、排错、架构与开发文档 tools/ 跨游戏小汤圆素材生成工具 星露谷、饥荒和缺氧源码都在本仓库统一维护；游戏发布包仍与 Harness 插件独立发版。以后新增游戏不重复开发模型调用、语音、记忆或媒体基础设施；只有真正依赖游戏 API 的知识和动作进入可选 Adapter。 文档 - 安装与升级 - 常见问题与排错 - 架构和职责边界 - 结构化状态与记忆隔离设计 - 开发与发布 - 更新记录 - 星露谷适配器 - 饥荒联机版 Mod 与 Adapter - 缺氧 Adapter 与 Bridge - 自动反馈接收端 - Harness 插件配置 - 游戏协议 v1 安装与安全原则 - 插件包和游戏包分开发布；游戏专属适配器不塞进通用 Harness 插件。 - 第一方星露谷包只包含 StardewAgentMod 和 XiaoTangYuanCompanion。 - Content Patcher 与 TrinketTinker 从各自官方来源下载，不重新打包进本仓库 Release。 - 下载前校验来源、版本、文件大小和 SHA-256。 - 覆盖升级使用事务安装；失败时恢复旧版本。 - 备份保存在游戏根目录 .xiaotangyuan-backups，绝不放进 Mods。 - Provider 密钥由 DSH 凭据管理器保存；插件只保存凭据名称，不保存 Key 内容。 - 玩家反馈只接受官方 Harness 的 HMAC 签名；模型和玩家都不接触 GitHub Token。 开发命令 pnpm install pnpm check pnpm check:dst pnpm build:stardew pnpm build:dst pnpm build:media pnpm pack:plugin 更多构建、测试和发版约束见开发与发布。 许可证 MIT。第三方组件遵循各自许可证，本仓库不改变或重新授权它们。
扫码进群