Skip to content

Repository files navigation

待办 (Daiban)

简洁高效的待办事项管理工具,支持 Web 和桌面端。

截图

功能特性

  • 📅 日期导航 - 快速切换昨天/今天/明天,支持自定义日期选择
  • 📁 任务分类 - 自定义分类管理,轻松组织各类任务
  • 时间段设置 - 为任务安排具体时间,提高效率
  • 🔁 重复任务 - 支持每天/每周/每月重复
  • 📝 任务备注 - 记录任务完成情况
  • 💾 数据导入/导出 - JSON 格式备份,数据安全可迁移
  • 🖥️ Electron 桌面版 - 跨平台支持(Windows/macOS/Linux)
  • 🎨 现代 UI - 简洁清爽的界面设计

技术栈

前端

  • React 19 - 最新版本,带来更好的性能
  • TypeScript 5.9 - 类型安全,开发体验更佳
  • Vite 8 - 极速开发服务器启动和热更新
  • Zustand 5 - 轻量级状态管理(~1KB)
  • Tailwind CSS 4 - 原子化 CSS,快速样式开发
  • Lucide React - 现代简洁的图标库

数据存储

  • Dexie.js - IndexedDB 优雅封装,本地存储
  • Day.js - 轻量级日期处理库(2KB)

桌面应用

  • Electron 41 - 跨平台桌面应用框架
  • electron-builder - 一键打包发布

快速开始

安装 Node.js

确保已安装 Node.js 18+ 版本。

安装依赖

npm install

开发模式

# 启动 Vite 开发服务器
npm run dev

# 访问 http://localhost:5173

生产构建

# 构建 Web 版本
npm run build

# 预览构建结果
npm run preview

打包桌面应用

# 构建 Electron 安装包
npm run electron:build

# 打包后可执行文件在 dist/ 或 release/ 目录

项目结构

daiban/
├── src/
│   ├── components/      # UI 组件
│   │   ├── TaskList.tsx
│   │   ├── TaskItem.tsx
│   │   ├── Settings.tsx
│   │   └── ...
│   ├── db/              # 数据库层(Dexie)
│   │   ├── index.ts
│   │   ├── tasksRepo.ts
│   │   └── categoriesRepo.ts
│   ├── stores/          # 状态管理(Zustand)
│   │   └── taskStore.ts
│   ├── types/           # TypeScript 类型定义
│   ├── utils/           # 工具函数
│   │   ├── importExport.ts
│   │   ├── date.ts
│   │   └── repeat.ts
│   ├── App.tsx          # 主应用组件
│   └── main.tsx         # 入口文件
├── electron/            # Electron 主进程
│   ├── main.ts
│   └── preload.ts
├── package.json
├── tsconfig.json
├── vite.config.ts
└── tailwind.config.js

数据迁移

导出数据

  1. 打开应用
  2. 点击左下角 设置
  3. 点击 导出数据
  4. 保存 JSON 备份文件

导入数据

  1. 打开应用
  2. 点击左下角 设置
  3. 点击 导入数据
  4. 选择之前导出的 JSON 文件

⚠️ 注意:导入数据将覆盖当前所有数据,请先做好备份

其他设备使用

方案 1:Git 克隆

git clone https://github.com/你的用户名/daiban.git
cd daiban
npm install
npm run dev

方案 2:直接复制

将整个项目文件夹复制到其他电脑,然后:

npm install
npm run dev

方案 3:打包 exe

在当前电脑执行 npm run electron:build,将生成的 exe 文件复制到其他电脑直接运行。

许可证

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages