你的第一个站点

本演练比 快速入门 更深入。我们连接一个存储库，查看 Showly 生成的站点清单，直接在编辑器中进行更改，然后发布。

连接存储库

在工作区主页点击连接站点，然后在 GitHub App 对话框中选择：

• 拥有存储库的组织或个人帐户
• 您要连接的存储库

GitHub App 会请求对所选仓库的内容：读写权限。GitHub 在仓库级别 授予该权限，而不是按分支授权。Showly 的产品策略只允许向 showly/* 前缀的分支提交，不会推送到默认分支。

授权后，存储库将显示在您的工作区中，状态为导入。

查看站点清单

导入流程会在工作区中生成 showly.json。这是自动检测得到的初始配置： Showly 检查仓库后给出建议值，你可以查看并覆盖任何字段。示例：

{
  "rootDirectory": ".",
  "runtime": "node",
  "runtimeVersion": "22",
  "packageManager": "pnpm",
  "installCommand": "pnpm install",
  "buildCommand": "pnpm build",
  "output": {
    "directory": ".next"
  }
}

框架由 Showly 自动检测，支持 Astro、Vite、Next.js 静态导出和纯静态 HTML，因此不需要在清单中手动设置。

站点清单是每次构建和智能体读取站点上下文时的权威配置。仓库的构建 方式发生变化后，请同步更新清单。完整结构和字段见 站点清单。

设置环境变量

打开站点的环境变量面板，设置构建和运行时所需的变量。Showly 不会从仓库中读取密钥；你可以分别为 preview 和 production 配置不同的值。

在编辑器中进行更改

Showly 编辑器在文件树旁边打开一个聊天面板。尝试：

添加一条带有简短简介的新路线 /about。

智能体会返回变更计划并列出待创建的文件。点击应用计划后， Showly 会在隔离工作区应用补丁、构建并生成预览。

构建状态依次经过 queued → building → ready，常见的小改动通常 不到一分钟。状态到达 ready 后，预览 URL 会显示在预览面板中。 如果状态变为 failed，展开部署读取构建日志，修复问题（常见原因是 清单中的构建命令或运行时设置）后重试。

发布

在版本面板中选择要发布的 ready 预览。发布流程不要求预先注册 OTP/MFA。

谁可以批准取决于工作区策略。启用审批工作流时，发布请求需要 owner 或 admin 批准，且请求者不能批准自己的请求。未启用第二位 审批人策略时，可直接点击发布，或使用智能体的两步 publish_site 确认。

你刚刚完成了什么

• GitHub 导入 → 站点清单
• 每个环境的环境变量
• 聊天 → 变更计划 → 补丁 → 预览
• 审批 → 生产发布

这就是整个发布循环。 Showly 中的每个后续工作流程都是同一路径的变体。