fund-cli 2.0.0__tar.gz → 2.0.1__tar.gz

{fund_cli-2.0.0 → fund_cli-2.0.1}/CHANGELOG.md

@@ -5,6 +5,13 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
 并且本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [2.0.1] - 2026-05-08
+
+### Fixed
+- 修复PyPI文档链接显示为空的问题
+- 将README.md中的文档链接改为GitHub绝对链接
+- 在README.md中直接包含安装指南、使用教程、API文档、开发指南内容
+
 ## [2.0.0] - 2026-05-08
 
 ### Added

fund_cli-2.0.1/GITHUB_MANUAL_RELEASE.md

@@ -0,0 +1,139 @@
+# Fund CLI V2.0.0 GitHub 手动发布步骤
+
+由于GitHub Token权限限制，请按照以下步骤手动完成发布。
+
+---
+
+## ✅ 本地准备已完成
+
+- [x] Git仓库初始化
+- [x] 所有代码已提交 (113个文件)
+- [x] Git标签 v2.0.0 已创建
+- [x] PyPI已发布成功
+
+---
+
+## 📋 手动发布步骤
+
+### 步骤1: 在GitHub创建仓库
+
+1. 访问 https://github.com/new
+2. 填写信息:
+   - **Repository name**: `fund-cli`
+   - **Description**: `专业基金分析CLI工具 - 支持AI辅助分析、组合优化、持仓分析`
+   - **Visibility**: Public
+   - **不要勾选** "Initialize this repository with a README"
+3. 点击 **Create repository**
+
+### 步骤2: 推送代码
+
+```bash
+cd /workspace/fund-cli
+
+# 添加远程仓库
+git remote add origin https://github.com/jarrey-0804/fund-cli.git
+
+# 推送代码
+git branch -M main
+git push -u origin main
+
+# 推送标签
+git push origin v2.0.0
+```
+
+### 步骤3: 创建GitHub Release
+
+1. 访问 `https://github.com/jarrey-0804/fund-cli/releases`
+2. 点击 **"Create a new release"**
+3. 选择标签: `v2.0.0`
+4. 填写标题: `Fund CLI V2.0.0 正式发布`
+5. 复制以下内容到Release notes:
+
+```markdown
+## Fund CLI V2.0.0 正式发布
+
+### 🎉 核心亮点
+
+- **🤖 AI辅助分析**: 集成多LLM提供商(OpenAI/阿里云Qwen)，支持智能基金分析
+- **📊 持仓分析**: 持仓穿透、行业分布、风格分析(九宫格)
+- **⚖️ 组合优化**: 均值-方差、最大夏普、风险平价策略
+- **👤 基金经理**: 经理业绩追踪、稳定性评估
+- **🔔 实时监控**: 净值变动监控、预警通知
+- **💻 交互式模式**: REPL风格交互体验
+
+### 📦 安装
+
+```bash
+pip install fund-cli==2.0.0
+```
+
+### 📚 文档
+
+- [安装指南](docs/installation.md)
+- [使用教程](docs/usage/tutorial.md)
+- [API文档](docs/api/reference.md)
+- [CHANGELOG](CHANGELOG.md)
+
+### 📝 主要变更
+
+**新增功能**:
+- AI分析模块（summarize, compare, advice, risk, insight, portfolio）
+- 持仓分析模块（query, industry, concentration, changes, style）
+- 基金经理模块（info, performance, stability）
+- 组合优化增强（mean-variance, max-sharpe, risk-parity, frontier, backtest）
+- 业绩归因模块（Brinson归因）
+- 监控预警模块
+
+**改进**:
+- 数据层架构重构，支持多数据源适配器
+- CLI界面优化，使用Rich库增强输出
+- 缓存机制优化
+
+**修复**:
+- 内存占用问题
+- 时区处理问题
+
+### 🔗 相关链接
+
+- PyPI: https://pypi.org/project/fund-cli/2.0.0/
+- 文档: https://github.com/jarrey-0804/fund-cli/tree/main/docs
+- Issues: https://github.com/jarrey-0804/fund-cli/issues
+
+---
+
+**发布日期**: 2026-05-08  
+**版本**: 2.0.0
+```
+
+6. 上传构建产物:
+   - 点击 "Attach binaries by dropping them here or selecting them"
+   - 上传 `/workspace/fund-cli/dist/fund_cli-2.0.0-py3-none-any.whl`
+   - 上传 `/workspace/fund-cli/dist/fund_cli-2.0.0.tar.gz`
+
+7. 点击 **"Publish release"**
+
+---
+
+## ✅ 发布后验证
+
+- [ ] 代码已推送到 https://github.com/jarrey-0804/fund-cli
+- [ ] Git标签已推送
+- [ ] GitHub Release已创建
+- [ ] 构建产物已上传
+- [ ] Release页面可访问: https://github.com/jarrey-0804/fund-cli/releases/tag/v2.0.0
+
+---
+
+## 🎉 发布完成
+
+GitHub Release创建完成后，您的项目将完全发布：
+
+| 平台 | 状态 | 链接 |
+|------|------|------|
+| PyPI | ✅ 已发布 | https://pypi.org/project/fund-cli/2.0.0/ |
+| GitHub | ⏳ 待手动发布 | https://github.com/jarrey-0804/fund-cli |
+
+**安装命令**:
+```bash
+pip install fund-cli==2.0.0
+```

