核心用法
Named Immortal 是一个面向AI Agent的加密资产风险 vitality 评估工具，通过调用 Majestify 的 Crypto Health Hub API，计算机构级风险指标并输出分级建议。支持命令行直接调用，可通过 --coins 指定资产（默认BTC/ETH）、--days 调整时间窗口（默认365天）、--api 自定义端点。
输出采用双通道设计：stdout 提供人类可读报告，stderr 输出 JSON 供 Agent 管道捕获。核心脚本 assess_vitality.py 兼容 Python 3.10+，优先使用 httpx 异步请求，无则回退至 urllib，实现零强制依赖。
显著优点
1. Agent原生设计：机器可读JSON输出、命令行优先、无交互阻塞，适合自动化流水线集成
2. 机构级指标体系：覆盖 Sharpe/Sortino/VaR/CVaR/Cornish-Fisher VaR/Max Drawdown 等完整风险度量
3. 分级决策框架：IMMORTAL/MORTAL/CRITICAL 三档分类直接映射国库配置、主动管理、避险对冲三种策略
4. 零依赖部署：仅依赖 Python 标准库即可运行，降低容器化与边缘部署成本
5. 可扩展架构：通过 --api 参数支持私有化或自托管后端，避免供应商锁定
潜在缺点与局限性
1. 外部API依赖：核心计算依赖 Majestify 托管服务（crypto-health-hub.onrender.com），存在单点故障与网络延迟风险；Render 免费套餐有冷启动与速率限制
2. 数据时效性未明：文档未披露价格数据来源、更新频率与历史回测覆盖度，极端行情下指标可能滞后
3. 分类阈值固定：Sharpe>1.2、Drawdown<60% 等阈值硬编码，未提供自定义分级规则或情景压力测试
4. 回测窗口有限：仅支持单一历史窗口计算，缺乏滚动窗口对比与 regime-switching 分析
5. 加密资产覆盖度依赖后端：未公开支持币种列表与流动性筛选逻辑，小市值资产可能因数据缺失报错
适合人群
- AI Agent 开发者：需要为交易系统、国库管理机器人、风险监控 Agent 集成实时风险评分
- DeFi 协议团队：构建自动化金库策略，基于 vitality 分级动态调整仓位
- 量化研究员：快速获取标准化风险指标作为策略筛选第一层过滤器
- 个人高净值投资者：以机构框架评估自托管资产配置健康度
常规风险
1. API可用性与数据质量风险：第三方服务中断、价格源异常或计算错误将直接导致误判；建议本地缓存与多源校验
2. 模型风险：历史风险指标（如VaR）假设收益分布稳定，无法预测黑天鹅与长尾事件；Cornish-Fisher调整仅部分缓解
3. 执行风险：分级建议（IMMORTAL/MORTAL/CRITICAL）为参考框架，不构成投资顾问服务；实际仓位需结合流动性、托管安全、合规因素综合判断
4. 隐私与合规：API调用将资产列表暴露至外部服务，机构用户应评估数据驻留与GDPR/AML合规要求
5. 技术债务：MIT 许可证友好，但项目处于 v1.0.0 早期版本，API契约与分级逻辑可能迭代变更