> ## Documentation Index
> Fetch the complete documentation index at: https://platform.stepfun.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# steppage：发布静态网站

通过 `steppage` 插件，将本地静态产物发布到 StepFun Page，获取预览链接并管理版本。

## 是什么

`steppage` 通过 MCP 服务器 `steppage-mcp` 提供部署、站点查询、版本管理、上线和回滚等工具。它接收本地目录或 ZIP，用于静态网页托管，不提供应用后端或数据库运行环境。

## 安装前置

在 Step Code 中安装：

```text theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
/plugin install steppage
```

| 项目      | 要求                                          |
| ------- | ------------------------------------------- |
| 凭据      | `STEPFUN_API_KEY` 环境变量；已登录 Step 账号时可由登录凭据兜底 |
| MCP 程序  | `steppage-mcp`；缺少时经官方安装器自动补齐                |
| 生效方式    | 安装后重启 Step Code，并通过 `/mcp` 检查状态             |
| Windows | 暂不自动安装 MCP 程序，可使用 WSL 或手动配置                 |

官方安装器地址为 `https://dl.stepfun.com/steppage-mcp/p/install.sh`，可通过 `STEPCODE_STEPPAGE_INSTALLER_URL` 覆盖。需要手动执行时：

```bash theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
curl -fsSL https://dl.stepfun.com/steppage-mcp/p/install.sh | sh
```

Bash / Zsh 环境变量方式示例：

```bash theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
export STEPFUN_API_KEY="YOUR_STEP_API_KEY"
step
```

将占位符替换为您的密钥，修改环境变量后重新启动 Step Code。独立 CLI 与 MCP 的使用方式见[静态托管 CLI 与 MCP](/docs/zh/guides/developer/page-hosting-cli-mcp)。

## 部署

1. 将前端项目构建为静态产物，如 `dist/`。
2. 检查入口页面、资源路径和产物目录，排除密钥、私有配置和用户数据。
3. 向 Step Code 明确指定要发布的目录及是否上线。
4. 检查工具返回的预览链接、版本和管理入口。

```text theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
把 ./dist 发布成网页，生成预览链接。
```

模型通过 `page_deploy` 将指定目录或 ZIP 发布为站点版本，返回结果自动附管理入口链接。更新已有站点时，请提供明确的站点标识。

<Warning>
  部署会将产物上传到外部托管服务。公开链接可能被他人访问和转发，发布前应检查内容与访问权限。模型返回链接不代表页面功能已验证，请在浏览器中检查页面和静态资源。
</Warning>

## 版本管理与回滚

* 每次部署生成新版本，可查看站点与版本列表。
* `promote` 将指定版本上线，`rollback` 回滚到指定版本。
* 在操作前核对站点和版本标识，操作后重新访问页面验证。
* 删除站点或版本可能不可逆，不应以“清理测试”为由省略确认。

自然语言任务示例：

```text theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
列出这个站点的最近版本和当前线上版本，给出回滚到上一稳定版本的操作计划，先不要执行。
```

## 管理入口

在[站点管理](https://platform.stepfun.com/sites)查看站点、版本和发布状态。托管额度、访问规则和平台限制以[静态托管文档](/docs/zh/guides/page-hosting)及账户实际状态为准，不应将 Step Plan 模型额度直接当作托管额度。

## 下一步

* [插件](/docs/zh/step-code/customization/plugins)
* [MCP](/docs/zh/step-code/customization/mcp)
* [常见使用案例](/docs/zh/step-code/guides/use-cases)