核心用法
ClawQuest: Agent Mine是一款面向ClawQuest游戏的托管式挖矿管理工具，通过调用游戏公开API实现自动化资源采集。用户需先在游戏内生成apiCode，通过set_api_code完成一次性配置后，即可调用start_mining_session启动自动化挖矿循环。
工具集涵盖完整的挖矿生命周期管理：
- 认证管理：
set_api_code/get_api_code/clear_api_code实现API密钥的持久化与多账户支持 - 基础操作：
start_mining/end_mining/check_mining_state控制单轮挖矿 - 资源管理：
buy_stamina/get_stamina监控体力与钻石消耗 - 自动化核心：
start_managed_mining_loop/start_mining_session实现全自动循环，包含预估等待、状态轮询、奖励记录、异常恢复等完整流程
推荐调用顺序：配置API密钥 → 启动托管会话 → 轮询事件流或状态接口 → 按需安全停止。
显著优点
1. 托管式自动化：无需持续人工干预，支持预估等待时间与智能轮询，显著降低操作负担
2. 完善的容错机制：可配置maxConsecutiveErrorCount自动止损，支持autoBuyStamina自动补充体力防止中断
3. 灵活的环境配置：9项环境变量覆盖超时、轮询间隔、事件缓冲区等关键参数，适应不同网络与策略需求
4. 事件驱动架构：get_mining_session_events提供增量事件流，便于外部系统集成与状态监控
5. 多账户支持：通过cacheKey机制支持多API密钥并行管理
潜在缺点与局限性
1. 认证前置依赖：需用户手动在游戏客户端生成apiCode，工具本身不具备登录能力，新手门槛较高
2. API稳定性风险：依赖第三方游戏服务器(svr.km.noyagames.cn)，服务变更或封禁策略调整可能导致功能失效
3. 资源消耗不透明：自动购买体力功能若配置不当，可能在无感知情况下消耗大量钻石
4. 反作弊政策模糊：自动化操作可能违反游戏服务条款，存在账号限制风险（文档未明确合规声明）
5. 调试信息有限：错误处理依赖HTTP状态码，缺乏详细的业务错误码映射说明
适合人群
- 休闲型玩家：希望离线期间持续获取游戏资源的用户
- 多账号运营者：需要管理多个游戏角色的工作室或高级玩家
- 自动化爱好者：希望将游戏资源采集纳入个人工作流的技术用户
常规风险
- 账号安全风险：API密钥以明文JSON形式本地存储，共享环境或权限配置不当可能导致密钥泄露
- 经济风险：
autoBuyStamina功能可能造成意外钻石消耗，建议配合autoBuyStaminaMaxFailures限制使用 - 合规风险：自动化工具可能触发游戏反作弊机制，建议控制调用频率并关注官方政策更新
- 服务中断风险：游戏API域名或协议变更将导致工具失效，需关注版本更新