前言¶

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