下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-vkwncxc8--ar-viewer.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-vkwncxc8/ar-viewer。用户输入 GLB 模型 → 生成可独立打开的 HTML 预览页,支持拖动旋转 + 手机原生 AR
阅读全文 (展开查看完整说明)
概述
AR 体验生成器(ar-viewer)
把任意 .glb 3D 模型,变成一个可独立打开的网页,支持桌面旋转预览,以及手机端一键把模型摆进真实房间(AR)。
用途
- 产品 / 潮玩 / 展品 → 生成可分享的 AR 预览页
- 把 Blender 导出的
.glb变成可直接发链接、扫二维码就能看的效果页 - 电商 / 自媒体展示 3D 资产,无需装 App、无需自建后端
前置条件
- 输入:一个
.glb文件(本地路径或http(s)://URL)。 - 零依赖:脚本只用 Python 标准库,无需
pip install。 - 预览页默认把 Google
<model-viewer>库一并内联进 HTML,与模型本体一起完全自包含,离线也能打开并拖动旋转预览(无需联网)。仅当 GLB 使用 Draco 压缩网格时,解码器会按需联网加载。 - 手机 AR 能力依赖系统原生支持:Android 需安装 Google Play 服务(Scene Viewer),iOS 需 Safari(Quick Look)。桌面浏览器仅显示 3D 预览,不进 AR。
输入格式
调用 scripts/generate_ar.py,参数:
| 参数 | 必填 | 说明 |
|---|---|---|
--glb | 是 | .glb 文件路径或 URL |
--output | 否 | 输出 HTML 路径,默认 ar_preview.html |
--title | 否 | 模型标题,显示在页面 |
--theme | 否 | system / light / dark,默认 system(跟随系统) |
--accent | 否 | 主题强调色(十六进制),默认 #6366f1 |
--qr | 否 | 额外生成分享二维码 PNG(需 qrcode 库,未装则跳过并提示) |
--no-ar | 否 | 关闭 AR 按钮(仅做 3D 预览) |
--mv-lib | 否 | 指定本地/URL 的 model-viewer.min.js,用该文件内联(跳过下载) |
--no-inline | 否 | 不内联库,改用 CDN <script src>(HTML 更小,但打开需联网) |
使用流程
- 用户给出
.glb(本地文件或链接)。 - Agent 调用脚本:
python scripts/generate_ar.py
--glb "model.glb"
--title "星河潮玩 v1"
--theme system
--output ar_preview.html- 脚本把 GLB 以 base64 内嵌进 HTML,输出一个单文件
ar_preview.html。 - 交付该 HTML:桌面双击即可拖动看模型;手机打开(或扫二维码)点「在你的空间查看」即进 AR。
交互指引(让使用者选择)
- 使用者未指定主题 → 默认
system(跟随设备),不追问。 - 使用者在意明暗 / 品牌色 → 传
--theme/--accent,尊重其选择,不擅自改回默认。 - 使用者只想做 3D 展示、不要 AR 按钮 → 传
--no-ar。 - 使用者想方便分享 → 传
--qr生成二维码(会提示需pip install qrcode)。
输出与交付
- 主产物:
ar_preview.html(自包含,模型内嵌,可直接发给用户 / 部署到任意静态托管)。 - 可选:
ar_preview.png(二维码,启用--qr时)。 - 网页内已含主题切换按钮(亮 / 暗 / 跟随系统),用户可自行切换。
限制
- 这是免费、本地生成型 Skill:用户用自己的模型,本 Skill 不代收任何费用,无需 X402 付费改造。
- 模型越大,内嵌后的 HTML 越大(base64 约为原体积 1.33 倍)。超过约 30MB 的 GLB 建议改用外链
src模式(在references/ar-guide.md有说明)。 - AR 实景能力依赖手机系统原生支持,桌面端仅 3D 预览。