Agent 德州扑克完整交付与最终全量验收(Issue35后续) #92

Open
peng01.guo wants to merge 2 commits from ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-6 into deliveries/agent-poker-final
Owner

Issue #88 开发修正报告

结论:pass(仅指本轮开发修正与自测完成,不代表最终验收通过)。需求版本:1。

  • 开发分支:ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-6。
  • 新候选:a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc;提交。
  • 基线:411cea6bd5a55848791051f4c47da325626ecb76,已验证是候选祖先。
  • 返工来源:独立 CR #78。原失败候选为 a3fce77317c99cc68fb05fa0c1934fd62999cd3f。

修复与范围

R1:Game.advance() 在仅剩一位可行动玩家时按未弃牌玩家的实际投注判断是否跟齐;短大盲全下且小盲已覆盖时自动摊牌。尚欠筹码时只需跟齐实际全下额,Game.legal() 拒绝无人能响应的加注。多人仍可下注时保留名义大盲。

R2:Game.view() 从完成状态、完整公共牌和至少两位未弃牌玩家推导真正摊牌;河牌弃牌获胜不再公开赢家底牌。自己的邀请仍可读取自己的牌,正常多人摊牌仍公开未弃牌者。使用已有字段,旧快照重载也应用修复。

仅修改 projects/agent-poker/game.mjs、projects/agent-poker/test.mjs、projects/agent-poker/api-check.mjs、projects/agent-poker/README.md。没有新增依赖、架构层、样式或配置;31 个冻结文件逐一核对 blob,差异为 0。已提交并推送。

实际验证

先添加回归再修代码:原代码 11 项中 7 通过、4 失败,分别复现已覆盖短盲仍行动、跟注额错误、多人弃牌后短盲仍行动及河牌赢家泄露;修复后 11/11 通过。断言不依赖随机牌的胜负。检查了非法动作不变更状态、筹码守恒、重载投影与正常摊牌。

执行命令(仓库根目录,TMPDIR、TMP、TEMP 均指向本角色私有目录):

node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs
npm ci --prefix projects/agent-poker --cache "$TMPDIR/npm-cache"
npm run build --prefix projects/agent-poker
node "$TMPDIR/integration.mjs"
git diff --check

集成脚本启动本 clone 的 server.mjs,以 POKER_PORT=0 分配独立端口和私有数据目录,执行 api-check.mjs 与 browser-check.mjs,最后关闭自己的测试服务。HTTP 实际通过邀请与私有观察、未授权拒绝、非当前玩家拒绝、并发重复请求只有一个成功;新增动作序列通过 HTTP 走到河牌并弃牌结束,公共 API 与所有其他玩家均看不到赢家底牌,赢家仍看得到自己的牌,历史筹码为 3000。Chrome 实际打开观测页面并完成接受邀请。没有模型调用,没有操作现有公网进程。

规则与持久化输出

✔ 快照替换完整且私有;替换前进程被杀仍保留旧历史 (51.523416ms)
✔ 牌型、轮子顺子及踢脚比较 (0.461167ms)
✔ 边池与平分奇数筹码 (1.650458ms)
✔ 轮次、隐私、重复动作与非法输入均不变更状态 (3.180334ms)
✔ 短 all-in 不重新开放加注;全下自动摊牌守恒 (0.944333ms)
✔ 连续 50 手合法行动筹码守恒 (7.633875ms)
✔ 短大盲全下且小盲已覆盖时直接摊牌,不再允许弃牌 (0.4175ms)
✔ 唯一可行动者只需跟齐实际全下额,不能向无人响应的边池加注 (0.1565ms)
✔ 多人短大盲保留名义大盲;其他玩家弃牌后按实际投注自动摊牌 (0.122041ms)
✔ 河牌弃牌获胜后公开和其他玩家投影隐藏赢家底牌,重载仍隐藏 (0.30325ms)
✔ 真实多人摊牌仍公开未弃牌者底牌 (0.189084ms)
ℹ tests 11
ℹ suites 0
ℹ pass 11
ℹ fail 0
ℹ cancelled 0
ℹ skipped 0
ℹ todo 0
ℹ duration_ms 82.802875

构建输出


> build
> vite build

vite v8.2.2 building client environment for production...
transforming...
✓ 2018 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                   0.33 kB │ gzip:  0.26 kB
dist/assets/index-CU526T7U.css   91.05 kB │ gzip: 18.12 kB
dist/assets/index-DdXzWjAN.js   288.06 kB │ gzip: 92.73 kB

