[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-93068":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":19,"hasPages":21,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":33,"readmeContent":34,"aiSummary":35,"trendingCount":15,"starSnapshotCount":15,"syncStatus":36,"lastSyncTime":37,"discoverSource":38},93068,"AxData","electkismet\u002FAxData","electkismet","AxData 是一个开源量化数据库框架，覆盖通达信、巨潮、腾讯财经、新浪财经、东方财富、财联社、开盘红等公开源接口。","https:\u002F\u002Felectkismet.github.io\u002FAxData\u002F",null,"Python",55,20,51,0,4,44.37,"Apache License 2.0",false,"main",true,[23,24,25,26,27,28,29,30,31,32],"a-share","china-stock","data-platform","duckdb","financial-data","parquet","plugin-system","python","quantitative-finance","react","2026-07-22 04:02:08","\u003Ch1 align=\"center\">AxData\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>开源量化数据库框架\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Felectkismet.github.io\u002FAxData\u002F\">\u003Cstrong>在线文档\u003C\u002Fstrong>\u003C\u002Fa>\n  ·\n  \u003Ca href=\"https:\u002F\u002Felectkismet.github.io\u002FAxData\u002Finterfaces\u002F\">接口一览\u003C\u002Fa>\n  ·\n  \u003Ca href=\"https:\u002F\u002Fpypi.org\u002Fproject\u002Faxdata\u002F\">PyPI\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Felectkismet\u002FAxData\u002Factions\u002Fworkflows\u002Fci.yml\">\u003Cimg alt=\"检查通过\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F检查-通过-2ea043\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fpypi.org\u002Fproject\u002Faxdata\u002F\">\u003Cimg alt=\"PyPI axdata\" src=\"https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Faxdata?label=PyPI&color=0969da\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Felectkismet.github.io\u002FAxData\u002F\">\u003Cimg alt=\"文档站\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F文档站-接口文档-0969da\">\u003C\u002Fa>\n  \u003Cimg alt=\"Python 3.11+\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.11%2B-3776AB?logo=python&logoColor=white\">\n  \u003Ca href=\".\u002FLICENSE\">\u003Cimg alt=\"Apache-2.0\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F协议-Apache--2.0-blue\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n![AxData 界面预览](docs\u002Fassets\u002Faxdata-readme-banner.png)\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fapi.astlane.com\u002F\">\n    \u003Cimg alt=\"Astlane token 赞助方\" src=\"docs\u002Fassets\u002Fastlane-sponsor.svg\" width=\"860\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## 项目简介\n\n> AxData 是一个 **开源量化数据库框架**，将 `数据源接口`、`采集任务`、`开放文件存储`、`本地查询`、`插件管理`、`Python SDK`、`HTTP API` 和 `Web 控制台` 集合在同一个可扩展的数据平台里。\n>\n> 项目主要面向 **个人量化研究**、**本地数据管理** 和 **数据源插件开发**。\n\n本项目前身为 `eltdx`，因此当前主要数据源和基础采集能力优先围绕通达信体系建设；同时默认数据源能力覆盖交易所、通达信、通达信扩展行情、巨潮、腾讯财经、新浪财经、东方财富、财联社、开盘红等公开源接口。由于接口目录会持续扩展，默认采集插件只内置少量稳定示例；有长期入库需求的接口，可以按数据源插件或采集器插件规范自行编写。欢迎开发者通过 AXP 分享插件，或提交 PR 将成熟数据源或采集器合并进项目。\n\n## 致谢与使用声明\n\n> [!IMPORTANT]\n> 本项目仅是一个开源量化数据库框架，数据接口部分基于互联网公开信息搜集整理。项目不提供商业数据服务，也不代表任何第三方数据源、网站或开源项目的授权。\n\n感谢以下开源项目为本项目的数据源接口研究和实现提供参考：\n\n| 参考项目 | 主要参考方向 |\n| --- | --- |\n| [rainx\u002Fpytdx](https:\u002F\u002Fgithub.com\u002Frainx\u002Fpytdx) | TDX 协议研究和 Python 实现 |\n| [akfamily\u002Fakshare](https:\u002F\u002Fgithub.com\u002Fakfamily\u002Fakshare) | 巨潮、腾讯财经、新浪财经等公开财经数据接口整理 |\n| [fleetinglife\u002Flevistock](https:\u002F\u002Fgithub.com\u002Ffleetinglife\u002Flevistock) | 东方财富、财联社、开盘红等 A 股公开数据接口整理 |\n\n**完整使用边界**\n\n1. 本项目代码按 Apache-2.0 协议开源，主要面向个人学习、技术研究和本地数据管理场景。\n2. 本项目仅是一个开源量化数据库框架，其中数据接口部分基于互联网公开信息搜集、整理和适配。\n3. 本项目不提供任何商业数据服务，也不对任何第三方数据的商业使用作出授权。通过本项目访问或获取第三方数据的，用户需自行确认并遵守对应网站、数据源、开源项目或服务协议；因商业使用、付费服务、生产服务、转售或其他用途产生的风险与责任由使用者自行承担。\n4. 对第三方服务器或服务的访问，用户需自行遵守相关法律法规、数据源条款及服务协议。\n5. 请勿将本项目用于侵犯他人权益、违反监管规定、绕过访问限制或滥用第三方服务的行为。\n\n代码授权见 [LICENSE](LICENSE)；第三方项目、第三方网站和第三方数据源仍归其各自权利人所有，并适用其各自许可证、条款和规则。\n\n## 快速开始\n\n推荐先安装 **完整项目 + Web 控制台**。这一种方式会拉取源码，并准备 Python SDK、CLI、API 和 Web 控制台。\n\n**一行命令安装完整项目**\n\nWindows PowerShell：\n\n```powershell\ngit clone https:\u002F\u002Fgithub.com\u002Felectkismet\u002FAxData.git AxData; cd AxData; powershell -ExecutionPolicy Bypass -File .\\scripts\\bootstrap.ps1\n```\n\nmacOS \u002F Linux：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Felectkismet\u002FAxData.git AxData && cd AxData && bash scripts\u002Fbootstrap.sh\n```\n\n**启动本地 API 和 Web**\n\nWindows PowerShell：\n\n```powershell\n.\\.venv\\Scripts\\python -m uvicorn apps.api.main:app --host 127.0.0.1 --port 8666 --reload\nnpm run dev:web\n```\n\nmacOS \u002F Linux：\n\n```bash\n.\u002F.venv\u002Fbin\u002Fpython -m uvicorn apps.api.main:app --host 127.0.0.1 --port 8666 --reload\nnpm run dev:web\n```\n\n**打开 Web 控制台**\n\n```text\nhttp:\u002F\u002F127.0.0.1:8667\n```\n\n完整项目需要本机先具备 3 个运行环境：\n\n| 环境 | 用途 |\n| --- | --- |\n| Git | 拉取 AxData 源码 |\n| Python 3.11+ | 运行 SDK、CLI、API 和后端服务 |\n| Node.js 22.12+ 或更新 LTS | 运行和构建 Web 控制台 |\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>运行环境安装示例\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nWindows PowerShell：\n\n```powershell\nwinget install --id Git.Git -e\nwinget install --id Python.Python.3.12 -e\nwinget install --id OpenJS.NodeJS.LTS -e\n```\n\nmacOS Homebrew：\n\n```bash\nbrew install git python@3.12 node\n```\n\nUbuntu \u002F Debian：\n\n```bash\nsudo apt update\nsudo apt install -y git python3 python3-venv python3-pip curl ca-certificates\n```\n\nUbuntu \u002F Debian 自带的 `nodejs` 版本可能偏旧；如果 `node --version` 低于 `22.12`，请从 Node.js 官网、NodeSource、nvm\u002Ffnm 或系统软件源安装更新的 Node.js。\n\n\u003C\u002Fdetails>\n\n如果只需要在脚本、Notebook 或命令行里使用 Python SDK\u002FCLI，可以直接安装 Python 包：\n\n```powershell\npip install axdata\n```\n\n`pip install axdata` 面向 Python SDK 和 CLI 使用，会安装 AxData Python 主包、核心依赖，以及随包提供的数据源能力。完整 Web 控制台、接口文档、本地 API 服务和前端源码请使用上面的完整项目安装方式。\n\n**升级现有安装**\n\n通过 PyPI 安装的 Python 包：\n\n```powershell\npython -m pip install --upgrade axdata\n```\n\n通过源码安装的完整项目，请在项目目录运行：\n\nWindows PowerShell：\n\n```powershell\ngit pull --ff-only\npowershell -ExecutionPolicy Bypass -File .\\scripts\\bootstrap.ps1\n```\n\nmacOS \u002F Linux：\n\n```bash\ngit pull --ff-only\nbash scripts\u002Fbootstrap.sh\n```\n\n## 核心能力\n\n| 能力 | 说明 |\n| --- | --- |\n| \u003Ckbd>数据源插件\u003C\u002Fkbd> | 提供接口目录、参数字段、真实样例和源端临时请求能力。 |\n| \u003Ckbd>采集器插件\u003C\u002Fkbd> | 将需要长期保存的数据写入本地 Parquet 数据资产。 |\n| \u003Ckbd>本地数据层\u003C\u002Fkbd> | `raw -> staging -> core -> factor`，以 Parquet 作为事实源。 |\n| \u003Ckbd>统一查询\u003C\u002Fkbd> | DuckDB、Python SDK、CLI、HTTP API 和 Web 使用同一套契约。 |\n| \u003Ckbd>AXP 分享\u003C\u002Fkbd> | 数据源接口、采集器和 Web 内容跟随插件声明，可安装、导出和分享。 |\n\n## Python SDK\n\n本地模式默认直接读取当前机器的数据目录和本机插件，不需要先启动 HTTP 服务。\n\n```python\nimport axdata as ax\n\nclient = ax.AxDataClient()\n\nstocks = client.stock_basic_exchange(\n    exchange=\"SSE\",\n    fields=[\"instrument_id\", \"name\", \"region\", \"company_full_name\"],\n)\n\nquote = client.call(\n    \"stock_realtime_snapshot_tdx\",\n    code=\"000001.SZ\",\n    fields=[\"instrument_id\", \"last_price\", \"change_pct\"],\n)\n```\n\n`client.call(...)` 默认只请求源端一次，不创建采集任务，也不写入本地数据层。需要远程调用时，可连接已启动的 AxData API：\n\n```python\nimport axdata as ax\n\nremote = ax.AxDataClient(api_base=\"http:\u002F\u002F192.168.1.20:8666\")\nstocks = remote.stock_basic_exchange(exchange=\"SZSE\", fields=[\"instrument_id\", \"name\", \"list_date\"])\n```\n\n## 界面预览\n\n### 接口目录与字段说明\n\n![AxData 接口目录与字段说明](docs\u002Fassets\u002Faxdata-interface-catalog.png)\n\n\u003Cdetails>\n\u003Csummary>展开更多界面截图\u003C\u002Fsummary>\n\n### 开始页与架构边界\n\n![AxData 开始页架构总览](docs\u002Fassets\u002Faxdata-start-overview.png)\n\n### 采集任务\n\n![AxData 采集任务页面](docs\u002Fassets\u002Faxdata-collector-task.png)\n\n### 插件管理\n\n![AxData 插件管理页面](docs\u002Fassets\u002Faxdata-plugin-management.png)\n\n\u003C\u002Fdetails>\n\n## 采集与本地数据\n\nAxData 的稳定数据资产以 Parquet 为事实源。采集任务会记录任务、运行、输出路径、行数、字段、日期范围、质量状态、日志和错误分类。\n\n```powershell\n.\\.venv\\Scripts\\axdata data list\n.\\.venv\\Scripts\\axdata data inspect daily\n.\\.venv\\Scripts\\axdata data preview daily --limit 20\n.\\.venv\\Scripts\\axdata query daily --symbol 000001.SZ --start 20240101 --end 20240131 --limit 100\n```\n\n当前默认采集器目录为 TDX 8 个独立采集器，主要用于验证采集链路、提供基础示例和覆盖常用核心数据。默认任务保持小样本参数，不会一键全市场重采。更多接口可以按同一套采集器规范扩展为独立采集器插件。\n\n## 插件体系\n\nAxData 插件是本地安装、本地启用、本地运行的 Python 扩展包。\n\n| 文件 | 作用 |\n| --- | --- |\n| `axdata-provider.json` | 数据源 Provider 插件，提供接口目录和源端临时请求。 |\n| `axdata-plugin.json` | 多能力插件或采集器插件，提供采集器声明、运行入口、输出数据集等能力。 |\n| `.axp` | 本地安装信封，可包含 wheel、manifest、README、LICENSE、checksum 和依赖 wheels。 |\n\n数据源插件和采集器插件可以独立存在：只想提供临时查询时写数据源插件；需要写入本地数据库时再写采集器插件。成熟插件可以导出为 AXP 分享给其他 AxData 用户，也可以提交 PR 合并到项目内置插件中。\n\n```powershell\n.\\.venv\\Scripts\\axdata plugin list --json\n.\\.venv\\Scripts\\axdata plugin installed --json\n.\\.venv\\Scripts\\axdata plugin collectors --json\n.\\.venv\\Scripts\\axdata plugin axp-preview C:\\path\\to\\plugin.axp --json\n.\\.venv\\Scripts\\axdata plugin axp-install C:\\path\\to\\plugin.axp --json\n```\n\n插件卸载不会删除已采集数据、metadata、任务或 run history，只会让插件贡献的接口、采集器、下载器和任务模板从当前可用能力中消失。\n\n## 真实源小样本检查\n\n默认测试不请求真实网络。真实源小样本检查必须显式启用，并建议写到临时目录。\n\n```powershell\n.\\.venv\\Scripts\\python scripts\\smoke_real_sources.py --json\n\n.\\.venv\\Scripts\\python scripts\\smoke_real_sources.py --run `\n  --interfaces tencent_realtime_snapshot `\n  --output-dir $env:TEMP\\axdata-real-source-smoke `\n  --json\n```\n\n`pass` 表示真实源返回小样本、写出 Parquet、质量检查通过且 DuckDB 能读回；`skip` 通常表示未安装、未启用、状态异常或未显式运行；`fail` 通常表示网络、上游、参数或限流问题。\n\n## 目录结构\n\n```text\ndata\u002F\n  raw\u002F       上游原始快照\n  staging\u002F   标准化中间层\n  core\u002F      稳定用户表\n  factor\u002F    因子和研究数据\nmetadata\u002F\n  collector\u002F\n  manifests\u002F\n  quality\u002F\ncache\u002F\nlogs\u002F\nplugins\u002F\n```\n\n`data\u002F`、`metadata\u002Fplugins.json`、`metadata\u002F*.sqlite`、`metadata\u002F*.db`、`cache\u002F`、`logs\u002F` 都是本地运行产物，不应提交。\n\n## 文档\n\n| 用户入口 | 插件开发 |\n| --- | --- |\n| [快速开始](docs\u002Fquickstart.md) | [数据源插件开发](docs\u002Fsource-provider-development.md) |\n| [文档目录](docs\u002FREADME.md) | [采集器插件开发](docs\u002Fcollector-plugin-development.md) |\n| [架构设计](docs\u002Farchitecture.md) | [插件协议](docs\u002Fplugin-spec.md) |\n|  | [AXP 打包与安装](docs\u002Faxp-packaging-guide.md) |\n\n## 开发与验证\n\n```powershell\n.\\.venv\\Scripts\\python -m pytest -q\nnpm run lint:web\nnpm run build:web\n.\\.venv\\Scripts\\python -m compileall -q libs\\axdata_core apps\\api packages\\axdata-sdk services scripts tests\n```\n\n## 交流\n\n- QQ 群：[点击链接加入群聊](https:\u002F\u002Fqm.qq.com\u002Fq\u002FzAjpZsvfzy)\n","AxData 是一个开源量化数据库框架，用于统一接入、采集、存储和查询中国A股市场公开财经数据。它支持通达信、巨潮、新浪财经、东方财富等十余个主流数据源，内置插件化架构、Parquet文件存储、DuckDB本地查询引擎、Python SDK、HTTP API及Web控制台，具备良好的可扩展性与本地化部署能力。项目聚焦个人量化研究、本地金融数据管理及数据源插件开发，不提供商业数据服务，所有接口均基于公开信息适配，强调合规使用与用户自主责任。",2,"2026-07-11 02:30:49","CREATED_QUERY"]