開發者
GitHub 應用
把你的程式碼倉庫連線到 Buda 的開發者門戶,以匯入技能和智慧體,並讓應用市場上架內容保持同步。
從你已經在維護的倉庫直接釋出。 只需連線一次 Buda GitHub 應用,把它指向某個倉庫,Buda 就會把其中的技能和智慧體作為應用市場上架內容匯入——並在原始碼變更時自動重新同步。無需複製貼上,也無需手動上傳。
安裝 GitHub 應用
開啟開發者門戶
進入 開發者門戶 並開啟 Repos 標籤頁。如果尚未連線任何 GitHub 安裝,系統會提示你連線一個。
在 GitHub 上授權
Buda 會把你引導到 GitHub 的應用安裝介面。選擇賬戶或組織,並授予訪問 全部倉庫 或僅 選定倉庫(你想從中釋出的倉庫)的許可權。
返回 Buda
GitHub 會跳轉回開發者門戶(/developer/repos),Buda 將該安裝記錄到你的賬戶名下。這一步只需做一次——後續你新增的每個倉庫都會複用此連線。
該連線是按使用者繫結的。在 GitHub 上重新安裝會自動替換之前的安裝。
匯入倉庫
應用連線好後,通過 GitHub URL 和一段簡短描述來新增倉庫:
- 在 Repos 中,選擇 Add repo。
- 貼上倉庫 URL(例如
https://github.com/your-org/your-skills)和一段描述。 - 儲存。倉庫會以 pending 狀態建立,Buda 自動啟動首次同步。
Buda 會讀取倉庫中的技能和智慧體,並將它們轉換為應用市場中的公司和上架內容。Repos 檢視會顯示每個倉庫生成了多少家公司和多少條上架內容。
同步更新
當你向已連線的倉庫推送變更後,在該倉庫上點選 Sync 即可重新匯入:
- 新增和有變化的技能/智慧體會被重新匯入。
- 從倉庫中移除的條目會從應用市場 下架,同步結果會報告下架了多少條。
同步使用你的 GitHub 安裝令牌,因此它可以讀取你授權訪問的私有倉庫。
故障排查
- 沒有列出任何倉庫。 請確認安裝已授予對你預期倉庫的訪問許可權。在 GitHub 上開啟該應用的設定,新增缺失的倉庫,然後返回並同步。
- 連線無聲中斷。 如果 GitHub 對你的安裝返回 404(例如應用被解除安裝或訪問許可權被撤銷),Buda 會清除失效的安裝並顯示一個空的倉庫列表。請從 Repos 標籤頁重新連線。
- 某條上架內容沒有更新。 再次執行 Sync——建立後匯入是在後臺進行的,因此首次失敗的匯入可以通過一次顯式的重新同步來修復。
- 已移除的條目仍在列表中。 同步該倉庫;已移除的條目會在下一次成功同步時下架。