# ai_knowledge

**Repository Path**: tillfall/ai_knowledge

## Basic Information

- **Project Name**: ai_knowledge
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-19
- **Last Updated**: 2026-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 知识库目录

金融数据获取工具、选基回测、信号监控及相关文档。AI 助手处理金融数据、指数分析、基金查询等任务时，优先查阅本目录。

> ⚠️ **维护提醒**：新增/删除/重命名文件后，**必须同步更新本 README**。

## 目录结构

```
/
├── README.md
├── 投资理财/
│   ├── 01指数信息获取.py / .md       # 指数列表/PE/PB/价格/实时行情
│   ├── 11基金信息获取.py / .md       # 基金列表/净值/筛选/退市
│   ├── 12指数选基.py / .md           # 梯度下降优化选基(ETF+上证)
│   ├── 基金回测分析工具.py / .md     # 单基金网格回测+HTML图表
│   ├── 指数买卖点信号监控.py / .md   # 日内涨跌实时信号
│   ├── 21股票信息获取.md              # 新星/akshare股票API
│   └── 数据/中证国证指数/             # 最新PE数据(CSV)
└── 旅游/
    ├── 0-*.md / 1-*.md / 2-*.md      # 风景自驾/骑行/徒步攻略
    └── skill/旅游攻略设计skill.md  # 攻略设计规范与命名
```

## 文件总览

| 编号 | 名称 | 用途 |
|:---:|------|------|
| 01 | 指数信息获取 | 指数列表/PE-PB/行情/统计 |
| 11 | 基金信息获取 | 基金列表/净值/6层筛选 |
| 12 | 指数选基 | ETF+上证双模式选基排名 |
| — | 基金回测分析 | 单基金网格回测+图表 |
| — | 指数信号监控 | 实时买卖信号报告 |
| 21 | 股票信息获取 | 新浪/akshare API参考 |
| — | Gitee推送工具 | 仓库文件推送/删除 |

## 详细说明

### 01 指数信息获取

**依赖** `akshare, pandas, numpy, requests`

**六大能力：**

- **指数列表** — `fetch_all_indices()` CSI+CNI全部指数（~3765条）；`search_indices(kw)` 按关键词搜索
- **PE/PB** — `fetch_major_index_pe_history("沪深300")` 12指数历史PE/PB；`fetch_all_major_pe_history()` 批量；`get_major_index_latest_pe_pb()` 最新汇总
- **最新PE** — `fetch_all_indices_latest_pe()` 三源合并（CNI+CSI+乐咕乐股）
- **价格** — `fetch_major_index_price("沪深300")` 日/周/月线；`fetch_all_major_index_prices("monthly")` 批量16只；`fetch_custom_index_price("sh000001")` 任意符号
- **信号** — `fetch_sh_index(start, end)` 上证日线+涨跌幅；`get_index_period_stats(…)` 区间统计/回撤/波动率；`count_signal_days(…)` 涨跌信号日计数
- **实时** — `IndexRealtimeQuoter.get_major_index_quotes()` 13核心指数实时行情；`get_market_summary()` 市场概况

**12个主要指数**: 上证50、沪深300、上证380、创业板50、中证500、上证180、深证红利、深证100、中证1000、上证红利、中证100、中证800

### 11 基金信息获取

**依赖** `requests, pandas`

- `get_all_funds()` — 全部公募基金列表
- `filter_funds()` — 6层过滤：类型/非人民币/ETF/清盘/清洗
- `get_filtered_funds()` — 一键获取过滤后列表
- `get_fund_nav()` — 基金历史净值
- `get_fund_valuation()` — 基金实时估值
- `batch_check_delisted()` — 批量检查退市

### 12 指数选基

**依赖** `pandas, numpy, openpyxl, akshare, requests`

梯度下降优化版信号网格交易，固定金额买入+比例卖出，XIRR收益评分。

- **宽基ETF** — 信号：8只宽基指数各自涨跌，标的：对应ETF联接基金
- **上证指数** — 信号：上证指数涨跌，标的：全市场过滤后基金

**回测时段**: 21-26（2021-07-01 ~ 至今）和 21-24（2021-07-01 ~ 2024-07-01）

**评分**: 60%×21-26XIRR + 40%×21-24XIRR

**输出**: Excel报告，含策略说明、ETF排名、上证Top50、各基金详情。

### 基金回测分析工具

