Tab Settings Enhanced

Enhanced tab management for Obsidian: control where new tabs open, navigate tabs with a keyboard-driven navigator, and colorize parent-child tab relationships.

Tab Settings Enhanced 是一款 Obsidian 标签管理增强插件，提供精细化的新标签打开位置控制、关闭后激活策略、防重复标签、父子标签颜色标记，以及一个键盘驱动的「标签导航器」模态框（序列快捷键切换 + 搜索 + 历史恢复）。

• 版本：1.6.11
• 最低 Obsidian 版本：1.4.0
• 作者：CTA System
• 平台：桌面端 & 移动端
• 开源协议：MIT

✨ 功能特性

1. 新标签打开位置控制

通过 patch workspace.openLinkText，拦截所有文件打开行为，按你的偏好放置新标签。

2. 关闭标签后激活策略

关闭当前标签时，自动激活哪个标签。

3. 新标签打开行为

• 默认在新标签打开 (openInNewTab)：所有链接点击默认在新标签打开。

• 快速切换器默认新标签打开 (openQuickSwitchInNewTab)：通过 Ctrl+O 快速切换器打开文件时，独立控制是否新标签打开，与上面的开关解耦。

  场景	openInNewTab	openQuickSwitchInNewTab	结果
  链接点击	false	false	当前标签打开
  链接点击	true	false	新标签打开
  快速切换器	false	true	新标签打开
  快速切换器	true	*	新标签打开

• 防止重复标签 (deduplicateTabs)：打开已存在的文件时，自动切换到已有标签，而非新开一个。

• 面板链接默认新标签打开 (openPanelLinkInNewTab)：在 书签 / 搜索 / 文件列表 / 入链(Backlinks) / 出链(Outgoing Links) 面板中点击文件链接时，默认在新标签打开。默认关闭（保持 Obsidian 原生单击行为）。

4. 标签颜色标记

为父子标签分配同色系，让标签层级关系一目了然。

• 配色方案 (colorPalette)：内置 7 套配色
  • 🌿 莫兰迪 Morandi（默认）
  • 🎨 鲜明 Vivid
  • 🌈 彩虹 Rainbow
  • 🌊 海洋 Ocean
  • 🍬 糖果 Candy
  • 💡 霓虹 Neon
  • 🎲 随机 Random（动态生成，色相差 60° 以上）
• 颜色透明度 (colorOpacity)：0 ~ 1，默认 0.3
• 视觉呈现：标签头下方绘制与父子关系同色的下划线（左对齐、向右生长），宽度按 未激活 10% / hover 20% / 激活 30% 递进，点击激活或去重激活时有弹簧脉冲反馈（30% → 90% → 30%）；未配置颜色的标签使用主题灰兜底，同样享受全套动画。

5. 标签导航器（Tab Navigator）

一个键盘驱动的标签切换模态框，集字母快捷切换、名称搜索、快捷关闭、历史恢复于一体。

默认快捷键：Alt + T（可在 设置 → 快捷键 中自定义）

模态框布局

┌─────────────────────────────────────────────┐
│  🔍 搜索标签...                              │  ← 输入框（自动聚焦）
├─────────────────────────────────────────────┤
│  📂 打开的标签                               │
│  [a]  📄 笔记标题1               [×]        │  ← 字母键 + 标题 + 关闭按钮
│  [s]  📄 笔记标题2               [×]        │
├─────────────────────────────────────────────┤
│  🕒 最近关闭                                 │
│  [k]  📄 已关闭的笔记1            ↩         │  ← 字母键 + 标题 + 恢复按钮
└─────────────────────────────────────────────┘
   点按 Alt 进入打开模式 | 点按 Ctrl 进入关闭模式 | ↑↓ 选择 | Enter 确认 | ESC 退出

键盘交互

特性

