SuperAPI AI 工具集

using-open-artifacts

前端与建站

查看项目

更新于 10-15 19:50

技能介绍

用途:将自包含的 HTML、Markdown 或 React 产物发布为可通过 URL 分享的页面。查看器把产物正文放在沙箱 iframe 中,并托管服务外壳、主题切换、版本选择、评论以及可选的 Live 或 Handoff 控件。产物保留不可变版本,一个频道可在后续发布中保持同一 URL。

主要能力:发布 CLI 捆绑在 scripts/artifact.mjs,需 Node.js 22 或更高版本,无全局二进制。需先解析 SKILL.md 所在目录为 SKILL_DIR,再用 ARTIFACT_CLI="$SKILL_DIR/scripts/artifact.mjs",并从项目根目录运行 node "$ARTIFACT_CLI" ...。实例 URL 按 --api、OPEN_ARTIFACTS_URL、项目 .artifacts/config.json 或 config.local.json、~/.config/open-artifacts/config.json 顺序解析;受 CREATE_TOKEN 保护的实例使用 OPEN_ARTIFACTS_TOKEN 或配置中的 createToken;托管实例如 coda0.com 可运行 node "$ARTIFACT_CLI" login。每个产物由 JSON Recipe 加有序片段构成,Recipe 需写 artifact.level: 1|2|3,可选 artifact.canvas: true。

使用方式:首次创建需询问产物是否为本地并建议本地,将选择记录在 artifact.local。共享 Recipe 与片段放在 .artifacts/recipes/ 和 .artifacts/fragments/,本地或加密源放在对应 .local/ 目录。状态保存在 .artifacts/,凭据与本地清单被 gitignore。修改状态的命令须逐个串行执行,不能并发,包括 create、update、delete、migrate、ack、auto-update、login、logout 和 install-hook。

设计约束:HTML 产物受严格 CSP 限制,不能发起外部请求,需内联 CSS/JS,图片与字体用 data: URI。图标优先使用内联 Remix Icon SVG,禁止 CDN。不得使用 localStorage/sessionStorage。必须同时支持浅色与深色主题,主题片段需含 :root 和 :root[data-theme="dark"]。L1 文档需用 <main class="oa-prose"> 包裹正文。查看器外壳由宿主注入,不要手工编写,也不要在主题片段覆盖 --oa-* 令牌。Markdown 产物直接发布 .md,不能主题化、加样式或脚本,且不得携带 theme/styles/scripts 片段。

限制:Live 编辑仅在实例绑定 LIVE_DO 时可用,且需要产物所有者的 sk_ 会话;Handoff 需设置 OPEN_ARTIFACTS_HANDOFF=1,均可能不存在于自托管实例。当前资料末尾在“若你需要主题化 Markdown 产物”处被截断,该部分细节暂未提供。