SuperAPI AI 工具集

building-canvases

数据与分析

查看项目

更新于 10-16 03:44

技能介绍

用途:画布是运行在 PostHog 沙箱 iframe 中的客户端浏览器应用,可用于数据看板、文档、表单、小工具或图形实验。源码存于 PostHog,通过 canvas-* 工具读写,不可写入本地文件,发布即保存。任何普通任务都可能触发画布需求,无需专门模式或预建画布。

目标解析:任务若指定 canvas id 即为目标,不要另建。否则以任务所在频道为准,用 canvas-list 列出该频道画布,若已有对应迭代则在其上构建;确实不匹配再用 canvas-create 新建并取简短描述性标题,不得用“Untitled canvas”。不要自行浏览频道选目标;用户未指明画布或频道时应询问。

实现配套技能:写源码前按需加载 building-react-quill-canvases(仪表盘、表单、工具、类应用状态)与 building-html-canvases(文档、文章、生成式图形、canvas/WebGL);涉及数据时同时加载 querying-canvas-data;发布前始终加载 validating-and-publishing-canvases。可混用两种实现方式。

能力:画布可含预制块(数字、目标、趋势、排行榜、漏斗、留存、已保存洞察、实时事件流、SQL 表、筛选器等),以 React 组件位于 src/blocks/。可通过 editable(name, props, params) 暴露可编辑参数(类型有 text、longtext、number、boolean、select、event、events、property、insight、color 等),每个使用点需唯一 blockId。

迭代流程:用 canvas-source-retrieve 读取当前源码与 current_version_id;编辑项目文件;用 canvas-validate-create 校验并修复所有错误级诊断;首版用 canvas-publish-create 并传 expected_current_version_id: null;已上线则用 canvas-edit-create 传 str_replace 与当前版本 id。仅在用户要求草稿或预览时用 canvas-draft-create。等待构建,失败需修复后重存。每项请求变更保存一次,回复末尾说明画布所在频道并以工具返回的 url 字段链接。

运行期能力:ph.state 键值记忆(user 默认私有,shared 全团队可见,上限 64 KB/256 键);ph.actions.invoke 写入 PostHog,须声明并绑定用户手势;ph.connectors.call 以查看者连接读取第三方数据;ph.agent.request 经查看者同意请求代理修改。所有调用须在 project.capabilities 中声明。

限制:源码项目保持 index.html 入口与 src/canvas.tsx;不得新增 npm 包,裸导入仅限平台固定依赖;图片用公共媒体库 URL(小于 4 MB,公开无鉴权,禁止上传机密或敏感数据);不得自行构造画布链接。