VS Code Tab Guardian

一款为你守护 VS Code 工作区的扩展，自动管理标签页数量，让你的工作空间保持整洁与高效。

✨ 功能特性

• 数量控制：限制工作区中最多打开的标签页数量，默认为 6 个。
• 智能清理：当打开新标签导致总数超过上限时，采用 LRU (最近最少使用) 策略自动关闭不活跃的标签。
• 人性化保护：
  • 绝不关闭已固定 (Pinned) 的标签：让你重要的文件始终可见。
  • 绝不关闭有未保存更改 (Dirty) 的标签：确保你的辛勤工作不会丢失。
  • 绝不关闭当前活动标签：避免打断你当前的工作心流。
• 状态栏总览：在右下角状态栏实时显示“当前标签数 / 最大限制”，一目了然。
• 手动触发：提供“立即清理”命令，让你随时可以一键整理标签页。
• 高度可配置：允许你根据自己的习惯调整各项功能。

📦 安装与本地调试

本项目为纯源码交付，你可以轻松在本地运行和调试。

1. 克隆或下载项目： 将 vscode-tab-guardian 文件夹放置在你的本地文件系统中。

2. 安装依赖： 在 VS Code 中打开 vscode-tab-guardian 文件夹，然后打开集成终端，运行以下命令：

   npm install
   

3. 编译 TypeScript： 继续在终端中运行编译命令：

   npm run compile
   

   或者，使用 Ctrl+Shift+B (Windows/Linux) 或 Cmd+Shift+B (Mac) 调出构建任务，选择 npm: compile。

4. 启动调试：

   • 按 F5 键。
   • 这会启动一个新的 [扩展开发宿主] VS Code 窗口，Tab Guardian 扩展已在该窗口中激活。
   • 在新窗口中随意打开文件，观察状态栏的变化和标签页的自动关闭行为。

⚙️ 配置项

你可以在 VS Code 的设置 (settings.json) 中自定义 Tab Guardian 的行为。

• tabManager.maxOpenTabs:

  • 描述: 最多同时打开的标签页数量。
  • 类型: number
  • 默认值: 6
  • 允许范围: 4 到 6 (如果设置值超出此范围，将被钳制在范围内)。

• tabManager.autoCloseEnabled:

  • 描述: 是否在打开新标签时自动关闭多余的标签。
  • 类型: boolean
  • 默认值: true

• tabManager.respectPinned:

  • 描述: 自动关闭时是否保护已固定 (Pinned) 的标签。
  • 类型: boolean
  • 默认值: true

• tabManager.respectDirty:

  • 描述: 自动关闭时是否保护有未保存更改 (Dirty) 的标签。
  • 类型: boolean
  • 默认值: true

⌨️ 命令

• Tab Guardian: 立即清理多余标签页
  • 命令 ID: tabManager.cleanNow
  • 功能: 手动触发一次清理，关闭所有超出 maxOpenTabs 限制且符合关闭条件的标签页。
  • 使用方式:
    • 通过命令面板 (Ctrl+Shift+P 或 Cmd+Shift+P) 输入并执行。
    • 点击状态栏上的 Tabs X/Y 图标。

❓ 常见问题与注意事项

• 为什么有些标签页没有被自动关闭？ Tab Guardian 出于安全考虑，不会关闭以下类型的标签页：

  1. 你已经固定 (Pin) 的标签。
  2. 文件内容有未保存修改的标签。
  3. 当前正在查看的标签。
  4. 非文本文件类型的特殊标签（如设置页、Notebook、预览视图等），因为难以准确判断其“脏”状态。

• 可以把最大数量设置得更大吗？ 目前版本限制在 4 到 6 个之间，旨在提供一个相对专注的工作环境。未来的版本可能会放宽此限制。

• 如何临时禁用自动关闭？ 将设置项 tabManager.autoCloseEnabled 改为 false 即可。此时你仍然可以通过状态栏图标或命令手动清理。

感谢使用！希望 Tab Guardian 能为你的 VS Code 体验带来一丝清爽。