tdxdraw 0.1.0__tar.gz

tdxdraw-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mengyiheng
+
+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.

tdxdraw-0.1.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: tdxdraw
+Version: 0.1.0
+Summary: 通达信画线文件（.eld）读写与批量生成工具，零依赖
+Author: mengyiheng
+License: MIT
+Keywords: tdx,tongdaxin,drawline,eld,quant
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+<p align="center"><img src="assets/cover.png" alt="tdxdraw" width="720"/></p>
+
+# tdxdraw — 通达信画线批量生成与转换工具
+
+把**任意来源的画线坐标清单**（CSV / JSON / 你的分析程序输出）批量转成通达信官方
+「画线导入」功能可直接识别的 `.eld` 文件；也可把通达信导出的画线文件反向解析成
+CSV / JSON，做二次处理。
+
+- 📤 **生成**：程序化批量画线 → `.eld` → 通达信一键导入
+- 📥 **解析**：通达信导出的 `.eld` → CSV / JSON，供回测、复盘、二次分析
+- 🪶 **零第三方依赖**，Python 3.9+
+- ✅ **逐字节校验**：编码结果与通达信实测可导入的样本文件逐字节一致
+- 🧭 **格式完全开源**：378 字节记录结构文档化于 [docs/FORMAT.md](docs/FORMAT.md)
+
+## 安装
+
+```bash
+pip install tdxdraw
+```
+
+## 快速开始
+
+### 1. 写一个画线清单（CSV）
+
+```csv
+market,code,line_type,start_price,end_price,start_date,end_date,period,line_id
+sh,600519,hline,1250.00,1250.00,2026-01-05,2026-10-19,day,1
+sh,600519,segment,1181.64,1367.85,2026-06-12,2026-09-30,day,2
+sz,002805,rectangle,1391.60,1321.62,2026-08-27,2026-09-15,day,1
+```
+
+### 2. 转成 .eld 并导入通达信
+
+```bash
+tdxdraw build drawings.csv mylines.eld
+```
+
+通达信 K 线界面 → 画线工具 → **画线管理（或导入画线）** → 选择 `mylines.eld`，
+所有画线立即出现在对应个股的 K 线图上。
+
+### 3. 也可以只用 Python API
+
+```python
+from datetime import date
+from tdxdraw import Drawing, write_eld, read_eld
+
+d = Drawing("sh", "600519", "hline", 1250.0, 1250.0,
+            date(2026, 1, 5), date(2026, 10, 19), line_id=1)
+write_eld("mylines.eld", [d])
+
+bars = read_eld("通达信导出.eld")   # 反向解析
+```
+
+### 4. 反向导出为 CSV
+
+```bash
+tdxdraw export 通达信导出.eld lines.csv
+```
+
+## 支持的画线类型
+
+`segment`(线段) `hline`(水平直线) `ray`(直线) `arrow`(箭头) `rectangle`(矩形)
+`text`(文字注释) `circle`(圆) `parallel`(平行直线) `channel`(价格通道线)
+`gann_fan`(江恩角度线) `gann_percent`(百分比线) `wave`(波段线) 等 40 种，
+完整映射见 [docs/FORMAT.md](docs/FORMAT.md)。
+
+支持的周期：`1m 5m 15m 30m 60m day week month quarter year`。
+
+## .eld 文件格式
+
+每条画线 = 378 字节定长记录（小端），核心字段：
+
+| 偏移 | 含义 |
+|---|---|
+| 0x00 | 市场（0=深 1=沪 2=京） |
+| 0x01 | 6 位证券代码 |
+| 0x18 | 指标页（如 `\x02STANDK`） |
+| 0x56 / 0x5A | 起点 / 终点价格（float32） |
+| 0x63 | 周期编码 |
+| 0x65 | 画线类型 |
+| 0x69 / 0x75 | 起点 / 终点日期（年 zone + 月日 9 位紧凑编码） |
+| 0x6B / 0x77 | 起点 / 终点分钟数 |
+| 0x71 | 个股内画线序号 |
+| 0xD1 / 0xD5 / 0xD9 | 线宽 / 线型 / BGRA 颜色 |
+
+完整字段表见 [docs/FORMAT.md](docs/FORMAT.md)。
+
+## 运行测试
+
+```bash
+pip install -e . pytest
+pytest
+```
+
+测试基准包含一个**经通达信实测可导入**的真实样本文件（逐字节比对）。
+
+## 免责声明
+
+本项目仅做画线坐标数据与通达信画线文件格式之间的转换，不提供任何行情数据，
+不构成任何投资建议。使用前请[阅读完整免责声明](DISCLAIMER.md)。
+
+## 量化相关定制需求
+
+承接画线自动化、分析系统 → 通达信画线管道、数据格式转换等定制开发，
+联系方式见 [README 联系方式](#量化相关定制需求) 或 [Gitee Issues](https://gitee.com/mengyiheng/tdxdraw/issues)。
+
+## License
+
+MIT
+
+## 量化相关定制需求
+
+作者承接画线自动化与通达信二次开发的定制开发：
+
+| 方向 | 示例 |
+|---|---|
+| 🖍 画线工程化 | 分析系统信号 → 通达信画线管道、多周期批量落图、画线模板管理 |
+| 📐 格式深水区 | 更多画线类型/样式区字段逆向、tdxline.dat 在线注入 |
+| 🛠 私有部署 | 全市场批量导入、CI 自动生成画线、团队共享线组 |
+
+**联系合作**：[Gitee Issues](https://gitee.com/mengyiheng/tdxdraw/issues) 或 [Gitee 私信](https://gitee.com/mengyiheng)。复杂需求请附：画线数据量级、时效要求、期望交付形式。

tdxdraw-0.1.0/README.md

@@ -0,0 +1,121 @@
+<p align="center"><img src="assets/cover.png" alt="tdxdraw" width="720"/></p>
+
+# tdxdraw — 通达信画线批量生成与转换工具
+
+把**任意来源的画线坐标清单**（CSV / JSON / 你的分析程序输出）批量转成通达信官方
+「画线导入」功能可直接识别的 `.eld` 文件；也可把通达信导出的画线文件反向解析成
+CSV / JSON，做二次处理。
+
+- 📤 **生成**：程序化批量画线 → `.eld` → 通达信一键导入
+- 📥 **解析**：通达信导出的 `.eld` → CSV / JSON，供回测、复盘、二次分析
+- 🪶 **零第三方依赖**，Python 3.9+
+- ✅ **逐字节校验**：编码结果与通达信实测可导入的样本文件逐字节一致
+- 🧭 **格式完全开源**：378 字节记录结构文档化于 [docs/FORMAT.md](docs/FORMAT.md)
+
+## 安装
+
+```bash
+pip install tdxdraw
+```
+
+## 快速开始
+
+### 1. 写一个画线清单（CSV）
+
+```csv
+market,code,line_type,start_price,end_price,start_date,end_date,period,line_id
+sh,600519,hline,1250.00,1250.00,2026-01-05,2026-10-19,day,1
+sh,600519,segment,1181.64,1367.85,2026-06-12,2026-09-30,day,2
+sz,002805,rectangle,1391.60,1321.62,2026-08-27,2026-09-15,day,1
+```
+
+### 2. 转成 .eld 并导入通达信
+
+```bash
+tdxdraw build drawings.csv mylines.eld
+```
+
+通达信 K 线界面 → 画线工具 → **画线管理（或导入画线）** → 选择 `mylines.eld`，
+所有画线立即出现在对应个股的 K 线图上。
+
+### 3. 也可以只用 Python API
+
+```python
+from datetime import date
+from tdxdraw import Drawing, write_eld, read_eld
+
+d = Drawing("sh", "600519", "hline", 1250.0, 1250.0,
+            date(2026, 1, 5), date(2026, 10, 19), line_id=1)
+write_eld("mylines.eld", [d])
+
+bars = read_eld("通达信导出.eld")   # 反向解析
+```
+
+### 4. 反向导出为 CSV
+
+```bash
+tdxdraw export 通达信导出.eld lines.csv
+```
+
+## 支持的画线类型
+
+`segment`(线段) `hline`(水平直线) `ray`(直线) `arrow`(箭头) `rectangle`(矩形)
+`text`(文字注释) `circle`(圆) `parallel`(平行直线) `channel`(价格通道线)
+`gann_fan`(江恩角度线) `gann_percent`(百分比线) `wave`(波段线) 等 40 种，
+完整映射见 [docs/FORMAT.md](docs/FORMAT.md)。
+
+支持的周期：`1m 5m 15m 30m 60m day week month quarter year`。
+
+## .eld 文件格式
+
+每条画线 = 378 字节定长记录（小端），核心字段：
+
+| 偏移 | 含义 |
+|---|---|
+| 0x00 | 市场（0=深 1=沪 2=京） |
+| 0x01 | 6 位证券代码 |
+| 0x18 | 指标页（如 `\x02STANDK`） |
+| 0x56 / 0x5A | 起点 / 终点价格（float32） |
+| 0x63 | 周期编码 |
+| 0x65 | 画线类型 |
+| 0x69 / 0x75 | 起点 / 终点日期（年 zone + 月日 9 位紧凑编码） |
+| 0x6B / 0x77 | 起点 / 终点分钟数 |
+| 0x71 | 个股内画线序号 |
+| 0xD1 / 0xD5 / 0xD9 | 线宽 / 线型 / BGRA 颜色 |
+
+完整字段表见 [docs/FORMAT.md](docs/FORMAT.md)。
+
+## 运行测试
+
+```bash
+pip install -e . pytest
+pytest
+```
+
+测试基准包含一个**经通达信实测可导入**的真实样本文件（逐字节比对）。
+
+## 免责声明
+
+本项目仅做画线坐标数据与通达信画线文件格式之间的转换，不提供任何行情数据，
+不构成任何投资建议。使用前请[阅读完整免责声明](DISCLAIMER.md)。
+
+## 量化相关定制需求
+
+承接画线自动化、分析系统 → 通达信画线管道、数据格式转换等定制开发，
+联系方式见 [README 联系方式](#量化相关定制需求) 或 [Gitee Issues](https://gitee.com/mengyiheng/tdxdraw/issues)。
+
+## License
+
+MIT
+
+## 量化相关定制需求
+
+作者承接画线自动化与通达信二次开发的定制开发：
+
+| 方向 | 示例 |
+|---|---|
+| 🖍 画线工程化 | 分析系统信号 → 通达信画线管道、多周期批量落图、画线模板管理 |
+| 📐 格式深水区 | 更多画线类型/样式区字段逆向、tdxline.dat 在线注入 |
+| 🛠 私有部署 | 全市场批量导入、CI 自动生成画线、团队共享线组 |
+
+**联系合作**：[Gitee Issues](https://gitee.com/mengyiheng/tdxdraw/issues) 或 [Gitee 私信](https://gitee.com/mengyiheng)。复杂需求请附：画线数据量级、时效要求、期望交付形式。

tdxdraw-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tdxdraw"
+version = "0.1.0"
+description = "通达信画线文件（.eld）读写与批量生成工具，零依赖"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "mengyiheng" }]
+keywords = ["tdx", "tongdaxin", "drawline", "eld", "quant"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Office/Business :: Financial :: Investment",
+]
+
+[project.scripts]
+tdxdraw = "tdxdraw.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

tdxdraw-0.1.0/setup.cfg

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

tdxdraw-0.1.0/src/tdxdraw/__init__.py

@@ -0,0 +1,25 @@
+"""tdxdraw — 通达信画线文件（.eld）读写与批量转换。
+
+典型流程：把任意来源的坐标清单（CSV / JSON / 你的分析程序输出）
+转成通达信官方"画线导入"功能可识别的 .eld 文件。
+
+    from tdxdraw import Drawing, write_eld
+
+    d = Drawing("sh", "600519", "hline", 1250.0, 1250.0,
+                date(2026, 1, 5), date(2026, 10, 19), line_id=1)
+    write_eld("out.eld", [d])   # 通达信 K 线界面 -> 画线工具 -> 导入画线
+"""
+
+from .batch import csv_to_eld, eld_to_csv, read_csv, read_json, write_csv, write_json
+from .eld import (LINE_TYPES, PERIODS, RECORD_SIZE, Drawing,
+                  decode, encode, read_eld, write_eld)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "Drawing", "encode", "decode", "read_eld", "write_eld",
+    "read_csv", "write_csv", "read_json", "write_json",
+    "csv_to_eld", "eld_to_csv",
+    "LINE_TYPES", "PERIODS", "RECORD_SIZE",
+    "__version__",
+]

tdxdraw-0.1.0/src/tdxdraw/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())

