fund-cli 2.0.0__tar.gz

fund_cli-2.0.0/.env.example

@@ -0,0 +1,77 @@
+# ===========================================
+# Fund CLI 环境变量配置示例
+# ===========================================
+# 复制此文件为 .env 并填入实际值
+
+# -------------------------------------------
+# 数据源配置
+# -------------------------------------------
+
+# AKShare 配置（免费，无需Token）
+FUND_DATA_AKSHARE_ENABLED=true
+
+# Tushare 配置（需要注册获取Token）
+# 注册地址: https://tushare.pro/register
+FUND_DATA_TUSHARE_TOKEN=your_tushare_token_here
+
+# Wind 配置（商业数据源，需要授权）
+FUND_DATA_WIND_ENABLED=false
+FUND_DATA_WIND_USERNAME=
+FUND_DATA_WIND_PASSWORD=
+
+# 数据缓存配置
+FUND_DATA_CACHE_TTL=3600
+FUND_DATA_CACHE_DIR=~/.fund_cli/cache
+
+# -------------------------------------------
+# AI 配置 (V2.0 功能)
+# -------------------------------------------
+
+# LLM 提供商: openai, anthropic, azure, etc.
+FUND_AI_PROVIDER=openai
+
+# 模型选择
+FUND_AI_MODEL=gpt-4
+
+# API Key
+FUND_AI_API_KEY=your_api_key_here
+
+# API Base URL (可选，用于代理或私有部署)
+# FUND_AI_API_BASE=https://api.openai.com/v1
+
+# 模型参数
+FUND_AI_TEMPERATURE=0.7
+FUND_AI_MAX_TOKENS=2000
+
+# -------------------------------------------
+# 分析配置
+# -------------------------------------------
+
+# 无风险利率（用于夏普比率等计算）
+FUND_ANALYSIS_RISK_FREE_RATE=0.03
+
+# 默认基准指数代码
+FUND_ANALYSIS_DEFAULT_BENCHMARK=000300
+
+# 分析周期默认值
+FUND_ANALYSIS_DEFAULT_PERIOD=1y
+
+# -------------------------------------------
+# 日志配置
+# -------------------------------------------
+
+# 日志级别: DEBUG, INFO, WARNING, ERROR
+FUND_LOG_LEVEL=INFO
+
+# 日志文件路径
+# FUND_LOG_FILE=~/.fund_cli/logs/fund-cli.log
+
+# -------------------------------------------
+# 开发配置
+# -------------------------------------------
+
+# 调试模式
+FUND_DEBUG=false
+
+# 开发模式（跳过缓存等）
+FUND_DEV_MODE=false

fund_cli-2.0.0/.gitignore

