当前位置：首页 > news >正文

深度解析My-TODOs：基于PyQt-SiliconUI的跨平台桌面任务管理技术实践

news 2026/5/11 21:32:52

深度解析My-TODOs：基于PyQt-SiliconUI的跨平台桌面任务管理技术实践

【免费下载链接】My-TODOsA cross-platform desktop To-Do list. 跨平台桌面待办小工具项目地址: https://gitcode.com/gh_mirrors/my/My-TODOs

在当今快节奏的数字生活中，高效的任务管理成为提升生产力的关键。My-TODOs作为一款基于PyQt-SiliconUI技术栈开发的跨平台桌面待办事项管理工具，通过现代化的UI设计和简洁的功能实现，为开发者提供了一个优秀的技术实践案例。本文将深入剖析该项目的技术架构、模块化设计和实现细节，为技术爱好者和开发者提供全面的技术解析。

技术架构深度解析

核心UI框架：PyQt-SiliconUI的现代化应用

My-TODOs基于PyQt-SiliconUI这一现代化的Python GUI框架构建，该框架提供了丰富的UI组件和动画系统。项目充分利用了SiliconUI的模块化设计理念，将界面组件与业务逻辑分离，实现了高度可维护的代码结构。

核心模块架构：

siui/core/- 核心动画与颜色管理系统
siui/components/- 可复用UI组件库
components/themed_option_card.py- 主题化卡片组件
ui.py- 主应用界面逻辑

项目采用典型的MVC（Model-View-Controller）架构模式，其中：

Model层：由todos_parser.py和settings_parser.py负责数据持久化
View层：基于PyQt-SiliconUI构建的现代化界面组件
Controller层：ui.py中的TODOApplication类负责协调业务逻辑

数据持久化方案：轻量级INI配置文件系统

My-TODOs采用INI配置文件作为数据存储方案，这种设计在轻量级桌面应用中具有显著优势：

# settings_parser.py - 配置解析器核心实现 class SettingsParser: def __init__(self, path): self.ini_path = path self.options = {} self.load() def load(self): """从.ini文件加载键值对""" ini_file = open(self.ini_path, encoding="utf-8") options = {} for line in ini_file.readlines(): line = line.strip() if self._is_a_legal_line(line) is False: continue key, value = line.split("=") key = key.strip() value = value.strip() options[key] = self._match_type(value) self.options.update(options)

配置文件结构对比：

配置文件	用途	数据格式	更新机制
`options.ini`	应用设置存储	键值对格式	实时保存用户偏好
`todos.ini`	待办事项存储	自定义标记格式	应用退出时批量保存

待办事项存储采用独特的标记格式：

# todos_parser.py - 待办事项解析器 class TODOParser: def __init__(self, path): self.path = path self.todos = [] self.read() def read(self): """从todos.ini读取待办事项""" file = open(self.path, encoding="utf-8") todos = file.read().split("<TODO-START-MARK>")[1:] self.todos = todos def write(self): """将当前待办列表写入todos.ini""" file = open(self.path, "w", encoding="utf-8") for item in self.todos: file.write(f"<TODO-START-MARK>{item}")

跨平台兼容性实现机制

基于PyQt5的强大跨平台能力，My-TODOs在Windows、macOS和Linux系统上都能提供一致的体验。项目通过以下技术手段确保跨平台兼容性：

平台无关的文件路径处理：使用相对路径和标准文件操作
统一的UI渲染引擎：PyQt5提供跨平台的图形渲染
系统API抽象：避免直接调用平台特定API

模块化架构设计与实现

核心UI组件系统

My-TODOs的界面由多个可复用的组件构成，每个组件都遵循单一职责原则：

图1：My-TODOs主界面展示基于PyQt-SiliconUI的现代化UI设计

主要UI组件层次结构：

TODOApplication (QMainWindow) ├── AppHeaderPanel (应用标题栏) ├── TODOListPanel (待办事项列表) ├── AddNewTODOPanel (新增待办面板) └── SettingsPanel (设置面板)

组件通信机制：

# 全局状态管理通过SiGlobal实现 SiGlobal.todo_list = NewGlobal() SiGlobal.todo_list.delete_pile = [] SiGlobal.todo_list.position_locked = False # 信号与槽机制实现组件间通信 self.header_panel.unfold_button.toggled.connect(self._onShowTODOButtonToggled) self.header_panel.add_todo_button.toggled.connect(self._onAddTODOButtonToggled) self.todo_list_panel.todoAmountChanged.connect(self._onTODOAmountChanged)

动画系统与用户体验优化

项目集成了SiliconUI的动画系统，为用户提供流畅的交互体验：

