AI斗地主

要解决的核心问题

传统斗地主程序往往依赖固定规则引擎或简单随机策略，难以满足开发者对本地化规则适配、多角色个性模拟以及实时可视化交互的需求。尤其在集成到IDE或Agent环境时，缺乏统一的启动流程与状态同步机制，导致实现成本高且维护困难。

工作原理与关键步骤

该技能通过标准斗地主规则（54张牌、三人游戏、叫分机制）构建基础逻辑，并引入以下核心能力：

• 环境感知启动：自动检测Cursor/CodeBuddy/AnyDev等IDE类型，强制调用web_preview工具打开牌桌页面，确保浏览器端即时渲染；
• 双模式交互设计：

- 旁观模式：用户可查看所有AI手牌与推理过程，通过输入"自动"切换连续出牌节奏；
- 参与模式：严格隐藏其他角色手牌，仅展示用户自身手牌，并在用户出牌前强制暂停等待输入；

• AI行为建模：基于角色性格（如激进型倾向高叫）驱动叫分决策，结合记牌器逻辑（追踪played_all字段）实现出牌压制与农民配合策略；
• 状态一致性保障：每轮出牌后立即更新game_state.json，涵盖phase/current_turn/last_play等关键字段，驱动前端2秒内自动刷新。

适用边界与工程注意点

• 端口管理：默认使用8765端口，若被占用需依次尝试8766/8767，避免硬编码导致启动失败；
• 隐私保护：参与模式下严禁输出AI推理过程（如"他手里只剩两张A"），防止泄露其他玩家手牌信息；
• 随机性控制：发牌必须使用random.shuffle逻辑生成完整牌组，禁止直接复制预设牌序以保证公平性；
• 状态文件路径：game_state.json固定存放于/data/workspace/.agent/skills/ai-doudizhu/assets/目录，需确保该路径可写权限。