---
name: deploy-flowinsight
description: FlowInsight 项目一键构建部署到 Cloudflare Pages。当用户说"部署 FlowInsight"、"把项目部署到线上"、"发布到 Cloudflare"、"build and deploy"、"重新部署"时使用此 skill。面向无技术背景用户，自动检测并安装所有环境（Node.js、npm、wrangler），零配置完成部署。适用于 Next.js 14 + 静态导出 + Cloudflare Pages 的部署场景。
keywords: flowinsight, cloudflare, 部署, wrangler, nextjs, 构建, 发布, 零配置, 自动安装
---

# FlowInsight 零配置部署 Skill

## 目标用户

**完全无技术背景**，什么都没有：没有 Node.js、npm、wrangler、Cloudflare 账号，只想把项目发到线上分享。

---

## Phase 1: 环境检测与自动安装

### 1.1 检测 Node.js

```bash
node --version
```

**如果没有安装**:
- Windows: 下载官方安装包并引导安装：https://nodejs.org/
- 安装完成后重启终端

### 1.2 检测 npm

```bash
npm --version
```

Node.js 自带 npm，通常无需单独安装。

### 1.3 检测 wrangler CLI

```bash
npx wrangler --version
```

**如果没有安装**:

```bash
npm install -g wrangler
```

### 1.4 检测 Cloudflare 登录状态

```bash
npx wrangler whoami
```

**如果未登录**:

```bash
npx wrangler login
```

自动打开浏览器，用户点击"Authorize"，返回终端继续。

---

## Phase 2: 项目依赖安装

进入项目目录并安装依赖：

```bash
cd /Users/fengzhouchong.fzc/Desktop/process-mining-app
npm install
```

**常见问题**:
- 网络慢：`npm config set registry https://registry.npmmirror.com`
- 权限错误：Windows 以管理员权限运行终端

---

## Phase 3: 构建项目

```bash
npm run build
```

**成功标志**:
```
✓ Compiled successfully
✓ Generating static pages (5/5)
✓ Finalizing page optimization
```

**如果失败**：检查语法错误或 `next.config.js` 配置，修复后重新 build。

---

## Phase 4: 部署到 Cloudflare Pages

```bash
npx wrangler pages deploy dist --project-name=flowinsight --branch=main
```

**首次部署**：自动创建项目 `flowinsight`，生成子域名如 `https://xxxx.flowinsight.pages.dev`

**成功输出示例**:
```
✨ Compiled Worker successfully
✨ Success! Uploaded 5 files
🌎 Deploying...
✨ Deployment complete! Take a peek over at https://a1b2c3d4.flowinsight.pages.dev
```

---

## Phase 5: 验证与交付

1. 打开部署地址测试
2. 复制链接分享给用户
3. 说明：链接永久有效，重新部署会生成新链接

---

## 用户交互话术

- **开始**："我来帮你把 FlowInsight 部署到线上。首先检测一下环境..."
- **缺少 Node.js**："检测到没有安装 Node.js，这是运行项目必需的。我来帮你安装..."
- **需要登录**："需要登录 Cloudflare 账号，我会打开浏览器，你点击'Authorize'授权即可。"
- **完成**："部署完成！访问地址：https://xxxx.flowinsight.pages.dev 这个链接可以分享给任何人。"

---

## 故障排查速查

| 问题 | 解决 |
|------|------|
| "command not found: node" | 安装 Node.js |
| "Cannot find module" | 运行 `npm install` |
| "Failed to authenticate" | 运行 `npx wrangler login` |
| "You must be logged in" | 重新登录 Cloudflare |
| "Build failed" | 检查代码错误，修复后重试 |
| "Permission denied" | Windows 用管理员权限运行终端 |
