XU Homepages
xcloud-ai143 downloadsOpen multiple notes as a startup layout, route homepages by weekday and time ranges, and restore the last session.
- Overview
- Scorecard
- Updates11
[!NOTE] 中文说明 启动台：单一主页启动接管——启动时打开主页或恢复上次会话，新标签页直达主页。
接管 Obsidian 的启动行为，功能收敛为四件事：单一主页（设置里选一个文件路径）、启动接管（打开主页或恢复上次会话，下拉二选一）、新标签页直达主页（点「+」或 Ctrl+T）、会话恢复（一键还原上次关闭时打开的全部文件）。
[!IMPORTANT] v2.0.0 破坏性变更 v1.x 的组合主页、星期/时间段条件路由、多窗格布局已移除，设置仅保留单一主页。旧配置中的主页文件路径会自动沿用。
English description below for review purposes. / 以下为英文说明，用于过审。
XU Homepages takes over Obsidian's startup behavior with a single focus: open one homepage or restore the last session on launch, and jump straight to the homepage in every new tab. v2.0.0 breaking change: v1.x profile layouts, weekday/time-based routing and multi-pane opening have been removed; only the single homepage remains and existing homepage paths carry over.
功能特性
- 启动拦截：接管 Obsidian 原生启动行为，严格按配置执行
- 新标签页直达：精准区分「新建标签」与「关闭标签/合并分屏」，只在新建时打开主页
- 会话采集：防抖记录关闭前打开的文件（含卸载兜底落盘）
- 记忆卫生：主页文件被移动时自动跟随更新路径，被删除时提示重新选择
- 双语界面：中文 / English 随时切换
- 移动端兼容：不依赖桌面专属 API
Features
- Startup interception: replaces Obsidian's native startup behavior
- New-tab redirect: reliably tells a new tab apart from closing a tab or merging panes
- Session capture: debounced recording plus an unload-time fallback save
- Memory hygiene: homepage path follows renames automatically and prompts on deletion
- Bilingual UI: Chinese / English switchable at any time
- Mobile friendly: no desktop-only APIs
安装
方式一：从 Obsidian 社区目录安装（推荐）
- 打开 Obsidian 设置 → 社区插件
- 点击「浏览」，搜索 "XU Homepages"
- 点击「安装」，然后「启用」
方式二：手动安装
- 从 最新 Release 下载
main.js、manifest.json、styles.css三个文件 - 在 vault 中创建目录
.obsidian/plugins/xu-homepages/ - 将三个文件放入该目录
- 打开 Obsidian 设置 → 社区插件，找到 XU Homepages 并开启
Installation
From Obsidian Community Directory:
- Open Obsidian Settings → Community Plugins
- Click Browse and search for XU Homepages
- Click Install, then Enable
Manual Installation:
- Download main.js, manifest.json, styles.css from the latest release
- Put them into /.obsidian/plugins/xu-homepages/
- Enable in Settings → Community Plugins
使用方法
- 启用插件后进入设置页，顶部可切换界面语言（中文 / English）
- 主页文件：直接输入 vault 内路径，或点「浏览」从文件列表中选择
- 启动行为（下拉二选一）：打开主页（默认）或恢复上次会话
- 新标签页打开主页（默认开）：点标签栏「+」或 Ctrl+T 直达主页，关闭标签不受影响
Usage
- Open the plugin settings and choose the interface language at the top
- Homepage file: type a vault path, or click Browse to pick from the file list
- Startup behavior (dropdown): Open homepage (default) or Restore last session
- Open homepage in new tab (on by default): the + button and Ctrl+T open the homepage directly
设置说明
| 设置项 | 说明 |
|---|---|
| 界面语言 | 中文 / English 切换，命令名即时跟随 |
| 主页文件 | vault 内路径，可手输或浏览选择；移动/重命名自动跟随 |
| 启动行为 | 打开主页（默认）/ 恢复上次会话 |
| 新标签页打开主页 | 默认开启，仅对「新建标签」生效 |
命令列表
| 命令 | 作用 |
|---|---|
| 打开主页 | 打开设置中指定的主页文件 |
| 恢复上次会话 | 还原上次关闭时打开的全部文件 |
与 Homepage 插件的差异
启动拦截思路借鉴 mirnovov/obsidian-homepage（MIT），独立实现，定位不同：
| 能力 | Homepage | XU Homepages |
|---|---|---|
| 启动打开 | 1 个主页 | 单一主页或恢复上次会话（可选） |
| 会话恢复 | 无 | 一键恢复上次关闭的全部文件 |
| 新标签页主页 | 无 | 「+」按钮 / Ctrl+T 直达主页 |
| 主页移动跟随 | 无 | 重命名/移动自动同步路径 |
兼容提示
- 与 Homepage 插件同时启用会抢启动行为，二者选一；检测到 Homepage 已启用时设置页显示冲突提示
- 与自研系列插件（XU 前缀）无 CSS / 设置键 / 命令冲突
技术说明
- 纯 JavaScript 实现（main.js），main.ts 为 TypeScript 源码参考
- 会话防抖采集 + onunload 兜底落盘；事件注册在 onLayoutReady 内（官方 load-time 规范）
- 兼容移动端（isDesktopOnly: false）
致谢 / Credits
- 启动拦截思路参考 mirnovov/obsidian-homepage（MIT License）
许可证
MIT License - Copyright (c) 2026 旭说