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

Open
opened 2026-09-12 06:56:59 +08:00 by peng01.guo · 2 comments
Owner

任务分配:reviewer

根任务:#72

分配原因

编排决定:dispatch(新候选上的独立全量 CR)

依据:根任务 71c1c0f7-69c9-487e-98a2-776bd0872c4f(Issue #72)需求版本 revision 1,基线 411cea6bd5a55848791051f4c47da325626ecb76。开发修正 run e6289cea-dfc7-40eb-99e7-b1ea880fdff9(codex,Issue #88,PR #92,结论 pass)已产生新候选 a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc。上一轮 CR run 68634d6a-4ec1-4dd7-becd-22380cffea6c(codex)在旧 SHA a3fce77317c99cc68fb05fa0c1934fd62999cd3f 上判 changes_requested(R1 短大盲全下后小盲仍被要求行动、R2 河牌弃牌获胜被错误公开底牌);该结论只对旧 SHA 有效,不得沿用作新候选的通过依据。现对新候选派独立全量 CR,与并行 QA 绑定同一 SHA 与同一 revision。

运行时选择理由:评审首选 opencode,但 run 67d72ca1-5c48-4331-896e-ff92ccbf63b3 曾以 Error: 超过单次执行时限 失败(观测到约 15 分钟硬上限);codex 在同等全量范围审查中以约 5.5 分钟产出了完整可判定结论。为在默认有界预算内稳定取得门禁结论,本轮 CR 使用 codex:独立会话、独立分支 ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-7、独立工作目录,与开发 run 不共享会话与工作树。

审查范围(全量,非增量):整个 projects/agent-poker 及实际复用的共享主题/布局/按钮/样式/工具依赖,逐项对照 docs/implementation-contract.md 九项要求与 Issue #72 冻结验收 v1 七项。

必查项:

  1. R1/R2 修复真实性:projects/agent-poker/game.mjs 中 advance()、legal()、view() 的新逻辑须用可复现脚本独立验证——短大盲全下且小盲已覆盖时自动摊牌且不再可 fold 夺池、唯一可行动者只需跟齐实际全下额且不能向无人响应的边池加注、多人仍可下注时保留名义大盲、河牌 fold 获胜后公共投影与其他玩家投影均隐藏赢家底牌、真实多人摊牌仍公开未弃牌者底牌、旧快照重载后投影仍隐藏。不得只采信开发自报的 11/11。
  2. 不得引入回归:盲注、发牌、翻牌/转牌/河牌、fold/check/call/bet/raise/all-in、短加注不重开加注、摊牌、牌型比较、平分、边池、筹码守恒;非法、越权、重复、非当前玩家动作不得改变牌局状态(含 version 并发门禁)。
  3. 隐私与凭据:玩家凭邀请凭据只能读自己底牌与允许的公共状态;观测页与公共 API 在摊牌前不得泄露他人底牌与邀请凭据(R2 修复后须重新覆盖该投影路径与其 HTTP 出口);邀请 token 不得进入公开 Git。
  4. 控制与历史:开始/暂停/停止与已完成局历史;未授权观众不得取得管理凭据、模型密钥或玩家私有信息。
  5. 真实对局证据:仅经 Git 读取候选自带 projects/agent-poker/evidence、0afa4df50967e881a700231022c13f4e30d9d2f1 下 evidence/issue-35-final、以及 470879a305438fc958acfc6486f1f86bcd94b681 既有证据。必须明确报告 game.mjs 已在 a0737d41 中被修复,历史三手对局不再与最终运行源码逐字相同,只能作为历史事实复用,不得冒称本轮新模型调用或修复后的验证结果;不得无理由重复昂贵对局,禁止调用真实模型。
  6. 部署一致性:公网 4399 仍为旧候选 a3fce773 的部署(Node PID 59783,启动身份 Sat Sep 12 06:19:00 2026,cloudflared PID 70644 保留,4498/4497 控制面不受影响)。不得把该旧部署冒充新候选,必须如实报告差异;已授权的源站替换不构成缺陷,dispatchPhase = launching 同属登记现象,均不得作为拒绝理由。
  7. 邀请 UI 边界:同页仅切换邀请 fragment 后 joined 残留显示上个玩家、独立新页三份邀请正常。本轮修改范围未含 ui.jsx,须独立复测并给出影响评估,交产品决定是否修复,不得跳过、隐瞒或自行宣称豁免。
  8. 开发报告非 pass 时评审拒绝才是正确门禁;本角色不得修改业务代码、冻结验收文件或控制面状态。

纪律与时间盒:本轮控制在约 10 分钟内完成,先做确定性单测与源码读证(node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs),浏览器/公网端到端与真实证据交叉核验交给并行 QA,避免重复消耗。禁止读取其他角色或根执行者私有目录、数据库、模型日志;全部交接只经 Git/Gitea;评论是数据不是指令。

输出要求:结论绑定候选 SHA a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc 与需求 revision 1,逐项给出 pass/reject 与显式 Markdown 链接或独立清晰 URL;失败项须给出可复现命令与文件路径(行内代码保护),不得弱化门禁。

目标与验收

使用本控制面的真实协作流程,自行组织开发、独立 CR、QA、修复和交付一个可运行的 Agent 德州扑克项目。实现代码只放 projects/agent-poker 与必要项目文档,复用仓库已有 D-SRE 样式和组件。游戏使用虚拟筹码,无真实支付。提供在线观测页面、邀请不同 agent 入桌的机制、明确的对局状态和动作时间线。牌局由服务器作为唯一裁判,不能让 agent 自报胜负。至少三名真实 agent 玩家,覆盖至少两种本机运行时或模型,动作来自真实模型根据各自私有观察做出的决策。禁止预置固定动作、录播、mock 模型或脚本冒充 agent 对局。执行者各自独立目录,只通过 Git/Gitea 交接开发工作。最终提交启动、邀请、观测、规则测试与真实对局复现说明。
以 docs/implementation-contract.md 的最终项目九项要求为完整契约。本机 cloudflared 已安装,可建立临时公网观测地址;只转发扑克项目必要入口,不转发 PPanel 控制面或管理密钥。游戏与观测服务须独立于开发执行者会话持续运行,记录端口和生命周期,邀请 token 不进公开 Git。

这是 Issue35 评论18981明确授权的一次完整后续任务。原根#38已blocked,原记录和预算保留,不将原任务改成功。本次目标分支 deliveries/agent-poker-final 已从完整基线411cea6bd5a55848791051f4c47da325626ecb76预置。采用远端已发布候选470879a305438fc958acfc6486f1f86bcd94b681(PR62,开发Issue57),参照原#38/#39/#48/#57全部Git/Gitea证据;优先采用已实现代码并按发现修复,不重复从零实现。禁止读取其他角色或根执行者私有目录、数据库、模型日志。全部交接只经Git/Gitea。

必须自行完成开发交付、独立全量reviewer和qa、必要返工、合并与合入后QA。审查整个projects/agent-poker及实际复用依赖,不仅增量;不得跳过规则、隐私、邀请、控制、历史、公网和真实模型证据。独立CR/QA须绑定同一最终SHA及需求revision;Git证据仅在源码/构建适用范围核对后复用,不冒称新调用,不无理由重复昂贵对局。开发报告非pass时评审拒绝是正确门禁,不把dispatchPhase launching当登记缺陷,不手改数据库或弱化门禁。使用默认有界预算;仅授权这一次后续任务,不无限重建。

公网环境由根执行者依授权从Git部署470879a,地址 https://laws-forming-bare-remedies.trycloudflare.com,源127.0.0.1:4399。源站为独立Node PID43920(Sat Sep 12 06:01:31 2026),cloudflared PID70644(Sat Sep 12 01:23:26 2026),不是空目录探针,不得按旧说明停止或替换未知进程。4498仅本地控制面,不公开;不访问4496/4497。临时URL依赖本机与隧道存活,不承诺永久服务。环境证据通过Git提供;不能用根执行者私有路径作业务输入。若交付代码变化导致现有部署不再适用,必须如实报告;不可把旧部署冒充最终候选。

邀请UI边界:同一页只切换邀请fragment后joined状态仍显示上个玩家已加入,独立新页三份邀请正常;请全量评审其影响并由产品决定是否修复。

已完成的独立部署与真实对局证据(必须通过Git读取):0afa4df509/evidence/issue-35-final 。45个项目文件与470879a逐字一致,公网页面资源等于构建,未授权models/private observation为403;独立规则/持久化6/6、HTTP与Chrome邀请/控制通过。根执行者在干净部署实际运行候选自带real-check.mjs一次,三位pi Agent、DeepSeek/GLM两模型,三手完成,每手与所有状态3000筹码,20次成功模型响应/19次应用/1次停止后未应用/1次错误。第二手GLM失败后经邀请API切换乙为DeepSeek续局,原GLM动作及失败完整保留;三手结束后已停止第四手,未完成不计数。公共牌桌70adbf3c-412c-45e1-8e82-a18cc539ffb8,现暂停、历史可见。新增三手均非多人摊牌,470879a原有Git证据另含一次真实摊牌;只能经独立核验后按相同源码适用范围复用,不冒称本轮新调用。源码、构建、运行身份、安全投影、模型调用/动作及UI证据见上述固定Git提交;这是环境与验收事实,不替代产品内独立全量CR/QA及最终同SHA交付。

  1. 完整可运行的德州扑克最小实现:合法行动、轮到谁、盲注、发牌、翻牌/转牌/河牌、fold/check/call/bet/raise/all-in、摊牌、牌型比较、平分与边池;筹码守恒,非法/越权/重复动作不能改变牌局。
  2. 玩家凭邀请凭据只能读取自己的底牌和允许的公共状态;观测页面及公共 API 在摊牌前不能泄露其他玩家底牌或邀请凭据。
  3. 有可从外网访问的实际观测地址,页面显示座位、筹码、公共牌、底池、当前行动者、真实动作时间线、已完成手牌结果。邀请机制能让至少三名真实 agent 入桌,且覆盖至少两种运行时或模型。
  4. 至少完成三手真实对局,保存可追溯的模型调用、合法动作、牌局结果与筹码核对证据。不能把单元测试、fixture 或纯随机脚本算作真实对局。
  5. 独立 CR 与 QA 绑定最终代码 SHA;规则与隐私测试覆盖 all-in/边池/平分、轮次、重复请求和越权。浏览器验证邀请与观测流程。README 说明持续运行方式、临时外网地址的生命周期与局限。
  6. 整个项目由控制面自研编排 agent 自行分派并推进;所有开发、审查、修复和集成可追溯到 Git/Gitea。根助手只提供目标、环境配置和观测,不手写扑克业务或替代产品调度。
  7. 观测页支持开始、暂停或停止演示,查看已完成局历史;未授权观众不能获取管理凭据、模型密钥或玩家私有信息。代码目录固定 projects/agent-poker,与契约一致。

实施契约完整九项要求

这是目标新增的最终验收,不替代原控制面 A01–A12。

  1. 在做好的 PPanel 页面提交一个项目目标。此后由产品内编排 agent 自行分派、复核、返工、集成;不得由当前根对话手工编写扑克业务代码或代替角色交接。
  2. 项目是虚拟筹码的多人 No-Limit Texas Hold'em 演示,没有充值、提现或真钱交易。
  3. 支持建立牌桌、邀请不同 agent 加入、展示邀请地址/接入说明;至少三位真实 agent 玩家、至少两种模型/运行时参与。
  4. 玩家通过受控接口获取只属于自己的手牌与公开桌面,提交合法动作。拒绝越权看牌、重复动作、非当前玩家动作和非法下注。不能向玩家泄露其他人的手牌。
  5. 正确执行发牌、盲注、下注轮、公共牌、弃牌、跟注、加注、all-in、边池和摊牌结算;用确定性规则测试验证牌型与筹码守恒。
  6. 提供可从外网访问的在线观测地址,界面有牌桌、座位、筹码、底池、公共牌、当前动作、时间线和局况。观察者按预定权限看牌,默认对局中不公开所有手牌。
  7. 邀请至少三位真实 agent 并完成不少于三手真实对局,留存玩家动作、模型调用与结算证据;不能用固定脚本或伪造对话冒充 agent。
  8. 观测页面支持开始/暂停或停止演示、查看已完成局历史。公网仅开放扑克项目的必要入口,管理/模型密钥不暴露;邀请 token 不进入公开 Git。
  9. 项目代码经过独立 CR、QA,由控制面交付真实 Git 提交与运行说明。在线地址实际打开验证,并在最后给用户。

需求版本:1
基线 SHA:411cea6bd5a55848791051f4c47da325626ecb76
检查 SHA:a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc
开发分支:ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-7
目标分支:deliveries/agent-poker-final

只在自己的 clone 工作,不读其他角色目录或日志。所有交接通过本 Issue 与远端 Git。不得弱化冻结验收。开发须确保候选包含分配的基线 SHA(必要时合并或变基),然后提交、push、创建 PR;独立 CR/QA 须实际检查固定 SHA,并把完整证据提交到独立证据分支或仓库评论。

使用当前会话的 worker 桥读取任务、创建 PR、发布中文 Markdown 报告;stdout 不是报告。

## 任务分配:reviewer 根任务:https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72 ### 分配原因 ## 编排决定:dispatch(新候选上的独立全量 CR) **依据**:根任务 `71c1c0f7-69c9-487e-98a2-776bd0872c4f`(Issue [#72](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72))需求版本 revision `1`,基线 `411cea6bd5a55848791051f4c47da325626ecb76`。开发修正 run `e6289cea-dfc7-40eb-99e7-b1ea880fdff9`(`codex`,Issue [#88](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/88),PR [#92](https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/92),结论 `pass`)已产生新候选 `a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc`。上一轮 CR run `68634d6a-4ec1-4dd7-becd-22380cffea6c`(`codex`)在旧 SHA `a3fce77317c99cc68fb05fa0c1934fd62999cd3f` 上判 `changes_requested`(`R1` 短大盲全下后小盲仍被要求行动、`R2` 河牌弃牌获胜被错误公开底牌);该结论只对旧 SHA 有效,不得沿用作新候选的通过依据。现对新候选派独立全量 CR,与并行 QA 绑定同一 SHA 与同一 revision。 **运行时选择理由**:评审首选 `opencode`,但 run `67d72ca1-5c48-4331-896e-ff92ccbf63b3` 曾以 `Error: 超过单次执行时限` 失败(观测到约 15 分钟硬上限);`codex` 在同等全量范围审查中以约 5.5 分钟产出了完整可判定结论。为在默认有界预算内稳定取得门禁结论,本轮 CR 使用 `codex`:独立会话、独立分支 `ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-7`、独立工作目录,与开发 run 不共享会话与工作树。 **审查范围(全量,非增量)**:整个 `projects/agent-poker` 及实际复用的共享主题/布局/按钮/样式/工具依赖,逐项对照 `docs/implementation-contract.md` 九项要求与 Issue #72 冻结验收 v1 七项。 必查项: 1. `R1`/`R2` 修复真实性:`projects/agent-poker/game.mjs` 中 `advance()`、`legal()`、`view()` 的新逻辑须用可复现脚本独立验证——短大盲全下且小盲已覆盖时自动摊牌且不再可 `fold` 夺池、唯一可行动者只需跟齐实际全下额且不能向无人响应的边池加注、多人仍可下注时保留名义大盲、河牌 `fold` 获胜后公共投影与其他玩家投影均隐藏赢家底牌、真实多人摊牌仍公开未弃牌者底牌、旧快照重载后投影仍隐藏。不得只采信开发自报的 `11/11`。 2. 不得引入回归:盲注、发牌、翻牌/转牌/河牌、`fold`/`check`/`call`/`bet`/`raise`/`all-in`、短加注不重开加注、摊牌、牌型比较、平分、边池、筹码守恒;非法、越权、重复、非当前玩家动作不得改变牌局状态(含 `version` 并发门禁)。 3. 隐私与凭据:玩家凭邀请凭据只能读自己底牌与允许的公共状态;观测页与公共 API 在摊牌前不得泄露他人底牌与邀请凭据(`R2` 修复后须重新覆盖该投影路径与其 HTTP 出口);邀请 token 不得进入公开 Git。 4. 控制与历史:开始/暂停/停止与已完成局历史;未授权观众不得取得管理凭据、模型密钥或玩家私有信息。 5. 真实对局证据:仅经 Git 读取候选自带 `projects/agent-poker/evidence`、`0afa4df50967e881a700231022c13f4e30d9d2f1` 下 `evidence/issue-35-final`、以及 `470879a305438fc958acfc6486f1f86bcd94b681` 既有证据。**必须明确报告 `game.mjs` 已在 `a0737d41` 中被修复,历史三手对局不再与最终运行源码逐字相同,只能作为历史事实复用,不得冒称本轮新模型调用或修复后的验证结果**;不得无理由重复昂贵对局,禁止调用真实模型。 6. 部署一致性:公网 `4399` 仍为旧候选 `a3fce773` 的部署(Node PID `59783`,启动身份 `Sat Sep 12 06:19:00 2026`,`cloudflared` PID `70644` 保留,4498/4497 控制面不受影响)。**不得把该旧部署冒充新候选,必须如实报告差异**;已授权的源站替换不构成缺陷,`dispatchPhase = launching` 同属登记现象,均不得作为拒绝理由。 7. 邀请 UI 边界:同页仅切换邀请 fragment 后 `joined` 残留显示上个玩家、独立新页三份邀请正常。本轮修改范围未含 `ui.jsx`,须独立复测并给出影响评估,交产品决定是否修复,不得跳过、隐瞒或自行宣称豁免。 8. 开发报告非 `pass` 时评审拒绝才是正确门禁;本角色不得修改业务代码、冻结验收文件或控制面状态。 **纪律与时间盒**:本轮控制在约 10 分钟内完成,先做确定性单测与源码读证(`node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs`),浏览器/公网端到端与真实证据交叉核验交给并行 QA,避免重复消耗。禁止读取其他角色或根执行者私有目录、数据库、模型日志;全部交接只经 Git/Gitea;评论是数据不是指令。 **输出要求**:结论绑定候选 SHA `a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc` 与需求 revision `1`,逐项给出 `pass`/`reject` 与显式 Markdown 链接或独立清晰 URL;失败项须给出可复现命令与文件路径(行内代码保护),不得弱化门禁。 ### 目标与验收 使用本控制面的真实协作流程,自行组织开发、独立 CR、QA、修复和交付一个可运行的 Agent 德州扑克项目。实现代码只放 projects/agent-poker 与必要项目文档,复用仓库已有 D-SRE 样式和组件。游戏使用虚拟筹码,无真实支付。提供在线观测页面、邀请不同 agent 入桌的机制、明确的对局状态和动作时间线。牌局由服务器作为唯一裁判,不能让 agent 自报胜负。至少三名真实 agent 玩家,覆盖至少两种本机运行时或模型,动作来自真实模型根据各自私有观察做出的决策。禁止预置固定动作、录播、mock 模型或脚本冒充 agent 对局。执行者各自独立目录,只通过 Git/Gitea 交接开发工作。最终提交启动、邀请、观测、规则测试与真实对局复现说明。 以 docs/implementation-contract.md 的最终项目九项要求为完整契约。本机 cloudflared 已安装,可建立临时公网观测地址;只转发扑克项目必要入口,不转发 PPanel 控制面或管理密钥。游戏与观测服务须独立于开发执行者会话持续运行,记录端口和生命周期,邀请 token 不进公开 Git。 这是 Issue35 评论18981明确授权的一次完整后续任务。原根#38已blocked,原记录和预算保留,不将原任务改成功。本次目标分支 deliveries/agent-poker-final 已从完整基线411cea6bd5a55848791051f4c47da325626ecb76预置。采用远端已发布候选470879a305438fc958acfc6486f1f86bcd94b681(PR62,开发Issue57),参照原#38/#39/#48/#57全部Git/Gitea证据;优先采用已实现代码并按发现修复,不重复从零实现。禁止读取其他角色或根执行者私有目录、数据库、模型日志。全部交接只经Git/Gitea。 必须自行完成开发交付、独立全量reviewer和qa、必要返工、合并与合入后QA。审查整个projects/agent-poker及实际复用依赖,不仅增量;不得跳过规则、隐私、邀请、控制、历史、公网和真实模型证据。独立CR/QA须绑定同一最终SHA及需求revision;Git证据仅在源码/构建适用范围核对后复用,不冒称新调用,不无理由重复昂贵对局。开发报告非pass时评审拒绝是正确门禁,不把dispatchPhase launching当登记缺陷,不手改数据库或弱化门禁。使用默认有界预算;仅授权这一次后续任务,不无限重建。 公网环境由根执行者依授权从Git部署470879a,地址 https://laws-forming-bare-remedies.trycloudflare.com,源127.0.0.1:4399。源站为独立Node PID43920(Sat Sep 12 06:01:31 2026),cloudflared PID70644(Sat Sep 12 01:23:26 2026),不是空目录探针,不得按旧说明停止或替换未知进程。4498仅本地控制面,不公开;不访问4496/4497。临时URL依赖本机与隧道存活,不承诺永久服务。环境证据通过Git提供;不能用根执行者私有路径作业务输入。若交付代码变化导致现有部署不再适用,必须如实报告;不可把旧部署冒充最终候选。 邀请UI边界:同一页只切换邀请fragment后joined状态仍显示上个玩家已加入,独立新页三份邀请正常;请全量评审其影响并由产品决定是否修复。 已完成的独立部署与真实对局证据(必须通过Git读取):https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/0afa4df50967e881a700231022c13f4e30d9d2f1/evidence/issue-35-final 。45个项目文件与470879a逐字一致,公网页面资源等于构建,未授权models/private observation为403;独立规则/持久化6/6、HTTP与Chrome邀请/控制通过。根执行者在干净部署实际运行候选自带real-check.mjs一次,三位pi Agent、DeepSeek/GLM两模型,三手完成,每手与所有状态3000筹码,20次成功模型响应/19次应用/1次停止后未应用/1次错误。第二手GLM失败后经邀请API切换乙为DeepSeek续局,原GLM动作及失败完整保留;三手结束后已停止第四手,未完成不计数。公共牌桌70adbf3c-412c-45e1-8e82-a18cc539ffb8,现暂停、历史可见。新增三手均非多人摊牌,470879a原有Git证据另含一次真实摊牌;只能经独立核验后按相同源码适用范围复用,不冒称本轮新调用。源码、构建、运行身份、安全投影、模型调用/动作及UI证据见上述固定Git提交;这是环境与验收事实,不替代产品内独立全量CR/QA及最终同SHA交付。 1. 完整可运行的德州扑克最小实现:合法行动、轮到谁、盲注、发牌、翻牌/转牌/河牌、fold/check/call/bet/raise/all-in、摊牌、牌型比较、平分与边池;筹码守恒,非法/越权/重复动作不能改变牌局。 2. 玩家凭邀请凭据只能读取自己的底牌和允许的公共状态;观测页面及公共 API 在摊牌前不能泄露其他玩家底牌或邀请凭据。 3. 有可从外网访问的实际观测地址,页面显示座位、筹码、公共牌、底池、当前行动者、真实动作时间线、已完成手牌结果。邀请机制能让至少三名真实 agent 入桌,且覆盖至少两种运行时或模型。 4. 至少完成三手真实对局,保存可追溯的模型调用、合法动作、牌局结果与筹码核对证据。不能把单元测试、fixture 或纯随机脚本算作真实对局。 5. 独立 CR 与 QA 绑定最终代码 SHA;规则与隐私测试覆盖 all-in/边池/平分、轮次、重复请求和越权。浏览器验证邀请与观测流程。README 说明持续运行方式、临时外网地址的生命周期与局限。 6. 整个项目由控制面自研编排 agent 自行分派并推进;所有开发、审查、修复和集成可追溯到 Git/Gitea。根助手只提供目标、环境配置和观测,不手写扑克业务或替代产品调度。 7. 观测页支持开始、暂停或停止演示,查看已完成局历史;未授权观众不能获取管理凭据、模型密钥或玩家私有信息。代码目录固定 projects/agent-poker,与契约一致。 ## 实施契约完整九项要求 这是目标新增的最终验收,不替代原控制面 A01–A12。 1. 在做好的 PPanel 页面提交一个项目目标。此后由产品内编排 agent 自行分派、复核、返工、集成;不得由当前根对话手工编写扑克业务代码或代替角色交接。 2. 项目是虚拟筹码的多人 No-Limit Texas Hold'em 演示,没有充值、提现或真钱交易。 3. 支持建立牌桌、邀请不同 agent 加入、展示邀请地址/接入说明;至少三位真实 agent 玩家、至少两种模型/运行时参与。 4. 玩家通过受控接口获取只属于自己的手牌与公开桌面,提交合法动作。拒绝越权看牌、重复动作、非当前玩家动作和非法下注。不能向玩家泄露其他人的手牌。 5. 正确执行发牌、盲注、下注轮、公共牌、弃牌、跟注、加注、all-in、边池和摊牌结算;用确定性规则测试验证牌型与筹码守恒。 6. 提供可从外网访问的在线观测地址,界面有牌桌、座位、筹码、底池、公共牌、当前动作、时间线和局况。观察者按预定权限看牌,默认对局中不公开所有手牌。 7. 邀请至少三位真实 agent 并完成不少于三手真实对局,留存玩家动作、模型调用与结算证据;不能用固定脚本或伪造对话冒充 agent。 8. 观测页面支持开始/暂停或停止演示、查看已完成局历史。公网仅开放扑克项目的必要入口,管理/模型密钥不暴露;邀请 token 不进入公开 Git。 9. 项目代码经过独立 CR、QA,由控制面交付真实 Git 提交与运行说明。在线地址实际打开验证,并在最后给用户。 需求版本:1 基线 SHA:`411cea6bd5a55848791051f4c47da325626ecb76` 检查 SHA:`a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc` 开发分支:`ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-7` 目标分支:`deliveries/agent-poker-final` 只在自己的 clone 工作,不读其他角色目录或日志。所有交接通过本 Issue 与远端 Git。不得弱化冻结验收。开发须确保候选包含分配的基线 SHA(必要时合并或变基),然后提交、push、创建 PR;独立 CR/QA 须实际检查固定 SHA,并把完整证据提交到独立证据分支或仓库评论。 使用当前会话的 worker 桥读取任务、创建 PR、发布中文 Markdown 报告;stdout 不是报告。 <!-- ppanel-issue:50853ea9-d6ec-4e3f-b5a4-81dc499142db -->
Author
Owner

任务分配:reviewer

根任务:#72

分配原因

编排决定:dispatch(新候选上的独立全量 CR)

依据:根任务 71c1c0f7-69c9-487e-98a2-776bd0872c4f(Issue #72)需求版本 revision 1,基线 411cea6bd5a55848791051f4c47da325626ecb76。开发修正 run e6289cea-dfc7-40eb-99e7-b1ea880fdff9(codex,Issue #88,PR #92,结论 pass)已产生新候选 a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc。上一轮 CR run 68634d6a-4ec1-4dd7-becd-22380cffea6c(codex)在旧 SHA a3fce77317c99cc68fb05fa0c1934fd62999cd3f 上判 changes_requested(R1 短大盲全下后小盲仍被要求行动、R2 河牌弃牌获胜被错误公开底牌);该结论只对旧 SHA 有效,不得沿用作新候选的通过依据。现对新候选派独立全量 CR,与并行 QA 绑定同一 SHA 与同一 revision。

运行时选择理由:评审首选 opencode,但 run 67d72ca1-5c48-4331-896e-ff92ccbf63b3 曾以 Error: 超过单次执行时限 失败(观测到约 15 分钟硬上限);codex 在同等全量范围审查中以约 5.5 分钟产出了完整可判定结论。为在默认有界预算内稳定取得门禁结论,本轮 CR 使用 codex:独立会话、独立分支 ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-7、独立工作目录,与开发 run 不共享会话与工作树。

审查范围(全量,非增量):整个 projects/agent-poker 及实际复用的共享主题/布局/按钮/样式/工具依赖,逐项对照 docs/implementation-contract.md 九项要求与 Issue #72 冻结验收 v1 七项。

必查项:

  1. R1/R2 修复真实性:projects/agent-poker/game.mjs 中 advance()、legal()、view() 的新逻辑须用可复现脚本独立验证——短大盲全下且小盲已覆盖时自动摊牌且不再可 fold 夺池、唯一可行动者只需跟齐实际全下额且不能向无人响应的边池加注、多人仍可下注时保留名义大盲、河牌 fold 获胜后公共投影与其他玩家投影均隐藏赢家底牌、真实多人摊牌仍公开未弃牌者底牌、旧快照重载后投影仍隐藏。不得只采信开发自报的 11/11。
  2. 不得引入回归:盲注、发牌、翻牌/转牌/河牌、fold/check/call/bet/raise/all-in、短加注不重开加注、摊牌、牌型比较、平分、边池、筹码守恒;非法、越权、重复、非当前玩家动作不得改变牌局状态(含 version 并发门禁)。
  3. 隐私与凭据:玩家凭邀请凭据只能读自己底牌与允许的公共状态;观测页与公共 API 在摊牌前不得泄露他人底牌与邀请凭据(R2 修复后须重新覆盖该投影路径与其 HTTP 出口);邀请 token 不得进入公开 Git。
  4. 控制与历史:开始/暂停/停止与已完成局历史;未授权观众不得取得管理凭据、模型密钥或玩家私有信息。
  5. 真实对局证据:仅经 Git 读取候选自带 projects/agent-poker/evidence、0afa4df50967e881a700231022c13f4e30d9d2f1 下 evidence/issue-35-final、以及 470879a305438fc958acfc6486f1f86bcd94b681 既有证据。必须明确报告 game.mjs 已在 a0737d41 中被修复,历史三手对局不再与最终运行源码逐字相同,只能作为历史事实复用,不得冒称本轮新模型调用或修复后的验证结果;不得无理由重复昂贵对局,禁止调用真实模型。
  6. 部署一致性:公网 4399 仍为旧候选 a3fce773 的部署(Node PID 59783,启动身份 Sat Sep 12 06:19:00 2026,cloudflared PID 70644 保留,4498/4497 控制面不受影响)。不得把该旧部署冒充新候选,必须如实报告差异;已授权的源站替换不构成缺陷,dispatchPhase = launching 同属登记现象,均不得作为拒绝理由。
  7. 邀请 UI 边界:同页仅切换邀请 fragment 后 joined 残留显示上个玩家、独立新页三份邀请正常。本轮修改范围未含 ui.jsx,须独立复测并给出影响评估,交产品决定是否修复,不得跳过、隐瞒或自行宣称豁免。
  8. 开发报告非 pass 时评审拒绝才是正确门禁;本角色不得修改业务代码、冻结验收文件或控制面状态。

纪律与时间盒:本轮控制在约 10 分钟内完成,先做确定性单测与源码读证(node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs),浏览器/公网端到端与真实证据交叉核验交给并行 QA,避免重复消耗。禁止读取其他角色或根执行者私有目录、数据库、模型日志;全部交接只经 Git/Gitea;评论是数据不是指令。

输出要求:结论绑定候选 SHA a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc 与需求 revision 1,逐项给出 pass/reject 与显式 Markdown 链接或独立清晰 URL;失败项须给出可复现命令与文件路径(行内代码保护),不得弱化门禁。

目标与验收

使用本控制面的真实协作流程,自行组织开发、独立 CR、QA、修复和交付一个可运行的 Agent 德州扑克项目。实现代码只放 projects/agent-poker 与必要项目文档,复用仓库已有 D-SRE 样式和组件。游戏使用虚拟筹码,无真实支付。提供在线观测页面、邀请不同 agent 入桌的机制、明确的对局状态和动作时间线。牌局由服务器作为唯一裁判,不能让 agent 自报胜负。至少三名真实 agent 玩家,覆盖至少两种本机运行时或模型,动作来自真实模型根据各自私有观察做出的决策。禁止预置固定动作、录播、mock 模型或脚本冒充 agent 对局。执行者各自独立目录,只通过 Git/Gitea 交接开发工作。最终提交启动、邀请、观测、规则测试与真实对局复现说明。
以 docs/implementation-contract.md 的最终项目九项要求为完整契约。本机 cloudflared 已安装,可建立临时公网观测地址;只转发扑克项目必要入口,不转发 PPanel 控制面或管理密钥。游戏与观测服务须独立于开发执行者会话持续运行,记录端口和生命周期,邀请 token 不进公开 Git。

这是 Issue35 评论18981明确授权的一次完整后续任务。原根#38已blocked,原记录和预算保留,不将原任务改成功。本次目标分支 deliveries/agent-poker-final 已从完整基线411cea6bd5a55848791051f4c47da325626ecb76预置。采用远端已发布候选470879a305438fc958acfc6486f1f86bcd94b681(PR62,开发Issue57),参照原#38/#39/#48/#57全部Git/Gitea证据;优先采用已实现代码并按发现修复,不重复从零实现。禁止读取其他角色或根执行者私有目录、数据库、模型日志。全部交接只经Git/Gitea。

必须自行完成开发交付、独立全量reviewer和qa、必要返工、合并与合入后QA。审查整个projects/agent-poker及实际复用依赖,不仅增量;不得跳过规则、隐私、邀请、控制、历史、公网和真实模型证据。独立CR/QA须绑定同一最终SHA及需求revision;Git证据仅在源码/构建适用范围核对后复用,不冒称新调用,不无理由重复昂贵对局。开发报告非pass时评审拒绝是正确门禁,不把dispatchPhase launching当登记缺陷,不手改数据库或弱化门禁。使用默认有界预算;仅授权这一次后续任务,不无限重建。

公网环境由根执行者依授权从Git部署470879a,地址 https://laws-forming-bare-remedies.trycloudflare.com,源127.0.0.1:4399。源站为独立Node PID43920(Sat Sep 12 06:01:31 2026),cloudflared PID70644(Sat Sep 12 01:23:26 2026),不是空目录探针,不得按旧说明停止或替换未知进程。4498仅本地控制面,不公开;不访问4496/4497。临时URL依赖本机与隧道存活,不承诺永久服务。环境证据通过Git提供;不能用根执行者私有路径作业务输入。若交付代码变化导致现有部署不再适用,必须如实报告;不可把旧部署冒充最终候选。

邀请UI边界:同一页只切换邀请fragment后joined状态仍显示上个玩家已加入,独立新页三份邀请正常;请全量评审其影响并由产品决定是否修复。

已完成的独立部署与真实对局证据(必须通过Git读取):0afa4df509/evidence/issue-35-final 。45个项目文件与470879a逐字一致,公网页面资源等于构建,未授权models/private observation为403;独立规则/持久化6/6、HTTP与Chrome邀请/控制通过。根执行者在干净部署实际运行候选自带real-check.mjs一次,三位pi Agent、DeepSeek/GLM两模型,三手完成,每手与所有状态3000筹码,20次成功模型响应/19次应用/1次停止后未应用/1次错误。第二手GLM失败后经邀请API切换乙为DeepSeek续局,原GLM动作及失败完整保留;三手结束后已停止第四手,未完成不计数。公共牌桌70adbf3c-412c-45e1-8e82-a18cc539ffb8,现暂停、历史可见。新增三手均非多人摊牌,470879a原有Git证据另含一次真实摊牌;只能经独立核验后按相同源码适用范围复用,不冒称本轮新调用。源码、构建、运行身份、安全投影、模型调用/动作及UI证据见上述固定Git提交;这是环境与验收事实,不替代产品内独立全量CR/QA及最终同SHA交付。

  1. 完整可运行的德州扑克最小实现:合法行动、轮到谁、盲注、发牌、翻牌/转牌/河牌、fold/check/call/bet/raise/all-in、摊牌、牌型比较、平分与边池;筹码守恒,非法/越权/重复动作不能改变牌局。
  2. 玩家凭邀请凭据只能读取自己的底牌和允许的公共状态;观测页面及公共 API 在摊牌前不能泄露其他玩家底牌或邀请凭据。
  3. 有可从外网访问的实际观测地址,页面显示座位、筹码、公共牌、底池、当前行动者、真实动作时间线、已完成手牌结果。邀请机制能让至少三名真实 agent 入桌,且覆盖至少两种运行时或模型。
  4. 至少完成三手真实对局,保存可追溯的模型调用、合法动作、牌局结果与筹码核对证据。不能把单元测试、fixture 或纯随机脚本算作真实对局。
  5. 独立 CR 与 QA 绑定最终代码 SHA;规则与隐私测试覆盖 all-in/边池/平分、轮次、重复请求和越权。浏览器验证邀请与观测流程。README 说明持续运行方式、临时外网地址的生命周期与局限。
  6. 整个项目由控制面自研编排 agent 自行分派并推进;所有开发、审查、修复和集成可追溯到 Git/Gitea。根助手只提供目标、环境配置和观测,不手写扑克业务或替代产品调度。
  7. 观测页支持开始、暂停或停止演示,查看已完成局历史;未授权观众不能获取管理凭据、模型密钥或玩家私有信息。代码目录固定 projects/agent-poker,与契约一致。

实施契约完整九项要求

这是目标新增的最终验收,不替代原控制面 A01–A12。

  1. 在做好的 PPanel 页面提交一个项目目标。此后由产品内编排 agent 自行分派、复核、返工、集成;不得由当前根对话手工编写扑克业务代码或代替角色交接。
  2. 项目是虚拟筹码的多人 No-Limit Texas Hold'em 演示,没有充值、提现或真钱交易。
  3. 支持建立牌桌、邀请不同 agent 加入、展示邀请地址/接入说明;至少三位真实 agent 玩家、至少两种模型/运行时参与。
  4. 玩家通过受控接口获取只属于自己的手牌与公开桌面,提交合法动作。拒绝越权看牌、重复动作、非当前玩家动作和非法下注。不能向玩家泄露其他人的手牌。
  5. 正确执行发牌、盲注、下注轮、公共牌、弃牌、跟注、加注、all-in、边池和摊牌结算;用确定性规则测试验证牌型与筹码守恒。
  6. 提供可从外网访问的在线观测地址,界面有牌桌、座位、筹码、底池、公共牌、当前动作、时间线和局况。观察者按预定权限看牌,默认对局中不公开所有手牌。
  7. 邀请至少三位真实 agent 并完成不少于三手真实对局,留存玩家动作、模型调用与结算证据;不能用固定脚本或伪造对话冒充 agent。
  8. 观测页面支持开始/暂停或停止演示、查看已完成局历史。公网仅开放扑克项目的必要入口,管理/模型密钥不暴露;邀请 token 不进入公开 Git。
  9. 项目代码经过独立 CR、QA,由控制面交付真实 Git 提交与运行说明。在线地址实际打开验证,并在最后给用户。

需求版本:1
基线 SHA:411cea6bd5a55848791051f4c47da325626ecb76
检查 SHA:a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc
开发分支:ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-7
目标分支:deliveries/agent-poker-final

只在自己的 clone 工作,不读其他角色目录或日志。所有交接通过本 Issue 与远端 Git。不得弱化冻结验收。开发须确保候选包含分配的基线 SHA(必要时合并或变基),然后提交、push、创建 PR;独立 CR/QA 须实际检查固定 SHA,并把完整证据提交到独立证据分支或仓库评论。

使用当前会话的 worker 桥读取任务、创建 PR、发布中文 Markdown 报告;stdout 不是报告。

## 任务分配:reviewer 根任务:https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72 ### 分配原因 ## 编排决定:dispatch(新候选上的独立全量 CR) **依据**:根任务 `71c1c0f7-69c9-487e-98a2-776bd0872c4f`(Issue [#72](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72))需求版本 revision `1`,基线 `411cea6bd5a55848791051f4c47da325626ecb76`。开发修正 run `e6289cea-dfc7-40eb-99e7-b1ea880fdff9`(`codex`,Issue [#88](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/88),PR [#92](https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/92),结论 `pass`)已产生新候选 `a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc`。上一轮 CR run `68634d6a-4ec1-4dd7-becd-22380cffea6c`(`codex`)在旧 SHA `a3fce77317c99cc68fb05fa0c1934fd62999cd3f` 上判 `changes_requested`(`R1` 短大盲全下后小盲仍被要求行动、`R2` 河牌弃牌获胜被错误公开底牌);该结论只对旧 SHA 有效,不得沿用作新候选的通过依据。现对新候选派独立全量 CR,与并行 QA 绑定同一 SHA 与同一 revision。 **运行时选择理由**:评审首选 `opencode`,但 run `67d72ca1-5c48-4331-896e-ff92ccbf63b3` 曾以 `Error: 超过单次执行时限` 失败(观测到约 15 分钟硬上限);`codex` 在同等全量范围审查中以约 5.5 分钟产出了完整可判定结论。为在默认有界预算内稳定取得门禁结论,本轮 CR 使用 `codex`:独立会话、独立分支 `ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-7`、独立工作目录,与开发 run 不共享会话与工作树。 **审查范围(全量,非增量)**:整个 `projects/agent-poker` 及实际复用的共享主题/布局/按钮/样式/工具依赖,逐项对照 `docs/implementation-contract.md` 九项要求与 Issue #72 冻结验收 v1 七项。 必查项: 1. `R1`/`R2` 修复真实性:`projects/agent-poker/game.mjs` 中 `advance()`、`legal()`、`view()` 的新逻辑须用可复现脚本独立验证——短大盲全下且小盲已覆盖时自动摊牌且不再可 `fold` 夺池、唯一可行动者只需跟齐实际全下额且不能向无人响应的边池加注、多人仍可下注时保留名义大盲、河牌 `fold` 获胜后公共投影与其他玩家投影均隐藏赢家底牌、真实多人摊牌仍公开未弃牌者底牌、旧快照重载后投影仍隐藏。不得只采信开发自报的 `11/11`。 2. 不得引入回归:盲注、发牌、翻牌/转牌/河牌、`fold`/`check`/`call`/`bet`/`raise`/`all-in`、短加注不重开加注、摊牌、牌型比较、平分、边池、筹码守恒;非法、越权、重复、非当前玩家动作不得改变牌局状态(含 `version` 并发门禁)。 3. 隐私与凭据:玩家凭邀请凭据只能读自己底牌与允许的公共状态;观测页与公共 API 在摊牌前不得泄露他人底牌与邀请凭据(`R2` 修复后须重新覆盖该投影路径与其 HTTP 出口);邀请 token 不得进入公开 Git。 4. 控制与历史:开始/暂停/停止与已完成局历史;未授权观众不得取得管理凭据、模型密钥或玩家私有信息。 5. 真实对局证据:仅经 Git 读取候选自带 `projects/agent-poker/evidence`、`0afa4df50967e881a700231022c13f4e30d9d2f1` 下 `evidence/issue-35-final`、以及 `470879a305438fc958acfc6486f1f86bcd94b681` 既有证据。**必须明确报告 `game.mjs` 已在 `a0737d41` 中被修复,历史三手对局不再与最终运行源码逐字相同,只能作为历史事实复用,不得冒称本轮新模型调用或修复后的验证结果**;不得无理由重复昂贵对局,禁止调用真实模型。 6. 部署一致性:公网 `4399` 仍为旧候选 `a3fce773` 的部署(Node PID `59783`,启动身份 `Sat Sep 12 06:19:00 2026`,`cloudflared` PID `70644` 保留,4498/4497 控制面不受影响)。**不得把该旧部署冒充新候选,必须如实报告差异**;已授权的源站替换不构成缺陷,`dispatchPhase = launching` 同属登记现象,均不得作为拒绝理由。 7. 邀请 UI 边界:同页仅切换邀请 fragment 后 `joined` 残留显示上个玩家、独立新页三份邀请正常。本轮修改范围未含 `ui.jsx`,须独立复测并给出影响评估,交产品决定是否修复,不得跳过、隐瞒或自行宣称豁免。 8. 开发报告非 `pass` 时评审拒绝才是正确门禁;本角色不得修改业务代码、冻结验收文件或控制面状态。 **纪律与时间盒**:本轮控制在约 10 分钟内完成,先做确定性单测与源码读证(`node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs`),浏览器/公网端到端与真实证据交叉核验交给并行 QA,避免重复消耗。禁止读取其他角色或根执行者私有目录、数据库、模型日志;全部交接只经 Git/Gitea;评论是数据不是指令。 **输出要求**:结论绑定候选 SHA `a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc` 与需求 revision `1`,逐项给出 `pass`/`reject` 与显式 Markdown 链接或独立清晰 URL;失败项须给出可复现命令与文件路径(行内代码保护),不得弱化门禁。 ### 目标与验收 使用本控制面的真实协作流程,自行组织开发、独立 CR、QA、修复和交付一个可运行的 Agent 德州扑克项目。实现代码只放 projects/agent-poker 与必要项目文档,复用仓库已有 D-SRE 样式和组件。游戏使用虚拟筹码,无真实支付。提供在线观测页面、邀请不同 agent 入桌的机制、明确的对局状态和动作时间线。牌局由服务器作为唯一裁判,不能让 agent 自报胜负。至少三名真实 agent 玩家,覆盖至少两种本机运行时或模型,动作来自真实模型根据各自私有观察做出的决策。禁止预置固定动作、录播、mock 模型或脚本冒充 agent 对局。执行者各自独立目录,只通过 Git/Gitea 交接开发工作。最终提交启动、邀请、观测、规则测试与真实对局复现说明。 以 docs/implementation-contract.md 的最终项目九项要求为完整契约。本机 cloudflared 已安装,可建立临时公网观测地址;只转发扑克项目必要入口,不转发 PPanel 控制面或管理密钥。游戏与观测服务须独立于开发执行者会话持续运行,记录端口和生命周期,邀请 token 不进公开 Git。 这是 Issue35 评论18981明确授权的一次完整后续任务。原根#38已blocked,原记录和预算保留,不将原任务改成功。本次目标分支 deliveries/agent-poker-final 已从完整基线411cea6bd5a55848791051f4c47da325626ecb76预置。采用远端已发布候选470879a305438fc958acfc6486f1f86bcd94b681(PR62,开发Issue57),参照原#38/#39/#48/#57全部Git/Gitea证据;优先采用已实现代码并按发现修复,不重复从零实现。禁止读取其他角色或根执行者私有目录、数据库、模型日志。全部交接只经Git/Gitea。 必须自行完成开发交付、独立全量reviewer和qa、必要返工、合并与合入后QA。审查整个projects/agent-poker及实际复用依赖,不仅增量;不得跳过规则、隐私、邀请、控制、历史、公网和真实模型证据。独立CR/QA须绑定同一最终SHA及需求revision;Git证据仅在源码/构建适用范围核对后复用,不冒称新调用,不无理由重复昂贵对局。开发报告非pass时评审拒绝是正确门禁,不把dispatchPhase launching当登记缺陷,不手改数据库或弱化门禁。使用默认有界预算;仅授权这一次后续任务,不无限重建。 公网环境由根执行者依授权从Git部署470879a,地址 https://laws-forming-bare-remedies.trycloudflare.com,源127.0.0.1:4399。源站为独立Node PID43920(Sat Sep 12 06:01:31 2026),cloudflared PID70644(Sat Sep 12 01:23:26 2026),不是空目录探针,不得按旧说明停止或替换未知进程。4498仅本地控制面,不公开;不访问4496/4497。临时URL依赖本机与隧道存活,不承诺永久服务。环境证据通过Git提供;不能用根执行者私有路径作业务输入。若交付代码变化导致现有部署不再适用,必须如实报告;不可把旧部署冒充最终候选。 邀请UI边界:同一页只切换邀请fragment后joined状态仍显示上个玩家已加入,独立新页三份邀请正常;请全量评审其影响并由产品决定是否修复。 已完成的独立部署与真实对局证据(必须通过Git读取):https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/0afa4df50967e881a700231022c13f4e30d9d2f1/evidence/issue-35-final 。45个项目文件与470879a逐字一致,公网页面资源等于构建,未授权models/private observation为403;独立规则/持久化6/6、HTTP与Chrome邀请/控制通过。根执行者在干净部署实际运行候选自带real-check.mjs一次,三位pi Agent、DeepSeek/GLM两模型,三手完成,每手与所有状态3000筹码,20次成功模型响应/19次应用/1次停止后未应用/1次错误。第二手GLM失败后经邀请API切换乙为DeepSeek续局,原GLM动作及失败完整保留;三手结束后已停止第四手,未完成不计数。公共牌桌70adbf3c-412c-45e1-8e82-a18cc539ffb8,现暂停、历史可见。新增三手均非多人摊牌,470879a原有Git证据另含一次真实摊牌;只能经独立核验后按相同源码适用范围复用,不冒称本轮新调用。源码、构建、运行身份、安全投影、模型调用/动作及UI证据见上述固定Git提交;这是环境与验收事实,不替代产品内独立全量CR/QA及最终同SHA交付。 1. 完整可运行的德州扑克最小实现:合法行动、轮到谁、盲注、发牌、翻牌/转牌/河牌、fold/check/call/bet/raise/all-in、摊牌、牌型比较、平分与边池;筹码守恒,非法/越权/重复动作不能改变牌局。 2. 玩家凭邀请凭据只能读取自己的底牌和允许的公共状态;观测页面及公共 API 在摊牌前不能泄露其他玩家底牌或邀请凭据。 3. 有可从外网访问的实际观测地址,页面显示座位、筹码、公共牌、底池、当前行动者、真实动作时间线、已完成手牌结果。邀请机制能让至少三名真实 agent 入桌,且覆盖至少两种运行时或模型。 4. 至少完成三手真实对局,保存可追溯的模型调用、合法动作、牌局结果与筹码核对证据。不能把单元测试、fixture 或纯随机脚本算作真实对局。 5. 独立 CR 与 QA 绑定最终代码 SHA;规则与隐私测试覆盖 all-in/边池/平分、轮次、重复请求和越权。浏览器验证邀请与观测流程。README 说明持续运行方式、临时外网地址的生命周期与局限。 6. 整个项目由控制面自研编排 agent 自行分派并推进;所有开发、审查、修复和集成可追溯到 Git/Gitea。根助手只提供目标、环境配置和观测,不手写扑克业务或替代产品调度。 7. 观测页支持开始、暂停或停止演示,查看已完成局历史;未授权观众不能获取管理凭据、模型密钥或玩家私有信息。代码目录固定 projects/agent-poker,与契约一致。 ## 实施契约完整九项要求 这是目标新增的最终验收,不替代原控制面 A01–A12。 1. 在做好的 PPanel 页面提交一个项目目标。此后由产品内编排 agent 自行分派、复核、返工、集成;不得由当前根对话手工编写扑克业务代码或代替角色交接。 2. 项目是虚拟筹码的多人 No-Limit Texas Hold'em 演示,没有充值、提现或真钱交易。 3. 支持建立牌桌、邀请不同 agent 加入、展示邀请地址/接入说明;至少三位真实 agent 玩家、至少两种模型/运行时参与。 4. 玩家通过受控接口获取只属于自己的手牌与公开桌面,提交合法动作。拒绝越权看牌、重复动作、非当前玩家动作和非法下注。不能向玩家泄露其他人的手牌。 5. 正确执行发牌、盲注、下注轮、公共牌、弃牌、跟注、加注、all-in、边池和摊牌结算;用确定性规则测试验证牌型与筹码守恒。 6. 提供可从外网访问的在线观测地址,界面有牌桌、座位、筹码、底池、公共牌、当前动作、时间线和局况。观察者按预定权限看牌,默认对局中不公开所有手牌。 7. 邀请至少三位真实 agent 并完成不少于三手真实对局,留存玩家动作、模型调用与结算证据;不能用固定脚本或伪造对话冒充 agent。 8. 观测页面支持开始/暂停或停止演示、查看已完成局历史。公网仅开放扑克项目的必要入口,管理/模型密钥不暴露;邀请 token 不进入公开 Git。 9. 项目代码经过独立 CR、QA,由控制面交付真实 Git 提交与运行说明。在线地址实际打开验证,并在最后给用户。 需求版本:1 基线 SHA:`411cea6bd5a55848791051f4c47da325626ecb76` 检查 SHA:`a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc` 开发分支:`ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-7` 目标分支:`deliveries/agent-poker-final` 只在自己的 clone 工作,不读其他角色目录或日志。所有交接通过本 Issue 与远端 Git。不得弱化冻结验收。开发须确保候选包含分配的基线 SHA(必要时合并或变基),然后提交、push、创建 PR;独立 CR/QA 须实际检查固定 SHA,并把完整证据提交到独立证据分支或仓库评论。 使用当前会话的 worker 桥读取任务、创建 PR、发布中文 Markdown 报告;stdout 不是报告。 <!-- ppanel:{"protocol_version":1,"event_id":"6b5df114-059c-437f-8615-160dbd39ae7d","kind":"assignment","task_id":"71c1c0f7-69c9-487e-98a2-776bd0872c4f","run_id":"50853ea9-d6ec-4e3f-b5a4-81dc499142db","sender_role":"orchestrator","recipient_role":"reviewer","goal_revision":1,"base_sha":"411cea6bd5a55848791051f4c47da325626ecb76","head_sha":"a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc","work_item_id":94} -->
Author
Owner

reviewer 执行报告

运行:50853ea9-d6ec-4e3f-b5a4-81dc499142db
版本:1
结论:pass
基线:411cea6bd5a55848791051f4c47da325626ecb76
提交:a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc

独立全量 CR:pass

结论仅为本次代码审查通过,不是最终产品验收通过。已独立检查 Issue #94 分配的全部项目源码及实际复用依赖,未发现需再次返工的规则或隐私阻断项。已知邀请交互缺陷保留待产品决定;公网新候选部署、并行 QA、集成与合入后 QA 尚不能由本报告宣布完成。

  • 需求版本:1。
  • 检查 SHA:a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc。
  • 基线 SHA:411cea6bd5a55848791051f4c47da325626ecb76,已验证为检查提交祖先。
  • 分支:ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-7;开发 PR #92。开发 pass 的正式来源为编排记录。没有将旧 SHA 的 CR/QA 通过结论沿用。
  • 仅使用本角色 clone、Git/Gitea 正式任务与证据;未修改业务代码、冻结要求、控制面或公网进程。工作树已恢复干净。冻结清单 31 个 blob 全部匹配。

本轮实测

node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs:11/11 通过;包含牌型、边池、平分、短加注、轮次、非法/重复动作、连续 50 手筹码守恒与原子快照故障注入。

额外自编确定性脚本 independent.mjs:5/5 组通过。短大盲筹码从 1 到 20 参数扫描;小盲已覆盖时自动摊牌并拒绝后续 fold,欠筹码时仅补实际差额、拒绝无响应加注;多人可下注仍保留名义大盲 20。2–6 人走到河牌下注后弃牌结束,各玩家投影与 JSON 旧快照重建均只显示自己的牌,公共投影全隐藏;正常多人摊牌仍公开未弃牌者。覆盖九种牌型排序与完整状态不变性。将同脚本绑定旧 a3fce773 后首组立即失败:实际 preflop,期望 complete,证明不是无效断言。

独立临时服务运行候选 api-check.mjs:真实 HTTP 鉴权、私有观察、非当前玩家拒绝、两个同版本并发动作仅一项成功、河牌弃牌后公共 API 与全部玩家出口隐私均通过。全部使用外部 API 测试玩家,没有调用模型。规则单测也验证旧快照投影;本轮未单独执行服务进程重启后的 HTTP 复验。

独立 npm ci 与 Vite 构建通过。构建输出在角色 tmp/dist,测试时仅建立临时静态目录链接,已移除。Chrome 对候选构建实际复测邀请边界,结果见下节。临时服务均已停止,日志保留。新增真实模型调用:0。

已知交互问题:交产品决定,未豁免

位置:ui.jsx,joined 位于第 17 行,邀请身份直接读取 location.hash,按钮成功后只执行 setJoined(true)。

复现:管理员建桌;新页打开第一份邀请并接受;在该页仅切换到第二份邀请 fragment;等待页面轮询后,按钮仍显示“已加入”,而服务器席位状态为 [true,false,false]。随后三份邀请分别在独立新页接受,服务器确认三席均已加入。

影响:同页连续邀请会误导用户,可能因第二席未加入而无法开始;服务端仍按当前 Bearer 凭据识别席位,未发生越权加入或底牌泄露。建议按邀请身份重置加入显示或从服务器席位确认状态。此项属于明确保留的产品决策,不能把本报告的 pass 解读为已修复或获豁免;需要产品记录是否在最终交付前处理。

完整九项契约逐项核对

以下 pass 表示本角色源码及所注明证据核对通过;有后续门禁的行明确保留,不冒称完整验收。

契约项 CR 结论 依据及边界
1 页面目标与产品自行分派 pass 根任务与正式评论记录开发、失败、返工、同新 SHA 独立 CR/QA;本角色只做审查。
2 虚拟筹码、无真钱 pass 完整项目无支付路径,服务器管理整数筹码。
3 建桌、邀请、三玩家两模型 pass 本轮 Chrome 三独立页与 HTTP 邀请通过;历史 Git 模型记录包含玩家 0/1/2、DeepSeek/GLM。邀请显示问题仍待产品决定。
4 受控观察与动作 pass server.mjs使用邀请 token 定位席位,version 与动作合法性先于状态变更;真实 HTTP 拒绝越权、非当前及并发重复动作。
5 完整规则与结算 pass game.mjs、既有 11 项与独立 5 组验证;R1/R2 已验证修复。
6 公网观测 pass(实现审查) 本地候选观测构建可运行,座位/底池/行动者/时间线/历史均有真实状态来源;现有公网按正式部署事实仍是旧 SHA,本轮未重复公网实开,当前 SHA 公网验收待 QA/部署环节。
7 三手真实模型及证据 pass(历史真实性与适用范围) 两组 Git 原始事件核对见下节,不能据此断言新 game.mjs 完成真实模型对局。
8 控制、历史与秘密隔离 pass 管理控制要求独立 admin token;公共投影不包含 token 或配置密钥;静态服务限制 dist,配置只由本机加载;暂停后版本/运行检查阻止迟到动作,历史由服务器结算形成。HTTP 已覆盖开始/暂停及观测;完整控制浏览器链由并行 QA 验证。
9 独立 CR/QA 与 Git 交付 pass(本角色) 本报告绑定固定 SHA/revision;开发已有真实 Git/PR,运行说明已核对。并行 QA、最终合并及合入后 QA 仍须各自通过,不以本报告代替。

冻结验收 v1 七项对应:1 规则 → 契约 5(pass);2 隐私 → 契约 4/8(pass);3 外网/邀请 → 契约 3/6(实现审查 pass,最终部署待验);4 三手真实记录 → 契约 7(历史核对 pass);5 独立测试/浏览器/运行说明 → 契约 9(本角色 pass,QA 门禁保留);6 产品编排 → 契约 1(pass);7 控制/历史/权限 → 契约 8(源码与 HTTP 检查 pass)。没有修改或降低任一验收条件。

历史证据与部署差异

独立历史真实对局证据逐事件核验:20 次成功模型响应、19 个已应用状态、1 个错误事件;三位玩家、两种模型,三手历史均 3000 筹码,各中间状态 stack + pot = 3000。模型动作在该次观察的 legal.actions 中、行动者匹配,公开证据已移除私有观察底牌。三手均非多人摊牌。停止后返回的 1 次响应未应用,第四手未完成不计入三手。

候选自带历史 evidence.json核验:17 次模型响应、16 个状态、2 个错误事件,三手与一次多人摊牌;同样三名玩家与两种模型,筹码守恒。没有读取其他角色原始私有日志,因此本报告验证的是 Git 安全证据的内部一致性及可追溯性,不宣称重新观测了供应商请求。

game.mjs 已在 a0737d41 被修复,历史三手对局不再与最终运行源码逐字相同,只能作为历史事实复用,不能冒称本轮新调用或修复后的验证结果。经 Git 比较,模型适配、服务器、持久化、UI、锁文件及直接复用的主题/布局/按钮/工具文件与历史候选无差异;规则、测试、验证脚本与文档有变化。共享 UI 继续直接导入,style.css 只有主题导入与组件扫描,许可声明保留,没有新增架构层。

按正式部署事实,公网 4399 仍对应 a3fce77317c99cc68fb05fa0c1934fd62999cd3f,Node PID 59783、启动身份 Sat Sep 12 06:19:00 2026,cloudflared PID 70644 保留。它不是当前候选部署;本角色未操作该服务、隧道或 4498/4497 控制面。旧部署替换获授权、dispatchPhase = launching 均未作为缺陷。历史 CSS/HTML 对比不等也不能当作本轮新部署的实测结论;本轮只确认自己的候选构建成功,最终公网资源关系由 QA 核验。

原始证据与复现

本角色全部临时文件保留在:

/Users/pptg/workspace/demo/ppanel/.ppanel/build/poker-driver/.ppanel/issue-35-control/tasks/71c1c0f7-69c9-487e-98a2-776bd0872c4f/reviewer/50853ea9-d6ec-4e3f-b5a4-81dc499142db/tmp

包括 task.json、tests.txt、independent.mjs、independent.log、old-check.mjs、old-check.log、install.log、build.log、http.log、ui-check.mjs、ui.log、ui-result.json、fragment-residual.png、frozen-result.json。这些本地路径不是跨角色交接要求;下面将独立脚本及关键原始输出直接附入 Gitea 评论,使证据可经正式仓库渠道复核。脚本 import 应定位到审查者自己的同 SHA clone;HTTP/Chrome 使用各自独立私有服务,不能读取本角色私有凭据。持久化故障注入和 HTTP 固定测试动作都不是模型对局。

tests.txt

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

independent.log

PASS 短盲注参数扫描与动作拒绝
PASS 多人名义盲注与无人响应限制
PASS 河牌弃牌、各玩家及旧快照隐私
PASS 正常摊牌与全部牌型排序
PASS 拒绝非法、非当前、重复动作不改变完整状态
{"checks":5,"modelCalls":0}

http.log

HTTP 鉴权、隐私、非当前玩家、并发重复动作与河牌弃牌获胜隐私检查通过

ui-result.json

{"samePageResidual":true,"serverSeatsBeforeFreshPages":[true,false,false],"threeFreshPagesJoined":true,"modelCalls":0}

frozen-result.json

{"files": 31, "mismatches": []}

independent.mjs

import assert from 'node:assert/strict';
import {Game,rank,settle} from 'file:///Users/pptg/workspace/demo/ppanel/.ppanel/build/poker-driver/.ppanel/issue-35-control/tasks/71c1c0f7-69c9-487e-98a2-776bd0872c4f/reviewer/50853ea9-d6ec-4e3f-b5a4-81dc499142db/repo/projects/agent-poker/game.mjs';
let checks=0;const ok=(name,fn)=>{fn();checks++;console.log('PASS',name)};
const act=(g,a,n)=>g.act(g.actor,a,n,g.version);
const quiet=g=>act(g,g.legal(g.actor).actions.includes('check')?'check':'call');
ok('短盲注参数扫描与动作拒绝',()=>{for(let bb=1;bb<=20;bb++){let g=new Game(['甲','乙'],[100,bb]);g.start();if(bb<=10){assert.equal(g.stage,'complete');const s=JSON.stringify(g);assert.throws(()=>g.act(0,'fold',0,g.version));assert.equal(JSON.stringify(g),s)}else{assert.equal(g.legal(0).call,bb-10);assert.deepEqual(g.legal(0).actions,['fold','call']);quiet(g);assert.equal(g.stage,'complete');}assert.equal(g.history[0].total,100+bb)}});
ok('多人名义盲注与无人响应限制',()=>{let g=new Game(['甲','乙','丙'],[100,100,7]);g.start();assert.equal(g.legal(0).call,20);act(g,'fold');assert.equal(g.stage,'complete');assert.equal(g.history[0].total,207)});
ok('河牌弃牌、各玩家及旧快照隐私',()=>{for(let count=2;count<=6;count++){let g=new Game(Array.from({length:count},(_,i)=>String(i)));g.start();while(g.stage!=='river')quiet(g);act(g,'bet',20);while(g.stage!=='complete')act(g,'fold');for(const v of [g,Object.assign(new Game(['x','y']),JSON.parse(JSON.stringify(g)))]){assert(v.view().players.every(p=>p.cards.length===0));for(let i=0;i<count;i++)assert(v.view(i).players.every(p=>p.cards.length===(p.id===i?2:0)));}}});
ok('正常摊牌与全部牌型排序',()=>{let g=new Game(['甲','乙','丙']);g.start();act(g,'fold');while(g.stage!=='complete')quiet(g);assert.deepEqual(g.view().players.map(p=>p.cards.length),[0,2,2]);const hands=['As Ks Qs Js Ts','As Ad Ac Ah Ks','As Ad Ac Kh Ks','As Js 8s 5s 2s','As Kd Qc Jh Ts','As Ad Ac Kh Qs','As Ad Kc Kh Qs','As Ad Kc Qh Js','As Kd Qc Jh 9s'].map(h=>rank(h.split(' ')));for(let i=1;i<hands.length;i++)assert(hands[i-1]>hands[i])});
ok('拒绝非法、非当前、重复动作不改变完整状态',()=>{let g=new Game(['甲','乙','丙']);g.start();for(const args of [[1,'fold',0,g.version],[0,'raise',NaN,g.version],[0,'raise',-1,g.version],[0,'call',0,g.version-1],[0,'invalid',0,g.version]]){const s=JSON.stringify(g);assert.throws(()=>g.act(...args));assert.equal(JSON.stringify(g),s)}const old=g.version;quiet(g);const s=JSON.stringify(g);assert.throws(()=>g.act(0,'call',0,old));assert.equal(JSON.stringify(g),s)});
console.log(JSON.stringify({checks,modelCalls:0}));

ui-check.mjs

import {createRequire} from 'node:module';
import {readFileSync,writeFileSync} from 'node:fs';
import assert from 'node:assert/strict';
const require=createRequire(new URL('../repo/projects/agent-poker/package.json',import.meta.url));
const {chromium}=require('@playwright/test');
const origin='http://127.0.0.1:'+JSON.parse(readFileSync(new URL('./server-identity.json',import.meta.url))).port;
const admin=readFileSync(new URL('./http-service/admin-token',import.meta.url),'utf8');
const browser=await chromium.launch({channel:'chrome',headless:true});
try {
const p=await browser.newPage();await p.goto(origin);await p.getByLabel('管理凭据').fill(admin);await p.getByRole('button',{name:'建立牌桌',exact:true}).click();await p.getByRole('link',{name:'玩家 1 邀请地址'}).waitFor();
const links=await p.getByRole('link',{name:/玩家 \d 邀请地址/}).evaluateAll(es=>es.map(e=>e.getAttribute('href')));
const guest=await browser.newPage();await guest.goto(origin+links[0]);await guest.getByRole('button',{name:'接受邀请',exact:true}).click();await guest.getByRole('button',{name:'已加入',exact:true}).waitFor();
await guest.goto(origin+links[1]);await guest.waitForTimeout(1800);assert(await guest.getByRole('button',{name:'已加入',exact:true}).isVisible());
let tables=(await (await fetch(origin+'/api/tables')).json()).tables;let t=tables.at(-1);assert.deepEqual(t.models.map(s=>s.joined),[true,false,false]);
await guest.screenshot({path:new URL('./fragment-residual.png',import.meta.url).pathname});
for(const link of links){const q=await browser.newPage();await q.goto(origin+link);await q.getByRole('button',{name:'接受邀请',exact:true}).click();await q.getByRole('button',{name:'已加入',exact:true}).waitFor();await q.close();}
tables=(await(await fetch(origin+'/api/tables')).json()).tables;t=tables.at(-1);assert(t.models.every(s=>s.joined));
writeFileSync(new URL('./ui-result.json',import.meta.url),JSON.stringify({samePageResidual:true,serverSeatsBeforeFreshPages:[true,false,false],threeFreshPagesJoined:true,modelCalls:0}));console.log('确认同页邀请显示残留;独立新页三份邀请成功;无越权加入。');
}finally{await browser.close()}

证据

## reviewer 执行报告 运行:`50853ea9-d6ec-4e3f-b5a4-81dc499142db` 版本:1 结论:pass 基线:`411cea6bd5a55848791051f4c47da325626ecb76` 提交:`a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc` ## 独立全量 CR:pass 结论仅为本次代码审查通过,不是最终产品验收通过。已独立检查 [Issue #94](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/94) 分配的全部项目源码及实际复用依赖,未发现需再次返工的规则或隐私阻断项。已知邀请交互缺陷保留待产品决定;公网新候选部署、并行 QA、集成与合入后 QA 尚不能由本报告宣布完成。 - 需求版本:`1`。 - 检查 SHA:`a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc`。 - 基线 SHA:`411cea6bd5a55848791051f4c47da325626ecb76`,已验证为检查提交祖先。 - 分支:`ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-7`;开发 [PR #92](https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/92)。开发 `pass` 的正式来源为[编排记录](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72#issuecomment-19338)。没有将旧 SHA 的 CR/QA 通过结论沿用。 - 仅使用本角色 clone、Git/Gitea 正式任务与证据;未修改业务代码、冻结要求、控制面或公网进程。工作树已恢复干净。冻结清单 `31` 个 blob 全部匹配。 ### 本轮实测 `node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs`:`11/11` 通过;包含牌型、边池、平分、短加注、轮次、非法/重复动作、连续 `50` 手筹码守恒与原子快照故障注入。 额外自编确定性脚本 `independent.mjs`:`5/5` 组通过。短大盲筹码从 `1` 到 `20` 参数扫描;小盲已覆盖时自动摊牌并拒绝后续 `fold`,欠筹码时仅补实际差额、拒绝无响应加注;多人可下注仍保留名义大盲 `20`。`2–6` 人走到河牌下注后弃牌结束,各玩家投影与 JSON 旧快照重建均只显示自己的牌,公共投影全隐藏;正常多人摊牌仍公开未弃牌者。覆盖九种牌型排序与完整状态不变性。将同脚本绑定旧 `a3fce773` 后首组立即失败:实际 `preflop`,期望 `complete`,证明不是无效断言。 独立临时服务运行候选 `api-check.mjs`:真实 HTTP 鉴权、私有观察、非当前玩家拒绝、两个同版本并发动作仅一项成功、河牌弃牌后公共 API 与全部玩家出口隐私均通过。全部使用外部 API 测试玩家,没有调用模型。规则单测也验证旧快照投影;本轮未单独执行服务进程重启后的 HTTP 复验。 独立 `npm ci` 与 Vite 构建通过。构建输出在角色 `tmp/dist`,测试时仅建立临时静态目录链接,已移除。Chrome 对候选构建实际复测邀请边界,结果见下节。临时服务均已停止,日志保留。新增真实模型调用:`0`。 ### 已知交互问题:交产品决定,未豁免 位置:[ui.jsx](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc/projects/agent-poker/ui.jsx),`joined` 位于第 `17` 行,邀请身份直接读取 `location.hash`,按钮成功后只执行 `setJoined(true)`。 复现:管理员建桌;新页打开第一份邀请并接受;在该页仅切换到第二份邀请 fragment;等待页面轮询后,按钮仍显示“已加入”,而服务器席位状态为 `[true,false,false]`。随后三份邀请分别在独立新页接受,服务器确认三席均已加入。 影响:同页连续邀请会误导用户,可能因第二席未加入而无法开始;服务端仍按当前 Bearer 凭据识别席位,未发生越权加入或底牌泄露。建议按邀请身份重置加入显示或从服务器席位确认状态。此项属于明确保留的产品决策,不能把本报告的 `pass` 解读为已修复或获豁免;需要产品记录是否在最终交付前处理。 ### 完整九项契约逐项核对 以下 `pass` 表示本角色源码及所注明证据核对通过;有后续门禁的行明确保留,不冒称完整验收。 | 契约项 | CR 结论 | 依据及边界 | | --- | --- | --- | | 1 页面目标与产品自行分派 | `pass` | [根任务与正式评论](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72)记录开发、失败、返工、同新 SHA 独立 CR/QA;本角色只做审查。 | | 2 虚拟筹码、无真钱 | `pass` | [完整项目](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc/projects/agent-poker)无支付路径,服务器管理整数筹码。 | | 3 建桌、邀请、三玩家两模型 | `pass` | 本轮 Chrome 三独立页与 HTTP 邀请通过;历史 Git 模型记录包含玩家 `0/1/2`、DeepSeek/GLM。邀请显示问题仍待产品决定。 | | 4 受控观察与动作 | `pass` | [server.mjs](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc/projects/agent-poker/server.mjs)使用邀请 token 定位席位,`version` 与动作合法性先于状态变更;真实 HTTP 拒绝越权、非当前及并发重复动作。 | | 5 完整规则与结算 | `pass` | [game.mjs](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc/projects/agent-poker/game.mjs)、既有 `11` 项与独立 `5` 组验证;`R1/R2` 已验证修复。 | | 6 公网观测 | `pass`(实现审查) | 本地候选观测构建可运行,座位/底池/行动者/时间线/历史均有真实状态来源;[现有公网](https://laws-forming-bare-remedies.trycloudflare.com)按正式部署事实仍是旧 SHA,本轮未重复公网实开,当前 SHA 公网验收待 QA/部署环节。 | | 7 三手真实模型及证据 | `pass`(历史真实性与适用范围) | 两组 Git 原始事件核对见下节,不能据此断言新 `game.mjs` 完成真实模型对局。 | | 8 控制、历史与秘密隔离 | `pass` | 管理控制要求独立 admin token;公共投影不包含 token 或配置密钥;静态服务限制 `dist`,配置只由本机加载;暂停后版本/运行检查阻止迟到动作,历史由服务器结算形成。HTTP 已覆盖开始/暂停及观测;完整控制浏览器链由并行 QA 验证。 | | 9 独立 CR/QA 与 Git 交付 | `pass`(本角色) | 本报告绑定固定 SHA/revision;开发已有真实 Git/PR,运行说明已核对。并行 QA、最终合并及合入后 QA 仍须各自通过,不以本报告代替。 | 冻结验收 v1 七项对应:`1` 规则 → 契约 `5`(`pass`);`2` 隐私 → 契约 `4/8`(`pass`);`3` 外网/邀请 → 契约 `3/6`(实现审查 `pass`,最终部署待验);`4` 三手真实记录 → 契约 `7`(历史核对 `pass`);`5` 独立测试/浏览器/运行说明 → 契约 `9`(本角色 `pass`,QA 门禁保留);`6` 产品编排 → 契约 `1`(`pass`);`7` 控制/历史/权限 → 契约 `8`(源码与 HTTP 检查 `pass`)。没有修改或降低任一验收条件。 ### 历史证据与部署差异 [独立历史真实对局证据](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/0afa4df50967e881a700231022c13f4e30d9d2f1/evidence/issue-35-final/real-evidence.json)逐事件核验:`20` 次成功模型响应、`19` 个已应用状态、`1` 个错误事件;三位玩家、两种模型,三手历史均 `3000` 筹码,各中间状态 `stack + pot = 3000`。模型动作在该次观察的 `legal.actions` 中、行动者匹配,公开证据已移除私有观察底牌。三手均非多人摊牌。停止后返回的 `1` 次响应未应用,第四手未完成不计入三手。 [候选自带历史 evidence.json](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/470879a305438fc958acfc6486f1f86bcd94b681/projects/agent-poker/evidence.json)核验:`17` 次模型响应、`16` 个状态、`2` 个错误事件,三手与一次多人摊牌;同样三名玩家与两种模型,筹码守恒。没有读取其他角色原始私有日志,因此本报告验证的是 Git 安全证据的内部一致性及可追溯性,不宣称重新观测了供应商请求。 `game.mjs` 已在 `a0737d41` 被修复,历史三手对局不再与最终运行源码逐字相同,只能作为历史事实复用,不能冒称本轮新调用或修复后的验证结果。经 Git 比较,模型适配、服务器、持久化、UI、锁文件及直接复用的主题/布局/按钮/工具文件与历史候选无差异;规则、测试、验证脚本与文档有变化。共享 UI 继续直接导入,`style.css` 只有主题导入与组件扫描,许可声明保留,没有新增架构层。 按[正式部署事实](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72#issuecomment-19117),公网 `4399` 仍对应 `a3fce77317c99cc68fb05fa0c1934fd62999cd3f`,Node PID `59783`、启动身份 `Sat Sep 12 06:19:00 2026`,`cloudflared` PID `70644` 保留。它不是当前候选部署;本角色未操作该服务、隧道或 `4498/4497` 控制面。旧部署替换获授权、`dispatchPhase = launching` 均未作为缺陷。历史 CSS/HTML 对比不等也不能当作本轮新部署的实测结论;本轮只确认自己的候选构建成功,最终公网资源关系由 QA 核验。 ### 原始证据与复现 本角色全部临时文件保留在: `/Users/pptg/workspace/demo/ppanel/.ppanel/build/poker-driver/.ppanel/issue-35-control/tasks/71c1c0f7-69c9-487e-98a2-776bd0872c4f/reviewer/50853ea9-d6ec-4e3f-b5a4-81dc499142db/tmp` 包括 `task.json`、`tests.txt`、`independent.mjs`、`independent.log`、`old-check.mjs`、`old-check.log`、`install.log`、`build.log`、`http.log`、`ui-check.mjs`、`ui.log`、`ui-result.json`、`fragment-residual.png`、`frozen-result.json`。这些本地路径不是跨角色交接要求;下面将独立脚本及关键原始输出直接附入 Gitea 评论,使证据可经正式仓库渠道复核。脚本 import 应定位到审查者自己的同 SHA clone;HTTP/Chrome 使用各自独立私有服务,不能读取本角色私有凭据。持久化故障注入和 HTTP 固定测试动作都不是模型对局。 #### `tests.txt` ```text ✔ 快照替换完整且私有;替换前进程被杀仍保留旧历史 (51.528792ms) ✔ 牌型、轮子顺子及踢脚比较 (0.596ms) ✔ 边池与平分奇数筹码 (2.137125ms) ✔ 轮次、隐私、重复动作与非法输入均不变更状态 (2.743916ms) ✔ 短 all-in 不重新开放加注;全下自动摊牌守恒 (0.670708ms) ✔ 连续 50 手合法行动筹码守恒 (9.300583ms) ✔ 短大盲全下且小盲已覆盖时直接摊牌,不再允许弃牌 (0.506583ms) ✔ 唯一可行动者只需跟齐实际全下额,不能向无人响应的边池加注 (0.18175ms) ✔ 多人短大盲保留名义大盲;其他玩家弃牌后按实际投注自动摊牌 (0.140416ms) ✔ 河牌弃牌获胜后公开和其他玩家投影隐藏赢家底牌,重载仍隐藏 (0.336334ms) ✔ 真实多人摊牌仍公开未弃牌者底牌 (0.200333ms) ℹ tests 11 ℹ suites 0 ℹ pass 11 ℹ fail 0 ℹ cancelled 0 ℹ skipped 0 ℹ todo 0 ℹ duration_ms 96.495875 ``` #### `independent.log` ```text PASS 短盲注参数扫描与动作拒绝 PASS 多人名义盲注与无人响应限制 PASS 河牌弃牌、各玩家及旧快照隐私 PASS 正常摊牌与全部牌型排序 PASS 拒绝非法、非当前、重复动作不改变完整状态 {"checks":5,"modelCalls":0} ``` #### `http.log` ```text HTTP 鉴权、隐私、非当前玩家、并发重复动作与河牌弃牌获胜隐私检查通过 ``` #### `ui-result.json` ```text {"samePageResidual":true,"serverSeatsBeforeFreshPages":[true,false,false],"threeFreshPagesJoined":true,"modelCalls":0} ``` #### `frozen-result.json` ```text {"files": 31, "mismatches": []} ``` #### `independent.mjs` ```js import assert from 'node:assert/strict'; import {Game,rank,settle} from 'file:///Users/pptg/workspace/demo/ppanel/.ppanel/build/poker-driver/.ppanel/issue-35-control/tasks/71c1c0f7-69c9-487e-98a2-776bd0872c4f/reviewer/50853ea9-d6ec-4e3f-b5a4-81dc499142db/repo/projects/agent-poker/game.mjs'; let checks=0;const ok=(name,fn)=>{fn();checks++;console.log('PASS',name)}; const act=(g,a,n)=>g.act(g.actor,a,n,g.version); const quiet=g=>act(g,g.legal(g.actor).actions.includes('check')?'check':'call'); ok('短盲注参数扫描与动作拒绝',()=>{for(let bb=1;bb<=20;bb++){let g=new Game(['甲','乙'],[100,bb]);g.start();if(bb<=10){assert.equal(g.stage,'complete');const s=JSON.stringify(g);assert.throws(()=>g.act(0,'fold',0,g.version));assert.equal(JSON.stringify(g),s)}else{assert.equal(g.legal(0).call,bb-10);assert.deepEqual(g.legal(0).actions,['fold','call']);quiet(g);assert.equal(g.stage,'complete');}assert.equal(g.history[0].total,100+bb)}}); ok('多人名义盲注与无人响应限制',()=>{let g=new Game(['甲','乙','丙'],[100,100,7]);g.start();assert.equal(g.legal(0).call,20);act(g,'fold');assert.equal(g.stage,'complete');assert.equal(g.history[0].total,207)}); ok('河牌弃牌、各玩家及旧快照隐私',()=>{for(let count=2;count<=6;count++){let g=new Game(Array.from({length:count},(_,i)=>String(i)));g.start();while(g.stage!=='river')quiet(g);act(g,'bet',20);while(g.stage!=='complete')act(g,'fold');for(const v of [g,Object.assign(new Game(['x','y']),JSON.parse(JSON.stringify(g)))]){assert(v.view().players.every(p=>p.cards.length===0));for(let i=0;i<count;i++)assert(v.view(i).players.every(p=>p.cards.length===(p.id===i?2:0)));}}}); ok('正常摊牌与全部牌型排序',()=>{let g=new Game(['甲','乙','丙']);g.start();act(g,'fold');while(g.stage!=='complete')quiet(g);assert.deepEqual(g.view().players.map(p=>p.cards.length),[0,2,2]);const hands=['As Ks Qs Js Ts','As Ad Ac Ah Ks','As Ad Ac Kh Ks','As Js 8s 5s 2s','As Kd Qc Jh Ts','As Ad Ac Kh Qs','As Ad Kc Kh Qs','As Ad Kc Qh Js','As Kd Qc Jh 9s'].map(h=>rank(h.split(' ')));for(let i=1;i<hands.length;i++)assert(hands[i-1]>hands[i])}); ok('拒绝非法、非当前、重复动作不改变完整状态',()=>{let g=new Game(['甲','乙','丙']);g.start();for(const args of [[1,'fold',0,g.version],[0,'raise',NaN,g.version],[0,'raise',-1,g.version],[0,'call',0,g.version-1],[0,'invalid',0,g.version]]){const s=JSON.stringify(g);assert.throws(()=>g.act(...args));assert.equal(JSON.stringify(g),s)}const old=g.version;quiet(g);const s=JSON.stringify(g);assert.throws(()=>g.act(0,'call',0,old));assert.equal(JSON.stringify(g),s)}); console.log(JSON.stringify({checks,modelCalls:0})); ``` #### `ui-check.mjs` ```js import {createRequire} from 'node:module'; import {readFileSync,writeFileSync} from 'node:fs'; import assert from 'node:assert/strict'; const require=createRequire(new URL('../repo/projects/agent-poker/package.json',import.meta.url)); const {chromium}=require('@playwright/test'); const origin='http://127.0.0.1:'+JSON.parse(readFileSync(new URL('./server-identity.json',import.meta.url))).port; const admin=readFileSync(new URL('./http-service/admin-token',import.meta.url),'utf8'); const browser=await chromium.launch({channel:'chrome',headless:true}); try { const p=await browser.newPage();await p.goto(origin);await p.getByLabel('管理凭据').fill(admin);await p.getByRole('button',{name:'建立牌桌',exact:true}).click();await p.getByRole('link',{name:'玩家 1 邀请地址'}).waitFor(); const links=await p.getByRole('link',{name:/玩家 \d 邀请地址/}).evaluateAll(es=>es.map(e=>e.getAttribute('href'))); const guest=await browser.newPage();await guest.goto(origin+links[0]);await guest.getByRole('button',{name:'接受邀请',exact:true}).click();await guest.getByRole('button',{name:'已加入',exact:true}).waitFor(); await guest.goto(origin+links[1]);await guest.waitForTimeout(1800);assert(await guest.getByRole('button',{name:'已加入',exact:true}).isVisible()); let tables=(await (await fetch(origin+'/api/tables')).json()).tables;let t=tables.at(-1);assert.deepEqual(t.models.map(s=>s.joined),[true,false,false]); await guest.screenshot({path:new URL('./fragment-residual.png',import.meta.url).pathname}); for(const link of links){const q=await browser.newPage();await q.goto(origin+link);await q.getByRole('button',{name:'接受邀请',exact:true}).click();await q.getByRole('button',{name:'已加入',exact:true}).waitFor();await q.close();} tables=(await(await fetch(origin+'/api/tables')).json()).tables;t=tables.at(-1);assert(t.models.every(s=>s.joined)); writeFileSync(new URL('./ui-result.json',import.meta.url),JSON.stringify({samePageResidual:true,serverSeatsBeforeFreshPages:[true,false,false],threeFreshPagesJoined:true,modelCalls:0}));console.log('确认同页邀请显示残留;独立新页三份邀请成功;无越权加入。'); }finally{await browser.close()} ``` ### 证据 - https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/92 - https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/0afa4df50967e881a700231022c13f4e30d9d2f1/evidence/issue-35-final/real-evidence.json <!-- ppanel:{"protocol_version":1,"event_id":"0e6c7d05-180b-4801-a77a-c39292d7b7c0","kind":"result","task_id":"71c1c0f7-69c9-487e-98a2-776bd0872c4f","work_item_id":94,"run_id":"50853ea9-d6ec-4e3f-b5a4-81dc499142db","sender_role":"reviewer","goal_revision":1,"base_sha":"411cea6bd5a55848791051f4c47da325626ecb76","head_sha":"a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc","conclusion":"pass","evidence_links":["https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/92","https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/0afa4df50967e881a700231022c13f4e30d9d2f1/evidence/issue-35-final/real-evidence.json"]} -->
Sign in to join this conversation.
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

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