{ "$schema": "./schema/catalog-v1.schema.json", "schema_version": 1, "catalog": { "reviewed_on": "2026-09-06", "status": "active" }, "paths": [ { "id": "foundations", "order": 1, "title_en": "Python foundations", "title_zh": "Python 基础", "summary_en": "Learn the language, environments, dependencies, typing, and tests that reliable Python work depends on.", "summary_zh": "掌握语言基础、环境、依赖、类型与测试，为可靠的 Python 项目打好根基。" }, { "id": "web-apis", "order": 2, "title_en": "Web and APIs", "title_zh": "Web 与 API", "summary_en": "Build typed services and applications that connect Python logic to users and other systems.", "summary_zh": "构建有类型约束的服务和应用，把 Python 逻辑连接到用户与其他系统。" }, { "id": "automation", "order": 3, "title_en": "Automation", "title_zh": "自动化", "summary_en": "Turn repeatable work into maintainable scripts, browser workflows, and data pipelines.", "summary_zh": "把重复工作变成可维护的脚本、浏览器工作流和数据管道。" }, { "id": "ai-agents", "order": 4, "title_en": "AI agents", "title_zh": "AI Agent", "summary_en": "Learn tools, structured output, state, evaluation, and the safety boundaries of agent systems.", "summary_zh": "理解工具调用、结构化输出、状态、评测以及 Agent 系统的安全边界。" } ], "resources": [ { "id": "python-tutorial", "path": "foundations", "title": "The Python Tutorial", "url": "https://docs.python.org/3/tutorial/", "source_type": "official-docs", "level": "beginner", "language": "en", "why_en": "The primary introduction to Python syntax, data structures, modules, errors, classes, and the standard library.", "why_zh": "Python 官方入门教程，覆盖语法、数据结构、模块、异常、类与标准库。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": true, "order": 1 }, { "id": "python-venv", "path": "foundations", "title": "venv — Creation of virtual environments", "url": "https://docs.python.org/3/library/venv.html", "source_type": "official-docs", "level": "beginner", "language": "en", "why_en": "The standard-library reference for creating isolated Python environments and understanding their behavior.", "why_zh": "Python 标准库的虚拟环境参考，说明如何创建隔离环境及其运行方式。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 2 }, { "id": "python-packaging-guide", "path": "foundations", "title": "Python Packaging User Guide", "url": "https://packaging.python.org/en/latest/tutorials/packaging-projects/", "source_type": "official-docs", "level": "intermediate", "language": "en", "why_en": "The PyPA tutorial for project layout, build metadata, distributions, and publishing Python packages.", "why_zh": "PyPA 官方教程，覆盖项目结构、构建元数据、分发包与 Python 包发布。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 3 }, { "id": "uv-docs", "path": "foundations", "title": "uv documentation", "url": "https://docs.astral.sh/uv/", "source_type": "official-project", "level": "all-levels", "language": "en", "why_en": "A modern workflow for Python versions, virtual environments, dependencies, lockfiles, and project commands.", "why_zh": "现代 Python 工作流，统一管理版本、虚拟环境、依赖、锁文件和项目命令。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": true, "order": 4 }, { "id": "pytest-docs", "path": "foundations", "title": "pytest documentation", "url": "https://docs.pytest.org/en/stable/", "source_type": "official-project", "level": "intermediate", "language": "en", "why_en": "The official guide to test discovery, assertions, fixtures, parametrization, and maintainable test suites.", "why_zh": "pytest 官方指南，覆盖测试发现、断言、fixture、参数化和可维护测试套件。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 5 }, { "id": "typing-docs", "path": "foundations", "title": "Python typing documentation", "url": "https://typing.python.org/en/latest/", "source_type": "official-docs", "level": "intermediate", "language": "en", "why_en": "The canonical home for Python's type-system specification, guides, and typing best practices.", "why_zh": "Python 类型系统规范、指南与类型标注实践的权威入口。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 6 }, { "id": "ruff-docs", "path": "foundations", "title": "Ruff documentation", "url": "https://docs.astral.sh/ruff/", "source_type": "official-project", "level": "all-levels", "language": "en", "why_en": "An extremely fast Python linter and code formatter written in Rust, replacing Flake8, Black, isort, and more.", "why_zh": "极速的 Rust 驱动 Python 代码检查与格式化工具，统一替代 Flake8、Black 与 isort。", "reviewed_on": "2026-09-02", "status": "active", "requires_key": false, "risk": "low", "featured": true, "order": 7 }, { "id": "mypy-docs", "path": "foundations", "title": "Mypy documentation", "url": "https://mypy.readthedocs.io/en/stable/", "source_type": "official-project", "level": "intermediate", "language": "en", "why_en": "The standard static type checker for Python to catch bugs and verify type contracts before running code.", "why_zh": "Python 官方与社区主流的静态类型检查器，在运行前拦截类型错误并验证代码契约。", "reviewed_on": "2026-09-02", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 8 }, { "id": "fastapi-docs", "path": "web-apis", "title": "FastAPI documentation", "url": "https://fastapi.tiangolo.com/", "source_type": "official-docs", "level": "intermediate", "language": "en", "why_en": "A direct route from typed Python functions to tested APIs with validation and generated documentation.", "why_zh": "从带类型的 Python 函数出发，构建具备验证、测试和自动文档的 API。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": true, "order": 1 }, { "id": "django-tutorial", "path": "web-apis", "title": "Django documentation: First steps", "url": "https://docs.djangoproject.com/en/stable/intro/tutorial01/", "source_type": "official-docs", "level": "beginner", "language": "en", "why_en": "The official path through Django projects, models, views, templates, forms, tests, and reusable apps.", "why_zh": "Django 官方入门路径，覆盖项目、模型、视图、模板、表单、测试和可复用应用。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 2 }, { "id": "flask-docs", "path": "web-apis", "title": "Flask documentation", "url": "https://flask.palletsprojects.com/en/stable/", "source_type": "official-docs", "level": "beginner", "language": "en", "why_en": "The maintained reference and tutorial for Flask applications, requests, templates, testing, and deployment.", "why_zh": "Flask 官方参考与教程，覆盖应用、请求、模板、测试和部署。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 3 }, { "id": "pydantic-docs", "path": "web-apis", "title": "Pydantic documentation", "url": "https://pydantic.dev/docs/validation/latest/get-started/", "source_type": "official-docs", "level": "intermediate", "language": "en", "why_en": "The primary guide to validating untrusted data and expressing typed contracts at Python system boundaries.", "why_zh": "在 Python 系统边界验证不可信数据、定义类型契约的官方指南。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 4 }, { "id": "httpx-docs", "path": "web-apis", "title": "HTTPX documentation", "url": "https://www.python-httpx.org/", "source_type": "official-project", "level": "intermediate", "language": "en", "why_en": "The official reference for synchronous and asynchronous HTTP clients, timeouts, streaming, and transport control.", "why_zh": "同步与异步 HTTP 客户端、超时、流式响应和传输控制的官方参考。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 5 }, { "id": "sqlalchemy-docs", "path": "web-apis", "title": "SQLAlchemy documentation", "url": "https://docs.sqlalchemy.org/en/20/", "source_type": "official-project", "level": "intermediate", "language": "en", "why_en": "The definitive Python SQL toolkit and Object Relational Mapper, providing type-safe database access and migrations.", "why_zh": "Python 权威的 SQL 工具包与对象关系映射器（ORM），提供类型安全的数据持久化与访问。", "reviewed_on": "2026-09-02", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 6 }, { "id": "alembic-docs", "path": "web-apis", "title": "Alembic documentation", "url": "https://alembic.sqlalchemy.org/en/latest/", "source_type": "official-project", "level": "intermediate", "language": "en", "why_en": "Database migration tool for SQLAlchemy, providing transactional schema changes and rollback support.", "why_zh": "基于 SQLAlchemy 的数据库迁移事实标准工具，提供事务性架构演进与版本回滚支持。", "reviewed_on": "2026-09-02", "status": "active", "requires_key": false, "risk": "medium", "featured": false, "order": 7 }, { "id": "pathlib-docs", "path": "automation", "title": "pathlib — Object-oriented filesystem paths", "url": "https://docs.python.org/3/library/pathlib.html", "source_type": "official-docs", "level": "beginner", "language": "en", "why_en": "The standard-library reference for readable, cross-platform file and directory automation.", "why_zh": "使用可读、跨平台的对象式路径完成文件与目录自动化的标准库参考。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 1 }, { "id": "subprocess-docs", "path": "automation", "title": "subprocess — Subprocess management", "url": "https://docs.python.org/3/library/subprocess.html", "source_type": "official-docs", "level": "intermediate", "language": "en", "why_en": "The standard-library contract for launching processes, capturing output, handling failures, and avoiding unsafe shell usage.", "why_zh": "启动进程、捕获输出、处理失败并避免不安全 shell 用法的标准库契约。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "medium", "featured": false, "order": 2 }, { "id": "playwright-python", "path": "automation", "title": "Playwright for Python", "url": "https://playwright.dev/python/docs/intro", "source_type": "official-docs", "level": "intermediate", "language": "en", "why_en": "The official Python guide to reliable browser automation, locators, assertions, traces, and isolated contexts.", "why_zh": "可靠浏览器自动化、定位器、断言、追踪和隔离上下文的 Python 官方指南。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "medium", "featured": false, "order": 3 }, { "id": "scrapy-tutorial", "path": "automation", "title": "Scrapy tutorial", "url": "https://docs.scrapy.org/en/latest/intro/tutorial.html", "source_type": "official-docs", "level": "intermediate", "language": "en", "why_en": "The official introduction to crawl structure, extraction, item pipelines, persistence, and responsible operation.", "why_zh": "爬虫结构、数据提取、item pipeline、持久化与负责任运行的官方入门。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "medium", "featured": false, "order": 4 }, { "id": "pandas-getting-started", "path": "automation", "title": "pandas getting started guides", "url": "https://pandas.pydata.org/docs/getting_started/index.html", "source_type": "official-docs", "level": "beginner", "language": "en", "why_en": "The primary entry point for tabular data loading, cleaning, transformation, analysis, and export.", "why_zh": "表格数据读取、清洗、转换、分析和导出的官方入门入口。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 5 }, { "id": "polars-docs", "path": "automation", "title": "Polars documentation", "url": "https://docs.pola.rs/", "source_type": "official-project", "level": "intermediate", "language": "en", "why_en": "Lightning-fast DataFrame library built on Apache Arrow and Rust, optimized for efficient data pipelines and parallel processing.", "why_zh": "基于 Apache Arrow 和 Rust 构建的极速 DataFrame 库，专为并行计算与现代数据管道优化。", "reviewed_on": "2026-09-02", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 6 }, { "id": "duckdb-docs", "path": "automation", "title": "DuckDB Python API documentation", "url": "https://duckdb.org/docs/api/python/overview", "source_type": "official-project", "level": "intermediate", "language": "en", "why_en": "Fast in-process analytical SQL engine for automated data transformation, Parquet querying, and embedded analytics.", "why_zh": "进程内高性能分析型 SQL 引擎，适用于自动化数据转换、Parquet 文件快速查询与嵌入式分析。", "reviewed_on": "2026-09-02", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 7 }, { "id": "openai-agents-sdk", "path": "ai-agents", "title": "OpenAI Agents SDK", "url": "https://openai.github.io/openai-agents-python/", "source_type": "official-docs", "level": "intermediate", "language": "en", "why_en": "The official Python toolkit for agents, tools, handoffs, guardrails, sessions, tracing, and orchestration.", "why_zh": "面向 Agent、工具、handoff、guardrail、session、追踪与编排的官方 Python 工具包。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": true, "risk": "medium", "featured": true, "order": 1 }, { "id": "pydantic-ai", "path": "ai-agents", "title": "Pydantic AI", "url": "https://pydantic.dev/docs/ai/overview/", "source_type": "official-docs", "level": "intermediate", "language": "en", "why_en": "Typed agent development built around validated inputs, structured output, tools, testing, and model portability.", "why_zh": "以输入验证、结构化输出、工具、测试和模型可移植性为核心的类型安全 Agent 开发。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": true, "risk": "medium", "featured": true, "order": 2 }, { "id": "model-context-protocol", "path": "ai-agents", "title": "Model Context Protocol", "url": "https://modelcontextprotocol.io/docs/getting-started/intro", "source_type": "official-standard", "level": "intermediate", "language": "en", "why_en": "The open protocol and reference documentation for connecting AI applications to tools, data, and reusable context.", "why_zh": "连接 AI 应用、工具、数据与可复用上下文的开放协议和权威参考。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": false, "risk": "medium", "featured": true, "order": 3 }, { "id": "langgraph-python", "path": "ai-agents", "title": "LangGraph overview", "url": "https://docs.langchain.com/oss/python/langgraph/overview", "source_type": "official-docs", "level": "advanced", "language": "en", "why_en": "The official Python guide to stateful graph workflows, durable execution, memory, interrupts, and human review.", "why_zh": "有状态图工作流、持久执行、记忆、中断与人工审核的 Python 官方指南。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": true, "risk": "medium", "featured": false, "order": 4 }, { "id": "google-adk", "path": "ai-agents", "title": "Google Agent Development Kit", "url": "https://adk.dev/", "source_type": "official-docs", "level": "advanced", "language": "en", "why_en": "Google's official documentation for developing, evaluating, and deploying modular agent systems.", "why_zh": "Google 官方模块化 Agent 系统开发、评测与部署文档。", "reviewed_on": "2026-08-31", "status": "active", "requires_key": true, "risk": "medium", "featured": false, "order": 5 }, { "id": "instructor-docs", "path": "ai-agents", "title": "Instructor documentation", "url": "https://python.useinstructor.com/", "source_type": "official-project", "level": "intermediate", "language": "en", "why_en": "Structured outputs and validation for LLMs powered by Pydantic, enabling predictable tool calling and schema enforcement.", "why_zh": "基于 Pydantic 的大模型结构化输出与严格验证框架，确保工具调用与数据提取的确定性。", "reviewed_on": "2026-09-02", "status": "active", "requires_key": true, "risk": "medium", "featured": false, "order": 6 }, { "id": "anthropic-mcp-docs", "path": "ai-agents", "title": "Model Context Protocol Python SDK", "url": "https://github.com/modelcontextprotocol/python-sdk", "source_type": "official-project", "level": "intermediate", "language": "en", "why_en": "Official Python implementation of the Model Context Protocol for building MCP servers and clients.", "why_zh": "Model Context Protocol 官方 Python SDK，用于快速构建和集成标准的 MCP 工具与服务。", "reviewed_on": "2026-09-02", "status": "active", "requires_key": false, "risk": "medium", "featured": false, "order": 7 }, { "id": "mcp-2026-07-28-spec-release", "path": "ai-agents", "title": "MCP 2026-07-28 specification release", "url": "https://blog.modelcontextprotocol.io/posts/2026-07-28/", "source_type": "official-docs", "level": "intermediate", "language": "en", "why_en": "The official release announcement for the 2026-07-28 Model Context Protocol specification, covering the stateless redesign and breaking changes.", "why_zh": "Model Context Protocol 2026-07-28 规范的官方发布公告，说明无状态重构与破坏性变更。", "reviewed_on": "2026-09-06", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 8 }, { "id": "mcp-2026-07-28-release-candidate", "path": "ai-agents", "title": "MCP 2026-07-28 release candidate overview", "url": "https://blog.modelcontextprotocol.io/posts/2026-07-28-release-candidate/", "source_type": "official-docs", "level": "intermediate", "language": "en", "why_en": "The official release-candidate post that enumerates the 2026-07-28 breaking changes and the migration window for SDK maintainers.", "why_zh": "官方 RC 发布说明，逐项列出 2026-07-28 的破坏性变更以及留给 SDK 维护者的迁移窗口。", "reviewed_on": "2026-09-06", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 9 }, { "id": "anthropic-mcp-aaif-donation", "path": "ai-agents", "title": "Anthropic donating MCP to the Agentic AI Foundation", "url": "https://www.anthropic.com/news/donating-the-model-context-protocol-and-establishing-of-the-agentic-ai-foundation", "source_type": "official-docs", "level": "intermediate", "language": "en", "why_en": "Anthropic's announcement establishing neutral Linux Foundation governance for MCP under the Agentic AI Foundation.", "why_zh": "Anthropic 官方公告，宣布将 MCP 交由 Linux 基金会旗下的 Agentic AI Foundation 中立治理。", "reviewed_on": "2026-09-06", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 10 }, { "id": "aaif-model-context-protocol", "path": "ai-agents", "title": "MCP under the Agentic AI Foundation", "url": "https://aaif.io/projects/model-context-protocol", "source_type": "official-project", "level": "intermediate", "language": "en", "why_en": "The Agentic AI Foundation project page for MCP, the neutral governance home for specification development and roadmaps.", "why_zh": "Agentic AI Foundation 的 MCP 项目主页，是规范开发与路线图的中立治理入口。", "reviewed_on": "2026-09-06", "status": "active", "requires_key": false, "risk": "low", "featured": false, "order": 11 } ] }