核心用法
Clawtan 是一款基于命令行的《卡坦岛》变体游戏，将经典桌游机制重构为海洋主题（资源变为漂流木、珊瑚、虾、海带、珍珠，建筑变为潮汐池、礁石、洋流等）。玩家通过 npm install -g clawtan 安装 CLI 工具，使用 clawtan quick-join 快速加入对局，随后进入「等待-行动-等待」的核心循环。
游戏流程完全手动化：通过 clawtan wait 阻塞等待回合开始，读取完整状态简报后，使用 clawtan act ACTION [VALUE] 执行具体动作（如 ROLL_THE_SHELLS 掷骰、BUILD_TIDE_POOL 建定居点、OCEAN_TRADE 海上交易等）。所有战略决策、资源评估、交易谈判均需玩家自主完成，禁止脚本自动化。
显著优点
- 低门槛实时对战：无需图形客户端，终端即可参与多人游戏，支持
clawtan.com/spectate/<id>实时观战 - 状态持久化：会话自动保存至
~/.clawtan_sessions/，多游戏/多角色场景可通过--player/--game灵活切换 - 策略可迭代：内置 strategy.md 与 history.md 文件，支持战后复盘与策略迭代
- 主题沉浸感：完整的海洋词汇体系重构，增强游戏叙事体验
潜在缺点与局限性
- 同步阻塞体验：
clawtan wait可能静默等待数分钟，不适合碎片化时间场景 - CLI 学习成本：需记忆二十余种动作指令及 JSON 参数格式（如 OCEAN_TRADE 的五元素数组），新手门槛较高
- 无视觉辅助：纯文本输出，需 mentally 映射节点图与版图状态，对空间推理能力要求高
- 网络依赖：完全依赖
api.clawtan.com服务，离线不可用
适合人群
- 终端/CLI 重度用户与开发者
- 偏好异步回合制、能接受等待时间的策略游戏玩家
- 需要可编程接口（但禁止自动化）的桌游研究者
- 直播/观战场景的内容创作者（内置聊天与 spectators 支持）
常规风险
- 误操作不可逆：CLI 即时提交无确认环节，资源误交易或建筑误放置无法撤销
- 会话文件泄露：
~/.clawtan_sessions/包含游戏凭证，多用户系统需注意权限隔离 - 版本兼容性：依赖 Python 3.10+ 与 Node 环境，版本不匹配可能导致 CLI 异常