From cc04edff10932fd5aed78d3b3426c46d786185c0 Mon Sep 17 00:00:00 2001 From: claude_dev Date: Tue, 8 Sep 2026 13:55:42 +0800 Subject: [PATCH] =?UTF-8?q?docs(spec):=20=C2=A719.10=20=E5=9B=A0=E5=AD=90P?= =?UTF-8?q?1=E6=89=B9=E4=BA=94=E5=9F=9F=E6=94=AF=E6=8C=81=E2=80=94?= =?UTF-8?q?=E2=80=94=E8=AF=BB=E5=8F=96=E5=A5=91=E7=BA=A6=E9=80=9F=E6=9F=A5?= =?UTF-8?q?+gdhs=E8=A1=A5=E5=8F=B2=E7=BB=88=E6=80=812013Q1+=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=E9=93=BE=E4=B8=89=E6=95=99=E8=AE=AD=20[nas]?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../2026-07-21-data-source-fusion-design.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/superpowers/specs/2026-07-21-data-source-fusion-design.md b/docs/superpowers/specs/2026-07-21-data-source-fusion-design.md index 13f1578..c79a009 100644 --- a/docs/superpowers/specs/2026-07-21-data-source-fusion-design.md +++ b/docs/superpowers/specs/2026-07-21-data-source-fusion-design.md @@ -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