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

Open
opened 2026-09-12 07:04:50 +08:00 by peng01.guo · 2 comments
Owner

任务分配:developer

根任务:#72

分配原因

编排决定:dispatch(revision 1 第二轮开发修正,修复邀请 UI 残留真实缺陷)

依据:根任务 71c1c0f7-69c9-487e-98a2-776bd0872c4f(Issue #72)当前 reviewing,task.revision = 1(权威需求版本;本次自动返工不递增、不臆造 revision),基线 411cea6bd5a55848791051f4c47da325626ecb76,候选 a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc(开发修正 run e6289cea-dfc7-40eb-99e7-b1ea880fdff9,Issue #88,PR #92)。同 SHA、同 revision 1 的门禁结果:独立全量 CR run 50853ea9-d6ec-4e3f-b5a4-81dc499142db(codex,Issue #94)为 pass;独立 QA run 3ff7ae35-1da7-47d5-8698-799bfc061773(codex,Issue #95)为 changes_requested。按门禁,同版本必须 CR 与 QA 同时通过才可 merge,QA 非 pass 时不得合并,也不得沿用 CR 的 pass 记录作为新一轮通过依据。

QA changes_requested 的两项拆分定性(返工范围据此确定):

  1. 项 4 fail:邀请同页切换后 joined 残留(projects/agent-poker/ui.jsx 中 joined 为页面级布尔、邀请身份直接读取 location.hash、无 hashchange 监听)。QA 复现:玩家 1 页接受邀请后仅把地址片段切到同桌玩家 2 的 #join=,未接受玩家 2 时按钮仍显示“已加入”,服务端席位实为 [true,false,false],会误导接入并触发全员加入门禁(未发现越权或底牌泄露)。Issue #72 明确要求由产品全量评审其影响并决定是否修复——本编排者作为产品的决定是:修复,理由是该缺陷会直接误导邀请与开局流程、修复面小而可控,且仅有修复后才能真正闭合本项 fail。
  2. 项 5 部分 fail:最终候选部署一致性(公网 4399 仍是旧候选 a3fce773 的部署,Node PID 59783,启动身份 Sat Sep 12 06:19:00 2026;cloudflared PID 70644 保留)。此项属环境/部署方职责,不在开发返工范围:开发不得触碰、停用或替换 4399 源站、隧道或 4498/4497 控制面,也不得声称公网已对齐最终候选;只需在 README.md 中如实说明现状与限制。

本轮返工边界(第 2 次开发修正,需求版本仍为 1):

  1. 只修改 projects/agent-poker 与必要项目文档;不得改动冻结验收文件、控制面状态或数据库(acceptance/FROZEN*.sha256 等 31 个冻结 blob 必须继续全部匹配)。
  2. 修复邀请 UI:使 joined(或等价状态)按当前邀请身份重置/判定(例如监听 hashchange、按当前 #join= token 重新判定,或从服务器席位状态推导),确保同页切换 fragment 后不再显示上一玩家的“已加入”;独立新页三份邀请的行为必须保持不变。服务端鉴权与隐私投影不得放松。
  3. 不得回归已修复项:game.mjs 的 R1(短大盲全下且小盲已覆盖时自动摊牌、唯一可行动者只跟实际欠筹码额、保留名义大盲)与 R2(仅真实多人摊牌公开未弃牌者底牌,河牌弃牌获胜继续隐藏,含公共 API 与其他玩家投影、旧快照重载)必须保持,现有 node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs 必须仍为 11/11。
  4. 为 UI 修复补充可复现证据与回归:扩展 projects/agent-poker/browser-check.mjs(或等价脚本)覆盖“同页切换邀请 fragment 后按钮状态正确 + 三份独立新页邀请成功”,并把原始输出提交到 projects/agent-poker/evidence 下本轮新目录,同时在报告正文内直接给出关键输出与脚本要点(不得只用私有路径作交接)。
  5. 不得新增依赖、架构层或样式体系;继续复用仓库已有 D-SRE 样式与共享组件。
  6. 本轮新增真实模型调用必须为 0;不得调用真实模型、不得重复昂贵对局。历史真实对局证据(0afa4df50967e881a700231022c13f4e30d9d2f1 下 evidence/issue-35-final、470879a305438fc958acfc6486f1f86bcd94b681 的 projects/agent-poker/evidence.json)只可经 Git 读取并按历史事实复用,不得冒称本轮新调用;game.mjs 已变更的事实必须在报告中如实说明其适用范围。
  7. 禁止读取其他角色或根执行者私有目录、数据库、模型日志;全部交接只经 Git/Gitea;dispatchPhase = launching 属登记现象,不构成缺陷;CSS/HTML 与公网不相等而 JS 逐字相等属已记录构建差异,不作拒绝理由,但也不得据此宣称完整视觉等价。
  8. 交付要求:推送目标分支、工作树干净、回报新的最终候选 SHA(供后续 refresh 后在同一 SHA 与 revision 1 上重新分派独立 CR 与 QA),并在报告首页明确:本报告非 pass 时评审拒绝是正确门禁;不得自行宣布最终验收通过。

环境事实(须采信):公网地址 公网观测 源 127.0.0.1:4399,为旧候选 a3fce773 的授权部署;临时 URL 依赖本机与临时隧道存活,不承诺永久服务。最终交付所需的“最终 SHA 公网部署与核验”由环境方在 merge 后执行,本次开发不得越权操作进程。

现在开始执行本轮修正。

目标与验收

使用本控制面的真实协作流程,自行组织开发、独立 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-9
目标分支:deliveries/agent-poker-final

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

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

## 任务分配:developer 根任务:https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72 ### 分配原因 ## 编排决定:dispatch(revision `1` 第二轮开发修正,修复邀请 UI 残留真实缺陷) **依据**:根任务 `71c1c0f7-69c9-487e-98a2-776bd0872c4f`(Issue [#72](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72))当前 `reviewing`,**task.revision = `1`**(权威需求版本;本次自动返工不递增、不臆造 revision),基线 `411cea6bd5a55848791051f4c47da325626ecb76`,候选 `a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc`(开发修正 run `e6289cea-dfc7-40eb-99e7-b1ea880fdff9`,Issue [#88](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/88),PR [#92](https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/92))。同 SHA、同 revision `1` 的门禁结果:独立全量 CR run `50853ea9-d6ec-4e3f-b5a4-81dc499142db`(`codex`,Issue [#94](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/94))为 `pass`;独立 QA run `3ff7ae35-1da7-47d5-8698-799bfc061773`(`codex`,Issue [#95](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/95))为 `changes_requested`。按门禁,同版本必须 CR 与 QA 同时通过才可 merge,QA 非 `pass` 时不得合并,也不得沿用 CR 的 `pass` 记录作为新一轮通过依据。 **QA `changes_requested` 的两项拆分定性(返工范围据此确定)**: 1. **项 4 `fail`:邀请同页切换后 `joined` 残留**(`projects/agent-poker/ui.jsx` 中 `joined` 为页面级布尔、邀请身份直接读取 `location.hash`、无 `hashchange` 监听)。QA 复现:玩家 1 页接受邀请后仅把地址片段切到同桌玩家 2 的 `#join=`,未接受玩家 2 时按钮仍显示“已加入”,服务端席位实为 `[true,false,false]`,会误导接入并触发全员加入门禁(未发现越权或底牌泄露)。Issue #72 明确要求由产品全量评审其影响并决定是否修复——**本编排者作为产品的决定是:修复**,理由是该缺陷会直接误导邀请与开局流程、修复面小而可控,且仅有修复后才能真正闭合本项 `fail`。 2. **项 5 部分 `fail`:最终候选部署一致性**(公网 `4399` 仍是旧候选 `a3fce773` 的部署,Node PID `59783`,启动身份 `Sat Sep 12 06:19:00 2026`;`cloudflared` PID `70644` 保留)。此项属**环境/部署方职责,不在开发返工范围**:开发不得触碰、停用或替换 `4399` 源站、隧道或 `4498`/`4497` 控制面,也不得声称公网已对齐最终候选;只需在 `README.md` 中如实说明现状与限制。 **本轮返工边界(第 2 次开发修正,需求版本仍为 `1`)**: 1. 只修改 `projects/agent-poker` 与必要项目文档;不得改动冻结验收文件、控制面状态或数据库(`acceptance/FROZEN*.sha256` 等 `31` 个冻结 blob 必须继续全部匹配)。 2. 修复邀请 UI:使 `joined`(或等价状态)按**当前邀请身份**重置/判定(例如监听 `hashchange`、按当前 `#join=` token 重新判定,或从服务器席位状态推导),确保同页切换 fragment 后不再显示上一玩家的“已加入”;独立新页三份邀请的行为必须保持不变。服务端鉴权与隐私投影不得放松。 3. 不得回归已修复项:`game.mjs` 的 `R1`(短大盲全下且小盲已覆盖时自动摊牌、唯一可行动者只跟实际欠筹码额、保留名义大盲)与 `R2`(仅真实多人摊牌公开未弃牌者底牌,河牌弃牌获胜继续隐藏,含公共 API 与其他玩家投影、旧快照重载)必须保持,现有 `node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs` 必须仍为 `11/11`。 4. 为 UI 修复补充**可复现证据与回归**:扩展 `projects/agent-poker/browser-check.mjs`(或等价脚本)覆盖“同页切换邀请 fragment 后按钮状态正确 + 三份独立新页邀请成功”,并把原始输出提交到 `projects/agent-poker/evidence` 下本轮新目录,同时在报告正文内直接给出关键输出与脚本要点(不得只用私有路径作交接)。 5. 不得新增依赖、架构层或样式体系;继续复用仓库已有 D-SRE 样式与共享组件。 6. **本轮新增真实模型调用必须为 `0`**;不得调用真实模型、不得重复昂贵对局。历史真实对局证据(`0afa4df50967e881a700231022c13f4e30d9d2f1` 下 `evidence/issue-35-final`、`470879a305438fc958acfc6486f1f86bcd94b681` 的 `projects/agent-poker/evidence.json`)只可经 Git 读取并按历史事实复用,不得冒称本轮新调用;`game.mjs` 已变更的事实必须在报告中如实说明其适用范围。 7. 禁止读取其他角色或根执行者私有目录、数据库、模型日志;全部交接只经 Git/Gitea;`dispatchPhase = launching` 属登记现象,不构成缺陷;CSS/HTML 与公网不相等而 JS 逐字相等属已记录构建差异,不作拒绝理由,但也不得据此宣称完整视觉等价。 8. 交付要求:推送目标分支、工作树干净、回报**新的最终候选 SHA**(供后续 `refresh` 后在同一 SHA 与 revision `1` 上重新分派独立 CR 与 QA),并在报告首页明确:本报告非 `pass` 时评审拒绝是正确门禁;不得自行宣布最终验收通过。 **环境事实(须采信)**:公网地址 [公网观测](https://laws-forming-bare-remedies.trycloudflare.com) 源 `127.0.0.1:4399`,为旧候选 `a3fce773` 的授权部署;临时 URL 依赖本机与临时隧道存活,不承诺永久服务。最终交付所需的“最终 SHA 公网部署与核验”由环境方在 merge 后执行,本次开发不得越权操作进程。 现在开始执行本轮修正。 ### 目标与验收 使用本控制面的真实协作流程,自行组织开发、独立 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-9` 目标分支:`deliveries/agent-poker-final` 只在自己的 clone 工作,不读其他角色目录或日志。所有交接通过本 Issue 与远端 Git。不得弱化冻结验收。开发须确保候选包含分配的基线 SHA(必要时合并或变基),然后提交、push、创建 PR;独立 CR/QA 须实际检查固定 SHA,并把完整证据提交到独立证据分支或仓库评论。 使用当前会话的 worker 桥读取任务、创建 PR、发布中文 Markdown 报告;stdout 不是报告。 <!-- ppanel-issue:2afaed02-52d1-4f7e-9e5e-df3710fe6392 -->
Author
Owner

任务分配:developer

根任务:#72

分配原因

编排决定:dispatch(revision 1 第二轮开发修正,修复邀请 UI 残留真实缺陷)

依据:根任务 71c1c0f7-69c9-487e-98a2-776bd0872c4f(Issue #72)当前 reviewing,task.revision = 1(权威需求版本;本次自动返工不递增、不臆造 revision),基线 411cea6bd5a55848791051f4c47da325626ecb76,候选 a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc(开发修正 run e6289cea-dfc7-40eb-99e7-b1ea880fdff9,Issue #88,PR #92)。同 SHA、同 revision 1 的门禁结果:独立全量 CR run 50853ea9-d6ec-4e3f-b5a4-81dc499142db(codex,Issue #94)为 pass;独立 QA run 3ff7ae35-1da7-47d5-8698-799bfc061773(codex,Issue #95)为 changes_requested。按门禁,同版本必须 CR 与 QA 同时通过才可 merge,QA 非 pass 时不得合并,也不得沿用 CR 的 pass 记录作为新一轮通过依据。

QA changes_requested 的两项拆分定性(返工范围据此确定):

  1. 项 4 fail:邀请同页切换后 joined 残留(projects/agent-poker/ui.jsx 中 joined 为页面级布尔、邀请身份直接读取 location.hash、无 hashchange 监听)。QA 复现:玩家 1 页接受邀请后仅把地址片段切到同桌玩家 2 的 #join=,未接受玩家 2 时按钮仍显示“已加入”,服务端席位实为 [true,false,false],会误导接入并触发全员加入门禁(未发现越权或底牌泄露)。Issue #72 明确要求由产品全量评审其影响并决定是否修复——本编排者作为产品的决定是:修复,理由是该缺陷会直接误导邀请与开局流程、修复面小而可控,且仅有修复后才能真正闭合本项 fail。
  2. 项 5 部分 fail:最终候选部署一致性(公网 4399 仍是旧候选 a3fce773 的部署,Node PID 59783,启动身份 Sat Sep 12 06:19:00 2026;cloudflared PID 70644 保留)。此项属环境/部署方职责,不在开发返工范围:开发不得触碰、停用或替换 4399 源站、隧道或 4498/4497 控制面,也不得声称公网已对齐最终候选;只需在 README.md 中如实说明现状与限制。

本轮返工边界(第 2 次开发修正,需求版本仍为 1):

  1. 只修改 projects/agent-poker 与必要项目文档;不得改动冻结验收文件、控制面状态或数据库(acceptance/FROZEN*.sha256 等 31 个冻结 blob 必须继续全部匹配)。
  2. 修复邀请 UI:使 joined(或等价状态)按当前邀请身份重置/判定(例如监听 hashchange、按当前 #join= token 重新判定,或从服务器席位状态推导),确保同页切换 fragment 后不再显示上一玩家的“已加入”;独立新页三份邀请的行为必须保持不变。服务端鉴权与隐私投影不得放松。
  3. 不得回归已修复项:game.mjs 的 R1(短大盲全下且小盲已覆盖时自动摊牌、唯一可行动者只跟实际欠筹码额、保留名义大盲)与 R2(仅真实多人摊牌公开未弃牌者底牌,河牌弃牌获胜继续隐藏,含公共 API 与其他玩家投影、旧快照重载)必须保持,现有 node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs 必须仍为 11/11。
  4. 为 UI 修复补充可复现证据与回归:扩展 projects/agent-poker/browser-check.mjs(或等价脚本)覆盖“同页切换邀请 fragment 后按钮状态正确 + 三份独立新页邀请成功”,并把原始输出提交到 projects/agent-poker/evidence 下本轮新目录,同时在报告正文内直接给出关键输出与脚本要点(不得只用私有路径作交接)。
  5. 不得新增依赖、架构层或样式体系;继续复用仓库已有 D-SRE 样式与共享组件。
  6. 本轮新增真实模型调用必须为 0;不得调用真实模型、不得重复昂贵对局。历史真实对局证据(0afa4df50967e881a700231022c13f4e30d9d2f1 下 evidence/issue-35-final、470879a305438fc958acfc6486f1f86bcd94b681 的 projects/agent-poker/evidence.json)只可经 Git 读取并按历史事实复用,不得冒称本轮新调用;game.mjs 已变更的事实必须在报告中如实说明其适用范围。
  7. 禁止读取其他角色或根执行者私有目录、数据库、模型日志;全部交接只经 Git/Gitea;dispatchPhase = launching 属登记现象,不构成缺陷;CSS/HTML 与公网不相等而 JS 逐字相等属已记录构建差异,不作拒绝理由,但也不得据此宣称完整视觉等价。
  8. 交付要求:推送目标分支、工作树干净、回报新的最终候选 SHA(供后续 refresh 后在同一 SHA 与 revision 1 上重新分派独立 CR 与 QA),并在报告首页明确:本报告非 pass 时评审拒绝是正确门禁;不得自行宣布最终验收通过。

环境事实(须采信):公网地址 公网观测 源 127.0.0.1:4399,为旧候选 a3fce773 的授权部署;临时 URL 依赖本机与临时隧道存活,不承诺永久服务。最终交付所需的“最终 SHA 公网部署与核验”由环境方在 merge 后执行,本次开发不得越权操作进程。

现在开始执行本轮修正。

目标与验收

使用本控制面的真实协作流程,自行组织开发、独立 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-9
目标分支:deliveries/agent-poker-final

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

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

## 任务分配:developer 根任务:https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72 ### 分配原因 ## 编排决定:dispatch(revision `1` 第二轮开发修正,修复邀请 UI 残留真实缺陷) **依据**:根任务 `71c1c0f7-69c9-487e-98a2-776bd0872c4f`(Issue [#72](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72))当前 `reviewing`,**task.revision = `1`**(权威需求版本;本次自动返工不递增、不臆造 revision),基线 `411cea6bd5a55848791051f4c47da325626ecb76`,候选 `a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc`(开发修正 run `e6289cea-dfc7-40eb-99e7-b1ea880fdff9`,Issue [#88](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/88),PR [#92](https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/92))。同 SHA、同 revision `1` 的门禁结果:独立全量 CR run `50853ea9-d6ec-4e3f-b5a4-81dc499142db`(`codex`,Issue [#94](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/94))为 `pass`;独立 QA run `3ff7ae35-1da7-47d5-8698-799bfc061773`(`codex`,Issue [#95](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/95))为 `changes_requested`。按门禁,同版本必须 CR 与 QA 同时通过才可 merge,QA 非 `pass` 时不得合并,也不得沿用 CR 的 `pass` 记录作为新一轮通过依据。 **QA `changes_requested` 的两项拆分定性(返工范围据此确定)**: 1. **项 4 `fail`:邀请同页切换后 `joined` 残留**(`projects/agent-poker/ui.jsx` 中 `joined` 为页面级布尔、邀请身份直接读取 `location.hash`、无 `hashchange` 监听)。QA 复现:玩家 1 页接受邀请后仅把地址片段切到同桌玩家 2 的 `#join=`,未接受玩家 2 时按钮仍显示“已加入”,服务端席位实为 `[true,false,false]`,会误导接入并触发全员加入门禁(未发现越权或底牌泄露)。Issue #72 明确要求由产品全量评审其影响并决定是否修复——**本编排者作为产品的决定是:修复**,理由是该缺陷会直接误导邀请与开局流程、修复面小而可控,且仅有修复后才能真正闭合本项 `fail`。 2. **项 5 部分 `fail`:最终候选部署一致性**(公网 `4399` 仍是旧候选 `a3fce773` 的部署,Node PID `59783`,启动身份 `Sat Sep 12 06:19:00 2026`;`cloudflared` PID `70644` 保留)。此项属**环境/部署方职责,不在开发返工范围**:开发不得触碰、停用或替换 `4399` 源站、隧道或 `4498`/`4497` 控制面,也不得声称公网已对齐最终候选;只需在 `README.md` 中如实说明现状与限制。 **本轮返工边界(第 2 次开发修正,需求版本仍为 `1`)**: 1. 只修改 `projects/agent-poker` 与必要项目文档;不得改动冻结验收文件、控制面状态或数据库(`acceptance/FROZEN*.sha256` 等 `31` 个冻结 blob 必须继续全部匹配)。 2. 修复邀请 UI:使 `joined`(或等价状态)按**当前邀请身份**重置/判定(例如监听 `hashchange`、按当前 `#join=` token 重新判定,或从服务器席位状态推导),确保同页切换 fragment 后不再显示上一玩家的“已加入”;独立新页三份邀请的行为必须保持不变。服务端鉴权与隐私投影不得放松。 3. 不得回归已修复项:`game.mjs` 的 `R1`(短大盲全下且小盲已覆盖时自动摊牌、唯一可行动者只跟实际欠筹码额、保留名义大盲)与 `R2`(仅真实多人摊牌公开未弃牌者底牌,河牌弃牌获胜继续隐藏,含公共 API 与其他玩家投影、旧快照重载)必须保持,现有 `node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs` 必须仍为 `11/11`。 4. 为 UI 修复补充**可复现证据与回归**:扩展 `projects/agent-poker/browser-check.mjs`(或等价脚本)覆盖“同页切换邀请 fragment 后按钮状态正确 + 三份独立新页邀请成功”,并把原始输出提交到 `projects/agent-poker/evidence` 下本轮新目录,同时在报告正文内直接给出关键输出与脚本要点(不得只用私有路径作交接)。 5. 不得新增依赖、架构层或样式体系;继续复用仓库已有 D-SRE 样式与共享组件。 6. **本轮新增真实模型调用必须为 `0`**;不得调用真实模型、不得重复昂贵对局。历史真实对局证据(`0afa4df50967e881a700231022c13f4e30d9d2f1` 下 `evidence/issue-35-final`、`470879a305438fc958acfc6486f1f86bcd94b681` 的 `projects/agent-poker/evidence.json`)只可经 Git 读取并按历史事实复用,不得冒称本轮新调用;`game.mjs` 已变更的事实必须在报告中如实说明其适用范围。 7. 禁止读取其他角色或根执行者私有目录、数据库、模型日志;全部交接只经 Git/Gitea;`dispatchPhase = launching` 属登记现象,不构成缺陷;CSS/HTML 与公网不相等而 JS 逐字相等属已记录构建差异,不作拒绝理由,但也不得据此宣称完整视觉等价。 8. 交付要求:推送目标分支、工作树干净、回报**新的最终候选 SHA**(供后续 `refresh` 后在同一 SHA 与 revision `1` 上重新分派独立 CR 与 QA),并在报告首页明确:本报告非 `pass` 时评审拒绝是正确门禁;不得自行宣布最终验收通过。 **环境事实(须采信)**:公网地址 [公网观测](https://laws-forming-bare-remedies.trycloudflare.com) 源 `127.0.0.1:4399`,为旧候选 `a3fce773` 的授权部署;临时 URL 依赖本机与临时隧道存活,不承诺永久服务。最终交付所需的“最终 SHA 公网部署与核验”由环境方在 merge 后执行,本次开发不得越权操作进程。 现在开始执行本轮修正。 ### 目标与验收 使用本控制面的真实协作流程,自行组织开发、独立 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-9` 目标分支:`deliveries/agent-poker-final` 只在自己的 clone 工作,不读其他角色目录或日志。所有交接通过本 Issue 与远端 Git。不得弱化冻结验收。开发须确保候选包含分配的基线 SHA(必要时合并或变基),然后提交、push、创建 PR;独立 CR/QA 须实际检查固定 SHA,并把完整证据提交到独立证据分支或仓库评论。 使用当前会话的 worker 桥读取任务、创建 PR、发布中文 Markdown 报告;stdout 不是报告。 <!-- ppanel:{"protocol_version":1,"event_id":"095ac996-8d7f-4ddd-a29a-64cc2fad6c08","kind":"assignment","task_id":"71c1c0f7-69c9-487e-98a2-776bd0872c4f","run_id":"2afaed02-52d1-4f7e-9e5e-df3710fe6392","sender_role":"orchestrator","recipient_role":"developer","goal_revision":1,"base_sha":"411cea6bd5a55848791051f4c47da325626ecb76","head_sha":"a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc","work_item_id":96} -->
Author
Owner

developer 执行报告

运行:2afaed02-52d1-4f7e-9e5e-df3710fe6392
版本:1
结论:pass
基线:411cea6bd5a55848791051f4c47da325626ecb76
提交:d1a5f6734e751dca5b7e9d8a1388218b25310558

Issue 96 开发交付:修复同页邀请加入状态

本报告结论为 pass,仅表示本轮授权开发修复及开发验证完成。本报告非 pass 时评审拒绝是正确门禁;本报告不宣布最终验收通过。 独立 CR 与 QA 必须在下列同一最终 SHA、需求版本 1 上重新执行,不能沿用旧候选评审。

  • 任务:Issue #96。
  • 需求版本:1。
  • 开发分支:ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-9。
  • 合并目标分支:deliveries/agent-poker-final;开发角色未合并。
  • 最终候选:d1a5f6734e751dca5b7e9d8a1388218b25310558。
  • 基线:411cea6bd5a55848791051f4c47da325626ecb76,已验证为候选祖先。
  • 修复前候选:a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc。
  • 已提交、推送,工作树干净。

修复与证据

projects/agent-poker/ui.jsx 原先直接读取 location.hash 且 joined 为页面级布尔值。现在监听 hashchange,按当前完整邀请片段判定成功加入记录;旧异步请求只能标记其发起时的邀请。独立新页行为保持,移除片段隐藏邀请区。仅复用原组件与样式,没有新增依赖、架构层或样式;服务端鉴权及隐私投影未改动。

扩展 projects/agent-poker/browser-check.mjs,真实 Chrome 与独立本机 HTTP 服务联调,先在原 UI 上确认回归失败,再验证修复通过。断言同时检查按钮与服务端席位:玩家 1 加入后同页切换玩家 2,确认未自动加入;接受玩家 2 后席位为 [true,true,false];切回玩家 1 保留该身份状态;移除片段隐藏邀请区。另一张新牌桌的三份邀请分别从独立新页接受,确认全部席位加入。关键原始输出:

同页切换玩家 1 → 玩家 2:接受邀请;服务端席位 [true,false,false]
三份独立新页邀请成功:服务端席位 [true,true,true]
浏览器观测、邀请流程通过
HTTP 鉴权、隐私、非当前玩家、并发重复动作与河牌弃牌获胜隐私检查通过

验证

npm --prefix projects/agent-poker run build 成功;node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs 为 11/11,失败 0;node projects/agent-poker/api-check.mjs 通过;node projects/agent-poker/browser-check.mjs 通过且页面错误为 []。正式任务规定的冻结 blob 全部匹配 31/31,git diff --check 通过。所有临时数据和运行日志位于本角色临时目录,测试服务仅监听 127.0.0.1:18596;未读取其他执行者目录。

相对修复前候选,game.mjs 与 server.mjs 无差异,保留 R1 短大盲全下/实际欠筹码/名义大盲,以及 R2 真实多人摊牌公开、河牌弃牌隐藏、公共及玩家投影、旧快照重载。新增可公开日志经过本轮管理凭据及邀请 token 扫描,未发现凭据。

模型与部署限制

本轮新增真实模型调用为 0,未执行 real-check.mjs,未读取本机模型配置或调用模型。浏览器不配置 modelId,HTTP 确定性测试不冒充真实对局。历史证据 环境真实对局 与 原候选对局 仅作为历史引用,不冒称本轮调用或重新全量核验。经 Git 比较,当前 game.mjs 相对 470879a305438fc958acfc6486f1f86bcd94b681 已有 6 行增加、2 行删除,因此历史真实模型记录不能证明新规则候选已部署或完成真实对局。

按正式任务环境事实,公网观测 仍是 127.0.0.1:4399 上旧候选 a3fce773,Node PID 59783,启动身份 Sat Sep 12 06:19:00 2026;cloudflared PID 70644。本轮未操作该源站、隧道或 4498/4497 控制面,不声称公网对齐最终候选。最终 SHA 的部署与核验由环境方在合并后执行;临时地址依赖本机与隧道存活,不承诺永久服务。旧 CSS/HTML/JavaScript 构建比较不能证明本次完整视觉等价。dispatchPhase = launching 不作缺陷。

证据

## developer 执行报告 运行:`2afaed02-52d1-4f7e-9e5e-df3710fe6392` 版本:1 结论:pass 基线:`411cea6bd5a55848791051f4c47da325626ecb76` 提交:`d1a5f6734e751dca5b7e9d8a1388218b25310558` # Issue 96 开发交付:修复同页邀请加入状态 本报告结论为 `pass`,仅表示本轮授权开发修复及开发验证完成。**本报告非 `pass` 时评审拒绝是正确门禁;本报告不宣布最终验收通过。** 独立 CR 与 QA 必须在下列同一最终 SHA、需求版本 `1` 上重新执行,不能沿用旧候选评审。 - 任务:[Issue #96](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/96)。 - 需求版本:`1`。 - 开发分支:`ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-9`。 - 合并目标分支:`deliveries/agent-poker-final`;开发角色未合并。 - 最终候选:[`d1a5f6734e751dca5b7e9d8a1388218b25310558`](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/d1a5f6734e751dca5b7e9d8a1388218b25310558)。 - 基线:`411cea6bd5a55848791051f4c47da325626ecb76`,已验证为候选祖先。 - 修复前候选:`a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc`。 - 已提交、推送,工作树干净。 ## 修复与证据 `projects/agent-poker/ui.jsx` 原先直接读取 `location.hash` 且 `joined` 为页面级布尔值。现在监听 `hashchange`,按当前完整邀请片段判定成功加入记录;旧异步请求只能标记其发起时的邀请。独立新页行为保持,移除片段隐藏邀请区。仅复用原组件与样式,没有新增依赖、架构层或样式;服务端鉴权及隐私投影未改动。 扩展 `projects/agent-poker/browser-check.mjs`,真实 Chrome 与独立本机 HTTP 服务联调,先在原 UI 上确认回归失败,再验证修复通过。断言同时检查按钮与服务端席位:玩家 1 加入后同页切换玩家 2,确认未自动加入;接受玩家 2 后席位为 `[true,true,false]`;切回玩家 1 保留该身份状态;移除片段隐藏邀请区。另一张新牌桌的三份邀请分别从独立新页接受,确认全部席位加入。关键原始输出: ```text 同页切换玩家 1 → 玩家 2:接受邀请;服务端席位 [true,false,false] 三份独立新页邀请成功:服务端席位 [true,true,true] 浏览器观测、邀请流程通过 HTTP 鉴权、隐私、非当前玩家、并发重复动作与河牌弃牌获胜隐私检查通过 ``` - [完整原始证据目录](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/d1a5f6734e751dca5b7e9d8a1388218b25310558/projects/agent-poker/evidence/issue-96-invitation) - [修复前失败日志](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/d1a5f6734e751dca5b7e9d8a1388218b25310558/projects/agent-poker/evidence/issue-96-invitation/browser-before.log):`接受邀请` 不可见,页面仍为 `已加入`。 - [修复后浏览器输出](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/d1a5f6734e751dca5b7e9d8a1388218b25310558/projects/agent-poker/evidence/issue-96-invitation/browser-after.log) - [规则与持久化输出](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/d1a5f6734e751dca5b7e9d8a1388218b25310558/projects/agent-poker/evidence/issue-96-invitation/unit.log) - [复现与环境说明](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/d1a5f6734e751dca5b7e9d8a1388218b25310558/projects/agent-poker/README.md) ## 验证 `npm --prefix projects/agent-poker run build` 成功;`node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs` 为 `11/11`,失败 `0`;`node projects/agent-poker/api-check.mjs` 通过;`node projects/agent-poker/browser-check.mjs` 通过且页面错误为 `[]`。正式任务规定的冻结 blob 全部匹配 `31/31`,`git diff --check` 通过。所有临时数据和运行日志位于本角色临时目录,测试服务仅监听 `127.0.0.1:18596`;未读取其他执行者目录。 相对修复前候选,`game.mjs` 与 `server.mjs` 无差异,保留 `R1` 短大盲全下/实际欠筹码/名义大盲,以及 `R2` 真实多人摊牌公开、河牌弃牌隐藏、公共及玩家投影、旧快照重载。新增可公开日志经过本轮管理凭据及邀请 token 扫描,未发现凭据。 ## 模型与部署限制 本轮新增真实模型调用为 `0`,未执行 `real-check.mjs`,未读取本机模型配置或调用模型。浏览器不配置 `modelId`,HTTP 确定性测试不冒充真实对局。历史证据 [环境真实对局](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/0afa4df50967e881a700231022c13f4e30d9d2f1/evidence/issue-35-final) 与 [原候选对局](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/470879a305438fc958acfc6486f1f86bcd94b681/projects/agent-poker/evidence.json) 仅作为历史引用,不冒称本轮调用或重新全量核验。经 Git 比较,当前 `game.mjs` 相对 `470879a305438fc958acfc6486f1f86bcd94b681` 已有 `6` 行增加、`2` 行删除,因此历史真实模型记录不能证明新规则候选已部署或完成真实对局。 按正式任务环境事实,[公网观测](https://laws-forming-bare-remedies.trycloudflare.com) 仍是 `127.0.0.1:4399` 上旧候选 `a3fce773`,Node PID `59783`,启动身份 `Sat Sep 12 06:19:00 2026`;`cloudflared` PID `70644`。本轮未操作该源站、隧道或 `4498`/`4497` 控制面,不声称公网对齐最终候选。最终 SHA 的部署与核验由环境方在合并后执行;临时地址依赖本机与隧道存活,不承诺永久服务。旧 CSS/HTML/JavaScript 构建比较不能证明本次完整视觉等价。`dispatchPhase = launching` 不作缺陷。 ### 证据 - https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/97 - https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/d1a5f6734e751dca5b7e9d8a1388218b25310558/projects/agent-poker/evidence/issue-96-invitation <!-- ppanel:{"protocol_version":1,"event_id":"db990fe1-c377-4b87-b30f-e23118ab365b","kind":"result","task_id":"71c1c0f7-69c9-487e-98a2-776bd0872c4f","work_item_id":96,"run_id":"2afaed02-52d1-4f7e-9e5e-df3710fe6392","sender_role":"developer","goal_revision":1,"base_sha":"411cea6bd5a55848791051f4c47da325626ecb76","head_sha":"d1a5f6734e751dca5b7e9d8a1388218b25310558","conclusion":"pass","evidence_links":["https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/97","https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/d1a5f6734e751dca5b7e9d8a1388218b25310558/projects/agent-poker/evidence/issue-96-invitation"]} -->
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#96
No description provided.