拉取請求和討論

Hub 的拉取請求和討論允許使用者對倉庫進行社群貢獻。拉取請求和討論對所有倉庫型別都以相同的方式工作。

從高層次來看，目標是構建一個比其他 Git 主機（如 GitHub）更簡單的拉取請求和議題版本。

• 不涉及分支：貢獻者直接將內容推送到源倉庫上的一個特殊 `ref` 分支。
• 討論和拉取請求之間沒有嚴格區分：它們本質上是相同的，因此顯示在相同的列表中。
• 它們是為機器學習（即模型/資料集/Spaces 倉庫）而非任意倉庫而精簡的。

注意，拉取請求和討論可以在倉庫設定中啟用或停用。

列表

透過進入任何倉庫的社群選項卡，您可以檢視所有討論和拉取請求。您還可以篩選，僅檢視未解決的。

檢視

討論頁面允許您檢視不同使用者的評論。如果是拉取請求，您可以透過“檔案已更改”選項卡檢視所有更改。

編輯討論/拉取請求標題

如果您發起了 PR 或討論，是倉庫的作者，或者對倉庫有寫入許可權，則可以透過單擊鉛筆按鈕編輯討論標題。

置頂討論/拉取請求

如果您對倉庫有寫入許可權，您可以置頂討論和拉取請求。置頂的討論將顯示在所有討論的頂部。

鎖定討論/拉取請求

如果您對倉庫有寫入許可權，則可以鎖定討論或拉取請求。討論一旦鎖定，之前的評論仍然可見，但使用者將無法新增新評論。

評論編輯和稽核

如果您撰寫了評論或對倉庫擁有寫入許可權，則可以從評論框右上角的上下文選單中編輯評論內容。

評論編輯後，評論上方會出現一個新連結。此連結顯示編輯歷史記錄。

您也可以隱藏評論。隱藏評論是不可逆的，並且沒有人能夠再看到其內容或編輯它。

另請閱讀稽核，瞭解如何舉報不當評論。

我可以在評論和討論中使用 Markdown 和 LaTeX 嗎？

是的！您可以使用 Markdown 為您的評論新增格式。此外，您還可以使用 LaTeX 進行數學排版，您的公式將在 Markdown 解析之前透過 KaTeX 渲染。

對於 LaTeX 方程式，您必須使用以下分隔符

• $$ ... $$ 用於顯示模式
• \\(...\\) 用於行內模式（斜槓和括號之間沒有空格）。

如何本地管理拉取請求？

假設您的 PR 編號是 42。

git fetch origin refs/pr/42:pr/42
git checkout pr/42
# Do your changes
git add .
git commit -m "Add your change"
git push origin pr/42:refs/pr/42

草稿模式

在“高階模式”中從頭開始建立新的拉取請求時，草稿模式是預設狀態。在此狀態下，其他貢獻者知道您的拉取請求正在進行中，無法合併。當您的分支準備就緒時，只需點選“釋出”按鈕即可將拉取請求狀態更改為“開放”。請注意，一旦釋出，就無法返回草稿模式。

拉取請求高階用法

更改儲存在 Git 倉庫的何處？

我們的拉取請求不使用分支和派生，而是使用直接儲存在源倉庫上的自定義“分支”，稱為 `refs`。

Git References 是 Git 內部機制，它已經儲存了標籤和分支。

使用自定義引用（例如 `refs/pr/42`）而不是分支的優勢在於，克隆倉庫的人（包括倉庫“所有者”）預設不會拉取它們，但它們仍然可以按需拉取。

拉取所有拉取請求：面向 Git 大師 🧙‍♀️

您可以調整本地 refspec 來拉取所有拉取請求。

1. 拉取

git fetch origin refs/pr/*:refs/remotes/origin/pr/*

2. 建立一個跟蹤引用的本地分支

git checkout pr/{PR_NUMBER}
# for example: git checkout pr/42

3. 如果您進行了本地更改，則推送到 PR 引用

git push origin pr/{PR_NUMBER}:refs/pr/{PR_NUMBER}
# for example: git push origin pr/42:refs/pr/42