• 序列快捷键（点按前导键）：先点按 Alt/Ctrl 进入打开/关闭模式，再按字母执行。采用「点按检测」而非组合键——Alt+A、Ctrl+C 等组合键原样放行，不会劫持系统或全局快捷键；进入模式后焦点自动移出搜索框，拼音输入法下无需切换输入法，字母键直达执行。
• 实时搜索：匹配文件名、完整路径、父文件夹名（不区分大小写）。
• 历史恢复：自动记录最近关闭的 30 条标签，可在「最近关闭」区域一键恢复。
• 去重显示：已打开的标签不会在历史区域重复出现。
• 搜索覆盖历史：搜索结果同时包含打开的标签和历史标签。
• 归档区：右侧边栏顶部为「已归档」模块（见下方功能 8）。

6. 标签切换/移动快捷键

通过命令面板或自定义快捷键快速切换标签。所有快捷键均可在 设置 → 快捷键 中修改。

编号顺序按 固定标签在前、普通标签在后 排列（各自保持标签栏原有相对顺序）。

7. 每标签导航历史（Per-Tab History）

• 复用 Obsidian 内置的每标签(per-pane)导航历史（v0.16.3+ 核心功能），本插件不另建历史栈，因此与内置 Ctrl+Alt+←/→ 完全一致、且随工作区持久化。
• 历史计数显示在原生 返回/前进 按钮旁（视图标题栏的 [←]3 [→]1，0 也显示），数据直接读自 leaf.history。需开启 设置 → 外观 → 显示标签标题栏。
• 鼠标侧键导航：第 4 键 = 后退，第 5 键 = 前进（底层调用内置 app:go-back / app:go-forward 命令）。
• 设置项：启用鼠标侧键标签导航历史 (enableMouseSideNav)、显示历史计数 (historyShowCount)。
• 与标签导航器联动：每个打开的标签会显示其 ◀N ▶M 历史计数。

8. 自动归档（Auto-Archive）+ 专注模式

• 默认关闭，需在设置中启用。
• 可配置闲置超时（默认 30 分钟）：每分钟检查一次，非固定、非当前活动且闲置超时的标签自动关闭并进入归档区。
• 归档区显示在标签导航器右侧边栏顶部（「最近关闭」上方），归档标签可点击恢复。
• 归档历史上限可配置（默认 100 条），超限时移除最旧记录。
• 专注模式：一键关闭所有非固定标签（全部进入归档区）。开启入口：① 命令面板命令；② 标签页右键菜单（标签的更多选项）。
• 启用开关 (enableFocusMode，默认开)：关闭后命令与右键菜单项均不可用。

9. 焦点锁定（Focus Lock）

• 两个独立设置项：
  • 显示状态栏按钮 (enableFocusLock)：控制状态栏是否显示焦点锁定切换按钮。
  • 焦点锁定 (focusLockOn)：直接控制锁定开/关，与状态栏图标双向联动（改任一处，另一处同步）。
• 状态栏图标采用 lucide SVG：锁定 = locate-fixed（定位已固定），未锁定 = locate-off；锁定态高亮强调色，未锁定态半透明。
• 锁定开启后，点击侧边栏面板（文件树、搜索、标签面板等）不会偷走主编辑区焦点，链接也不会打开到错误的窗格。
• 若正在侧边栏输入框中输入，则不打断输入。
• 锁定状态随 data.json 持久化保存，重启后保持。

10. 禅模式（Zen Mode）

• 一键进入心流写作状态：隐藏所有无关 UI —— 左侧图标栏(ribbon)、左右侧边栏、状态栏、标签栏、笔记标题栏、窗口标题栏全部隐藏，当前笔记内容全屏铺满（不固定宽度，更霸气）。
• 进入方式：① 命令面板「禅模式」；② 点击左侧 Ribbon 羽毛笔图标；③ 标签页右键菜单；④ 可自定义快捷键。
• 退出方式：按 ESC、再次执行命令、或再次点击羽毛笔图标。
• 进入时自动把焦点放回当前编辑器，右上角有 ESC 退出提示。
• 启用开关 (enableZenMode，默认开)：关闭后命令/羽毛笔图标/右键菜单均不可用（若在禅模式中则自动退出）。

11. 设置页快捷键一览

• 设置页底部新增「⌨️ 快捷键」分区：列出所有命令及默认快捷键（含鼠标侧键），并提供「打开快捷键设置」按钮一键跳转，方便自定义。

