迷你网站 — 完整用户指南

什么是迷你网站？

迷你网站让你可以在 OrbitingFox 内部直接构建和发布自己的网站 — 无需编码。 每个网站都有自己的公共 URL，自定义页面、图像和联系表单。 你可以在 /sites/ 浏览所有已发布的网站。

创建你的第一个网站

1. 前往 迷你网站仪表板 → 点击 + 新网站。
2. 填写标题、内部别名（URL 安全的昵称）和可选的描述。
3. 点击 创建 — 你将进入构建器。

构建器

构建器有两个主要区域：

• 左侧边栏 — 你的页面列表。点击页面进行编辑。使用可见性眼睛图标控制谁可以查看每个页面。
• 画布（右侧） — 你的块编辑器。每个块是一段内容（文本、图像、按钮等）。

顶部栏有快速访问按钮：

• 预览 — 查看页面的公共视图
• 设置 — 全站设置（颜色、徽标、SEO、导航样式）
•  导出 ZIP — 下载整个网站作为可移动文件
• 版本 — 浏览和恢复先前的快照

页面和部分

每个网站由 页面（称为部分）构成。页面会自动出现在你网站的导航中。

• 点击侧边栏中的 + 添加页面 创建新页面。
• 给予它一个 标签（出现在导航中）和一个 别名（简短的 URL 安全名称，例如 services）。
• 拖动页面上下重新排列导航。
• 每个页面的 可见性：公开（所有人）、仅所有者（只有你）、隐藏（不在导航中显示）。

子页面

你可以将页面嵌套最多 4 层。要使某个页面成为另一个页面的子页面，在添加/编辑时设置其 父页面。子页面在导航中以下拉项显示。

块类型

在页面内点击 + 添加块 插入内容。可用的块类型：

AI 提示助手（原始 HTML 块）

当你添加一个 原始 HTML 块时，会出现一个紫色的 使用 AI 自定义 面板。 点击它以展开 — 它显示该部分类型的现成 AI 提示。

1. 向下滚动到提示底部的 [EDIT THIS PART] 并用自己的内容替换示例。
2. 点击 复制提示。
3. 粘贴到 ChatGPT 或 Gemini （均免费）。
4. 复制 AI 返回的 HTML → 粘贴到代码框 → 点击 保存。

提示 — 将按钮链接到部分：如果 AI 给了你一个像 <a href="#">了解更多</a> 的按钮， 将 # 替换为 #your-page-slug。示例： <a href="#services">我们的服务</a> 滚动到别名为 services 的页面。

AI 助手下方有一个绿色的 提示 面板，解释此内容，并提醒你使用内置的表单块作为联系表单（而不是 AI 生成的 HTML 表单）。

设置选项卡

在构建器中打开 设置 选项卡以配置全站选项：

• 基本 — 标题、别名、描述、SEO 标题/描述/关键字、横幅标题
• 品牌 — 顶部图像、徽标、图标、动画徽标
• 颜色 — 背景、徽标区域、头部、页脚（十六进制颜色选择器）
• 徽标轮播 — 上传多个徽标用于滚动条；控制幻灯片间隔、对齐方式
• 导航 — 布局（左侧边栏 / 顶部栏 / 右侧边栏）、主题（明亮 / 昏暗 / 透明）
• 联系表单 — 显示电话字段切换，设置电话/电子邮件为必填
• OrbitingFox 徽章 — 显示或隐藏网站归属徽章
• 发布 — 设置你的公共 URL、可见性模式和发布/取消发布按钮

发布你的网站

1. 在 设置 → 发布 部分，输入 公共 URL（唯一别名，例如 my-bakery）。你的站点将在 /sites/my-bakery/ 可用。
2. 选择 发布可见性：
   • 公开 — 列在 /sites/ 目录中，任何人都可以找到它
   • 未列出 — 仅通过直接 URL 访问，不在目录中列出
   • 组 — 仅对选定联系组的成员可访问
3. 点击 发布。修订快照将自动保存。
4. 要将你的网站下线，请点击 取消发布。

联系消息

当有人提交你的联系表单时，消息会出现在 仪表板 → 你的网站 → 消息 中。

每条消息都有一个状态你可以更新：

• 新 → 已读 → 已回复 → 已归档

点击发件人的电子邮件以回复（打开你的邮件客户端并预填地址）。

修订历史

每次点击 发布 时，OrbitingFox 会保存你整个网站的快照。 访问 版本（顶部栏按钮）以浏览快照。

• 每张卡片显示日期、时间和当时页面及块的摘要。
• 点击 恢复此版本 以回滚。确认对话框警告你更改是立即生效的。
• 将 ZIP 导入现有网站也会创建一个前后修订对。

复制网站

在仪表板上，点击网站旁的  菜单 → 复制。 将创建一个完整的副本（所有页面、块、设置、图像），具有新的内部别名。 公共 URL 不会被复制 — 你必须设置一个新的。

ZIP 导出、导入与 VSCode 工作流

导出现有网站

构建器顶部栏 →  导出 ZIP。该 ZIP 包含：

• site.json — 所有你的页面、块和设置以可读格式
• images/ 和 files/ — 所有上传的媒体
• README.md — 用户和 AI 助手的逐步指南
• AI_CONTEXT.md — AI 代理和开发者的完整技术参考

下载空白的初始模板

仪表板 →  初始模板。相同的 ZIP 格式，预填具有首页（英雄块）和联系页（表单块）。如果你希望在 VSCode 中从零开始设计，请从这里开始。

在 VSCode 中与 AI 编辑

1. 解压 → 在 VSCode 中打开文件夹。
2. 告诉 AI 助手：“首先阅读 AI_CONTEXT.md，然后帮助我创建网站。”
3. 用简单的英语描述更改。AI 将为你编辑 site.json。
4. 重新打包并上传。

重新上传（导入）

仪表板 →  导入 ZIP。

• 保持下拉菜单为空 → 创建一个 新草稿网站。
• 从下拉菜单中选择现有网站 → 替换该网站的内容 并自动保存修订，以便你可以回滚。

不导入的内容

• 公共 URL — 你必须设置自己的 URL
• 发布状态 — 总是作为私有草稿开始
• 联系消息 — 保留在原始服务器上
• 组限制 — 组是特定于服务器的

安全性

OrbitingFox 会扫描每个上传的 ZIP 以检查不安全内容。被拒绝的 ZIP 将附有一条简单的英文解释说明为何它们被阻止（例如，“检测到不安全的 HTML”，“不允许的文件类型”）。

注意（2026-08-17） — 与平台设计系统不同。 上述颜色设置是 每个网站（或每个项目）由创建该网站的用户拥有的设置。它们不是平台范围内的视觉标准。平台的颜色、文本大小和组件位于设计系统中 — 请参阅 管理员 → 设计系统 和 docs/design/DESIGN.md — 并在 外观 中全局设置。