# UI Blueprint Cloudflare Worker 发布说明

## 当前发布目标

- Cloudflare account: `aa6e4945ef90ff4ac43fc97271b30f51`
- Worker: `proster`
- Worker subdomain: `luxiaoxiao.workers.dev`
- Design URL: `https://proster.luxiaoxiao.workers.dev/ui-redesign/`
- Style reference URL: `https://proster.luxiaoxiao.workers.dev/ui-redesign/style-reference.html`
- Source directory: `docs/`

## 仓库配置

相关文件：

- `wrangler.toml`
- `workers/proster/src/index.js`
- `.github/workflows/deploy-proster-worker.yml`
- `docs/ui-redesign/index.html`

`wrangler.toml` 把 `docs/` 配为 Worker static assets：

```toml
name = "proster"
account_id = "aa6e4945ef90ff4ac43fc97271b30f51"
compatibility_date = "2026-06-11"
main = "workers/proster/src/index.js"

[assets]
directory = "docs"
binding = "ASSETS"
html_handling = "force-trailing-slash"
not_found_handling = "404-page"
```

Worker 入口只做两件事：

1. `/` 跳转到 `/ui-redesign/`。
2. 其他路径交给 `env.ASSETS` 返回静态文件。

## 自动更新流程

1. 修改 `docs/ui-redesign/` 下的 UI 蓝图文件。
2. 提交并推送到 `ui-blueprint` 分支。
3. GitHub Actions 触发 `Deploy Proster Worker`。
4. `cloudflare/wrangler-action@v3` 执行 `wrangler deploy`。
5. Cloudflare Worker 发布新版本。
6. 访问 `https://proster.luxiaoxiao.workers.dev/ui-redesign/` 查看最新页面。

当前 workflow 监听：

- `main`
- `dev`
- `ui-blueprint`

UI 蓝图建议长期在 `ui-blueprint` 分支维护。这个分支和 `main` / `dev` 复用同一个 Worker 与同一个预览地址，不额外创建预览环境。

监听路径：

- `docs/**`
- `workers/proster/**`
- `wrangler.toml`
- `.github/workflows/deploy-proster-worker.yml`

## 需要配置的 GitHub Secret

GitHub 仓库需要添加：

```text
CLOUDFLARE_API_TOKEN
```

Token 权限建议最小化：

- Account: Workers Scripts Edit
- Account: Workers Tail Read（可选，排查日志时再加）

如果只部署这个 worker，优先把 token 限制到当前 Cloudflare account。

## 手动触发

workflow 支持 `workflow_dispatch`。在 GitHub Actions 页面选择 `Deploy Proster Worker` 后，可手动运行一次部署。

## 当前注意事项

当前 Codex 的 Cloudflare 连接器可以访问并管理 Worker，但不会暴露底层 API token，因此不能直接把连接器 token 写入 GitHub Secret。需要在 Cloudflare Dashboard 创建一个 API token，再手动放到 GitHub repository secrets。