正文、示例与项目入口
正文和 Python现代开发示例、Python现代开发学习笔记.assets 放在同一目录。正文中的链接按这个关系打开。配套文件按章节分组；片段/ 对应讲解顺序，完整项目已经将续写代码合并到同一文件。
下面的目录都相对于 Python现代开发示例/。先打开索引找到当前任务，再进入项目目录运行。带 pyproject.toml 的项目在该文件所在目录准备环境；第三至五章的小包直接在包的上一级目录执行 python -m 包名。
| 章节与索引 | 完整程序位置 | 入口与主要用途 |
|---|---|---|
| 第一章：环境管理 | 环境管理/reading-pip、reading-uv |
比较解释器、安装位置与环境重建 |
| 第二章：基础语法 | 基础语法/ |
reading_summary.py、title_counts.py、reading_menu.py |
| 第三章：函数与模块 | 函数与模块/reading_project |
python -m readingkit，筛选并统计阅读时长 |
| 第四章：面向对象 | 面向对象/bookshelf_project |
python -m bookshelf，比较两种存储器 |
| 第五章：文件与数据库 | 文件与数据库/persistence_project |
python -m bookdata，导入、日志与导出 |
| 第六章：调试与项目组织 | 调试与项目组织/quality_project |
reading-log、tools/check.py |
| 第七章：Git 与 GitHub | Git与GitHub/starter、templates |
暂存、提交、双克隆与协作实验 |
| 第八章：并发、异步与 HTTP | 并发异步与HTTP/network_project |
reading-fetch 与本地 labserver |
| 第九章：爬虫与数据采集 | 爬虫与数据采集/crawler_project |
crawl-books 与本地 crawlsite |
| 第十章：Pygame | Pygame与交互程序/dodge_project |
dodge-game，开始、计分、暂停与重开 |
| 第十一章：NumPy | NumPy与数值计算/analysis_project |
reading-analyze，CSV 统计与图表 |
| 第十二章：Web 共同基础 | Web应用共同基础/web_project |
web-books，表单、会话与 JSON |
| 第十三章：FastAPI | FastAPI/api_project |
api-books，登录与书籍 API |
| 第十四章：Flask | Flask/shelf_project |
shelf-books，个人书架页面 |
| 第十五章：Django | Django/reading_project |
manage.py，迁移、阅读站与后台 |
| 第十六章：PyTorch | PyTorch与模型开发/training_project |
reading-train，回归、分类与检查点 |
| 第十七章：采集查询 | 综合项目与交付/catalog_project |
catalog，原始快照、事务与只读查询 |
| 第十七章：训练推理 | 综合项目与交付/model_project |
model-lab，版本发布与 FastAPI 推理 |
| 第十八章：学习助手 | LangChain与AgentRuntime/study_agent |
study-agent，检索、引用、确认与恢复 |
全部项目也可以从 配套文件总入口 查阅。框架项目的演示账号、页面操作和数据文件说明放在各自 README 中；短例仍从所属章的示例索引定位。