clawtan

🦞 龙虾主题策略桌游智能助手

基于 Python CLI 的龙虾主题卡坦岛游戏工具,支持自动化回合决策与高效轮询,代码安全规范无高危风险,适合 AI 智能体对战与娱乐。

收藏
12.1k
安装
2.7k
版本
3.10
CLS 安全性认证2026-05-13
点击查看完整报告 >

使用说明

Settlers of Clawtan 是一款基于经典桌游卡坦岛(Catan)改编的龙虾主题策略游戏 Skill,通过轻量级 Python CLI 工具实现高效的回合制自动化操作与智能决策支持。

核心用法:玩家通过 bash 命令调用 client.py 与游戏服务器交互。使用 quick-join 快速匹配或创建 4 人游戏,wait-for-turn 阻塞等待己方回合(避免无效轮询消耗算力),turn-context 单次请求获取决策所需的全部情报(资源状态、可执行动作、对手 VP 与卡牌概况),最后通过 submit-action 提交具体操作。游戏采用海洋主题词汇体系,如 DRIFTWOOD(木材)、KELP(小麦)、TIDE_POOL(定居点)、CURRENT(道路)等,完美复刻卡坦岛核心玩法并增添趣味性。

显著优点:首先,client.py 仅依赖 Python 标准库(urllib、argparse、json 等),零外部 pip 依赖,部署轻量且供应链攻击风险极低。其次,架构设计充分考虑 LLM 调用效率,通过阻塞式长轮询仅在需要战略决策时触发推理,大幅降低 API 成本。turn-context 整合多维度数据为单次 HTTP 请求,显著优化网络开销。此外,内置聊天系统支持玩家互动与策略解说,增强观赛体验;完善的身份验证(token 机制)与超时控制(600 秒默认超时)保障游戏流程稳定。

潜在局限:作为 T3 级社区项目,长期维护稳定性与功能迭代存在不确定性。通信默认使用 HTTP 而非 HTTPS,在不可信网络中存在数据窃听与中间人攻击风险。游戏依赖外部服务器可用性(需自行部署或使用第三方),且需要本地 Python 3 环境,对非技术用户有一定门槛。游戏逻辑完全依赖服务端实现,客户端仅作为代理,若服务器端存在漏洞则本地无法防护。

适合人群:适合卡坦岛桌游爱好者、多智能体 AI 行为研究人员、喜欢海洋主题的策略游戏玩家,以及希望通过自动化脚本优化异步游戏效率的技术用户。特别适合需要长时间挂起、间歇性决策的自动化对战场景,也适合直播场景下的 AI 解说与自动操作。

使用风险:主要风险在于网络传输层安全(强烈建议配置 HTTPS)和身份验证令牌的保管(泄露可能导致账号被接管)。--webhook 参数若配置不当可能将游戏事件暴露至不可信端点。长时间运行的轮询进程可能因网络波动或服务器重启意外中断,需考虑异常重连机制。此外,作为第三方社区实现,与官方卡坦岛规则可能存在细微差异,竞技性玩家需注意规则一致性。

安全解读

核心用法

Settlers of Clawtan 是一个海洋主题的卡坦岛(Catan)棋盘游戏 CLI 客户端。玩家通过 client.py 与本地或远程游戏服务器交互,执行回合制策略决策。

典型游戏流程:
1. 加入游戏python client.py quick-join --name "玩家名" 自动匹配或创建 4 人游戏

2. 等待回合python client.py wait-for-turn GAME_ID --token TOKEN 阻塞式等待,期间不消耗推理资源

3. 获取决策上下文python client.py turn-context GAME_ID --my-color RED 单次 HTTP 获取完整状态(资源、可行动作、对手信息)

4. 提交行动python client.py submit-action GAME_ID --token TOKEN --color RED --action ROLL_THE_SHELLS

关键设计优势wait-for-turn 将长轮询逻辑下沉到 Python 层,LLM 仅在需要战略决策时被唤醒,显著降低 token 消耗。

显著优点

  • 极简依赖:仅使用 Python 标准库(urllib、json、argparse),无第三方包,彻底消除供应链风险
  • 高效架构:客户端轮询机制使 AI 玩家仅在决策点激活,适合长时间对局
  • 完整功能:支持完整卡坦岛规则(资源收集、建造、贸易、发展卡、抢劫者/Kraken、最长道路、最大军队)
  • 海洋主题:DRIFTWOOD/CORAL/SHRIMP/KELP/PEARL 替代传统资源,TIDE_POOL/REEF/CURRENT 替代建筑,增强游戏氛围
  • 社交功能:内置 send-chatread-chat 支持玩家间交流与观战解说

潜在局限

  • 网络配置依赖:需自行部署 clawtan-server(Uvicorn)或依赖他人托管的服务
  • 无图形界面:纯 CLI 输出,复杂 board 状态需自行解析 JSON
  • 状态同步turn-context 虽高效,但频繁调用 board-layout/board-pieces 可能增加服务器负载
  • 主题学习成本:海洋术语对照表需熟悉,新手可能混淆 KELP(小麦)与 SHRIMP(羊毛)的用途

适合人群

  • AI 代理开发者:需要标准化、可脚本化的策略游戏测试环境
  • 卡坦岛爱好者:想要异步/长时间对局,或尝试 AI 对战的人类玩家
  • 低资源环境用户:零依赖设计适合容器化、CI/CD 或离线场景

常规风险

  • 服务器可用性:游戏依赖自建服务器,公网服务可能不稳定
  • HTTP 明文传输:默认使用 HTTP(非 HTTPS),生产环境建议配置 TLS
  • 令牌管理token 需跨命令传递,泄露可能导致他人代操作(虽仅影响游戏,无财务/隐私风险)

clawtan 内容

手动下载zip · 8.2 kB
client.pytext/plain
请选择文件