北代MCP常用器

Prerequisites

You do not need these to install a packaged release. This section is for building from source and for troubleshooting GPU/runtime setup.

Linux system dependencies

Install the build libraries for your distribution:

Debian/Ubuntu:

sudo apt install build-essential pkg-config libssl-dev libvulkan-dev \
  libwayland-dev libxkbcommon-dev libxkbcommon-x11-dev libx11-dev libxcb1-dev \
  libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev libfontconfig-dev \
  libfreetype-dev libdbus-1-dev

Fedora:

sudo dnf install gcc pkgconf-pkg-config openssl-devel vulkan-loader-devel \
  wayland-devel libxkbcommon-devel libX11-devel libxcb-devel \
  fontconfig-devel freetype-devel dbus-devel

Arch Linux:

sudo pacman -S base-devel pkg-config openssl vulkan-icd-loader wayland \
  libxkbcommon libx11 libxcb fontconfig freetype2 dbus

Install a Vulkan ICD (see Prerequisites > Vulkan GPU driver above).

vulkaninfo --summary # should list at least one physicalDevice

Install

Pick the format that matches your platform. Published release artifacts are attached to the latest GitHub release; the differences between formats are how updates arrive and where files land on disk.

Substitute placeholders before running. The commands below use two placeholders: - X.Y.Z: replace with the release version (e.g., 0.3.7). No leading v in the asset filename. - <ARCH>: replace with x86_64 or aarch64 (check with uname -m). To auto-resolve the latest version:

