A 股零鉴权取数(data-access)

本 skill 是研究宪法 §0 第 1 条("禁止凭记忆生成数据")与 §5("取数只用登记脚本")的落地:每个数字都来自本次运行的脚本调用,原始响应落盘,证据带齐契约字段。脚本只取数、不做算术(单季拆分 / TTM / 同比 / 分位一律交给 calc/)。

1. 调用方式

python3 .agents/skills/data-access/scripts/<script>.py --symbol 300308 --out-dir .local/runs/<run-id>

(示例代码 300308 为 Phase 0 验收标的,仅作命令行示例,不代表任何推荐。)

--symbol 接受 300308 / SZ300308 / 300308.SZ(前后缀二选一,矛盾即报错,绝不猜市场);输出统一 6 位 + 市场 SH|SZ|BJ。
--out-dir 给运行目录:原始响应自动写到 <out-dir>/raw/,结构化结果写到 <out-dir>/fetch/<script>.json;不给则只打印 JSON 到 stdout(仍计算 sha256)。
退出码:0 ok(主源成功)/ 2 partial(走了备源或部分字段缺失,看 extra.degraded 与 errors)/ 3 failed(关键数据全部失败)。非 0 不是"没数据可以编",是"如实记缺口"。
依赖:scripts/requirements.txt(requests / pandas / lxml / akshare / baostock);腾讯、深交所、东财 K 线只用标准库。需要联网;正式研究里由编排器在自己的进程中执行这些脚本,接进来的研究大脑(本机 Agent 或模型 API)不联网、也不直接跑脚本。
东财系请求全部经 common.em_get:跨进程串行(文件锁覆盖整个请求生命周期,任一时刻最多一个东财请求在途,间隔 ≥1s + 抖动)、403 不重试、代理失败自动直连重试、push2 断连自动轮询 push2delay。编排器并行启动多个脚本也会在锁上排队。