docs: 将英文文件名重命名为中文

重命名13个英文文档为中文:
- etf_pool_selection.md → ETF候选池筛选报告.md
- etf_tracking_error_calculation.md → ETF跟踪误差计算方法.md
- FLASK_SERVICE_SUMMARY.md → Flask服务总结.md
- flask_api_README.md → Flask_API接口说明.md
- cross_market_effectiveness_survey.md → 跨市场有效性调研.md
- etf_rotation_deep_analysis.md → ETF轮动深度分析.md
- etf_rotation_framework.md → ETF轮动框架.md
- momentum_rotation_survey.md → 动量轮动调研.md
- strategy_evolution_report.md → 策略演进报告.md
- universal_fetcher_*.md → 通用数据源*.md

同时更新文档内部的交叉引用链接
This commit is contained in:
2026-06-20 23:24:04 +08:00
parent a600a71aa3
commit b698857e49
13 changed files with 6 additions and 6 deletions

View File

@@ -0,0 +1,128 @@
# 快速入门:统一数据获取接口
## 5分钟快速上手
### 1. 安装依赖
```bash
pip install pandas yfinance tushare
```
### 2. 配置 Tushare Token
在项目根目录的 `.env` 文件中添加:
```env
TUSHARE_TOKEN=your_token_here
```
如果没有 token前往 [Tushare](https://tushare.pro/) 注册获取。
### 3. 第一个示例
```python
from core.datasource.universal_fetcher import fetch_kline
# 获取沪深300指数最近3个月的数据
df = fetch_kline("000300.SH", "2024-01-01", "2024-03-31")
print(f"获取到 {len(df)} 条数据")
print(df.tail())
```
### 4. 批量获取
```python
from core.datasource.universal_fetcher import UniversalDataFetcher
codes = [
"000300.SH", # 沪深300
"510300.SH", # 沪深300ETF
"NDX", # 纳斯达克100
"HSI", # 恒生指数
]
fetcher = UniversalDataFetcher()
with fetcher:
results = fetcher.fetch_multiple(codes, "2024-01-01", "2024-03-31")
for code, df in results.items():
if df is not None:
print(f"✓ {code}: {len(df)} 条")
```
## 常用代码速查表
### A股指数
| 代码 | 名称 |
|------|------|
| `000300.SH` | 沪深300 |
| `000016.SH` | 上证50 |
| `399006.SZ` | 创业板指 |
| `000905.SH` | 中证500 |
| `H30269.CSI` | 中证红利低波 |
### A股ETF
| 代码 | 名称 |
|------|------|
| `510300.SH` | 沪深300ETF |
| `159915.SZ` | 创业板ETF |
| `510500.SH` | 中证500ETF |
| `513100.SH` | 纳指ETF |
### 全球指数
| 代码 | 名称 |
|------|------|
| `NDX` | 纳斯达克100 |
| `SPX` | 标普500 |
| `HSI` | 恒生指数 |
| `N225` | 日经225 |
| `GDAXI` | 德国DAX |
### 期货 & 加密资产
| 代码 | 名称 |
|------|------|
| `AU.SHF` | 黄金期货 |
| `BTC` | 比特币 |
| `ETH` | 以太坊 |
## 常见问题
### 获取数据失败怎么办?
1. **检查网络连接**YFinance 可能需要科学上网
2. **检查 Token**:确保 `.env` 文件中配置了 `TUSHARE_TOKEN`
3. **检查代码格式**:使用 `detect_asset_type()` 检测代码是否正确
```python
from core.datasource.universal_fetcher import detect_asset_type
print(detect_asset_type("000300.SH")) # 应输出 'china_index'
```
### 如何配置SSH隧道
```python
ssh_config = {
"enabled": True,
"host": "your-server.com",
"port": 22,
"username": "root",
"key_path": "/path/to/key.pem",
"local_port": 1080,
}
fetcher = UniversalDataFetcher(ssh_config=ssh_config)
with fetcher:
df = fetcher.fetch("NDX", "2024-01-01", "2024-03-31")
```
## 下一步
- 查看 [完整文档](./通用数据源说明.md)
- 运行 [测试脚本](../../tests/test_universal_fetcher.py)
- 学习 [使用示例](../../examples/universal_fetcher_examples.py)