feat: expand runnable examples, playbooks, guides, catalog resources, and modernized tooling

- Add 3 new runnable examples: pydantic-validation, mcp-server, and async-fetcher
- Add 3 new task playbooks: write-llm-evals, setup-structured-logging, manage-database-migrations
- Add 3 new depth guides: modern-typing, async-patterns, and context-budget
- Add 8 new reviewed catalog resources (Ruff, Mypy, SQLAlchemy, Alembic, Polars, DuckDB, Instructor, MCP)
- Initialize Project Radar evaluated projects list in catalog/projects/
- Add reusable templates for agent IDE rules, eval records, and API specifications
- Modernize pyproject.toml and add Makefile for unified development tasks
- Generalize example verification and test discovery across all examples
- Re-export catalog.json, content-manifest.json, and rendered bilingual READMEs

Author: xxg1413

Makefile

@@ -0,0 +1,37 @@
+.PHONY: help check export render manifest test verify lint typecheck all
+
+PYTHON ?= python3
+
+help:
+	@echo "FlyPython Development Workflow:"
+	@echo "  make check      - Run all catalog, export, readme, manifest, and example checks"
+	@echo "  make export     - Regenerate catalog.json"
+	@echo "  make render     - Regenerate README and README_cn catalog indexes"
+	@echo "  make manifest   - Regenerate content-manifest.json"
+	@echo "  make test       - Run pytest test suite"
+	@echo "  make verify     - Verify all runnable examples"
+	@echo "  make all        - Regenerate all exports and run all checks and tests"
+
+check:
+	$(PYTHON) tools/validate_catalog.py
+	$(PYTHON) tools/export_catalog.py --check
+	$(PYTHON) tools/render_readmes.py --check
+	$(PYTHON) tools/build_content_manifest.py --check
+	$(PYTHON) tools/verify_examples.py
+
+export:
+	$(PYTHON) tools/export_catalog.py
+
+render:
+	$(PYTHON) tools/render_readmes.py
+
+manifest:
+	$(PYTHON) tools/build_content_manifest.py
+
+test:
+	$(PYTHON) -m pytest
+
+verify:
+	$(PYTHON) tools/verify_examples.py
+
+all: export render manifest test check

README.md

@@ -59,14 +59,14 @@ which access or safety constraints deserve attention.
 
 <!-- catalog-index:start -->
 <!-- Generated by tools/render_readmes.py; edit catalog/ instead. -->
-> **21 reviewed resources** · Catalog reviewed 2026-08-31 · 14 intermediate or advanced · Primary sources first
+> **29 reviewed resources** · Catalog reviewed 2026-09-02 · 21 intermediate or advanced · Primary sources first
 
 ### Choose a learning path
 
