docs(spec): §19.10 因子P1批五域支持——读取契约速查+gdhs补史终态2013Q1+同步链三教训 [nas]
CI/CD / test (push) Successful in 23s
CI/CD / nas-deploy (push) Successful in 24s
CI/CD / nas-verify (push) Successful in 7s

This commit is contained in:
2026-09-08 13:55:42 +08:00
parent 7195aa6e25
commit cc04edff10
@@ -888,6 +888,26 @@ DSM `sanguo-fundamentals-daily` 07:10 已由用户 GUI 注册(09-08 晨)并手
东财 datacenter 1.5s/巨潮 1.0s/东财 search 1.0s/article 2.0s 慢爬,直连不走代理,
日间带 00:30-17:30 语义,baostock 同 IP 单连接 48000 次/天。
### 19.10 因子 P1 批五域支持(2026-09-08,factor 派单回执)
P1 二批 5 因子所需 5 域读取契约(真文件勘测 VPS+NAS,容器复验读通)。NAS 运行时根
`/volume1/stock/sanguo_vnpy_v2/data/`(static 树即 P0 --fund-data-dir 所指):
| 域 | 路径/命名 | 主键 | PIT 列 | 覆盖与坑 |
|---|---|---|---|---|
| dividend | `static/dividend/{code}.{SH\|SZ}_dividend.parquet`(5538 只) | (code,分红事件行) | dividPlanAnnounceDate(可空,回退链 PreNotice→AgmPum→Plan,全空丢行) | baostock 静态快照 2020→2026-07,**无增量 lane**(2027 前开);code 列=`sh.600519` 小写格式;沪深含退市,无北交 |
| gdhs | `static/gdhs/{YYYYMMDD}_gdhs.parquet`(53 期) | (代码,统计截止日-本次) | 公告日期 | **2013Q1→2026Q1**(09-08 补史 44 期/15.4 万行,源头边界 2013Q1 实测钉死,2012Q4 前东财无数据);「本次/上次」截止日不规则→增减比例≠统一季环比,消费方自建事件表自算 Δln;ak-weekly 滚动 3 年窗喂新期(披露守卫 90 天) |
| top_holders | `static/top_holders/{code}.{EXC}_{期}_top_holders.parquet`(10.9 万文件) | (code,期,名次) | 无公告日列→法定披露截止近似(Q1→04-30/H1→08-31/Q3→10-31/年报→次年04-30) | 2020Q1→2026Q2;增减列混「不变」字符串;占比=%单位;北交排除 |
| financial_abstract | `static/financial_abstract/{code}.{EXC}_*.parquet`(5559 只) | (指标,报告期)——**转置宽表**(行=80 指标,列=报告期) | **无 NOTICE_DATE,直接用有前视风险** | 1998→2026Q2;E08 已定改三表自算 CCC(复用 NOTICE_DATE PIT),本域只作对账源;ak-daily 19:00 日更 |
| valuation_baostock | **`data/valuation_baostock/{year}.parquet`**(static 兄弟目录) | (symbol,date) | 日频即点时 | 1990→2026 含退市(000003 实测在);2026 仅 08-13 起,H1 缺口=基线层 em valuation 补;亏损/净资负 peTTM、pbMRQ=NaN;date 为字符串 |
gdhs 补史实施: `akshare_static_download.py --gdhs-start 20130331`(040a39e,枚举外扩+marker
幂等,TDD 23 测绿),VPS 一趟 44/44 ok/154031 行/104s,VPS+NAS 双侧 53 期对齐。同步链同日
两修一加固: ①`dir /b` 枚举 CRLF 清洗(a37d324——此前 6 天文件名尾粘回车符 scp 静默失败,
NAS 空目录) ②257bd3b 引入注释断行语法死(裸引号未闭合致整脚本 parse 失败,bash -n 抓出,
7195aa6 修回)——**shell 改完必跑 bash -n,CI 只覆盖 pytest 救不了 shell** ③skip-if-exists
(期文件 write-once,53 文件无需每日重拉)。
## 参考(调查来源)
- xtdata 官方:https://dict.thinktrader.net/nativeApi/xtdata.html