核心功能
eve-esi 是面向EVE Online玩家的一站式API管理工具，基于CCP Games官方ESI（EVE Swagger Interface）构建，支持角色数据的全面查询与自动化管理。
核心用法
认证流程：采用OAuth2 PKCE标准，首次运行auth_flow.py完成EVE SSO授权，令牌自动存储于~/.openclaw/eve-tokens.json，支持自动刷新。
数据查询：通过esi_query.py封装所有ESI端点，覆盖：
- 资产与钱包：实时余额、交易记录、资产清单
- 技能管理：训练队列、技能点数、植入体状态
- 位置信息：当前位置、舰船类型、跳跃克隆
- 工业与PI：制造作业、行星开采、忠诚点
- 市场与合同：订单追踪、合同状态、邮件通知
威胁评估：集成zKillboard数据，为低/零安地区PI系统提供实时威胁评级（低/中/高/致命），支持路径规划与安全航线推荐。
显著优点
- 官方接口：直接对接CCP官方ESI，数据权威实时
- 模块化设计：Dashboard配置系统支持告警、报告、市场追踪灵活组合
- 多角色管理：单令牌文件支持多角色切换
- 自动化能力：内置缓存机制、错误退避、分页处理，适合长期运行
潜在局限
- 令牌生命周期：访问令牌约20分钟过期，依赖自动刷新机制
- 速率限制：部分端点（邮件、合同）存在内部限制，可能返回HTTP 520
- 端点稳定性：
/dev/前缀端点可能无预警变更 - Redis依赖：威胁缓存需外部Redis服务
适合人群
- 活跃EVE玩家（工业家、贸易商、PI从业者、PVP指挥官）
- 需要跨角色资产监控的军团管理者
- 开发自动化报表和告警系统的技术型玩家
常规风险
- 令牌泄露风险：JSON令牌文件需设置600权限，避免明文环境变量存储
- 第三方API依赖：zKillboard、Telegram、Discord webhook为可选但引入外部信任边界
- 数据隐私：所有角色数据经CCP官方服务器，符合EVE开发者协议