git push 都会自动检测变更的 MCP 工具、reward 函数和 rubric —— 无需手动上传。
安装 GitHub App
导航至 Git 设置
前往 platform.osmosis.ai → Settings → Workspace → Git
自动同步的工作原理
连接后，同步过程是自动的：- 您推送代码到仓库（配置为同步的任何分支）
- GitHub 发送 webhook 到 Osmosis 平台
- Osmosis 拉取最新代码并扫描组件
- 组件被部署 —— 工具、reward 函数和 rubric 可用于训练运行
同步的内容
Osmosis 根据必需的文件夹结构发现 MCP 工具、reward 函数和 reward rubric。依赖项从仓库根目录的pyproject.toml 中读取。
同步状态仪表板
连接仓库后，同步仪表板显示：- 最近同步时间 —— 最近一次同步完成的时间
- 同步状态 —— 成功、失败或进行中
- 发现的组件 —— 找到的工具、reward 函数和 rubric 列表
- 同步历史 —— 最近同步事件的日志及详细信息
管理已连接的仓库
在 Settings → Workspace → Git 中：- 查看所有已连接的仓库及其同步状态
- 触发手动同步 —— 如果需要强制重新同步
- 断开仓库连接以停止同步
故障排除
推送后同步未触发
推送后同步未触发
- 验证 Osmosis GitHub App 已安装在该仓库上
- 检查 webhook 是否在 GitHub → Repository Settings → Webhooks 中处于活动状态
- 确保您推送到的是配置为同步的分支
- 尝试从平台仪表板触发手动同步
组件未被发现
组件未被发现
- 确认您的文件夹结构与预期布局匹配
- 检查装饰器是否正确应用（
@mcp.tool()、@osmosis_reward、@osmosis_rubric） - 验证
pyproject.toml列出了所有必需的依赖项 - 查看同步日志中的导入错误
私有仓库访问被拒绝
私有仓库访问被拒绝
- 重新授权 GitHub App 并确保它有权访问该特定仓库
- 在 GitHub → Settings → GitHub Apps → Osmosis 中检查仓库权限
- 对于组织仓库，确保管理员已批准应用安装
同步显示错误
同步显示错误
- 在仪表板上查看同步日志以获取具体错误信息
- 常见问题：
pyproject.toml中缺少依赖项、Python 文件中的语法错误、缺少__init__.py文件 - 推送前在本地测试您的代码：
pip install -e . && python -c "from reward_fn.compute_reward import *"