零基础快速上手跨平台桌面待办工具 My-TODOs：10 分钟从下载到玩转-平芜编程栈

零基础快速上手跨平台桌面待办工具 My-TODOs：10 分钟从下载到玩转

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

My-TODOs 是一款免费开源、基于 PyQt-SiliconUI 打造的跨平台桌面待办工具，任务数据全部保存在本地todos.ini文件中，不联网、不注册、不收费，Windows / macOS / Linux 三平台通用。本文以新手视角，从下载安装讲到记录任务、勾选完成、切换主题、备份数据，最后快速浏览源码结构，帮你用 10 分钟把这款轻量待办软件完整跑起来。

先聊聊：为什么还有人执着于"本地待办"？

用过的云端待办应用越多，越容易遇到这几件烦心事：换设备要重新同步、免费版功能被砍、数据放在别人服务器上总觉得不踏实，偶尔断网干脆连列表都打不开。

本地化的思路刚好绕开了这些麻烦。像 My-TODOs 这样把数据写进本地文件的工具，启动快、无广告、不联网也能照常工作，任务内容只存在于你自己的电脑里，隐私风险天然低了一大截。它不追求功能堆砌，专注把"记一件事、做一件事"这两步做到顺手，这正是很多效率工具越做越复杂之后丢掉的东西。

第一印象：一眼看懂 My-TODOs 的界面布局

第一次打开 My-TODOs，你会看到一张悬浮的圆角卡片，而不是传统的方方正正窗口。它没有边框和标题栏，背景半透明，边缘带一层柔和的投影，整体观感干净利落，主色调是清爽的蓝色。

顶栏从左到右依次是：应用图标、显示待办数量的折叠按钮、设置按钮和"添加新待办"按钮。把鼠标悬停在按钮上，会弹出文字提示；点击按钮时，对应面板会带着平滑的动画展开或收起，过渡不突兀，细节手感相当好。

上手四连招：记任务、勾完成、清列表、看计数

别看界面简单，日常待办管理的几个核心动作它全都覆盖了。

记任务。点击顶栏右侧的添加按钮，展开输入面板，在文本区输入内容后点确认（或点取消放弃）。输入框支持多行文字，末尾多余的换行会被自动清理，空白内容则直接忽略，不会误存一条空任务。

勾完成。每条任务左侧都有一个复选框。这里有个小设计值得留意：勾选后任务并不会立刻消失，而是先进入一个"待删除队列"，等鼠标移出列表区域，被勾选的任务才会真正移除。这相当于给"反悔"留了一小段缓冲，手滑勾错了还能马上取消。

清列表。列表底部有一个"全部完成"按钮，点击后所有任务一次性全部勾选，配合上面的机制，鼠标移开后列表就清空了，适合周末集中清理。

看计数。顶部的折叠按钮会实时显示"几个待办事项"，列表为空时显示"没有待办"，列表内部还会出现一行浅色的"当前没有待办哦"。点一下这个按钮，整块列表可以折叠起来，只留一个干净的小卡片在桌面上。

数据存在哪：My-TODOs 的 todos.ini 与 options.ini 全解析

My-TODOs 的数据只由两个文本文件承载，这也是它全部"数据库"的所在。

todos.ini存放任务内容，每条任务以<TODO-START-MARK>作为分隔标记。程序退出时会把当前列表写回这个文件，所以下次启动时任务原样恢复。因为就是纯文本，你甚至可以直接用记事本查看和修改它。

options.ini存放应用设置，采用简单的键 = 值格式，主要配置项如下：

配置项	作用	默认值
`FIXED_POSITION`	是否锁定窗口位置	`False`
`USE_DARK_MODE`	是否启用深色模式	`False`
`FIXED_POSITION_X`	窗口记忆的横坐标	`1335`
`FIXED_POSITION_Y`	窗口记忆的纵坐标	`682`

备份与迁移因此变得格外简单：把todos.ini和options.ini两个文件复制到安全位置即可完成备份；换电脑时，把这两个文件放进新环境的程序目录，所有任务和窗口习惯原样带回。

细节控福音：深色模式与位置锁定的配置技巧

设置面板里藏着两个很实用的开关。

深色模式。默认是亮色主题，如果你常在夜间或暗色环境下工作，打开"深色模式"开关，整个界面会立刻切换为偏暗的紫色调，文字和边框颜色同步调整，长时间使用更护眼。这个开关的状态会写进options.ini，重启后依然生效。

锁定位置。开启后窗口会被"钉"在当前位置——即使拖动，松手后它也会自己滑回原处，适合想把待办卡片固定在某个屏幕角落、随时瞄一眼的场景。即使不开锁定，窗口每次退出时也会自动记录坐标，下次在相同位置出现，不会每次都"乱跑"。

另外，设置面板里还能找到开源许可证、第三方图标资源的说明以及作者信息，透明度做得比较足。

不用等官方包：跨平台桌面待办工具的源码打包指南

官方发布的 Release 包开箱即用，但如果你所在的平台没有现成安装包，或者想验证最新代码，可以走源码自打包路线。先在终端执行：

git clone https://gitcode.com/gh_mirrors/my/My-TODOs cd My-TODOs Pyinstaller start.py --noconsole

编译完成后，需要把三个关键文件移动到可执行文件所在目录：

options.ini—— 应用配置；
todos.ini—— 待办数据文件；
./icons/icons.dat—— 图标资源文件（程序图标依赖它加载）。

不同系统对文件路径的处理略有差异，如果启动时报错，结合报错信息调整这三个文件的位置即可。

谁适合用、怎么用得更好：三类人群与日常节奏

隐私敏感型用户：所有内容留在本机，不经过任何服务器，适合记录不便上传的私人安排。
离线场景工作者：出差、通勤、无网环境下任务照常添加和勾选，不受网络状态影响。
极简主义效率派：界面上没有多余菜单和广告，注意力能集中在任务本身。

配合这几个小习惯，用起来会更顺手：每天早上一口气把当天事项录入；把"写周报""预约体检"这类模糊想法拆成一句话能说清的小任务；隔几天用"全部完成"清一次列表，保持列表短而精。

新手高频疑问速答（FAQ）

Q：任务会自动保存吗？会不会一关就丢？会。程序退出时自动把当前列表写回todos.ini，下次启动完整恢复。

Q：勾选后任务去了哪里？勾选先进入删除队列，鼠标移出列表区域后才会真正移除，这是为了给误操作留缓冲。

Q：换电脑了怎么迁移？复制todos.ini和options.ini到新环境的程序目录即可，纯文本格式，兼容性很好。

Q：程序打不开或闪退怎么办？优先尝试源码自打包方案（见上文），并按报错信息调整三个数据文件的位置。

Q：支持云同步或手机端吗？不支持，这正是它的设计取向——本地优先、离线可用，数据完全由自己掌控。

想动手改改？My-TODOs 源码目录速览

项目体量小、结构清晰，适合作为 PyQt 入门读物。核心文件都在仓库根目录：

start.py—— 程序入口，负责初始化应用与全局主题色；
ui.py—— 主窗口逻辑，界面搭建、信号绑定、数据读写都在这里；
todos_parser.py—— 待办数据的读写解析；
settings_parser.py—— 配置文件的读写与类型转换；
components/themed_option_card.py—— 主题化卡片组件；
icons/—— 图标字典与icons.dat资源文件解析器；
siui/—— 所依赖的 PyQt-SiliconUI 组件库，按钮、标签、动画等控件都在siui/components/widgets/和siui/core/animation/下。