新增 CLAUDE.md,重置 README.md

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
fish
2026-07-20 17:42:25 +08:00
parent a6c7f8f8cc
commit 30bb71f9c5
2 changed files with 35 additions and 55 deletions
+34
View File
@@ -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 -55
View File
@@ -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 | 退市日期 |