# remind

**Repository Path**: Richard1126/remind

## Basic Information

- **Project Name**: remind
- **Description**: pc端桌面弹窗提醒小工具
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python

## README

# 提醒闹钟

PC 桌面提醒小工具：支持多规则循环（单次/每天/每周/间隔），最小化到系统托盘，到点前可配置分钟数（1~60 分钟）弹窗 + 窗口抖动 + 提示音；支持开机自启（通过启动文件夹）。

## 环境

- Python 3.8+
- Windows（提示音使用 `winsound`）

### 安装 Python（Windows）

若本机尚未安装 Python，任选一种方式即可：

1. **用 winget（推荐）**  
   在 PowerShell 或命令提示符中执行：
   ```bash
   winget install Python.Python.3.12
   ```
   安装完成后**重新打开**终端或 Cursor，使 `python` 命令生效。

2. **官网安装**  
   打开 [python.org/downloads](https://www.python.org/downloads/)，下载 Windows 安装包，运行安装程序时**勾选 “Add Python to PATH”**，再完成安装。

3. **Microsoft Store**  
   在开始菜单搜索“Microsoft Store”，打开后搜索 “Python 3.12” 并安装。

安装后可在终端执行 `python --version` 检查是否成功。

## 安装依赖

```bash
pip install -r requirements.txt
```

## 运行

在项目根目录执行：

```bash
python main.py
```

规则与设置保存在同目录下的 **`remind_data.json`**（提醒规则、提前分钟数、是否开机自启均在此文件），可手动编辑或通过界面修改。若该文件不存在，首次运行或保存时会自动创建。

## 打包为单文件 exe

**首次打包**需先安装 PyInstaller（只需一次）：

```bash
pip install pyinstaller
```

之后在项目根目录执行（**重新打包也只执行下面这条**，无需再 `pip install`）：

```bash
pyinstaller --onefile --windowed --name Remind main.py
```

若提供图标，可将 `icon.ico` 放到 `assets/` 下后执行：

```bash
pyinstaller --onefile --windowed --icon=assets/icon.ico --name Remind main.py
```

- 生成的可执行文件在 **`dist/Remind.exe`**，无需安装 Python 即可运行。
- 每次改完代码后，只重新执行上面的 `pyinstaller` 命令即可，新的 exe 会覆盖 `dist/Remind.exe`。
- **配置文件**：程序只使用一个 **`remind_data.json`**（在 exe 或脚本所在目录），内含提醒规则与设置；若不存在会自动创建，请勿删除。

### 换一台电脑运行 exe 报「缺少 api-ms-win-core-xxx.dll」

这是因为 exe 在**当前这台电脑**上打包时，会依赖本机的 Windows 系统 DLL（如 `api-ms-win-core-sysinfo-l1-2-0.dll`）。若目标电脑的 Windows 版本更老或缺少更新，就可能没有该文件。

**可行做法（任选其一）：**

1. **在目标电脑上重新打包**：把项目拷到目标电脑，安装同版本 Python 和依赖后，在该电脑上执行一次 `pyinstaller` 打包，生成的 exe 只依赖该机的系统文件。
2. **在“与目标电脑同版本或更老”的 Windows 上打包**：例如要在 Windows 10 上运行，就在 Windows 10 上打包，这样一般不会出现这类 DLL 缺失。
3. **给目标电脑打齐 Windows 更新**：在报错的那台电脑上安装所有 Windows 可选更新后再运行 exe，有时会补上缺失的 API 集。

## 使用说明

- **添加/编辑/删除**：在主窗口操作；双击列表项可编辑。
- **关闭主窗口**：窗口最小化到系统托盘，程序继续运行。
- **托盘**：右键图标可“显示主窗口”或“退出”；双击图标也可显示主窗口。
- **提醒**：到达设定时间前 N 分钟会弹窗、抖动并播放系统提示音；N 可在主窗口「设置」中手动输入 1–60 分钟。
- **设置**：主窗口下方可设置「提前提醒(分钟)」为 1–60；勾选「开机自启」后，会在当前用户启动文件夹中创建启动项（仅 Windows），下次开机自动运行本程序。开机自启时，程序会把 exe 路径写入 **`%APPDATA%\RemindAlarm\path.txt`**，启动项中的 VBS 会从该文件读取路径再启动程序，由程序自动维护，无需手动编辑。

### 开机自启报「找不到文件」时

开机时若弹出“Windows Script Host”提示**找不到指定的文件**，可能是 path.txt 中记录的 exe 路径已失效（exe 或项目已移动/重命名）。按下面做即可修复：

1. 把 **Remind.exe** 放到你打算**长期放置**的目录（不要再用完就移走）。
2. **从该目录直接双击运行** Remind.exe（不要通过快捷方式指向别处）。
3. 在主窗口**先取消勾选「开机自启」**，再**重新勾选**一次，程序会重新写入 `%APPDATA%\RemindAlarm\path.txt` 和启动项中的 VBS。
4. 以后若再次移动 exe，重复以上步骤即可。


## 建议新建一个文件夹存放 Remind.exe

程序首次运行并成功设置提醒或修改设置后，会在 **exe 所在目录** 自动创建**唯一配置文件** **`remind_data.json`**（内含提醒规则、提前分钟数、是否开机自启等），请不要删除该文件。