工程開發
wt avatar

wt

使用 git worktrees 管理隔離的 LlamaFarm 開發環境,實現平行代理程式工作階段與服務測試。

簡介

wt 技能為需要同時執行多個隔離 LlamaFarm 平台的開發人員提供了強大的管理介面。透過利用 git worktrees,此工具可建立完全自主的開發環境,其中每個工作階段都維持其獨立的服務連接埠、資料目錄與背景處理程序。這種架構有效地消除了執行多個代理程式實例時常見的資源競爭與連接埠衝突,是開發複雜功能、測試 RAG 工作流程或管理平行 AI 代理程式工作階段且不中斷主要開發分支的理想解決方案。無論您是在偵錯伺服器、驗證執行階段模型推論,還是測試自訂工具呼叫邏輯,wt 都能確保每個環境都是獨立且可重現的。

  • 自動化生命週期管理:使用簡單的 CLI 指令建立、啟動、停止與刪除工作樹。

  • 確定性網路:自動分配 Server、Designer 與 Runtime 服務的連接埠,防止衝突。

  • 隔離狀態:為每個工作樹配置專屬資料目錄,確保實驗與測試的乾淨度。

  • 診斷工具:內建 doctor 指令,用於排解過時 PID、連接埠繫結錯誤與服務健康檢查。

  • 工作流程優化:與 Git 分支無縫整合,可立即切換不同的功能開發環境。

  • 使用 wt create --go feat/my-feature 從頭初始化一個功能完整、隔離的工作空間。

  • 使用 wt list 監控作用中的服務,查看所有當前工作樹的連接埠對映與運作狀態。

  • 利用 wt logs 針對 rag、runtime 或 server 等特定組件進行目標偵錯,避免日誌混雜。

  • 請務必呼叫 wt gc 對孤立的資料目錄執行垃圾回收並清除過時的工作樹,以維護主機系統效能。

  • 請注意 wt 依賴本機連接埠分配(通常從 14345+偏移量開始);請確保您的環境允許指定範圍內的動態連接埠繫結。

  • 此技能專為 LlamaFarm 開發而優化,利用底層 Git worktree 結構將不同的分支映射到同一個儲存庫根目錄。

倉庫統計

Star 數
822
Fork 數
56
Open Issue 數
60
主要語言
Python
預設分支
main
同步狀態
閒置
最近同步時間
2026年5月3日 上午06:02
在 GitHub 查看