@@ -0,0 +1,103 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.project
+.pydevproject
+.settings/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.log
+*.tmp
+.cache/
+data/cache/
+*.xlsx
+*.csv
+!tests/fixtures/*.csv
+
+# Secrets
+*.pem
+*.key
+secrets.yaml
+secrets.json

fund_cli-2.0.0/.pre-commit-config.yaml

@@ -0,0 +1,64 @@
+# Pre-commit hooks configuration
+# See https://pre-commit.com for more information
+
+repos:
+  # General hooks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+        args: [--unsafe]
+      - id: check-toml
+      - id: check-json
+      - id: check-added-large-files
+        args: ['--maxkb=1000']
+      - id: check-merge-conflict
+      - id: check-case-conflict
+      - id: detect-private-key
+
+  # Python code formatting
+  - repo: https://github.com/psf/black
+    rev: 23.12.1
+    hooks:
+      - id: black
+        language_version: python3.10
+
+  # Linting
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.1.9
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+
+  # Type checking
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.7.1
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - pydantic>=2.5.0
+          - types-PyYAML
+          - pandas-stubs
+        args: [--ignore-missing-imports]
+
+  # Security checks
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.7.6
+    hooks:
+      - id: bandit
+        args: ["-c", "pyproject.toml"]
+        additional_dependencies: ["bandit[toml]"]
+
+# CI configuration
+ci:
+  autofix_commit_msg: |
+    [pre-commit.ci] auto fixes from pre-commit.com hooks
+    for more information, see https://pre-commit.ci
+  autofix_prs: true
+  autoupdate_branch: ''
+  autoupdate_commit_msg: '[pre-commit.ci] pre-commit autoupdate'
+  autoupdate_schedule: weekly
+  skip: []
+  submodules: false

fund_cli-2.0.0/CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+所有重要的变更都将记录在此文件中。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
+并且本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [2.0.0] - 2026-05-08
+
+### Added
+- AI辅助分析功能（V2.0核心特性）
+  - 支持OpenAI、阿里云Qwen等LLM提供商
+  - 基金摘要生成、对比分析、投资建议、风险评估
+  - 可配置API参数，切换方便
+- 持仓分析模块
+  - 持仓查询、行业分布分析
+  - 重仓股分析、持仓集中度(HHI)
+  - 持仓变化追踪、风格分析(九宫格)
+- 基金经理分析
+  - 经理信息查询、业绩统计
+  - 稳定性评估
+- 组合优化功能
+  - 均值-方差优化、最大夏普比率优化
+  - 风险平价优化、有效前沿计算
+  - 组合回测功能
+- 业绩归因模块
+  - Brinson归因模型
+  - 收益分解、风险归因
+- 监控预警功能
+  - 监控池管理、净值变动监控
+  - 预警规则设置、通知功能
+- 交互式模式
+  - REPL风格交互界面
+  - 命令自动补全
+
+### Changed
+- 重构数据层架构，支持多数据源适配器
+- 优化缓存机制，提升数据获取性能
+- 改进CLI界面，使用Rich库增强输出效果
+- 增强基金筛选功能，支持高级表达式
+- 增强基金分析功能，支持滚动窗口、月度分布、情景分析
+
+### Fixed
+- 修复大数据集下的内存占用问题
+- 修复时区处理不一致问题
+
+## [1.0.0] - 2024-XX-XX
+
+### Added
+- 初始版本发布
+- 基础基金筛选功能
+- 业绩分析功能（收益率、夏普比率、最大回撤等）
+- 基金对比功能
+- 数据管理功能（多数据源、缓存、导出）
+- 系统配置功能

fund_cli-2.0.0/CONTRIBUTING.md

@@ -0,0 +1,95 @@
+# 贡献指南
+
+感谢您对Fund CLI项目的关注！
+
+## 开发环境搭建
+
+```bash
+# 克隆仓库
+git clone https://github.com/your-org/fund-cli.git
+cd fund-cli
+
+# 创建虚拟环境
+python -m venv .venv
+source .venv/bin/activate  # Linux/macOS
+# 或 .venv\Scripts\activate  # Windows
+
+# 安装开发依赖
+pip install -e ".[dev]"
+
+# 安装pre-commit钩子
+pre-commit install
+```
+
+## 代码提交规范
+
+我们使用 [Conventional Commits](https://www.conventionalcommits.org/) 规范：
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+### 类型说明
+
+- `feat`: 新功能
+- `fix`: 修复bug
+- `docs`: 文档更新
+- `style`: 代码格式调整（不影响功能）
+- `refactor`: 代码重构
+- `test`: 测试相关
+- `chore`: 构建/工具相关
+
+### 示例
+
+```
+feat(ai): add Qwen provider support
+
+Add Alibaba Cloud Qwen LLM provider for AI analysis.
+Supports qwen-max, qwen-plus, and qwen-turbo models.
+
+Closes #123
+```
+
+## 代码审查流程
+
+1. Fork 仓库
+2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
+3. 提交变更 (`git commit -m 'feat: add amazing feature'`)
+4. 推送分支 (`git push origin feature/amazing-feature`)
+5. 创建 Pull Request
+
+## 测试要求
+
+- 新功能必须包含单元测试
+- 测试覆盖率不得低于80%
+- 所有测试必须通过
+
+```bash
+# 运行测试
+pytest tests/ -v
+
+# 运行测试并检查覆盖率
+pytest tests/ --cov=src/fund_cli --cov-report=html
+
+# 代码格式化
+black src tests --line-length=100
+
+# 代码检查
+ruff check src tests
+```
+
+## 问题反馈
+
+如果您发现了bug或有功能建议，请通过以下方式反馈：
+
+1. 查看现有Issue，避免重复提交
+2. 创建新Issue，详细描述问题
+3. 对于bug，请提供复现步骤和环境信息
+
+## 许可证
+
+通过贡献代码，您同意您的贡献将在MIT许可证下发布。

fund_cli-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Fund CLI Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fund_cli-2.0.0/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: fund-cli
+Version: 2.0.0
+Summary: 专业基金分析CLI工具 - 面向机构客户
+Project-URL: Homepage, https://github.com/your-org/fund-cli
+Project-URL: Documentation, https://fund-cli.readthedocs.io
+Project-URL: Repository, https://github.com/your-org/fund-cli
+Author: Fund CLI Team
+License: MIT
+License-File: LICENSE
+Keywords: analysis,cli,finance,fund,investment,quant
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Terminals
+Requires-Python: >=3.10
+Requires-Dist: akshare>=1.12.0
+Requires-Dist: diskcache>=5.6.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: litellm>=1.20.0
+Requires-Dist: matplotlib>=3.8.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: plotly>=5.18.0
+Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: pyportfolioopt>=1.5.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: quantstats>=0.0.62
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tushare>=1.4.0
+Requires-Dist: typer[all]>=0.9.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.7.0; extra == 'dev'
+Requires-Dist: pandas-stubs>=2.0.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.5.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.4.0; extra == 'docs'
+Requires-Dist: mkdocs>=1.5.0; extra == 'docs'
+Requires-Dist: mkdocstrings[python]>=0.23.0; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# Fund CLI
+
+<div align="center">
+
+**专业基金分析CLI工具 - 面向机构客户**
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+</div>
+
+---
+
+## 📖 简介
+
+Fund CLI 是一款面向机构客户的专业基金分析命令行工具，提供基金筛选、业绩分析、组合对比、风险监控等功能。基于开源技术栈构建，支持多数据源接入和AI辅助分析。
+
+## ✨ 核心功能
+
+- 🔍 **基金筛选** - 多维度筛选条件，支持业绩、风险、规模等指标
+- 📊 **业绩分析** - 收益率、夏普比率、最大回撤等专业指标
+- ⚖️ **基金对比** - 多基金横向对比分析
+- 📈 **组合优化** - 基于现代投资组合理论的资产配置优化
+- 🤖 **AI分析** (V2.0) - AI辅助投资分析和报告生成
+- 💾 **多数据源** - 支持AKShare、Tushare、Wind等数据源
+
+## 🚀 快速开始
+
+### 安装
+
+```bash
+# 使用 pip 安装
+pip install fund-cli
+
+# 或从源码安装
+git clone https://github.com/your-org/fund-cli.git
+cd fund-cli
+pip install -e ".[dev]"
+```
+
+### 基本使用
+
+```bash
+# 查看帮助
+fund --help
+
+# 筛选基金
+fund filter --type 股票型 --min-scale 10
+
+# 分析基金
+fund analyze 000001
+
+# 对比基金
+fund compare 000001 000002 000003
+
+# 查看基金信息
+fund info 000001
+```
+
+## 📚 文档
+
+- [安装指南](docs/installation.md)
+- [使用教程](docs/usage/)
+- [API文档](docs/api/)
+- [开发指南](docs/development.md)
+
+## 🛠️ 技术栈
+
+| 类别 | 技术 |
+|------|------|
+| CLI框架 | Typer, Rich |
+| 数据处理 | Pandas, NumPy |
+| 数据源 | AKShare, Tushare |
+| 量化分析 | QuantStats, PyPortfolioOpt |
+| 可视化 | Plotly, Matplotlib |
+| AI集成 | LiteLLM |
+
+## 📁 项目结构
+
+```
+fund-cli/
+├── src/fund_cli/          # 源代码
+│   ├── cli.py             # CLI入口
+│   ├── config.py          # 配置管理
+│   ├── core/              # 核心模块
+│   ├── data/              # 数据层
+│   ├── analysis/          # 分析模块
+│   ├── commands/          # CLI命令
+│   └── utils/             # 工具函数
+├── tests/                 # 测试代码
+├── docs/                  # 文档
+└── examples/              # 示例脚本
+```
+
+## 🧪 开发
+
+```bash
+# 安装开发依赖
+pip install -e ".[dev]"
+
+# 安装 pre-commit 钩子
+pre-commit install
+
+# 运行测试
+pytest tests/
+
+# 代码格式化
+black src tests
+
+# Lint检查
+ruff check src tests
+
+# 类型检查
+mypy src
+```
+
+## 📄 许可证
+
+本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。
+
+## 🤝 贡献
+
+欢迎贡献！请查看 [贡献指南](CONTRIBUTING.md) 了解详情。
+
+## 📧 联系方式
+
+- 问题反馈: [GitHub Issues](https://github.com/your-org/fund-cli/issues)
+- 功能建议: [GitHub Discussions](https://github.com/your-org/fund-cli/discussions)