..

Agent 德州扑克

Issue 103 当前完整交付

当前任务为 Issue #103,根任务 Issue #102,需求版本 1。在完整基线 411cea6bd5a55848791051f4c47da325626ecb76 上交付整个 projects/agent-poker,采用指定候选 c721a1ccb75119f575e06933b78c430e5db571c2 的实现、测试和历史证据。运行源码与构建输入保持一致。本节是当前状态,下面各旧 Issue 的部署与验收状态仅作为历史记录保留。

固定环境证据已经解释并解决此前构建差异:归档如果没有自己的 Git 边界、又嵌在外层忽略目录内,会改变 Tailwind 扫描结果。请在普通 clone 或具有独立 Git 边界的完整归档中执行 npm ci --prefix projects/agent-poker 和 npm run build --prefix projects/agent-poker。

环境方记录源站为 127.0.0.1:4399,Node PID 2303,启动身份 Sat Sep 12 06:59:02 2026,隧道 PID 70644。这些身份仅供部署者核对,业务开发不得操作环境服务。HTML SHA256 为 44d05fc4255104e453f592a25b4fbeda8948ba86886caae4267e7d6852d5041b;index-BO_t9cEz.js 为 85e2f085961e7ecefd05c84890ab933a78d81a0a97c3f399849f3661969b42ad;index-CU526T7U.css 为 8a1d3de5a24abd65b2873a9e0cb04859b977adc46e68db1a4516743cdd58665c。公网观测:Agent 扑克。它依赖本机、源站和临时隧道存活,持续运行方式见下文。

新规则真实对局采用固定三手证据:新桌 52e49afe-dd88-4d89-9cfa-e7b750c9e1e1,三位真实 agent、DeepSeek/GLM,24 次成功响应、23 次应用、1 次暂停后未应用、1 次错误;每手和中间状态筹码均为 3000。第三手错误后经既有邀请 API 将玩家 1 切换到 DeepSeek 恢复同桌;第四手未完成,不计入。成功响应累计 621850ms、109853 tokens、并发 1 是历史调用记录,本轮新增模型调用 0。仅在 server.mjs、game.mjs、persistence.mjs、models.mjs、package.json、package-lock.json、real-check.mjs 与证据对应源码逐字一致时复用。

历史根 Issue #38 与 Issue #72 的失败、blocked、全部预算、原开发非 pass 与修正轮次耗尽均保留,不复活、不重置。短盲全下、河牌弃牌隐私、邀请 UI 修复,以及 CR #78、CR #98 和 QA 历史继续保留;旧 470 / a3 三手不是新规则证据。本次预算默认 90 分钟、20 次执行、3 次修正,仅一次新页面目标。

实施契约九项对照

契约 实现与复核入口
1 产品编排交付 根 Issue → 开发 Issue → PR → 独立 CR/QA → 集成与合入后 QA;开发不代替其他角色
2 虚拟筹码 game.mjs、ui.jsx,初始每位 1000,无支付接口
3 建桌与邀请 POST /api/tables、邀请 fragment、join 接口;页面展示邀请地址和接入说明;使用 modelId 接入不同模型
4 私有观察与合法行动 Bearer 鉴权、observation、action、version 重放保护与 legal 校验
5 规则与守恒 game.mjs 的盲注、发牌、下注轮、牌型、边池、平分;规则与 HTTP 测试
6 在线观测 上述公网地址;座位、筹码、公共牌、底池、行动者和时间线;默认底牌保密
7 三位真实 agent / 三手 固定新规则证据和后端逐字等价核验;测试动作不算模型对局
8 控制与安全 管理员开始/暂停/停止、已完成历史、独立服务;公网只开放扑克入口
9 Git 与独立验收 本轮 PR 最终 SHA 和需求版本 1 供独立 CR、QA 绑定,合入后 QA 待控制面推进

实际安装、构建、规则、HTTP、浏览器、公网及身份核验结果见本 Issue 的开发报告。开发自测不代替独立 CR、QA,不宣布最终验收通过。

以下为历史交付记录

当前交付 Issue #100,需求版本 1;本次只补文档与身份核验证据,运行源码及构建输入保持与 d1a5f6734e751dca5b7e9d8a1388218b25310558 逐字相同。虚拟筹码 No-Limit Texas Hold'em;服务器发牌、校验行动、比较牌型、分配边池及结算。没有支付功能。

