Last Position

English | 中文

Last Position 是一个 Obsidian 插件，用于按标签页自动保存和恢复 Markdown 笔记的滚动位置，让阅读、编辑和工作区切换保持连续。

功能

• 按标签页保存和恢复位置，支持编辑模式、阅读模式、分栏和同一文件的多个标签页。
• 尊重标题与块引用锚点导航，不使用历史位置覆盖目标锚点。
• 提供“跳转到上次位置”命令，随时返回当前文件已保存的位置。
• 提供位置书签，可命名保存、搜索跳转和删除；重名书签会自动添加数字后缀。
• 状态栏显示当前高度；左键保存书签，右键打开当前文件的书签列表。
• 支持固定恢复延迟和智能恢复延迟（Beta），并可配置最大重试次数及重试间隔。
• 支持位置数据表、分页、删除、JSON 导入导出和过期数据自动清理。
• 界面支持中文和英文，可在桌面端和移动端 Obsidian 中使用。

安装

社区插件

1. 打开 Obsidian 的“设置 → 社区插件”。
2. 关闭安全模式（如有提示），点击“浏览”。
3. 搜索 “Last Position”，点击“安装”，然后启用插件。

从 GitHub Release 手动安装

1. 从 Releases 页面下载同一版本的 main.js、manifest.json 和 styles.css。
2. 在 Obsidian 库（Vault）的 .obsidian/plugins/ 目录下创建 last-position 文件夹。
3. 将三个文件放入 .obsidian/plugins/last-position/。
4. 重新加载 Obsidian，在“设置 → 社区插件”中启用 Last Position。

需要 Obsidian 1.8.0 或更高版本。

使用

插件启用后会自动记录 Markdown 视图的位置，并在再次打开文件或切换标签页时恢复。标题链接和块引用链接的目标位置优先于历史位置。

可从命令面板使用以下命令：

• Last Position: 跳转到上次位置
• Last Position: 保存书签
• Last Position: 选择书签
• Last Position: 删除书签

状态栏显示当前滚动高度。左键点击状态栏可保存当前位置为书签；右键点击可直接打开当前文件的书签列表。

配置

• 自动保存：保存位置的 debounce 间隔，默认 3 秒；修改后重启插件生效。
• 监听事件：触发位置保存的事件，支持鼠标悬停、点击或滚动，默认 mouseover；修改后重启插件生效。
• 智能恢复延迟（Beta）：根据来源和目标笔记的字数计算恢复延迟，默认关闭；启用后忽略固定恢复延迟。
• 恢复延迟：智能延迟关闭时使用的固定等待时间，默认 300 毫秒。
• 重试次数：恢复位置的最大尝试次数，默认 30 次；修改后重启插件生效。
• 恢复重试间隔：两次恢复尝试之间的等待时间，默认 100 毫秒。
• 每页显示条目数：位置数据表每页显示 5、10、20 或 50 条，默认 10 条。
• 自动清理：插件启动时清理超过保留天数的位置数据，默认关闭。
• 清理天数：可设置为 7–365 天，默认 30 天。
• 数据导入导出：将位置和书签导出为 JSON，或把经过校验的兼容数据合并导入当前数据。

注意事项

• 书签记录的是滚动高度；如果文档内容大幅变化，书签对应的位置可能发生偏移。
• 长文档或包含大量异步渲染内容的笔记可能需要更长的恢复延迟或更多重试次数。
• main.js 不纳入源码仓库提交，应从 GitHub Release 附件下载。
• 如遇问题，请在 GitHub Issues 中反馈，并附上 Obsidian 版本、平台和复现步骤。

许可证

本项目使用 MIT License。