# 平滑移动动画实现 self.move_animation = SiExpAnimation(self) self.move_animation.setFactor(1 / 4) self.move_animation.setBias(1) self.move_animation.setCurrent([self.x(), self.y()]) self.move_animation.ticked.connect(self._onMoveAnimationTicked) def _onMoveAnimationTicked(self, pos): self.move(int(pos[0]), int(pos[1])) if SiGlobal.todo_list.position_locked is False: self.fixed_position = self.pos()

主题系统实现

My-TODOs支持深色和浅色双主题模式，通过统一的颜色管理系统实现：

def load_colors(is_dark=True): if is_dark is True: # 深色主题 SiGlobal.siui.colors["THEME"] = "#e1d9e8" SiGlobal.siui.colors["BACKGROUND_COLOR"] = "#252229" SiGlobal.siui.colors["BORDER_COLOR"] = "#3b373f" SiGlobal.siui.colors["TEXT_A"] = "#FFFFFF" else: # 浅色主题 SiGlobal.siui.colors["THEME"] = "#0F85D3" SiGlobal.siui.colors["BACKGROUND_COLOR"] = "#F3F3F3" SiGlobal.siui.colors["BORDER_COLOR"] = "#d0d0d0" SiGlobal.siui.colors["TEXT_A"] = "#1f1f2f" SiGlobal.siui.reloadAllWindowsStyleSheet()

实践应用：开发与部署指南

开发环境搭建

要基于My-TODOs进行二次开发或学习其实现，需要以下环境配置：

依赖安装：

# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/my/My-TODOs cd My-TODOs # 安装核心依赖 pip install PyQt5 pip install pyinstaller # 用于打包

项目结构说明：

My-TODOs/ ├── siui/ # SiliconUI核心库 │ ├── components/ # UI组件库 │ ├── core/ # 核心动画与颜色系统 │ └── gui/ # GUI工具类 ├── components/ # 应用特定组件 ├── icons/ # 图标资源 ├── start.py # 应用入口点 ├── ui.py # 主界面实现 ├── todos_parser.py # 待办事项解析器 ├── settings_parser.py # 设置解析器 ├── options.ini # 配置文件 └── todos.ini # 待办数据文件

自定义编译与打包

对于需要跨平台部署的场景，项目提供了完整的打包方案：

# 使用PyInstaller打包应用 Pyinstaller start.py --noconsole --onefile # 打包后需要复制的资源文件 # 1. options.ini - 应用配置文件 # 2. todos.ini - 待办事项数据文件 # 3. ./icons/icons.dat - 图标资源文件

打包注意事项：

确保所有依赖库正确包含
配置文件需要与可执行文件位于同一目录
图标资源文件路径需要正确配置

扩展功能开发

基于现有架构，开发者可以轻松扩展My-TODOs的功能：

添加新功能模块示例：

# 1. 创建新的设置选项 class NewFeatureOption(SingleSettingOption): def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) self.setTitle("新功能", "功能描述") # 添加交互控件 self.feature_switch = SiSwitch(self) self.feature_switch.toggled.connect(self._onFeatureToggled) self.addWidget(self.feature_switch) # 2. 在SettingsPanel中集成 self.new_feature = NewFeatureOption(self) self.new_feature.setTitle("新功能", "功能描述") self.body().addWidget(self.new_feature)

技术优化与性能考量

内存管理策略

My-TODOs采用轻量级的内存管理策略，确保应用在长时间运行时保持稳定：

延迟加载：UI组件按需创建和销毁
对象复用：频繁使用的组件进行缓存
事件解耦：通过信号槽机制减少耦合

响应式布局实现

项目采用自适应布局系统，确保在不同分辨率下都能提供良好的用户体验：

class SingleTODOOption(SiDenseHContainer): def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) self.setShrinking(True) self.check_box = SiCheckBox(self) self.check_box.resize(12, 12) self.text_label = SiLabel(self) self.text_label.resize(500 - 48 - 48 - 32, 32) # 动态宽度计算 self.text_label.setWordWrap(True) # 文本自动换行 self.text_label.setAutoAdjustSize(True)

数据持久化性能优化

通过批量写入和智能缓存机制，My-TODOs在保证数据安全的同时优化了IO性能：

def closeEvent(self, a0): """应用关闭时批量保存数据""" super().closeEvent(a0) # 批量写入待办事项 todos = [widget.text_label.text() for widget in self.todo_list_panel.body().widgets_top] SiGlobal.todo_list.todos_parser.todos = todos SiGlobal.todo_list.todos_parser.write() # 批量写入设置 SiGlobal.todo_list.settings_parser.modify("FIXED_POSITION_X", self.fixed_position.x()) SiGlobal.todo_list.settings_parser.modify("FIXED_POSITION_Y", self.fixed_position.y()) SiGlobal.todo_list.settings_parser.write()