Issue 100 当前源码、构建与运行身份

本节取代下文各历史轮次的“当前部署”描述。新候选是包含本文的 Git 提交,准确 SHA 以本 Issue 的开发报告及 PR 为准;d1a5f6734e751dca5b7e9d8a1388218b25310558 是未改动的运行源码身份,不冒充本次文档提交 SHA。

环境方评论 19435 与固定 Git 部署证据报告:公网源为 127.0.0.1:4399,后端从 a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc 部署,Node PID 2303,启动身份 Sat Sep 12 06:59:02 2026;隧道 PID 70644。静态资源由环境方从 d1a5f673 构建更新。本轮只经 Git 核验,没有访问源站、操作隧道或控制面,也未读取其他角色私有文件。进程身份是环境方采样事实,不能据此盲目停止或替换进程。

源码绑定已核验,静态部署绑定仍有差异。 本轮脚本证明 server.mjs、game.mjs、persistence.mjs、models.mjs、package.json、package-lock.json 及 service.mjs 在 a0737d41、d1a5f673 和工作树逐字一致;所有其他既有跟踪文件(本文除外)与 d1a5f673 一致。独立安装构建得到 index-BO_t9cEz.js 和 index-CU526T7U.css。但上述环境 Git 的 build.log 与 deployment.json 记录 index-FU5_FpP1.js 和 index-BEOPO_nE.css:JavaScript 内容 SHA256 相同,CSS 与 HTML 摘要不同。因此不能把“环境方称已对齐”写成已证实的完整构建一致;差异原始输出、完整摘要与复现命令见本轮证据。本轮未改变运行源码或构建输入,未因本轮返工使部署失效;既有部署的静态资源一致性仍待环境方解释或对齐,不能冒称最终候选已完整部署。

公网观测地址依赖本机、网络、独立源站及临时隧道存活,不承诺永久服务。部署与生命周期由环境方负责;本次返工不、也不能修改正在运行的公网部署与隧道。最终部署对齐由环境方按既有授权完成,独立 QA 须实际打开并绑定新候选 SHA 与需求版本 1。

真实对局证据只有后端源码及依赖锁文件逐字等价时才可复用,且仅证明对应规则/模型运行,不能替代新 UI、当前部署或独立验收。依据评论 19429及固定新规则对局证据,a0737d41 新桌 52e49afe-dd88-4d89-9cfa-e7b750c9e1e1 的三手、DeepSeek/GLM、24 次成功响应/23 次应用/1 次暂停后未应用/1 次错误与筹码 3000,可按本轮后端等价检查交独立角色复核。它们是环境方历史调用,本轮新增真实模型调用为 0,没有执行 real-check.mjs。

0afa4df50967e881a700231022c13f4e30d9d2f1 下的 evidence/issue-35-final 和 470879a305438fc958acfc6486f1f86bcd94b681 下的 projects/agent-poker/evidence.json(第一手含一次真实多人摊牌)保留为历史事实。该旧规则的 game.mjs 与当前不同,不能用其证明当前规则已实际摊牌、完成新调用或通过验收。后续独立全量 CR、QA 与合入后 QA 必须使用同一最终 SHA,开发不得自行宣布最终验收通过。

安装与启动

Node 24。在仓库根目录运行:

cd projects/agent-poker
npm ci
npm run build
# 由运行者设置自己的私有目录,禁止使用其他角色目录。
export TMPDIR="<当前角色绝对路径>/tmp"
export TMP="$TMPDIR" TEMP="$TMPDIR" POKER_DATA="$TMPDIR/service"
mkdir -p "$POKER_DATA"
POKER_PORT=18439 node service.mjs

服务仅监听 127.0.0.1:18439,关闭浏览器或开发会话不终止独立后台进程。状态与完整模型证据存于 POKER_DATA/state.json、POKER_DATA/evidence.jsonl,权限 0600;服务重启恢复牌局且默认暂停,管理员核对后开始。停止服务使用自己保存的 PID。此版单进程、单本机文件持久化:同目录临时文件写入、fsync、原子替换并同步目录。中断时保留完整旧版或新版快照,重启忽略残留 .pending;不提供多实例或日志与快照之间的跨文件事务。物理断电受操作系统与存储硬件刷盘保证约束。

