用途:在 Orca 聊天回复中内联展示 HTML 可视化页面,适用于图表、示意图、表格、报告或原型等有助于理解答案的场景。
写入方式:把页面保存到环境变量 ORCA_CHAT_VISUALS_DIR 指定的文件夹(可用 printenv ORCA_CHAT_VISUALS_DIR 查看;PowerShell 用 $env:ORCA_CHAT_VISUALS_DIR)。若未设置或无法写入,则跳过可视化。每个可视化一个完整 HTML 文件,直接放在该文件夹,小于 512 KB,每次使用新文件名(如 latency-by-region-7c1e.html),文件名由字母、数字、.、_、- 组成并以 .html 结尾。
资源限制:样式、脚本和数据内联;库与字体只能从 cdn.jsdelivr.net、unpkg.com、cdnjs.cloudflare.com、esm.sh、fonts.googleapis.com、fonts.gstatic.com 加载。页面不能发起网络请求,图片需用内联 SVG 或 data: URL。
布局与主题:不要用视口高度(100vh)设定尺寸,Orca 会按内容自适应框架。可选使用 Orca 主题色 CSS 变量:--background、--foreground、--muted-foreground、--border、--primary、--chart-1 至 --chart-5。
展示方式:文件存在后,在回复中单独一行、位于代码块之外写入 ::orca-visual{file="latency-by-region-7c1e.html" title="Latency by region"}。file 只能是纯文件名,不能带路径;title 可选。每条回复最多 8 个。
限制:未设置目录或无法写入时不可用;视觉内容受体积、外链来源与无网络请求约束。其他收费、价格、平台或效果信息暂未提供。