Repository navigation
Releases: jarrey-0804/fund-cli
Releases · jarrey-0804/fund-cli
Release list
v3.9.0 - 缓存与性能优化
Sprint 2: 缓存与性能优化
缓存核心修复
- DataCache 命中率统计(真实 hit_rate)
- Qieman 适配器缓存接入(74 接口全覆盖)
- 差异化 TTL 映射
N+1 查询消除
- DataManager batch 接口
- diagnose_cmd 预加载(7 处消除)
- FundEvaluator 批量净值
- RebalanceAdvisor/AssetLookthrough 预加载
内存泄漏修复
- Gateway LRU 淘汰(500 条目上限)
- AI 缓存 TTL + 大小限制
- 缓存锁定期清理
网络优化
- QiemanMCPClient HTTP 连接复用
- search_funds 全量列表缓存
质量
- 2317 passed, 0 failed
- 18 files changed, +357 -80
v3.8.1 - 技术债务清理与工程加固
Sprint 1: 债务清理与工程加固
修复
- 版本号同步 (3.5.0 → 3.8.1)
- WindAdapter 标记 deprecated
- 11 个代码质量修复
质量指标
- Ruff: 0 errors
- Bandit: 0 High
- 测试: 2317 passed
v3.5.0 - 五层数据质量治理体系完善
新增功能
P0 核心治理模块
- Rate Limiter (): Token Bucket 限流器,防止数据源过载
- Alert Notifier (): 多通道告警通知(CLI/Webhook/Email)
- CI 质量测试 (): 集成到 CI 的数据质量回归测试
P1 增强治理模块
- Health Checker (): 主动健康检查
- Idempotent Executor (): 幂等性保证
- Cache Protection (): 穿透/击穿/雪崩防护
- Data Masker (): 敏感数据脱敏
- Determinism Checker (): 分析结果可复现性验证
- Trace Context (): 分布式链路追踪
- Quality Trend Analyzer (): 质量趋势分析
- SLA Monitor (): SLA 监控与告警
- Metrics Exporter (): Prometheus 指标导出
测试统计
- 2317 个测试用例全部通过
- 代码覆盖率 66%
文档更新
- README 版本号同步
- CHANGELOG 完整记录
- CI/CD 配置完善
Full Changelog: v3.4.0...v3.5.0
Fund CLI v3.4.0 - 智能推荐系统
Fund CLI v3.4.0 发布说明
新增功能
Phase 4 - 智能推荐系统
- 用户画像管理 (
fund ai profile) - 个性化基金推荐 (
fund ai recommend) - 智能投资建议 (
fund ai advise)
Phase 3 - 市场分析
- 资金流向分析 (
fund analyze money-flow) - 行业轮动分析 (
fund analyze sector-rotation) - 市场情绪分析 (
fund analyze sentiment)
Phase 2 - 风险分析
- 压力测试 (
fund analyze stress-test) - 情景分析 (
fund analyze scenario-v2) - 风险预算分析 (
fund analyze risk-budget)
Phase 1 - AI 决策支持
- 智能选基 (
fund ai select) - 组合诊断 (
fund ai diagnose) - 市场解读 (
fund ai market)
测试统计
- 总计: 2177 个测试全部通过
安装
pip install fund-cli==3.4.0PyPI
Fund CLI v3.1.0
Fund CLI v3.1.0 - 多数据源架构 · 报告引擎 · AI 分析
✨ 新增功能
多数据源架构(核心特性)
- TushareAdapter: 18个核心方法,适配 Tushare 2025.11 API 变更
- AKShareAdapter: AKShare 数据源适配器
- WindAdapter: Wind 金融终端适配器
- DataSourceGateway: 熔断器、降级、重试机制
- DataNormalizer: 跨数据源标准化(字段映射、日期、代码、数值)
报告引擎
- 5种报告格式: HTML / Markdown / PDF / Word / PPT
- TemplateEngine: Jinja2 模板引擎 + 自定义过滤器
- 4类报告模板: 单基金研究、投资组合、市场资金流向、合规风控
AI 分析
- RuleBasedBackend: 规则引擎(零配置)
- OpenAIBackend: OpenAI API 后端
- 智能分析: 摘要、风险提示、投资建议
CLI 命令
fund report: 报告生成fund list-templates: 列出可用模板
🔧 改进
- DataManager 集成 DataSourceGateway,支持多源自动降级
- 代码质量: ruff lint + mypy 类型检查全部通过
- 1930 个单元测试,70% 代码覆盖率
- MkDocs 文档站(Material 主题)
- Docker + CI/CD 就绪
📦 安装
pip install fund-cli==3.1.0完整更新日志请查看 CHANGELOG.md。
Fund CLI v3.0.0 - AI Agent 全面升级
🚀 Fund CLI v3.0.0 - AI Agent 全面升级
✨ 主要更新
AI Agent 框架
- 基于 LangChain/LangGraph 构建 AI Agent
- 支持工具调用(Tool Calling)和记忆(Memory)
- 支持 Postgres 持久化和 Human Review
AI 工具(86个)
- 100% API 方法覆盖率:107个 AKShareAdapter 方法全部覆盖
- 基金分析:费率、评级、排行、业绩、风险、持仓
- 宏观数据:GDP、CPI、PPI、PMI、利率、货币供应
- 资金流向:行业板块、北向资金、市场整体
- 债券数据:收益率曲线、可转债、中美利差
- 市场估值:A股估值、指数估值、PE/PB
CLI 命令(72个)
- 新增
fund version版本查看命令 - 新增
fund doctor环境诊断命令 fund config set支持持久化到 .env 文件fund config list-keys查看所有可配置项
MCP 协议支持
- FastMCP Server 暴露基金查询、筛选、分析工具
- 优雅降级:未安装 mcp 包时友好提示
长期记忆
- ChromaDB 向量数据库存储对话记忆
- 语义搜索历史对话
📊 质量指标
| 指标 | 数值 |
|---|---|
| 测试 | 644 passed, 0 errors, 0 warnings |
| AI 工具 | 86个 |
| API 覆盖率 | 100% (107/107) |
| CLI 命令 | 72个 |
| 代码规范 | Ruff 0 错误, Mypy 0 错误 |
📦 安装
pip install fund-cli
# 安装全部可选依赖
pip install "fund-cli[all-extras]"
# 仅安装 AI 相关
pip install "fund-cli[mcp,memory,postgres]"🔧 使用
# 查看版本
fund version
# 环境诊断
fund doctor
# AI 对话
fund ai chat "帮我分析一下华夏成长的业绩"
# AI 投资建议
fund ai advice 000001
# 配置管理
fund config set ai.provider qwen
fund config list-keys