🌐 多语言支持

内置中文 / 英文双语，并支持自动跟随 Obsidian 界面语言。

📦 安装

方式一：社区插件商店（推荐）

1. 打开 设置 → 第三方插件 → 社区插件市场 → 浏览。
2. 搜索 Tab Settings Enhanced，点击安装。
3. 安装完成后，在已安装插件列表中点击启用。

方式二：手动安装

1. 下载 main.js 与 manifest.json（data.json 为插件运行时自动生成的用户数据，无需下载）。
2. 在 Obsidian Vault 中创建目录：.obsidian/plugins/tab-settings-enhanced/
3. 将下载的文件放入该目录。
4. 在 Obsidian 中打开 设置 → 第三方插件，关闭「安全模式」。
5. 在插件列表中找到 Tab Settings Enhanced，点击启用。

方式三：从源码构建（开发者）

本项目无构建流程，main.js 即插件本体（手写、未压缩、未混淆），克隆后可直接使用：

git clone https://github.com/wonderez/tab-settings-enhanced.git

将 main.js 与 manifest.json 复制（或软链接）到 <你的Vault>/.obsidian/plugins/tab-settings-enhanced/，在 Obsidian 中启用即可。修改代码后建议运行 node --check main.js 校验语法。

⚙️ 配置项一览

所有配置存储在 .obsidian/plugins/tab-settings-enhanced/data.json，亦可在 设置 → Tab Settings Enhanced 中可视化调整。

标签导航器的历史记录（closedTabsHistory，最多 30 条）与归档区（archivedTabs）也会写入 data.json 持久化保存。

⌨️ 命令与快捷键

所有快捷键均可在 设置 → 快捷键 中自定义。

🛠️ 实现原理简述

• 打开行为拦截：通过 patchOpenLink() 重写 workspace.openLinkText，根据 newTabPlacement 决定新标签插入位置，并通过 DOM 检测快速切换器模态框判断调用来源。
• 关闭行为拦截：通过 patchLeafDetach() 重写 WorkspaceLeaf.prototype.detach，在标签关闭前记录历史，并按 closeTabActivation 策略激活下一个标签。
• 父子关系追踪：维护父子标签映射，用于颜色分配与关闭后回到父标签。
• 颜色分配：从选定配色方案中按父子层级分配颜色，同色系标识父子关系。
• 标签导航器：TabNavigatorModal 继承自 obsidian.Modal，独立实现字母分配、搜索过滤、键盘事件处理。

完整设计文档见 IMPLEMENTATION_PLAN.md。

🔒 兼容性与注意事项

• 完全向下兼容，所有新增配置默认值与原行为一致。
• 通过 register() 注册还原函数，插件卸载时自动恢复所有 patch，不污染 Obsidian 原生行为。
• 标签导航器模态框是独立的，不修改原生快速切换器，与 Quick Switcher++ 等插件无冲突。
• 历史记录仅存储路径信息（不存文件内容），最多 30 条，内存占用极低。

📁 项目结构

tab-settings-enhanced/
├── manifest.json            # Obsidian 插件清单
├── main.js                  # 插件主文件（可直接安装使用）
├── LICENSE                  # MIT 开源协议
├── IMPLEMENTATION_PLAN.md   # 功能增强实现方案（设计文档）
└── README.md                # 本文件

data.json（用户配置与历史记录）由插件运行时自动生成，含个人笔记路径，不纳入版本库。

📝 更新日志

v1.6.11

• 标签颜色下划线宽度收窄为 10% / 20% / 30%（未激活 / hover / 激活），脉冲峰值 100% → 90%；无层级关系的标签增加灰色兜底下划线，同样享受 hover、激活与点击脉冲动画。

v1.6.1 ~ v1.6.10（概要）