管理凭据在 POKER_DATA/admin-token,由本机管理员读取后填写页面密码框。页面仅在内存保存,不置入链接或浏览器持久化。公网观众无需管理凭据即可观测;控制操作需要管理凭据。请使用 HTTPS 公网地址。

邀请与真实模型

页面“建立牌桌”生成三张邀请链接。邀请凭据只放 URL fragment,不发送至静态服务器或 Referer;不要提交 Git 或公开转发。受邀玩家点击“接受邀请”,或者使用 API。模型配置仅从 /Users/pptg/.d-sre-agent/config/sre-agent.yaml 加载,复用 D-SRE 的 provider 与 compat 映射,使用 pi SDK 0.85.0。

  • GET /api/tables:公开牌桌、行动、历史与筹码。
  • POST /api/tables:管理员提交 { "names": ["甲", "乙", "丙"] },返回牌桌 id 与邀请链接。
  • GET /api/models:管理员读取安全模型列表。
  • POST /api/tables/:id/join:邀请 Bearer 凭据,空对象接入外部 API 玩家;{ "modelId": "本机模型 id" } 接入服务内真实 pi Agent 玩家。至少两种模型可分配至三位玩家。
  • GET /api/tables/:id/observation:邀请 Bearer 凭据,只返回该玩家底牌和公开观察,含 version、legal 与 player。
  • POST /api/tables/:id/action:邀请 Bearer 凭据,{ "version": 1, "action": "call", "amount": 0 }。bet/raise 的 amount 为本下注轮总额;合法范围以观察为准。
  • POST /api/tables/:id/control:管理员 Bearer 凭据,{ "action": "start" } 开始最多三手;pause 或 stop 停止继续执行。已在途模型响应保留证据,但暂停期间不应用动作。

所有玩家接受邀请后才可开始。模型按自己的私有观察独立调用,不配置固定动作或回退随机动作;非法模型输出使牌桌暂停。每个调用有 90 秒超时。外部玩家不行动会等待,不代替玩家行动。玩家破产导致不足两位时不能开始新手牌。单实例按桌串行调用模型,适用于本演示规模。

规则与验证

npm test
# 以下集成检查会创建独立测试牌桌;使用当前运行者自己的数据目录。
node api-check.mjs
node browser-check.mjs
# 创建三位真实模型玩家,调用本机配置的 DeepSeek 与 GLM;服务每次开始最多三手。
POKER_URL=http://127.0.0.1:18439 node real-check.mjs

浏览器检查使用本机 Chrome 与 Playwright,截图写入 TMPDIR。POKER_URL 可指定 HTTPS 外网地址。规则测试覆盖牌型、轮次、all-in、短加注不重新开放行动、边池、平分、筹码守恒、非当前玩家、非法下注、过期请求与私有投影;HTTP 检查覆盖鉴权与并发重复动作。开发自测不等于独立 CR/QA。

牌型从最多七张牌枚举五张组合,最强牌型按类别及踢脚比较;奇数筹码从按钮左侧获胜玩家开始分配。每手轮转按钮,盲注 10/20,初始每位 1000。legal.actions 给出当前允许动作。单个不足最小加注的 all-in 不重新开放加注;累计差额达到最小加注时恢复加注权。弃牌底牌不在公开历史中披露;只有五张公共牌的已结束摊牌展示未弃牌者底牌。

UI 复用

直接导入仓库 apps/web/src/theme.css、page-layout.css、workbench.css、components/page-workspace.tsx 与 components/ui/button.tsx;D-SRE 来源见 复用清单,许可见 第三方声明。style.css 仅导入既有主题并用 @source 扫描根目录外复用组件的工具类,不含新增视觉规则;牌桌座位使用已有 Tailwind 网格、边框及主题 token,公共状态和历史使用原生语义元素。组件源码与许可未改动。

外网与交付限制

仅将本项目端口转发:

cloudflared tunnel --url http://127.0.0.1:18439 --no-autoupdate

