From ff160f41cabee24d9159e975ec9e7a7182ecef74 Mon Sep 17 00:00:00 2001 From: weidu12123 Date: Sat, 17 Oct 2026 17:02:46 +0800 Subject: [PATCH] docs: settle the GPUI client plan and the development baseline The plan pins gpui-kit 0.7.3 (locked to gpui-pre 0.3.9) as the client stack, keeps the backend untouched behind the existing HTTP/WS API, and ships the client for Windows, macOS and Linux. The dev baseline records the verified versions, the knowledge sources that outrank memory, the entry-point skeleton, and the platform facts the next sessions must not relitigate. Co-Authored-By: Claude Fable 5 --- docs/gpui-client.md | 139 ++++++++++++++++++++++++++++++++++++++++++++ docs/gpui-dev.md | 137 +++++++++++++++++++++++++++++++++++++++++++ docs/plan.md | 4 +- 3 files changed, 278 insertions(+), 2 deletions(-) create mode 100644 docs/gpui-client.md create mode 100644 docs/gpui-dev.md diff --git a/docs/gpui-client.md b/docs/gpui-client.md new file mode 100644 index 0000000..f2d6bba --- /dev/null +++ b/docs/gpui-client.md @@ -0,0 +1,139 @@ +# GPUI 原生 Windows 客户端方案 + +> 2026-10-17 调研结论。本文是 `docs/plan.md` 的展开，边界修改见文末「对 plan.md 的修改」。 + +--- + +## 结论 + +| 决策 | 选择 | 依据 | +|---|---|---| +| GPUI 分发 | crates.io `gpui-kit = "0.7.3"`（内部精确锁定 `gpui-pre =0.3.9`） | 本机 Windows 11 实测：一次编译通过（1m55s），窗口正常打开 | +| 组件库 | gpui-kit（含 gpui-component） | 75+ 组件、Dock/DataTable/Tree/VirtualList/Editor 齐备、Apache-2.0、Longbridge Pro 生产验证 | +| 终端渲染 | `alacritty_terminal 0.26` + 自写 GPUI Element | 四个参照项目全部走这条路；后端已有同版本解析器与字节环 | +| 后端集成 | GPUI 客户端走 HTTP/WS 连现有 axum 守护进程，后端零改动 | 一份实现、两个前端；现有 API 已覆盖全部板块 | +| 产物 | `vps-switch`（守护进程，Linux/Windows 无头）+ `vps-switch-gpui`（Windows / macOS / Linux 三平台客户端） | 受众优先：能构建的平台都构建，与 shell-rs / tty7 的发布矩阵一致 | + +**不 fork GPUI、不打补丁。** 参照项目里只有 shell-rs 是零 fork 路线，它已在生产用 gpui-kit 0.6.1 做了完整 SSH 客户端；我们的 spike 在本机复现了同样的可行性。 + +--- + +## 四个参照项目的路线对照（2026-10-17 实测克隆） + +| 项目 | 星数 | 许可 | GPUI 来源 | 组件库 | 规模 | +|---|---|---|---|---|---| +| [shell-rs](https://github.com/since2006/shell-rs) | 334 | **GPL-3.0** | crates.io `gpui-kit 0.6.1` | gpui-kit | 13.3 万行，终端模块 1.5 万行 | +| [tty7](https://github.com/l0ng-ai/tty7) | 1263 | **Apache-2.0** | Zed git rev（钉 commit） | gpui-component 自维护分支 | 34 万行，终端 5.7 万行 | +| [pebrel](https://github.com/Kuddev/pebrel) | 3418 | **GPL-3.0** | 自维护 `Kuddev/zed` fork（v1.16.1 + 一串补丁） | gpui-component fork 0.5.2 | 终端核心约 1 万行 | +| [oxideterm](https://github.com/AnalyseDeCircuit/oxideterm) | 1681 | **GPL-3.0** | vendor 整套 `gpui-ce` 进仓库 | 自建 UI | 90 个 crate | + +**许可证事实：四个项目里只有 tty7 是 Apache-2.0，可以直接借鉴代码（保留声明）；其余三个是 GPL-3.0，只能读架构、不能抄代码。** 这条约束把 tty7 抬到「第一参照」：它的守护进程模型、终端渲染、托盘实现都可以合法移植。 + +**它们分叉的原因**（说明为什么我们不能照抄任何一家）： + +- pebrel / oxideterm 需要上游没有的东西（DirectWrite 字体内存所有权、虚拟窗口测试、混合 DPI 修复），选择了 fork/vendor，代价是每次上游变更都要手工合并。 +- tty7 需要 gpui-component 的未发布修改，选了 git 分支；GPUI 本体钉 Zed commit 而非 gpui-pre，因为它的 `alacritty_terminal` 也是自己的 fork，不能跟周更快照绑死。 +- shell-rs 什么都不需要改，所以用 crates.io 版本，交给 gpui-kit 的周更节奏管理升级。 + +**vps-switch 属于 shell-rs 这一档**：我们没有任何必须改 GPUI 本体的需求。如果后期发现确实需要（例如 IME bug 必须在平台层修），再升级到 tty7 模式（钉 Zed rev），这是渐进的，不影响现在的选型。 + +--- + +## 生态事实（决定维护成本的硬数据） + +- `gpui-pre` 是 Longbridge（huacnlee）把 Zed 每周快照重发到 crates.io 的系列：0.3.9 = 2026-10-12，Apache-2.0，月下载 10.5 万，是事实上唯一的可用分发。crates.io 上 `gpui` 这个名字的 Zed 官方版本停在 2025-10 的 0.2.2，结构已过时（早于平台拆分），不能用。 +- gpui-kit 0.7.3（2026-10-12），周更节奏，**精确锁 `=0.3.9`**（它曾经用 caret 被周更打崩过，现在 CI 强制精确 pin）。升级 GPUI 必须跟它一起走。 +- 0.7.x 仍有 breaking change（`Table`→`DataTable` 等），**锁死具体版本升级，不自动跟周更**。 +- Zed 官方 2026 年把 GPUI 开发降级为「只做 Zed 用得到的部分」，社区需求一律指向 fork。这对我们意味着：**上游不会替我们修任何东西**，所有平台层缺口要么自己补、要么靠 gpui-kit 这个已被生态接受的通道。 +- Zed 的终端 crate 不可复用：GPL-3.0 且与编辑器深度耦合（不在 crates.io，不独立发布）。 + +--- + +## 架构 + +### 进程模型 + +``` +vps-switch-gpui.exe (GPUI 客户端) + │ HTTP REST + 二进制 WS（127.0.0.1:18800，回环免 Key） + ▼ +vps-switch.exe (守护进程：axum + SQLite + russh + alacritty Term + MCP) + │ + ├── 本机 PTY（portable-pty + 随包 ConPTY） + └── 远端 SSH（russh，连接池 + 跳板） +``` + +- **后端零改动。** 现有 26 个 REST 端点 + 终端二进制 WS（0x00 实时 / 0x01 输入 / 0x02 回放）+ SSE 事件，覆盖全部五大板块与 MCP。 +- **客户端启动时自动拉起守护进程**（若 127.0.0.1:18800 无响应），沿用现有 `--minimized` 启动参数与数据目录解析（`%APPDATA%\vps-switch\data`）。 +- 终端状态仍是「后端权威 + 客户端第二份解析」：后端 `Term` 保证 pane 保活与回放，客户端 `alacritty_terminal` 把 WS 字节流渲染出来。这与现在浏览器里 xterm.js 的地位完全相同。 +- 旧 Windows 桌面壳（`src/desktop.rs`，tao + wry + tray-icon）在 GPUI 客户端达到可用后退役；退役之前两者并存，互不干扰。 +- **客户端三平台同一份代码**：GPUI 与 gpui-kit 原生支持 Windows / macOS / Linux，shell-rs（零 fork 的 gpui-kit 路线）与 tty7 都已发布三平台产物。需要平台专用代码的只有托盘（原生 / StatusNotifierItem）与自启（注册表 / LaunchAgent / systemd user unit）。 + +### 客户端模块（`gpui/` 目录，独立 binary） + +| 模块 | 内容 | 复用的后端 | +|---|---|---| +| `workspace` | DockArea 布局：左主机树 / 中工作台 / 右详情，标签页与分屏 | — | +| `hosts` | 主机树（Tree）、增删改（Dialog）、连接测试 | `/api/hosts*` | +| `terminal` | alacritty_terminal 解析 + 自写 Element 渲染 + 输入编码 | `/api/ws/terminal/:pane_id`、`/api/terminals` | +| `files` | 双栏 DataTable、CodeMirror 对应物（gpui-kit 内置 Editor） | `/api/files/*` | +| `inspector` | 探针仪表盘（gpui-kit Chart：Line/Bar/Area） | `/api/hosts/:id/inspect` | +| `settings` | 设置四分类 | `/api/settings*` | +| `tray` | 托盘图标 + 右键主机列表秒开终端 | — | +| `app` | 单实例（CLI socket）、自启、窗口状态持久化 | — | + +### 终端渲染（关键实现细节，来自四个项目的共识） + +1. 解析线程持有 `alacritty_terminal::Term`，UI 线程定时（16ms）批量取快照，**锁内只做快照、锁外做颜色解析与绘制**（pebrel 契约）。 +2. 每行一次 `shape_line`，`force_width` 传**单格宽度**而非行宽（shell-rs 的实测教训：传行宽会把首字符之后全部推向右边）。 +3. 背景色按连续区间合并成矩形，不逐格画。 +4. 字形原点 = `列号 × cell_width`，不允许布局引擎移动字形（等宽字体正确性的前提）。 +5. 连字默认关闭（逐格塑形），后续作为可选特性（pebrel 的做法：同样式相邻 ASCII 合并塑形再映射回固定列号）。 + +--- + +## Windows 风险清单（按严重度，全部要在 M0 验证） + +| # | 风险 | 事实 | 应对 | +|---|---|---|---| +| 1 | **中文 IME** | zed#56327（2026-05 开，标记 needs repro，2026-10 仍未修）：IME 组合态下 WM_KEYDOWN 未被抑制，可能重复插入或干扰输入 | M0 第一项实测。若复现：在 spike 里接 Win32 `WM_IME_*` 自管组合文本；若平台层限制无法绕开，再考虑钉 Zed rev 自修（升级到 tty7 模式） | +| 2 | **GPU 要求** | 这是 GPUI 框架自身的限制，所有 GPUI 应用（含四个参照项目）完全一样。Windows 要求 DirectX 11 兼容 GPU，**官方文档明确虚拟机里用模拟适配器「能工作、仅性能下降」**；仅纯 Basic Display Adapter 环境可能打不开。Linux 需要 Vulkan，缺驱动报 `NoSupportedDeviceFound`，装驱动可解（软件渲染未文档化）。macOS 全系 Metal，无此问题 | 发布说明写明 GPU 要求。重点自测用户的云电脑场景（虚拟机） | +| 3 | 托盘 | GPUI 上游无内置（托盘 PR #44047 被官方以「无 Zed 用例」关闭）；`gpui-tray 0.1.4`（2026-09-20）可用 | 三平台各一套：Windows/macOS 原生 + Linux StatusNotifierItem（tty7 的 `src/ui/tray/` 共 1150 行，Apache-2.0 可移植） | +| 4 | 窗口透明/毛玻璃 | 未知：GPUI 有 `transparent` 选项，Windows 上亚克力/模糊效果未验证 | M0 验证。退路：纯色深/浅主题（gpui-kit 内置 20+ 主题），毛玻璃作为后续增强 | +| 5 | 字体 | DirectWrite 走系统 shaping/光栅化，无需 font-kit，中文回退正常（Zed 自身每日验证） | 低风险，M0 顺带验证 | + +--- + +## 分阶段计划（每阶段可独立验收） + +- **M0 可行性收尾（1 天）**：已完成的编译 + 开窗 ✅。待验证：中文输入、托盘、透明窗口、Dock 布局骨架、终端 Element 画 5000 格。 +- **M1 骨架（3–5 天）**：workspace + DockArea + 主机树 + 设置页只读；客户端连守护进程读真实数据。 +- **M2 终端**：alacritty_terminal 解析 + Element 渲染 + 输入 + resize + 重连回放；手用终端零注入的既有纪律沿用。 +- **M3 文件**：双栏 DataTable + 传输队列 + 内置 Editor。 +- **M4 探针**：仪表盘图表。 +- **M5 平台**：托盘、自启、单实例、窗口状态、独立终端窗口。 +- **M6 收尾**：退役旧桌面壳；打包三平台 —— Windows（Inno Setup，沿用现有流程）、macOS（arm64 + x64 dmg；签名/公证需要 Apple Developer 账号，先做未签名版）、Linux（AppImage，随包 X11/Wayland 依赖）；GitHub Actions 发版流水线（tag 触发、matrix 三平台、产物 + SHA256SUMS）；旧桌面壳退役、发版。 + +每个里程碑验收用真实机队（vip-hk 等）与真实界面，不用代理指标。 + +--- + +## 不做的事（防蔓延） + +- 不 fork GPUI、不打补丁（除非 M0 的 IME 验证证明必须）。 +- 不学 tty7 的 agent 集成、mobile、remote workspace；不学 oxideterm 的插件/wasm/云同步。 +- 不引入 IDE 能力（LSP/补全/diff 视图）——内置 Editor 只用来看和改配置文件。 +- Vue 前端不追求与 GPUI 对齐：它降级为「浏览器控制台 + Linux 服务器管理界面」，功能完整但不再加新交互。 +- 概念数不增加：客户端/守护进程是既有架构的显式化，不引入新名词。 + +--- + +## 对 plan.md 的修改（待拍板） + +边界一句话改为： + +> **一个轻量级 VPS 管理工具：先把 VPS 仓库、终端、文件浏览器、文件上传下载、探针五大核心板块做到极致，最后将这些现成链路加上护栏工具化为 MCP Server。交付两个产物：GPUI 原生的桌面客户端（Windows / macOS / Linux，`vps-switch-gpui`）与无头的守护进程（`vps-switch`，Linux/Windows），两者共用同一后端与同一套 HTTP/WS API。** + +技术栈表「桌面壳」一行改为： + +> | 桌面壳 | GPUI（gpui-kit 0.7.3 / gpui-pre 0.3.9） | Windows 客户端；Linux 无头服务不带壳 | diff --git a/docs/gpui-dev.md b/docs/gpui-dev.md new file mode 100644 index 0000000..de88221 --- /dev/null +++ b/docs/gpui-dev.md @@ -0,0 +1,137 @@ +# GPUI 开发基线（知识防老化） + +> 2026-10-17 建立。**目的：任何后续会话/开发者动手前先读本文，不要凭记忆写 GPUI 代码。** +> GPUI 在 2026 年变化极快（`gpui-kit` 这个名字 2026-09 才从 `gpui-component` 改来；GPUI 本体在 crates.io 上只到 2025-10 的 0.2.2，结构已过时）。训练数据里的"GPUI 知识"大概率是错的。 +> 方案见 `docs/gpui-client.md`，本文是可执行的事实基线与纪律。 + +--- + +## 1. 版本基线（写死，不 auto-update） + +| 项 | 版本 | 说明 | +|---|---|---| +| `gpui-kit` | **`=0.7.3`** | crates.io，Apache-2.0。一个依赖带出 GPUI + 组件 + 图标 | +| `gpui-pre` 系列 | **`=0.3.9`**（gpui-kit 内部锁定） | 不要在 `Cargo.toml` 里自己写，也不要 `cargo update` 它 | +| Rust | **1.99.1**（`rust-toolchain.toml` 钉住） | gpui-pre 0.3.x 用了 1.94 后才稳定的 std API；1.95 编不过 | +| `alacritty_terminal` | **0.26** | 与后端 `Cargo.toml` 同版本 | +| 镜像 | rsproxy（`sparse+https://rsproxy.cn/index/`） | 本机与 CI 都配 | + +**升级纪律**： + +- `gpui-kit` 0.7.x 仍有 breaking change（`Table`→`DataTable`、`Divider`→`Separator` 等都发生过）。**升级 = 一次明确的工程任务**：读 [gpui-kit releases](https://gpui-kit.com/releases) → 全量编译 → 修 breaking → 真机验收。绝不混在日常改动里。 +- `gpui-pre` 由 gpui-kit 精确锁定，**每升一版 gpui-kit 才动一次**。曾经有人用 caret 依赖被周更打崩（gpui-kit #3156），CI 现在强制精确 pin。 +- 升级后第一件事：跑本机 spike（见 §8）验证编译与开窗，再跑 IME 手测。 + +--- + +## 2. 知识来源优先级（不要凭记忆） + +写任何 GPUI/gpui-kit 代码前，按此顺序核实 API： + +1. **本地源码**（已下载，最可靠）： + - `~/.cargo/registry/src/*/gpui-component-0.7.3/` + - `~/.cargo/registry/src/*/gpui-base-0.7.3/` + - `~/.cargo/registry/src/*/gpui-pre-0.3.9/src/` +2. **组件文档**：https://gpui-kit.com/component/.md ；索引 https://gpui-kit.com/docs/components +3. **官方 AI skills**（含编码规范与设计规范，shell-rs 把它当规范用）：`npx skills add longbridge/gpui-kit` +4. **参照项目**（本地克隆，见 §7）——读架构可以，代码注意许可证。 + +**反面模式**（记忆里出现过、实际已过时的说法）： + +- ❌ "crates.io 上的 gpui 可以直接用" —— 0.2.2 结构过时（早于平台拆分），不可用。 +- ❌ "stable Rust 1.90+ 就够" —— 那是 2025-12 的信息；现在需要 ≥1.98，本项目钉 1.99.1。 +- ❌ "gpui-terminal 有个 358 行的现成实现可以依赖" —— 已停更近一年，API 对不上当前 GPUI，只能读思路。 +- ❌ "Zed 官方会处理平台问题" —— 2026-02 起官方只做 Zed 用得到的部分，社区需求一律指向 fork。上游不会替我们修任何东西。 + +--- + +## 3. 已验证的入口骨架（本机编译 + 开窗通过） + +```rust +use gpui_kit::component::input::*; +use gpui_kit::component::*; +use gpui_kit::*; + +fn main() { + gpui_kit::application().run(move |cx| { + gpui_kit::init(cx); // 必须先调用，再使用任何组件 + gpui_kit::open_window(WindowOptions::default(), cx, |window, cx| { + cx.new(|cx| MyView::new(window, cx)) + }) + .expect("Failed to open window"); + }); +} +``` + +- `gpui_kit::open_window` 自动挂 `Root`（对话框/toast 的宿主），不要自己再包一层。 +- 完整可用样例：`E:\1shell4.7\gpui-spike\src\main.rs`（含 Input 与 Button，中文占位符验证过）。 +- 带 `Root`、单实例、设置加载、Store 注入的生产级骨架：`E:\1shell4.7\gpui-refs\shell-rs\src\main.rs`（147 行，GPL，读结构不抄代码）。 + +--- + +## 4. 工程模式（从 shell-rs AGENTS.md 提炼，已被生产验证） + +- **一个命令一个处理器**：按钮、菜单、快捷键全部派发 `actions.rs` 里的 action，由 Workspace 统一处理。不写临时闭包直接改状态。 +- **状态经 Entity 流动**：mutator 在 Entity 方法里「改内存 → 写库 → notify」；消费方 `cx.observe`。**渲染回调内不得读取其他实体**，只能传普通快照（渲染闭包运行在 render 过程中，重入会 panic 或死锁）。 +- **焦点规则**：`dispatch_action` 只沿焦点元素的祖先链走。工作区内部必须有东西持有焦点；**永远不要聚焦根节点**（对话框层是它的子元素，祖先持焦点会让对话框的焦点陷阱失效）。标题栏按钮用 `FocusHandle::dispatch_action` 派发。 +- **对话框关闭后焦点会丢**（gpui-component 既有行为）：这是上游行为不是 bug，别花时间修。 +- **彩色 SVG 不能用 `Icon`**：`svg()` 走 `paint_svg`，整图当遮罩单色上色。彩色要 `img()`（光栅化成位图）。 +- **gpui-kit 的 Scrollable 不是就地在原元素加滚动条**：它重建外层 div。滚动区内先放一层 `v_flex().w_full()` 再写内容（否则子块按内容宽度收缩，宽度参差）。 +- **无头 UI 测试**：`gpui-kit` 的 `test-support` feature + `gpui_kit::test::TestWindowExt`（真实 Workspace 在无头窗口里渲染，`click`/`input`/`find` 驱动）。每个里程碑的验收都要有这类测试，别只靠肉眼看窗口。 +- 尺寸：`px(..)` 只用于 API 要求 `Pixels` 的地方；其余用 `cx.theme()` token 与 rem 助手。 + +--- + +## 5. 终端渲染要点（四个参照项目的共识） + +1. **解析线程 + UI 定时批量刷新**：解析线程持有 `alacritty_terminal::Term`；UI 线程 ~16ms 取一次快照。锁内只做快照（拷贝成纯数据），**锁外做颜色解析与绘制**。 +2. **每行一次 `shape_line`**；`force_width` 传**单格宽度**——传行宽会把首字符之后全部推向右边（shell-rs 实测教训，源码里有注释）。 +3. **背景按连续区间合并**成矩形，不逐格画。 +4. **字形原点 = `列号 × cell_width`**，不允许布局引擎移动字形。连字默认关（逐格塑形）。 +5. 输入编码在 UI 侧完成（`Keystroke` → 按终端模式编码字节），协议回复/鼠标报告/IME 预编辑不走通用输入路径。 +6. 后端已有同版本 `alacritty_terminal` 与 2MiB 字节环；客户端收 WS 字节流（0x00 实时 / 0x01 输入 / 0x02 整份回放），**0x02 要重置再重建**（`\x1bc` 或清屏），这是浏览器端踩过的坑（commit `a868ce9`）。 + +--- + +## 6. 平台事实 + +| 平台 | GPU | 托盘 | 字体 | IME | +|---|---|---|---|---| +| Windows | DX11 兼容；虚拟机用模拟适配器**能工作**（官方文档原话），纯 Basic Display Adapter 可能打不开 | 无内置；`gpui-tray 0.1.4` 或移植 tty7 `src/ui/tray/native.rs`（148 行） | DirectWrite，走系统 | **风险**：zed#56327 中文 IME 未修，M0 必须手测 | +| macOS | 全系 Metal，无问题 | 原生 NSStatusItem | 系统 | NSTextInputClient 语义，正常 | +| Linux | 需要 Vulkan；缺驱动报 `NoSupportedDeviceFound`，装驱动可解；无文档化软件渲染 | StatusNotifierItem（tty7 `sni.rs`） | fontconfig | X11/Wayland 输入法框架 | + +- 发布说明必须写明 GPU 要求。 +- 三平台自启：注册表 `HKCU\...\Run` / LaunchAgent `plist` / systemd user unit。 + +--- + +## 7. 参照项目（本地克隆，`E:\1shell4.7\gpui-refs\`） + +| 目录 | 项目 | 许可证 | 能做什么 | +|---|---|---|---| +| `tty7/` | l0ng-ai/tty7（1263★） | **Apache-2.0** | **唯一可以抄代码的**：托盘、守护进程模型、终端渲染、IME 处理，保留版权声明即可 | +| `shell-rs/` | since2006/shell-rs（334★） | GPL-3.0 | 零 fork gpui-kit 路线的完整工程样板，**只读结构与文档** | +| `pebrel/` | Kuddev/pebrel（3418★） | GPL-3.0 | 渲染契约、逐格塑形思路，只读 | +| `oxideterm/` | AnalyseDeCircuit/oxideterm（1681★） | GPL-3.0 | vendor GPUI 的做法（我们不采用），只读 | + +**纪律**：GPL 项目一行代码都不能复制进 vps-switch。Apache-2.0 的 tty7 可以移植，保留其版权声明。 + +--- + +## 8. Spike（每次升级 gpui-kit 后重跑） + +`E:\1shell4.7\gpui-spike\`（仓库外，独立 cargo 工程）： + +- `cargo build` 通过 = 工具链与版本兼容。 +- `cargo run` 出窗口 + 在输入框里打中文 = 开窗与 IME 验证。 +- 内存参考：debug 构建窗口进程约 74MB。 +- 未验证、需要补的：托盘、透明窗口、Dock 布局、终端 Element 画 5000 格、macOS/Linux 本机构建。 + +--- + +## 9. 调研过程教训（避免重复浪费） + +- **不开子 agent 做调研**：2026-10-17 四个并行 agent 烧掉约 40 万 token 并撞 429 配额全部失败。读文件自己读，每次让 agent 报告结论会把上下文翻倍。 +- **先跑通再写文档**：方案里每个"可行"都要有本机实测支撑（编译、开窗）。 +- **验收用真实界面**，不用代理指标（抓包/日志）。 diff --git a/docs/plan.md b/docs/plan.md index eaba037..a9464ca 100644 --- a/docs/plan.md +++ b/docs/plan.md @@ -8,7 +8,7 @@ ## 边界 -**一个轻量级 VPS 管理工具：先把 VPS 仓库、终端、文件浏览器、文件上传下载、探针五大核心板块做到极致，最后将这些现成链路加上护栏工具化为 MCP Server。** +**一个轻量级 VPS 管理工具：先把 VPS 仓库、终端、文件浏览器、文件上传下载、探针五大核心板块做到极致，最后将这些现成链路加上护栏工具化为 MCP Server。交付两个产物：GPUI 原生的桌面客户端（Windows / macOS / Linux，`vps-switch-gpui`）与无头的守护进程（`vps-switch`，Linux/Windows），两者共用同一后端与同一套 HTTP/WS API。** 设计准则： @@ -109,5 +109,5 @@ | Web 服务与实时通信 | `axum` | REST API + 终端二进制 WebSocket + 状态/探针/传输进度 SSE | | 本地存储 | `rusqlite`（bundled） | 单文件 SQLite + 凭据加密存储 | | MCP 协议 | `rmcp`（≥ 1.4.0） | 板块六接入，支持 stdio 与 Streamable HTTP | -| 桌面壳 | Tauri 2 | 桌面窗口与托盘 + headless 同一二进制双模式 | +| 桌面壳 | GPUI（`gpui-kit` 0.7.3，内部锁 `gpui-pre` 0.3.9） | GPUI 原生桌面客户端（Windows / macOS / Linux）；Linux 无头服务不带壳。详见 `docs/gpui-client.md` | | 前端 | Vue 3 + TypeScript + Tailwind CSS + xterm.js（WebGL）+ CodeMirror 6 | 轻量、响应迅速、围绕五大板块打造精致 UI |