**依赖** `akshare, pandas, numpy`

单基金网格交易回测，基于基准指数信号，生成含ECharts图表的HTML报告。

### 指数买卖点信号监控

**依赖** `akshare, pandas`

根据指数日内涨跌幅实时判断买卖信号，输出文本+HTML报告，支持Flask调用。

### 21 股票信息获取

纯文档，记录新浪财经和akshare的股票/指数API接口。

## 旅游目录

按地理大区编号 + 目的地 + 主题 + 出行方式 + 天数 命名,共 48 篇攻略:

| 编号段 | 区域 | 数量 |
|:------:|------|:---:|
| `0-` | 中国大陆(新疆/云南/川西/西藏/甘青/东北/海南等) | 17 |
| `1-` | 亚洲(日本/东南亚/中东/南亚) | 12 |
| `2-` | 欧洲(冰岛/希腊/意大利/西葡等) | 8 |
| `3-` | 北美洲(美加/墨西哥) | 4 |
| `4-` | 大洋洲(澳新) | 2 |
| `5-` | 非洲 + 印度洋海岛(Safari / 度假) | 5 |

**攻略设计规范**:`旅游/skill/旅游攻略设计skill.md` —— 11 大模块结构、命名规范、写作规范、7 条强制规范(开篇/目录/酒店/海外APP/高海拔/合规/口吻)、海外与高海拔专项。

## 快速定位

- **指数列表/PE/PB** → `01指数信息获取.py` :: `fetch_all_indices()` `fetch_major_index_pe_history()`
- **上证指数日线** → `01指数信息获取.py` :: `fetch_sh_index()`
- **指数历史价格** → `01指数信息获取.py` :: `fetch_major_index_price()`
- **指数区间统计** → `01指数信息获取.py` :: `get_index_period_stats()`
- **涨跌信号日统计** → `01指数信息获取.py` :: `count_signal_days()`
- **实时行情** → `01指数信息获取.py` :: `IndexRealtimeQuoter`
- **已保存PE数据** → `数据/中证国证指数/全部指数最新PE_YYYYMMDD.csv`
- **基金列表/净值** → `11基金信息获取.py` :: `get_filtered_funds()` `get_fund_nav()`
- **ETF选基回测** → `12指数选基.py` :: `run_etf_backtest()`
- **上证选基回测** → `12指数选基.py` :: `run_sh_index_backtest()`
- **导出选基Excel** → `12指数选基.py` :: `export_excel()`
- **单基金回测** → `基金回测分析工具.py`
- **买卖信号监控** → `指数买卖点信号监控.py`
- **股票API参考** → `21股票信息获取.md`
- **推送文件到Gitee** → `Gitee知识库推送工具.py` :: `push_to_gitee()`

## 编号规则

- **01-09** 指数/行情
- **11-19** 基金/选基
- **21-29** 股票

## 更新日志

- **2026-07-24** 新增 `旅游/skill/旅游攻略设计skill.md`,v1.4 弱化自驾属性;受众分层+角色声明+7 条规范散落至各模块+海外/高海拔专项
- **2026-07-22** 删除Gitee知识库推送工具（.py/.md），清理README相关引用

- **2026-07-22** 新增旅游目录，添加《贵州自驾七日游攻略》（飞贵阳+租车自驾7天环线，含梵净山/黄果树/小七孔/苗寨/镇远）

- **2026-07-22** 文件重命名加编号：01指数信息获取、11基金信息获取、12指数选基、21股票信息获取
- **2026-07-22** 移除所有缓存逻辑，数据一律从网络获取
- **2026-07-22** 宽基ETF精简：删除上证180/红利/中证1000/创业板50，修改4只基金代码
- **2026-07-22** ETF回测改用基金净值作为交易价格，自动过滤成立日晚于回测起始日的基金
- **2026-07-21** 基金回测分析工具：修复当日成本计算bug，增tooltip详情
- **2026-07-20** 新增12指数选基：梯度下降优化，ETF+上证双模式，Excel报告
- **2026-07-20** 合并工具：指数信息获取工具（六大能力），删除冗余旧文件
- **2026-07-20** 新建`投资理财/数据/中证国证指数/`，上传PE数据
- **2026-07-20** 策略更新：选基买入改固定金额(三档网格,上限10万)，收益率用资金加权利用率
- **2026-06-19** 初始创建：上证指数工具、Gitee推送工具、基金/股票工具