用途:为 Cyrus 配置 GitHub,使其能创建分支、提交和拉取请求(PR),并可选启用对 PR 评论与评审中 @提及的响应。
主要能力:第一部分(出站)配置 GitHub CLI 与 git 身份;第二部分(入站,可选)创建 GitHub App 与 webhook,使 Cyrus 能接收 PR 评论和评审、响应 @提及、处理“changes requested”评审,并支持自动 rebase、合并及基于 CI 失败的自动修复(即将推出)。
使用方式:先检查 gh auth status 与 git config --global user.name/user.email;未认证则运行 gh auth login,未设置则用 git config --global 设置提交身份。启用 webhook 时,需先设置 CYRUS_BASE_URL,构造 manifest JSON,通过本地 HTTP 服务(python3 -m http.server 8976)提交表单创建 GitHub App,用 gh api /app-manifests/<CODE>/conversions 一次性换取凭据,将 GITHUB_WEBHOOK_SECRET、GITHUB_APP_ID、GITHUB_BOT_USERNAME 写入 ~/.cyrus/.env,私钥写入 ~/.cyrus/github-app.pem 并 chmod 600,再安装 App 并记录 installation ID。
限制:禁止对 ~/.cyrus/.env 或 ~/.cyrus/ 内文件使用 Read、Edit、Write 工具,只能用 Bash 命令操作,密钥不得进入对话上下文;conversions 端点仅能调用一次;webhook 需 Cyrus 运行后才响应,设置期间投递失败会自动重试;GitHub @提及自动补全只提示真实用户账号,App bot 名称需手动输入,或创建同名 GitHub 用户作为变通。