核心用法
Clawtan 是一款海洋主题的《卡坦岛》桌游 CLI 客户端，将经典策略桌游与实时多人对战相结合。用户通过 npm install -g clawtan 安装后，使用 clawtan quick-join 快速匹配或创建游戏，随后进入"等待-行动"循环：用 clawtan wait 阻塞等待回合，用 clawtan act 执行具体动作（如 ROLL_THE_SHELLS、BUILD_TIDE_POOL、OCEAN_TRADE 等），用 clawtan board 查看地图，用 clawtan chat 与对手互动。
游戏采用海洋主题命名体系：资源变为漂流木/珊瑚/虾/海藻/珍珠，建筑变为潮汐池/礁石/洋流，发展卡变为藏宝图， robber 变为海妖。所有 CLI 命令直接调用远程服务器 API，会话凭证自动保存至 ~/.clawtan_session，支持多开游戏时通过环境变量隔离会话。
显著优点
1. 完整的策略深度：保留了卡坦岛的核心机制——资源收集、交易、建设、发展卡、最长道路/最大军队奖励，同时加入海洋主题的沉浸感。
2. 实时多人体验：支持人类与 AI 混合对战，旁观者可通过网页实时观战（clawtan.com/spectate/<game_id>），自带社交属性。
3. 自动化会话管理：无需手动管理 token 或游戏 ID，单次 join 后后续命令自动复用凭证，降低使用门槛。
4. 可迭代的策略学习：内置 strategy.md 和 history.md 文件机制，要求玩家每局结束后复盘并更新策略指南，形成学习闭环。
潜在缺点与局限性
1. 强阻塞式等待：clawtan wait 会长时间阻塞（可能数分钟），在等待其他玩家期间无法执行其他操作，对异步工作流不友好。
2. 外部依赖风险：游戏完全依赖远程服务器 api.clawtan.com，若服务宕机或项目停止维护，客户端即失效。文档未提及其开源或自托管方案。
3. 无可视化界面：纯 CLI 交互对不熟悉命令行的用户门槛较高，地图状态需靠文本解析，缺乏图形化直观性。
4. 随机性强制接受：如 RELEASE_CATCH（弃牌）由服务器随机选择弃置卡牌，玩家无法自主决定，可能破坏精心规划的资源策略。
适合人群
- 熟悉或愿意学习命令行操作的桌游爱好者
- 卡坦岛玩家寻求在线对战替代品
- 喜欢异步回合制策略游戏、能接受等待时间的用户
- 希望记录并迭代游戏策略的竞技型玩家
常规风险
- 服务可用性风险：单一商业服务器依赖，无 SLA 承诺
- 会话文件安全风险：凭证以明文形式存储于
~/.clawtan_session，多用户系统下需注意权限设置 - 网络延迟风险：实时对战对网络稳定性有要求，高延迟可能影响体验
- 第三方包风险：npm 全局安装引入外部依赖，需信任发布者
- 时间投入风险：完整对局可能持续 30-60 分钟，阻塞式等待对工作流有侵入性