✓ built in 479ms

HTTP 与浏览器输出

api-check.mjs exit=0
browser-check.mjs exit=0
HTTP 鉴权、隐私、非当前玩家、并发重复动作与河牌弃牌获胜隐私检查通过
浏览器观测、邀请流程通过

完整任务与评论、原失败输出、通过输出、安装/构建日志、HTTP 服务日志、浏览器截图及私有测试状态均保留于本角色 tmp;凭据与运行产物未提交。以上可复现测试代码已随提交交付,报告直接包含验证结果,不以其他角色私有路径作为交接输入。

证据适用范围与剩余门禁

已通过 Git 读取 既有真实对局与源码证据。该记录包含三位玩家、DeepSeek/GLM 两模型、三手完成、20 次响应、19 次应用、1 次错误,每手 3000 筹码;这是旧运行的历史事实,本轮新增模型调用 0。本轮核对源码摘要:模型适配、服务器、持久化、UI 与锁文件保持一致;game.mjs 已修正,不能将旧真实对局说成修复后新调用或同源码全量验证。未重复昂贵对局,后续独立角色须判断历史证据适用范围。

公网观测地址 按 环境更新 仍是旧候选 a3fce773 的部署。本角色没有重新部署或宣称公网已包含修复;不能用本轮本地自测替代新 SHA 公网验证。授权部署者需要从新候选更新并核验。地址依赖本机与临时隧道,生命周期限制见 README.md。

同页切换邀请 fragment 的已知显示问题保持原任务规定:交产品决定,当前每份邀请独立新页打开。本次未擅自扩大 UI 修改范围。

后续由控制面在本报告新 SHA 与需求版本 1 上安排独立全量 CR、QA、部署核验、集成与合入后 QA;不得沿用旧 SHA 通过记录或由开发宣布最终验收通过。

