dsh-artifact
Render ECharts (and later more engines) inline in DeepSeek Harness conversations — declarative options fed to the real charting engine.
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:sumarilkkxx/dsh-artifact说明文档
阅读完整 README ↗dsh-artifact
在 DeepSeek Harness 对话中内联渲染交互式 ECharts 图表。
dsh-artifact 让模型在对话里直接渲染真实、可交互的图表——不是手绘 SVG,也不是一堆文字。模型调用 render_artifact 工具,传入声明式的 ECharts option(纯 JSON、无函数),Web UI 就用真正的 ECharts 引擎渲染出来:tooltip、缩放、图例,以及 ECharts 支持的全部图表类型(柱状 / 折线 / 饼图 / 散点 / 热力图 / 雷达 / 仪表盘 / 漏斗 / 桑基图 / 关系图 / 地图 / 盒须图 / 旭日图 / K 线等)。
为什么做 dsh-artifact
| dsh-genui | dsh-visualize | dsh-artifact | |
|---|---|---|---|
| 模型产物 | 白名单 JSON 组件树 | 任意 HTML/JS | 声明式 ECharts option |
| 真实图表引擎 | ✗(手绘 3 种图) | ✓(靠 HTML) | ✓(完整 ECharts) |
| 对话内内联 | ✓ | ✗(仅工具行) | ✓(工具卡片) |
| 可交互 | ✓ | 部分 | ✓(tooltip / 缩放 / 图例) |
| 交互回环 | ✓ | ✗ | 路线图(v0.3) |
| 安全模型 | 白名单 | 沙箱 iframe | 纯 JSON、无函数 |
dsh-genui 手绘了三种图表、能力有限;dsh-visualize 能渲染任意 HTML 却没有交互回环。dsh-artifact 把声明式 JSON option 喂给真正的 ECharts 引擎——模型最擅长写 JSON,却因此获得全量图表能力,成本更低,且以「纯 JSON、无函数」作为严格的安全边界。
安装
# 从 GitHub 安装(推荐,仓库已包含构建产物,无需额外构建)
dsh plugin --profile web add github:sumarilkkxx/dsh-artifact
# 本地目录链接(开发调试)
dsh plugin --profile web add link:/path/to/dsh-artifact
# 从项目目录
dsh plugin --profile web add .
重启 dsh web 并强制刷新页面(Cmd/Ctrl+Shift+R)。
需要
pnpm在PATH中(dsh plugin命令内部会转发给 pnpm)。
使用
直接对模型说:
画一张 2024 年四个季度的收入柱状图:120、180、150、210 万元
模型会调用 render_artifact 并传入 ECharts option,图表即以交互卡片的形式出现在对话中。
工具参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
option |