SuperAPI AI 工具集

live-artifact

数据与分析

查看项目

更新于 10-16 06:51

技能介绍

用途:创建项目范围内、可预览的 OpenDesign 实时工件(live artifact),其数据可在不重新设计展示层的情况下后续刷新。适用于用户需要实时仪表盘、可刷新报告、同步状态页、可审计数据视图,或需要从本地/项目数据或连接器刷新数据的场景。若用户只需一次性 HTML/模型/图片且无需刷新、来源元数据或数据溯源面板,则应使用普通静态工件;意图不明时可询问“应做成可刷新/实时,还是静态工件?”

主要能力:以 template.html 作为人工设计的 HTML 模板,由守护进程用 data.json 按 html_template_v1 绑定契约进行水合;支持标量绑定 {{data.path.to.value}}(路径以 data 开头、点分隔、允许数字索引)和列表绑定 data-od-repeat="item in data.items"(仅一层,循环内绑定 {{item.label}})。不支持嵌套重复、条件、过滤器、辅助函数及原始/三花括号插值;脚本在预览中会被剥离。需编写 data.json(真实值而非占位符)、artifact.json(元数据、预览与文档声明、安全来源描述符)、provenance.json(来源说明、时间戳、非敏感连接器引用、转换说明)。index.html 由守护进程派生,不作为源文件编写。

使用方式:优先使用守护进程包装命令而非原始 HTTP。注册与更新命令为 "$OD_NODE_BIN" "$OD_BIN" tools live-artifacts create --input artifact.json、tools live-artifacts list --format compact、tools live-artifacts update --artifact-id "$ARTIFACT_ID" --input artifact.json。连接器数据先列出:"$OD_NODE_BIN" "$OD_BIN" tools connectors list --format compact;执行只读工具:"$OD_NODE_BIN" "$OD_BIN" tools connectors execute --connector "$CONNECTOR_ID" --tool "$TOOL_NAME" --input input.json。包装器读取注入的 OD_NODE_BIN、OD_BIN、OD_DAEMON_URL、OD_TOOL_TOKEN,不得打印、持久化或覆盖令牌值;不要包含或虚构 projectId。

限制与安全:不得在 artifact.json、data.json、provenance.json 或来源元数据中存储凭据、OAuth 令牌、API 密钥、Cookie、认证头、原始提供方响应、HTTP 信封、完整负载或类密钥字段;避免 raw、rawResponse、payload、body、headers、cookie、authorization、token、secret、credential、password 等键名。仅持久化预览所需的紧凑规范化字段及非敏感连接器引用(connectorId、toolName、accountLabel)。数据应保持紧凑,大列表、提供方响应或日志需先汇总。若连接器未连接,应告知用户在 UI 中连接,不要索取密钥或重复设置。验证失败时修正源文件并通过包装器重试,不得绕过验证。成功时返回工件 ID/标题并说明 index.html 由守护进程派生。