quantdb-data-structure SKILL.md skillA
quantdb-data-structure from qusong0627/quantmind is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add qusong0627/quantmind/quantdb-data-structure@git:20260919.a5c8006Pins git:20260919.a5c8006 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- qusong0627/quantmind
- Path
skills/quantdb-data-structure/SKILL.md- Versions recorded
- 3
- Latest version
- git:20260919.a5c8006, committed Sep 19, 2026
- First version recorded
- Aug 30, 2026
- Size
- 7,651 bytes
- Repository stars
- 1,774
- License
- AGPL-3.0
QuantDB 服务器数据结构与读取口径 — 数据目录组织（1_kline_data~6_ml_datasets）、Hive 分区规律（dt=YYYYMMDD 整数）、单文件 {symbol}.parquet、parquet 后缀式代码 600519.SH 与 PG 前缀式 SH600519 的转换口径、quantdb_hub.py 单一读取入口与 DuckDB 视图清单、服务器路径映射（/opt/quantmind/data/quantdb → 容器 /data/quantdb）。凡需要读写/探查/补数/验证 QuantDB 本地 parquet 数据、查目录结构、写 DuckDB 查询、排查查不到数据问题时使用。触发词：quantdb 结构、数据目录、dt 分区、hive 分区、parquet 路径、数据在哪里、600519.SH、代码格式、qdb_ 视图、quantdb_hub、增量同步、数据缺失排查.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
> ⚙️ 本技能遵循公共运行环境契约（最高优先级，先于本文其余内容执行）： > 详见 [_shared/env-contract.md](../_shared/env-contract.md)，执行前先读它。 # quantdb-data-structure — QuantDB 数据结构与读取口径 > 写任何触碰 QuantDB 本地数据的代码/查询前必读。字段单位与口径陷阱另见 > `skills/quantdb-fields/SKILL.md`（本技能管「数据在哪、怎么组织、怎么读」）。 ## 一、路径映射（先定位数据） | 位置 | 路径 | |---|---| | 生产服务器宿主机 | `/opt/quantmind/data/quantdb` | | 容器内（`./data:/data` bind mount） | `/data/quantdb` | | 本地仓库 | `<项目根>/data/quantdb` | | **用户自定义数据集（产出区）** | `/data/quantcustom`（宿主机 `/opt/quantmind/data/quantcustom`） | > ⚠️ `quantdb/` 是**官方只读数据**；`quantcustom/` 是**用户/挖掘产出**（因子挖掘、因子工厂的落盘区，`QM_QUANTCUSTOM_DATA_DIR`）。两者结构同为 6 大类，但写入一律进 `quantcustom`，**不要污染 quantdb**。 数据目录解析优先级（`quantdb_hub.py._resolve_data_dir`）： 环境变量 `QM_QUANTDB_DATA_DIR` → `/data/quantdb` → `/app/data/quantdb` → `D:/quant_data` → 项目根 `data/quantdb`。 ## 二、顶层数据集目录 | 目录 | 内容 | 组织方式 | |---|---|---| | `1_kline_data/` | 日K（daily_forward/backward/unadjusted 三种复权）、index_daily、min1_kline、min5_kline、tick | 日K/指数=分区；分钟线=单文件 | | `2_base_sector/` | instrument_detail、sector_concept、trading_calendar、index_weights、margin_trading、hsgt_north | 混合 | | `3_financial_data/` | balance/income/cashflow/股本/分红因子等财务报表 | 单文件为主 | …
Read the whole file at its exact version.
How to install
mdr add qusong0627/quantmind/quantdb-data-structure@sha256:3a603162f7083ebeThe line at the top of this page pins the label git:20260919.a5c8006, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_f5qbo7iw6bgupdzh)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Aug 30, 2026 and Sep 19, 2026, about one every 10 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260919.a5c8006 latest | 2026-09-19 | a5c8006 | 7,651 B | A | view · diff |
| git:20260913.d790e2e | 2026-09-13 | d790e2e | 7,457 B | A | view · diff |
| git:20260830.03b6bd4 | 2026-08-30 | 03b6bd4 | 6,308 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (7651 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
qusong0627/quantmind · 1,774 stars · license AGPL-3.0 · pushed 2026-10-22 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_f5qbo7iw6bgupdzh GET https://markdownregistry.com/api/v1/resolve?ref=qusong0627/quantmind/quantdb-data-structure GET https://markdownregistry.com/api/v1/blob/3a603162f7083ebe12d0d27ea7d2316b8c0694251595a14e260333f3190f5747
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.