Skip to content

Releases: jarrey-0804/fund-cli

v3.9.0 - 缓存与性能优化

Choose a tag to compare

@jarrey-0804 jarrey-0804 released this 15 May 05:36

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 - 技术债务清理与工程加固

Choose a tag to compare

@jarrey-0804 jarrey-0804 released this 15 May 04:53

Sprint 1: 债务清理与工程加固

修复

  • 版本号同步 (3.5.0 → 3.8.1)
  • WindAdapter 标记 deprecated
  • 11 个代码质量修复

质量指标

  • Ruff: 0 errors
  • Bandit: 0 High
  • 测试: 2317 passed

v3.5.0 - 五层数据质量治理体系完善

Choose a tag to compare

@jarrey-0804 jarrey-0804 released this 12 May 06:01

新增功能

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 - 智能推荐系统

Choose a tag to compare

@jarrey-0804 jarrey-0804 released this 11 May 02:12

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.0

PyPI

https://pypi.org/project/fund-cli/3.4.0/

Fund CLI v3.1.0

Choose a tag to compare

@jarrey-0804 jarrey-0804 released this 09 May 23:37

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 全面升级

Choose a tag to compare

@jarrey-0804 jarrey-0804 released this 08 May 23:26

🚀 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

Fund CLI V2.0.1

Choose a tag to compare

@jarrey-0804 jarrey-0804 released this 08 May 02:24

Fund CLI V2.0.1

修复

  • 修复PyPI文档链接显示为空的问题
  • 将README.md中的文档链接改为GitHub绝对链接
  • 在README.md中直接包含安装指南、使用教程、API文档、开发指南内容

安装

pip install fund-cli==2.0.1

文档

核心功能

  • 🔍 基金筛选 - 多维度筛选条件
  • 📊 业绩分析 - 收益率、夏普比率、最大回撤
  • ⚖️ 基金对比 - 多基金横向对比
  • 📈 组合优化 - 均值方差、风险平价、最大夏普
  • 🤖 AI分析 - 智能投资分析和报告生成
  • 💾 多数据源 - AKShare、Tushare、Wind