先确认该端口响应为本扑克项目,再开隧道。不得转发 PPanel 控制面。临时地址随 cloudflared 生命周期失效,没有稳定域名或可用性保证。当前既有公网观测地址转发 127.0.0.1:4399,依赖本机、网络与隧道持续运行。源站 Node PID 43920(2026-09-12 06:01:31 启动)、cloudflared PID 70644(2026-09-12 01:23:26 启动)由部署者管理;这些是历史启动身份,不能仅凭 PID 停止或替换。开发者自测使用自己独立端口和运行目录。以上为 Issue 73 的历史部署身份,现已被本文开头 Issue 100 的环境记录取代;后续独立 CR/QA 与集成仍须绑定最终 SHA。

evidence.json 为三手真实对局的安全证据投影:保留模型身份、实际输出、动作、耗时、用量、结算和私有观察摘要,移除底牌;完整私有观察仍保存在开发运行目录,不能用其本机路径替代 Git/Gitea 交接。复现需自行建桌、分配模型并运行三手,不要求复现相同随机牌或模型动作。

Issue 57 历史运行与限制(非当前部署状态)

本轮服务监听 127.0.0.1:18459,独立进程及启动身份、私有日志和状态目录详见 evidence/verification.json。18460 是独立 HTTP/重启测试服务。所有临时文件位于本角色 tmp。测试动作不计入真实对局。

已有临时公网入口直连 HTTP 返回 200,浏览器异步加载完成后显示另一张已有牌桌,停在第 5 手并提示模型调用或动作失败。指定探针 PID 70638 已不存在;隧道 PID 70644 启动身份仍匹配。按照 Issue 的失败分支,没有替换未知源站,没有改动隧道或控制面。该公网入口不代表本轮候选的部署,外网验收仍未完成;代理路径返回 CONNECT 403。公网截图与原始响应见 evidence/issue-57/。

本轮第三手河牌阶段 GLM 两次超时后,将玩家乙经自身邀请接口切换到 DeepSeek 继续真实决策,见 evidence/issue-57/model-switch.json;此前 GLM 的实际动作和失败事件均保留。模型超时不是成功响应。

本轮完成三手真实对局、一手真实摊牌(第三手河牌弃牌结束,不计摊牌),17 次成功模型响应、16 次应用动作,另一次暂停期间返回而未应用;两次超时另记错误事件。三手筹码总额均为 3000,重启后三手历史完整保留且默认暂停。

Issue 73 交付与证据复用

在完整基线 411cea6bd5a55848791051f4c47da325626ecb76 上仅采用候选的项目目录,保留基线控制面修复。运行源码、锁文件及直接复用的共享 UI 与候选逐字一致;本轮变更为本文和开发验证证据。核验详见 evidence/issue-73/。

既有独立部署证据记录三手真实对局、三位 pi Agent、DeepSeek/GLM 两模型、20 次成功响应、19 次应用动作、1 次停止后未应用及 1 次错误,所有历史筹码总额 3000。第二手模型失败后通过邀请 API 切换模型继续。第四手停止且未完成,不计数。本轮只从 Git 读取并核对这些事件,无新增模型调用。项目原有 evidence.json 另有三手与一次真实摊牌,是 Issue 57 历史证据,不冒称本轮新对局。

本轮本地构建与公网 JavaScript 内容逐字一致,但 CSS 和 HTML 文件哈希不同;本地构建及公网资源摘要分别保留,不声称整个构建逐字一致。真实模型与规则证据复用限于相同运行源码,页面验收以本轮浏览器检查及后续独立 QA 为准。

历史邀请交互(已由下文 Issue 96 修复):在同一页面仅切换 #join= fragment 时,joined 是页面级布尔值,按钮可能继续显示前一玩家“已加入”。服务端仍按当前邀请凭据鉴权,不能凭显示状态读取其他玩家底牌;三个独立新页邀请可正常完成。影响是同页连续接入时可能误以为新玩家已加入,导致开始被全员加入门禁拒绝。开发建议后续按邀请身份重置显示状态;本 Issue 明确将是否修复交给产品决定,因此本次保留并报告,不将其隐去或自作最终产品验收结论。当前使用方式是每份邀请独立新页打开。

Issue 88 规则与隐私返工

