代碼託管平台
在應用裏瀏覽、創建、審閲和合並拉取請求(PR)與合併請求(MR),支持四家平台:
| 平台 | 説明 |
|---|---|
| GitHub | 完整支持,含草稿、rebase 合併 |
| GitLab | 完整支持,嵌套分組按 owner 路徑處理 |
| Gitea | 完整支持,含草稿、rebase 合併 |
| Bitbucket Cloud | 支持,但不支持草稿與 rebase 合併 |
令牌
訪問令牌按主機保存在系統憑據庫(macOS 鑰匙串 / Windows 憑據管理器 / Linux Secret Service),不寫入設置文件,也不進日誌。
在「設置 → Git → Forge 令牌」裏為某個遠端主機添加、替換或刪除令牌。令牌被拒絕、權限不足或觸發速率限制時,應用會給出對應的提示,而不是籠統的網絡錯誤。
服務商默認按主機名推斷,bitbucket.org 歸到 Bitbucket Cloud;未知主機不會被猜測,而是提示不支持。自建實例可以在同一處按主機指定服務商。
列表
從 ⌘K 命令面板打開「拉取請求」面板,這一步會發起第一次網絡請求。列表每次取 30 條,最多顯示 100 條,底部會説明上限。
每條顯示編號、標題、作者、源分支 → 目標分支、草稿標記與檢查摘要(通過 / 失敗 / 進行中)。檢查查詢失敗時該條標為未知,不影響其他條目。
創建
從當前分支創建:
- 目標默認是主機的默認分支;
- 標題默認取最後一次提交的標題,可修改;
- 草稿選項在 Bitbucket Cloud 上會隱藏,並説明該平台不支持。
倉庫沒有遠程地址時不會進入創建流程,而是提示先添加遠程。
詳情
點開一條請求,看到:
- 描述(超長會截斷);
- 提交列表(最多 100 條);
- 檢查項與瀏覽器鏈接;
- 評審評論(最多 50 條)。
詳情、提交、檢查與評論在同一次請求里加載;某一部分失敗只會加一條警告,不會讓整個面板變成錯誤。
審閲
可以發表評論、批准或請求修改。
- 評論與「請求修改」必須填寫內容,長度上限 8000 字符;
- 批准時內容可選;
- GitHub 與 Gitea 走各自的 reviews API;GitLab 與 Bitbucket Cloud 發佈評論加批准,並明確拒絕「請求修改」,而不是降級成別的動作;
- 已關閉或已合併的請求在寫入前就會被拒絕;
- 請求只發送一次,失敗不會自動重試。
審閲動作會離開本機並出現在服務端,確認框裏會寫清目標請求與動作。
合併
- 合併方式:合併提交、壓縮合並、變基合併;變基僅 GitHub 與 Gitea 支持;
- 可以選擇同時刪除源分支;刪除失敗不會把合併判為失敗;
- 服務端報告有衝突時拒絕合併,並請你先解決;
- 草稿、已關閉、已合併的請求不可合併;
- 服務端不報告可合併狀態時(例如 GitHub 返回空值),會允許你明確發起一次合併請求,且只發一次。
應用不會自動評論、批准或合併任何請求。每寫一次都要你點一次。
最後更新於