核心用法
AppDeploy 是一个面向 Claude Code 用户的全栈 Web 应用部署技能，通过 HTTP API 实现从本地代码到在线服务的完整交付流程。用户无需手动配置服务器或 CI/CD 管道，仅需通过 JSON-RPC 调用即可完成部署。
标准工作流：
1. 调用 get_deploy_instructions 获取部署约束与框架规则
2. 根据应用类型选择模板（html-static / react-vite / nextjs-static）
3. 调用 deploy_app 提交代码，支持增量更新与版本回滚
4. 通过 get_app_status 实时监控构建状态与运行时错误日志
核心能力覆盖：
- 前端架构：纯静态 HTML、React SPA（Vite）、Next.js SSG
- 后端服务：内置 API 路由、身份验证、实时通信、定时任务
- 基础设施：托管数据库、对象存储、AI 推理接口自动集成
显著优点
- 零配置部署：无需 Dockerfile、nginx 配置或云厂商账户，API 调用即完成资源分配与域名绑定
- 智能模板系统：三种前端模板预置最佳实践，自动处理依赖安装与构建优化
- 全生命周期管理：支持版本快照（
get_app_versions）、代码级调试（src_grep/src_read）、一键回滚 - 实时可观测性：内置前端网络错误捕获与后端日志流，无需额外接入 APM
潜在局限
- 供应商锁定：深度绑定 AppDeploy 托管平台，无法导出至 AWS/Azure/GCP 原生环境
- 模板约束：仅支持三种前端框架，复杂自定义 Webpack/Vite 配置可能受限
- 调试间接性：线上问题需通过
src_read远程读取源码，本地复现环境缺失 - API 密钥管理：首次使用需手动保存
ak_密钥，无 OAuth 或密钥轮换机制
适合人群
- 快速验证产品原型的独立开发者与初创团队
- 需要为 Demo 或内部工具快速生成公网 URL 的技术人员
- 希望跳过 DevOps 学习曲线的全栈新手
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 密钥泄露 | `.appdeploy` 文件误提交至 Git | 技能内置 `.gitignore` 提醒，建议配合 Git Hooks 二次校验 |
| 版本冲突 | 多人协作时 `app_id` 误操作覆盖他人部署 | 团队约定 `app_name` 命名空间，生产环境禁用 `app_id: null` 强制新建 |
| 资源滥用 | 定时任务配置不当导致无限循环扣费 | 部署前必须通过 `get_deploy_instructions` 确认配额限制 |
| 数据残留 | 删除应用（`delete_app`）后数据库快照保留策略不明 | 敏感业务部署前确认平台数据删除 SLA |