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）。