SuperAPI AI 工具集

generated-ui

编程与开发

查看项目

更新于 10-22 08:46

技能介绍

用途

该扩展用于在交互式计算或比较有助于用户探索问题时,生成一张本地可交互的界面卡片。对于单一事实或简单结果,应直接用文本回答。每次调用都创建一张全新的完整卡片,不能更新旧卡片,也不能打开文件、抓取数据、发送消息或代替用户执行操作。

主要能力

界面由 title、summary、html、css、javascript 五个字符串字段组成。title 为 1–120 字符,summary 为 1–2,000 字符,html 为 1–12,000 字符,css 为 0–6,000 字符,javascript 为 0–12,000 字符。整个序列化结果(含重复的标题、摘要、元数据和 JSON 转义)须控制在 24,000 字符和 24,000 UTF-8 字节以内。

html 是正文内容而非完整页面,支持标题、文本、标签、列表、表格、支持的输入控件、按钮和基本 SVG。最多 512 个元素和 64 个控件。ID 须唯一,以 ASCII 字母开头,仅含字母、数字、下划线或连字符,最长 64 字符。支持控件包括 text/number/range/checkbox/radio 输入、单值 select 和 textarea;多选 select 会被拒绝。样式放在 css 中,所有计算放在 javascript 中。不得包含 URL、外部图片/字体/脚本、链接、表单、iframe、嵌入、事件处理属性、文件输入或导航。

JavaScript API 包括:ui.on('control-id', 'input', function (event) {...}),其中 event 为 { id, type, value, checked },不是浏览器 Event;ui.input('control-id') 返回 { value: string, checked: boolean };ui.text('answer-id', 'Plain text');ui.html('answer-id', '<strong>Sanitized markup</strong>');ui.value('control-id', '42')。仅支持 input、change、click 事件。text/html/value 操作须传入字符串,用户控制的值优先用 ui.text。ui.value 使请求的字符串对同一轮后续 ui.input 调用可见。浏览器归一化(数字校验、range 钳制或 select 匹配)和 HTML 创建的默认值会在下一次分发的快照中体现。

使用方式

从对话中确认实际问题、提供的数据、单位和假设,标注示意性数据与不确定输入,不得把模型猜测当作实测事实。为 generated_ui_show 生成一组完整的标题、摘要、html、css 和 javascript 字符串,调用一次。摘要须在脱离界面时仍有意义:包含初始结果、假设以及可变化的内容。使用稳定的唯一元素 ID 和受支持 ui API 的普通同步 JavaScript 计算,显式转换数值输入,约束无效输入,显示公式、单位和有意义的标签。注册处理器后计算一次初始显示。

若被拒绝,应简化完整文档并最多修正一次。若宿主仍无法显示,则以独立答案结束并说明限制。不要反复生成卡片或尝试其他执行通道绕过运行时限制。

适用场景

适合参数模拟(如容量估算)、加权选项比较等需要用户拖动滑块或修改数值即时查看结果的本地计算。

限制

JavaScript 运行在隔离的 QuickJS Worker 中,没有 document、window、fetch、require、模块导入、定时器、文件系统、MCP 工具或宿主消息 API。不能使用 querySelector、addEventListener、setTimeout、浏览器事件、CDN、图表库导入或隐藏内联脚本。

计算须同步。事件处理器抛出未捕获同步异常或返回被拒绝的 Promise 会结束激活。UI 操作失败是终止性的。Worker 堆上限 32 MiB,栈 256 KiB,每次初始化/事件限 250 ms。一轮最多处理 256 个待处理微任务并发出最多 64 个补丁,超过即结束。输入值限 2,048 字符;每个完整输入快照和补丁批次须在 16,000 字符和 UTF-8 字节内。避免无界循环、大分配、递归、持续动画或人为延迟。

连续输入事件可能被合并;最多 16 个事件等待 Worker,队列满时无法合并的额外事件会被忽略。旧轮次与较新排队编辑冲突时整批补丁(含派生文本/HTML)会被丢弃。丢弃补丁不会撤销 JavaScript 变量变更,也不会触发新渲染;显示状态应保存在控件中并从 ui.input() 快照渲染,不要依赖可变的闭包计数器、开关或历史列表。没有事务回滚或恰好一次的事件投递。

刷新可能从保存的初始值开始新激活,不恢复用户的滑块位置。终端或旧宿主保留可读摘要。历史可保留初始文档,但过大的重放窗口可能降级为文本;不提供持久交互状态、流式输出或无限制的富重放。