GitHub 应用
把你的代码仓库连接到 Buda 的开发者门户，以导入技能和智能体，并让应用市场上架内容保持同步。
从你已经在维护的仓库直接发布。 只需连接一次 Buda GitHub 应用，把它指向某个仓库，Buda 就会把其中的技能和智能体作为应用市场上架内容导入——并在源代码变更时自动重新同步。无需复制粘贴，也无需手动上传。
安装 GitHub 应用
打开开发者门户
进入 开发者门户 并打开 Repos 标签页。如果尚未连接任何 GitHub 安装，系统会提示你连接一个。
在 GitHub 上授权
Buda 会把你引导到 GitHub 的应用安装界面。选择账户或组织，并授予访问 全部仓库 或仅 选定仓库（你想从中发布的仓库）的权限。
返回 Buda
GitHub 会跳转回开发者门户（/developer/repos），Buda 将该安装记录到你的账户名下。这一步只需做一次——后续你添加的每个仓库都会复用此连接。
该连接是按用户绑定的。在 GitHub 上重新安装会自动替换之前的安装。
导入仓库
应用连接好后，通过 GitHub URL 和一段简短描述来添加仓库：
- 在 Repos 中，选择 Add repo。
- 粘贴仓库 URL（例如
https://github.com/your-org/your-skills）和一段描述。 - 保存。仓库会以 pending 状态创建，Buda 自动启动首次同步。
Buda 会读取仓库中的技能和智能体，并将它们转换为应用市场中的公司和上架内容。Repos 视图会显示每个仓库生成了多少家公司和多少条上架内容。
同步更新
当你向已连接的仓库推送变更后，在该仓库上点击 Sync 即可重新导入：
- 新增和有变化的技能/智能体会被重新导入。
- 从仓库中移除的条目会从应用市场 下架，同步结果会报告下架了多少条。
同步使用你的 GitHub 安装令牌，因此它可以读取你授权访问的私有仓库。
故障排查
- 没有列出任何仓库。 请确认安装已授予对你预期仓库的访问权限。在 GitHub 上打开该应用的设置，添加缺失的仓库，然后返回并同步。
- 连接无声中断。 如果 GitHub 对你的安装返回 404（例如应用被卸载或访问权限被撤销），Buda 会清除失效的安装并显示一个空的仓库列表。请从 Repos 标签页重新连接。
- 某条上架内容没有更新。 再次运行 Sync——创建后导入是在后台进行的，因此首次失败的导入可以通过一次显式的重新同步来修复。
- 已移除的条目仍在列表中。 同步该仓库；已移除的条目会在下一次成功同步时下架。
为单个智能体连接 GitHub
以上内容说的是开发者门户使用的按用户连接。智能体还有一套独立的按智能体GitHub 连接，与应用市场发布无关——它让智能体的云电脑在聊天和任务执行期间可以读取（并根据你授予的权限进行推送）真实的代码仓库。
- 连接方式——打开该智能体，然后：在聊天输入框的 + 菜单中依次选择 Integration（集成）→ OAuth → GitHub（未连接时显示 Install GitHub App）；或者打开该智能体的 Integrations（集成） 设置，点击 GitHub 旁的 Connect。两条路径都会把你带到 GitHub 的安装界面，选择账户/组织和要授权的仓库。
- 整个会话共享——这个安装绑定在智能体上，而不是绑定在你个人身上。所有能与该智能体聊天的人都使用同一份 GitHub 访问权限；但只有该智能体的编辑者（或所有者）才能连接、替换或断开它。
- 每个智能体只有一个安装——重新连接会替换该智能体之前连接的安装。
- 断开连接——在该智能体的 Integrations 设置中，打开 GitHub 行的菜单并选择 Disconnect。这只会在 Buda 这边忘记该安装——GitHub 应用本身仍会保持安装状态，直到你在 GitHub 上移除它。断开时没有二次确认，会立即让所有正在与该智能体聊天的人失去访问权限。
这个智能体级别的连接与上文的按用户连接完全独立——不同的安装、不同的数据表、不同的用途。为某个智能体连接 GitHub 并不会给你开发者门户/应用市场的发布权限，反之，连接开发者门户也不会给任何智能体在聊天中的仓库访问权限。
智能体如何使用这个连接来操作真实仓库，参见 Git。