要实现QoderWake本地配置自动同步至云端，需配置GitHub Actions监听文件变更、封装自定义Action或通过Webhook代理跨平台同步。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在QoderWake中完成本地配置修改，但希望这些变更自动同步至云端知识图谱，则可能是由于GitHub Actions未正确触发或工作流未绑定目标仓库。以下是实现配置自动上传的步骤：
一、配置GitHub Actions工作流以监听配置变更
该方式通过监听特定文件路径的推送事件，确保每次修改.qoder/config.yaml或类似配置文件后立即触发上传流程，避免手动干预导致的知识断连。
1、在项目根目录创建.github/workflows/qoder-sync.yml文件。
2、写入以下YAML内容：on:push:paths:- '.qoder/config.yaml'- 'src/**/config/*.json'。
3、在jobs段中定义upload-job，使用actions/checkout@v4拉取最新代码。
4、添加步骤调用qoderwake sync --mode=cloud --config=.qoder/config.yaml，需提前将QODER_API_KEY设为仓库Secrets。
二、使用自定义Action封装QoderWake同步逻辑
该方式将同步命令封装为可复用的GitHub Action，便于多项目统一维护版本与权限策略，同时支持参数化控制上传范围与重试机制。
1、在项目中新建/.github/actions/qoder-cloud-sync/action.yml文件。
生成周报：读取本机 Git 仓库最近一周的提交记录，按项目分类提炼总结，生成标准周报格式，通过微信推送并返回给用户。触发词：周报、weekly report、git总结、提交记录总结、工作周报。
2、定义inputs字段：config-path（默认值.qoder/config.yaml）、retry-attempts（默认值3）、dry-run（默认false）。
3、在runs段中执行docker run -e QODER_API_KEY=${{ secrets.QODER_API_KEY }} -v $(pwd):/workspace qoder/sync-cli:latest --config ${{ inputs.config-path }} --retry ${{ inputs.retry-attempts }}。
4、在主工作流中引用该Action：uses: ./github/actions/qoder-cloud-sync，并传入必要参数。
三、通过Webhook代理实现跨平台配置同步
该方式绕过GitHub原生CI限制，利用QoderWake提供的Webhook接收端，在非GitHub托管环境（如GitLab私有实例）中也能完成配置变更捕获与云端上传。
1、登录QoderWake控制台，在「Sync Settings」中启用「External Webhook Mode」，获取endpoint URL与signature_key。
2、在GitLab项目Settings → Webhooks中添加新hook，URL填写上一步获取的endpoint，Secret Token填入signature_key。
3、勾选Push events与Tag push events，并启用SSL verification。
4、在QoderWake侧配置payload解析规则：match: $.ref == 'refs/heads/main' && $.commits[0].modified contains '.qoder/config.yaml'。
