GitHub 倉庫處理
基本用法
處理公共倉庫:
bash
# 使用完整 URL
repomix --remote https://github.com/user/repo
# 使用 GitHub 簡寫
repomix --remote user/repo你也可以直接傳入 owner/repo 簡寫,而無需 --remote:
bash
repomix yamadashy/repomix由於 owner/repo 看起來也像相對本機路徑,因此只有當不存在同名的本機檔案或目錄、且該儲存庫在 GitHub 上可存取時,Repomix 才會將其視為遠端儲存庫。已存在的本機路徑一律優先;若要強制將 owner/repo 形式的路徑作為本機路徑處理,請在前面加上 ./(例如 repomix ./owner/repo)。如果參數符合該格式但儲存庫無法存取(例如私有儲存庫或拼字錯誤),Repomix 會回退為將其作為本機路徑處理。
分支和提交選擇
bash
# 指定分支
repomix --remote user/repo --remote-branch main
# 指定標籤
repomix --remote user/repo --remote-branch v1.0.0
# 指定提交哈希
repomix --remote user/repo --remote-branch 935b695系統要求
- 必須安裝 Git
- 需要網絡連接
- 需要倉庫的讀取權限
輸出控制
bash
# 自定義輸出位置
repomix --remote user/repo -o custom-output.xml
# 使用 XML 格式
repomix --remote user/repo --style xml
# 移除註釋
repomix --remote user/repo --remove-commentsDocker 使用方法
bash
# 在當前目錄處理並輸出
docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix \
--remote user/repo
# 輸出到指定目錄
docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix \
--remote user/repo安全性
基於安全考量,遠端倉庫中的設定檔(repomix.config.*)預設不會被載入。這可以防止不受信任的倉庫透過 repomix.config.ts 等設定檔執行程式碼。
您的全域設定和 CLI 選項仍然會正常生效。
如需信任遠端倉庫的設定:
bash
# 使用 CLI 旗標
repomix --remote user/repo --remote-trust-config
# 使用環境變數
REPOMIX_REMOTE_TRUST_CONFIG=true repomix --remote user/repo在 --remote 模式下使用 --config 時,必須指定絕對路徑:
bash
repomix --remote user/repo --config /home/user/repomix.config.json常見問題
訪問問題
- 確保倉庫是公開的
- 檢查 Git 是否已安裝
- 驗證網絡連接
大型倉庫處理
- 使用
--include選擇特定路徑 - 啟用
--remove-comments - 分開處理不同分支