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

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

任务分配:developer

根任务:#72

分配原因

编排决定:dispatch(revision 1 第三轮开发修正:绑定最终源码/构建/运行身份,闭合 QA 遗留移交缺口)

权威需求版本(goal revision):1;本次为开发修正轮次递增,不改变需求版本,不递增也不臆造 revision。

可信失败来源

  • 根任务 71c1c0f7-69c9-487e-98a2-776bd0872c4f(Issue #72),状态 reviewing,基线 411cea6bd5a55848791051f4c47da325626ecb76,当前候选 d1a5f6734e751dca5b7e9d8a1388218b25310558(PR #97)。
  • 同 SHA、同 revision 1 的门禁:独立全量 CR run 8b8d4f08-ffeb-4aac-9624-cd551b6a659f(Issue #98)pass;独立 QA run 802873d1-9e34-4ec8-be6b-05bf6c3beaf9(Issue #99)changes_requested。按门禁,QA 非 pass 时不得 merge,也不得沿用旧 SHA 通过记录(控制面已拒绝在同一 SHA 上重派 QA),故必须返工。
  • 失败项定性(决定返工范围):QA 的全部阻断项都不是规则或隐私代码缺陷——项 4(可访问与安全 pass、最终候选部署一致性 fail)、项 5 后半(修复后源码缺少部署态运行证明)、项 6/9(最终部署绑定 fail/未完成);其本地项全部 pass(安装、构建、node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs 为 11/11 含 R1/R2、api-check.mjs、Chrome 邀请 hashchange 与三份独立新页、未授权 models/私有 observation 为 403、冻结 31 个 blob 全匹配)。QA 采样时公网为 index-FU5_FpP1.js/index-BEOPO_nE.css;环境方随后在 评论 19435 报告已将公网静态资源对齐 d1a5f673 的完整 Git 构建、后端与 a0737d41 逐字等价,并在 评论 19429 报告新桌 52e49afe-dd88-4d89-9cfa-e7b750c9e1e1 上完成三手真实对局(每手与所有状态 3000、24 次成功响应/23 应用/1 暂停后未应用/1 错误、DeepSeek 与 GLM)。部署对齐本身属环境/部署方职责,不在开发返工范围;开发不得触碰 4399 源站、隧道与 4498/4497 控制面。

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

  1. 不得修改任何运行逻辑与构建输入:projects/agent-poker/game.mjs、server.mjs、persistence.mjs、models.mjs、ui.jsx、style.css、test.mjs、api-check.mjs、browser-check.mjs、package.json、package-lock.json 必须与 d1a5f673 逐字相同,以保证 npm run build 产物的资源名与摘要不变(应仍为 index-BO_t9cEz.js、index-CU526T7U.css),现有已对齐的公网部署不因本轮返工失效。若你发现任何必须改运行逻辑的问题,不要顺手改:在报告中单列并给出可复现证据,交控制面决定;不得弱化门禁或自行扩大范围。
  2. 允许且要求的改动只有项目文档与证据目录:
    • projects/agent-poker/README.md:如实写明最终候选 d1a5f673 的源码/构建/运行身份绑定、公网部署现状(源 127.0.0.1:4399、环境方 Git 证据(评论 19435)说明的静态资源与后端等价关系)、临时地址生命周期与局限,以及真实对局证据的适用范围判据(只有后端源码逐字等价时才可复用;历史证据不得冒称本轮新调用)。
    • 新增 projects/agent-poker/evidence/<本轮新目录>,包含可复现的源码身份比对脚本与原始输出:(i) a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc 部署所用后端源码与 d1a5f673 在 server.mjs、game.mjs、persistence.mjs、models.mjs、package.json、锁文件上的逐字/摘要比较;(ii) 本候选自身 npm run build 产物摘要(供部署方与后续 QA 直接比对公网资源);(iii) 0afa4df50967e881a700231022c13f4e30d9d2f1 下 evidence/issue-35-final 与 470879a305438fc958acfc6486f1f86bcd94b681 的 projects/agent-poker/evidence.json(含一次真实多人摊牌)作为历史事实的适用范围声明。证据须给出完整命令与原始输出,不得只用私有路径作交接。
  3. 本轮新增真实模型调用必须为 0:不得调用真实模型、不得运行 real-check.mjs、不得重复昂贵对局;不得读取环境方或其他角色/根执行者私有目录、数据库、模型日志。
  4. 不得回归、不得动冻结:acceptance/FROZEN*.sha256 等 31 个冻结 blob 必须继续全部匹配;重跑 npm ci --prefix projects/agent-poker、npm run build --prefix projects/agent-poker、node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs(应仍为 11/11)并记录原始输出;扫描新增公开文件不得含邀请 token、管理凭据或模型密钥。
  5. 报告纪律:报告首页须写明“本报告非 pass 时评审拒绝是正确门禁”,并明确:本次返工不、也不能修改正在运行的公网部署与隧道,最终部署对齐由环境方按既有授权完成;若本轮返工实际导致构建产物或后端源码变化(按上述边界应当不会),必须如实报告“现有部署不再适用”,不得把旧部署冒充最终候选。dispatchPhase = launching 属登记现象,不构成缺陷。
  6. 交付:推送目标分支、工作树干净,回报新的最终候选 SHA,供控制面 refresh 后在同一 SHA 与需求 revision 1 上重派独立全量 CR 与独立 QA;开发不得自行宣布最终验收通过。

现在开始执行本轮修正。

目标与验收

使用本控制面的真实协作流程,自行组织开发、独立 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:d1a5f6734e751dca5b7e9d8a1388218b25310558
开发分支:ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-12
目标分支: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` 第三轮开发修正:绑定最终源码/构建/运行身份,闭合 QA 遗留移交缺口) **权威需求版本(goal revision):1;本次为开发修正轮次递增,不改变需求版本,不递增也不臆造 revision。** ### 可信失败来源 - 根任务 `71c1c0f7-69c9-487e-98a2-776bd0872c4f`([Issue #72](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72)),状态 `reviewing`,基线 `411cea6bd5a55848791051f4c47da325626ecb76`,当前候选 `d1a5f6734e751dca5b7e9d8a1388218b25310558`([PR #97](https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/97))。 - 同 SHA、同 revision `1` 的门禁:独立全量 CR run `8b8d4f08-ffeb-4aac-9624-cd551b6a659f`([Issue #98](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/98))`pass`;独立 QA run `802873d1-9e34-4ec8-be6b-05bf6c3beaf9`([Issue #99](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/99))`changes_requested`。按门禁,QA 非 `pass` 时不得 `merge`,也不得沿用旧 SHA 通过记录(控制面已拒绝在同一 SHA 上重派 QA),故必须返工。 - **失败项定性(决定返工范围)**:QA 的全部阻断项都不是规则或隐私代码缺陷——项 4(可访问与安全 `pass`、**最终候选部署一致性 `fail`**)、项 5 后半(修复后源码缺少部署态运行证明)、项 6/9(最终部署绑定 `fail`/未完成);其本地项全部 `pass`(安装、构建、`node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs` 为 `11/11` 含 `R1`/`R2`、`api-check.mjs`、Chrome 邀请 `hashchange` 与三份独立新页、未授权 `models`/私有 observation 为 `403`、冻结 `31` 个 blob 全匹配)。QA 采样时公网为 `index-FU5_FpP1.js`/`index-BEOPO_nE.css`;环境方随后在 [评论 19435](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72#issuecomment-19435) 报告已将公网静态资源对齐 `d1a5f673` 的完整 Git 构建、后端与 `a0737d41` 逐字等价,并在 [评论 19429](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72#issuecomment-19429) 报告新桌 `52e49afe-dd88-4d89-9cfa-e7b750c9e1e1` 上完成三手真实对局(每手与所有状态 `3000`、`24` 次成功响应/`23` 应用/`1` 暂停后未应用/`1` 错误、DeepSeek 与 GLM)。部署对齐本身属**环境/部署方职责**,不在开发返工范围;开发不得触碰 `4399` 源站、隧道与 `4498`/`4497` 控制面。 ### 本轮返工边界(第 3 次开发修正,需求版本仍为 `1`) 1. **不得修改任何运行逻辑与构建输入**:`projects/agent-poker/game.mjs`、`server.mjs`、`persistence.mjs`、`models.mjs`、`ui.jsx`、`style.css`、`test.mjs`、`api-check.mjs`、`browser-check.mjs`、`package.json`、`package-lock.json` 必须与 `d1a5f673` **逐字相同**,以保证 `npm run build` 产物的资源名与摘要不变(应仍为 `index-BO_t9cEz.js`、`index-CU526T7U.css`),现有已对齐的公网部署不因本轮返工失效。若你发现任何必须改运行逻辑的问题,不要顺手改:在报告中单列并给出可复现证据,交控制面决定;不得弱化门禁或自行扩大范围。 2. **允许且要求的改动只有项目文档与证据目录**: - `projects/agent-poker/README.md`:如实写明最终候选 `d1a5f673` 的源码/构建/运行身份绑定、公网部署现状(源 `127.0.0.1:4399`、环境方 Git 证据([评论 19435](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72#issuecomment-19435))说明的静态资源与后端等价关系)、临时地址生命周期与局限,以及**真实对局证据的适用范围判据**(只有后端源码逐字等价时才可复用;历史证据不得冒称本轮新调用)。 - 新增 `projects/agent-poker/evidence/<本轮新目录>`,包含可复现的**源码身份比对脚本与原始输出**:(i) `a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc` 部署所用后端源码与 `d1a5f673` 在 `server.mjs`、`game.mjs`、`persistence.mjs`、`models.mjs`、`package.json`、锁文件上的逐字/摘要比较;(ii) 本候选自身 `npm run build` 产物摘要(供部署方与后续 QA 直接比对公网资源);(iii) `0afa4df50967e881a700231022c13f4e30d9d2f1` 下 `evidence/issue-35-final` 与 `470879a305438fc958acfc6486f1f86bcd94b681` 的 `projects/agent-poker/evidence.json`(含一次真实多人摊牌)作为**历史事实**的适用范围声明。证据须给出完整命令与原始输出,不得只用私有路径作交接。 3. **本轮新增真实模型调用必须为 `0`**:不得调用真实模型、不得运行 `real-check.mjs`、不得重复昂贵对局;不得读取环境方或其他角色/根执行者私有目录、数据库、模型日志。 4. **不得回归、不得动冻结**:`acceptance/FROZEN*.sha256` 等 `31` 个冻结 blob 必须继续全部匹配;重跑 `npm ci --prefix projects/agent-poker`、`npm run build --prefix projects/agent-poker`、`node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs`(应仍为 `11/11`)并记录原始输出;扫描新增公开文件不得含邀请 token、管理凭据或模型密钥。 5. **报告纪律**:报告首页须写明“本报告非 `pass` 时评审拒绝是正确门禁”,并明确:本次返工**不、也不能**修改正在运行的公网部署与隧道,最终部署对齐由环境方按既有授权完成;若本轮返工实际导致构建产物或后端源码变化(按上述边界应当不会),必须如实报告“现有部署不再适用”,不得把旧部署冒充最终候选。`dispatchPhase = launching` 属登记现象,不构成缺陷。 6. **交付**:推送目标分支、工作树干净,回报**新的最终候选 SHA**,供控制面 `refresh` 后在同一 SHA 与需求 revision `1` 上重派独立全量 CR 与独立 QA;开发不得自行宣布最终验收通过。 现在开始执行本轮修正。 ### 目标与验收 使用本控制面的真实协作流程,自行组织开发、独立 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:`d1a5f6734e751dca5b7e9d8a1388218b25310558` 开发分支:`ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-12` 目标分支:`deliveries/agent-poker-final` 只在自己的 clone 工作,不读其他角色目录或日志。所有交接通过本 Issue 与远端 Git。不得弱化冻结验收。开发须确保候选包含分配的基线 SHA(必要时合并或变基),然后提交、push、创建 PR;独立 CR/QA 须实际检查固定 SHA,并把完整证据提交到独立证据分支或仓库评论。 使用当前会话的 worker 桥读取任务、创建 PR、发布中文 Markdown 报告;stdout 不是报告。 <!-- ppanel-issue:1856bcd8-96c3-4342-abfe-98bd1968bba2 -->
Author
Owner

任务分配:developer

根任务:#72

分配原因

编排决定:dispatch(revision 1 第三轮开发修正:绑定最终源码/构建/运行身份,闭合 QA 遗留移交缺口)

权威需求版本(goal revision):1;本次为开发修正轮次递增,不改变需求版本,不递增也不臆造 revision。

可信失败来源

  • 根任务 71c1c0f7-69c9-487e-98a2-776bd0872c4f(Issue #72),状态 reviewing,基线 411cea6bd5a55848791051f4c47da325626ecb76,当前候选 d1a5f6734e751dca5b7e9d8a1388218b25310558(PR #97)。
  • 同 SHA、同 revision 1 的门禁:独立全量 CR run 8b8d4f08-ffeb-4aac-9624-cd551b6a659f(Issue #98)pass;独立 QA run 802873d1-9e34-4ec8-be6b-05bf6c3beaf9(Issue #99)changes_requested。按门禁,QA 非 pass 时不得 merge,也不得沿用旧 SHA 通过记录(控制面已拒绝在同一 SHA 上重派 QA),故必须返工。
  • 失败项定性(决定返工范围):QA 的全部阻断项都不是规则或隐私代码缺陷——项 4(可访问与安全 pass、最终候选部署一致性 fail)、项 5 后半(修复后源码缺少部署态运行证明)、项 6/9(最终部署绑定 fail/未完成);其本地项全部 pass(安装、构建、node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs 为 11/11 含 R1/R2、api-check.mjs、Chrome 邀请 hashchange 与三份独立新页、未授权 models/私有 observation 为 403、冻结 31 个 blob 全匹配)。QA 采样时公网为 index-FU5_FpP1.js/index-BEOPO_nE.css;环境方随后在 评论 19435 报告已将公网静态资源对齐 d1a5f673 的完整 Git 构建、后端与 a0737d41 逐字等价,并在 评论 19429 报告新桌 52e49afe-dd88-4d89-9cfa-e7b750c9e1e1 上完成三手真实对局(每手与所有状态 3000、24 次成功响应/23 应用/1 暂停后未应用/1 错误、DeepSeek 与 GLM)。部署对齐本身属环境/部署方职责,不在开发返工范围;开发不得触碰 4399 源站、隧道与 4498/4497 控制面。

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

  1. 不得修改任何运行逻辑与构建输入:projects/agent-poker/game.mjs、server.mjs、persistence.mjs、models.mjs、ui.jsx、style.css、test.mjs、api-check.mjs、browser-check.mjs、package.json、package-lock.json 必须与 d1a5f673 逐字相同,以保证 npm run build 产物的资源名与摘要不变(应仍为 index-BO_t9cEz.js、index-CU526T7U.css),现有已对齐的公网部署不因本轮返工失效。若你发现任何必须改运行逻辑的问题,不要顺手改:在报告中单列并给出可复现证据,交控制面决定;不得弱化门禁或自行扩大范围。
  2. 允许且要求的改动只有项目文档与证据目录:
    • projects/agent-poker/README.md:如实写明最终候选 d1a5f673 的源码/构建/运行身份绑定、公网部署现状(源 127.0.0.1:4399、环境方 Git 证据(评论 19435)说明的静态资源与后端等价关系)、临时地址生命周期与局限,以及真实对局证据的适用范围判据(只有后端源码逐字等价时才可复用;历史证据不得冒称本轮新调用)。
    • 新增 projects/agent-poker/evidence/<本轮新目录>,包含可复现的源码身份比对脚本与原始输出:(i) a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc 部署所用后端源码与 d1a5f673 在 server.mjs、game.mjs、persistence.mjs、models.mjs、package.json、锁文件上的逐字/摘要比较;(ii) 本候选自身 npm run build 产物摘要(供部署方与后续 QA 直接比对公网资源);(iii) 0afa4df50967e881a700231022c13f4e30d9d2f1 下 evidence/issue-35-final 与 470879a305438fc958acfc6486f1f86bcd94b681 的 projects/agent-poker/evidence.json(含一次真实多人摊牌)作为历史事实的适用范围声明。证据须给出完整命令与原始输出,不得只用私有路径作交接。
  3. 本轮新增真实模型调用必须为 0:不得调用真实模型、不得运行 real-check.mjs、不得重复昂贵对局;不得读取环境方或其他角色/根执行者私有目录、数据库、模型日志。
  4. 不得回归、不得动冻结:acceptance/FROZEN*.sha256 等 31 个冻结 blob 必须继续全部匹配;重跑 npm ci --prefix projects/agent-poker、npm run build --prefix projects/agent-poker、node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs(应仍为 11/11)并记录原始输出;扫描新增公开文件不得含邀请 token、管理凭据或模型密钥。
  5. 报告纪律:报告首页须写明“本报告非 pass 时评审拒绝是正确门禁”,并明确:本次返工不、也不能修改正在运行的公网部署与隧道,最终部署对齐由环境方按既有授权完成;若本轮返工实际导致构建产物或后端源码变化(按上述边界应当不会),必须如实报告“现有部署不再适用”,不得把旧部署冒充最终候选。dispatchPhase = launching 属登记现象,不构成缺陷。
  6. 交付:推送目标分支、工作树干净,回报新的最终候选 SHA,供控制面 refresh 后在同一 SHA 与需求 revision 1 上重派独立全量 CR 与独立 QA;开发不得自行宣布最终验收通过。

现在开始执行本轮修正。

目标与验收

使用本控制面的真实协作流程,自行组织开发、独立 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:d1a5f6734e751dca5b7e9d8a1388218b25310558
开发分支:ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-12
目标分支: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` 第三轮开发修正:绑定最终源码/构建/运行身份,闭合 QA 遗留移交缺口) **权威需求版本(goal revision):1;本次为开发修正轮次递增,不改变需求版本,不递增也不臆造 revision。** ### 可信失败来源 - 根任务 `71c1c0f7-69c9-487e-98a2-776bd0872c4f`([Issue #72](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72)),状态 `reviewing`,基线 `411cea6bd5a55848791051f4c47da325626ecb76`,当前候选 `d1a5f6734e751dca5b7e9d8a1388218b25310558`([PR #97](https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/97))。 - 同 SHA、同 revision `1` 的门禁:独立全量 CR run `8b8d4f08-ffeb-4aac-9624-cd551b6a659f`([Issue #98](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/98))`pass`;独立 QA run `802873d1-9e34-4ec8-be6b-05bf6c3beaf9`([Issue #99](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/99))`changes_requested`。按门禁,QA 非 `pass` 时不得 `merge`,也不得沿用旧 SHA 通过记录(控制面已拒绝在同一 SHA 上重派 QA),故必须返工。 - **失败项定性(决定返工范围)**:QA 的全部阻断项都不是规则或隐私代码缺陷——项 4(可访问与安全 `pass`、**最终候选部署一致性 `fail`**)、项 5 后半(修复后源码缺少部署态运行证明)、项 6/9(最终部署绑定 `fail`/未完成);其本地项全部 `pass`(安装、构建、`node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs` 为 `11/11` 含 `R1`/`R2`、`api-check.mjs`、Chrome 邀请 `hashchange` 与三份独立新页、未授权 `models`/私有 observation 为 `403`、冻结 `31` 个 blob 全匹配)。QA 采样时公网为 `index-FU5_FpP1.js`/`index-BEOPO_nE.css`;环境方随后在 [评论 19435](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72#issuecomment-19435) 报告已将公网静态资源对齐 `d1a5f673` 的完整 Git 构建、后端与 `a0737d41` 逐字等价,并在 [评论 19429](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72#issuecomment-19429) 报告新桌 `52e49afe-dd88-4d89-9cfa-e7b750c9e1e1` 上完成三手真实对局(每手与所有状态 `3000`、`24` 次成功响应/`23` 应用/`1` 暂停后未应用/`1` 错误、DeepSeek 与 GLM)。部署对齐本身属**环境/部署方职责**,不在开发返工范围;开发不得触碰 `4399` 源站、隧道与 `4498`/`4497` 控制面。 ### 本轮返工边界(第 3 次开发修正,需求版本仍为 `1`) 1. **不得修改任何运行逻辑与构建输入**:`projects/agent-poker/game.mjs`、`server.mjs`、`persistence.mjs`、`models.mjs`、`ui.jsx`、`style.css`、`test.mjs`、`api-check.mjs`、`browser-check.mjs`、`package.json`、`package-lock.json` 必须与 `d1a5f673` **逐字相同**,以保证 `npm run build` 产物的资源名与摘要不变(应仍为 `index-BO_t9cEz.js`、`index-CU526T7U.css`),现有已对齐的公网部署不因本轮返工失效。若你发现任何必须改运行逻辑的问题,不要顺手改:在报告中单列并给出可复现证据,交控制面决定;不得弱化门禁或自行扩大范围。 2. **允许且要求的改动只有项目文档与证据目录**: - `projects/agent-poker/README.md`:如实写明最终候选 `d1a5f673` 的源码/构建/运行身份绑定、公网部署现状(源 `127.0.0.1:4399`、环境方 Git 证据([评论 19435](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72#issuecomment-19435))说明的静态资源与后端等价关系)、临时地址生命周期与局限,以及**真实对局证据的适用范围判据**(只有后端源码逐字等价时才可复用;历史证据不得冒称本轮新调用)。 - 新增 `projects/agent-poker/evidence/<本轮新目录>`,包含可复现的**源码身份比对脚本与原始输出**:(i) `a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc` 部署所用后端源码与 `d1a5f673` 在 `server.mjs`、`game.mjs`、`persistence.mjs`、`models.mjs`、`package.json`、锁文件上的逐字/摘要比较;(ii) 本候选自身 `npm run build` 产物摘要(供部署方与后续 QA 直接比对公网资源);(iii) `0afa4df50967e881a700231022c13f4e30d9d2f1` 下 `evidence/issue-35-final` 与 `470879a305438fc958acfc6486f1f86bcd94b681` 的 `projects/agent-poker/evidence.json`(含一次真实多人摊牌)作为**历史事实**的适用范围声明。证据须给出完整命令与原始输出,不得只用私有路径作交接。 3. **本轮新增真实模型调用必须为 `0`**:不得调用真实模型、不得运行 `real-check.mjs`、不得重复昂贵对局;不得读取环境方或其他角色/根执行者私有目录、数据库、模型日志。 4. **不得回归、不得动冻结**:`acceptance/FROZEN*.sha256` 等 `31` 个冻结 blob 必须继续全部匹配;重跑 `npm ci --prefix projects/agent-poker`、`npm run build --prefix projects/agent-poker`、`node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs`(应仍为 `11/11`)并记录原始输出;扫描新增公开文件不得含邀请 token、管理凭据或模型密钥。 5. **报告纪律**:报告首页须写明“本报告非 `pass` 时评审拒绝是正确门禁”,并明确:本次返工**不、也不能**修改正在运行的公网部署与隧道,最终部署对齐由环境方按既有授权完成;若本轮返工实际导致构建产物或后端源码变化(按上述边界应当不会),必须如实报告“现有部署不再适用”,不得把旧部署冒充最终候选。`dispatchPhase = launching` 属登记现象,不构成缺陷。 6. **交付**:推送目标分支、工作树干净,回报**新的最终候选 SHA**,供控制面 `refresh` 后在同一 SHA 与需求 revision `1` 上重派独立全量 CR 与独立 QA;开发不得自行宣布最终验收通过。 现在开始执行本轮修正。 ### 目标与验收 使用本控制面的真实协作流程,自行组织开发、独立 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:`d1a5f6734e751dca5b7e9d8a1388218b25310558` 开发分支:`ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-12` 目标分支:`deliveries/agent-poker-final` 只在自己的 clone 工作,不读其他角色目录或日志。所有交接通过本 Issue 与远端 Git。不得弱化冻结验收。开发须确保候选包含分配的基线 SHA(必要时合并或变基),然后提交、push、创建 PR;独立 CR/QA 须实际检查固定 SHA,并把完整证据提交到独立证据分支或仓库评论。 使用当前会话的 worker 桥读取任务、创建 PR、发布中文 Markdown 报告;stdout 不是报告。 <!-- ppanel:{"protocol_version":1,"event_id":"86ff3526-77fa-42c1-b060-177110d35db5","kind":"assignment","task_id":"71c1c0f7-69c9-487e-98a2-776bd0872c4f","run_id":"1856bcd8-96c3-4342-abfe-98bd1968bba2","sender_role":"orchestrator","recipient_role":"developer","goal_revision":1,"base_sha":"411cea6bd5a55848791051f4c47da325626ecb76","head_sha":"d1a5f6734e751dca5b7e9d8a1388218b25310558","work_item_id":100} -->
Author
Owner

developer 执行报告

运行:1856bcd8-96c3-4342-abfe-98bd1968bba2
版本:1
结论:changes_requested
基线:411cea6bd5a55848791051f4c47da325626ecb76
提交:c721a1ccb75119f575e06933b78c430e5db571c2

Issue 100 开发报告:源码身份已绑定,环境静态摘要仍有差异

本报告非 pass 时评审拒绝是正确门禁。

结论:changes_requested。授权范围内的文档与证据补全已提交、推送;固定环境证据的 CSS/HTML 与本候选构建摘要不同,不能宣布最终部署一致或最终验收通过。需控制面交环境方核验此差异,开发不得越权部署或改运行代码。

版本与交付

  • 任务:Issue #100,根任务:Issue #72,需求版本 1。
  • 开发分支:ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-12;目标分支:deliveries/agent-poker-final。仅推送开发分支,未绕过门禁直接更新目标分支。
  • 新候选:c721a1ccb75119f575e06933b78c430e5db571c2;提交。
  • 基线:411cea6bd5a55848791051f4c47da325626ecb76,已核验为候选祖先。
  • 运行源码身份:d1a5f6734e751dca5b7e9d8a1388218b25310558;它不是本次新提交 SHA。
  • 完整可复现证据,含 verify.mjs、冻结清单、安装/构建/测试/身份比对原始输出、公开文件扫描结果。工作树干净,远端开发分支与本地 SHA 相同。

修改与验证

只修改 projects/agent-poker/README.md 并新增 projects/agent-poker/evidence/issue-100-identity/。修正 README 中过期的当前部署描述,明确源码、构建、运行身份及历史对局适用范围;无运行逻辑、测试、依赖、样式、共享 UI 或冻结要求变化。

实际执行:

npm ci --prefix projects/agent-poker
npm run build --prefix projects/agent-poker
node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs
node projects/agent-poker/evidence/issue-100-identity/verify.mjs

安装与构建成功,规则/持久化测试 11/11,包括 R1/R2;冻结 31/31 blob 与正式分配及基线相符。所有既有跟踪文件(本轮 README 除外)与 d1a5f673 逐字一致。后端七个文件在 a0737d41、d1a5f673 与本候选逐字相同。公开文件模式扫描加人工核对未发现邀请 token、管理凭据或模型密钥;未加载模型配置或凭据。提交后再次构建与身份核验,资源摘要保持一致。

未闭合的环境证据差异

环境评论 19435声称已对齐,但固定 Git 环境证据的 build.log 和 deployment.json 实际记录另一组资源。

项目 本候选构建 环境固定 Git 记录
JS 资源名 index-BO_t9cEz.js index-FU5_FpP1.js
JS SHA256 85e2f085961e7ecefd05c84890ab933a78d81a0a97c3f399849f3661969b42ad 相同
CSS 资源名 index-CU526T7U.css index-BEOPO_nE.css
CSS SHA256 8a1d3de5a24abd65b2873a9e0cb04859b977adc46e68db1a4516743cdd58665c 2caad2edf3d2f0067b92a1c035a888592249a03b2a37d12c96309700dc0c3348
HTML SHA256 44d05fc4255104e453f592a25b4fbeda8948ba86886caae4267e7d6852d5041b 0e856f8477c1c91c6b71750b863d0a4f5278b92a1444195d4567b5cb5d1e9538

verify.mjs 原始结果为 environmentBuildMatch: false。脚本退出成功表示源码与冻结断言通过,不表示部署通过。没有证据证明这是新的运行代码缺陷;未擅自修改逻辑,也未臆测差异原因。

本次返工不、也不能修改正在运行的公网部署与隧道,最终部署对齐由环境方按既有授权完成。没有访问或操作 4399 源站、隧道及 4498/4497 控制面。运行源码与构建产物没有因本轮改动而变化;但固定环境记录不能证明静态资源完整适用,不能把旧部署冒充最终候选。公网此刻状态本轮未实测。公网观测 的源 127.0.0.1:4399、Node PID 2303 及启动身份 Sat Sep 12 06:59:02 2026、隧道 PID 70644 均为环境方记录;临时地址依赖本机、网络和隧道存活,不承诺永久可用。

模型证据与后续门禁

新增真实模型调用 0,未运行 real-check.mjs,未读其他角色目录、数据库或私有日志。

新规则三手证据对应 a0737d41 后端,与本候选逐字等价,可交独立角色复核其适用性。环境报告三手、DeepSeek/GLM、24 次成功/23 应用/1 暂停后未应用/1 错误,筹码 3000;第四手未完成不计数。不是本轮新调用,不替代 UI 和部署验证。

旧部署三手证据及旧开发含一次多人摊牌的证据仅为历史事实,旧 game.mjs 与当前不同,不满足完整后端逐字等价判据,不能证明当前规则实际摊牌或验收通过。

dispatchPhase = launching 是登记现象,不构成缺陷。控制面应处理上述环境证据差异;需要评审时必须对同一新候选 c721a1ccb75119f575e06933b78c430e5db571c2 与需求版本 1 重派独立全量 CR/QA,旧 SHA 的通过记录不可沿用。开发没有宣布最终验收通过,也没有代替集成与合入后 QA。

已创建 PR #101,对应上述新候选 SHA 与目标分支,等待控制面后续处理。

证据

## developer 执行报告 运行:`1856bcd8-96c3-4342-abfe-98bd1968bba2` 版本:1 结论:changes_requested 基线:`411cea6bd5a55848791051f4c47da325626ecb76` 提交:`c721a1ccb75119f575e06933b78c430e5db571c2` # Issue 100 开发报告:源码身份已绑定,环境静态摘要仍有差异 本报告非 `pass` 时评审拒绝是正确门禁。 结论:`changes_requested`。授权范围内的文档与证据补全已提交、推送;固定环境证据的 CSS/HTML 与本候选构建摘要不同,不能宣布最终部署一致或最终验收通过。需控制面交环境方核验此差异,开发不得越权部署或改运行代码。 ## 版本与交付 - 任务:[Issue #100](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/100),根任务:[Issue #72](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72),需求版本 `1`。 - 开发分支:`ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-12`;目标分支:`deliveries/agent-poker-final`。仅推送开发分支,未绕过门禁直接更新目标分支。 - 新候选:`c721a1ccb75119f575e06933b78c430e5db571c2`;[提交](https://gitea.d-robotics.cc/peng01.guo/ppanel/commit/c721a1ccb75119f575e06933b78c430e5db571c2)。 - 基线:`411cea6bd5a55848791051f4c47da325626ecb76`,已核验为候选祖先。 - 运行源码身份:`d1a5f6734e751dca5b7e9d8a1388218b25310558`;它不是本次新提交 SHA。 - [完整可复现证据](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/c721a1ccb75119f575e06933b78c430e5db571c2/projects/agent-poker/evidence/issue-100-identity),含 `verify.mjs`、冻结清单、安装/构建/测试/身份比对原始输出、公开文件扫描结果。工作树干净,远端开发分支与本地 SHA 相同。 ## 修改与验证 只修改 `projects/agent-poker/README.md` 并新增 `projects/agent-poker/evidence/issue-100-identity/`。修正 README 中过期的当前部署描述,明确源码、构建、运行身份及历史对局适用范围;无运行逻辑、测试、依赖、样式、共享 UI 或冻结要求变化。 实际执行: ```sh npm ci --prefix projects/agent-poker npm run build --prefix projects/agent-poker node --test projects/agent-poker/test.mjs projects/agent-poker/persistence.test.mjs node projects/agent-poker/evidence/issue-100-identity/verify.mjs ``` 安装与构建成功,规则/持久化测试 `11/11`,包括 `R1`/`R2`;冻结 `31/31` blob 与正式分配及基线相符。所有既有跟踪文件(本轮 README 除外)与 `d1a5f673` 逐字一致。后端七个文件在 `a0737d41`、`d1a5f673` 与本候选逐字相同。公开文件模式扫描加人工核对未发现邀请 token、管理凭据或模型密钥;未加载模型配置或凭据。提交后再次构建与身份核验,资源摘要保持一致。 ## 未闭合的环境证据差异 [环境评论 19435](https://gitea.d-robotics.cc/peng01.guo/ppanel/issues/72#issuecomment-19435)声称已对齐,但[固定 Git 环境证据](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/b2347b72abc8dac917003cf709637ca5cab370c7/evidence/issue-35-d1)的 `build.log` 和 `deployment.json` 实际记录另一组资源。 | 项目 | 本候选构建 | 环境固定 Git 记录 | | --- | --- | --- | | JS 资源名 | `index-BO_t9cEz.js` | `index-FU5_FpP1.js` | | JS SHA256 | `85e2f085961e7ecefd05c84890ab933a78d81a0a97c3f399849f3661969b42ad` | 相同 | | CSS 资源名 | `index-CU526T7U.css` | `index-BEOPO_nE.css` | | CSS SHA256 | `8a1d3de5a24abd65b2873a9e0cb04859b977adc46e68db1a4516743cdd58665c` | `2caad2edf3d2f0067b92a1c035a888592249a03b2a37d12c96309700dc0c3348` | | HTML SHA256 | `44d05fc4255104e453f592a25b4fbeda8948ba86886caae4267e7d6852d5041b` | `0e856f8477c1c91c6b71750b863d0a4f5278b92a1444195d4567b5cb5d1e9538` | `verify.mjs` 原始结果为 `environmentBuildMatch: false`。脚本退出成功表示源码与冻结断言通过,不表示部署通过。没有证据证明这是新的运行代码缺陷;未擅自修改逻辑,也未臆测差异原因。 本次返工不、也不能修改正在运行的公网部署与隧道,最终部署对齐由环境方按既有授权完成。没有访问或操作 `4399` 源站、隧道及 `4498`/`4497` 控制面。运行源码与构建产物没有因本轮改动而变化;但固定环境记录不能证明静态资源完整适用,不能把旧部署冒充最终候选。公网此刻状态本轮未实测。[公网观测](https://laws-forming-bare-remedies.trycloudflare.com) 的源 `127.0.0.1:4399`、Node PID `2303` 及启动身份 `Sat Sep 12 06:59:02 2026`、隧道 PID `70644` 均为环境方记录;临时地址依赖本机、网络和隧道存活,不承诺永久可用。 ## 模型证据与后续门禁 新增真实模型调用 `0`,未运行 `real-check.mjs`,未读其他角色目录、数据库或私有日志。 [新规则三手证据](https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/044810adf30631167aae0b89793917d91bfed93c/evidence/issue-35-a073)对应 `a0737d41` 后端,与本候选逐字等价,可交独立角色复核其适用性。环境报告三手、DeepSeek/GLM、`24` 次成功/`23` 应用/`1` 暂停后未应用/`1` 错误,筹码 `3000`;第四手未完成不计数。不是本轮新调用,不替代 UI 和部署验证。 [旧部署三手证据](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)仅为历史事实,旧 `game.mjs` 与当前不同,不满足完整后端逐字等价判据,不能证明当前规则实际摊牌或验收通过。 `dispatchPhase = launching` 是登记现象,不构成缺陷。控制面应处理上述环境证据差异;需要评审时必须对同一新候选 `c721a1ccb75119f575e06933b78c430e5db571c2` 与需求版本 `1` 重派独立全量 CR/QA,旧 SHA 的通过记录不可沿用。开发没有宣布最终验收通过,也没有代替集成与合入后 QA。 已创建 [PR #101](https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/101),对应上述新候选 SHA 与目标分支,等待控制面后续处理。 ### 证据 - https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/101 - https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/c721a1ccb75119f575e06933b78c430e5db571c2/projects/agent-poker/evidence/issue-100-identity - https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/b2347b72abc8dac917003cf709637ca5cab370c7/evidence/issue-35-d1 <!-- ppanel:{"protocol_version":1,"event_id":"95dcdf77-f4d1-4ac6-9f51-88a99f36a19c","kind":"result","task_id":"71c1c0f7-69c9-487e-98a2-776bd0872c4f","work_item_id":100,"run_id":"1856bcd8-96c3-4342-abfe-98bd1968bba2","sender_role":"developer","goal_revision":1,"base_sha":"411cea6bd5a55848791051f4c47da325626ecb76","head_sha":"c721a1ccb75119f575e06933b78c430e5db571c2","conclusion":"changes_requested","evidence_links":["https://gitea.d-robotics.cc/peng01.guo/ppanel/pulls/101","https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/c721a1ccb75119f575e06933b78c430e5db571c2/projects/agent-poker/evidence/issue-100-identity","https://gitea.d-robotics.cc/peng01.guo/ppanel/src/commit/b2347b72abc8dac917003cf709637ca5cab370c7/evidence/issue-35-d1"]} -->
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#100
No description provided.