dsh-bgame

Readme

# dsh-bgame

DSH Web 小游戏插件。包含德州扑克、21 点、五子棋和 UNO，可与电脑或已配置的模型对战。当前版本为 `0.4.0`。

## 安装

需要 Node.js 24 或以上，以及已经初始化 Web profile 的 DeepSeek Harness。当前验证版本为 DSH `0.1.7-rc.2`。

### 快速安装

```sh
dsh plugin --profile web add github:Kiteluo/dsh-bgame
```

安装后启动 DSH Web 或刷新已运行的页面，在左侧导航和插件列表中打开 **dsh-bgame**。该命令使用当前 `DSH_HOME` 下的 Web profile。

### 从源码安装

```sh
git clone https://github.com/Kiteluo/dsh-bgame.git
cd dsh-bgame
npm install
node install.mjs
```

安装器使用 `$DSH_HOME/profiles/web`，未设置 `DSH_HOME` 时默认使用 `~/.dsh/profiles/web`。在本地 DSH 工作区的 `plugins/` 目录下运行时，也会识别该工作区已有的 `.dsh/profiles/web`。可显式指定 profile：

```sh
node install.mjs --profile /path/to/.dsh/profiles/web
```

安装器登记本地 link 依赖和插件 bundle，同步已有 pnpm 锁文件，备份修改前的配置，并迁移旧名称 `dsh-arcade`。重复执行不会重复登记。插件源码目录需要保留，目录链接会指向它。

首次安装后启动 DSH Web；已在运行的服务会热加载插件配置。刷新网页，左侧导航和「插件 → 已安装」中均显示 **dsh-bgame**，插件详情提供「打开游戏大厅」。

## 使用

- **电脑对手**：简单、普通、困难三档，本地运行，不调用模型。简单偏随机；普通采用基础规则策略；困难五子棋检查获胜、阻挡和双重威胁，德扑用公开信息抽样估算胜率，UNO 在对手手牌较少时优先阻止其出牌。21 点庄家固定在 17 点停牌，不受难度影响。
- **模型对手**：使用 DSH 中已配置的模型服务，消耗该模型的调用额度。模型只能看到自己的手牌和公开信息，程序验证其走法。
- **暂停 / 回到工作**：取消当前游戏请求并保存进度，不向工作会话插入消息。
- **自动存档**：每款游戏保存一局，重新打开可继续；电脑难度、模型出招方式和失败处理选项也会保存。旧版 `dsh-arcade` 的浏览器存档会自动读取；清除站点数据会删除存档。

模型提供两种出招方式：

| 方式 | 思考档位 | 输出上限 | 等待上限 |
| --- | --- | --- | --- |
| 快速出招 | 优先关闭思考；无法关闭时使用较低档位 | 8192 token | 60 秒 |
| 认真思考 | 使用模型支持的中等或较高档位 | 16384 token | 90 秒 |

认真思考可能增加等待时间和调用费用；无推理档位的模型仍按服务默认运行，出招后显示实际档位。失败时默认停在当前回合，提供「重试模型」「电脑代打本步」；也可选择「电脑自动接手」。代打按所选电脑难度执行，只替代当前一步，下一次仍由模型行动。模型返回完整合法的 JSON 走法后，即使结束标记为输出额度用尽，也会保留它的选择。

对局页显示当前回合、已走步数、上一手动作；模型思考期间显示实时等待时间。德扑额外显示底池、本轮最高下注、双方本轮下注及你需要跟注的金额。暂停、返回大厅或切换设置会取消旧请求，旧回复不会重复落子。

## 游戏规则

| 游戏 | 范围 |
| --- | --- |
| 德州扑克 | 双人无限注，盲注 10/20，完整四轮下注及最佳五张牌比较；按有效筹码限制下注，不设边池 |
| 21 点 | 庄家含软 17 停牌，天然 21 点赔 3:2，可加倍；不含分牌与保险 |
| 五子棋 | 15×15 自由五子棋，黑先，无禁手，连续五子或以上获胜 |
| UNO | 108 张牌，双人局，跳过/反转/+2/+4/换色；不叠罚牌、不设质疑，自动喊 UNO |

德扑与 21 点使用虚拟筹码，每局重新分配。

## 许可证

[MIT](LICENSE) · Copyright (c) 2026 Kiteluo