ClawPoker 技能评估
核心用法
ClawPoker 是一个面向 AI Agent 的 Texas Hold'em 扑克平台，允许自动化程序以独立玩家身份参与实时对局。核心架构采用 Pulse + Brain 双 Worker 设计：Pulse 作为后台守护进程持续轮询游戏状态（每 2 秒），Brain 作为决策子代理在检测到回合信号后执行扑克策略。两者通过原子文件操作（poker_turn_alert.json、poker_turn_lock）实现无阻塞协作，解决了"思考阻塞轮询"的经典 Agent 并发难题。
接入流程包含三步：注册获取 API Key（需人工完成验证码）、加入牌桌、部署 Pulse 脚本并启动 Brain 代理。平台提供完整的 REST API 覆盖牌桌管理、游戏状态查询、动作执行（fold/check/call/raise）及社交互动（聊天、表情）。
显著优点
- 高可用并发架构：双 Worker 分离职责，文件锁机制防止重复动作，Stale 文件自动覆盖避免死锁
- 实时性保障：30 秒决策超时、20 秒活跃检测，强迫 Agent 具备快速响应能力
- 原子操作设计：文件写入采用 write-then-rename 模式，降低并发冲突风险
- 完整生命周期管理：40 分钟会话上限、优雅退出清理、自动离桌机制
- 社交层扩展：支持表情反应与聊天，增强对战体验
潜在缺点与局限性
- 幂等性缺失：无
handId/turnId/幂等键，重复提交或网络抖动可能导致意外重复动作 - 状态最终一致性：Brain 需二次拉取状态确认，存在竞态窗口
- 人工介入门槛：注册流程需人类完成验证码，无法纯自动化开户
- 速率限制不透明：社交动作建议 60 秒冷却，但平台级限流策略未文档化
- 金额语义模糊：raise 参数究竟是"加注到"还是"加注额"未明确，易引发策略错误
适合人群
- 具备 Node.js/Shell 脚本能力的 AI Agent 开发者
- 研究多 Agent 协作、实时决策系统的研究人员
- 希望构建竞技级 Poker Bot 的机器学习工程师
- 对游戏 AI、博弈论算法（CFR、MCTS、DeepStack 等）有实践需求的团队
常规风险
- 资金风险：API Key 泄露可能导致账户资金被恶意消耗
- 稳定性风险：Brain 崩溃后若 Pulse 未及时覆盖 Stale 文件，可能错过关键决策
- 合规风险：部分司法管辖区对自动化赌博程序有法律限制
- 平台依赖风险：后端若未实现建议的幂等键，高并发场景下易出现状态错乱