docs: 建立 MkDocs 文档站与 AI 层文档
- 新增 MkDocs + Material 文档站(19 页):入门、CLI、场景示例、FAQ、 Contributing、Changelog、API 参考(mkdocstrings 自动渲染)、内部原理 (架构 / 协议 / 三池路由 / 缓存) - 新增 docs/llms.txt:面向 LLM 的结构化摘要(枚举取值、方法速查、常见陷阱) - 新增 scripts/check_docs.py:校验文档与 api.py 公开方法清单是否漂移 - 新增根 CHANGELOG.md 作为版本记录唯一来源,docs/changelog.md 用 snippet 引入 - 新增 .github/workflows/docs.yml:push main 自动构建并部署 GitHub Pages - 修正文档口径:TdxData 公开方法 53 个(51 数据方法 + start/close); API_REFERENCE 版本号 v0.3.2 -> v0.4.0 - pyproject.toml 新增 docs 依赖组;.gitignore 忽略 site/
This commit is contained in:
1 parent
02ec5b6e33
commit
c4dd61665b
26 files changed
+2934
-1
No files matched your search
@@ -0,0 +1,112 @@
|
||||
# 枚举速查
|
||||
|
||||
!!! danger "先看这里——本项目最容易踩的坑"
|
||||
通达信的枚举取值**完全没有直觉**:`KlinePeriod.DAY` 是 **4** 不是 0 也不是 3,
|
||||
`ExMarket.HK_MAIN_BOARD` 是 **31**,`Market.SZ` 是 **0**。
|
||||
写死数字几乎必错,**请一律使用枚举成员**。
|
||||
|
||||
```python
|
||||
from pytdxdata.models import Adjust, ExMarket, KlinePeriod, Market
|
||||
```
|
||||
|
||||
## Market — 普通市场
|
||||
|
||||
| 成员 | 值 | 说明 |
|
||||
|---|---|---|
|
||||
| `Market.SZ` | `0` | 深圳 |
|
||||
| `Market.SH` | `1` | 上海 |
|
||||
| `Market.BJ` | `2` | 北京(北交所) |
|
||||
|
||||
!!! warning "代码不唯一"
|
||||
**市场 + 代码**才唯一。`(SH, "000001")` 是上证指数,`(SZ, "000001")` 是平安银行。
|
||||
所有接口的第一个参数都是 `market`,就是为了消歧。
|
||||
|
||||
## KlinePeriod — K 线周期
|
||||
|
||||
| 成员 | 值 | 说明 |
|
||||
|---|---|---|
|
||||
| `KlinePeriod.MIN_5` | `0` | 5 分钟 |
|
||||
| `KlinePeriod.MIN_15` | `1` | 15 分钟 |
|
||||
| `KlinePeriod.MIN_30` | `2` | 30 分钟 |
|
||||
| `KlinePeriod.MIN_60` | `3` | 60 分钟 |
|
||||
| `KlinePeriod.DAY` | `4` | **日线(最常用)** |
|
||||
| `KlinePeriod.WEEK` | `5` | 周线 |
|
||||
| `KlinePeriod.MONTH` | `6` | 月线 |
|
||||
| `KlinePeriod.MIN_1` | `7` | 1 分钟 |
|
||||
| `KlinePeriod.MIN_3` | `8` | 3 分钟 |
|
||||
| `KlinePeriod.YEAR` | `9` | 年线 |
|
||||
| `KlinePeriod.SEASON` | `10` | 季线 |
|
||||
| `KlinePeriod.YEAR_ALT` | `11` | 另一套年线编码 |
|
||||
|
||||
取值**与通达信协议字节一致**(`KlineCategory`)。附带一个属性:
|
||||
|
||||
```python
|
||||
KlinePeriod.MIN_1.is_minute # True
|
||||
KlinePeriod.DAY.is_minute # False
|
||||
```
|
||||
|
||||
!!! warning "`MIN_1` 会换通道"
|
||||
`MIN_1` 被强制路由到 **MAC 通道**并采用**单连接串行分页**,
|
||||
避免并发分页在多服务器深度不一致时产生数据空洞。
|
||||
详见 [通道与数据源](../internals/routing.md)。
|
||||
|
||||
## Adjust — 复权方式
|
||||
|
||||
| 成员 | 值 | 说明 |
|
||||
|---|---|---|
|
||||
| `Adjust.NONE` | `0` | 不复权(**默认**) |
|
||||
| `Adjust.QFQ` | `1` | 前复权 |
|
||||
| `Adjust.HFQ` | `2` | 后复权 |
|
||||
|
||||
`adjust != NONE` 时 K 线请求会切到 **MAC 通道**(标准通道不提供复权数据)。
|
||||
|
||||
!!! tip "和券商软件对不上,先差这里"
|
||||
很多券商前端默认前复权,而本包默认 `NONE`。对比数据前先确认两边复权方式一致。
|
||||
|
||||
## ExMarket — 扩展市场 {#exmarket}
|
||||
|
||||
港股 / 美股 / 期货 / 期权等走通达信 **EX 通道(端口 7727)**,`market` 参数传 `ExMarket` 成员。
|
||||
|
||||
### 常用值速查
|
||||
|
||||
| 成员 | 值 | 说明 |
|
||||
|---|---|---|
|
||||
| `ExMarket.SH_STOCK_OPTION` | `8` | 沪股票期权 |
|
||||
| `ExMarket.SZ_STOCK_OPTION` | `9` | 深股票期权 |
|
||||
| `ExMarket.ZZ_FUTURES` | `28` | 郑商所期货 |
|
||||
| `ExMarket.DL_FUTURES` | `29` | 大商所期货 |
|
||||
| `ExMarket.SH_FUTURES` | `30` | 上期所期货 |
|
||||
| `ExMarket.HK_MAIN_BOARD` | `31` | **港股主板(最常用)** |
|
||||
| `ExMarket.NEEQ` | `44` | 新三板 |
|
||||
| `ExMarket.CFFEX_FUTURES` | `47` | 中金所期货(股指 / 国债) |
|
||||
| `ExMarket.HK_GEM` | `48` | 港股创业板 |
|
||||
| `ExMarket.GZ_FUTURES` | `66` | 广期所期货 |
|
||||
| `ExMarket.GE_STOCK` | `73` | 德国股票 |
|
||||
| `ExMarket.US_STOCK` | `74` | **美股(最常用)** |
|
||||
|
||||
```python
|
||||
from pytdxdata.models import ExMarket, KlinePeriod
|
||||
|
||||
await td.get_kline(ExMarket.HK_MAIN_BOARD, "00700", KlinePeriod.DAY, count=700) # 腾讯
|
||||
await td.get_kline(ExMarket.US_STOCK, "AAPL", KlinePeriod.DAY, count=700) # 苹果
|
||||
await td.get_kline(ExMarket.CFFEX_FUTURES, "IFL0", KlinePeriod.DAY, count=700) # 股指期货
|
||||
await td.get_kline(ExMarket.SH_STOCK_OPTION, "10010971", KlinePeriod.DAY, count=700)
|
||||
```
|
||||
|
||||
### 完整成员列表
|
||||
|
||||
以下由 `mkdocstrings` 从源码实时渲染,**以源码为准**:
|
||||
|
||||
::: pytdxdata.models.ExMarket
|
||||
options:
|
||||
show_root_heading: false
|
||||
show_root_toc_entry: false
|
||||
members_order: source
|
||||
|
||||
!!! note "美股期权 / 港股期权不在其中"
|
||||
通达信协议内**没有**美股、港股期权数据。美股期权需要走 CBOE 公开接口。
|
||||
|
||||
## 下一步
|
||||
|
||||
- [数据模型](models.md) — 返回对象字段
|
||||
- [通道与数据源](../internals/routing.md) — 每个枚举对应哪台服务器
|
||||
Reference in new issue
Block a user