chore(deps): 统一依赖管理 - pnpm 11 + node:22 + golang:1.25 + python:3.12 + shared-* 集中化

- Node.js 统一到 node:22-alpine，Go 统一到 golang:1.25-alpine，Python 统一到 python:3.12-slim

- pnpm 升级到 11.13.0（corepack），新增 allowBuilds 白名单解决 ERR_PNPM_IGNORED_BUILDS

- 新增 packages/shared-py 集中 Python 共享依赖，shared-ts 补充 graphql-yoga/prom-client

- api-gateway 修复 go.mod 的 shared-go 依赖 + Dockerfile 改用 repo 根作 context

- Python 服务（data-ana/ai）Dockerfile 改用 repo 根作 context + 声明 uv workspace sources

- 16 个服务的 Dockerfile + CI + docker-compose.tools.yml 全部对齐版本矩阵

- known-issues.md 沉淀 9 条 pnpm 11 / uv workspace / Go shared-go 迁移经验

- 验证：4 服务完全成功（api-gateway /healthz 200），其余 install 成功（build 失败为预存 TS 错误）

services/ai/Dockerfile

@@ -1,6 +1,7 @@
 # 多阶段构建（G1 多阶段强制规则）
 # Stage 1: builder - 安装依赖 + 生成 proto 代码
 # Stage 2: runtime - 精简运行时镜像
+# 用法：docker build -t edu/ai:latest -f services/ai/Dockerfile .
 
 # === Stage 1: builder ===
 FROM python:3.12-slim AS builder
@@ -10,14 +11,19 @@ WORKDIR /app
 # 安装 uv（快速依赖管理）
 RUN pip install --no-cache-dir uv
 
-# 先复制依赖文件，利用 Docker layer cache
-COPY pyproject.toml ./
+# 复制 workspace 根配置 + shared-py 包（uv workspace 依赖）
+COPY pyproject.toml uv.lock* ./
+COPY packages/shared-py ./packages/shared-py
+
+# 复制 ai 服务配置
+COPY services/ai/pyproject.toml ./services/ai/pyproject.toml
 
 # 安装生产依赖（含 dev 依赖用于生成 proto）
+WORKDIR /app/services/ai
 RUN uv sync --all-extras
 
 # 复制源码
-COPY src ./src
+COPY services/ai/src ./src
 
 # 生成 gRPC 代码（如果 proto_gen 不存在或需更新）
 RUN uv run python -m grpc_tools.protoc \
@@ -33,14 +39,14 @@ WORKDIR /app
 
 # 安装运行时系统依赖（curl 用于健康检查）
 RUN apt-get update && apt-get install -y --no-install-recommends \
-    curl=7.88.* \
+    curl \
     && rm -rf /var/lib/apt/lists/*
 
-# 从 builder 复制虚拟环境
+# 从 builder 复制虚拟环境（uv workspace 在根目录创建 .venv）
 COPY --from=builder /app/.venv /app/.venv
 
 # 从 builder 复制源码（含生成的 proto 代码）
-COPY --from=builder /app/src /app/src
+COPY --from=builder /app/services/ai/src /app/src
 
 # 环境变量
 ENV PATH="/app/.venv/bin:$PATH" \

services/ai/pyproject.toml

@@ -4,10 +4,9 @@ version = "0.1.0"
 description = "AI 网关服务 - LLM 集成 + 出题 + 备课工作流（D6 智能洞察领域 · 生成子域）"
 requires-python = ">=3.12"
 dependencies = [
-    "fastapi>=0.115.0",
-    "uvicorn[standard]>=0.30.0",
-    "pydantic>=2.9.0",
-    "pydantic-settings>=2.5.0",
+    # 通过 workspace 继承 shared-py 集中声明的共享库版本
+    "edu-shared-py",
+    # 服务特有依赖（非共享库）
     "httpx>=0.27.0",
     # gRPC
     "grpcio>=1.66.0",
@@ -21,16 +20,11 @@ dependencies = [
     "redis>=5.1.0",
     # 重试机制（LLM 调用 + 下游 gRPC）
     "tenacity>=9.0.0",
-    # 可观测性三支柱
-    "opentelemetry-api>=1.27.0",
-    "opentelemetry-sdk>=1.27.0",
-    "opentelemetry-exporter-otlp>=1.27.0",
-    "opentelemetry-instrumentation-fastapi>=0.48b0",
-    "opentelemetry-instrumentation-grpc>=0.48b0",
-    "prometheus-client>=0.20.0",
-    "structlog>=24.4.0",
 ]
 
+[tool.uv.sources]
+edu-shared-py = { workspace = true }
+
 [project.optional-dependencies]
 dev = [
     "grpcio-tools>=1.66.0",