程式碼託管平臺
在應用裡瀏覽、建立、審閱和合並拉取請求(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 返回空值),會允許你明確發起一次合併請求,且只發一次。
應用不會自動評論、批准或合併任何請求。每寫一次都要你點一次。
最後更新於