CNEquity
September 5, 2026 · View on GitHub
从 A 股开始的本地可日更、可溯源金融数据底座：多源采集、编排、标准化，交付带溯源、列契约稳定的 Parquet 数据层。
CLI 是 cne，Python 包是 cnequity。推荐：pip install cnequity → cne demo 试玩，或 cne config init 写出配置再跑全量。数据湖根目录默认 ./data/cnequity。
建议顺序： 安装 → 快速开始 → 配置。卡在网络 / TDX / workers 时看 排障。
定位与合规（开源读者可先看）：与同类项目差异 · 许可与数据合规。
产品边界与近期方向：ROADMAP。
可搜索的在线文档站：rootsunc.github.io/cnequity。
面向使用者的文档以中文为准；CHANGELOG 与 ADR 保持英文。英文简介见 README.en.md。
术语约定
| 中文 | 英文/代码 | 含义 |
|---|---|---|
| 波次 | Wave | 日更编排中的一批并行/串行 step |
| 主键 | PK / primary key | curated 去重与契约键 |
| 主源 / 备源 | primary / backup | 写入 curated 的源 vs 仅进 source_snapshots 的源 |
| 主备切换 | Failover | 主源失败时写备源快照，不自动顶替 curated |
| 权威行 | canonical | curated 中每主键一行的正式数据 |
| 溯源 | provenance | source / data_version / fetched_at |
| 水位 | watermark | meta/state 中已成功 compact 的进度 |
| 按需 | on-demand | 不进日更主路径、按 symbol 拉取并缓存 |
| 备份 | backup（脚本/目录） | 元数据归档；与「备源」不同 |
入门
数据集与查询
- 数据集目录 · Schema
- 查询指南 · 逐源限制
- CLI · Python API · MCP（接给 AI agent）
研究 Recipes
运维
架构
模块地图（贡献者）
源码包拆分说明：modules/（config / domain / adapters / orchestrator / steps / storage / derive / quality / query / cli）。
定位与合规
版本
当前主线 0.8.0（见 CHANGELOG）。从 0.3.x 升级先看其中的 Upgrading from 0.3.x，以及 installation — 升级。