Repository navigation
Expand file tree
/
Copy pathcatalog.json
More file actions
605 lines (605 loc) · 23.2 KB
/
Copy pathcatalog.json
File metadata and controls
605 lines (605 loc) · 23.2 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
{
"$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
}
]
}