README file from
GithubFolder Pin
在 Obsidian 文件资源管理器中将文件夹钉为标签页，一键切换项目上下文，告别反复展开、折叠和滚动。
为什么做这个插件
同一个 vault 里管理多个大型项目时，每次切换都要展开、折叠、滚动文件树。Folder Pin 让你把文件夹钉为资源管理器标签页的根目录，每个项目拥有独立的聚焦视图，切换只需一次点击。
功能特性
- 文件夹钉为标签页 — 每个标签页以钉选文件夹为根，隐藏其余内容。
- 多资源管理器视图 — 通过命令面板执行
Open another Folder Pin explorer可开启多个独立视图。 - 标签页独立状态 — 展开状态、滚动位置、选中文件均按标签页记忆。
- 布局切换 — 标签栏支持网格等多种布局方式。
- 可选「返回上级」按钮 — 快速从钉选子目录跳回父文件夹。
演示
安装
从社区插件市场安装（上架后可用）
- 打开 Obsidian → 设置 → 第三方插件。
- 搜索 Folder Pin。
- 安装并启用。
手动安装（审核期间的推荐方式）
- 从 GitHub Releases 下载最新版本的
main.js、manifest.json和styles.css。 - 将三个文件放入
<你的 vault>/.obsidian/plugins/folder-pin/。 - 重新加载 Obsidian → 在设置 → 第三方插件中启用 Folder Pin。
使用方法
- 从侧边栏图标打开 Folder Pin 资源管理器视图，或在命令面板中执行
Open another Folder Pin explorer。 - 在资源管理器中右键点击任意文件夹 → Pin as tab，该文件夹即变为新标签页。
- 点击标签页切换上下文，每个标签页独立保留展开状态和滚动位置。
设置项
| 设置项 | 说明 |
|---|---|
| Show "Go up" button | 在每个标签页顶部显示返回父文件夹按钮 |
| Tab layout | 标签栏布局模式：grid、vertical 或 horizontal |
兼容性
- 最低 Obsidian 版本： 1.6.2
- 仅桌面端 — 使用了移动端不可用的 Node API。
开发
npm install
npm run dev # esbuild 监听模式
npm run build # 一次性生产构建 → main.js
测试时将构建产物和 manifest.json / styles.css 软链接或复制到 .obsidian/plugins/folder-pin/ 即可。
许可证
MIT © 2026 Chu HanYu