tdxdraw-0.1.0/src/tdxdraw/batch.py

@@ -0,0 +1,65 @@
+"""CSV / JSON 画线清单与 .eld 文件互转。"""
+
+from __future__ import annotations
+
+import csv
+import json
+from datetime import date, datetime
+from pathlib import Path
+from typing import List
+
+from .eld import Drawing, read_eld
+
+FIELDS = ["market", "code", "line_type", "start_price", "end_price",
+          "start_date", "end_date", "start_time", "end_time",
+          "period", "line_id", "line_width", "color_bgr"]
+
+
+def _parse_row(row: dict) -> Drawing:
+    d = dict(row)
+    for k in ("start_date", "end_date"):
+        d[k] = datetime.strptime(str(d[k]), "%Y-%m-%d").date()
+    for k in ("start_time", "end_time", "line_id", "line_width", "color_bgr"):
+        if k in d:
+            d[k] = int(d[k])
+    for k in ("start_price", "end_price"):
+        d[k] = float(d[k])
+    return Drawing(**{k: v for k, v in d.items() if k in FIELDS})
+
+
+def read_csv(path: str | Path) -> List[Drawing]:
+    with open(path, newline="", encoding="utf-8-sig") as f:
+        return [_parse_row(r) for r in csv.DictReader(f)]
+
+
+def write_csv(path: str | Path, drawings: List[Drawing]) -> None:
+    with open(path, "w", newline="", encoding="utf-8-sig") as f:
+        w = csv.DictWriter(f, fieldnames=FIELDS)
+        w.writeheader()
+        for d in drawings:
+            w.writerow({k: getattr(d, k) for k in FIELDS})
+
+
+def read_json(path: str | Path) -> List[Drawing]:
+    items = json.loads(Path(path).read_text(encoding="utf-8"))
+    if isinstance(items, dict):
+        items = items.get("drawings", [])
+    return [_parse_row({k: str(v) for k, v in it.items()}) for it in items]
+
+
+def write_json(path: str | Path, drawings: List[Drawing]) -> None:
+    items = [{k: getattr(d, k) for k in FIELDS} for d in drawings]
+    Path(path).write_text(json.dumps({"drawings": items}, ensure_ascii=False, indent=2),
+                          encoding="utf-8")
+
+
+def eld_to_csv(eld_path: str | Path, csv_path: str | Path) -> int:
+    ds = read_eld(eld_path)
+    write_csv(csv_path, ds)
+    return len(ds)
+
+
+def csv_to_eld(csv_path: str | Path, eld_path: str | Path) -> int:
+    ds = read_csv(csv_path)
+    from .eld import write_eld
+    return write_eld(eld_path, ds)