# Issue #88 开发修正报告 结论:`pass`(仅指本轮开发修正与自测完成,不代表最终验收通过)。需求版本:`1`。 - 开发分支:`ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-6`。 - 新候选:`a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc`;[提交](https://gitea.d-robotics.cc/peng01.guo/ppanel/commit/a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc)。 - 基线:`411cea6bd5a55848791051f4c47da325626ecb76`,已验证是候选祖先。 - 返工来源:[独立 CR #78](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/78)。原失败候选为 `a3fce77317c99cc68fb05fa0c1934fd62999cd3f`。 ## 修复与范围 `R1`:`Game.advance()` 在仅剩一位可行动玩家时按未弃牌玩家的实际投注判断是否跟齐;短大盲全下且小盲已覆盖时自动摊牌。尚欠筹码时只需跟齐实际全下额,`Game.legal()` 拒绝无人能响应的加注。多人仍可下注时保留名义大盲。 `R2`:`Game.view()` 从完成状态、完整公共牌和至少两位未弃牌玩家推导真正摊牌;河牌弃牌获胜不再公开赢家底牌。自己的邀请仍可读取自己的牌,正常多人摊牌仍公开未弃牌者。使用已有字段,旧快照重载也应用修复。 仅修改 `projects/agent-poker/game.mjs`、`projects/agent-poker/test.mjs`、`projects/agent-poker/api-check.mjs`、`projects/agent-poker/README.md`。没有新增依赖、架构层、样式或配置;`31` 个冻结文件逐一核对 blob,差异为 `0`。已提交并推送。 ## 实际验证 先添加回归再修代码:原代码 `11` 项中 `7` 通过、`4` 失败,分别复现已覆盖短盲仍行动、跟注额错误、多人弃牌后短盲仍行动及河牌赢家泄露;修复后 `11/11` 通过。断言不依赖随机牌的胜负。检查了非法动作不变更状态、筹码守恒、重载投影与正常摊牌。 执行命令(仓库根目录,`TMPDIR`、`TMP`、`TEMP` 均指向本角色私有目录): ```sh node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs npm ci --prefix projects/agent-poker --cache "$TMPDIR/npm-cache" npm run build --prefix projects/agent-poker node "$TMPDIR/integration.mjs" git diff --check ``` 集成脚本启动本 clone 的 `server.mjs`,以 `POKER_PORT=0` 分配独立端口和私有数据目录,执行 `api-check.mjs` 与 `browser-check.mjs`,最后关闭自己的测试服务。HTTP 实际通过邀请与私有观察、未授权拒绝、非当前玩家拒绝、并发重复请求只有一个成功;新增动作序列通过 HTTP 走到河牌并弃牌结束,公共 API 与所有其他玩家均看不到赢家底牌,赢家仍看得到自己的牌,历史筹码为 `3000`。Chrome 实际打开观测页面并完成接受邀请。没有模型调用,没有操作现有公网进程。 ### 规则与持久化输出 ```text ✔ 快照替换完整且私有;替换前进程被杀仍保留旧历史 (51.523416ms) ✔ 牌型、轮子顺子及踢脚比较 (0.461167ms) ✔ 边池与平分奇数筹码 (1.650458ms) ✔ 轮次、隐私、重复动作与非法输入均不变更状态 (3.180334ms) ✔ 短 all-in 不重新开放加注;全下自动摊牌守恒 (0.944333ms) ✔ 连续 50 手合法行动筹码守恒 (7.633875ms) ✔ 短大盲全下且小盲已覆盖时直接摊牌,不再允许弃牌 (0.4175ms) ✔ 唯一可行动者只需跟齐实际全下额,不能向无人响应的边池加注 (0.1565ms) ✔ 多人短大盲保留名义大盲;其他玩家弃牌后按实际投注自动摊牌 (0.122041ms) ✔ 河牌弃牌获胜后公开和其他玩家投影隐藏赢家底牌,重载仍隐藏 (0.30325ms) ✔ 真实多人摊牌仍公开未弃牌者底牌 (0.189084ms) ℹ tests 11 ℹ suites 0 ℹ pass 11 ℹ fail 0 ℹ cancelled 0 ℹ skipped 0 ℹ todo 0 ℹ duration_ms 82.802875 ``` ### 构建输出 ```text > build > vite build vite v8.2.2 building client environment for production... transforming... ✓ 2018 modules transformed. rendering chunks... computing gzip size... dist/index.html 0.33 kB │ gzip: 0.26 kB dist/assets/index-CU526T7U.css 91.05 kB │ gzip: 18.12 kB dist/assets/index-DdXzWjAN.js 288.06 kB │ gzip: 92.73 kB ✓ built in 479ms ``` ### HTTP 与浏览器输出 ```text api-check.mjs exit=0 browser-check.mjs exit=0 HTTP 鉴权、隐私、非当前玩家、并发重复动作与河牌弃牌获胜隐私检查通过 浏览器观测、邀请流程通过 ``` 完整任务与评论、原失败输出、通过输出、安装/构建日志、HTTP 服务日志、浏览器截图及私有测试状态均保留于本角色 `tmp`;凭据与运行产物未提交。以上可复现测试代码已随提交交付,报告直接包含验证结果,不以其他角色私有路径作为交接输入。 ## 证据适用范围与剩余门禁 已通过 Git 读取 [既有真实对局与源码证据](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/0afa4df50967e881a700231022c13f4e30d9d2f1/evidence/issue-35-final)。该记录包含三位玩家、DeepSeek/GLM 两模型、三手完成、`20` 次响应、`19` 次应用、`1` 次错误,每手 `3000` 筹码;这是旧运行的历史事实,本轮新增模型调用 `0`。本轮核对源码摘要:模型适配、服务器、持久化、UI 与锁文件保持一致;`game.mjs` 已修正,不能将旧真实对局说成修复后新调用或同源码全量验证。未重复昂贵对局,后续独立角色须判断历史证据适用范围。 [公网观测地址](https://laws-forming-bare-remedies.trycloudflare.com) 按 [环境更新](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72#issuecomment-19196) 仍是旧候选 `a3fce773` 的部署。本角色没有重新部署或宣称公网已包含修复;不能用本轮本地自测替代新 SHA 公网验证。授权部署者需要从新候选更新并核验。地址依赖本机与临时隧道,生命周期限制见 `README.md`。 同页切换邀请 fragment 的已知显示问题保持原任务规定:交产品决定,当前每份邀请独立新页打开。本次未擅自扩大 UI 修改范围。 后续由控制面在本报告新 SHA 与需求版本 `1` 上安排独立全量 CR、QA、部署核验、集成与合入后 QA;不得沿用旧 SHA 通过记录或由开发宣布最终验收通过。
peng01.guo added 2 commits 2026-09-12 06:55:42 +08:00
This pull request has changes conflicting with the target branch.
  • projects/agent-poker/README.md
  • projects/agent-poker/browser-check.mjs
  • projects/agent-poker/ui.jsx

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-6:ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-6
git checkout ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-6
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: peng01.guo/ppanel#92
No description provided.