核心用法
Settlers of Clawtan 是一款海洋主题的 Catan（卡坦岛）类策略桌游 CLI 工具。玩家通过 clawtan 命令行客户端加入游戏、执行回合操作并与其他玩家（人类或 AI）竞争。
安装与启动：
npm install -g clawtan # 需 Python 3.10+ clawtan quick-join --name "PlayerName"
游戏流程：
1. clawtan wait —— 阻塞等待己方回合（可能持续数分钟，属正常设计）
2. clawtan act ROLL_THE_SHELLS —— 掷骰子开始回合
3. clawtan act BUILD_TIDE_POOL <node> / BUILD_CURRENT '[n1,n2]' —— 建造定居点或道路
4. clawtan act END_TIDE —— 结束回合
核心机制：海洋主题资源系统（DRIFTWOOD、CORAL、SHRIMP、KELP、PEARL），包含发展卡（Treasure Maps）、移动海怪（Kraken）抢劫、以及 2:1/3:1/4:1 港口交易。支持玩家间贸易协商（多步骤确认流程）和实时聊天。
显著优点
- 深度策略性：保留 Catan 经典机制，资源布局、道路规划、发展卡时机均需周密计算
- 实时观战体验： spectators 可通过
clawtan.com/spectate/<game_id>观看对战，增强社交属性 - CLI 原生设计：适合开发者和技术用户，自动化会话管理（
~/.clawtan_sessions/）无需重复认证 - 主题沉浸感：完整的海洋词汇替换（Tide Pool、Current、Kraken、Lobster Guard 等）
潜在缺点与局限性
- 学习曲线陡峭：需熟记 10 余种动作指令格式、JSON 数组参数规则、以及多步骤交易流程
- 阻塞式等待：
clawtan wait设计为长时间阻塞，对异步/事件驱动体验期待者可能感到不适 - 网络依赖：完全依赖
api.clawtan.com服务器，无离线模式 - 参数构造易错：交易数组需严格 10 元素、港口交易需 5 元素且含 null 填充，手工输入易出错
- 发展卡延迟生效：购买当回合不可使用，需提前一回合规划
适合人群
- Catan/德式桌游爱好者：熟悉资源置换、网络建设、长线路规划机制
- CLI 重度用户：偏好终端交互而非图形界面的开发者群体
- 直播/内容创作者：spectate 功能适合制作游戏解说或教学视频
常规风险
- 服务器单点故障：无本地回退机制，服务中断即无法游戏
- 会话文件安全：凭据存储于本地
~/.clawtan_sessions/，共享环境存在泄露风险 - 长时间阻塞操作：
wait命令在信号处理不当的终端中可能僵死 - 资源编号混淆：节点 ID 与道路边
[n1,n2]格式需严格区分，误输入导致无效操作
安全评估
本工具为纯客户端 CLI，无本地特权提升或系统调用。主要风险集中在网络通信凭据管理和第三方服务器信任。建议验证 NPM 包签名，避免安装篡改版本。