Ai Tab Organizer

# AI Tab Organizer

## 中文

AI Tab Organizer 是一款 Chrome 扩展，用于通过兼容 OpenAI 的 AI 服务，将当前打开的浏览器标签页整理成有意义的标签组。

### 功能介绍

- **AI 智能分组**：分析标签页标题和 URL，将相关标签页放入命名后的 Chrome 标签组。
- **重新整理已打开分组**：重新分析当前已打开的标签组，在内容混杂或分组不合理时重新归类。
- **自动分组**：可选择在新打开标签页或标签页域名变化时自动触发分组。
- **分组策略**：支持批量分组以减少 API 调用，也支持并行分组以提高独立分类效果。
- **自定义 AI 服务**：可配置 OpenAI 兼容接口的 Base URL、API Key、模型名称和最大响应 token 数。
- **书签感知分组**：当标签页 URL 匹配已有书签时，可使用书签所在文件夹名称作为分组名称。
- **域名兜底分组**：当少量相似标签不需要 AI 分类时，可按域名直接分组。
- **智能跳过规则**：自动跳过搜索结果页、空白页、浏览器内部页面，以及自定义排除 URL。
- **自定义排除规则**：支持通过 URL 文本或正则表达式配置不参与自动分组的页面。
- **分组颜色**：为 Chrome 标签组应用颜色，方便快速识别。
- **智能折叠**：可配置保留最近使用的若干个分组展开，其余分组自动折叠。
- **使用计数**：在弹窗中显示 API 调用次数和分组触发次数。

### 说明

- 扩展可以整理 Chrome 当前已经打开的标签页和标签组。
- Chrome 扩展 API 不开放读取已保存但未打开的标签组，如需整理已保存标签组，需要先在 Chrome 中打开该标签组，扩展才能读取并重新整理其中的标签页。

## English

AI Tab Organizer is a Chrome extension that helps organize open browser tabs into meaningful tab groups with an OpenAI-compatible AI service.

### Features

- **AI tab grouping**: Analyze tab titles and URLs, then place related tabs into named Chrome tab groups.
- **Regroup existing open groups**: Re-evaluate currently open tab groups and reorganize them when their contents become mixed or outdated.
- **Automatic grouping**: Optionally group newly opened or navigated tabs when their domain changes.
- **Grouping strategies**: Choose between batch grouping for fewer API calls or parallel grouping for more independent classification.
- **Custom AI provider**: Configure an OpenAI-compatible base URL, API key, model name, and response token limit.
- **Bookmark-aware grouping**: When a tab URL matches a bookmark, the extension can use the bookmark folder name as the group name.
- **Domain-based fallback**: Group tabs by domain when AI classification is not needed for a small set of similar tabs.
- **Smart skip rules**: Avoid automatically grouping search result pages, blank pages, browser internal pages, and custom excluded URLs.
- **Custom exclusions**: Add URL text or regular-expression rules for pages that should not be automatically grouped.
- **Group colors**: Apply Chrome tab group colors to make groups easier to scan.
- **Smart collapse behavior**: Keep a configurable number of recently used groups expanded while collapsing older groups.
- **Usage counters**: Show API call and grouping trigger counts from the popup.

### Notes

- The extension can organize tabs and tab groups that are currently open in Chrome.
- Chrome's extension APIs do not expose saved tab groups that are pinned or saved but not currently opened.
- Saved groups need to be opened first before the extension can read and reorganize their tabs.