跳到内容
PaneflowPaneflow
文档

在 Windows 上安装 Paneflow

使用签名 MSI 在 Windows 上安装 Paneflow。验证安装、解决终端命令不可用的问题，并为 WSL2 选择 Linux 版。

Paneflow 原生支持 Windows 10 版本 1809 或更高版本和 Windows 11， 处理器须为 x86_64（Intel 或 AMD）。Windows 项目使用 MSI 安装。 如果仓库和智能体位于 Linux 发行版中，请参阅下方的 WSL2 说明。

使用 MSI 安装 Paneflow

  1. 打开 Paneflow 下载页面 或 GitHub 上的最新 Paneflow 版本。
  2. 下载 paneflow-0.17.7-x86_64-pc-windows-msvc.msi。
  3. 按下方说明验证文件签名，然后运行 MSI。批准 Windows 的管理员权限请求。
  4. 保持选中 PATH Environment Variable，以便从终端运行 paneflow。 默认安装目录为 %ProgramFiles%\PaneFlow。
  5. 完成安装，然后从开始菜单打开 PaneFlow。

无需 Rust 或编译工具。CLI 智能体需要单独安装，然后按照 入门指南 打开项目并运行智能体。

验证 MSI 签名

在 PowerShell 中打开下载的 MSI 所在文件夹，然后运行：

powershell
$version = "0.17.7"
$signature = Get-AuthenticodeSignature ".\paneflow-$version-x86_64-pc-windows-msvc.msi"
$signature.Status
$signature.SignerCertificate.Subject

状态应为 Valid，证书使用者信息应显示发布者为 Strivex。 如果找不到文件，检查文件夹和文件名。如果签名无效或发布者不同， 先从版本页面重新下载，再继续安装。

即使文件已签名，SmartScreen 仍可能显示信誉警告。先核对签名和发布者。 如果组织管理的电脑阻止安装，请联系管理员。

验证安装

打开新的 PowerShell 窗口并运行：

powershell
paneflow --version

命令应输出已安装的版本号。还要确认能从开始菜单打开应用。

如果无法识别 paneflow，关闭所有终端窗口，然后从开始菜单重新打开 PowerShell。如果命令仍不可用，尝试默认安装路径：

powershell
& "$env:ProgramFiles\PaneFlow\paneflow.exe" --version

如果选择了其他安装目录，改用对应路径。如果完整路径可用，可暂时使用它， 并重新运行 MSI 以恢复 PATH Environment Variable 功能。 如果缺少可执行文件，检查安装目录或重新安装应用。

新面板使用 Paneflow Settings 中选择的 shell。未配置时，Paneflow 依次尝试 PowerShell 7、Windows PowerShell、%ComSpec% 和 cmd.exe。

Windows 版本与要求

环境提供形式要求
Windows 11 x86_64原生 MSI正常工作的 GPU 驱动，支持 DirectX 11 功能级别 10 或更高。
Windows 10 1809+ x86_64原生 MSI相同的图形要求。
Windows 10 1809 之前不支持安装前先升级 Windows。
Windows ARM64无 ARM64 MSIWindows 版本仅提供 x86_64 安装程序。
WSL2 与 WSLgLinux 版Windows 10 内部版本 19044+ 或 Windows 11，以及兼容的 GPU 驱动。

原生 Windows 还是 WSL2？

Windows 文件、shell 和智能体使用原生应用。从开始菜单或 Windows shell 启动应用，即使在面板内使用 WSL 也采用这一方式。

如果仓库、智能体和工具安装在 Linux 中，则在 WSL2 内使用 Linux 版。 WSLg 负责显示 Linux 应用窗口。按照 Microsoft 的 WSLg 配置说明 设置 WSL2 和图形支持，然后在 Linux 终端中按照 Linux 安装指南 操作。选择适合发行版和 处理器架构的软件包。WSL1 无法通过 WSLg 显示 Linux 图形应用。

Windows 已知注意点

  • 跟踪面板当前目录时，优先使用 PowerShell 或 Git Bash，而非 cmd.exe。 cmd.exe 不通过 OSC 7 报告目录变化。
  • 远程桌面、从 WSL2 或开发容器启动、CJK 输入法和部分 Ctrl+C 行为 可能存在 Windows 特有限制。如果最新版本仍有问题， 报告 Windows 问题， 并提供 Paneflow 版本、Windows 内部版本、shell 和复现步骤。

终端后端

Windows 版已包含 Ghostty 的 libghostty-vt 终端引擎，无需单独安装 或选择后端。paneflow.json 中遗留的 terminal.backend 键会被忽略。 迁移历史参见 Paneflow 在 Windows 上如何使用 Ghostty。

更新和卸载

升级前，保存文件并结束正在运行的命令。MSI 可能在升级过程中停止 正在运行的终端会话。

使用应用内更新功能，或下载并运行 paneflow-0.17.7-x86_64-pc-windows-msvc.msi。如果更新报告下载损坏， 或只是重新启动相同版本，请手动安装最新 MSI。0.7.7/0.7.8 和 0.17.0/0.17.1 的已知更新故障也采用这一方式，无需安装中间版本。

从 Windows 设置中卸载 Paneflow。这会移除已安装的应用，但保留 %USERPROFILE%\.paneflow，包括 paneflow.json、已保存的会话、 受管 worktree 和 bin 下的辅助可执行文件。