-- [**Python foundations**](#path-foundations) — Learn the language, environments, dependencies, typing, and tests that reliable Python work depends on. (6 resources)
-- [**Web and APIs**](#path-web-apis) — Build typed services and applications that connect Python logic to users and other systems. (5 resources)
-- [**Automation**](#path-automation) — Turn repeatable work into maintainable scripts, browser workflows, and data pipelines. (5 resources)
-- [**AI agents**](#path-ai-agents) — Learn tools, structured output, state, evaluation, and the safety boundaries of agent systems. (5 resources)
+- [**Python foundations**](#path-foundations) — Learn the language, environments, dependencies, typing, and tests that reliable Python work depends on. (8 resources)
+- [**Web and APIs**](#path-web-apis) — Build typed services and applications that connect Python logic to users and other systems. (7 resources)
+- [**Automation**](#path-automation) — Turn repeatable work into maintainable scripts, browser workflows, and data pipelines. (7 resources)
+- [**AI agents**](#path-ai-agents) — Learn tools, structured output, state, evaluation, and the safety boundaries of agent systems. (7 resources)
 
 <a id="path-foundations"></a>
 ### Python foundations
@@ -81,6 +81,8 @@ Learn the language, environments, dependencies, typing, and tests that reliable
 | [uv documentation](https://docs.astral.sh/uv/)<br><sub>Official project · Featured</sub> | A modern workflow for Python versions, virtual environments, dependencies, lockfiles, and project commands. | All levels<br>English | No API key<br>Low risk | 2026-08-31 |
 | [pytest documentation](https://docs.pytest.org/en/stable/)<br><sub>Official project</sub> | The official guide to test discovery, assertions, fixtures, parametrization, and maintainable test suites. | Intermediate<br>English | No API key<br>Low risk | 2026-08-31 |
 | [Python typing documentation](https://typing.python.org/en/latest/)<br><sub>Official docs</sub> | The canonical home for Python's type-system specification, guides, and typing best practices. | Intermediate<br>English | No API key<br>Low risk | 2026-08-31 |
+| [Ruff documentation](https://docs.astral.sh/ruff/)<br><sub>Official project · Featured</sub> | An extremely fast Python linter and code formatter written in Rust, replacing Flake8, Black, isort, and more. | All levels<br>English | No API key<br>Low risk | 2026-09-02 |
+| [Mypy documentation](https://mypy.readthedocs.io/en/stable/)<br><sub>Official project</sub> | The standard static type checker for Python to catch bugs and verify type contracts before running code. | Intermediate<br>English | No API key<br>Low risk | 2026-09-02 |
 
 <a id="path-web-apis"></a>
 ### Web and APIs
@@ -94,6 +96,8 @@ Build typed services and applications that connect Python logic to users and oth
 | [Flask documentation](https://flask.palletsprojects.com/en/stable/)<br><sub>Official docs</sub> | The maintained reference and tutorial for Flask applications, requests, templates, testing, and deployment. | Beginner<br>English | No API key<br>Low risk | 2026-08-31 |
 | [Pydantic documentation](https://pydantic.dev/docs/validation/latest/get-started/)<br><sub>Official docs</sub> | The primary guide to validating untrusted data and expressing typed contracts at Python system boundaries. | Intermediate<br>English | No API key<br>Low risk | 2026-08-31 |
 | [HTTPX documentation](https://www.python-httpx.org/)<br><sub>Official project</sub> | The official reference for synchronous and asynchronous HTTP clients, timeouts, streaming, and transport control. | Intermediate<br>English | No API key<br>Low risk | 2026-08-31 |
+| [SQLAlchemy documentation](https://docs.sqlalchemy.org/en/20/)<br><sub>Official project</sub> | The definitive Python SQL toolkit and Object Relational Mapper, providing type-safe database access and migrations. | Intermediate<br>English | No API key<br>Low risk | 2026-09-02 |
+| [Alembic documentation](https://alembic.sqlalchemy.org/en/latest/)<br><sub>Official project</sub> | Database migration tool for SQLAlchemy, providing transactional schema changes and rollback support. | Intermediate<br>English | No API key<br>Review permissions and side effects | 2026-09-02 |
 
 <a id="path-automation"></a>
 ### Automation
@@ -107,6 +111,8 @@ Turn repeatable work into maintainable scripts, browser workflows, and data pipe
 | [Playwright for Python](https://playwright.dev/python/docs/intro)<br><sub>Official docs</sub> | The official Python guide to reliable browser automation, locators, assertions, traces, and isolated contexts. | Intermediate<br>English | No API key<br>Review permissions and side effects | 2026-08-31 |
 | [Scrapy tutorial](https://docs.scrapy.org/en/latest/intro/tutorial.html)<br><sub>Official docs</sub> | The official introduction to crawl structure, extraction, item pipelines, persistence, and responsible operation. | Intermediate<br>English | No API key<br>Review permissions and side effects | 2026-08-31 |
 | [pandas getting started guides](https://pandas.pydata.org/docs/getting_started/index.html)<br><sub>Official docs</sub> | The primary entry point for tabular data loading, cleaning, transformation, analysis, and export. | Beginner<br>English | No API key<br>Low risk | 2026-08-31 |
+| [Polars documentation](https://docs.pola.rs/)<br><sub>Official project</sub> | Lightning-fast DataFrame library built on Apache Arrow and Rust, optimized for efficient data pipelines and parallel processing. | Intermediate<br>English | No API key<br>Low risk | 2026-09-02 |
+| [DuckDB Python API documentation](https://duckdb.org/docs/api/python/overview)<br><sub>Official project</sub> | Fast in-process analytical SQL engine for automated data transformation, Parquet querying, and embedded analytics. | Intermediate<br>English | No API key<br>Low risk | 2026-09-02 |
 
 <a id="path-ai-agents"></a>
 ### AI agents
@@ -120,6 +126,8 @@ Learn tools, structured output, state, evaluation, and the safety boundaries of
 | [Model Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro)<br><sub>Official standard · Featured</sub> | The open protocol and reference documentation for connecting AI applications to tools, data, and reusable context. | Intermediate<br>English | No API key<br>Review permissions and side effects | 2026-08-31 |
 | [LangGraph overview](https://docs.langchain.com/oss/python/langgraph/overview)<br><sub>Official docs</sub> | The official Python guide to stateful graph workflows, durable execution, memory, interrupts, and human review. | Advanced<br>English | API key typically required<br>Review permissions and side effects | 2026-08-31 |
 | [Google Agent Development Kit](https://adk.dev/)<br><sub>Official docs</sub> | Google's official documentation for developing, evaluating, and deploying modular agent systems. | Advanced<br>English | API key typically required<br>Review permissions and side effects | 2026-08-31 |
+| [Instructor documentation](https://python.useinstructor.com/)<br><sub>Official project</sub> | Structured outputs and validation for LLMs powered by Pydantic, enabling predictable tool calling and schema enforcement. | Intermediate<br>English | API key typically required<br>Review permissions and side effects | 2026-09-02 |
+| [Model Context Protocol Python SDK](https://github.com/modelcontextprotocol/python-sdk)<br><sub>Official project</sub> | Official Python implementation of the Model Context Protocol for building MCP servers and clients. | Intermediate<br>English | No API key<br>Review permissions and side effects | 2026-09-02 |
 
 Missing an important official source? [Propose a resource or report a correction](https://github.com/flypythoncom/python/issues/new/choose).
 <!-- catalog-index:end -->

README_cn.md

@@ -49,14 +49,14 @@ python examples/product-slug/verify.py solution
 
 <!-- catalog-index:start -->
 <!-- Generated by tools/render_readmes.py; edit catalog/ instead. -->
-> **21 条已审核资源** · 最近整体审核：2026-08-31 · 14 条进阶或高级资源 · 一手来源优先
+> **29 条已审核资源** · 最近整体审核：2026-09-02 · 21 条进阶或高级资源 · 一手来源优先
 
 ### 选择学习路径
 
-- [**Python 基础**](#path-foundations) — 掌握语言基础、环境、依赖、类型与测试，为可靠的 Python 项目打好根基。 (6 条资源)
-- [**Web 与 API**](#path-web-apis) — 构建有类型约束的服务和应用，把 Python 逻辑连接到用户与其他系统。 (5 条资源)
-- [**自动化**](#path-automation) — 把重复工作变成可维护的脚本、浏览器工作流和数据管道。 (5 条资源)
-- [**AI Agent**](#path-ai-agents) — 理解工具调用、结构化输出、状态、评测以及 Agent 系统的安全边界。 (5 条资源)
+- [**Python 基础**](#path-foundations) — 掌握语言基础、环境、依赖、类型与测试，为可靠的 Python 项目打好根基。 (8 条资源)
+- [**Web 与 API**](#path-web-apis) — 构建有类型约束的服务和应用，把 Python 逻辑连接到用户与其他系统。 (7 条资源)
+- [**自动化**](#path-automation) — 把重复工作变成可维护的脚本、浏览器工作流和数据管道。 (7 条资源)
+- [**AI Agent**](#path-ai-agents) — 理解工具调用、结构化输出、状态、评测以及 Agent 系统的安全边界。 (7 条资源)
 
 <a id="path-foundations"></a>
 ### Python 基础
@@ -71,6 +71,8 @@ python examples/product-slug/verify.py solution
 | [uv documentation](https://docs.astral.sh/uv/)<br><sub>官方项目 · 精选</sub> | 现代 Python 工作流，统一管理版本、虚拟环境、依赖、锁文件和项目命令。 | 所有阶段<br>英语 | 无需 API Key<br>低风险 | 2026-08-31 |
 | [pytest documentation](https://docs.pytest.org/en/stable/)<br><sub>官方项目</sub> | pytest 官方指南，覆盖测试发现、断言、fixture、参数化和可维护测试套件。 | 进阶<br>英语 | 无需 API Key<br>低风险 | 2026-08-31 |
 | [Python typing documentation](https://typing.python.org/en/latest/)<br><sub>官方文档</sub> | Python 类型系统规范、指南与类型标注实践的权威入口。 | 进阶<br>英语 | 无需 API Key<br>低风险 | 2026-08-31 |
+| [Ruff documentation](https://docs.astral.sh/ruff/)<br><sub>官方项目 · 精选</sub> | 极速的 Rust 驱动 Python 代码检查与格式化工具，统一替代 Flake8、Black 与 isort。 | 所有阶段<br>英语 | 无需 API Key<br>低风险 | 2026-09-02 |
+| [Mypy documentation](https://mypy.readthedocs.io/en/stable/)<br><sub>官方项目</sub> | Python 官方与社区主流的静态类型检查器，在运行前拦截类型错误并验证代码契约。 | 进阶<br>英语 | 无需 API Key<br>低风险 | 2026-09-02 |
 
 <a id="path-web-apis"></a>
 ### Web 与 API
@@ -84,6 +86,8 @@ python examples/product-slug/verify.py solution
 | [Flask documentation](https://flask.palletsprojects.com/en/stable/)<br><sub>官方文档</sub> | Flask 官方参考与教程，覆盖应用、请求、模板、测试和部署。 | 入门<br>英语 | 无需 API Key<br>低风险 | 2026-08-31 |
 | [Pydantic documentation](https://pydantic.dev/docs/validation/latest/get-started/)<br><sub>官方文档</sub> | 在 Python 系统边界验证不可信数据、定义类型契约的官方指南。 | 进阶<br>英语 | 无需 API Key<br>低风险 | 2026-08-31 |
 | [HTTPX documentation](https://www.python-httpx.org/)<br><sub>官方项目</sub> | 同步与异步 HTTP 客户端、超时、流式响应和传输控制的官方参考。 | 进阶<br>英语 | 无需 API Key<br>低风险 | 2026-08-31 |
+| [SQLAlchemy documentation](https://docs.sqlalchemy.org/en/20/)<br><sub>官方项目</sub> | Python 权威的 SQL 工具包与对象关系映射器（ORM），提供类型安全的数据持久化与访问。 | 进阶<br>英语 | 无需 API Key<br>低风险 | 2026-09-02 |
+| [Alembic documentation](https://alembic.sqlalchemy.org/en/latest/)<br><sub>官方项目</sub> | 基于 SQLAlchemy 的数据库迁移事实标准工具，提供事务性架构演进与版本回滚支持。 | 进阶<br>英语 | 无需 API Key<br>检查权限与副作用 | 2026-09-02 |
 
 <a id="path-automation"></a>
 ### 自动化
@@ -97,6 +101,8 @@ python examples/product-slug/verify.py solution
 | [Playwright for Python](https://playwright.dev/python/docs/intro)<br><sub>官方文档</sub> | 可靠浏览器自动化、定位器、断言、追踪和隔离上下文的 Python 官方指南。 | 进阶<br>英语 | 无需 API Key<br>检查权限与副作用 | 2026-08-31 |
 | [Scrapy tutorial](https://docs.scrapy.org/en/latest/intro/tutorial.html)<br><sub>官方文档</sub> | 爬虫结构、数据提取、item pipeline、持久化与负责任运行的官方入门。 | 进阶<br>英语 | 无需 API Key<br>检查权限与副作用 | 2026-08-31 |
 | [pandas getting started guides](https://pandas.pydata.org/docs/getting_started/index.html)<br><sub>官方文档</sub> | 表格数据读取、清洗、转换、分析和导出的官方入门入口。 | 入门<br>英语 | 无需 API Key<br>低风险 | 2026-08-31 |
+| [Polars documentation](https://docs.pola.rs/)<br><sub>官方项目</sub> | 基于 Apache Arrow 和 Rust 构建的极速 DataFrame 库，专为并行计算与现代数据管道优化。 | 进阶<br>英语 | 无需 API Key<br>低风险 | 2026-09-02 |
+| [DuckDB Python API documentation](https://duckdb.org/docs/api/python/overview)<br><sub>官方项目</sub> | 进程内高性能分析型 SQL 引擎，适用于自动化数据转换、Parquet 文件快速查询与嵌入式分析。 | 进阶<br>英语 | 无需 API Key<br>低风险 | 2026-09-02 |
 
 <a id="path-ai-agents"></a>
 ### AI Agent
@@ -110,6 +116,8 @@ python examples/product-slug/verify.py solution
 | [Model Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro)<br><sub>正式标准 · 精选</sub> | 连接 AI 应用、工具、数据与可复用上下文的开放协议和权威参考。 | 进阶<br>英语 | 无需 API Key<br>检查权限与副作用 | 2026-08-31 |
 | [LangGraph overview](https://docs.langchain.com/oss/python/langgraph/overview)<br><sub>官方文档</sub> | 有状态图工作流、持久执行、记忆、中断与人工审核的 Python 官方指南。 | 高级<br>英语 | 通常需要 API Key<br>检查权限与副作用 | 2026-08-31 |
 | [Google Agent Development Kit](https://adk.dev/)<br><sub>官方文档</sub> | Google 官方模块化 Agent 系统开发、评测与部署文档。 | 高级<br>英语 | 通常需要 API Key<br>检查权限与副作用 | 2026-08-31 |
+| [Instructor documentation](https://python.useinstructor.com/)<br><sub>官方项目</sub> | 基于 Pydantic 的大模型结构化输出与严格验证框架，确保工具调用与数据提取的确定性。 | 进阶<br>英语 | 通常需要 API Key<br>检查权限与副作用 | 2026-09-02 |
+| [Model Context Protocol Python SDK](https://github.com/modelcontextprotocol/python-sdk)<br><sub>官方项目</sub> | Model Context Protocol 官方 Python SDK，用于快速构建和集成标准的 MCP 工具与服务。 | 进阶<br>英语 | 无需 API Key<br>检查权限与副作用 | 2026-09-02 |
 
 没有找到合适的官方资料？可以[建议资源或报告错误](https://github.com/flypythoncom/python/issues/new/choose)。
 <!-- catalog-index:end -->