DSH 插件 dsh-tdx：接入通达信获取 A 股行情数据

做 AI 投资分析的 DSH 用户常面临模型拿不到行情数据的问题，只能依赖训练记忆中的陈旧价格。本插件通过接入通达信（pytdx），为模型提供真实的 K 线、实时行情、技术指标和板块数据，解决数据源缺失的问题。

插件概况¶

名称：dsh-tdx
所有者：guozede12593312
定位：联网工具类插件，通过本地通达信接口提供金融数据。
核心价值：为 DSH 模型提供 K 线查询、实时快照、技术指标计算及概念板块分析能力。

核心功能¶

该插件提供以下四类查询工具：

A股历史 K 线 (OHLCV)：支持获取指定周期和数量的历史数据。
实时行情快照 (批量)：支持一次性查询多只股票的当前价格。
技术指标：支持计算 MACD、RSI、MA、EMA 等指标。
概念板块：支持查询概念板块的成分股列表或特定板块的成分。

前置依赖与配置¶

使用前需满足以下环境要求：

Node.js：用于运行插件本体。
Python 3.6+：用于数据抓取，需安装 pytdx 库。
- 安装命令：pip install pytdx
环境变量：若 python 不在系统 PATH 中，需设置环境变量 DSH_TDX_PYTHON 指向 Python 解释器路径。

安装与启用¶

安装命令如下：

dsh plugin --profile <your-profile> add https://github.com/guozede12593312/dsh-tdx

安装完成后，插件工具即可在 DSH 会话中调用。

本地调试¶

若需在本地调试插件，需进入插件目录手动安装依赖：

cd dsh-tdx && npm install
DSH_TDX_PYTHON=<python 路径> dsh plugin --profile <your-profile> add ./dsh-tdx

注意：link 模式下，副本 ~/.dsh/plugins-src/dsh-tdx 也需在该目录执行 npm install，因为 link 模式不会自动共享 node_modules。

典型用法¶

以下是插件提供的工具调用示例：

# 获取贵州茅台最近 60 个交易日的日 K 线
tdx_kline(code=600519, period=day, count=60)

# 获取贵州茅台最近 60 个交易日的 MACD 指标
tdx_indicator(code=600519, indicator=macd, count=60)

# 获取贵州茅台最近 60 个交易日的 RSI 指标
tdx_indicator(code=600519, indicator=rsi, count=60)

# 查询“人工智能”板块的成分股
tdx_sector(name=人工智能)

技术设计¶

插件采用薄壳模式，将注册逻辑与核心计算分离：
* 数据层：通过 Node 调用 Python 脚本，利用 pytdx 连接通达信服务器获取原始数据。
* 逻辑层：指标计算逻辑（MA/EMA/MACD/RSI）在 lib.js 中通过纯函数实现，减少外部依赖。
* 测试：依赖安装后，可通过 npm install && node --test 进行单测。

适用场景与注意¶

适用场景：适合需要基于实时或历史行情数据进行 AI 投资分析的 DSH 用户。
权限注意：插件以当前 DSH 进程的权限运行，请确保环境配置安全。
源码审查：安装前建议检查源码与许可证（MIT）。