| name | doubao-visualization |
| description | 当用户的需求依赖可视化展示、画图、图解、趋势图、关系图、交互/动态演示、动画讲解，或数据趋势占比排名、多指标对比、算法状态机、参数变化教学、结构化知识、几何构造证明需要图示时使用；地图、附件生成、纯文字足够场景不使用。 |
豆包可视化回复
概述
本 Skill 用于当用户问题使用可视化回答有收益时，模型能回复安全、真实、可运行、移动端友好的 HTML renderer 可视化内容。核心原则是：只有命中可视化白名单才输出可视化；一旦命中，最终答案必须包含至少 1 个与任务主目标直接对应的 html type="renderer" 模块，并配套简短结论与数据口径说明。
完整规范拆分在 references/ 下的 4 个文件中；生成可视化前必须按场景读取并遵守，不能遗漏触发、格式、设计、稳定性、ECharts、交互、几何、输出示例和移动端规则。
使用场景
使用本 Skill 当用户请求满足任一白名单条件：
- 显式要求可视化：提到可视化、画图、图解、关系图、走势图、趋势图、分布图、占比图、交互演示、动态演示、动画讲解、用图说明、直观一些、清晰看到、方便展示、方便学生理解等。
- 数据图表显著增益：涉及趋势、占比、排名、波动、相关性或多指标对比，如金融价格、空气质量、气候指标、传染病发病、市场份额、财务指标等。
- 教学型动态概念：参数变化会影响曲线、轨迹、分布或空间关系，如运动轨迹、天文地理变化、函数变换、物理过程、算法过程。
- 步骤状态机：算法逐步执行、状态迁移、流程推进，且用户目标是“看过程”。
- 结构化知识展示：人物关系、历史脉络、组织结构、因果链路、流程执行、时间轴、网络扩张、路径演化等，用图能明显提升理解。
- 几何构造与证明题：仅限可视化有显著增益的几何题。
不要使用本 Skill 当：
- 用户只是代码调试、工程实现、文案、总结改写、普通问答检索、静态信息罗列、通用知识解释、闲聊、安全拒答、单纯症状解释或健康建议，且文字或公式已足够清晰。
- 用户要生成、导出、修复 PDF/PPT/Word/Excel/图片/压缩包等附件产物；这类任务必须真实生成文件，不能用 HTML renderer 冒充最终文件。
- 用户请求地图、导航、路线、地点查找、地理轨迹、行政区划展示等地图/地理位置可视化；此类需求绝对禁止地图可视化，回退为纯文本、普通列表、非地图型流程图或取数方案。
核心流程
- 判定是否触发：先按白名单判断；未命中时只用 Markdown 回复，禁止为了美化强行输出 renderer。
- 读取相关规则：命中白名单后至少读取
references/visualization-trigger-design.md；涉及脚本、公式、ECharts、交互、几何或移动端输出时，继续读取对应 reference，按完整规则执行。
- 核验事实与数据：需要实时、权威或历史真实数据时，先用可用的搜索、链接访问或数据工具核验；取不到可靠数据时，不能编造数值，只能输出空态图、示例结构、可复用模板或下一步取数方案，并明确标注“未取得可靠数据，以下为示例结构”。
- 选择表现形式：优先纯 SVG/Canvas/JS；通用数据图表可用 ECharts 或 Chart.js；仅 2D 无法表达关键关系时才用 Three.js 等专用库；地图相关组件和库始终禁止。
- 生成 renderer：用 Markdown 文本与
html type="renderer" 代码块交替输出。命中白名单时必须包含：简短文字结论、至少 1 个可运行 renderer、关键数据口径/假设/来源说明。
- 做稳定性自检：检查 HTML 结构、内联样式、脚本 IIFE、try-catch、DOM 存在性、CDN 降级、无解析期错误、无死循环高度写法、无地图组件、无文本重叠或截断。
- 做移动端自检：使用响应式布局，禁止固定列数，交互元素不小于
44×44px，正文不低于 14px，图表轴标签不低于 12px，控件不覆盖核心内容。
输出形式
命中可视化白名单时，进行文本和可视化混合的方式进行详细回复，可视化模块稳定输出：
固定结构（交替输出）：
文字结论或上下文说明（说明数据口径、假设、来源）
<html style="margin:0;padding:0;">
<div style="background-color:transparent;box-sizing:border-box;">
</div>
</html>
必要的解读、关键峰谷/拐点、最大最小项、下一步建议等
命中白名单的最终答案应该同时包含
- 文字回复或结论；
- 一个或多个与任务主目标直接对应的 HTML renderer 可视化；
- 关键数据口径、假设或来源说明。
- 其他详细的文本回复内容
单个 HTML 代码块 ≤ 300 行，超出拆为多个模块。
强制规则：
- 必须直接在回复正文中使用
```html type="renderer" 代码块输出可视化内容，由消息渲染器就地渲染
- 禁止使用 CanvasCreateFile 创建文件
- 禁止使用任何文件生成工具输出可视化，注意，禁止使用 如CanvasCreateFile / CanvasStrReplace 等文件工具输出可视化
- 所有可视化均以
```html type="renderer" 代码块直接嵌入回复正文中，不要在回复额外交付HTML产物
关键格式约束：
- 最外层必须使用
<html style="margin:0;padding:0;"> 与透明 div 包裹；禁止 <head>、<body>、<TEXT>。
- CSS 全部内联，禁止
<style> 标签。
- 单个 HTML 代码块不超过 300 行，超出时拆成多个模块。
- 根容器不得写死
height、min-height:100vh、height:100% 或 100vh；高度必须由内容自然撑开。
- 外部库优先 jsDelivr，严禁 BootCDN；外部依赖失败时必须显示可读回退内容，不能空白。
- 当代码中存在交互操作逻辑按钮等，确保对应可交互。
安全边界
- 不编造统计数据、财报营收、行业报告、历史事件、病例数、股价、排名或来源，如果需要展示客观数据，可以前置使用搜索工具进行数据准备。
- 不输出地图可视化，不调用 Leaflet、ECharts
geo/map、地图注册数据、行政区划数据、瓦片地图、坐标点或地理轨迹能力。
- 不用 renderer 代替真实附件文件交付。
- 不把示例数据伪装成真实数据；涉及真实世界数据时，明确区分“已核验数据”“估算/示例数据”“无法取得数据”。
- 不写入或回显 token、cookie、AK/SK、JWT、私钥；不绕过登录、权限、审批、审计或风控。
参考文件
references/visualization-trigger-design.md：触发白名单、禁止边界、决策树、设计哲学、设计令牌、图表库分层、配色、核心格式约束和可视化设计原则；命中任何可视化场景时必读。references/visualization-stability-math.md：脚本稳定性、降级策略、防死循环高度约束、动态/静态数学公式规则；输出任何带脚本或公式的 renderer 时必读。references/visualization-echarts-interaction.md：ECharts 专项规范、安全模板、交互式教育演示和几何证明专项；使用 ECharts、交互控件或几何图示时必读。references/visualization-output-mobile.md：输出结构示例和移动端适配规则；生成最终 renderer 前必读，用于核对结构、响应式、触控和性能要求。
参考案例
应触发
- 用户：“把这组季度收入做成趋势图，直观一点。”
- 用户：“用动画讲解冒泡排序每一步怎么交换。”
- 用户：“画一个可拖拽的三角形，辅助证明内角和。”
不应触发
- 用户：“帮我 debug 这段 React 代码为什么报错。”
- 用户：“导出一份 PPT/Excel/PDF 文件给我。”
- 用户：“在地图上标出这些城市的路线。”
