lmong11/dsh-game-center

DSH Game Center

把可替换的 AI Agent 放进 DeepSeek Harness 里的真实牌桌。
模型、角色、策略、规则、房间与界面都保持为可替换的插件能力。

DeepSeek Harness ·
快速开始 ·
架构 ·
朋友房

DSH Game Center 是构建在 DeepSeek Harness 上的实验性游戏运行时与界面。德州扑克是第一个可玩的游戏：你可以坐进一张支持 2 至 8 个座位的牌桌，为每个 Agent 席位分别指定模型、角色或策略，并让 Harness 通过同一套合法行动边界驱动所有决策。

这是一个使用无现金价值比赛筹码的开源 Agent 游乐场，不是真钱德州扑克平台。

可以做什么

- 和真正的 Harness Agent 对战。 使用语言模型的席位会在轮到自己时调用选定的 DSH 模型，而不是重复硬编码的 NPC 脚本。
- 替换牌手，不必改写游戏。 同一张牌桌可以混用不同模型、已发布角色档案、结构化策略或受信任的 solver 适配器。
- 运行可审计的德扑规则。 Host 负责私有信息、合法行动、下注、边池、摊牌、结算与确定性 replay。
- 把真人带进同一场牌局。 可选的临时朋友房可以把当前 DSH 进程变成一张公网牌桌；没有真人入座的位置仍可由 Agent 补齐。
- 继续扩展 Harness。 游戏、Agent 目录、决策引擎、房间传输与 UI 表面是彼此独立的插件能力，而不是一个德扑专用的单体应用。

实机画面

DSH Host 选择真人与 Agent 席位。
朋友用手机浏览器直接打牌。

认识同桌牌手

内置牌手更像你熟悉的朋友局，而不是一份 solver 排行榜。每个角色都是虚构的，拥有独立版本，也可以随时替换。

| Agent | 牌风 | 桌上表现 |
| --- | --- | --- |
| 阿辉 | 松凶 | 总想证明自己真的「有范围」，所以经常多开一枪。 |
| 王总 | 极化 | 输小底池没感觉，但不喜欢别人当面抢他的底池。 |
| 老周 | 紧弱 | 一小时不入池也不着急。 |
| 小林 | 松弱 | 都已经跟到这里了，再看一张也很合理。 |
| 阿杰 | 紧凶 | 平时安静，找到优势后会连续施压。 |
| 小顾 | 平衡 | 范围表很熟，简单局面也容易想太久。 |

快速开始

当前版本从本仓库源码运行。Host 需要 Node.js 22.19+ 或 24+；只和 Agent 本地对战时不需要安装 cloudflared。

git clone https://github.com/lmong11/dsh-game-center.git
cd dsh-game-center
npm install --global pnpm@11.7.0
pnpm install
pnpm run build

启动本地 Agent 牌桌：

pnpm dsh --profile game-center

打开终端显示的本地地址，进入 Game Center，选择与 Agent 对战，配置席位后开始游戏。模型席位使用 DSH 中已配置的 provider；结构化策略席位不需要发起模型请求。

三种决策引擎

| 模式 | 席位如何行动 | 适合场景 |
| --- | --- | --- |
| 语言模型 | 把席位安全视图与有限合法行动列表发送给选定的 DSH 模型。 | 观察模型行为、测试角色设定，以及比较 Token 成本。 |
| 结构化策略 | 使用带版本的数值策略，并记录完整行动概率分布。 | 快速、可复现的对手与回归测试。 |
| Solver | 调用受信任的外部适配器，并在不可用或返回无效结果时显式降级。 | 在不把特定 solver 耦合进游戏的前提下进行受限实验。 |

每个普通席位只会收到自己的私牌和公共牌桌状态。Agent 看不到其他存活牌手的手牌、种子或尚未发出的牌。

为什么要在 Harness 里做游戏

德州扑克很适合验证 Harness，因为每次决策都有不完整信息、成本、截止时间和可衡量结果。有意思的不只是 Agent 会不会打牌，而是周围的 Harness 能否让你安全地替换并比较其中的各个部分。

| 能力 | 可替换边界 |
| --- | --- |
| 游戏 | 规则、状态投影、合法行动、结算与 replay 格式。 |
| Agent | 身份、版本、模型、策略参数、资源预算与 session 历史。 |
| 决策来源 | 语言模型、确定性策略或 solver 适配器。 |
| 房间 | 本地持久牌桌，或可选的临时公网分享层。 |
| 界面 | 通过 slot 注册的大厅、牌手目录、牌桌、replay 与未来游戏表面。 |

德州扑克的实现细节见 @deepseek-ai/dsh-game-holdem。DSH 的整体架构见开发指南、架构文档，以及 Cordis 论文 _A Programming Paradigm for Spatiotemporal Composability_。

临时朋友房

按照 Cloudflare 官方说明安装 cloudflared，确认 cloudflared --version 可用，然后启动朋友房 profile：

pnpm dsh --profile friend-room

在 Game Center 中选择与朋友，配置牌桌并复制邀请链接。朋友只需要手机或电脑浏览器，不必安装 DSH，也不必创建账号。

当前 MVP 有意保留以下限制：

- Host 进程、电脑与网络必须保持在线。
- 临时公网地址会在重启后改变，而且暂不支持断线恢复。
- Host 拥有最终裁决权，因此这个模式只适合相互信任的朋友与无现金价值筹码。

项目状态

DeepSeek Harness 与 Game Center 目前都处于开发者预览阶段。在插件边界稳定之前，请预期会有破坏兼容性的变更、尚未完成的界面以及有意收窄的产品限制。

欢迎在本仓库的 issues 中提交反馈与 bug。关于上游 Harness 的讨论，请前往 DeepSeek Harness 社区；相关插件仓库也可以添加 dsh-plugin topic 便于发现。

参与贡献

参见 CONTRIBUTING.md。在本仓库中工作的 agent 请遵循 AGENTS.md。

许可证

MIT。第三方依赖及其许可证见 THIRD_PARTY_NOTICES.md。