fund_cli-2.0.1/GITHUB_RELEASE_INSTRUCTIONS.md

@@ -0,0 +1,155 @@
+# Fund CLI V2.0.0 GitHub 发布指南
+
+## ✅ 本地Git操作已完成
+
+- [x] Git仓库初始化
+- [x] 所有文件提交 (113个文件, 13789行)
+- [x] Git标签 v2.0.0 创建
+
+---
+
+## 📤 推送到GitHub步骤
+
+### 步骤1: 在GitHub创建仓库
+
+1. 访问 https://github.com/new
+2. 填写仓库信息:
+   - **Repository name**: `fund-cli`
+   - **Description**: `专业基金分析CLI工具 - 支持AI辅助分析、组合优化、持仓分析`
+   - **Visibility**: Public (或 Private)
+   - **Initialize**: 不要勾选 (已有本地仓库)
+3. 点击 **Create repository**
+
+### 步骤2: 添加远程仓库并推送
+
+```bash
+cd /workspace/fund-cli
+
+# 添加远程仓库 (替换 YOUR_USERNAME 为您的GitHub用户名)
+git remote add origin https://github.com/YOUR_USERNAME/fund-cli.git
+
+# 推送代码到main分支
+git branch -M main
+git push -u origin main
+
+# 推送标签
+git push origin v2.0.0
+```
+
+### 步骤3: 创建GitHub Release
+
+**方法A: 通过GitHub Web界面**
+
+1. 访问 `https://github.com/YOUR_USERNAME/fund-cli/releases`
+2. 点击 **"Create a new release"**
+3. 填写Release信息:
+
+**Choose a tag**: `v2.0.0`  
+**Release title**: `Fund CLI V2.0.0 正式发布`  
+
+**Release notes**:
+
+```markdown
+## Fund CLI V2.0.0 正式发布
+
+### 🎉 核心亮点
+
+- **🤖 AI辅助分析**: 集成多LLM提供商(OpenAI/阿里云Qwen)，支持智能基金分析
+- **📊 持仓分析**: 持仓穿透、行业分布、风格分析(九宫格)
+- **⚖️ 组合优化**: 均值-方差、最大夏普、风险平价策略
+- **👤 基金经理**: 经理业绩追踪、稳定性评估
+- **🔔 实时监控**: 净值变动监控、预警通知
+- **💻 交互式模式**: REPL风格交互体验
+
+### 📦 安装
+
+```bash
+pip install fund-cli==2.0.0
+```
+
+### 📚 文档
+
+- [安装指南](docs/installation.md)
+- [使用教程](docs/usage/tutorial.md)
+- [API文档](docs/api/reference.md)
+- [CHANGELOG](CHANGELOG.md)
+
+### 📝 主要变更
+
+**新增功能**:
+- AI分析模块（summarize, compare, advice, risk, insight, portfolio）
+- 持仓分析模块（query, industry, concentration, changes, style）
+- 基金经理模块（info, performance, stability）
+- 组合优化增强（mean-variance, max-sharpe, risk-parity, frontier, backtest）
+- 业绩归因模块（Brinson归因）
+- 监控预警模块
+
+**改进**:
+- 数据层架构重构，支持多数据源适配器
+- CLI界面优化，使用Rich库增强输出
+- 缓存机制优化
+
+**修复**:
+- 内存占用问题
+- 时区处理问题
+
+### 🔗 相关链接
+
+- PyPI: https://pypi.org/project/fund-cli/2.0.0/
+- 文档: https://github.com/YOUR_USERNAME/fund-cli/tree/main/docs
+- Issues: https://github.com/YOUR_USERNAME/fund-cli/issues
+
+---
+
+**发布日期**: 2026-05-08  
+**版本**: 2.0.0
+```
+
+4. 上传构建产物:
+   - 点击 **"Attach binaries"**
+   - 上传 `dist/fund_cli-2.0.0-py3-none-any.whl`
+   - 上传 `dist/fund_cli-2.0.0.tar.gz`
+
+5. 点击 **"Publish release"**
+
+**方法B: 通过GitHub CLI**
+
+```bash
+# 安装GitHub CLI (如未安装)
+# https://cli.github.com/
+
+# 登录
+gitHub auth login
+
+# 创建Release
+gh release create v2.0.0 \
+  --title "Fund CLI V2.0.0 正式发布" \
+  --notes-file RELEASE_NOTES.md \
+  dist/fund_cli-2.0.0-py3-none-any.whl \
+  dist/fund_cli-2.0.0.tar.gz
+```
+
+---
+
+## ✅ 发布后验证清单
+
+- [ ] 代码已推送到GitHub
+- [ ] Git标签已推送
+- [ ] GitHub Release已创建
+- [ ] 构建产物已上传到Release
+- [ ] Release页面可访问
+- [ ] 文档链接有效
+
+---
+
+## 🔗 GitHub Release页面
+
+创建完成后，Release页面地址为:
+```
+https://github.com/YOUR_USERNAME/fund-cli/releases/tag/v2.0.0
+```
+
+---
+
+**发布日期**: 2026-05-08  
+**版本**: 2.0.0

