feat: 价格小数位改用协议权威值(SecurityInfo.decimal_point) (#7)
0.6.5 用「代码前缀推断 + 全量清单离线校验」修好了债券/回购标度,但同一份证券 清单接口本来就返回 decimal_point,权威值一直没接进取数路径。本次接进来: - price_decimal_digits:查找顺序改为 权威表 -> 静态前缀规则(兜底) - decimal_sync(新模块):每日后台同步一次 + 磁盘缓存 + 原子写 - TdxData.sync_decimal_points() / decimal_point_status() - start() 不阻塞:当日缓存命中直接装表(60ms 零网络),否则挂后台 task - PYPYTDX_DATA_DISABLE_DECIMAL_SYNC=1 关闭 表按三位前缀归并(全量 5 万只 -> 129 条);若某前缀出现混合小数位则自动退化为 逐代码表,只存例外,mixed_prefixes 可观测。 实测:全量 51,982 条权威表与静态规则零分歧;首次同步 50s(后台), 热缓存 60ms。测试 289 -> 306。 Co-authored-by: openbot-coder <openbot-coder@users.noreply.github.com>
This commit is contained in:
1 parent
b84a6c8a1b
commit
76644919de
13 files changed
+723
-23
No files matched your search
@@ -2,6 +2,43 @@
|
||||
|
||||
本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
|
||||
|
||||
## [0.6.6] - 2026-10-22
|
||||
|
||||
### 改进
|
||||
|
||||
- **价格小数位改用协议自带的权威值,前缀规则降为兜底**。
|
||||
|
||||
0.6.5 修好债券/回购标度时,采用的是「按代码前缀推断」+「用全量清单做离线校验」。
|
||||
但同一份证券清单接口(`get_universe`,底层 `GetSecurityListCmd`)本来就**返回**
|
||||
`SecurityInfo.decimal_point`(外加自描述浮点的 `pre_close`)——权威值一直就在手上,
|
||||
只是没接进取数路径。本次把它接进来:
|
||||
|
||||
| 位置 | 说明 |
|
||||
|---|---|
|
||||
| `price_decimal_digits` | 查找顺序改为 **权威表 → 静态前缀规则**,未同步时行为与 0.6.5 完全一致 |
|
||||
| `decimal_sync`(新模块) | 每日后台同步一次 + 磁盘缓存(`%LOCALAPPDATA%\pytdxdata\decimal-points.json`) |
|
||||
| `TdxData.sync_decimal_points()` | 手动强制刷新(排障 / 立刻要权威表) |
|
||||
| `TdxData.decimal_point_status()` | 状态:`source` / `stock` / `mixed_prefixes` / `syncing` |
|
||||
|
||||
**对用户仍无感**:`start()` 命中当日缓存就直接装表(实测 60 ms、零网络),
|
||||
未命中则挂后台 task(实测首次 50 s,含沪 27,520 + 深 24,462 条清单),
|
||||
不阻塞 `start()`(`start()` 仍 1.5 s);`close()` 会取消未完成的同步。
|
||||
|
||||
**表结构刻意做小**:全量 5 万只标的只产生 **129 个**「三位前缀 → 小数位」映射,
|
||||
内存里就是 129 条。若将来某段代码混用两种小数位,该前缀自动退化为**逐代码表**,
|
||||
只存例外代码(`mixed_prefixes` 会 > 0,可据此发现),不会静默算错。
|
||||
|
||||
为什么保留前缀规则:`get_quotes` 解析是纯同步、无网络的路径,解析那一刻可能还没
|
||||
同步过清单;离线 / 首次安装也必须能出价格。实测两者在全量清单上**零分歧**
|
||||
(51,982 条逐条比对,不一致 0 条),并存不会造成口径冲突。
|
||||
|
||||
开关:`PYPYTDX_DATA_DISABLE_DECIMAL_SYNC=1` 关闭后台同步(CI / 测试用)。
|
||||
|
||||
### 说明
|
||||
|
||||
- 新增回归测试 16 项(权威表优先级 / 混合前缀退化 / 缓存跨日失效 / 损坏容错 /
|
||||
后台任务取消),测试总数 **289 → 306**。
|
||||
|
||||
## [0.6.5] - 2026-10-22
|
||||
|
||||
### 新增
|
||||
|
||||
Reference in new issue
Block a user