catalog.json

{
  "$schema": "./schema/catalog-v1.schema.json",
  "schema_version": 1,
  "catalog": {
    "reviewed_on": "2026-09-02",
    "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
    }
  ]
}