SuperAPI AI 工具集

page

办公与效率

查看项目

更新于 10-30 16:30

技能介绍

用途:该技能把一份 HTML 文档发布为组织内可访问的链接,并接收读者在页面元素上固定的评论,让页面成为可协作的工作界面,而非一次性的导出文件。

主要能力:支持发布单个自包含 .html 文件,或发布一个目录(其 index.html 作为文档,其他文件按相对路径随附);每次发布生成版本,页面可保留历史;读者可在任意元素上固定评论,评论会回传给可处理它的智能体;页面拥有独立来源与严格内容策略;提供 window.superset.storage 共享存储 API,支持每人一个写入槽位、读取全员数据、订阅更新,可用于投票、RSVP、认领清单等。

使用方式:通过 superset pages publish 命令发布,可指定 --title、--description、--label 等参数;目录发布时 index.html 为页面入口,引用的图片、样式、媒体按相对路径一并发布;重复发布同一工作区与路径可保持页面身份,路径变化时需使用 --page <id>。发布前应检查:无远程 script src 或远程样式表链接、无任何 fetch(含 data: URI)、无 eval 或 new Function、HTML 不超过 16 MB、在断网状态下从 file:// 可正常打开。

内容策略限制:脚本无法发起网络请求(fetch、XHR、EventSource、WebSocket 均被阻止,含 fetch("data:..."));不支持运行时编译代码(无 unsafe-eval,eval 与 new Function 会抛出 EvalError);禁止从远程主机加载脚本和样式表,Google Fonts 的 link 标签是例外;图片、视频、音频可为远程(https:、data:、blob:),但建议关键资源使用 data: URI;浏览器本地存储可用且按页面隔离;无法访问父窗口;表单不可提交,需在脚本中处理输入;内联脚本与弹窗可正常工作。共享存储中每个值上限 64 KiB,每人最多 500 个键,整页上限 20 MiB;错误应按 error.code 分支处理,revoked 为终态。

适用场景:需要读者和链接的工作成果,如报告、站会仪表盘、对比表、图表、变更说明、事故调查记录、浏览器或桌面验证截图;周期性内容复用同一页面版本化发布最为合适。不适用于应放入仓库的源码、文档、配置,或需要自有服务器、数据库连接、登录流程的场景。

设计建议:使用提供的语义 HTML 骨架和主题令牌(--sp-bg、--sp-surface、--sp-text、--sp-accent 等),在 :root 上覆盖令牌;通过 body 的 dark、light 或 auto 类控制明暗主题;避免通用 AI 输出风格;使用相对单位和 flex/grid 实现响应式,宽内容加 overflow-x: auto 容器。

身份与替代:页面属于组织,出现在组织页面列表中,按工作区与入口路径进行版本化;与仅属于制作者的 Claude Artifact 不同,页面评论会回传给能处理它的智能体。在 Superset 终端内首次使用 Artifact 发布会被钩子拒绝并指向本技能;可通过设置 SUPERSET_PAGES_NUDGE=off 关闭提示。

是否发布:仅在产出物有读者且需要链接时提议发布,用一句话说明页面用途并等待用户答复;用户明确要求时直接构建。发布成本低且可逆,但用户不需要的页面会成为组织列表中的噪音。