tdx2ckz 0.1.0__tar.gz

tdx2ckz-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qiuxiaoying
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tdx2ckz-0.1.0/PKG-INFO

@@ -0,0 +1,222 @@
+Metadata-Version: 2.1
+Name: tdx2ckz
+Version: 0.1.0
+Summary: 通达信 .day 日线与 gbbq 股本变迁读取器（Windows x64）
+Author: qiuxiaoying
+License: MIT
+Project-URL: Homepage, https://github.com/qiuxiaoying/tdx2ckz
+Project-URL: Repository, https://github.com/qiuxiaoying/tdx2ckz
+Keywords: 通达信,tdx,day,gbbq,stock-data,market-data
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# tdx2ckz
+
+通达信（TDX）本地数据读取器：把 `vipdoc` 下的 `.day` 日线文件与 `T0002/hq_cache/gbbq`
+股本变迁文件直接解析成 pandas `DataFrame`。
+
+- 只有两个入口：`read_lday(path)`、`read_gbbq(path)`
+- 单个 C 扩展 `tdx2ckz._core`，`Py_LIMITED_API=0x03080000`，wheel 标签 `cp38-abi3-win_amd64`
+- 仅支持 **Windows x64**（C 源在非 Windows 直接 `#error`，`setup.py` 在非 `win32` 直接 `RuntimeError`）
+- C 层不依赖 numpy C API：按列返回连续缓冲，Python 侧 `np.frombuffer` 零拷贝组表
+
+## 构建
+
+```powershell
+# 开发：就地编译
+python setup.py build_ext --inplace
+
+# 发布 wheel（只产 wheel，不产 sdist）
+python -m pip wheel . --no-deps --no-build-isolation -w dist
+
+# 发布 sdist（只产 tar.gz，不产 wheel）
+python setup.py sdist --dist-dir dist
+```
+
+| 命令 | 产物 |
+| --- | --- |
+| `pip wheel ...` | `tdx2ckz-0.1.0-cp38-abi3-win_amd64.whl`（只产 wheel） |
+| `setup.py sdist` | `tdx2ckz-0.1.0.tar.gz`（只产 sdist） |
+
+`setup.py` 声明 `Extension`，并通过 `options={"bdist_wheel": {"py_limited_api": "cp38"}}`
+固定 wheel 标签；源码树中的 `setup.cfg` 已移除，构建不再依赖它。
+
+`python -m build` 需要额外安装 `build` 包，离线环境请用上面两条命令。
+
+`tar.gz` 解包后出现的 `tdx2ckz-0.1.0/setup.cfg` 是 `egg_info` 打包时**自动生成**的构建
+副产品（内容只有 `[egg_info]` 的 `tag_build` / `tag_date`），与源码树中已删除的那个
+`setup.cfg` 不是同一个文件。
+
+清空 `.pyd` 与 `build/` 后重建，编译器（MSVC `/W3 /O2 /utf-8`）输出 **0 warning / 0 error**。
+
+## 用法
+
+```python
+import tdx2ckz
+
+lday = tdx2ckz.read_lday(r"C:\new_tdx_mock\vipdoc")
+print(lday.dtypes)
+print(lday.head())
+
+gbbq = tdx2ckz.read_gbbq(r"C:\new_tdx_mock\T0002\hq_cache\gbbq")
+print(gbbq.dtypes)
+```
+
+### read_lday
+
+`path` 是 `vipdoc` 这类根目录：递归遍历所有子目录，只取 `.day`，其它扩展名一律跳过。
+
+| 列 | dtype | 说明 |
+| --- | --- | --- |
+| code | category | 归一后的代码，如 `sh600000`、`ds47#IF00` |
+| date | datetime64[ns] | 交易日 |
+| open / high / low / close | float64 | 价格 |
+| amount | float64 | 成交额 |
+| volume | uint32 | 成交量 |
+
+- `.day` 为 32 字节定长记录；`sh`/`sz`/`bj` 的 OHLC 为整数分，除以 100
+- `ds`（扩展行情）的 OHLC 是 **float32 原值，不除以 100**；直接提升到 float64 会带二进制
+  残尾（`209.97691345214844`），而真实价格是 3 位小数，因此 `open/high/low/close`
+  统一四舍五入到 3 位小数（`209.977`、`181.462`）
+- `ds` 的 `amount` 保持原值，不做小数处理：实测该字段是整数、量级 2.7×10⁹–1.0×10¹¹，
+  float32 在该量级的间隔（ULP）已达 8192，补 3 位小数没有意义
+- 市场归属规则：相对路径中出现的市场目录名（`sh/sz/bj/ds`），或 `.day` 文件名自带的市场
+  前缀；因此单独指向 `vipdoc\ds\lday` 时，其下所有文件仍能正确识别为 `ds`
+- 递归时跳过符号链接 / 联接点（junction）目录，不跟随
+- 行序只由文件扫描顺序（路径排序）决定，与线程调度无关
+- 空目录返回 0 行、同 schema 的 DataFrame
+
+代码归一：
+
+1. 取文件名主干；前两位是 `sh/sz/bj/ds` 时识别为市场前缀并统一小写，其余字符原样保留
+   （`SH600000.day` → `sh600000`）
+2. 主干无前缀时补上一级市场目录名（`ds/lday/47#IF00.day` → `ds47#IF00`，`IF00` 保持大写，
+   `#` 前的交易所编号保留）
+3. 归一后代码重复（如 `sh600000` 与 `SH600000`）在扫描阶段直接抛 `ValueError`，异常文本列出
+   全部冲突路径；跨市场同代码（`sh600000` 与 `sz600000`）不算冲突
+
+异常：目录不存在 → `FileNotFoundError`；路径不是目录、文件长度不是 32 的整数倍 →
+`ValueError`，异常文本均带完整路径。长度校验默认用目录枚举得到的字节数；若实际读取到的
+大小与之不符，以实读结果为准（详见下文“为什么用目录枚举的大小”）。
+
+### read_gbbq
+
+gbbq 文件：4 字节头记录数 + 每条 29 字节（前 24 字节为 16 轮 sbox 加密，后 5 字节明文）。
+
+| 列 | dtype | 说明 |
+| --- | --- | --- |
+| market | uint8 | 市场编号 |
+| code | category | 证券代码（文件内容，去掉尾部 NUL） |
+| date | uint32 | `YYYYMMDD` 整数 |
+| category | uint8 | 记录类别 |
+| f1..f4 | float64 | 四个浮点字段 |
+
+头部记录数必须与文件长度严格一致，否则 `ValueError`（带路径、记录数与字节数）；
+0 条记录返回 0 行同 schema DataFrame。
+
+## 性能
+
+- 扫描用 `os.scandir` 递归，文件大小直接取 `DirEntry.stat().st_size`，随扫描结果一起传给 C 层
+- 读取按文件多线程切分，默认 `min(4, CPU)`；`TDX2CKZ_THREADS=1` 回单线程
+- 线程只写各自分片的预分配列缓冲，因此结果与调度顺序无关
+
+### 为什么用目录枚举的大小
+
+逐文件调用 `GetFileAttributesExW` 在本机会卷上有明显开销：约 **0.40 ms/次**，`sh` 的
+6,053 个文件合计约 **2.35 s**，占修复前 sh 耗时（3.004 s）的绝大部分。而 `os.scandir`
+返回的 `DirEntry.stat().st_size` 直接复用 `FindFirstFileW` 已给出的结果，同样 6,053 个
+文件只需 **0.029 s**，几乎免费。所以扫描阶段一次枚举就把大小带到 C 层，线程启动前不再
+逐文件 stat。
+
+代价是“扫描后、读取前文件被改动”不再是隐含假设，C 层对此有显式保护：
+
+- 每轮开始前按当前行数重算偏移并重新分配列缓冲
+- 某文件实际行数与枚举行数不符时 **不写任何字节**，改用实读大小重排该文件行数，最多重试
+  **4 轮**
+- 实际长度不是 32 的整数倍 → `ValueError`（异常文本带实际字节数）
+- 枚举大小不是 32 的整数倍 → `ValueError`（带枚举字节数）；0 字节文件贡献 0 行
+- 4 轮后仍不一致 → `ValueError("文件大小在扫描与读取之间持续变化: ...")`
+
+### 分市场（修复后，各 5 次取中位）
+
+`C:\new_tdx_mock\vipdoc`，单进程、默认 4 线程：
+
+| 市场 | 文件数 | 行数 | 中位耗时 | 峰值内存 |
+| --- | --- | --- | --- | --- |
+| sh | 6,053 | 15,328,535 | **0.746 s** | 938 MB |
+| sz | 5,928 | 14,207,349 | **0.730 s** | 877 MB |
+| bj | 373 | 283,177 | **0.038 s** | 94 MB |
+| ds | 3 | 3,943 | **0.006 s** | 78 MB |
+
+修复前 sh 为 3.004 s；瓶颈是主线程串行的 6,053 次 `GetFileAttributesExW`。
+
+### C 核心层与分段耗时（sh）
+
+| 项目 | 单线程 | 4 线程 |
+| --- | --- | --- |
+| C 核心（打开 + 读 + 解码 + 写列缓冲） | 1.868 s | 0.606 s（**3.08×**） |
+
+端到端 sh 单线程（`TDX2CKZ_THREADS=1`）**2.050 s**，默认 4 线程 0.746 s（2.75×）。
+
+sh 分段（4 线程）：scan **0.039 s**、core **0.606 s**、DataFrame 组装约 **0.20 s**
+（其中 `np.repeat` 0.062 s、`Categorical` 0.022 s、`DataFrame` 构造 0.111 s）。
+
+### 整体（`vipdoc` 全量）
+
+| 指标 | 数值 |
+| --- | --- |
+| 文件数 | 12,357（sh 6053 / sz 5928 / bj 373 / ds 3） |
+| 总行数 | 29,823,004 |
+| 出现代码 | 12,355（另有 2 个 0 字节 `.day` 无数据行） |
+| 日期范围 | 1990-12-19 → 2026-11-06 |
+| 热读耗时（4 次） | 1.540 / 1.462 / 1.794 / 1.561 s，中位 **1.561 s** |
+| 峰值内存 | **1.75 GB**（DataFrame 本身 1.50 GB，列缓冲零拷贝） |
+
+gbbq：194,352 条，热读中位 **0.087 s**。
+
+复现：
+
+```powershell
+python bench/bench.py
+```
+
+## 测试
+
+```powershell
+# 合成样本（schema/值/递归/归一/冲突/空目录/异常/gbbq 解密）
+python -m pytest tests -q
+
+# 追加真实数据逐值交叉验证（独立 Python 解析，逐值零差异）
+TDX2CKZ_REAL=1 python -m pytest tests -q -k real
+
+# PowerShell 下等价写法
+$env:TDX2CKZ_REAL="1"; python -m pytest tests -q -k real
+```
+
+交叉验证用 numpy 结构化 dtype + pandas 日期解析 + 独立实现的 16 轮 sbox 解密，
+与 C 层逐文件、逐列比对（`assert_array_equal`，不做近似）。
+
+## 目录
+
+```
+tdx2ckz.c                 # 唯一 C 源，导出 read_lday / read_gbbq
+tdx2ckz/__init__.py       # 两个入口，C 层缓冲 -> DataFrame
+tdx2ckz/__init__.pyi      # 类型与中文注释
+tdx2ckz/py.typed
+setup.py                  # Extension 声明 + wheel 标签（options.bdist_wheel.py_limited_api）
+pyproject.toml            # build-system + project 元数据
+tests/test_readers.py
+bench/bench.py
+```

tdx2ckz-0.1.0/README.md

@@ -0,0 +1,198 @@
+# tdx2ckz
+
+通达信（TDX）本地数据读取器：把 `vipdoc` 下的 `.day` 日线文件与 `T0002/hq_cache/gbbq`
+股本变迁文件直接解析成 pandas `DataFrame`。
+
+- 只有两个入口：`read_lday(path)`、`read_gbbq(path)`
+- 单个 C 扩展 `tdx2ckz._core`，`Py_LIMITED_API=0x03080000`，wheel 标签 `cp38-abi3-win_amd64`
+- 仅支持 **Windows x64**（C 源在非 Windows 直接 `#error`，`setup.py` 在非 `win32` 直接 `RuntimeError`）
+- C 层不依赖 numpy C API：按列返回连续缓冲，Python 侧 `np.frombuffer` 零拷贝组表
+
+## 构建
+
+```powershell
+# 开发：就地编译
+python setup.py build_ext --inplace
+
+# 发布 wheel（只产 wheel，不产 sdist）
+python -m pip wheel . --no-deps --no-build-isolation -w dist
+
+# 发布 sdist（只产 tar.gz，不产 wheel）
+python setup.py sdist --dist-dir dist
+```
+
+| 命令 | 产物 |
+| --- | --- |
+| `pip wheel ...` | `tdx2ckz-0.1.0-cp38-abi3-win_amd64.whl`（只产 wheel） |
+| `setup.py sdist` | `tdx2ckz-0.1.0.tar.gz`（只产 sdist） |
+
+`setup.py` 声明 `Extension`，并通过 `options={"bdist_wheel": {"py_limited_api": "cp38"}}`
+固定 wheel 标签；源码树中的 `setup.cfg` 已移除，构建不再依赖它。
+
+`python -m build` 需要额外安装 `build` 包，离线环境请用上面两条命令。
+
+`tar.gz` 解包后出现的 `tdx2ckz-0.1.0/setup.cfg` 是 `egg_info` 打包时**自动生成**的构建
+副产品（内容只有 `[egg_info]` 的 `tag_build` / `tag_date`），与源码树中已删除的那个
+`setup.cfg` 不是同一个文件。
+
+清空 `.pyd` 与 `build/` 后重建，编译器（MSVC `/W3 /O2 /utf-8`）输出 **0 warning / 0 error**。
+
+## 用法
+
+```python
+import tdx2ckz
+
+lday = tdx2ckz.read_lday(r"C:\new_tdx_mock\vipdoc")
+print(lday.dtypes)
+print(lday.head())
+
+gbbq = tdx2ckz.read_gbbq(r"C:\new_tdx_mock\T0002\hq_cache\gbbq")
+print(gbbq.dtypes)
+```
+
+### read_lday
+
+`path` 是 `vipdoc` 这类根目录：递归遍历所有子目录，只取 `.day`，其它扩展名一律跳过。
+
+| 列 | dtype | 说明 |
+| --- | --- | --- |
+| code | category | 归一后的代码，如 `sh600000`、`ds47#IF00` |
+| date | datetime64[ns] | 交易日 |
+| open / high / low / close | float64 | 价格 |
+| amount | float64 | 成交额 |
+| volume | uint32 | 成交量 |
+
+- `.day` 为 32 字节定长记录；`sh`/`sz`/`bj` 的 OHLC 为整数分，除以 100
+- `ds`（扩展行情）的 OHLC 是 **float32 原值，不除以 100**；直接提升到 float64 会带二进制
+  残尾（`209.97691345214844`），而真实价格是 3 位小数，因此 `open/high/low/close`
+  统一四舍五入到 3 位小数（`209.977`、`181.462`）
+- `ds` 的 `amount` 保持原值，不做小数处理：实测该字段是整数、量级 2.7×10⁹–1.0×10¹¹，
+  float32 在该量级的间隔（ULP）已达 8192，补 3 位小数没有意义
+- 市场归属规则：相对路径中出现的市场目录名（`sh/sz/bj/ds`），或 `.day` 文件名自带的市场
+  前缀；因此单独指向 `vipdoc\ds\lday` 时，其下所有文件仍能正确识别为 `ds`
+- 递归时跳过符号链接 / 联接点（junction）目录，不跟随
+- 行序只由文件扫描顺序（路径排序）决定，与线程调度无关
+- 空目录返回 0 行、同 schema 的 DataFrame
+
+代码归一：
+
+1. 取文件名主干；前两位是 `sh/sz/bj/ds` 时识别为市场前缀并统一小写，其余字符原样保留
+   （`SH600000.day` → `sh600000`）
+2. 主干无前缀时补上一级市场目录名（`ds/lday/47#IF00.day` → `ds47#IF00`，`IF00` 保持大写，
+   `#` 前的交易所编号保留）
+3. 归一后代码重复（如 `sh600000` 与 `SH600000`）在扫描阶段直接抛 `ValueError`，异常文本列出
+   全部冲突路径；跨市场同代码（`sh600000` 与 `sz600000`）不算冲突
+
+异常：目录不存在 → `FileNotFoundError`；路径不是目录、文件长度不是 32 的整数倍 →
+`ValueError`，异常文本均带完整路径。长度校验默认用目录枚举得到的字节数；若实际读取到的
+大小与之不符，以实读结果为准（详见下文“为什么用目录枚举的大小”）。
+
+### read_gbbq
+
+gbbq 文件：4 字节头记录数 + 每条 29 字节（前 24 字节为 16 轮 sbox 加密，后 5 字节明文）。
+
+| 列 | dtype | 说明 |
+| --- | --- | --- |
+| market | uint8 | 市场编号 |
+| code | category | 证券代码（文件内容，去掉尾部 NUL） |
+| date | uint32 | `YYYYMMDD` 整数 |
+| category | uint8 | 记录类别 |
+| f1..f4 | float64 | 四个浮点字段 |
+
+头部记录数必须与文件长度严格一致，否则 `ValueError`（带路径、记录数与字节数）；
+0 条记录返回 0 行同 schema DataFrame。
+
+## 性能
+
+- 扫描用 `os.scandir` 递归，文件大小直接取 `DirEntry.stat().st_size`，随扫描结果一起传给 C 层
+- 读取按文件多线程切分，默认 `min(4, CPU)`；`TDX2CKZ_THREADS=1` 回单线程
+- 线程只写各自分片的预分配列缓冲，因此结果与调度顺序无关
+
+### 为什么用目录枚举的大小
+
+逐文件调用 `GetFileAttributesExW` 在本机会卷上有明显开销：约 **0.40 ms/次**，`sh` 的
+6,053 个文件合计约 **2.35 s**，占修复前 sh 耗时（3.004 s）的绝大部分。而 `os.scandir`
+返回的 `DirEntry.stat().st_size` 直接复用 `FindFirstFileW` 已给出的结果，同样 6,053 个
+文件只需 **0.029 s**，几乎免费。所以扫描阶段一次枚举就把大小带到 C 层，线程启动前不再
+逐文件 stat。
+
+代价是“扫描后、读取前文件被改动”不再是隐含假设，C 层对此有显式保护：
+
+- 每轮开始前按当前行数重算偏移并重新分配列缓冲
+- 某文件实际行数与枚举行数不符时 **不写任何字节**，改用实读大小重排该文件行数，最多重试
+  **4 轮**
+- 实际长度不是 32 的整数倍 → `ValueError`（异常文本带实际字节数）
+- 枚举大小不是 32 的整数倍 → `ValueError`（带枚举字节数）；0 字节文件贡献 0 行
+- 4 轮后仍不一致 → `ValueError("文件大小在扫描与读取之间持续变化: ...")`
+
+### 分市场（修复后，各 5 次取中位）
+
+`C:\new_tdx_mock\vipdoc`，单进程、默认 4 线程：
+
+| 市场 | 文件数 | 行数 | 中位耗时 | 峰值内存 |
+| --- | --- | --- | --- | --- |
+| sh | 6,053 | 15,328,535 | **0.746 s** | 938 MB |
+| sz | 5,928 | 14,207,349 | **0.730 s** | 877 MB |
+| bj | 373 | 283,177 | **0.038 s** | 94 MB |
+| ds | 3 | 3,943 | **0.006 s** | 78 MB |
+
+修复前 sh 为 3.004 s；瓶颈是主线程串行的 6,053 次 `GetFileAttributesExW`。
+
+### C 核心层与分段耗时（sh）
+
+| 项目 | 单线程 | 4 线程 |
+| --- | --- | --- |
+| C 核心（打开 + 读 + 解码 + 写列缓冲） | 1.868 s | 0.606 s（**3.08×**） |
+
+端到端 sh 单线程（`TDX2CKZ_THREADS=1`）**2.050 s**，默认 4 线程 0.746 s（2.75×）。
+
+sh 分段（4 线程）：scan **0.039 s**、core **0.606 s**、DataFrame 组装约 **0.20 s**
+（其中 `np.repeat` 0.062 s、`Categorical` 0.022 s、`DataFrame` 构造 0.111 s）。
+
+### 整体（`vipdoc` 全量）
+
+| 指标 | 数值 |
+| --- | --- |
+| 文件数 | 12,357（sh 6053 / sz 5928 / bj 373 / ds 3） |
+| 总行数 | 29,823,004 |
+| 出现代码 | 12,355（另有 2 个 0 字节 `.day` 无数据行） |
+| 日期范围 | 1990-12-19 → 2026-11-06 |
+| 热读耗时（4 次） | 1.540 / 1.462 / 1.794 / 1.561 s，中位 **1.561 s** |
+| 峰值内存 | **1.75 GB**（DataFrame 本身 1.50 GB，列缓冲零拷贝） |
+
+gbbq：194,352 条，热读中位 **0.087 s**。
+
+复现：
+
+```powershell
+python bench/bench.py
+```
+
+## 测试
+
+```powershell
+# 合成样本（schema/值/递归/归一/冲突/空目录/异常/gbbq 解密）
+python -m pytest tests -q
+
+# 追加真实数据逐值交叉验证（独立 Python 解析，逐值零差异）
+TDX2CKZ_REAL=1 python -m pytest tests -q -k real
+
+# PowerShell 下等价写法
+$env:TDX2CKZ_REAL="1"; python -m pytest tests -q -k real
+```
+
+交叉验证用 numpy 结构化 dtype + pandas 日期解析 + 独立实现的 16 轮 sbox 解密，
+与 C 层逐文件、逐列比对（`assert_array_equal`，不做近似）。
+
+## 目录
+
+```
+tdx2ckz.c                 # 唯一 C 源，导出 read_lday / read_gbbq
+tdx2ckz/__init__.py       # 两个入口，C 层缓冲 -> DataFrame
+tdx2ckz/__init__.pyi      # 类型与中文注释
+tdx2ckz/py.typed
+setup.py                  # Extension 声明 + wheel 标签（options.bdist_wheel.py_limited_api）
+pyproject.toml            # build-system + project 元数据
+tests/test_readers.py
+bench/bench.py
+```

