# 梦幻番茄时钟

**Repository Path**: TenFingers_monster/Fantasy-Study-Timer

## Basic Information

- **Project Name**: 梦幻番茄时钟
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-08
- **Last Updated**: 2025-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

 # 梦幻学习时光 (Fantasy Study Timer)

一款美观且功能丰富的桌面专注与学习计时器应用，旨在帮助用户通过番茄工作法或其他时间管理技巧提高学习和工作效率，同时提供舒适的视觉和听觉体验。

## ✨ 主要特性

*   **专注与休息计时器**：自定义工作时长和休息时长，支持自动切换。
*   **小憩功能**：在专注期间，可设置随机间隔进行短暂的强制眼部或身体放松。
*   **个性化外观**：
    *   支持多种背景类型：默认渐变、自定义图片 (本地上传或URL)、自定义视频 (本地上传或URL)。
    *   计时器面板透明度可调，实现沉浸式体验。
    *   应用主标题可自定义文本和显隐。
*   **提示音自定义**：
    *   工作/休息切换提示音和小憩提示音均支持多种内置音效，并允许用户上传自定义音效文件。
    *   提示音音量可独立调节。
*   **背景音乐播放器**：
    *   支持上传本地音乐文件，创建和管理播放列表。
    *   提供播放/暂停、上一首/下一首、清空列表等控制功能。
    *   支持顺序播放、单曲循环、随机播放模式。
    *   背景音乐音量可独立调节。
*   **小憩记录**：自动记录每次小憩的开始时间。
*   **跨平台**：基于 Electron 构建，可在 Windows, macOS, 和 Linux 上运行。
*   **自动更新**：集成自动更新功能，方便用户获取最新版本 (需配合发布服务器)。
*   **设置持久化**：所有个性化设置在应用关闭后都会被保存，并在下次启动时自动加载。

## 🛠️ 技术栈

*   **核心框架**：[Electron](https://www.electronjs.org/)
*   **前端**：HTML, CSS, JavaScript
*   **UI 风格**：[Tailwind CSS](https://tailwindcss.com/) (可能，根据之前的代码片段推断)
*   **音频处理/播放**：[Tone.js](https://tonejs.github.io/) (用于合成提示音和处理自定义音频)
*   **构建与打包**：[electron-builder](https://www.electron.build/)
*   **版本控制**：Git & Gitee
*   **自动更新服务**：依赖于配置的发布提供商 (如 Gitee Release, Generic server 等)

## 🚀 安装与本地运行

**环境准备**：

*   [Node.js](https://nodejs.org/) (建议使用 LTS 版本)
*   [Git](https://git-scm.com/)
*   npm (通常随 Node.js 一起安装) 或 yarn

**步骤**：

1.  **克隆仓库**：
    ```bash
    git clone https://gitee.com/TenFingers_monster/Fantasy-Study-Timer.git
    cd Fantasy-Study-Timer
    ```

2.  **安装依赖**：
    ```bash
    npm install
    ```
    或者，如果你使用 yarn：
    ```bash
    yarn install
    ```

3.  **启动应用 (开发模式)**：
    ```bash
    npm start
    ```
    或者：
    ```bash
    yarn start
    ```
    这将以开发模式启动应用，通常会打开调试工具。

## 📦 构建与打包

你可以使用 `electron-builder` 来为不同平台构建可执行的应用安装包。

1.  **确保 `package.json` 配置正确**：
    *   检查 `build` 字段下的配置，如 `appId`, `productName`, `directories.output`, 以及针对不同平台 (win, mac, linux) 的具体配置。
    *   如果需要代码签名，确保相关配置已设置。

2.  **执行打包命令**：
    *   打包当前平台：
        ```bash
        npm run dist
        ```
        或者
        ```bash
        yarn dist
        ```
    *   打包特定平台 (例如 Windows 和 Linux)：
        ```bash
        npm run dist -- --win --linux
        ```
        (可用的参数有 `--win`, `--mac`, `--linux`)

    打包完成后，生成的文件通常会在 `dist/` 或你 `package.json` 中指定的输出目录下。

## ⚙️ 关于自动更新

本应用集成了 `electron-updater` 来处理自动更新。

*   **发布新版本**：当你在 Gitee (或你配置的其他发布源) 创建一个新的 Release 并上传了对应平台的安装包 (例如 `.exe`, `.yml` 等) 后，应用在启动时会自动检测更新。
*   **更新流程**：
    1.  应用启动时检查更新。
    2.  如果检测到新版本，会自动在后台下载。
    3.  下载完成后，会弹窗提示用户新版本已就绪，并询问是否立即重启应用以完成更新。

确保 `package.json` 中的 `publish` 配置指向了正确的提供商和仓库信息。

## 📝 使用说明 (简要)

1.  **主界面**：显示专注/休息倒计时。
    *   点击“开始专注”启动计时器，再次点击可“暂停”或“继续”。
    *   “重置”按钮会将当前计时器重置回设定的专注时长。
    *   右下角的小憩计时器会在专注期间根据设定的时间间隔进行倒计时。
2.  **设置面板 (点击右上角齿轮图标或主界面“设置”按钮打开)**：
    *   **时间设置**：调整专注、休息、小憩的时长和间隔。
    *   **背景与外观**：选择背景类型，上传自定义背景，调整计时框透明度，设置应用标题。
    *   **提示音设置**：选择或上传主提示音和小憩提示音，调节提示音量。
    *   **背景音乐播放器**：添加本地音乐，管理播放列表，控制播放，调节音乐音量。
    *   所有设置在修改后通常会自动保存，或有明确的“应用”按钮。

## 🤝 贡献

欢迎提交 Pull Requests 或 Issues 来改进此项目！

在提交代码前，请确保：

*   代码风格与项目现有代码保持一致。
*   相关的依赖已正确添加和说明。
*   进行了充分的测试。


_祝您学习愉快，效率倍增！_ ✨