Suwu Vibe 项目

项目简介

Suwu 是一个把远程 shell 搬进浏览器标签页的开源项目，目标是在"智能体 AI 时代"让远程命令行变得好用。它提供一个平铺式终端，刷新页面、断开连接甚至明天再来，会话都会原样恢复。Suwu 同时面向人类开发者和 AI 智能体：既给人一套顺手的终端环境，也给需要同时驱动大量终端的智能体编排器（如 opencode、pi、herdr）提供一个稳定的控制目标。项目灵感来自 Omarchy 风格的平铺窗口体验，并用网页形式复刻到远程机器上。

核心功能

1. 平铺窗口管理：支持键盘快捷键或鼠标拖拽来拆分、聚焦、移动、交换窗格，布局本身保存会话状态。
2. 完整终端体验：提供选择、复制粘贴、滚动回看和通知等真实 shell 能力，对人类顺手，对智能体编排器也足够可靠。
3. 会话可恢复：刷新页面、掉线、甚至重启服务器后，每个窗格都能回到离开时的样子。
4. 常用开发小工具：内置带下载功能的文件浏览器、自动刷新的文件查看器、TCP/UDP 端口转发器、支持 SQLite/MySQL/PostgreSQL 的数据库浏览器，以及一个类 Postman 的 REST 调试器，可直接访问服务器侧的本地与局域网地址。
5. suwu 命令行联动：suwu send 可从任意脚本给屏幕推送通知（支持管道输入和标题），suwu forward 打开端口转发窗格，suwu open 在远程机器上解析链接和动作，长任务跑完会主动提醒。
6. 安全访问控制：默认在 localhost、局域网或反代后的公网可达，带密码认证、每次运行独立令牌，并支持一条命令开启 HTTPS。
7. 界面可调：可切换字体族与字号、设置主题配色、调整玻璃背景透明度，还可选择全视口背景（动态光斑、循环视频或 WebGPU 海景），设置中带实时预览；界面开箱支持英文与中文。
8. 文件夹同步：把服务器上的某个目录单向镜像到本机目录，每几秒重新校验，构建产物自动落到本地电脑。
9. 沙箱化扩展：扩展是一段返回 HTML 页面的 JavaScript 小程序，运行在独立进程的 QuickJS 隔离环境中，受严格内容策略约束，拥有自己的 API 路由、静态资源和独立令牌。

技术实现

Suwu 以单个二进制形式分发，通过 shell 安装脚本把文件放到 ~/.local/bin/suwu 并引导完成初始化；它不依赖 Rust 或 Cargo，用户无需准备编译环境。前端是一个可在浏览器中运行的平铺终端界面，后端负责终端会话的持久化——会话状态与布局绑定保存，因此页面刷新或连接中断不会丢失进程。扩展机制采用 QuickJS 隔离运行，每个扩展运行在独立进程中并受内容安全策略限制，令牌只能访问自身的接口。访问层提供密码认证与逐次运行令牌，HTTPS 可通过单条命令启用；网络能力覆盖 localhost、局域网以及反代后的公网。项目还提供文档站点，并可通过 suwu upgrade 保持二进制版本更新，无需手动维护配置文件。

快速上手

1. 安装：运行 curl -fsSL https://raw.githubusercontent.com/liyu1981/suwu/refs/heads/master/install.sh | sh，下载会落到 ~/.local/bin/suwu 并引导完成初始化。
2. 完成引导：按提示一步步配置开发环境，无需手写配置文件。
3. 用键盘或鼠标组织窗格：拆分、聚焦、移动、交换窗格，按需把终端、文件浏览、数据库浏览等排进同一个网格。
4. 接入智能体编排器：把 opencode、pi、herdr 等编排器指向 Suwu 提供的终端，让多个 agent 驱动多个终端。
5. 保持更新与同步：用 suwu upgrade 更新二进制，用内置的文件夹同步把服务器构建产物镜像到本机。
6. 自定义界面：在设置里调整字体、主题和背景，获取即时的可视化预览。

适用人群

适合需要在远程服务器上长期工作的开发者、需要同时管理多个终端会话的运维人员，以及编写和使用 AI 智能体编排器的工程师。对希望把远程 shell 与文件、数据库、端口转发等常用工具整合到同一界面下的用户，Suwu 能显著减少切换窗口的成本。

官网链接

https://suwu.liyu1981.xyz/ （开源仓库：https://github.com/liyu1981/suwu）