Web Deploy

核心用法

web-deploy 是一个综合性的 Web 部署技能，涵盖从本地开发预览到多平台生产部署的完整工作流。主要功能包括：

1. 本地预览：支持静态站点（http-server）、Next.js、FastAPI、Vite 等主流框架的本地开发与生产预览
2. 多平台部署：

3. 部署管理：环境变量配置、域名绑定、一键回滚、日志查看
4. 质量保障：内置预部署检查清单（构建、测试、SEO、性能、安全）

• Vercel：前端框架（Next.js/React）、静态站点、Serverless 函数的首选
• Railway：后端 API、数据库、长运行进程、Docker 容器
• GitHub Pages：文档、简单静态站点
• Canvas (clawdbot)：本地工作空间部署

显著优点

• 全栈覆盖：前后端、静态/动态、容器化场景一应俱全
• 平台原生 CLI：深度集成各平台官方工具链，功能完整
• 工作流标准化：从本地预览到生产回滚形成闭环
• 开箱即用：主流框架（Next.js/Vite/FastAPI）配置简洁，零配置即可部署

潜在缺点/局限性

• 平台依赖性强：需分别学习 Vercel、Railway 等平台的特有概念与限制
• 无自建服务器方案：未涵盖传统 VPS/裸金属服务器的部署流程
• Canvas 部署说明简略：本地工作空间部署仅一行命令，缺乏权限、服务管理等细节
• 无 CI/CD 集成：未涉及 GitHub Actions 等自动化流水线配置

适合人群

• 前端/全栈开发者需快速将项目上线
• 初创团队寻找免费/低成本的托管方案
• 需要同时管理前后端部署的独立开发者
• 使用 Next.js + FastAPI 技术栈的开发者（完美匹配）

常规风险

• 环境变量泄露风险：.env 文件误提交至 Git（需严格遵循检查清单）
• 平台锁定：深度使用 Vercel/Railway 特有功能后迁移成本较高
• Serverless 限制：Vercel 函数有执行时长/内存限制，不适合计算密集型任务
• Railway 成本：免费额度有限，数据库+后端组合易触发付费
• 域名/DNS 配置错误：手动 DNS 记录配置不当导致服务中断

核心用法

web-deploy 是一个面向全栈开发者的部署指南文档，专注于将网站、Web 应用和 API 快速推向生产环境。内容涵盖四大主流部署目标：

• Vercel：Next.js、React SPA 和静态站点的首选，支持服务端渲染和无服务器函数
• Railway：后端 API、数据库和长运行进程的理想平台，提供原生 PostgreSQL 等插件
• GitHub Pages：适合文档站点和简单静态页面，零成本托管
• Canvas (Clawdbot)：本地工作空间部署方案

Skill 提供完整的本地预览工作流（http-server、Vite、FastAPI 等）以及生产部署前的 10 项检查清单，包括构建验证、环境变量管理、SEO 基础配置和性能优化。同时支持一键回滚和自定义域名绑定。

显著优点

1. 零学习成本：纯 Markdown 文档，无需理解复杂配置即可按步骤执行
2. 平台覆盖全：从免费静态托管到企业级容器部署，覆盖常见场景
3. 实用 checklist：预部署检查清单显著降低上线事故概率
4. 安全透明：无实际代码执行，仅输出标准化 CLI 命令

局限与风险

• 无自动化能力：需手动复制粘贴命令，无法一键完成部署
• 平台依赖性强：命令示例随 Vercel/Railway CLI 版本迭代可能过期
• T3 来源可信度：社区项目，建议结合官方文档交叉验证

适合人群

前端开发者、全栈工程师、独立开发者、技术文档作者，尤其适合需要快速对比多平台部署方案的团队。

常规风险提示

• 生产部署操作不可逆，建议先在预览环境验证
• 涉及第三方 CLI 工具（如 npx vercel），需确认安装来源
• 环境变量管理不当可能导致密钥泄露