Obsidian Home

为 Obsidian 添加一个美观实用的首页功能，便于快速访问和搜索笔记。

功能特点

• 自定义首页视图：现代化界面设计，清晰展示置顶笔记和最近打开的笔记
• 智能搜索：实时搜索笔记，弹窗显示搜索结果
• 笔记置顶：支持多种方式置顶和管理重要笔记
• 右键菜单支持：在文件浏览器中右键点击笔记可快速置顶/取消置顶
• 拖拽排序：设置中支持通过拖拽调整置顶笔记顺序
• 自动更新：当笔记重命名或删除时，相关列表自动更新
• 新标签页替换：可选择在新标签页中显示首页内容
• 自定义选项：灵活调整首页外观和行为

安装方法

1. 从 GitHub Releases 页面下载最新版本的以下文件：
   • main.js
   • manifest.json
   • styles.css
2. 在你的 Obsidian 库的 .obsidian/plugins/ 目录下创建 obsidian-home 文件夹
3. 将下载的文件放入 obsidian-home 文件夹中
4. 重启 Obsidian
5. 在设置 > 第三方插件中启用 Home 插件

或者使用 BRAT 插件 安装：

1. 安装 BRAT 插件
2. 在 BRAT 设置中添加本插件仓库路径：dlzmoe/obsidian-home
3. 启用 Home 插件

使用指南

打开首页

有三种方式可以打开首页：

1. 点击左侧边栏中的"首页"图标
2. 使用命令面板（Ctrl/Cmd + P）并搜索"打开首页"
3. 打开新标签页时将自动显示首页（如已启用该功能）

笔记置顶管理

有多种方式管理置顶笔记：

1. 右键菜单：在文件浏览器中右键点击任何笔记，选择"置顶到首页"
2. 命令面板：打开命令面板并搜索"置顶当前笔记"
3. 设置页面：在插件设置的"置顶笔记管理"部分添加或删除置顶笔记

调整置顶笔记顺序

在设置页面中，你可以通过以下方式调整置顶笔记的顺序：

1. 拖拽排序：直接拖动笔记项目可调整其位置
2. 快速操作：使用每个笔记项目右侧的按钮也可以快速操作：
   • 删除置顶笔记
   • 打开笔记

搜索笔记

在首页顶部的搜索框中输入关键词，可以实时搜索笔记：

• 搜索结果以弹窗形式显示
• 点击任何搜索结果可直接打开相应笔记
• 点击搜索框以外的区域可关闭搜索结果弹窗

插件设置

在设置 > 插件选项 > Home 中可以调整以下选项：

• 启动时打开首页：设置 Obsidian 启动时是否自动打开首页
• 替换新标签页：设置新标签页是否显示首页内容
• 搜索占位符：自定义搜索框中的提示文本
• 最大最近笔记数：调整最近打开列表中显示的笔记数量（0-30）
• 最大置顶笔记数：调整可置顶的最大笔记数量（0-30）

常见问题

问：如何在首页显示更多的最近打开笔记？
答：在插件设置中调整"最大最近笔记数"的值即可。

问：文件重命名后，置顶列表中的名称会自动更新吗？
答：会，插件会监听文件重命名事件并自动更新置顶列表和最近文件列表中的名称。

问：可以将已删除的笔记从列表中移除吗？
答：插件会自动监测并从列表中移除已删除的笔记，无需手动操作。

问题反馈

如果您在使用过程中遇到任何问题或有改进建议，欢迎通过以下方式反馈：

• 提交 Issue

许可证

本插件采用 MIT 许可证 发布。