pi-computer-use 控制电脑应用环境变量完全手册PI_COMPUTER_USE_* 全部变量详解【免费下载链接】pi-computer-useLet Pi control your apps on MacOS Windows项目地址: https://gitcode.com/GitHub_Trending/pi/pi-computer-usepi-computer-use让 AI 智能体Pi在 macOS、Windows 与 Linux 上操作你的桌面应用——看窗口、点按钮、敲键盘。除了配置文件它还提供了一整套PI_COMPUTER_USE_*环境变量用于精细控制浏览器、执行策略、无头模式与原生 Helper 的位置。本文把全部变量讲清楚帮你按需切换、快速排错。配置优先级环境变量为何最高pi-computer-use 有三层配置来源优先级从低到高如下全局配置~/.pi/agent/extensions/pi-computer-use.json项目配置.pi/computer-use.json环境变量PI_COMPUTER_USE_*最高覆盖前两者也就是说环境变量是最强的临时开关适合调试与 CI 场景。相关逻辑见 src/config.ts。在 Pi 里运行/computer-use可查看当前生效配置及其来源。浏览器相关变量控制 launch_browser变量取值作用PI_COMPUTER_USE_BROWSER_USE0/1设为0时拒绝操控已知的浏览器窗口Safari、Chrome、Firefox、Arc 等PI_COMPUTER_USE_MANAGED_BROWSERchrome/helium选择launch_browser启动的受管浏览器默认chromePI_COMPUTER_USE_CHROME_EXECUTABLE绝对路径指定 Chrome 可执行文件适用于 AppImage / 便携版 / 非标位置PI_COMPUTER_USE_HELIUM_EXECUTABLE绝对路径指定 Helium 可执行文件launch_browser默认会搜索系统常见安装位置与PATH一旦设置了显式可执行文件变量它即为权威来源且必须指向一个真实的可执行文件。解析逻辑见 src/bridge.ts。执行模式与输入投递最常用变量取值作用PI_COMPUTER_USE_HEADLESS0/1无头/后台模式。设为1时动作必须留在后台禁止前台焦点回退、光标接管与原生指针/键盘事件PI_COMPUTER_USE_CURSOR_OVERLAY0/1macOS 智能体光标覆盖层开关。0实现隐形自动化不移动真实指针、不接收输入PI_COMPUTER_USE_DELIVERY_POLICYdefault/foreground输入投递策略调试用途。foreground强制前台投递PI_COMPUTER_USE_HEADLESS1会禁止前台回退是无头环境的关键。PI_COMPUTER_USE_DELIVERY_POLICY是调试输入正常策略建议写进配置文件而非逐次调用。策略解析见 src/bridge.ts。CDP 浏览器支持Chromium 系进阶PI_COMPUTER_USE_CDP_PORT为 Chrome DevTools Protocol 后端开关用--remote-debugging-port端口启动浏览器并把此变量设为同一端口即可启用。必须搭配非默认的--user-data-dirChrome 136 对默认数据目录会忽略远程调试参数出于安全考虑。launch_browser已自动创建临时独立 CDP 配置文件并绑定随机回环端口。变量未设置时CDP 完全不激活。详见 docs/configuration.md。原生 Helper 路径与构建部署排错用变量适用平台作用PI_COMPUTER_USE_HELPER_APP_PATHmacOS显式指定 Helper.app安装位置PI_COMPUTER_USE_WINDOWS_HELPER_PATHWindows覆盖windows-bridge.exe安装路径PI_COMPUTER_USE_LINUX_HELPER_PATHLinux覆盖linux-bridge安装路径PI_COMPUTER_USE_HELPER_VARIANTmacOSmodern/legacy/auto按系统版本自动选择变体PI_COMPUTER_USE_ALLOW_BUILD通用设为1允许安装时现场构建而非仅用预构建件PI_COMPUTER_USE_ALLOW_ADHOC_UPDATEmacOS设为1允许用 ad-hoc 签名替换已装 Helper本地开发用Helper 路径解析见 src/platform/windows/helper.ts、src/platform/linux/helper.ts 与 src/platform/macos/helper-path.mjs。签名变量macOS 本地开发变量作用PI_COMPUTER_USE_NO_SIGN设为1跳过代码签名等价 ad-hoc 签名PI_COMPUTER_USE_CODESIGN_IDENTITY指定签名 Identity等价--sign-identityPI_COMPUTER_USE_CODESIGN_IDENTIFIER指定签名 Bundle Identifier等价--sign-identifier注意macOS 上 ad-hoc 签名替换已安装 Helper 可能重置辅助功能 / 屏幕录制授权生产环境请使用预签名 Helper 或安装 Developer ID。签名逻辑见 scripts/build-native.mjs。快速排错清单 智能体找不到浏览器 → 设置PI_COMPUTER_USE_CHROME_EXECUTABLE或PI_COMPUTER_USE_HELIUM_EXECUTABLE。需要完全后台、不打扰用户 →PI_COMPUTER_USE_HEADLESS1PI_COMPUTER_USE_CURSOR_OVERLAY0。项目不该碰浏览器 →PI_COMPUTER_USE_BROWSER_USE0。手动 CDP 启动失败 → 检查PI_COMPUTER_USE_CDP_PORT是否与--remote-debugging-port一致且使用了非默认--user-data-dir。完整故障排查见 docs/troubleshooting.md。小结pi-computer-use的PI_COMPUTER_USE_*变量可分为五类浏览器选择、执行模式、CDP 支持、Helper 路径、签名。日常使用只需记住PI_COMPUTER_USE_HEADLESS与PI_COMPUTER_USE_BROWSER_USE两个部署与调试时再按需启用路径覆盖与签名变量。所有变量均覆盖配置文件是临时切换与自动化流水线中最灵活的控制手段。【免费下载链接】pi-computer-useLet Pi control your apps on MacOS Windows项目地址: https://gitcode.com/GitHub_Trending/pi/pi-computer-use创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 pi-computer-use 控制电脑应用环境变量完全手册：PI_COMPUTER_USE_* 全部变量详解
pi-computer-use 控制电脑应用环境变量完全手册PI_COMPUTER_USE_* 全部变量详解【免费下载链接】pi-computer-useLet Pi control your apps on MacOS Windows项目地址: https://gitcode.com/GitHub_Trending/pi/pi-computer-usepi-computer-use让 AI 智能体Pi在 macOS、Windows 与 Linux 上操作你的桌面应用——看窗口、点按钮、敲键盘。除了配置文件它还提供了一整套PI_COMPUTER_USE_*环境变量用于精细控制浏览器、执行策略、无头模式与原生 Helper 的位置。本文把全部变量讲清楚帮你按需切换、快速排错。配置优先级环境变量为何最高pi-computer-use 有三层配置来源优先级从低到高如下全局配置~/.pi/agent/extensions/pi-computer-use.json项目配置.pi/computer-use.json环境变量PI_COMPUTER_USE_*最高覆盖前两者也就是说环境变量是最强的临时开关适合调试与 CI 场景。相关逻辑见 src/config.ts。在 Pi 里运行/computer-use可查看当前生效配置及其来源。浏览器相关变量控制 launch_browser变量取值作用PI_COMPUTER_USE_BROWSER_USE0/1设为0时拒绝操控已知的浏览器窗口Safari、Chrome、Firefox、Arc 等PI_COMPUTER_USE_MANAGED_BROWSERchrome/helium选择launch_browser启动的受管浏览器默认chromePI_COMPUTER_USE_CHROME_EXECUTABLE绝对路径指定 Chrome 可执行文件适用于 AppImage / 便携版 / 非标位置PI_COMPUTER_USE_HELIUM_EXECUTABLE绝对路径指定 Helium 可执行文件launch_browser默认会搜索系统常见安装位置与PATH一旦设置了显式可执行文件变量它即为权威来源且必须指向一个真实的可执行文件。解析逻辑见 src/bridge.ts。执行模式与输入投递最常用变量取值作用PI_COMPUTER_USE_HEADLESS0/1无头/后台模式。设为1时动作必须留在后台禁止前台焦点回退、光标接管与原生指针/键盘事件PI_COMPUTER_USE_CURSOR_OVERLAY0/1macOS 智能体光标覆盖层开关。0实现隐形自动化不移动真实指针、不接收输入PI_COMPUTER_USE_DELIVERY_POLICYdefault/foreground输入投递策略调试用途。foreground强制前台投递PI_COMPUTER_USE_HEADLESS1会禁止前台回退是无头环境的关键。PI_COMPUTER_USE_DELIVERY_POLICY是调试输入正常策略建议写进配置文件而非逐次调用。策略解析见 src/bridge.ts。CDP 浏览器支持Chromium 系进阶PI_COMPUTER_USE_CDP_PORT为 Chrome DevTools Protocol 后端开关用--remote-debugging-port端口启动浏览器并把此变量设为同一端口即可启用。必须搭配非默认的--user-data-dirChrome 136 对默认数据目录会忽略远程调试参数出于安全考虑。launch_browser已自动创建临时独立 CDP 配置文件并绑定随机回环端口。变量未设置时CDP 完全不激活。详见 docs/configuration.md。原生 Helper 路径与构建部署排错用变量适用平台作用PI_COMPUTER_USE_HELPER_APP_PATHmacOS显式指定 Helper.app安装位置PI_COMPUTER_USE_WINDOWS_HELPER_PATHWindows覆盖windows-bridge.exe安装路径PI_COMPUTER_USE_LINUX_HELPER_PATHLinux覆盖linux-bridge安装路径PI_COMPUTER_USE_HELPER_VARIANTmacOSmodern/legacy/auto按系统版本自动选择变体PI_COMPUTER_USE_ALLOW_BUILD通用设为1允许安装时现场构建而非仅用预构建件PI_COMPUTER_USE_ALLOW_ADHOC_UPDATEmacOS设为1允许用 ad-hoc 签名替换已装 Helper本地开发用Helper 路径解析见 src/platform/windows/helper.ts、src/platform/linux/helper.ts 与 src/platform/macos/helper-path.mjs。签名变量macOS 本地开发变量作用PI_COMPUTER_USE_NO_SIGN设为1跳过代码签名等价 ad-hoc 签名PI_COMPUTER_USE_CODESIGN_IDENTITY指定签名 Identity等价--sign-identityPI_COMPUTER_USE_CODESIGN_IDENTIFIER指定签名 Bundle Identifier等价--sign-identifier注意macOS 上 ad-hoc 签名替换已安装 Helper 可能重置辅助功能 / 屏幕录制授权生产环境请使用预签名 Helper 或安装 Developer ID。签名逻辑见 scripts/build-native.mjs。快速排错清单 智能体找不到浏览器 → 设置PI_COMPUTER_USE_CHROME_EXECUTABLE或PI_COMPUTER_USE_HELIUM_EXECUTABLE。需要完全后台、不打扰用户 →PI_COMPUTER_USE_HEADLESS1PI_COMPUTER_USE_CURSOR_OVERLAY0。项目不该碰浏览器 →PI_COMPUTER_USE_BROWSER_USE0。手动 CDP 启动失败 → 检查PI_COMPUTER_USE_CDP_PORT是否与--remote-debugging-port一致且使用了非默认--user-data-dir。完整故障排查见 docs/troubleshooting.md。小结pi-computer-use的PI_COMPUTER_USE_*变量可分为五类浏览器选择、执行模式、CDP 支持、Helper 路径、签名。日常使用只需记住PI_COMPUTER_USE_HEADLESS与PI_COMPUTER_USE_BROWSER_USE两个部署与调试时再按需启用路径覆盖与签名变量。所有变量均覆盖配置文件是临时切换与自动化流水线中最灵活的控制手段。【免费下载链接】pi-computer-useLet Pi control your apps on MacOS Windows项目地址: https://gitcode.com/GitHub_Trending/pi/pi-computer-use创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考