应用部署服务

技能简介

AppDeploy 提供完整的 Web 应用托管能力，支持前端静态页面、React 单页应用、Next.js 多页站点以及带后端 API 的全栈项目。通过 HTTP API 调用完成注册、部署、状态查询和版本管理，最终获得可公开访问的 URL。

业务背景

AppDeploy 帮助业务团队快速上线 Web 应用，无需关心服务器配置。无论是营销落地页、内部数据仪表盘还是带数据库的完整业务系统，都能一键部署并获取公开访问地址。支持版本回滚和实时日志查看，让产品迭代更可控，故障排查更高效。

落地案例：某运营团队需要发布活动报名页面：选择 frontend-only 类型和 html-static 模板，调用 get_deploy_instructions 确认约束后，通过 deploy_app 提交页面代码文件，轮询状态至 ready 即可获得正式 URL。若后续需修改表单字段，使用相同 app_id 以 diff 格式提交变更，避免重新上传全部代码。

能做什么

• 部署纯前端静态网站（HTML/CSS/JS）
• 发布 React Vite 项目（仪表盘、小游戏等 SPA）
• 托管 Next.js 静态生成站点（多页面应用）
• 构建含后端 API 和数据库的全栈应用
• 查看实时构建日志与 QA 快照诊断问题
• 管理多版本回滚与永久删除应用

使用说明

首次安装配置：

1. 检查项目根目录是否存在 .appdeploy 文件且包含有效 api_key
2. 若无密钥，执行注册命令获取：
   curl -X POST https://api-v2.appdeploy.ai/mcp/api-key -H "Content-Type: application/json" -d '{"client_name": "claude-code"}'
3. 保存响应中的 api_key 到 .appdeploy 文件：
   {"api_key": "ak_...", "endpoint": "https://api-v2.appdeploy.ai/mcp"}
4. 将 .appdeploy 加入 .gitignore 防止泄露

部署工作流：

1. 调用 get_deploy_instructions 获取部署约束（必须首先执行）
2. 调用 get_app_template 获取选定技术栈的基础模板
3. 调用 deploy_app 提交代码文件（新应用传 null 作为 app_id）
4. 调用 get_app_status 轮询构建状态直至就绪或失败
5. 使用 get_apps 查看所有已部署应用列表

JSON-RPC 调用示例：

curl -X POST {endpoint} \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "deploy_app",
      "arguments": { ... }
    }
  }'

输入与输出

见下方输入与输出表格。

风险提示

• API 密钥仅创建时显示一次，丢失后需重新注册生成
• delete_app 操作不可逆，删除后无法恢复数据
• 部署前必须调用 get_deploy_instructions，否则可能因违反约束导致构建失败
• 更新现有应用时需使用 diff 格式提交变更，避免全量覆盖
• 构建过程中产生的错误日志可能暴露代码路径信息

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/avimak/appdeploy/SKILL.md
来源类型：GitHub 仓库