第14讲 用AI开发Python桌面端应用运行说明

这是需要Python环境的源码应用，不是免安装软件。请先解压源码包，再在解压目录运行。
要求：Python 3.10以上，并包含能创建窗口的tkinter/Tk；无需第三方Python库。
先验证当前解释器：
python3 --version
python3 -m tkinter
第二条应打开一个独立窗口。仅能import tkinter不代表图形环境可用。

在解压目录启动：
python3 todo_app.py --data data/classroom-demo.json
检查：
python3 -B -m unittest discover -v

本机实际验证的解释器（不是其他机器的通用路径）：
/Library/Frameworks/Python.framework/Versions/3.11/bin/python3.11
在本项目的todo-ai-workflow/lesson14_desktop目录中，已实际启动：
/Library/Frameworks/Python.framework/Versions/3.11/bin/python3.11 todo_app.py --data data/classroom-20261028.json
实测为Python 3.11.9、Tk 8.6。默认数据位置为源码目录下data/tasks.json。
--data是相对当前工作目录的路径，因此先进入解压目录。演示请使用单独文件，不覆盖个人数据。
关闭窗口会退出程序；重新执行同一命令，检查任务与完成状态恢复。

本次Comate路线：新任务 → 日常任务 → 选择本地todo-ai-workflow目录 → 分轮发送提示词。
代码由本机Comate生成和修复；其内置环境无法正常初始化Tk，也不能调用本机GUI解释器。
因此真实窗口由本机Python另行启动，未更改Comate或系统的安全设置。
课堂模板是对6轮实际制作提示词的教学整理，软件的回复与等待时间可能不同。

最终版本40项自动检查通过；基础检查点31项通过。测试数不是发送提示词时的承诺。
桌面新增、完成、恢复、确认/取消删除、空名、三种筛选、关闭重开已经用键盘与原生对话框验证。
最终版键盘：输入框回车新增；Tab移动至列表，列表获焦自动选择首行；上下移动，空格切换状态。
基础版没有最终版新增的焦点改进，不应将最终版的全部键盘操作结论套用到基础版。
筛选只影响显示，统计仍按全部任务计算。
尚未逐项验证鼠标操作、损坏文件GUI弹窗、Windows环境。损坏文件保护已通过自动检查。
源码包不包含任务数据。备份任务时正常关闭程序，再备份实际使用的JSON文件。