# 文件浏览器 | Liu Terminal

> Liu Terminal 文件浏览器。侧边栏树通过 OSC 7 集成和远程 SFTP 支持跟随活动标签页的 cwd。

URL: https://liu.software/zh/docs/file-browser/  
Language: zh  
Updated: 2026-10-20

在 Shell 旁浏览工作区的侧边栏树，也可作为完整标签页。本地路径与远程 SFTP 树共用同一界面；打开文件会自动选择查看器：Markdown、代码、纯文本、图像或文件夹内笔记的知识图谱。

**正在重写中。** 核心逻辑位于 src/ui/filebrowser.c 和 src/ui/fileops.c；Markdown 渲染接入 src/ui/markdown/。格式和查看器 API 仍在变动：提交涉及它们的 PR 前请先开 Issue。

## 打开

⌘ K → Toggle File Browser 显示或隐藏侧边栏树。若 Shell 提示中接入了 OSC 7，浏览器会跟随活动终端标签的 cwd；否则 Liu 回退到 proc\_pidinfo（macOS）或 /proc/\<pid\>/cwd（Linux）。

也可从标签栏将浏览器拆分为独立标签页（file-browser 标签类型），或用 ⌘ K → Open Vault 打开 Notes Vault 文件夹。设置 → Notes Vault 配置 Open Note、Graph View 和 Search Notes 使用的库路径。

## 查看模式

点击文件会打开右侧查看面板（图谱/Markdown 可为纯查看器布局）。Liu 根据扩展名选择模式：

- **Markdown**: .md / .markdown → 样式化渲染器（见 Markdown 页）。
- **代码**: 带语法高亮的源码，可选编辑器。
- **文本 / 图像 / 二进制**: 纯文本编辑器、GPU 图像预览，或未知类型的十六进制式转储。
- **图谱**: 文件夹（库或当前目录）内 .md 文件的力导向链接图。

## 文件操作

⌘-点击与 Shift-点击范围实现多选。上下文操作包括重命名、删除、复制/移动（两侧均已挂载时支持本地与 SFTP 跨面板拖拽），以及创建文件/文件夹提示。SFTP 列表在阻塞作用域中运行 libssh2，避免 readdir 在 EAGAIN 时被截断。

## 命令面板入口

- `Open Note`: Notes Vault 内的 Markdown 快速切换器。
- `Search Notes`: 库内 Markdown 文件全文搜索。
- `Go to Heading`: 已打开 Markdown 文档的大纲选择器。
- `Graph View` / `Graph Current Folder`: 为库或活动目录打开知识图谱。

[下一步 代码编辑器 →](https://liu.software/zh/docs/code-editor.md)