# infoMatters

**Repository Path**: limy718/info-matters

## Basic Information

- **Project Name**: infoMatters
- **Description**: Win的提醒事项
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-20
- **Last Updated**: 2026-01-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# InfoMatters (Reminders)

InfoMatters 是一个基于 Electron + React + TypeScript 构建的本地待办事项与提醒应用。它提供了一个现代化、简洁的界面来管理您的日常任务，支持本地数据库存储，确保数据安全与隐私。

## ✨ 主要特性

- **任务管理**：轻松创建、编辑、删除和完成任务。
- **列表分类**：支持创建自定义列表来组织不同类型的任务（如工作、个人、购物等）。
- **智能提醒**：支持设置任务截止日期和提醒时间，应用会在后台检查并发送系统通知。
- **本地存储**：使用 SQLite (`better-sqlite3`) 进行本地数据持久化，无需联网，数据完全掌握在自己手中。
- **新手引导**：首次启动应用时提供交互式功能引导，帮助您快速上手。
- **系统托盘**：应用常驻系统托盘，支持最小化到托盘和开机自启。
- **多语言支持**：内置国际化支持（i18n）。
- **现代化 UI**：基于 Ant Design 和 Tailwind CSS 构建的响应式界面。

## 🛠 技术栈

- **核心框架**：[Electron](https://www.electronjs.org/)
- **前端框架**：[React](https://react.dev/)
- **构建工具**：[Vite](https://vitejs.dev/)
- **编程语言**：[TypeScript](https://www.typescriptlang.org/)
- **UI 组件库**：[Ant Design](https://ant.design/)
- **样式工具**：[Tailwind CSS](https://tailwindcss.com/)
- **状态管理**：[Redux Toolkit](https://redux-toolkit.js.org/)
- **数据库**：[better-sqlite3](https://github.com/WiseLibs/better-sqlite3)
- **打包工具**：[electron-builder](https://www.electron.build/)

## 🚀 快速开始

### 环境要求

- **Node.js**: 建议 v18 或更高版本
- **包管理器**: 推荐使用 [pnpm](https://pnpm.io/)

### 安装依赖

```bash
# 克隆项目（如果您还没有下载）
# git clone <repository-url>

# 进入项目目录
cd info-matters

# 安装依赖
pnpm install
```

### 开发模式

启动开发服务器（包含 React 热更新和 Electron 主进程）：

```bash
pnpm dev
```

### 构建打包

为 Windows 平台构建安装包（`.exe`）：

```bash
pnpm build
```

构建产物将位于 `release` 目录下。

## ⚠️ 常见问题与注意事项

### 1. 原生模块构建 (Native Modules)

本项目使用了 `better-sqlite3` 和 `auto-launch` (依赖 `winreg`) 等原生模块。在 Windows 下打包时，这些模块需要被正确编译和解压。

- **asarUnpack**: `electron-builder.json5` 中已配置 `asarUnpack`，确保 `better-sqlite3`, `bindings`, `file-uri-to-path`, `winreg` 等模块不被打包进 `app.asar`，以避免运行时路径错误。
- **构建环境**: 确保您的系统已安装 C++ 构建工具（通常通过安装 Visual Studio 或 `windows-build-tools`）。

### 2. 文件锁定 (File Locking)

如果遇到 `release` 目录无法删除或 `Access is denied` 错误，通常是因为某个后台进程（如僵尸 Electron 进程）锁定了文件。
**解决方法**：
- 使用任务管理器结束所有 `Electron` 或 `Reminders` 进程。
- 重启计算机。

### 3. 代码签名 (Code Signing)

目前的配置已关闭代码签名验证 (`verifyUpdateCodeSignature: false`) 以避免在没有证书的情况下构建失败。如果您有代码签名证书，请在 `electron-builder.json5` 中进行相应配置。

## 📂 项目结构

```text
info-matters/
├── electron/                 # Electron 主进程代码
│   ├── main.ts              # 主入口
│   ├── database.ts          # 数据库连接与初始化
│   ├── scheduler.ts         # 定时任务/提醒调度
│   └── ...
├── src/                      # React 渲染进程代码
│   ├── components/          # UI 组件
│   │   ├── TaskList/        # 任务列表组件
│   │   ├── Sidebar/         # 侧边栏组件
│   │   └── ...
│   ├── service/             # API 服务层
│   ├── store/               # Redux 状态管理
│   └── App.tsx              # 根组件
├── electron-builder.json5    # 打包配置文件
├── vite.config.ts            # Vite 配置文件
└── package.json              # 项目依赖与脚本
```

## 📄 许可证

[MIT License](LICENSE)