tdx2ckz-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tdx2ckz"
+version = "0.1.0"
+description = "通达信 .day 日线与 gbbq 股本变迁读取器（Windows x64）"
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [{ name = "qiuxiaoying" }]
+keywords = ["通达信", "tdx", "day", "gbbq", "stock-data", "market-data"]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+]
+dependencies = [
+    "numpy>=1.20",
+    "pandas>=1.3",
+]
+# setuptools 65.5 < 77，不支持 PEP 639，使用经典 license 表写法
+license = { text = "MIT" }
+
+[project.urls]
+Homepage = "https://github.com/qiuxiaoying/tdx2ckz"
+Repository = "https://github.com/qiuxiaoying/tdx2ckz"
+
+[tool.setuptools]
+packages = ["tdx2ckz"]
+
+[tool.setuptools.package-data]
+tdx2ckz = ["py.typed", "__init__.pyi"]

tdx2ckz-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tdx2ckz-0.1.0/setup.py

@@ -0,0 +1,19 @@
+import sys
+
+from setuptools import Extension, setup
+
+if sys.platform != "win32":
+    raise RuntimeError("tdx2ckz 仅支持 Windows x64（当前平台: %s）" % sys.platform)
+
+setup(
+    ext_modules=[
+        Extension(
+            "tdx2ckz._core",
+            sources=["tdx2ckz.c"],
+            define_macros=[("Py_LIMITED_API", "0x03080000")],
+            py_limited_api=True,
+            extra_compile_args=["/W3", "/O2", "/utf-8"],
+        )
+    ],
+    options={"bdist_wheel": {"py_limited_api": "cp38"}},
+)