SuperAPI AI 工具集

feishu-cli-htmlbox

前端与建站

查看项目

更新于 10-16 02:31

技能介绍

用途:在飞书云文档中绘制会动的图、可交互图表与数据大屏。妙笔BOX 是飞书文档里唯一能真实执行 CSS/JS 的载体(iframe 沙箱),动画、ECharts、Three.js、Canvas 均可运行。流程为:照配方写一页自包含 HTML,本地浏览器验证渲染,再用 doc htmlbox 落库。

主要能力:覆盖 ECharts 常见统计与关系图(折线、柱状、饼、雷达、散点、热力、桑基、漏斗、仪表、K线、箱线、平行坐标、旭日、treemap 等)、词云、纯 CSS 动画、Canvas 粒子、SVG 路径自绘、KPI 数据大屏、真实地图着色与飞线、echarts-gl 3D 地图与 Three.js 场景。妙笔BOX 的 iframe 内注入 window.magic 运行时,可获取当前用户身份、读取文档全文与元信息、持久化状态、拉取多维表数据、调用文档内 AI。

使用方式:插入 feishu-cli doc htmlbox create <doc_id> --html-file x.html;替换 feishu-cli doc htmlbox update <doc_id> <block_id> --html-file x2.html;读回 feishu-cli doc htmlbox get <doc_id> <block_id> --raw > cur.html;删除 feishu-cli doc htmlbox delete <doc_id> <block_id>。输入也支持 --html 或 --html-file -(stdin)。落库前用 scripts/verify.sh /tmp/x.html 验证,退出码 0 才算初步通过,仍需肉眼查看截图。

适用场景:飞书文档内的动态可视化、数据大屏、可交互文档小程序。

限制:妙笔BOX 是整体 iframe,内部元素不能在飞书里单独点选编辑;画板 SVG 节点会被栅格化为静态图。window.magic 只在飞书文档端注入,本地 file:// 预览为 undefined,需判存兜底。ECharts 5 不带地图数据,需先 fetch GeoJSON 再 registerMap。批量创建需间隔 sleep 0.5s 避免限流。其余细节暂未提供。