{fund_cli-2.0.0 → fund_cli-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fund-cli
-Version: 2.0.0
+Version: 2.0.1
 Summary: 专业基金分析CLI工具 - 面向机构客户
 Project-URL: Homepage, https://github.com/your-org/fund-cli
 Project-URL: Documentation, https://fund-cli.readthedocs.io
@@ -66,34 +66,54 @@ Description-Content-Type: text/markdown
 
 ---
 
-## 📖 简介
+## 简介
 
 Fund CLI 是一款面向机构客户的专业基金分析命令行工具，提供基金筛选、业绩分析、组合对比、风险监控等功能。基于开源技术栈构建，支持多数据源接入和AI辅助分析。
 
-## ✨ 核心功能
+## 核心功能
 
-- 🔍 **基金筛选** - 多维度筛选条件，支持业绩、风险、规模等指标
-- 📊 **业绩分析** - 收益率、夏普比率、最大回撤等专业指标
-- ⚖️ **基金对比** - 多基金横向对比分析
-- 📈 **组合优化** - 基于现代投资组合理论的资产配置优化
-- 🤖 **AI分析** (V2.0) - AI辅助投资分析和报告生成
-- 💾 **多数据源** - 支持AKShare、Tushare、Wind等数据源
+- **基金筛选** - 多维度筛选条件，支持业绩、风险、规模等指标
+- **业绩分析** - 收益率、夏普比率、最大回撤等专业指标
+- **基金对比** - 多基金横向对比分析
+- **组合优化** - 基于现代投资组合理论的资产配置优化
+- **AI分析** (V2.0) - AI辅助投资分析和报告生成
+- **多数据源** - 支持AKShare、Tushare、Wind等数据源
 
-## 🚀 快速开始
+---
+
+## 安装指南
+
+### 系统要求
+
+- Python 3.10 或更高版本
+- pip 包管理器
 
-### 安装
+### 使用 pip 安装
 
 ```bash
-# 使用 pip 安装
 pip install fund-cli
+```
+
+### 从源码安装
 
-# 或从源码安装
-git clone https://github.com/your-org/fund-cli.git
+```bash
+git clone https://github.com/jarrey-0804/fund-cli.git
 cd fund-cli
 pip install -e ".[dev]"
 ```
 
-### 基本使用
+### 验证安装
+
+```bash
+fund --version
+fund --help
+```
+
+---
+
+## 使用教程
+
+### 基本命令
 
 ```bash
 # 查看帮助
@@ -112,53 +132,130 @@ fund compare 000001 000002 000003
 fund info 000001
 ```
 
-## 📚 文档
+### AI分析功能 (V2.0)
 
-- [安装指南](docs/installation.md)
-- [使用教程](docs/usage/)
-- [API文档](docs/api/)
-- [开发指南](docs/development.md)
+```bash
+# 配置AI服务
+fund ai config --provider qwen --api-key YOUR_API_KEY
 
-## 🛠️ 技术栈
+# AI基金分析
+fund ai summarize 000001
 
-| 类别 | 技术 |
-|------|------|
-| CLI框架 | Typer, Rich |
-| 数据处理 | Pandas, NumPy |
-| 数据源 | AKShare, Tushare |
-| 量化分析 | QuantStats, PyPortfolioOpt |
-| 可视化 | Plotly, Matplotlib |
-| AI集成 | LiteLLM |
+# AI投资建议
+fund ai advice --risk-level 中等
+
+# AI风险评估
+fund ai risk 000001
+```
 
-## 📁 项目结构
+### 组合优化
 
+```bash
+# 均值方差优化
+fund optimize mean-variance 000001 000002 000003
+
+# 风险平价优化
+fund optimize risk-parity 000001 000002 000003
+
+# 最大夏普比率优化
+fund optimize max-sharpe 000001 000002 000003
 ```
-fund-cli/
-├── src/fund_cli/          # 源代码
-│   ├── cli.py             # CLI入口
-│   ├── config.py          # 配置管理
-│   ├── core/              # 核心模块
-│   ├── data/              # 数据层
-│   ├── analysis/          # 分析模块
-│   ├── commands/          # CLI命令
-│   └── utils/             # 工具函数
-├── tests/                 # 测试代码
-├── docs/                  # 文档
-└── examples/              # 示例脚本
+
+### 数据管理
+
+```bash
+# 更新基金数据
+fund data update
+
+# 查看数据缓存
+fund data cache info
+
+# 清理缓存
+fund data cache clear
 ```
 
-## 🧪 开发
+---
+
+## API文档
+
+### Python API 使用
+
+```python
+from fund_cli import FundClient
+
+# 创建客户端
+client = FundClient()
+
+# 获取基金信息
+fund_info = client.get_fund("000001")
+
+# 分析基金
+analysis = client.analyze("000001")
+
+# 筛选基金
+funds = client.screen(type="股票型", min_scale=10)
+
+# 对比基金
+comparison = client.compare(["000001", "000002", "000003"])
+```
+
+### AI分析 API
+
+```python
+from fund_cli.ai import AIAnalyzer
+
+# 创建分析器
+analyzer = AIAnalyzer(provider="qwen", api_key="YOUR_API_KEY")
+
+# 基金摘要
+summary = analyzer.summarize_fund("000001")
+
+# 投资建议
+advice = analyzer.investment_advice(risk_level="中等")
+
+# 风险评估
+risk = analyzer.risk_assessment("000001")
+```
+
+---
+
+## 开发指南
+
+### 开发环境设置
 
 ```bash
+# 克隆仓库
+git clone https://github.com/jarrey-0804/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
+```
 
-# 运行测试
+### 运行测试
+
+```bash
+# 运行所有测试
 pytest tests/
 
+# 运行带覆盖率
+pytest --cov=src/fund_cli tests/
+
+# 运行特定测试
+pytest tests/unit/test_core/ -v
+```
+
+### 代码质量
+
+```bash
 # 代码格式化
 black src tests
 
@@ -169,15 +266,57 @@ ruff check src tests
 mypy src
 ```
 
-## 📄 许可证
+### 项目结构
+
+```
+fund-cli/
+├── src/fund_cli/          # 源代码
+│   ├── cli.py             # CLI入口
+│   ├── config.py          # 配置管理
+│   ├── core/              # 核心模块
+│   ├── data/              # 数据层
+│   ├── analysis/          # 分析模块
+│   ├── ai/                # AI模块 (V2.0)
+│   ├── commands/          # CLI命令
+│   └── utils/             # 工具函数
+├── tests/                 # 测试代码
+├── docs/                  # 文档
+└── examples/              # 示例脚本
+```
+
+---
+
+## 技术栈
+
+| 类别 | 技术 |
+|------|------|
+| CLI框架 | Typer, Rich |
+| 数据处理 | Pandas, NumPy |
+| 数据源 | AKShare, Tushare |
+| 量化分析 | QuantStats, PyPortfolioOpt |
+| 可视化 | Plotly, Matplotlib |
+| AI集成 | LiteLLM, Qwen |
+
+---
+
+## 更多文档
+
+- [安装指南](https://github.com/jarrey-0804/fund-cli/blob/main/docs/installation.md)
+- [使用教程](https://github.com/jarrey-0804/fund-cli/blob/main/docs/usage/tutorial.md)
+- [API参考](https://github.com/jarrey-0804/fund-cli/blob/main/docs/api/reference.md)
+- [开发指南](https://github.com/jarrey-0804/fund-cli/blob/main/docs/development.md)
+
+---
+
+## 许可证
 
 本项目采用 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)
+- 问题反馈: [GitHub Issues](https://github.com/jarrey-0804/fund-cli/issues)
+- 功能建议: [GitHub Discussions](https://github.com/jarrey-0804/fund-cli/discussions)