新增 CLAUDE.md,重置 README.md
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,34 @@
|
|||||||
|
# CLAUDE.md
|
||||||
|
|
||||||
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||||||
|
|
||||||
|
## Project Overview
|
||||||
|
|
||||||
|
AI 协助分析交易数据和回测的仓库。主要用来做策略回测、行情分析、期权定价、资产配置等量化相关操作。
|
||||||
|
|
||||||
|
## Python Environment
|
||||||
|
|
||||||
|
- Python 3.13 (Homebrew at `/opt/homebrew/bin/python3`)
|
||||||
|
- `pip` 与 `python3` 版本可能不对应(pip 可能指向 3.9),安装包时用 `/opt/homebrew/bin/python3 -m pip install <pkg>` 或创建 venv
|
||||||
|
- `.venv/` 已 gitignore
|
||||||
|
- 常用库: `pandas`, `numpy`, `akshare`, `yfinance`, `tushare`
|
||||||
|
|
||||||
|
## Data Sources
|
||||||
|
|
||||||
|
按优先级排序:
|
||||||
|
|
||||||
|
1. **Tushare Pro** — 优先使用,数据最全(股票、期货、指数、期权等)
|
||||||
|
- Token: `76efd8465f9f2591aa42a385268e06acf6b80b7a15be2267ad2281b7`
|
||||||
|
- 用法: `import tushare as ts; ts.set_token('...'); pro = ts.pro_api()`
|
||||||
|
2. **akshare** — 备选,无需 token,覆盖面广
|
||||||
|
- A股指数: `ak.stock_zh_index_daily(symbol="sh000300")`
|
||||||
|
- 全球指数: `ak.index_global_hist_em(symbol="纳斯达克")`
|
||||||
|
- 个股: `ak.stock_zh_a_hist(symbol="600030", adjust="qfq")`
|
||||||
|
- 期货主连: `ak.futures_main_sina(symbol="FG0")`
|
||||||
|
3. **yfinance** — 海外市场(注意频次限制,需加 sleep)
|
||||||
|
|
||||||
|
## Conventions
|
||||||
|
|
||||||
|
- 期货主连代码格式: `FG0` (品种代码 + "0")
|
||||||
|
- A股个股复权方式: 前复权 (`adjust="qfq"`)
|
||||||
|
- 图表输出到 `/tmp/` 临时目录,不回写仓库
|
||||||
@@ -1,57 +1,3 @@
|
|||||||
# futures-data-warehouse
|
# futures-data-warehouse
|
||||||
|
|
||||||
期货合约每日收盘数据仓库。数据通过 Tushare Pro API 获取,按品种-合约组织存储。
|
期货与股票数据分析仓库。
|
||||||
|
|
||||||
## 目录结构
|
|
||||||
|
|
||||||
```
|
|
||||||
data/ # CSV 数据文件,按品种分文件夹存放
|
|
||||||
FG/ # 玻璃期货
|
|
||||||
FG2609.csv
|
|
||||||
FG2610.csv
|
|
||||||
...
|
|
||||||
db/ # SQLite 数据库
|
|
||||||
futures.db
|
|
||||||
update.py # 数据拉取脚本
|
|
||||||
```
|
|
||||||
|
|
||||||
## CSV 字段说明
|
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `ts_code` | str | TS 合约代码,如 `FG2609.ZCE` |
|
|
||||||
| `trade_date` | str | 交易日期,格式 `YYYYMMDD` |
|
|
||||||
| `pre_close` | float | 昨收盘价 |
|
|
||||||
| `pre_settle` | float | 昨结算价 |
|
|
||||||
| `open` | float | 开盘价 |
|
|
||||||
| `high` | float | 最高价 |
|
|
||||||
| `low` | float | 最低价 |
|
|
||||||
| `close` | float | 收盘价 |
|
|
||||||
| `settle` | float | 结算价 |
|
|
||||||
| `change1` | float | 涨跌 1(收盘价 - 昨结算价) |
|
|
||||||
| `change2` | float | 涨跌 2(结算价 - 昨结算价) |
|
|
||||||
| `vol` | float | 成交量(手) |
|
|
||||||
| `amount` | float | 成交金额(万元) |
|
|
||||||
| `oi` | float | 持仓量(手) |
|
|
||||||
| `oi_chg` | float | 持仓量变化 |
|
|
||||||
| `delv_settle` | float | 交割结算价(交割月附近出现) |
|
|
||||||
|
|
||||||
## 数据库
|
|
||||||
|
|
||||||
`db/futures.db` 为 SQLite 数据库,包含两张表:
|
|
||||||
|
|
||||||
### daily — 日线行情数据
|
|
||||||
|
|
||||||
主键 `(ts_code, trade_date)`,字段与 CSV 一致,支持 `INSERT OR REPLACE` 幂等更新。
|
|
||||||
|
|
||||||
### contracts — 合约元数据
|
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `ts_code` | TEXT PK | 合约代码,如 `FG2609.ZCE` |
|
|
||||||
| `symbol` | TEXT | 交易标识 |
|
|
||||||
| `name` | TEXT | 中文简称 |
|
|
||||||
| `exchange` | TEXT | 交易所代码 |
|
|
||||||
| `fut_code` | TEXT | 品种代码,如 `FG` |
|
|
||||||
| `list_date` | TEXT | 上市日期 |
|
|
||||||
| `delist_date` | TEXT | 退市日期 |
|
|
||||||
|
|||||||
Reference in New Issue
Block a user