工程开发
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 查看