Widget 总览

VizChat 的画布由 widget 组成。每个 widget 是画布上的一个可视化单元——图表、表格、PDF、网页书签、Agent 生成的小工具等。了解有哪些 widget 类型，是掌握 VizChat 的第一步。

VizChat 的两类 widget

VizChat 采用两层 widget 扩展模型，兼顾开箱即用的稳定性与 AI 动态生成的灵活性。

1. 内置自定义 Widget（Built-in Custom Widgets）

通过源码在 repo 里实现，随 VizChat 一起发布的图表与文档类 widget。当前约十余种，覆盖最常见的可视化需求：

• 图表 widget — 柱状图、折线图、饼图、函数作图
• 表格 widget — 结构化表格数据
• 信息图 — DSL 驱动的信息图排版
• PDF 阅读器 — PDF 查看 + bbox 引用
• 网页查看器 — 网页书签 / Reader 模式

内置 widget 代码托管在仓库的 src/custom-widgets/ 和 src/react-native-widgets/ 目录下，升级需要发版。

2. 用户 Widget

Agent 在对话中运行时生成的 HTML+JS 组件实例，存为数据库记录（username/slug@version），不占用 repo 代码。详见 用户 Widget。

怎么选用哪类 widget

需求	推荐类型
常见图表 / 表格 / PDF 引用	内置 widget
临时想法、一次性小工具、个性化交互	用户 Widget

快速判断：先看有没有现成内置 widget → 没有就让 Agent 生成用户 Widget。

扩展策略

内置 widget 类型数量有限（当前约十余种），覆盖不了长尾场景；用户 Widget 数量可达千级，通过画布内的 Widget Marketplace Sheet 发现与安装；我们计划推出公开 /marketplace 覆盖两类 widget 的统一浏览、对话调用与收藏体系（见 路线图）。

这也是为什么本节文档不试图穷举所有 Widget——Widget 属于市场中发现的对象，而非 docs 列表中的条目。

Next step

• 图表 widget — 最常用的可视化类型
• 用户 Widget — Agent 动态生成的小工具
• 自定义 widget 开发 — 给开发者的 widget 开发指南