安装

Ridge 是一个桌面应用，提供 Windows 安装包；macOS 与 Linux 用户当前需要从源码构建。所有平台均可使用同一份代码。

从安装包安装（Windows）

访问 Releases 页面，下载与系统匹配的安装包：

• ridge_0.1.0_x64-setup.exe — NSIS 安装程序
• ridge_0.1.0_x64_en-US.msi — MSI 安装程序

双击运行，按提示完成即可。安装结束后会在「开始」菜单看到 Ridge。首次启动可能需要授予网络权限（Ridge 会在本地启动一个供智能体使用的 HTTP 端口）。

从源码构建（所有平台）

需要：

• Node.js 18 或更新版本
• pnpm 9 或更新版本
• Rust 1.77 或更新版本
• Windows 还需要：MSVC Build Tools 与 WebView2 运行时
• Linux 还需要：webkit2gtk、libssl-dev 等系统依赖（参考 Tauri 官方安装清单）

$ git clone https://github.com/MySetsuna/ridge.git
$ cd ridge
$ pnpm install
$ pnpm tauri build   # 输出可执行文件 + 安装包到 src-tauri/target/release/bundle/

第一次运行

启动后会看到一个全屏的终端分屏。这是 Ridge 的最小工作单元：每个分屏都是一个独立的终端会话，有自己的工作目录、命令历史与 Git 状态。

建议先做这几件事：

• 按 Ctrl + \ 把当前分屏水平切分成两个，按 Ctrl + - 垂直切分。
• 在左上角点击工作区下拉，选择「打开文件夹…」加载一个项目。Ridge 会以这个目录作为新工作区。
• 左侧栏顶部三个图标分别是：文件浏览器、源代码管理（Git）、搜索。
• 每个分屏的标题栏右侧有几个按钮：当前分支徽章（点击切换 / 新建分支）、Bot（启动 Claude Code 智能体）、History（查看历史输出）、× 关闭。

所有界面元素的位置都是固定的，不需要先做配置就能开始用。

使用终端

分屏与切换

Ridge 的核心工作模式是任意嵌套的分屏。每次切分都把当前分屏一分为二，可以是水平或垂直方向，没有层级上限。

• Ctrl + \ 水平切分（左右排列）
• Ctrl + - 垂直切分（上下排列）
• Ctrl + W 关闭当前分屏
• 用鼠标拖拽分屏之间的分隔线可以调整大小；双击分隔线复位为均分。

每个分屏完全独立——切换 shell、运行长任务、按 Ctrl + C 中断，都不会影响其它分屏。关闭某个分屏时，对应的进程会被一并结束。

分屏标题栏会显示当前的工作目录与前台进程名。当 shell 切换目录（例如执行 cd）时，标题栏会自动同步。

滚动历史与历史回放

每个分屏会保留最近的命令输出，可以用滚轮、Shift + PageUp / PageDown 或者 Shift + 上 / 下 翻看。容量按字节计算，足以容纳数 MB 的输出，老内容会按队列丢弃最早的部分。

如果需要查看更久之前的输出（例如已经被新输出推走的内容），点击分屏标题栏的 History 按钮，会打开一个独立的历史回放窗口。这个窗口默认载入最新的几百 KB 文本，可以按「加载更早」继续往前翻；附带搜索框（支持区分大小写、上一项 / 下一项跳转），并自动剥离 ANSI 转义码方便复制。

使用文件

文件浏览器

左侧栏第一个图标打开文件浏览器。每个工作区下会按当前活跃过的目录形成一列；点击文件夹展开，点击文件直接在编辑器中打开。

文件浏览器支持：

• 键盘导航：上下方向键移动焦点，Enter 打开，左 / 右收起或展开目录，Home / End 跳到首尾。
• 右键菜单：新建文件、新建文件夹、重命名、删除、复制路径、在系统资源管理器中显示。
• 行内重命名 / 新建：按 F2 或在右键菜单选择「重命名」会把名称变成可编辑输入框，Enter 提交，Esc 取消。新建的输入框会出现在所选目录顶端。
• 展开状态记忆：每列的展开 / 选中状态会在重启后恢复。

代码编辑器

Ridge 内置的代码编辑器和终端共享同一套分屏布局：可以把任意分屏切换为编辑器模式，也可以同时存在多个编辑器分屏。

编辑器顶部是文件标签栏，支持横向滚动；标签可以拖拽排序、按 Ctrl + W 关闭。语言识别、语法高亮、括号匹配、查找替换等基础能力均开箱可用。可以在设置里切换主题与编辑器字体。

跨分屏搜索

