v0.5.0

新增

• 现代 API：01_models_prompts.py 迁 with_structured_output；03_memory_graph.py（LangGraph StateGraph + MemorySaver）+ 老 API 对照 03_memory_runnable.py + 入口导航 03_memory.py
• examples/09_caching.py：缓存层（InMemoryCache / SQLiteCache）
• examples/10_rag_eval.py：RAG 评估（自建上下文命中率 + 可选 RAGAS）
• examples/11_observability.py：可观测性（token 计数 + LangSmith + OpenTelemetry）
• examples/INDEX.md / notebooks/INDEX.md（含 .en.md 英文版）：示例与笔记本入口导航
• mkdocs 真双语：接入 mkdocs-static-i18n（suffix 模式，自动生成 /en/ 子站 + 语言切换器）；32 篇文档内 ](X.en.md) 链接统一改为 /en/X/
• 配置集中化：引入 pydantic-settings（examples/_common/settings.py 集中管理 .env）
• Docker 部署：Dockerfile 加 HEALTHCHECK（探测 /health）+ 装 curl；README / docs/06 补 Docker 运行示例（含 -v data/chroma 挂载）
• 测试新增 test_env / test_paths / test_io / test_04_rag / test_03_memory_logic / test_06_langserve / test_10_rag_eval / test_11_observability，共 42 用例

变更

• _common/llm.py 加 temperature / timeout / max_retries 默认；get_llm / get_embeddings 透传 openai_api_base
• docs/04-retrieval-and-rag.md 补「进阶：评估」「进阶检索技术（Re-ranking / Hybrid Search）」
• CONTRIBUTING.md 增"提交 / 提 PR 前必跑 make lint && make test"指引
• CI：矩阵加 windows-latest 校验 Makefile.ps1；加 requirements.lock 可解析性校验（--dry-run）；coverage 源收敛 examples/_common 且 fail_under=85（实测 93%）
• Makefile / Makefile.ps1 增 format / coverage / security / lock-check 目标
• 依赖：langgraph、pydantic-settings 进 requirements.txt / requirements.lock