核心用法
Cosmonyx Admin 是一款面向 Cosmonyx 平台管理员的综合数据操作工具，通过标准化 API 流程实现企业全生命周期管理。核心操作流程分为五步：首先安全采集管理员凭证并完成 JWT 认证；随后自动分页拉取全量企业数据至内存；接着提供六种筛选维度（合规状态、风险等级、KYC 审核状态、到期日期等）；根据筛选结果分叉执行——或导出为 PDF/Excel 报表至本地下载目录，或批量发送个性化提醒邮件；最后可选邮件直送导出文件。
显著优点
1. 端到端自动化：从认证、数据获取、智能筛选到文件生成与邮件发送形成闭环，无需人工切换工具
2. 企业级筛选能力：支持嵌套对象查询（如 primaryUser.sumsubVerificationStatus）、日期范围比对等复杂条件
3. 灵活输出格式：同时支持 PDF（适合审阅归档）与 Excel（适合数据分析），满足合规与运营双重场景
4. 敏感信息安全处理：密码不回显、Token 仅内存驻留、凭证验证失败即阻断，符合金融数据安全基线
5. 可扩展邮件能力：基于模板变量的批量邮件发送，支持 SMTP 环境配置，便于集成现有邮件基础设施
潜在缺点与局限性
1. 环境依赖性强：硬编码 gateway-dev.cosmonyx.co 开发域名，生产环境需手动适配或维护多环境配置
2. 无持久化存储：Token 与全量数据仅存内存，大列表场景下存在内存压力，且中断后需重新全量获取
3. 邮件功能外部耦合：依赖 cosmonyx-signin-fetch-companies/scripts/send-cosmonyx-email.py 外部脚本，若该路径缺失则邮件功能失效
4. 日期格式刚性：仅支持 YYYY-MM-DD 硬格式输入，国际化用户可能产生格式困惑
5. 无权限细粒度校验：假设调用者即为管理员，未校验账户角色权限，存在误用风险
适合人群
- 合规运营团队：需定期筛选高风险/待合规企业并生成审计报表
- 平台管理员：负责 Cosmonyx 企业入驻审核与生命周期管理
- 金融数据分析师：需将企业数据导出至 Excel 进行深度统计建模
- 客户成功团队：需针对特定状态企业批量发送激活或提醒邮件
常规风险
1. 凭证泄露风险：用户需在交互中明文输入密码，若会话被截屏或日志记录则存在暴露可能
2. Token 劫持风险：Bearer Token 虽仅内存存储，但在技能执行期间若环境被入侵仍可被提取
3. 数据导出合规风险：批量下载企业信息（含邮箱、KYC 状态）可能触发 GDPR/个人信息保护法合规义务
4. 误发邮件风险：邮件模板变量替换若出现逻辑错误，可能导致敏感信息错发或内容误导
5. SMTP 配置风险：邮件功能依赖环境变量中的 SMTP 凭证，若配置不当可能导致凭证泄露或邮件被拒收