左侧栏第三个图标（也可按 Ctrl + Shift + F）打开搜索面板。它会同时扫描当前打开的所有工作区与分屏所在的目录——你不需要先选择「在哪里搜」。

支持的开关与过滤：

• 大小写敏感、全词匹配、正则三个独立开关。
• 包含 / 排除路径用 glob 写法（例如 **/*.ts、!node_modules/**）。
• 展开「替换」行后，可以执行批量替换；替换会按仓库根分组提交，避免跨项目误改。
• 搜索为输入防抖触发；按 Enter 立刻执行并取消防抖。点击结果会跳到对应行列。

使用 Git

提交图

左侧栏第二个图标打开源代码管理面板。顶部是当前仓库的提交图，按时间倒序绘制分支拓扑：每个圆点是一个 commit，颜色区分分支，连线表示父子关系。

提交图会随仓库变化自动刷新——执行 git commit、git fetch、切换分支、暂存改动等操作后，无需手动按刷新键。

分支与状态徽章

每个分屏标题栏右侧有一个徽章显示当前分支、未提交改动数、与远端的 ahead / behind 差。

• 点击徽章打开分支选择器，可以切换到任一现有分支。
• 选择器底部有「+ 创建新分支…」，输入分支名按 Enter 即可（基于当前 HEAD）。
• 按住 Ctrl 点击徽章会跳到源代码管理面板。

同一仓库的多个分屏会共享一份缓存的状态，避免重复查询。

暂存与提交

源代码管理面板列出当前仓库的全部改动，分为「未暂存」「已暂存」两组。每个文件支持：

• 查看 diff（点击文件名）。
• 暂存 / 取消暂存（点击 + / − 按钮）。
• 放弃改动 / 删除新文件（右键菜单）。

顶部输入框写提交信息，按 Ctrl + Enter 提交。提交后状态徽章与提交图都会即时更新。如果项目使用 git worktree（同一仓库的多个工作树），Ridge 会识别每个工作树独立的 HEAD 与索引。

与 Claude Code 协作

Ridge 兼容 Claude Code 的多分屏会话协议。从任一分屏内启动 claude（或在分屏标题栏点 Bot 按钮）后，智能体会把 Ridge 当成多分屏会话的容器——它可以新建分屏、命名分屏、列出所有分屏、读取每个分屏的工作目录，乃至关闭分屏。

这意味着：

• 可以让多个智能体同时运行在不同分屏上，互不干扰输出。
• 智能体在另一个目录下的分屏跑命令时，工作目录会被正确识别。
• 从 Ridge 启动的智能体自动获得所需的连接凭证，无需手动配置环境变量。

Bot 按钮会弹出启动器，可选预设 prompt 或留空直接进入交互。按住 Shift 或 Alt 点击可跳过启动器、直接打开裸 claude。

建议从 PowerShell、cmd 或 Windows Terminal 风格的环境里启动 Claude Code，避免一些 shell 在转义参数时引入额外问题。

快捷键

常见问题

启动后显示空白窗口（Windows）

Ridge 在 Windows 依赖系统的 WebView2 运行时。如果安装的是不带 WebView2 的精简版 Windows，请到 Microsoft 官网安装 Microsoft Edge WebView2 Runtime。安装完毕重启 Ridge 即可。

从源码构建时 Rust 编译失败

• 确认 Rust 工具链版本不低于 1.77（rustc --version）。
• Windows 上需要 MSVC（Visual Studio Build Tools 中的 "Desktop development with C++"）；不能只装 GNU 工具链。
• Linux 上参考 Tauri 官方文档的系统依赖清单（webkit2gtk-4.1、libssl-dev 等）。

从源码构建时前端依赖失败

使用 pnpm 9+。如果 pnpm install 卡住，先 pnpm store prune 再重试。

Claude Code 启动后报错找不到分屏

必须从 Ridge 自己的分屏内启动 claude，让它继承 Ridge 的环境。如果你在外部终端启动 Claude Code，它无法找到 Ridge 的本地协调端口，自然也看不到任何分屏。

文件浏览器右键菜单没有反应

菜单依赖于聚焦在文件树上：先用鼠标或 Ctrl + B 切到文件浏览器，再右键点击对应行。

更多帮助

仍未解决？欢迎在 GitHub Issues 提交报告。请附上操作系统版本、Ridge 版本（设置面板可见）以及复现步骤。

Under the hood

Ridge 是一个原生桌面应用，使用 Tauri 作为外壳、Rust 处理终端与文件系统、Svelte 与 TypeScript 构建界面。源码以 MIT 协议在 GitHub 开放。

Ridge 取自田埂——把屏幕分割成可以独立工作的几块。