- Overview
- Scorecard
- Updates13
固定常用文件夹，在 Obsidian 中快速切换目录、浏览笔记和拖动整理文件。
Pin favorite folders, browse notes, and organize files with drag and drop in Obsidian.
2.2.9 · Obsidian 1.13.0+ · MIT
功能 / Features
| 中文 | English |
|---|---|
| 固定与布局：母目录、子目录快速切换；支持横版两排、竖版两列及高度调整。 | Pin and navigate: Switch between folders and subfolders in horizontal rows or resizable vertical columns. |
| 清晰层级：统一缩进和细线，适配主题与显示缩放；记忆排序、展开和滚动位置。 | Clear hierarchy: Consistent thin guides across themes and display scales; saved sorting, expansion, and scroll. |
| 拖动与批量操作：移动笔记和整个文件夹，支持直接拖动子目录入口；多选后批量打开、移动、删除。 | Drag and batch actions: Move notes and entire folders, including from subfolder shortcuts; open, move, or delete selections. |
| 顶部路径定位：默认在文件区中定位笔记顶部的文件夹路径；未固定目录临时浏览，可关闭此功能。 | Header path navigation: Browse header folder paths in this panel by default, including unpinned folders; optional in settings. |
| 右键创建与扩展：新建笔记、文件夹优先，接入白板、数据库及第三方文件菜单。 | Creation and integrations: Notes and folders lead the menu, followed by Canvas, Bases, and third-party file actions. |
| 搜索与原生操作：搜索当前目录内容；Ctrl/Cmd 或中键新标签页打开，拖到编辑器或白板。 | Search and native workflows: Search folder contents, open new tabs with Ctrl/Cmd or middle-click, and drag into editors or Canvas. |
安装与更新 / Install and update
从 Releases 下载并解压安装包，将 main.js、manifest.json、styles.css 放入笔记库的 .obsidian/plugins/folder-pin-view/，然后启用插件。
Download a package from Releases. Extract the three files into your vault's .obsidian/plugins/folder-pin-view/ directory, then enable the plugin.
更新时先停用插件，替换这三个文件，保留 data.json，再启用。
To update, disable the plugin, replace the three files, keep data.json, then enable it again.
使用 / Usage
- 右键文件夹选择“固定文件夹”。点击母目录浏览完整内容，点击子目录切换范围；在插件设置中切换横竖布局。
Right-click a folder to pin it. Select a parent or child to browse its contents; choose a layout in the plugin settings. - 拖动母目录入口调整顺序。子目录入口拖到同栏按钮边缘为排序，拖到文件夹中央为移入；插入线和目标高亮区分两种操作，Esc 取消。
Drag parent shortcuts to reorder. Drag child shortcuts to an edge to reorder or a folder's center to move. Insertion lines and highlights distinguish the actions; Escape cancels. - 普通点击笔记顶部的文件夹路径，在文件区中定位，当前笔记保持打开；关闭“点击笔记路径时在文件区中定位”可恢复原生行为。
Plain-click a header folder path to locate it here without changing the note. Disable Locate header paths in Folder Pin View to restore native behavior. - 右键开启多选模式，Shift 连选后执行批量操作；点击放大镜搜索当前目录及其子目录。
Enter selection mode from the context menu, use Shift for ranges, and apply batch actions. The magnifier searches the current folder and its descendants.
目录搜索需启用“搜索”核心插件；白板、数据库及第三方菜单取决于对应插件。
Folder search requires the Search core plugin. Canvas, Bases, and third-party actions depend on their respective plugins.
2.2.9 更新 / What's new in 2.2.9
展开区拖放：拖到展开的内容区时，高亮目标文件夹及其可见内容。拖到列表空白处可移入当前目录。
Folder drop zones: Drop into expanded folders with a highlight across the destination folder and its visible contents. Drop on empty list space to move into the current folder.
隐藏重复子目录：可关闭一级内容区里的子文件夹行，通过二级快捷栏进入。
Cleaner parent lists: Optionally hide duplicate subfolder rows while keeping their shortcuts available.
竖版导航：一级、二级快捷栏隐藏滑块，保留滚轮、触摸和键盘滚动。
Vertical navigation: Shortcut columns hide scrollbars and remain scrollable by wheel, touch, and keyboard.
定位与整理：临时浏览时显示当前路径和返回入口。「移动到…」优先列出最近成功移入的目录。
Navigation and organization: Temporary browsing shows the current path and a return action. Move to… prioritizes recent destinations.
减少重复工作：批量移动合并刷新，拖动时复用预检，后台更新按受影响目录刷新。
Less repeated work: Batch moves consolidate refreshes, drag previews reuse validation, and background refreshes are scoped to affected folders.
更早版本见 发布记录 / Earlier releases。
开发与验证 / Development and validation
Node.js 24:
npm ci
npm run typecheck
npm test
npm run build
npm run dev 监听源码变化。可选浏览器检查：node tests/browser-check.mjs，需要 Playwright 和 Chromium；可用 FPV_PLAYWRIGHT_MODULE、FPV_BROWSER_EXECUTABLE 指定已有安装。
npm run dev watches source changes. Optional browser QA: node tests/browser-check.mjs requires Playwright and Chromium; the two environment variables above can select existing installations.
隐私 / Privacy
插件无网络请求、无遥测。设置仅保存在当前笔记库的插件目录 data.json 中。
The plugin makes no network requests and collects no telemetry. Settings stay in the plugin's data.json within the current vault.