核心功能与用法
eve-esi 是一套完整的 EVE Online 官方 API 管理工具，基于 CCP Games 提供的 ESI (EVE Swagger Interface) REST API 构建。核心功能涵盖：
1. 全角色数据管理
- 资产追踪（舰船、装备、物资）与位置解析
- 钱包余额、交易流水、市场订单监控
- 技能队列、技能点数、属性加点、植入体管理
- 跳跃克隆、当前位置、舰船状态实时查询
2. 自动化监控与警报
- 模块化仪表盘配置，支持战争宣战、结构攻击、技能完成、工业作业、行星开采等事件警报
- Telegram/Discord webhook 通知推送
- 定时报告生成（净资产、技能进度、市场订单等）
3. 威胁评估与路径规划
- 低安/零安区域 PvP 威胁等级评估（结合 ESI 击杀数据与 zKillboard）
- 带威胁标注的路径规划（安全/最短/危险路线）
- PI（行星工业）系统安全简报
4. 开发工具链
- OAuth2/PKCE 认证流程自动化，token 自动刷新
- 统一查询脚本
esi_query.py支持分页、缓存、错误重试 - JSON Schema 配置验证
显著优点
- 官方权威数据源：直接对接 CCP Games 官方 ESI，数据实时性与准确性远超第三方工具
- 企业级安全设计：OAuth2 PKCE 流程、token 本地加密存储（chmod 600）、支持环境变量脱敏
- 高度可扩展：模块化配置，用户自定义监控规则与通知渠道
- 威胁情报独特：结合 zKillboard 的 PvP 数据，提供其他工具罕见的区域风险评估
潜在局限与风险
- steep 学习曲线：需理解 EVE 的 OAuth2 流程、ESI scope 权限体系、type ID 解析机制
- 令牌有效期短：access token 约 20 分钟过期，依赖自动刷新机制，脚本异常时可能中断
- 速率限制严格：部分端点（邮件、合同）有内部限速，高频轮询易触发 HTTP 520
- Redis 依赖：威胁缓存功能需要本地 Redis 服务
适合人群
- 多角色深度玩家，需要跨角色资产汇总与自动化监控
- 军团/联盟管理人员，需要战争警报与成员状态追踪
- PI 与工业玩家，重视低安区域安全评估
- 开发者，希望基于官方 API 构建自定义工具链
常规风险
- token 泄露风险：尽管存储加密，文件权限配置错误或备份泄露仍可能导致账号风险
- API 变更风险：ESI
/dev/端点可能无预警变更，建议使用/latest/稳定版本 - 误操作风险：自动化脚本可能对钱包、市场订单产生意外修改（技能以只读端点为主，风险较低）