跳到内容
PaneflowPaneflow

在 Windows 上安装 Paneflow

在 Windows 10 或 11 上安装 Paneflow 原生 MSI，验证 PATH 条目，并判断什么时候 WSL2 更合适。

Paneflow 为 Windows 10 1809+ 和 Windows 11 的 x86_64 发布原生 Windows MSI。普通 Windows 工作流请使用 MSI。只有当你的文件、智能体和 toolchain 已经在 Linux 里时，才使用 WSL2。

下载 paneflow-0.8.2-x86_64-pc-windows-msvc.msi，运行它，从开始菜单 打开 Paneflow，然后在新的 PowerShell 窗口中验证 paneflow 命令。

MSI 使用 StriveX 发布者身份签名。运行前可以这样验证下载的 MSI：

powershell
$version = "0.8.2"
Get-AuthenticodeSignature ".\paneflow-$version-x86_64-pc-windows-msvc.msi" | Select-Object Status, SignerCertificate

Status 应为 Valid。证书 reputation 积累期间，SmartScreen 仍可能出现。

使用 MSI 安装 Paneflow

  1. 打开下载页面或 latest GitHub release。

  2. 下载 Windows MSI：

msi
paneflow-0.8.2-x86_64-pc-windows-msvc.msi

  1. 运行安装程序。MSI 会把 Paneflow 安装为标准 Windows 应用，添加开始菜单 快捷方式，并把 paneflow 暴露到 PATH。

  2. 从开始菜单打开 Paneflow。

  3. 打开新的 PowerShell 窗口并验证命令：

powershell
paneflow --version

如果命令输出版本号，说明 MSI 和 PATH 条目都正常。

新 pane 使用你配置的 shell。如果没有配置 shell，Paneflow 会依次回退到 PowerShell 7、Windows PowerShell、%ComSpec%，然后是 cmd.exe。可在 Settings 中修改默认 shell。

支持的 Windows 矩阵

环境状态说明
Windows 11 x86_64支持推荐的原生路径。
Windows 10 1809+ x86_64支持需要可用的 GPU 驱动，并支持 DirectX 11 feature level 10+。
Windows 10 1809 之前不支持原生 build 依赖较新的 Windows 终端和图形 API。
Windows on ARM64尚未发布Windows release artifact 目前只有 x86_64。
WSL2 + WSLg取决于使用场景当 Linux toolchain 是 source of truth 时使用。不要从 WSL2 或 dev container 的 host shell 启动原生 Windows 应用。

Paneflow 的 Windows runtime 使用 Win32、DirectX、ConPTY 和 named pipes。 应用渲染的是原生风格 Windows 控件，不是 Electron 外壳。

终端后端

从 Paneflow 0.8.1 开始，官方 Windows x64 MSVC 版本在 terminal.backend 被省略或为 auto 时，会为新会话默认选择固定版本并 静态链接的 Ghostty libghostty-vt 引擎。Paneflow 保留自己的 GPUI 渲染器 和 ConPTY/会话层；libghostty-vt 负责 VT 解析、终端状态和输入编码。将该值 设为 alacritty 可明确回退到 Alacritty。Windows ARM64 和 GNU 目标，以及 未包含原生 Ghostty 功能的自定义版本，仍使用 Alacritty。此变更仅适用于 新会话，已打开的会话会保留当前引擎。

原生 Windows 还是 WSL2？

如果你想要 Windows 集成，请使用原生 MSI：开始菜单启动、Windows 文件选择器、 通知、原生窗口控件、PATH 配置，以及应用内更新。

如果你的智能体、仓库、包管理器和 shell 自定义都在 Linux 发行版中，请使用 WSL2。这种情况下，把 Linux build 安装到 WSL2 内，并让 WSLg 显示窗口。

bash
VER=0.8.2
curl -LO "https://github.com/arthjean/paneflow/releases/download/v${VER}/paneflow-${VER}-x86_64.deb"
sudo apt install "./paneflow-${VER}-x86_64.deb"
paneflow --version
paneflow

在 Paneflow pane 内使用 WSL，和从 WSL 启动 Paneflow 本身不是一回事。原生 应用请从开始菜单或原生 Windows shell 启动。

Windows 已知注意点

  • Windows Defender SmartScreen 可能会在签名证书积累 reputation 时出现。 运行 MSI 前请验证 release 和发布者。
  • cmd.exe 不会发出当前目录的 OSC 7 标记，所以依赖 cwd 的 pane 行为会更弱。 优先使用 PowerShell 7、Windows PowerShell、Git Bash 或 WSL。
  • RDP、从 dev container 启动，以及从 WSL2 启动原生应用，可能遇到 upstream GPUI 或 Windows graphics 边界问题。
  • CJK IME 和部分 ConPTY Ctrl+C 行为仍有 Windows 特定边界情况。

更底层的 Windows notes，请以 app repo 的 Windows document 作为 source of truth。

更新和卸载

使用应用内 updater，或重新运行最新 MSI。Updater 会选择匹配的 Windows MSI， 验证它，保存当前会话，然后把升级交给 Windows Installer。

如果你正从 Paneflow 0.7.7 或 0.7.8 更新，并且应用内 updater 报告下载 corrupt 或 tampered，请先通过 MSI 手动安装一次 0.7.9。之后的 Windows 更新应该可以重新在 Paneflow 内完成。

从 Windows Settings 卸载 Paneflow。卸载会移除应用，但会保留用户配置 %APPDATA%\paneflow\paneflow.json。辅助二进制文件也可能位于 %LOCALAPPDATA%\paneflow\bin。