Skip to Content
文件程式碼託管平台

代碼託管平台

在應用裏瀏覽、創建、審閲和合並拉取請求(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 返回空值),會允許你明確發起一次合併請求,且只發一次。

應用不會自動評論、批准或合併任何請求。每寫一次都要你點一次。

最後更新於