Windows原生如何安装LoopX：PowerShell 7部署步骤与常见坑点清单

Windows原生如何安装LoopXPowerShell 7部署步骤与常见坑点清单【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopxLoopX 是一个面向长程任务的 Agent 控制平面control plane可以统一管理 Codex、Claude Code 等多种 harness 的持久化、受治理工作。本文带你用PowerShell 7 在 Windows 原生环境安装 LoopX从环境自检、两种安装路径到最容易踩的坑点一次讲清楚。先说结论Windows 上有两条安装路径 ️路径适合谁核心方式PyPI 发布包推荐普通用户pip install loopx无需 Git、无需 WSL源码快照安装贡献者 / 需要固定版本的运维git clone后运行scripts/install-windows.ps1无论哪条路径Windows 原生安装都不需要 Bash、POSIX 符号链接或 WSL。两条路径对最终用户的意义不同PyPI 是常规发布的权威渠道快照安装则是刻意选择一个可信 checkout 的不可变快照。部署前 30 秒环境自检清单 ✅安装前请先确认三样东西这是绝大多数失败信息的根源PowerShell 7pwsh安装脚本头部声明了#requires -Version 7.0Windows 自带的 5.1 无法运行Python 3.11安装器会显式校验低于 3.11 直接报错退出Node.js 22.6LoopX 的 Effect Program 运行在受管的 TypeScript 运行时中安装前后都要满足。# 检查 PowerShell 版本应为 7.x $PSVersionTable.PSVersion # 检查可用 Python应包含 3.11 或更高 py --list # 检查 Node.js应为 v22.6.0 或更新 node --version 提示在 Windows 应用商店或 PowerShell Gallery 官方渠道安装 PowerShell 7 即可之后所有命令都在pwsh中执行。最快路径从 PyPI 一条命令装好普通用户这是官方文档推荐的 Windows 原生方式使用 Python 3.11 解释器无需 clone 仓库py -3.11 -m pip install --upgrade loopx loopx workflow-skills --install loopx doctor三条命令各司其职第一条是包事务安装/升级 Python 包本体除标准库外没有额外的 runtime 依赖第二条是激活契约把打包好的 LoopX workflow skills 复制进 Codex skill 目录并写入版本回读第三条是健康自检loopx doctor会报告安装类型、Node 运行时状态ready/missing/unsupported/probe_failed等关键指标。第一次安装完成后务必重启你的 Agent host让它重新加载新的 workflow skills。doctor中运行时显示stopped是健康的表示空闲退出的运行时会随下一个控制平面请求自动拉起。进阶路径install-windows.ps1 源码快照安装贡献者如果你刻意需要基于可信 checkout 的固定版本可以走快照安装。安装入口是仓库中的 scripts/install-windows.ps1其核心逻辑由 loopx/windows_install.py 实现git clone https://gitcode.com/GitHub_Trending/lo/loopx $HOME/loopx Set-Location $HOME/loopx pwsh -NoLogo -NoProfile -File .\scripts\install-windows.ps1 -Python (Get-Command python).Source -AddToUserPath loopx doctor --deep这个安装器做了几件很稳的事先验证后晋升在发布目录中完整跑一遍doctor --deep候选校验全部关键检查项通过后才写入原子的 release 指针默认落位启动器loopx.ps1和版本指针 sidecarloopx-current-release.json默认放入$HOME/.local/bin新 shell 自动发现后续新开的终端通过 sidecar 找到安装不需要额外设置环境变量。常用参数一览 参数作用默认值-Python指定 Python 解释器python-InstallRoot快照安装根目录$HOME/.local/share/loopx-BinDir启动器目录$HOME/.local/bin-SkillsDirworkflow skills 目录$HOME/.codex/skills-SkipSkills跳过 skill 安装其他受管 host 已拥有时关-AddToUserPath将BinDir加入 Windows 用户 PATH关常见坑点清单9 个最容易踩的雷 ⚠️#坑点症状解法1用 Windows PowerShell 5.1 运行脚本报版本不满足 7.0 要求安装 PowerShell 7用pwsh执行2Python 版本低于 3.11Python 3.11 is required报错用py --list确认并指定 3.11 解释器3没加-AddToUserPath装完找不到 loopxloopx不是可识别的命令重新安装时带上-AddToUserPath或手动把$HOME/.local/bin加入 PATH然后重开终端4执行策略拦截脚本提示禁止运行脚本用pwsh -NoProfile -File .\scripts\install-windows.ps1 ...必要时加-ExecutionPolicy Bypass5Node.js 缺失或版本过低doctor 显示missing/unsupported安装 Node.js 22.6运行时是失败关闭设计不会偷偷降级到备用引擎6装完不重启 hostskills 未生效、行为像旧版本安装后重启 Agent host7扩展 post-install 复检失败警告One or more enabled extensions failed post-install doctor revalidation修复对应 provider 后运行loopx extension doctor --all-enabled --execute8手工改 release 指针版本错乱、无法回滚快照版loopx update与自动回滚都是 fail-closed检出目标修订 → 重跑install-windows.ps1→loopx doctor --deep9混用 PyPI 与快照两套安装安装 owner 冲突只保留一个权威安装来源PyPI 装法与快照装法不要在同一机器上叠加 升级提醒对 PyPI 安装loopx update check / plan / apply是渠道感知的升级入口对快照安装升级或回滚一律是检出预期修订 重跑安装器 doctor --deep验证旧版本目录会保留在安装根目录下由你手动清理。卸载与清理干净利落地退出 移除快照安装时先卸载 host 材料再删文件loopx slash-commands --uninstall loopx workflow-skills --uninstall Remove-Item -LiteralPath $HOME/.local/bin/loopx.ps1 -ErrorAction SilentlyContinue Remove-Item -LiteralPath $HOME/.local/bin/loopx-current-release.json -ErrorAction SilentlyContinue Remove-Item -LiteralPath $HOME/.local/share/loopx -Recurse -Force -ErrorAction SilentlyContinue如果安装时使用了-AddToUserPath请再通过 Windows 环境变量界面把对应的BinDir从用户 PATH 中删掉。卸载不会删除项目本地的.loopx/、.codex/goals/或任何证据状态——这些属于你的项目数据。延伸阅读 完整安装指南含 pipx、archive fallback 与回滚细节docs/guides/installing-loopx.mdWindows 安装器实现scripts/install-windows.ps1、loopx/windows_install.pyWindows 启动器与版本指针机制scripts/loopx.ps1装完之后进入你的项目目录执行loopx connectloopx status长程任务的持久化、受治理循环就可以真正跑起来了。【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考