本次 Issue #88 根据 独立 CR #78 修正两项问题,需求版本仍为 1:

  • 只剩一位可行动玩家时,跟注目标使用仍未弃牌玩家的实际投注。短大盲全下且小盲已覆盖时直接补齐公共牌并摊牌;仍欠筹码时可弃牌或跟注,不能向无人响应的边池加注。仍有多人可下注时保留名义大盲 20。
  • 结束后至少两位未弃牌玩家且公共牌完整才公开摊牌底牌。河牌弃牌获胜仍隐藏赢家底牌;赢家通过自己的邀请可看自己的牌。使用现有牌局状态推导,无新增持久化字段,旧快照加载后同样应用隐私规则。

新增规则回归覆盖短盲注、无人响应加注、多人转为全下对局、河牌弃牌公共/玩家投影、快照重载及正常多人摊牌;api-check.mjs 通过真实 HTTP 动作执行河牌弃牌结束,检查公共接口与每位玩家的观察。测试动作不是模型对局。

本次修改了 game.mjs,已有部署及真实模型记录不能证明修复后的代码已部署或通过验收。根据 根任务环境更新,公网此前已更新至 a3fce77317c99cc68fb05fa0c1934fd62999cd3f,源站 Node PID 59783(2026-09-12 06:19:00 启动),替代上文历史 PID 43920。本轮未操作该源站、隧道或控制面;最终部署需由授权部署者从新候选更新并重新核验,不能只凭历史 PID 操作服务。

本轮新增模型调用 0。旧真实对局仅作为可追溯历史事实;模型适配、邀请接口和 UI 源码保持不变,但规则文件有上述修正,不能宣称与旧运行源码逐字一致。最终独立 CR、QA、部署核验及合入后 QA 必须绑定新 SHA。当时同页切换邀请 fragment 的显示问题交产品决定;现已按 Issue 96 的修复决定完成修改,见下文。

Issue 96 邀请状态修复(需求版本 1)

产品在 Issue #96 决定修复同页切换邀请后“已加入”残留。页面现在监听 hashchange,成功接受的邀请按完整 #join= 身份保存在当前页面内存中;切换到尚未接受的邀请显示“接受邀请”,移除片段隐藏邀请区域。异步加入响应只标记发起该请求的邀请,不能把新邀请标为已加入。刷新页面后可重新接受邀请,服务器原有幂等加入接口不变。无新增依赖、样式或服务端权限变更。

browser-check.mjs 在本机真实 Chrome 与项目 HTTP 服务间验证:玩家 1 加入后同页切换玩家 2,按钮恢复“接受邀请”,服务端仍为 [true,false,false];接受玩家 2 后变为 [true,true,false];另建新桌,三份邀请各自独立新页加入,席位最终为 [true,true,true]。脚本不配置模型、不启动模型对局。原始失败、通过输出与规则测试见 evidence/issue-96-invitation/。

复现时先将 TMPDIR、TMP、TEMP 指向执行者自己的临时目录,POKER_DATA 指向该目录内的独立私有数据目录;为测试服务选择空闲本机端口,并令 POKER_URL 对应它。执行:

npm ci --prefix projects/agent-poker
npm --prefix projects/agent-poker run build
node projects/agent-poker/server.mjs
# 另一个终端,沿用上述环境变量:
node projects/agent-poker/browser-check.mjs
node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs
node projects/agent-poker/api-check.mjs

本轮新增真实模型调用为 0。相对前候选 a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc 未修改 game.mjs,保留 Issue 88 的 R1/R2 修复;相对历史真实对局候选 470879a305438fc958acfc6486f1f86bcd94b681,规则源码已经变化,因此旧真实对局只证明历史运行,不证明当前候选已完成真实对局或最终验收。

根据 Issue 96 当时正式任务的历史环境事实,公网观测 的源站仍为 127.0.0.1:4399 上旧候选 a3fce773(Node PID 59783,启动身份 Sat Sep 12 06:19:00 2026),cloudflared PID 70644。本轮未操作源站、隧道或 4498/4497 控制面,未宣称公网已更新到本候选;最终 SHA 的公网部署及核验由环境方在合并后执行。临时地址依赖本机与隧道存活,不承诺永久服务。独立 CR 与 QA 必须重新绑定同一最终 SHA 和需求版本 1,开发验证不能代替最终验收。