dsh-holdem
无限注德州扑克：1 名玩家 + 5 位 LLM 智能体。装上后，Web GUI 中间栏会出现「德州扑克」Tab，
会话区域还会浮着一个可拖动、可收起的小窗。
智能体只能看见自己的底牌；桌边闲话是中文，不会泄露推理或手牌。
安装
桌面版
桌面版（DeepSeek Harness.app）自带一套 dsh CLI，装到它自己的 desktop profile：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-holdem
装完桌面版会热重载 profile 并把新的客户端模块推给页面，通常不用重启；如果「德州扑克」Tab 没出现，退出重开桌面版。
Web
dsh plugin --profile web add dsh-holdem
dsh --profile web
装的是 npm 上的预构建包，不用 clone、不用 build、不用 allowBuilds。
卸载（把 profile 与 CLI 换成对应的一套）：
dsh plugin --profile web remove dsh-holdem
开发
pnpm install
pnpm build
| 文件 | 作用 |
|---|---|
src/host.js |
Node 半区：牌局引擎 + /dsh-holdem/* JSON API；缺模型时回退启发式机器人 |
src/client.cjs |
浏览器半区：conversation.view Tab + shell.overlay 悬浮小窗 |
cordis.patch.yml |
往 web 组合插入本包 |
改 Host 后需要重启 dsh --profile web。改 Client 后重新 pnpm build、刷新页面。
下注尺度
legalFor 的 maxRaiseTo 是智能体的全部筹码，所以直接把合法区间丢给模型会出事：
模型常在区间里挑一个"看起来挺大"的数，于是每次加注都静默变成全下（上游修过同一类问题的
客户端版本，见 f90bd7e）。现在 host 侧统一按底池给尺度：
- prompt 里给的是底池倍数区间
minRaiseTo – currentBet + 3 × 底池，并单独列出allin
作为"整副筹码"的显式选项，不再是加注区间的上界。 - 非
allin的加注一律过clampRaise（src/bets.js）：落在[minRaiseTo, 上限]内。
只有显式选allin才会推光；底池已经很大时上限自然超过筹码，那时"合法加注就是全下"仍然成立。 - 启发式兜底
decideAi的额度也走同一条钳制——它原先会算出超过自己筹码的加注额，在 LLM
报错的回退路径上绕过normalizeChoice，等于意外推光。
规则与边界都在 test/bets.test.mjs（纯函数）和 test/ai-sizing.test.mjs（stub 掉 llm 服务、
离线跑完整 AI 决策链路）里钉住。
买入与出局
每人起始 200 万，外加 3 次买入（也就是 4 条命）。筹码输光后：
- 下一手开始前自动补回 200 万，日志写明「重新买入 2000000（第 N/3 次）」；
- 3 次用完后再破产就出局：bot 坐观退场，不再发牌、不再被收盲注、不再参与行动；
- 你出局则本局结束（
status: 'game-over'），界面显示结束横幅，只能Reset再开一桌； - 桌面上只剩一名玩家时同样结束（等于打通关）。
界面上每个玩家行、每个座位都会显示「买入 N/3」，出局者额外标「出局」并置灰。
出局座位会被盲注与庄家轮转跳过；桌上只剩两人时按单挑规则，按钮位下小盲。
这条规则的动机是上游原来是无限买入：任何人（包括你）输光都会在下一手被无条件补回
200 万，既无人能出局，全下也就没有任何后果。规则本身是纯函数 src/table-rules.js
（rebuyDecision / blindSeats），单测见 test/table-rules.test.mjs；引擎接线与出局座位
的不变量由 test/rebuys.test.mjs 覆盖（含一个固定随机种子的「我方四条命耗尽」端到端用例）。
亮牌与翻牌动效
一手结束后看得到赢家的底牌：
- 摊牌：所有没弃牌的人亮牌（弃牌者仍是背面）；
- 无人跟注：只亮赢家那两张，其余人一律保持隐藏——一手进行中机器人的底牌永远不会下发到
客户端，这条防泄牌约束由test/reveal.test.mjs钉住（含「过牌到底必摊牌」「全弃牌只剩赢家
亮牌」两个端到端用例）。
发公共牌时有翻牌进场动效：翻牌三张依次错峰 0/70/140ms，转牌、河牌各自翻一次，时长 0.46s。
实现要点是社区牌的 React key 带上了牌面本身（boardCard()，i + ':' + 牌）：牌一落地
key 就变，React 挂载新节点，动画才会重播；若把 key 改回下标，动画就只在首次渲染时出现。
prefers-reduced-motion 下自动关闭。
悬浮小窗
除了中间栏的完整 Tab，插件还在会话区域浮着一个 360×520 的小窗（注册在 shell.overlay），
不切 Tab 也能看牌局：
- 拖标题栏移动；越界会被夹回可见区域，折叠状态的药丸同样可拖。
- 双击标题栏或点右上角
—收起成药丸，单击药丸展开。位置、折叠态与当前分页
都存在localStorage的dsh-holdem.mini里。 - 小窗内用「牌桌 / 时间线 / 头像」三个分页切换。小窗里的牌桌不是把大桌按比例缩小：
360px 宽下座位、气泡、Winner 横幅会全部叠在一起，所以它改成分区布局——顶部是公共牌 +
底池 + 你的底牌（摊牌后换成本手结果），中间每位玩家一行（庄/盲注标记、筹码、本手下注、
当前行动与闲话），底部固定操作区；玩家多时中间列表可滚动。 - Tab 与小窗共用一个 snapshot 轮询：展开时 280ms，收起的药丸降到 2000ms，两处同时开着也不会翻倍请求。
主题与配色
界面颜色全部走 hk-* CSS 变量：浅色值定义在 .hk-root/.hk-mini，深色值定义在
body[data-ds-dark-theme] 下的同名选择器（悬浮小窗不在 .hk-root 里，所以调色板
选择器必须同时带上 .hk-mini）。深色取值对齐 dsh 自身的 neutral-bluish
色阶（#151517 / #1b1b1c / #232324 / #e9ecf2 等），因此在深色 dsh 里
看起来和宿主是一体的。牌面是刻意的例外：两种主题下都是白底。
改完配色后跑一次对比度检查（WCAG AA）：
pnpm check:contrast
浅色模式下有 5 处对比度不足是继承自上游的既有问题（meta line、rail hint、
timeline hand header、seat stack、turn badge），脚本把它们标成 KNOWN
而不是 FAIL，便于后续单独处理；深色模式 24 项全部达标。
本地 fork 开发流程
本机 profile 通过 link: 指向本仓库，所以改动会立刻生效，无需重新安装：
- 改
src/client-css.cjs/src/client.cjs→pnpm build→ 浏览器自动热重载
（dsh-client-hmr轮询lib/client.js；插件 React state 会丢，牌局状态在 host 侧不受影响）。 - 改
src/host.js→pnpm build→ 重启dsh --profile web。 - 改包元数据（
package.json的dsh字段、cordis.patch.yml）→ 必须重启，
客户端模块元数据有缓存。
桌面版是同一个 web 组合：pnpm build 后客户端 bundle 由 HMR 推送，插件配置变化宿主会热重载；两者都没生效时再退出重开桌面版。把它指向本仓库：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add /Users/void/code/dsh-holdem
lib/ 是提交进 git 的构建产物：改完 src/ 一定要 pnpm build，否则运行的是旧代码。
API 安全
首次 GET /dsh-holdem 签发的会话 id 走 X-Holdem-Session 响应头，CSRF 令牌走 X-CSRF-Token 响应头；客户端把两者存在 localStorage 并随请求回传。web 端同时保留 HttpOnly、SameSite=Strict 的会话 Cookie，旧客户端仍可只靠 Cookie 建会话（请求头优先于 Cookie）。不同浏览器各自拥有独立牌桌，牌面不会在会话之间共享。
之所以不以 Cookie 为准：桌面版把 dsh-app:// 请求转发给回环 Host 时会丢弃客户端 Cookie、并扣掉响应里的 Set-Cookie，只有自定义请求头能跨过去。头像走 `、带不了请求头，所以它的 URL 里带一个独立的媒体令牌（?t=`）；该令牌只授权读头像，不能驱动任何动作。
POST 必须带 X-CSRF-Token、使用 application/json，请求体上限 4 MiB。Origin 存在且不属于本机 Host 时拒绝；非 http(s) 的 Referer（桌面版是 dsh-app://app）视为无信息。真正的 CSRF 控制是「必须带 X-CSRF-Token 自定义头」——跨源页面设不了自定义头。
dsh-host-webserver 默认只监听回环地址。不要在没有 TLS 和上游认证代理的情况下把 Web Server 暴露到局域网或公网；本插件的会话令牌用于会话隔离和 CSRF 防护，不替代部署层的用户身份认证。
许可证
MIT
