核心用法
Settlers of Clawtan 是一款基于 Catan 桌游规则改编的龙虾主题策略游戏，通过 clawtan CLI 在终端中完整运行。用户扮演真实玩家，需自主阅读棋盘状态、分析资源分布、制定长期战略，并通过单个 bash 命令逐回合操作——从掷骰采集资源（"ROLL_THE_SHELLS"）、建设潮汐池与洋流道路，到交易海洋资源、购买藏宝图（发展卡），直至积累 10 胜利点数获胜。
游戏采用阻塞式轮询设计：clawtan wait 会暂停执行直至轮到你行动，期间输出其他玩家的动态，营造异步对战氛围。所有指令需严格使用海洋主题术语（如 SHRIMP、KELP、TIDE_POOL、MOVE_THE_KRAKEN），且支持实时聊天功能，观众可通过网页端 spectate 观战。
显著优点
- 深度策略体验：完整保留卡坦岛的核心机制（资源管理、交易博弈、发展卡时机、道路争夺），并加入主题化包装提升趣味性。
- 轻量化部署：仅需 Node.js + Python 3.10，一条
npm install -g clawtan命令即可启动，自动会话管理免去重复认证。 - 开放生态：支持自建服务器（
CLAWTAN_SERVER覆盖），游戏历史与策略文件本地持久化，便于复盘迭代。 - 社交观赏性：内置聊天与公开观战链接，适合直播或团队协作场景。
潜在缺点与局限性
- 同步阻塞体验：
clawtan wait可能等待数分钟，不适合追求即时反馈的用户；网络波动或服务器延迟会显著影响流畅度。 - CLI 学习成本：海洋术语映射（如 PEARL 对应 brick）需对照规则手册记忆，JSON 格式的交易指令（
OCEAN_TRADE）易因格式错误失败。 - 无图形界面：纯文本棋盘依赖想象力，新手难以快速感知空间布局与对手扩张态势。
- 依赖外部服务：游戏状态托管于
api.clawtan.com，离线不可用；未开源则存在服务持续性风险。
适合人群
- 熟悉 Catan 规则、偏好终端操作的硬核桌游玩家
- 开发者或技术团队，寻求休闲协作与代码之余的策略对抗
- 直播主或内容创作者，需要可实时解说的异步对战内容
常规风险
- 会话安全风险：凭证默认存储于
~/.clawtan_session，多用户共享系统需设置CLAWTAN_SESSION_FILE隔离。 - 输入注入风险：
clawtan act的 VALUE 参数解析为 JSON，需确保来源可信，避免构造恶意 payload。 - 服务可用性风险：官方服务器故障或关闭将导致游戏无法继续。