需将QoderWake与GitHub Actions集成以实现提交即构建部署，共四路径：一、用Webhook触发本地构建；二、Actions调用QoderWake REST API远程构建；三、Actions接管构建产物推送至GitHub Pages；四、SSH远程执行构建脚本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 QoderWake 开发工具时，希望代码提交后自动触发构建与部署流程，则需将其行为与 GitHub Actions 工作流对齐。以下是实现该目标的多种可行路径：
一、通过 GitHub Webhook 触发 QoderWake 构建任务
QoderWake 支持接收外部 HTTP 请求以启动本地构建服务，可将其作为部署流水线的前置执行节点。此方式适用于开发环境快速验证，无需将构建逻辑完全移至云端。
1、在 QoderWake 的设置界面中启用 Webhook 服务，并记录监听地址与认证 Token。
2、登录 GitHub 仓库 Settings → Webhooks → Add webhook。
3、Payload URL 填写为 http://[qoderwake-host]:[port]/webhook/build，Content type 选择 application/json。
4、Secret 字段填入 QoderWake 中配置的 Token 值。
5、选择 Just the push event 作为触发事件，保存配置。
二、利用 GitHub Actions 调用 QoderWake REST API 完成远程构建
当 QoderWake 部署在局域网或私有云环境中时，可通过 GitHub Actions 的 curl 步骤向其暴露的 API 接口发起构建请求。该方法要求 QoderWake 服务具备公网可达性或已配置内网穿透。
1、在 GitHub 仓库中创建 .github/workflows/qoderwake-deploy.yml 文件。
2、在 workflow 文件中定义 job，使用 runs-on: ubuntu-latest。
3、添加 checkout 步骤拉取最新代码。
4、添加 run 步骤执行 curl 命令：curl -X POST "http://[qoderwake-ip]:8080/api/v1/build" -H "Authorization: Bearer ${{ secrets.QODERWAKE_TOKEN }}" -d '{"project":"${{ github.repository }}"}
5、将 QODERWAKE_TOKEN 作为 secret 添加至仓库 Settings → Secrets and variables → Actions。
QoderWake Linux版是阿里推出的生产级数字员工系统，支持Linux环境部署。它作为7×24小时在线的AI员工，具备长期记忆与专业技能（如编程、运维），可自主响应代码审查、告警处理等事件。其核心采用“员工与工位分离”架构，并设置了严格的权限红线，确保持续进化的同时实现安全可控。
三、将 QoderWake 构建产物直接推送至 GitHub Pages 或静态托管服务
QoderWake 在完成本地构建后可生成标准静态资源目录（如 dist/），GitHub Actions 可接管后续发布阶段，将该目录内容推送到 gh-pages 分支或同步至对象存储。
1、确保 QoderWake 构建输出路径固定为 ./dist。
2、在 GitHub Actions 工作流中增加一个 job，使用 actions/checkout@v4 拉取源码。
3、添加自定义步骤运行 QoderWake CLI 命令：qoderwake build --output dist --config ./qoderwake.config.json。
4、使用 JamesIves/github-pages-deploy-action@v4 将 dist 目录部署至 gh-pages 分支。
5、配置 deploy key 并赋予 push 权限，确保 Actions 具备向目标分支写入能力。
四、使用 SSH 连接 QoderWake 所在主机并执行构建脚本
若 QoderWake 安装于 Linux 服务器且支持命令行调用，GitHub Actions 可通过 SSH 登录该主机，直接触发构建流程。该方式规避了 Webhook 安全策略限制，适合高隔离要求场景。
1、在服务器上生成 SSH 密钥对，将公钥添加至 ~/.ssh/authorized_keys。
2、将私钥内容以 base64 编码后存为 GitHub Secret，名称设为 QODERWAKE_SSH_KEY。
3、在 workflow 中添加 ssh-keyscan 步骤获取服务器指纹并缓存。
4、使用 webfactory/ssh-agent@v0.8.0 动作加载私钥。
5、执行远程命令：ssh -o StrictHostKeyChecking=no user@host 'cd /opt/qoderwake && ./bin/qoderwake build --env production'。
