# TabLoop

**Repository Path**: spaceman_3/tab-loop

## Basic Information

- **Project Name**: TabLoop
- **Description**: TabLoop 是一款轻量级 Chrome 扩展，专为标签页自动化设计，可在浏览器中自动轮换标签页，适用于数据仪表板、监控墙等场景。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-08
- **Last Updated**: 2026-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TabLoop - 智能标签页轮换工具

TabLoop 是一款轻量级 Chrome 扩展，专为标签页自动化设计，可在浏览器中自动轮换标签页，适用于数据仪表板、监控墙等场景。

## 功能特性

- **自定义轮换间隔**：为每个标签页设置独立的轮换时间间隔
- **指定窗口轮换**：可选择特定浏览器窗口进行标签页轮换
- **标签页计划**：安排标签页在特定日期和时间自动打开
- **轻量高效**：最小化资源占用，最大化性能表现
- **深色模式**：支持深色主题，保护视力
- **可视化播放列表**：直观显示当前窗口所有标签页及其轮换间隔

## 安装方法

1. 克隆仓库：
    ```bash
    git clone https://gitee.com/spaceman_3/tab-loop.git
    ```
2. 打开 Chrome 浏览器，访问 `chrome://extensions/`
3. 右上角开启"开发者模式"
4. 点击"加载已解压的扩展程序"，选择克隆的仓库文件夹
5. 安装完成，TabLoop 图标将出现在浏览器工具栏

## 使用指南

### 快速开始

1. 安装完成后，首次点击扩展图标会打开欢迎页面
2. 点击浏览器工具栏中的 TabLoop 图标打开主界面

### 标签页轮换

1. **设置轮换间隔**：
   - 在主界面顶部设置默认轮换间隔（秒）
   - 使用滑块快速调整时间
   - 或在播放列表中为每个标签页单独设置间隔

2. **开始/停止轮换**：
   - 点击绿色"开始"按钮启动轮换
   - 点击红色"停止"按钮暂停轮换
   - 扩展图标会显示当前状态（播放/暂停）

3. **选择轮换窗口**：
   - 在下拉菜单中选择要轮换的浏览器窗口
   - 默认使用当前活动窗口

### 计划标签页

1. 点击左上角日历图标进入计划页面
2. 点击"添加计划标签页"按钮
3. 填写以下信息：
   - **名称**：标签页的名称
   - **URL**：要打开的网址
   - **星期**：选择在一周中的哪些天打开
   - **时间**：设置打开的具体时间
   - **显示时长**：设置标签页显示多长时间后自动关闭（可选）
   - **重复周期**：设置首次打开后的重复频率（可选）
4. 点击"保存"按钮

### 个性化设置

1. **深色主题**：
   - 点击设置按钮（齿轮图标）
   - 开启"深色主题"开关

2. **重置标签页间隔**：
   - 在播放列表中点击"全部重置为默认"
   - 所有标签页将恢复为默认轮换间隔

## 常见问题

### 为什么标签页没有按时轮换？
- 检查是否已点击"开始"按钮启动轮换
- 确认轮换间隔设置是否正确
- 确保目标窗口仍然打开

### 如何删除计划任务？
- 进入计划页面
- 点击对应计划右侧的"删除"按钮

### 扩展图标有什么作用？
- 蓝色播放图标：表示轮换已停止
- 蓝色暂停图标：表示轮换正在进行
- 图标上会显示下次轮换的倒计时

## 技术栈

- **前端**：HTML5, CSS3, JavaScript (ES6+)
- **存储**：Chrome Storage API
- **定时**：Chrome Alarms API
- **图标**：SVG + PNG 混合方案

## 贡献

欢迎贡献代码！请遵循以下步骤：

1. Fork 本仓库
2. 创建新分支：
    ```bash
    git checkout -b feature-name
    ```
3. 提交更改：
    ```bash
    git commit -m "Add feature-name"
    ```
4. 推送到分支：
    ```bash
    git push origin feature-name
    ```
5. 提交 Pull Request

## 更新日志

### v0.0.1
- 优化图标显示，使用蓝色圆形图标
- 修复设置按钮点击事件
- 改进 UI 布局和响应式设计
- 支持 SVG 图标系统

## 许可证

本项目采用 [MIT 许可证](LICENSE) 授权。

## 支持

如有问题或建议，请通过以下方式联系：
- 提交 Issue
- 发送邮件至项目维护者

---

**TabLoop** - 让标签页管理更智能、更高效！