# obsidian-set-init-up

**Repository Path**: wn2019/obsidian-set-init-up

## Basic Information

- **Project Name**: obsidian-set-init-up
- **Description**: obsdian插件，打开obsdian插件后两侧侧边栏默认打开界面、可以显示的工具条，主要在ipad上使用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-25
- **Last Updated**: 2026-09-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Obsdian

## README

# Set Init up

配置 Obsidian 启动时左右侧边栏默认面板与默认打开的笔记，并提供 iPad / iPhone 上的侧边栏面板关闭与恢复功能（补上移动端没有右键菜单的短板）。

- 支持平台：Windows / macOS / Linux 桌面端，iPad / iPhone 移动端
- 最低 Obsidian 版本：1.4.0
- 当前版本：**1.3.2**

---

## 功能说明

### 1. 启动默认布局

- **左右侧边栏默认面板**：启动时自动把左侧 / 右侧侧边栏切换到指定面板（文件列表、搜索、书签、大纲、出链，以及已安装插件注册的面板如日历、表格工具栏等，运行时自动发现）。
- **启动展开控制**：可分别设置启动后是否自动展开左 / 右侧边栏（iPhone 屏幕小，默认不展开）。
- **应用延迟**：启动后等待一段时间再应用，避免与其他插件竞争；移动端默认 1500ms，桌面端 300ms，可在 0–5000ms 之间调整。
- **启动时自动应用**：总开关，可关闭改为手动应用。

### 2. 默认笔记

- **启动自动打开指定笔记**：支持省略 `.md` 扩展名的路径写法；可从库中模糊搜索浏览选择，或一键「使用当前」。
- **打开模式**：编辑模式 / 阅读模式 / 跟随 Obsidian 默认。
- **新标签页打开**：可配置复用当前标签页或在新标签页打开。

### 3. 侧边栏面板管理（v1.3.1+，iPad 重点适配）

动态列出左右侧边栏**当前实际打开**的面板标签，按左侧 / 右侧分组：

- **关闭面板**：每个面板一个「关闭」按钮，效果与电脑端右键标签 → 关闭完全一致。iPad / iPhone 没有右键菜单，此前无法关闭多余面板，此功能即为补齐。
- **添加 / 恢复面板**（v1.3.2+）：每侧列表下方提供下拉框 + 「添加」按钮，可恢复刚关闭的面板，或新开任意可用面板到该侧；下拉自动过滤该侧已打开的项，避免重复。
- **刷新列表**：安装或启停插件后重新检测面板。
- 面板全部关闭后仍可继续添加恢复。

### 4. 命令

| 命令 | 说明 |
| --- | --- |
| 应用默认侧边栏布局 | 立即按设置切换左右侧边栏面板并修正展开状态 |
| 捕获当前侧边栏面板为默认 | 把当前左右侧边栏正在显示的面板保存为默认值 |
| 打开默认笔记 | 立即打开设置中配置的默认笔记 |

### 5. iPad / iPhone 适配

- 全部使用 Obsidian 原生 Setting 组件，触屏操作无障碍。
- 「关闭」「添加」按钮行点击区域 ≥44px（触屏标准）。
- 移动端默认应用延迟加大，适配 iPad / iPhone 渲染节奏。
- 优先使用 Obsidian 1.7.2+ 的 `ensureSideLeaf` 官方 API，旧版本自动回退兼容。

---

## 使用方法

1. 将 `main.js`、`manifest.json`、`styles.css` 放入库的 `.obsidian/plugins/set-init-up/` 目录。
2. 在 Obsidian 设置 → 第三方插件中启用「Set Init up」。
3. 在 设置 → Set Init up 中配置：
   - 「启动行为」：是否自动应用、延迟时间。
   - 「侧边栏面板管理」：关闭 / 添加实际打开的面板。
   - 「左侧 / 右侧侧边栏」：默认面板与启动展开行为。
   - 「默认笔记」：启动自动打开的笔记及打开方式。
4. 可用「手动操作」中的「捕获当前」「应用」快速验证效果。

## 开发与构建

```bash
npm install
npm run build   # 类型检查 + esbuild 生产构建，产物 main.js
```

---

## 版本说明

### v1.3.2（2026-09-25）

- 「侧边栏面板管理」新增「添加面板」：每侧列表下方提供下拉框 + 「添加」按钮，可把刚关闭的面板恢复回来，或新开任意可用面板到该侧（自动过滤该侧已打开的项，避免重复）。
- 侧边栏面板全部关闭后仍可继续添加（修复空列表时无法恢复的问题）。

### v1.3.1（2026-09-25）

- 新增「侧边栏面板管理」：按左侧 / 右侧分别动态列出侧边栏当前实际打开的面板标签，可逐个点击「关闭」，效果与电脑端右键标签 → 关闭完全一致（iPad / iPhone 没有右键菜单，此前无法关闭多余面板）。
- 面板列表实时检测（内置面板 + 已安装插件面板），显示每个面板的名称、视图类型与是否当前显示中，关闭后列表自动刷新。
- 适配 iPad / iPhone：「关闭」按钮行加大点击区域（≥44px），使用原生 Setting 组件，触屏操作无障碍。
- 按需求澄清移除 v1.3.0 的「面板下拉选项管理」（下拉框选项过滤）功能。

### v1.3.0（2026-09-25）

- （已被 v1.3.1 取代）曾提供「面板下拉选项管理」：过滤设置页下拉框中的面板选项。
- 设置页新增「版本与更新说明」区块，可随时查看功能说明与补丁记录。

### v1.2.0（2026-09-16）

- 新增「捕获当前侧边栏面板为默认」命令与设置项。
- 支持 Obsidian 1.7.2+ 的 `ensureSideLeaf` 官方 API，旧版本自动回退。
- 移动端默认延迟加大，适配 iPad / iPhone 渲染节奏。

### v1.1.0（2026-09-10）

- 支持配置左右侧边栏默认面板与启动展开行为。
- 支持启动时自动打开默认笔记（可选编辑 / 阅读模式、新标签页）。

### v1.0.0（2026-09-09）

- 首个版本：启动时应用默认侧边栏布局。

---

## 许可证

MIT