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

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

任务分配:developer

根任务:#72

分配原因

开发修正(revision 1)。

目标与验收

使用本控制面的真实协作流程,自行组织开发、独立 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:a3fce77317c99cc68fb05fa0c1934fd62999cd3f
开发分支:ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-6
目标分支: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 ### 分配原因 开发修正(revision 1)。 ### 目标与验收 使用本控制面的真实协作流程,自行组织开发、独立 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:`a3fce77317c99cc68fb05fa0c1934fd62999cd3f` 开发分支:`ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-6` 目标分支:`deliveries/agent-poker-final` 只在自己的 clone 工作,不读其他角色目录或日志。所有交接通过本 Issue 与远端 Git。不得弱化冻结验收。开发须确保候选包含分配的基线 SHA(必要时合并或变基),然后提交、push、创建 PR;独立 CR/QA 须实际检查固定 SHA,并把完整证据提交到独立证据分支或仓库评论。 使用当前会话的 worker 桥读取任务、创建 PR、发布中文 Markdown 报告;stdout 不是报告。 <!-- ppanel-issue:e6289cea-dfc7-40eb-99e7-b1ea880fdff9 -->
Author
Owner

任务分配:developer

根任务:#72

分配原因

开发修正(revision 1)。

目标与验收

使用本控制面的真实协作流程,自行组织开发、独立 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:a3fce77317c99cc68fb05fa0c1934fd62999cd3f
开发分支:ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-6
目标分支: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 ### 分配原因 开发修正(revision 1)。 ### 目标与验收 使用本控制面的真实协作流程,自行组织开发、独立 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:`a3fce77317c99cc68fb05fa0c1934fd62999cd3f` 开发分支:`ppanel/71c1c0f7-69c9-487e-98a2-776bd0872c4f/r1-6` 目标分支:`deliveries/agent-poker-final` 只在自己的 clone 工作,不读其他角色目录或日志。所有交接通过本 Issue 与远端 Git。不得弱化冻结验收。开发须确保候选包含分配的基线 SHA(必要时合并或变基),然后提交、push、创建 PR;独立 CR/QA 须实际检查固定 SHA,并把完整证据提交到独立证据分支或仓库评论。 使用当前会话的 worker 桥读取任务、创建 PR、发布中文 Markdown 报告;stdout 不是报告。 <!-- ppanel:{"protocol_version":1,"event_id":"c9ff3b13-fe9e-4972-b581-fe64a22f93dc","kind":"assignment","task_id":"71c1c0f7-69c9-487e-98a2-776bd0872c4f","run_id":"e6289cea-dfc7-40eb-99e7-b1ea880fdff9","sender_role":"orchestrator","recipient_role":"developer","goal_revision":1,"base_sha":"411cea6bd5a55848791051f4c47da325626ecb76","head_sha":"a3fce77317c99cc68fb05fa0c1934fd62999cd3f","work_item_id":88} -->
Author
Owner

developer 执行报告

运行:e6289cea-dfc7-40eb-99e7-b1ea880fdff9
版本:1
结论:pass
基线:411cea6bd5a55848791051f4c47da325626ecb76
提交:a0737d41f02a8b38bc8c3f72fccfdf23e6d6d4bc

Issue #88 开发修正报告

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

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

修复与范围

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

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

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

实际验证

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

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

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

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

规则与持久化输出

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

构建输出


> build
> vite build

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

✓ built in 479ms

HTTP 与浏览器输出

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

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

证据适用范围与剩余门禁

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

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

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

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

证据

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