tdxdraw-0.1.0/src/tdxdraw/cli.py

@@ -0,0 +1,38 @@
+"""tdxdraw 命令行。
+
+用法:
+  tdxdraw build  in.csv  out.eld      # CSV/JSON 画线清单 -> 通达信 .eld
+  tdxdump 等价: tdxdraw export in.eld out.csv   # .eld -> CSV
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+from .batch import csv_to_eld, eld_to_csv, read_json
+
+
+def main(argv: list[str] | None = None) -> int:
+    a = list(sys.argv[1:] if argv is None else argv)
+    if len(a) != 3 or a[0] not in ("build", "export"):
+        print(__doc__)
+        return 1
+    cmd, src, dst = a
+    if cmd == "build":
+        n = csv_to_eld(src, dst) if src.lower().endswith(".csv") else _json_to_eld(src, dst)
+        print(f"[tdxdraw] {n} 条画线 -> {dst}（通达信: 画线工具 -> 导入画线）")
+    else:
+        n = eld_to_csv(src, dst)
+        print(f"[tdxdraw] {n} 条画线 -> {dst}")
+    return 0
+
+
+def _json_to_eld(src: str, dst: str) -> int:
+    from .eld import write_eld
+    ds = read_json(src)
+    return write_eld(dst, ds)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

tdxdraw-0.1.0/src/tdxdraw/eld.py

@@ -0,0 +1,176 @@
+"""tdxdraw.eld — 通达信画线文件（.eld）记录编解码。
+
+每条画线为固定 378 字节记录，格式经通达信官方"画线导入"功能实测验证。
+"""
+
+from __future__ import annotations
+
+import struct
+from dataclasses import dataclass, field
+from datetime import date, datetime
+from pathlib import Path
+from typing import Iterable, List
+
+RECORD_SIZE = 0x17A  # 378
+
+MARKETS = {"sz": 0, "sh": 1, "bj": 2}
+
+PERIODS = {
+    "1m": 0x07, "5m": 0x00, "15m": 0x01, "30m": 0x02, "60m": 0x03,
+    "day": 0x04, "week": 0x05, "month": 0x06, "quarter": 0x0A, "year": 0x0B,
+}
+PERIOD_DECODE = {v: k for k, v in PERIODS.items()}
+
+LINE_TYPES = {
+    "segment": 0x0A, "ray": 0x0B, "arrow": 0x21, "ray2": 0x22,
+    "hline": 0x26, "hray": 0x2D, "hsegment": 0x2E,
+    "vline": 0x27, "price_tag": 0x2A, "channel": 0x1C,
+    "parallel": 0x1D, "gann_percent": 0x0D, "wave": 0x0E,
+    "gann_price": 0x1F, "regression": 0x11,
+    "circle": 0x23, "rectangle": 0x17, "text": 0x16,
+    "gann_fan": 0x0C,
+}
+LINE_TYPE_DECODE = {v: k for k, v in LINE_TYPES.items()}
+
+# 偏移量表（实测验证）
+OFF = {
+    "market": 0x00, "code": 0x01, "indicator": 0x18,
+    "start_price": 0x56, "end_price": 0x5A, "period": 0x63,
+    "line_type": 0x65, "fixed12": 0x66, "start_date": 0x69,
+    "start_time": 0x6B, "start_price2": 0x6D, "line_id": 0x71,
+    "end_date": 0x75, "end_time": 0x77, "end_price2": 0x79,
+    "line_start": 0xCD, "line_width": 0xD1, "line_style": 0xD5,
+    "color": 0xD9, "draw_date": 0xE5,
+}
+
+# 年份 zone 编码表（zone: 0=1-4月, 1=5-10月, 2=11-12月）
+_YEAR_ZONE_YO = {
+    (2024, 0): 83, (2024, 1): 81, (2024, 2): 82,
+    (2025, 0): 84, (2025, 1): 85, (2025, 2): 86,
+    (2026, 0): 88, (2026, 1): 89,
+}
+_YO_YEAR_ZONE = {v: k for k, v in _YEAR_ZONE_YO.items()}
+
+
+def _encode_eld_date(d: date) -> int:
+    md = d.month * 100 + d.day
+    zone = 0 if md <= 511 else (1 if md <= 1023 else 2)
+    yo = _YEAR_ZONE_YO.get((d.year, zone))
+    if yo is None:
+        yo = 80 + (d.year - 2024) * 4 + zone   # 扩展规则（2027+）
+    return (yo << 9) | (md - zone * 512)
+
+
+def _decode_eld_date(v: int) -> date:
+    yo, stored_md = v >> 9, v & 0x1FF
+    year, zone = _YO_YEAR_ZONE.get(yo, (1941 + yo, 0))
+    md = stored_md + zone * 512
+    return date(year, md // 100, md % 100)
+
+
+@dataclass
+class Drawing:
+    """一条画线。time 字段为当天分钟数（0-1439），日线一般填 900（=15:00）。"""
+
+    market: str          # "sh" / "sz" / "bj"
+    code: str            # 6 位代码
+    line_type: str       # LINE_TYPES 的键
+    start_price: float
+    end_price: float
+    start_date: date
+    end_date: date
+    start_time: int = 900
+    end_time: int = 900
+    period: str = "day"
+    line_id: int = 1     # 个股内唯一序号（从 1 开始）
+    line_width: int = 1
+    color_bgr: int = 0x00FFFFFF          # BGRA
+    indicator: bytes = b"\x02STANDK"     # 画线所属指标页
+
+    def __post_init__(self) -> None:
+        self.validate()
+
+    def validate(self) -> None:
+        if self.market not in MARKETS:
+            raise ValueError(f"市场必须是 {list(MARKETS)}: {self.market}")
+        if not (self.code.isdigit() and len(self.code) == 6):
+            raise ValueError(f"代码必须是 6 位数字: {self.code}")
+        if self.line_type not in LINE_TYPES:
+            raise ValueError(f"未知画线类型: {self.line_type}")
+        if self.period not in PERIODS:
+            raise ValueError(f"未知周期: {self.period}")
+
+
+def encode(d: Drawing) -> bytes:
+    """Drawing -> 378 字节记录（通达信画线导入功能可直接识别）。"""
+    d.validate()
+    r = bytearray(RECORD_SIZE)
+    r[OFF["market"]] = MARKETS[d.market]
+    r[OFF["code"]:OFF["code"] + 6] = d.code.encode("ascii").ljust(6, b"\x00")
+    r[OFF["indicator"]:OFF["indicator"] + 7] = d.indicator[:7].ljust(7, b"\x00")
+
+    struct.pack_into("<f", r, OFF["start_price"], d.start_price)
+    struct.pack_into("<f", r, OFF["end_price"], d.end_price)
+    r[OFF["period"]] = PERIODS[d.period]
+    r[OFF["line_type"]] = LINE_TYPES[d.line_type]
+    r[OFF["fixed12"]] = 0x10
+
+    struct.pack_into("<H", r, OFF["start_date"], _encode_eld_date(d.start_date))
+    struct.pack_into("<H", r, OFF["start_time"], d.start_time)
+    struct.pack_into("<f", r, OFF["start_price2"], d.start_price)
+
+    lid = max(0, d.line_id - 1)
+    r[OFF["line_id"]:OFF["line_id"] + 3] = lid.to_bytes(3, "little")
+
+    struct.pack_into("<H", r, OFF["end_date"], _encode_eld_date(d.end_date))
+    struct.pack_into("<H", r, OFF["end_time"], d.end_time)
+    struct.pack_into("<f", r, OFF["end_price2"], d.end_price)
+
+    r[OFF["line_start"]] = 0x01
+    r[OFF["line_width"]] = d.line_width
+    r[OFF["line_style"]] = LINE_TYPES[d.line_type]
+    struct.pack_into("<I", r, OFF["color"], d.color_bgr)
+
+    now = datetime.now()
+    r[OFF["draw_date"]] = (now.day + 204) & 0xFF
+    r[OFF["draw_date"] + 1] = (now.month + 34) & 0xFF
+    r[OFF["draw_date"] + 2] = (now.year - 1973) & 0xFF
+    r[OFF["draw_date"] + 3] = 0x01
+    r[OFF["draw_date"] + 4] = 0x01
+    return bytes(r)
+
+
+def decode(rec: bytes) -> Drawing:
+    """378 字节记录 -> Drawing。"""
+    if len(rec) != RECORD_SIZE:
+        raise ValueError(f"记录长度必须为 {RECORD_SIZE} 字节: {len(rec)}")
+    return Drawing(
+        market={0: "sz", 1: "sh", 2: "bj"}.get(rec[OFF["market"]], "sh"),
+        code=rec[OFF["code"]:OFF["code"] + 6].rstrip(b"\x00").decode("ascii", "replace"),
+        line_type=LINE_TYPE_DECODE.get(rec[OFF["line_type"]], f"unknown_{rec[OFF['line_type']]:#04x}"),
+        start_price=struct.unpack_from("<f", rec, OFF["start_price"])[0],
+        end_price=struct.unpack_from("<f", rec, OFF["end_price"])[0],
+        start_date=_decode_eld_date(struct.unpack_from("<H", rec, OFF["start_date"])[0]),
+        end_date=_decode_eld_date(struct.unpack_from("<H", rec, OFF["end_date"])[0]),
+        start_time=struct.unpack_from("<H", rec, OFF["start_time"])[0],
+        end_time=struct.unpack_from("<H", rec, OFF["end_time"])[0],
+        period=PERIOD_DECODE.get(rec[OFF["period"]], f"p{rec[OFF['period']]:#04x}"),
+        line_id=int.from_bytes(rec[OFF["line_id"]:OFF["line_id"] + 3], "little") + 1,
+        line_width=rec[OFF["line_width"]],
+        color_bgr=struct.unpack_from("<I", rec, OFF["color"])[0],
+        indicator=rec[OFF["indicator"]:OFF["indicator"] + 7],
+    )
+
+
+def read_eld(path: str | Path) -> List[Drawing]:
+    """读取 .eld 画线文件为 Drawing 列表。"""
+    data = Path(path).read_bytes()
+    n = len(data) // RECORD_SIZE
+    return [decode(data[i * RECORD_SIZE:(i + 1) * RECORD_SIZE]) for i in range(n)]
+
+
+def write_eld(path: str | Path, drawings: Iterable[Drawing]) -> int:
+    """Drawing 列表 -> .eld 文件（通达信画线导入功能可直接加载）。"""
+    payload = b"".join(encode(d) for d in drawings)
+    Path(path).write_bytes(payload)
+    return len(payload) // RECORD_SIZE

tdxdraw-0.1.0/src/tdxdraw.egg-info/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: tdxdraw
+Version: 0.1.0
+Summary: 通达信画线文件（.eld）读写与批量生成工具，零依赖
+Author: mengyiheng
+License: MIT
+Keywords: tdx,tongdaxin,drawline,eld,quant
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+<p align="center"><img src="assets/cover.png" alt="tdxdraw" width="720"/></p>
+
+# tdxdraw — 通达信画线批量生成与转换工具
+
+把**任意来源的画线坐标清单**（CSV / JSON / 你的分析程序输出）批量转成通达信官方
+「画线导入」功能可直接识别的 `.eld` 文件；也可把通达信导出的画线文件反向解析成
+CSV / JSON，做二次处理。
+
+- 📤 **生成**：程序化批量画线 → `.eld` → 通达信一键导入
+- 📥 **解析**：通达信导出的 `.eld` → CSV / JSON，供回测、复盘、二次分析
+- 🪶 **零第三方依赖**，Python 3.9+
+- ✅ **逐字节校验**：编码结果与通达信实测可导入的样本文件逐字节一致
+- 🧭 **格式完全开源**：378 字节记录结构文档化于 [docs/FORMAT.md](docs/FORMAT.md)
+
+## 安装
+
+```bash
+pip install tdxdraw
+```
+
+## 快速开始
+
+### 1. 写一个画线清单（CSV）
+
+```csv
+market,code,line_type,start_price,end_price,start_date,end_date,period,line_id
+sh,600519,hline,1250.00,1250.00,2026-01-05,2026-10-19,day,1
+sh,600519,segment,1181.64,1367.85,2026-06-12,2026-09-30,day,2
+sz,002805,rectangle,1391.60,1321.62,2026-08-27,2026-09-15,day,1
+```
+
+### 2. 转成 .eld 并导入通达信
+
+```bash
+tdxdraw build drawings.csv mylines.eld
+```
+
+通达信 K 线界面 → 画线工具 → **画线管理（或导入画线）** → 选择 `mylines.eld`，
+所有画线立即出现在对应个股的 K 线图上。
+
+### 3. 也可以只用 Python API
+
+```python
+from datetime import date
+from tdxdraw import Drawing, write_eld, read_eld
+
+d = Drawing("sh", "600519", "hline", 1250.0, 1250.0,
+            date(2026, 1, 5), date(2026, 10, 19), line_id=1)
+write_eld("mylines.eld", [d])
+
+bars = read_eld("通达信导出.eld")   # 反向解析
+```
+
+### 4. 反向导出为 CSV
+
+```bash
+tdxdraw export 通达信导出.eld lines.csv
+```
+
+## 支持的画线类型
+
+`segment`(线段) `hline`(水平直线) `ray`(直线) `arrow`(箭头) `rectangle`(矩形)
+`text`(文字注释) `circle`(圆) `parallel`(平行直线) `channel`(价格通道线)
+`gann_fan`(江恩角度线) `gann_percent`(百分比线) `wave`(波段线) 等 40 种，
+完整映射见 [docs/FORMAT.md](docs/FORMAT.md)。
+
+支持的周期：`1m 5m 15m 30m 60m day week month quarter year`。
+
+## .eld 文件格式
+
+每条画线 = 378 字节定长记录（小端），核心字段：
+
+| 偏移 | 含义 |
+|---|---|
+| 0x00 | 市场（0=深 1=沪 2=京） |
+| 0x01 | 6 位证券代码 |
+| 0x18 | 指标页（如 `\x02STANDK`） |
+| 0x56 / 0x5A | 起点 / 终点价格（float32） |
+| 0x63 | 周期编码 |
+| 0x65 | 画线类型 |
+| 0x69 / 0x75 | 起点 / 终点日期（年 zone + 月日 9 位紧凑编码） |
+| 0x6B / 0x77 | 起点 / 终点分钟数 |
+| 0x71 | 个股内画线序号 |
+| 0xD1 / 0xD5 / 0xD9 | 线宽 / 线型 / BGRA 颜色 |
+
+完整字段表见 [docs/FORMAT.md](docs/FORMAT.md)。
+
+## 运行测试
+
+```bash
+pip install -e . pytest
+pytest
+```
+
+测试基准包含一个**经通达信实测可导入**的真实样本文件（逐字节比对）。
+
+## 免责声明
+
+本项目仅做画线坐标数据与通达信画线文件格式之间的转换，不提供任何行情数据，
+不构成任何投资建议。使用前请[阅读完整免责声明](DISCLAIMER.md)。
+
+## 量化相关定制需求
+
+承接画线自动化、分析系统 → 通达信画线管道、数据格式转换等定制开发，
+联系方式见 [README 联系方式](#量化相关定制需求) 或 [Gitee Issues](https://gitee.com/mengyiheng/tdxdraw/issues)。
+
+## License
+
+MIT
+
+## 量化相关定制需求
+
+作者承接画线自动化与通达信二次开发的定制开发：
+
+| 方向 | 示例 |
+|---|---|
+| 🖍 画线工程化 | 分析系统信号 → 通达信画线管道、多周期批量落图、画线模板管理 |
+| 📐 格式深水区 | 更多画线类型/样式区字段逆向、tdxline.dat 在线注入 |
+| 🛠 私有部署 | 全市场批量导入、CI 自动生成画线、团队共享线组 |
+
+**联系合作**：[Gitee Issues](https://gitee.com/mengyiheng/tdxdraw/issues) 或 [Gitee 私信](https://gitee.com/mengyiheng)。复杂需求请附：画线数据量级、时效要求、期望交付形式。

tdxdraw-0.1.0/src/tdxdraw.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/tdxdraw/__init__.py
+src/tdxdraw/__main__.py
+src/tdxdraw/batch.py
+src/tdxdraw/cli.py
+src/tdxdraw/eld.py
+src/tdxdraw.egg-info/PKG-INFO
+src/tdxdraw.egg-info/SOURCES.txt
+src/tdxdraw.egg-info/dependency_links.txt
+src/tdxdraw.egg-info/entry_points.txt
+src/tdxdraw.egg-info/top_level.txt
+tests/test_eld.py

tdxdraw-0.1.0/src/tdxdraw.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tdxdraw-0.1.0/src/tdxdraw.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tdxdraw = tdxdraw.cli:main

tdxdraw-0.1.0/src/tdxdraw.egg-info/top_level.txt

@@ -0,0 +1 @@
+tdxdraw

tdxdraw-0.1.0/tests/test_eld.py

@@ -0,0 +1,69 @@
+from datetime import date
+from pathlib import Path
+
+import pytest
+
+from tdxdraw import Drawing, decode, encode, read_eld, write_eld
+
+FIXTURE = Path(__file__).parent / "fixtures" / "tdx_accepted_001.eld"
+
+
+def test_decode_real_tdx_accepted_file():
+    """通达信官方画线导入功能实测认得的样本，必须能正确解码。"""
+    (d,) = read_eld(FIXTURE)
+    assert d.market == "sz"
+    assert d.code == "002805"
+    assert d.line_type == "segment"
+    assert d.start_price == pytest.approx(22.20, abs=0.01)
+    assert d.end_price == pytest.approx(21.19, abs=0.01)
+    assert d.start_date == date(2026, 6, 12)
+    assert d.line_id == 3
+
+
+def test_reencode_matches_tdx_accepted_bytes():
+    """重编码应与通达信可接受的原始字节逐字节一致（画线创建日期除外）。"""
+    raw = FIXTURE.read_bytes()
+    mine = bytearray(encode(decode(raw)))
+    mine[0xE5:0xEA] = raw[0xE5:0xEA]      # draw_date 按写入时刻生成
+    assert bytes(mine) == raw
+
+
+def test_encode_decode_roundtrip():
+    d = Drawing("sh", "600519", "hline", 1250.0, 1250.0,
+                date(2026, 1, 5), date(2026, 10, 19), line_id=7)
+    back = decode(encode(d))
+    assert back.market == "sh" and back.code == "600519"
+    assert back.line_type == "hline"
+    assert back.start_price == pytest.approx(1250.0)
+    assert back.start_date == date(2026, 1, 5)
+    assert back.end_date == date(2026, 10, 19)
+    assert back.line_id == 7
+
+
+def test_eld_file_roundtrip(tmp_path):
+    ds = [
+        Drawing("sz", "000001", "segment", 10.0, 11.5,
+                date(2026, 3, 2), date(2026, 4, 8), line_id=1),
+        Drawing("sh", "600519", "rectangle", 1391.6, 1321.62,
+                date(2026, 8, 27), date(2026, 9, 30), line_id=2),
+    ]
+    p = tmp_path / "out.eld"
+    assert write_eld(p, ds) == 2
+    assert p.stat().st_size == 2 * 378
+    back = read_eld(p)
+    assert len(back) == 2
+    for a, b in zip(back, ds):
+        assert a.market == b.market and a.code == b.code
+        assert a.line_type == b.line_type
+        assert a.start_price == pytest.approx(b.start_price, abs=0.01)
+        assert a.end_price == pytest.approx(b.end_price, abs=0.01)
+        assert (a.start_date, a.end_date, a.line_id) == (b.start_date, b.end_date, b.line_id)
+
+
+def test_validation():
+    with pytest.raises(ValueError):
+        Drawing("xx", "600519", "hline", 1, 1, date(2026, 1, 1), date(2026, 1, 1))
+    with pytest.raises(ValueError):
+        Drawing("sh", "60051", "hline", 1, 1, date(2026, 1, 1), date(2026, 1, 1))
+    with pytest.raises(ValueError):
+        Drawing("sh", "600519", "noline", 1, 1, date(2026, 1, 1), date(2026, 1, 1))