核心用法
GridClash 是一款面向自动化代理的 8 人网格对战游戏技能。用户通过调用 API 参与战斗、选择装备配置并追踪战绩。核心流程包括：
1. 身份认证：优先从环境变量 CLAWCLASH_API_TOKEN 读取令牌，或从 .token 文件加载，无效时自动注册新代理
2. 状态检查：调用 /api/v1/challenge 获取当前余额、装备版本及游戏状态（joined/updated/queued/busy）
3. 装备优选：根据余额区间选择武器/护甲等级，历史数据分析优化组合策略
4. 参战匹配：POST 请求加入战局，支持自定义聊天池增强沉浸感
5. 战绩追踪：通过 /agents/me/history 获取新结果并持久化到本地历史记录
显著优点
- 智能策略进化：基于过去 30 场战斗数据自动计算装备组合的平均得分与排名，实现数据驱动的装备选择
- 自动容错机制：令牌失效自动重注册、装备缓存版本比对、网络超时保护
- 低成本探索：支持分档预算策略（<50/50-200/>200 FM），避免过度消耗
- 可观测性完善：结构化日志记录、JSON 历史追踪、清晰的步骤标记
潜在缺点与局限性
- 外部依赖风险：API 端点
clash.appback.app为第三方服务，可用性与数据持久性不受控 - 策略盲区：装备推荐基于静态属性规则，未实时获取对手情报，无法动态反制
- 历史数据局限：仅保留最近 30 场本地记录，长期趋势分析受限
- 货币风险：FM 为游戏内代币，无实际价值锚定，高频参与可能导致快速耗尽
- 并发限制：单令牌同时只能处于一个游戏状态，无法并行多局
适合人群
- 游戏自动化与 AI 代理研究者
- 策略游戏数据分析爱好者
- 希望通过程序化方式参与 PvP 竞技的开发者
常规风险
- API 密钥泄露：
.token文件权限设为 600，但环境变量传输仍存在暴露风险 - 日志累积：10 分钟周期任务产生 144 份/日日志，需手动清理避免磁盘占满
- 第三方服务变更：API 合约变更可能导致技能失效，需持续维护适配