# CCSTodo
**Repository Path**: ccsgroup/ccstodo
## Basic Information
- **Project Name**: CCSTodo
- **Description**: 一个面向未来的AI智能助手
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-13
- **Last Updated**: 2026-07-03
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ⚡ CCSTodo · 云枢 [V1.0.3]
### 面向 AI 时代的本地离线 + 邮箱轻协同效率工具
*从待办清单，到专属 AI 私人助理 — 隐私优先，协同无忧*
[](https://github.com/Yogurtcry/ccsgroup-ccstodo)
[](https://gitee.com/ccsgroup/ccstodo)
[](LICENSE)
[](https://www.electronjs.org/)
[](https://vuejs.org/)
[](https://www.typescriptlang.org/)
[](https://element-plus.org/)
[**English**](./README_EN.md) | [简体中文](./README.md)
*🎯 核心定位：本地离线任务管理 + 邮箱轻量级团队协同 — 兼顾个人隐私与多人协作的新一代效率解决方案*
---
## 📌 项目理念
在 AI 时代重新思考效率工具的可能性。
当前主流协同任务软件的方案依赖云端同步，既存在隐私泄露风险，长期部署维护成本也偏高。而纯离线工具又缺失协作能力。
**云枢** 提出 **本地离线使用 + 邮箱轻协同** 的创新方案：
- 🛡️ **隐私优先** — 个人事务完全离线本地存储，数据完全由您掌控
- 🤝 **轻量协同** — 多人协作任务通过邮箱流转，对方绑定邮箱即可在软件内直接接收解析
- 📧 **无障碍兼容** — 未使用软件的协作者也能正常查看邮件任务内容
- 🔒 **双向兼顾** — 离线安全与简易协同的完美平衡
---
## ✨ 核心特性
### 🔐 隐私安全
- 本地 SQLite 数据库存储，所有数据留在本地
- 无需云端账号，零隐私泄露风险
- 支持本地密码锁屏保护
- AES 加密存储敏感信息
### 📧 邮箱协同
- 通过 SMTP/IMAP 协议实现任务流转
- 对方无需安装软件，邮件即可查看任务详情
- 支持任务状态同步与回复确认
- 自动解析邮件内容并更新任务状态
### 📋 任务管理
- 🔖 **多维视图** — 今日待办、任务统计分析
- 👥 **团队协同** — 成员管理、全部任务、发出任务、接收任务
- 📊 **任务统计** — 数据概览、趋势图表、词云分析
- 🎯 **优先级管理** — 支持任务优先级设置与筛选
- 📝 **子任务支持** — 任务拆解与进度追踪
- ⚙️ **表格配置持久化** — 列名显隐、布局密度、表格样式可自定义并持久化存储
### 🖥️ 桌面体验
- 🚀 **跨平台** — Windows / macOS(规划中) / Linux(规划中)
- 🎨 **现代化 UI** — Element Plus + Tailwind CSS
- 🌙 **深浅主题** — 深色/浅色/系统主题，自定义主题风格与界面布局
- ⚡ **流畅交互** — 细腻动效与即时反馈
- 📌 **托盘驻留** — 关闭窗口最小化至系统托盘，后台持续运行
### 🛠️ 个性化配置
- 多标签页与手风琴侧边栏模式
- 国际化支持（中英文切换）
- 表格显示自定义：列显隐、紧凑/默认/宽松布局、斑马纹/边框/表头背景开关
- 配置自动持久化至本地数据库，重启不丢失
---
## 🏗️ 技术架构
| 层级 | 技术选型 | 说明 |
|------|---------|------|
| **核心模板** | Art Design Pro | 优秀的中后台模板 |
| **桌面框架** | Electron 39.8.10 | 跨平台桌面应用框架 |
| **前端框架** | Vue 3.5.39 | 渐进式 JavaScript 框架 |
| **类型系统** | TypeScript 5.9.3 | 类型安全的开发体验 |
| **UI 组件库** | Element Plus 2.14.2 | Vue 3 组件库 |
| **样式方案** | Tailwind CSS 4.3 + SCSS | 原子化 CSS + 传统样式 |
| **状态管理** | Pinia 3.0.4 | 新一代 Vue 状态管理 |
| **国际化** | Vue-i18n 9.14.5 | 多语言支持 |
| **构建工具** | electron-vite 5.0 + Vite 7.3 | 快速的 Electron 开发构建 |
| **本地数据库** | SQLite3 6.0.1 | 轻量级本地存储 |
| **邮件协议** | Nodemailer + IMAP | 邮件收发支持 |
| **图表库** | ECharts 5.5 + echarts-wordcloud | 数据可视化与词云 |
| **中文分词** | NodeJieba 3.5 | 任务摘要词频统计 |
| **富文本编辑** | WangEditor 5.1.23 | 富文本内容编辑 |
---
## 🚀 快速开始
### 环境要求
- Node.js ≥ 18+
- pnpm ≥ 8+（推荐）
- Git
### 安装步骤
```bash
# 克隆项目
git clone https://gitee.com/ccsgroup/ccstodo.git
# 或者
git clone https://github.com/Yogurtcry/ccsgroup-ccstodo.git
# 进入项目目录
cd CCSTodo
# 安装依赖
pnpm install
# 启动开发服务器
pnpm dev
```
### 构建发布
```bash
# 类型检查
pnpm typecheck
# 构建生产版本
pnpm build
# 构建 Windows 便携版
pnpm build:win
# 构建 macOS 版本
pnpm build:mac
# 构建 Linux 版本
pnpm build:linux
```
---
## 📂 项目结构
```
CCSTodo/
├── electron.vite.config.* # Vite 配置
├── electron-builder.yml # 打包配置
├── package.json
├── tsconfig*.json # TypeScript 配置
├── src/
│ ├── main/ # Electron 主进程
│ │ ├── index.ts # 入口文件
│ │ ├── schedules/ # 定时任务调度
│ │ │ ├── email.ts # 邮件解析调度
│ │ │ └── imapServer.ts # IMAP 服务器池
│ │ ├── types/ # 类型定义
│ │ └── utils/ # 主进程工具模块
│ │ ├── exec/ # 业务执行逻辑
│ │ │ ├── auth/ # 认证相关
│ │ │ ├── systems/ # 系统功能
│ │ │ └── teamWorker/ # 团队协作
│ │ ├── modules/ # 功能模块
│ │ └── sqlite3/ # 数据库操作
│ ├── preload/ # 预加载脚本
│ │ └── index.ts
│ └── renderer/ # Vue 渲染进程
│ └── src/
│ ├── api/ # API 接口封装
│ ├── assets/ # 静态资源
│ ├── components/ # Vue 组件
│ │ ├── core/ # 核心基础组件
│ │ └── views/ # 业务视图组件
│ ├── hooks/ # 组合式函数
│ ├── locales/ # 国际化语言包
│ ├── router/ # 路由配置
│ ├── store/ # Pinia 状态管理
│ ├── types/ # TypeScript 类型定义
│ ├── utils/ # 工具函数
│ └── views/ # 页面视图
│ ├── auth/ # 认证模块
│ │ ├── login/ # 登录页面
│ │ ├── register/ # 注册页面
│ │ └── forget-password/ # 忘记密码
│ ├── dashboard/ # 工作台
│ │ └── console/ # 数据控制台
│ ├── taskList/ # 任务清单
│ │ ├── today/ # 今日待办
│ │ └── statistics/ # 任务统计
│ ├── teamWorker/ # 团队协同
│ │ ├── workerManage/ # 成员管理
│ │ ├── taskList/ # 全部任务
│ │ ├── sendOut/ # 发出任务
│ │ └── receive/ # 接收任务
│ ├── system/ # 系统管理
│ │ ├── user-center/ # 个人中心
│ │ ├── operateLog/ # 操作日志
│ │ ├── dataManage/ # 数据管理
│ │ ├── authManage/ # 授权管理
│ │ ├── privacyPolicy/ # 隐私政策
│ │ ├── acknowledgment/ # 致谢
│ │ └── updateLog/ # 更新日志
│ ├── exception/ # 异常页面
├── resources/ # 应用资源
│ ├── docs/ # 说明文档
│ │ ├── emailTemplate/ # 邮件模板
│ │ ├── workCloud/ # 词云配置文件
│ │ ├── LicenseAgreement.html
│ │ ├── PrivacyPolicy.html
│ │ └── UpdateLog.json
│ ├── icons/ # 应用图标
│ └── utils/ # 工具资源（nircmd等）
└── out/ # 构建输出目录
```
---
## 🎨 功能模块
### 🔐 用户认证系统
完整的用户身份管理体系：
- ✅ **用户注册** — 支持邮箱注册与隐私政策确认
- ✅ **用户登录** — 本地账号认证与JWT令牌管理
- ✅ **密码管理** — 密码修改、重置与安全验证
- ✅ **邮箱验证** — 邮箱绑定与连接测试
### 📊 工作台 (Dashboard)
数据驾驶舱，正在规划中：
- ⬜ **工作台模块** — 整体模块规划中
- ⬜ 任务统计卡片与趋势图
- ⬜ 活跃用户与动态数据
- ⬜ 数据可视化图表展示
### 📋 任务清单 (Task List)
个人任务管理，多维度掌控：
- ✅ **今日待办** — 当日任务聚焦、优先级排序、快速操作
- ✅ **任务统计** — 数据可视化分析、趋势图表、jieba 分词词云、协作者分布
- ✅ 高级筛选 — 多条件精准定位任务
- ✅ 任务详情 — 支持富文本描述与子任务管理
- ✅ 任务评论 — 团队成员实时沟通与反馈
- ✅ 表格配置持久化 — 列名显隐/顺序、布局密度、斑马纹/边框/表头样式可自定义存储
### 👥 团队协作 (Team Collaboration)
基于邮箱的轻量级协同，完整可用：
- ✅ **成员管理** — 添加、禁用、删除团队成员，成员统计
- ✅ **全部任务** — 全部任务统一管理与状态追踪
- ✅ **发出任务** — 发起协作的任务追踪与进度监控
- ✅ **接收任务** — 收到的协同任务处理与状态更新
- ✅ 表格配置持久化 — 各列表视图独立保存列显隐与样式配置
### 👤 个人中心 (User Center)
完善的个人信息与数据管理：
- ✅ **基本设置** — 用户ID、昵称、性别、头像管理
- ✅ **密码安全** — 密码修改与安全验证
- ✅ **邮箱配置** — SMTP/IMAP 邮箱绑定与连接测试
- ✅ **数据统计** — 个人任务统计卡片与多语言适配
- ⬜ 存储管理 — 本地数据存储空间管理（计划中）
### ⚙️ 系统管理 (System)
配套支持功能，基本覆盖：
- ⬜ **操作日志** — 详细的行为记录审计与追踪
- ⬜ **数据管理** — 本地数据导入导出
- ⬜ **授权管理** — 许可证管理与协议确认
- ⬜ **致谢页面** — 开源依赖与贡献者展示
- ⬜ **隐私政策** — 透明的数据处理说明与用户权益
- ⬜ **更新日志** — 版本迭代记录与功能演进
- ⬜ **数据备份恢复** — 云端同步选项（规划中）
### 🎨 界面定制
丰富的个性化体验：
- ✅ **主题切换** — 深色/浅色/系统主题自适应
- ✅ **菜单风格** — 深色/浅色/设计风格切换
- ✅ **表格自定义** — 列显隐、顺序拖拽、紧凑/默认/宽松布局
- ✅ **配置持久化** — 所有界面配置自动保存至数据库，重启不丢失
---
## 🔄 核心业务流程
### 邮箱协同工作流程
1. **任务创建与分配**
- 用户在软件中创建任务并分配给团队成员
- 系统通过 SMTP 协议发送任务邮件给协作者
2. **邮件接收与解析**
- IMAP 服务器定时监听邮箱
- 自动解析任务邮件并提取关键信息
- 更新本地数据库中的任务状态
3. **任务状态同步**
- 协作者通过邮件回复更新任务进度
- 系统自动解析回复内容并同步任务状态
- 实现跨平台的任务协作
### 数据安全机制
1. **本地存储**
- 所有用户数据存储在本地 SQLite 数据库
- 敏感信息采用 AES 加密存储
- 支持数据备份与恢复
2. **身份认证**
- JWT 令牌机制确保会话安全
- 密码采用 MD5 加密存储
- 支持登录状态持久化
3. **权限控制**
- 基于角色的访问控制
- 操作日志记录所有用户行为
- 支持用户禁用与权限管理
---
### 技术栈说明
- **主进程**：负责 Electron 窗口管理、系统调用、数据库操作
- **渲染进程**：Vue 3 应用，负责用户界面展示与交互
- **预加载脚本**：提供安全的 IPC 通信接口
### 数据库设计
项目采用 SQLite3 作为本地数据库，主要包含以下表和视图：
**数据表：**
- `T_SYS_USER` — 用户信息表
- `T_SYS_EMAIL_CONFIG` — 邮箱配置表
- `T_TASK_WORKER` — 协同成员表
- `T_TASK_WORKER_APPLY` — 团队成员申请协同记录表
- `T_TASK_TASKLIST` — 任务信息表
- `T_TASK_TASKLIST_RECEIVER` — 任务接收人表
- `T_TASK_TASKLIST_PUBLISH` — 任务发布表
- `T_TASK_TASKLIST_COMMENT` — 任务评论表
- `T_SYS_EMAIL_PROVIDER` — 邮箱服务商配置表
- `T_REC_EMAIL` — 邮件接收记录表
- `T_SYS_TABLE_CONFIG` — 表格视图配置持久化表
**视图：**
- `V_TASK_TASKLIST` — 任务层级视图（支持递归查询子任务）
- `V_SYS_USER` — 用户视图（联合用户信息与邮箱配置）
---
## 🤝 参与贡献
我们欢迎所有形式的贡献！
---
## 📄 许可证
本项目基于 [MulanPSL2 许可证](LICENSE) 开源。
---
## 🙏 致谢
本项目的开发离不开以下优质开源项目的支持：
- [Art Design Pro](https://www.artd.pro/docs/zh/guide/introduce.html) - 优秀的桌面应用模板
- [Vue.js](https://vuejs.org/) - 渐进式 JavaScript 框架
- [Element Plus](https://element-plus.org/) - Vue 3 组件库
- [Electron](https://www.electronjs.org/) - 跨平台桌面应用框架
- [electron-vite](https://cn.electron-vite.org/) - Electron 构建工具
- [Tailwind CSS](https://tailwindcss.com/) - 原子化 CSS 框架
- [Pinia](https://pinia.vuejs.org/) - Vue 状态管理
- [Vue-i18n](https://vue-i18n.intlify.dev/) - 国际化插件
- [SQLite](https://www.sqlite.org/) - 轻量级数据库
- [TypeScript](https://www.typescriptlang.org/) - 类型系统
- [ECharts](https://echarts.apache.org/) - 数据可视化图表库
- [NodeJieba](https://github.com/yanyiwu/nodejieba) - 中文分词与词频统计
- [Nodemailer](https://nodemailer.com/) - 邮件发送模块
- [IMAP](https://github.com/mscdex/node-imap) - 邮件接收协议
以及所有开源社区的贡献者！
---
## 📬 联系方式
- 📧 **邮箱**: ben.2001@foxmail.com
- 🐛 **Bug 反馈**: [Gitee Issues](https://gitee.com/ccsgroup/ccstodo/issues)
---
## 🗺️ 开发路线图
### 📌 已完成功能 (v1.0.3)
- ✅ 用户认证系统（登录、注册、密码管理）
- ✅ 邮箱协同（SMTP/IMAP 协议支持、8 大主流邮箱服务商）
- ✅ 个人中心（用户信息、邮箱配置、个人任务统计卡片）
- ✅ 今日待办（当日任务聚焦、优先级排序、快速操作）
- ✅ 任务统计（ECharts 图表、jieba 分词词云、协作者分布）
- ✅ 团队协作 — 成员管理（添加、禁用、删除、成员统计）
- ✅ 团队协作 — 全部任务（统一管理、子任务递归视图）
- ✅ 团队协作 — 发出任务（协作任务追踪与进度监控）
- ✅ 团队协作 — 接收任务（协同任务处理与状态更新）
- ✅ 系统管理（操作日志、数据管理、授权管理、隐私政策、致谢、更新日志）
- ✅ 国际化支持（中英文）
- ✅ 主题切换（深色/浅色/系统）
- ✅ 表格配置持久化（列显隐与顺序、布局密度、斑马纹/边框/表头样式）
- ✅ 托盘最小化与后台运行
### 🚧 下一版本预计迭代功能
- ⬜ 支持任务汇总提醒
- ⬜ 支持任务回应精细到人
- ⬜ 支持任务发送后状态更新，如转发、更新优先级
- ⬜ 日历视图任务管理
- ⬜ 甘特视图任务管理
- ⬜ 存储空间管理
- ⬜ 数据备份与恢复
### 🚀 计划中功能
- 🔮 AI 智能任务推荐与分类
- 🔮 更多邮件服务商支持（Outlook除外）
- 🔮 云端同步选项
- 🔮 移动端适配
---
**如果这个项目对您有帮助，请给我们一个 ⭐️**
*Made with ❤️ by [Github](https://github.com/Yogurtcry) OR [Gitee](https://gitee.com/Yogurt_cry)*
**云枢 · 掌控诸事时序**