ONIMI PAGES / 使用文档
帮助中心
从用 Agent 生成第一个页面，到把分享权限掌握在自己手里。
01
用 Agent 生成网页
Creator 帮助你在自己的 Agent 工作区中，把想法变成可预览、可修改的 HTML。
谁在生成页面
把 Creator 安装到你正在使用的 Agent。Agent 使用你已经选择的模型和本地工作区生成页面；Onimi Pages 不提供生成模型，也不会在这条流程中接收你的创作提示词。
从描述到本地预览
告诉 Agent 页面用途、读者、内容和风格。Creator 会引导它先确定版式方向，再生成一个自包含 HTML，并检查交互、键盘操作、手机布局、减少动画和示例数据标识。先在本地浏览器预览，不满意就继续修改。
生成不等于发布
完成的 HTML 可以只留在本地。只有你明确要求时，Agent 才会使用另行安装并授权的 Publish 继续发布；公开、未列出或私有由你选择。你也可以在工作台手动上传。
02
从第一次发布开始
可以在 Agent 对话中发布，也可以直接在工作台上传。
安装、授权、使用
打开「如何使用」，选择 GitHub、Cloudflare 直接下载、npm（上架后）或 ClawHub，复制安装提示词发送给 Agent。它会安装 Skill 并配置连接；在浏览器登录 Onimi Pages、确认权限后返回对话。
发布第一个页面
告诉 Agent：「把 product.html 发布到 Onimi Pages，创建一个名为『产品介绍』的新项目，并把访问链接发给我。」已有项目时，直接指明项目名称。Agent 不会在你未要求时自动创建项目。
直接上传
不使用 Agent 时，在「项目」中新建项目，进入项目页面上传单个 HTML，或包含一个 HTML 入口及配套资源的 ZIP。工作台上传同样会创建版本并提供访问链接。
03
项目是什么
一个项目对应一个对外访问的 HTML 页面，以及这个页面的更新历史。
创建与命名
项目名称用于辨认内容，slug 用于访问地址。首次成功发布后 slug 固定；后续更新同一项目会继续使用原来的稳定链接。不同页面请分别创建项目。
项目里的功能
概览展示项目信息与状态；版本管理更新记录；分享创建和撤销访问授权；统计查看访问表现；设置修改名称、描述、分类、标签和可见性。
04
发布、更新与版本
更新页面内容时继续发布到原项目，不需要重新向所有人发送链接。
稳定链接与版本链接
稳定链接打开当前生效版本。版本链接在同一地址后带上 ?version=vN，用于指向某次发布；版本号不会放到路径里。发布失败不会替换当前页面。
旧版本是否可访问
在项目设置中关闭「允许旧版本链接」后，普通旧版本链接会跳转到最新版。所有者和有效的临时 Pinned 授权仍可查看指定历史版本。
HTML 和 ZIP 的区别
当前 Agent 发布工具接收单个 HTML。需要一并上传本地图片、样式等资源时，可以在工作台上传只有一个 HTML 入口的 ZIP；不要上传服务端代码或多页面站点。
05
把页面分享给别人
先决定谁可以访问，再选择要发送的链接。
公开 Public
页面可被公开访问，并可进入广场。适合希望被发现的作品与演示。
未列出 Unlisted
页面不在广场展示，但知道链接的人仍可访问。未列出不是私有，也不会阻止链接被转发。
私有 Private
其他人需要有效的访问授权。在项目的「分享」页面创建授权，将生成的授权链接发给对方，或让对方在访问码页面输入授权码。授权秘密只显示一次，请及时保存。
Live 与 Pinned
Live 授权跟随当前版本，适合持续更新的内容；Pinned 授权固定某个版本，适合评审或留档。可以设置有效天数和最多访问次数。旧版本访问被关闭时，历史 Pinned 授权需要有效期。
06
关闭分享与下线
停止某条分享、限制公开访问和删除页面，对应不同操作。
撤销某一条授权
进入项目 → 分享 → 已有授权，找到对应项点击「撤销」。该授权不再允许新的访问，但其他有效授权仍可使用。对公开或未列出的项目，撤销授权不会关闭普通链接的访问。
停止普通链接访问
在项目 → 设置中把可见性改为 Private。若希望同时停止已授权访问，还需在「分享」中撤销所有有效授权。仅从 Public 改为 Unlisted 不能阻止已有链接访问。
删除并下线
在项目 → 设置中的危险操作区域选择「删除并下线」。此操作会删除项目并关闭访问，请仅在确定不再需要时使用；它不是可随时恢复的暂停开关。已经被他人下载或保存的内容无法收回。
07
Agent 连接与授权
Agent 连接管理的是工具对你账号的访问权限。
查看与断开连接
在「Agent 连接」查看已连接客户端、申请权限与最后使用时间，并撤销不再需要的连接。撤销后需要重新授权才能继续通过该连接操作。
断开后页面还在吗
已经发布的页面和访问授权保持原有状态。断开 Agent 不会删除项目，也不会让分享链接下线。停止页面分享请使用项目的分享与设置功能。
登录后没有回到 Agent
回到 Agent 的连接管理界面检查状态，必要时重新发起授权。安装 Skill、添加连接和浏览器授权是不同步骤；部分客户端需要重新加载后才能发现工具。不要把 Token 或授权码粘贴到聊天中。
08
访问统计
进入项目 → 统计，了解页面的访问情况。
如何阅读数据
总访问统计成功页面加载，访问趋势按天展示，并提供独立访客、地区、来源和设备信息。计费用量请以「套餐与用量」页面为准。
09
套餐、账号与开发者功能
在工作台中集中管理账号及使用情况。
套餐与用量
在「套餐与用量」查看当前套餐、项目及访问额度，并按页面入口管理订阅。发布被额度限制时先检查用量，无需通过删除其他项目来尝试绕过限制。
账号设置
在「账号设置」查看和修改页面允许编辑的资料。用户名用于你的页面访问地址，请留意页面对可修改字段的说明。语言和主题可通过顶栏切换。
开发者令牌
供 CI 或终端自动化使用，可按需要创建和撤销。一般 Agent 用户使用浏览器授权即可，无需创建令牌。
10
常见问题
从当前卡住的步骤开始排查。
安装了 Skill，却找不到发布工具
检查是否已配置 Onimi Pages 的远程 MCP 连接并完成 OAuth 授权，再重新加载 Agent。若客户端不支持自定义远程连接，可先使用工作台上传。
朋友打不开页面
确认项目已成功发布；检查可见性、授权是否被撤销、是否过期或达到次数限制。私有项目要发送有效的授权链接，而不是只发普通项目链接。
上传失败
核对文件格式、HTML 入口数量、资源路径和当前套餐限制，按具体报错修改。不要反复新建项目；失败的发布不会覆盖当前生效页面。