Origin 整合

Tuist 可以在原生 Cursor Origin 儲存庫的 pull request 上發布建置、測試、預覽和 bundle 報告。它會更新應用程式現有的 Tuist Run Report，而不是為每次上傳發布新評論。

安裝應用程式不會執行建置或測試。你現有的工作流程會繼續將結果上傳到 Tuist，而整合功能會將這些結果帶入你的 pull request。

設定#

Tuist 帳戶的管理員應開啟 Settings → Integrations，在 Origin 卡片中選擇 Install Origin App，並在 Cursor 中批准存取權限。選擇 Tuist 應存取的 Origin 帳戶或命名空間及儲存庫，然後返回 Tuist。此連線屬於 Tuist 帳戶，而非個別專案。

你也可以直接從 Origin 安裝應用程式。批准存取權限後，如有需要請登入 Tuist 並選擇要連線的組織。只有你管理的組織和你的個人帳戶可供選擇。如果只有一個帳戶可用，Tuist 會自動連線而不顯示選擇器。如果你從 Tuist 開始操作，組織已經選定，因此會跳過此步驟。

選擇 Add new project connection 以開啟儲存庫選擇視窗。選擇一個未連線的 Tuist 專案和從已連線的 Origin 帳戶中發現的其中一個儲存庫，然後選擇 Create Connection。如果連線了多個 Origin 帳戶，請先選擇帳戶。只有原生 Origin 儲存庫可供連線。Tuist 會在連線專案前再次驗證 pull request 存取權限，並採用儲存庫的預設分支。

使用 Manage integration 在新分頁中開啟 Cursor 的同意流程，並調整儲存庫存取權限或連線另一個 Origin 帳戶。儲存庫載入失敗時會顯示 Retry，這與成功的空儲存庫清單不同。

使用 帳戶權杖 來驗證結果上傳。

報告與權限#

批准應用程式時，你授予連線儲存庫和發布報告所需的權限：

Tuist 不需要存取你的原始碼或合併 pull request 的權限。

若要將結果與 pull request 關聯，上傳必須包含儲存庫的 Origin clone URL、Git ref 和完整 commit SHA。Tuist 僅在這些資訊識別出當前 head commit 的單一開啟中 pull request 時才會發布報告。已被取代的 commit 結果不會覆蓋當前報告。

Origin 卡片列出專案至儲存庫的連線。在專案連線上選擇 Manage → Remove connection 以停止其報告，而無需解除安裝應用程式。在 Cursor 中解除安裝應用程式以撤銷其存取權限；Tuist 會在處理安裝通知時移除安裝及其專案連線。

自行託管伺服器#

如果你自行託管 Tuist 伺服器，請先為你的部署註冊並設定 Origin 應用程式。遵循 Origin 自行託管說明，然後返回上述設定步驟以連線帳戶和專案。