前言¶

DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在開發智能體或工具鏈時，直接在對話流中輸出可視化數據比單純返回文本更具參考價值。ikomom/dsh-trade-chart 插件解決了在 DSH 環境下直接渲染金融圖表的需求，它通過純自繪 SVG 的方式，在對話中嵌入 K 線、折線、柱狀及熱力圖等組件，無需依賴任何外部圖表庫。

插件介紹¶

該插件由開發者 ikomom 維護，類別爲客戶端插件，採用 MIT 開源協議。它不依賴瀏覽器現成的圖表庫，而是內置了完整的繪圖邏輯，能夠處理 K 線、技術指標、板塊輪動矩陣以及連板晉級圖等多種數據展示形式。

安裝¶

安裝前請確保你的 DeepSeek Harness 環境已正確配置。根據你的部署方式，選擇以下三種命令之一執行：

# 方式一：本地路徑安裝（Windows 示例，請替換爲你的真實路徑）
dsh plugin --profile web add link:D:\你的真實路徑\dsh-trade-chart

# 方式二：直接從 Git 安裝（推薦）
dsh plugin --profile web add git+https://github.com/ikomom/dsh-trade-chart.git

# 方式三：通過 NPM 包安裝（發佈後可用）
dsh plugin --profile web add @ikonon/dsh-trade-chart

安裝完成後，重啓 dsh web 進程並刷新頁面即可生效。

核心功能¶

插件主要提供以下幾種圖表渲染能力：

• K 線圖：支持紅漲綠跌的蠟燭圖，包含成交量副圖以及可自定義週期的 MA 均線。
• 技術指標：
  • 主圖指標：EMA（自定義週期）、BOLL 布林帶（帶狀填充）。
  • 副圖指標：MACD（DIF/DEA/柱狀圖）、RSI（30/70 超買超賣區）、KDJ。
  • 成交量指標：量柱、MAVOL 均量線。
• 基礎圖表：支持折線、柱狀、面積圖，具備多序列對比、圖例顯示及懸浮提示功能。
• 特殊圖表：
  • 熱點輪動矩陣：板塊與日期的二維矩陣，紅漲綠跌着色。
  • 連板晉級圖：板數與日期的天梯圖，顯示家數與自動計算的晉級率。
• 標註與交互：支持 pivots 自動標註波段高低點，支持自由標註（趨勢線、箭頭、矩形等）。交互上支持滾輪縮放（Y 軸鎖定）、拖動平移、雙擊復位及十字光標。

使用方式¶

插件在對話中調用 trade_chart 工具來渲染圖表。以下是主要參數說明。

圖表類型¶

通過 chart.type 指定圖表形態，支持 kline（K 線）、line（折線）、bar（柱狀）、area（面積）、heatmap（熱力圖）、ladder（連板晉級圖）。

K 線圖參數¶

若 type 爲 kline，需傳入 kline 數組（OHLCV 格式）和 indicators 對象。

{
  "chart": {
    "type": "kline",
    "title": "示例日K",
    "symbol": "600519.SH",
    "period": "日K",
    "kline": [
      {
        "time": "2026-07-19T16:00:00Z",
        "open": 1270,
        "high": 1329,
        "low": 1266,
        "close": 1327.5,
        "volume": 106151
      }
    ],
    "indicators": {
      "ema": [12, 26],
      "boll": true,
      "mavol": [5, 10],
      "macd": true,
      "rsi": [6, 12, 24],
      "kdj": true
    },
    "pivots": true
  }
}

熱點輪動矩陣參數¶

若 type 爲 heatmap，需傳入 heatmap 對象。

{
  "chart": {
    "type": "heatmap",
    "title": "熱點輪動",
    "heatmap": {
      "rows": ["AI算力", "機器人"],
      "categories": ["07-01", "07-02"],
      "values": [[5.2, 3.1], [-1.5, 2.3]],
      "unit": "%"
    }
  }
}

連板晉級圖參數¶

若 type 爲 ladder，需傳入 ladder 數組。

{
  "chart": {
    "type": "ladder",
    "title": "連板晉級",
    "ladder": [
      {
        "date": "2026-07-01",
        "boards": [
          { "level": 1, "count": 42 },
          { "level": 2, "count": 9 },
          { "level": 3, "count": 3, "stocks": ["中際旭創", "新易盛"] }
        ]
      }
    ]
  }
}

自由標註¶

通過 annotations 數組支持自定義標註，包括高低點、水平線、趨勢線、箭頭、矩形和備註。

數據與指標說明¶

• 數據定位：支持 time（時間戳）或 i（下標，從 0 開始）定位數據點，支持添加 color 屬性。
• 指標計算邏輯：
  • MACD：柱狀圖計算公式爲 2 × (DIF - DEA)。
  • RSI：採用 SMA（簡單移動平均）平滑計算。
  • KDJ：默認參數爲 (9, 3, 3)。
• 熱力圖着色：遵循 A 股慣例，紅漲綠跌，0 值爲中性發散，null 值顯示爲灰塊。
• 連板晉級邏輯：
  • 縱軸爲板數，橫軸爲日期。
  • 客戶端自動計算晉級率（今日家數 ÷ 昨日上一板家數）。
  • 晉級率 ≥ 50% 的格子標紅。
  • 高板（股票數少）時，格子內直接列出具體股票名稱。

注意事項¶

1. 性能限制：K 線數據量超過 800 根時會自動聚合，超過 5000 根將被拒絕渲染。
2. 渲染方式：所有圖表均由純 SVG 渲染，不依賴外部圖表庫，保證輕量化。
3. 權限依賴：插件運行在 DSH 客戶端環境，安裝前請檢查源碼與許可證（MIT）。