> VER=$(curl -fsSL https://api.github.com/repos/ArthurDEV44/paneflow/releases/latest \
>       | grep -oE '"tag_name":\s*"v[^"]+"' | cut -d\" -f4 | sed 's/^v//')
> ARCH=$(uname -m)
> 

Then paste $VER and $ARCH in place of the placeholders below. The Git tag uses a v prefix (v0.3.7); the artifact filenames do not (paneflow-0.3.7-x86_64.deb).

Verify the signature BEFORE `apt install`: postinst runs as root,

Verify the signature BEFORE `dnf install`: %post runs as root.

sudo rpm --import https://pkg.paneflow.dev/gpg # see Troubleshooting for the TOFU caveat rpm --checksig paneflow-X.Y.Z-<ARCH>.rpm # expect: digests signatures OK sudo dnf install ./paneflow-X.Y.Z-<ARCH>.rpm paneflow --version

Future updates:

Tarball (immutable distros, no-root installs)

Use this on Fedora Silverblue, SteamOS, NixOS, or any machine where you'd rather not touch /usr. Installs to ~/.local/paneflow.app/ and symlinks ~/.local/bin/paneflow:

curl -LO https://github.com/ArthurDEV44/paneflow/releases/latest/download/paneflow-X.Y.Z-<ARCH>.tar.gz
curl -LO https://github.com/ArthurDEV44/paneflow/releases/latest/download/paneflow-X.Y.Z-<ARCH>.tar.gz.sha256
sha256sum --check paneflow-X.Y.Z-<ARCH>.tar.gz.sha256
tar xzf paneflow-X.Y.Z-<ARCH>.tar.gz
./paneflow.app/install.sh
~/.local/bin/paneflow --version

The in-app updater atomically swaps ~/.local/paneflow.app/ on new releases (no package manager involved).

Uninstall

.deb (Ubuntu/Debian):

sudo apt remove paneflow                              # keep config
sudo apt purge paneflow                               # remove config too
sudo rm /etc/apt/sources.list.d/paneflow.list         # remove APT source
sudo rm /usr/share/keyrings/paneflow-archive.gpg      # remove signing key

.rpm (Fedora/RHEL):

sudo dnf remove paneflow
sudo rm /etc/yum.repos.d/paneflow.repo                # remove DNF source

AppImage: just rm paneflow-X.Y.Z-<ARCH>.AppImage. Nothing else is installed on disk.

.tar.gz:

```bash rm -rf ~/.local/paneflow.app ~/.local/bin/paneflow \ ~/.local/share/applications/paneflow.desktop for s in 16 32 48 128 256 512; do rm -f ~/.local/share/icons/hicolor/${s}x${s}/apps/paneflow.png done

Build from source

1. Install Xcode Command Line Tools (one-time)

xcode-select --install

3. Build

cargo build --release -p paneflow-app --target aarch64-apple-darwin

5. (Optional) Build a .dmg for local distribution

bash scripts/create-dmg.sh \ --version "$(cargo pkgid -p paneflow-app | sed 's/.*#//')" \ --arch aarch64

**Unsigned dev build first-launch:** macOS Gatekeeper rejects unsigned builds by default. For locally-built binaries (no Developer ID cert available), strip the quarantine attribute once:

1. Install the Rust MSVC toolchain target (one-time)

rustup target add x86_64-pc-windows-msvc

2. Compile the binary

cargo build --release -p paneflow-app --target x86_64-pc-windows-msvc

Quickstart

Install a release build first; you do not need Rust unless you are building from source.

```bash

Usage

```bash

Optional: remove config and cache

rm -rf ~/.config/paneflow ~/.cache/paneflow ```

3. (Optional) Produce an MSI via cargo-wix + WiX 3.14

choco install wixtoolset --version 3.14.1 cargo install cargo-wix --version 0.3.9 --locked cargo wix build --no-build ` --package paneflow-app ` --target x86_64-pc-windows-msvc ` --install-version "$(cargo pkgid -p paneflow-app | ForEach-Object { $_ -replace '.*#','' })" ```

Reporting Windows-specific bugs: use the Windows bug report template (captures Windows version + build automatically) and see docs/WINDOWS.md for the full v1 limitations catalog.

Environment variables

Configuration

Paneflow reads paneflow.json from a platform-appropriate config directory:

{
  "$schema": "https://github.com/ArthurDEV44/paneflow/raw/main/schemas/paneflow.schema.json",
  "$schemaVersion": "1.0.0",
  "default_shell": "/bin/zsh",
  "theme": "One Dark",
  "font_family": ".PaneflowMono",
  "font_size": 14,
  "line_height": 1.3,
  "window_decorations": "client",
  "option_as_meta": true,
  "shortcuts": {},
  "terminal": {
    "ligatures": false
  },
  "telemetry": {
    "enabled": null
  },
  "claude_code_button_visible": true,
  "claude_code_bypass_permissions": false,
  "codex_button_visible": true,
  "opencode_button_visible": true,
  "pi_button_visible": true,
  "hermes_agent_button_visible": true,
  "commands": []
}

Alt / Option behavior

option_as_meta defaults to true and makes Alt send an ESC prefix. On macOS, set it to false if you rely on Option to produce Unicode characters.

Terminal options

• terminal.ligatures (default false): when true, programming-font ligatures (FiraCode => !=, JetBrains Mono, Cascadia Code) are rendered through GPUI's text system. Hot-reloaded; takes effect on the next render. Some ligated glyphs span multiple cells, which can shift cell-width measurements compared to default monospaced behavior.

Configuration schema

A versioned JSON Schema for paneflow.json lives at schemas/paneflow.schema.json (draft-07). Editors that understand $schema (VS Code, Zed, JetBrains, neovim with coc-json / nvim-lspconfig) give you autocomplete and inline validation when you point at it from your config:

{
  "$schema": "https://github.com/ArthurDEV44/paneflow/raw/main/schemas/paneflow.schema.json",
  "$schemaVersion": "1.0.0"
}

Both $schema (the editor pointer) and $schemaVersion (the version pin) are optional. Paneflow logs a warning when $schemaVersion is unknown but never refuses to load the file. Schema validation is editor-side; runtime parsing stays tolerant.

WSL2 / headless / GPU-less hosts: force the lavapipe software ICD.

sudo apt install mesa-vulkan-drivers # Debian/Ubuntu VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/lvp_icd.x86_64.json paneflow ```

GPUI auto-selects Wayland or X11 based on WAYLAND_DISPLAY / DISPLAY. To force X11 on a Wayland session: WAYLAND_DISPLAY= paneflow.

Compare

Paneflow overlaps with terminals, multiplexers, and agent workspaces, but the design center is narrower: keep several real CLI agents visible and controllable inside one native project window.

Detailed comparisons:

• Hub: paneflow.dev/compare
• vs cmux
• vs WezTerm
• vs iTerm2
• vs Warp

Troubleshooting