• v1.6.1：16 项 bug 修复——自动归档对「从未激活标签」失效、最近关闭历史不持久化、入链/出链面板点击同文件双开、parentMap 环保护、popout 浮动窗口误判、历史徽标滞后等。
• v1.6.2：标签导航器改为「点按前导键」序列快捷键（点按 Alt=打开模式 / Ctrl=关闭模式），不再劫持 Alt+字母 等全局快捷键；下划线改为标题下方居中、弹簧动画、激活 60%。
• v1.6.3：序列快捷键兼容拼音输入法——进入模式后焦点移出搜索框，IME 不介入，无需切换输入法。
• v1.6.4 ~ v1.6.10：下划线视觉持续打磨——改用独立子元素避开原生伪元素冲突、去重激活「下划线脉冲」替代原生黄色闪烁、左对齐向右生长、高度/不透明度三档层级、左偏移 6px、峰值 90%。

v1.6.0

• 修复标签右键菜单：tab-context-menu 事件不可靠，改为纯 DOM 注入方案——监听标签头 contextmenu，等原生菜单弹出后往 .menu 注入菜单项，稳定可用。禅模式项也加入右键菜单。
• 禅模式全屏铺满：取消固定宽度（880px），笔记内容占满全屏，更霸气。
• 新增功能开关：enableFocusMode（专注模式）与 enableZenMode（禅模式），默认开启；关闭后对应命令/图标/右键菜单项均不可用，禅模式开关关闭时自动退出禅模式并隐藏羽毛笔图标。
• 设置页快捷键一览：新增「⌨️ 快捷键」分区，列出所有命令及默认快捷键（含鼠标侧键），附「打开快捷键设置」按钮一键跳转自定义。

v1.5.0

• 每标签导航历史设置简化：移除「启用每标签导航历史」（系统内置功能，无需开关），替换为「启用鼠标侧键标签导航历史」(enableMouseSideNav)。
• 历史计数位置调整：从标签头徽标改为显示在原生 返回/前进 按钮旁（视图标题栏 [←]3 [→]1），0 也显示数字。
• 专注模式入口扩展：除命令面板外，新增到标签页右键菜单（标签的更多选项），一键开启。
• 新增禅模式（Zen Mode）：隐藏 ribbon/侧边栏/状态栏/标签栏/标题栏等所有无关 UI，笔记内容居中限宽全屏显示，专注写作；命令/Ribbon 羽毛笔图标进入，ESC 退出。

v1.4.0

• 重构 Per-Tab History：改为复用 Obsidian 内置 leaf.history（不再自建历史栈），计数/侧键与内置 Ctrl+Alt+←/→ 完全一致，且随工作区持久化。代码更简洁。
• 焦点锁定优化：拆分为「显示状态栏按钮」+「焦点锁定开关」两个独立设置项，双向联动；状态栏图标由 emoji 换成 lucide SVG（locate-fixed/locate-off），锁定态高亮。
• 新增面板链接开关 openPanelLinkInNewTab：书签 / 搜索 / 文件列表 / 入链 / 出链面板点击文件链接时默认新标签打开（默认关闭）。

v1.3.0

• 新增 标签切换/移动快捷键：Alt+1~9 跳转、Alt+←/→ 前后切换（固定标签在前排序）
• 新增 每标签独立导航历史：前进/后退栈、标签头计数徽标（◀3 ▶1）、鼠标侧键支持、与标签导航器联动显示
• 新增 自动归档：闲置超时自动关闭非固定标签进入归档区（可恢复）、归档上限可配、专注模式命令一键关闭所有非固定标签
• 新增 焦点锁定：状态栏图标点击切换，防止侧边栏偷走编辑器焦点，状态持久化
• 关闭历史与归档区改为持久化存储（写入 data.json）

v1.2.2

• 新增「快速切换器默认新标签打开」独立开关
• 新增标签导航器（Tab Navigator）模态框
  • 字母快捷切换、名称搜索、Ctrl+字母关闭、历史恢复
• 多语言完善

早期版本

• 新标签打开位置控制（5 种策略）
• 关闭标签后激活策略（6 种策略）
• 防止重复标签
• 父子标签颜色标记（7 套配色）

💖 支持

如果这个插件对你有帮助，欢迎在 GitHub 上点个 Star，或提交 Issue 反馈问题与建议。

License

本项目基于 MIT License 开源，Copyright (c) 2026 CTA System。