流式图表叙事 HellowVirgil/dsh-antv-ava

🌐 简体中文 | English

dsh-antv-ava

让 DeepSeek Harness 自动将数据回答呈现为流式叙事文本、AntV 图表，或两者的自然组合。

效果预览

叙事文本和图表会直接融入模型回复，不使用独立卡片。文本按短语逐步出现，GPT-Vis 图表在获得可用数据后就开始呈现，并在生成过程中持续更新。

核心功能

- 自动选择表达方式：模型根据问题和数据决定使用 NTV、图表或两者组合。
- 流式数据解读：指标、变化率、占比、分类明细和结论按短语增量渲染。
- 流式 AntV 图表：模型生成 GPT-Vis 官方 syntax，完整数据行会在回答结束前持续更新同一个图表实例。
- AVA 数据洞察：生成稳定后，AVA 会分析表格数据中的趋势、异常、变化、占比和相关性等显著模式。
- 对话流设计：继承 DSH 的字体、字号、行高、颜色、宽度和 Markdown 间距。
- 实时主题适配：切换亮色或暗色主题后，图表坐标轴、标签和网格线会同步更新，无需刷新页面。
- 语义数据表达：支持指标高亮、涨跌箭头、绝对变化、变化率、贡献度和占比微图。
- 按需加载：只有回答包含图表时才加载 AVA/GPT-Vis 图表引擎。
- 安全解析：限制输入规模，并拒绝可执行标记、危险 URL 和私网资源。

安装

dsh plugin --profile web add dsh-antv-ava

安装后重启 dsh web，再重新加载页面。插件会自动向模型注入所需的输出约定，普通用户不需要额外安装 Skill，也不需要手写 DSL。

使用方式

安装完成后直接用自然语言提问即可。

数据解读

解读以下经营数据，给出适合快速阅读的核心结论：本月订单总量 1.98 亿，同比增长 7.05%……

模型通常会返回流式 NTV，突出指标、变化、占比和分类结论。

数据解读和图表

分析 Q1 到 Q4 的收入变化，并选择合适的方式进行可视化： Q1 128 万、Q2 164 万、Q3 191 万、Q4 226 万。

当趋势或比较通过图形更容易理解时，模型会组合叙事文本和图表。

只生成图表

把下面的数据画成趋势图，只需要图表：……

用户明确要求图表时，模型可以仅输出图表，不重复生成解释文本。

自动输出规则

| 内容特点 | 常见结果 |
| KPI、同比环比、占比、分类拆解、数据结论 | NTV |
| 趋势、比较、分布、排名、构成需要图形辅助 | NTV + Chart |
| 明确要求只画图，或文字解释没有额外价值 | Chart |

这是模型的自动选择，用户无需了解内部格式。

支持的数据表达

NTV 支持：

- 主指标、次指标和维度值
- 时间描述和趋势结论
- 绝对变化和变化率
- 占比、贡献度和占比微图
- headline、1–6 级标题、段落、列表、分节和分隔线

图表使用 GPT-Vis syntax，支持：

- 折线图、面积图、柱状图、条形图、饼图、散点图、雷达图、漏斗图、瀑布图和双轴图
- 直方图、箱线图、小提琴图、矩形树图、桑基图、韦恩图、水波图、词云和表格
- 在适合数据解读时，也可以使用 GPT-Vis 支持的其他关系图

可选：安装 Skill

插件自身已经可以工作。只有当 Agent 环境会读取 ~/.agents/skills，并且希望复杂数据任务获得更严格的事实保真和表达选择指导时，才需要安装仓库内附带的 Skill。

mkdir -p ~/.agents/skills/antv-ava
cp SKILL.md ~/.agents/skills/antv-ava/SKILL.md

高级：统一 AVA 格式

模型在一个 ava 围栏中按需生成 narrative、chart 或两者：

ava
ava
language zh-CN
narrative
headline 季度收入持续增长 paragraph text Q4 收入达到 metric-value 226万 text ，较 Q1 增长 ratio positive 76.6% chart vis line data
- time Q1
value 128
- time Q4
value 226
title "季度收入趋势" axisXTitle 季度 axisYTitle "收入（万元）"

适用范围

适合有明确数字依据的 KPI、经营分析、趋势、占比、排名和分类拆解。插件不会为了可视化补造数值，也不会执行模型输出的任意 HTML、SVG 或脚本。

缺少有效数字结构的流程、层级和路线图，更适合使用信息图类插件。

从源码安装

git clone https://github.com/HellowVirgil/dsh-antv-ava.git
cd dsh-antv-ava
pnpm install
pnpm run check
dsh plugin --profile web add "link:$PWD"

开发

pnpm test
pnpm build
pnpm run verify:pack

License

MIT。AntV AVA 和 AntV GPT-Vis 也采用 MIT License。