fix: 移除 pre-push hook

husky 9 的 pre-push hook 在 Windows Git Bash 下有 stdout 'Bad file descriptor' bug，
阻塞所有推送。Go 编译检查改由 CI 完成。

规范文档 docs/standards/git-workflow.md §3.4 保留 pre-push 设计说明，
待 husky 修复或迁移至 CI 后恢复。

.github/CODEOWNERS

@@ -0,0 +1,80 @@
+# Edu 平台 CODEOWNERS
+# 格式：路径  @owner
+# 作用：GitHub/Gitea 自动为 PR 分配 reviewer
+# 维护规则：
+#   1. 新增服务/包时，必须同步更新本文件
+#   2. owner 变更需开独立 PR，由架构组审批
+#   3. 与 docs/standards/git-workflow.md §4.7 保持同步
+# Team handle 占位符：@edu-platform/* 需在 Organization 中创建对应 team 后替换
+
+# ===== 架构与规则（架构组，2 人 review）=====
+/.trae/                    @edu-platform/arch
+/docs/architecture/        @edu-platform/arch
+/docs/standards/           @edu-platform/arch
+/scripts/arch-scan/        @edu-platform/arch
+
+# ===== 根配置（架构组，2 人 review，影响全局）=====
+/.commitlintrc.js          @edu-platform/arch
+/lint-staged.config.js     @edu-platform/arch
+/package.json              @edu-platform/arch
+/pnpm-workspace.yaml       @edu-platform/arch
+/go.work                   @edu-platform/arch
+/pyproject.toml            @edu-platform/arch
+/tsconfig.base.json        @edu-platform/arch
+
+# ===== 共享包（架构组，2 人 review，契约变更影响所有服务）=====
+/packages/shared-proto/    @edu-platform/arch
+/packages/shared-ts/       @edu-platform/arch
+/packages/shared-go/       @edu-platform/arch
+/packages/shared-py/       @edu-platform/arch
+/packages/shared-tokens/   @edu-platform/arch
+
+# ===== 网关层（Go）=====
+/services/api-gateway/     @edu-platform/gateway
+/services/push-gateway/    @edu-platform/gateway
+
+# ===== 业务微服务 =====
+# IAM（核心模块，2 人 review）
+/services/iam/             @edu-platform/iam
+# 教学核心
+/services/core-edu/        @edu-platform/edu-core
+/services/classes/         @edu-platform/edu-core
+# 内容资源
+/services/content/         @edu-platform/content
+# 消息通知
+/services/msg/             @edu-platform/messaging
+# 数据分析（Python）
+/services/data-ana/        @edu-platform/data
+# AI 网关（Python）
+/services/ai/              @edu-platform/ai
+
+# ===== BFF 聚合层（NestJS）=====
+/services/teacher-bff/     @edu-platform/edu-core
+/services/student-bff/     @edu-platform/edu-core
+/services/parent-bff/      @edu-platform/edu-core
+
+# ===== 微前端（Next.js）=====
+/apps/teacher-portal/      @edu-platform/frontend
+/apps/student-portal/      @edu-platform/frontend
+/apps/parent-portal/       @edu-platform/frontend
+/apps/admin-portal/        @edu-platform/frontend
+
+# ===== 基础设施（SRE，2 人 review，生产环境变更强制）=====
+/infra/k8s/                @edu-platform/sre
+/infra/backup/             @edu-platform/sre
+/infra/security/           @edu-platform/sre
+/infra/monitoring/         @edu-platform/sre
+/infra/docker-compose*.yml @edu-platform/sre
+
+# ===== CI/CD（SRE）=====
+/.github/                  @edu-platform/sre
+/.husky/                   @edu-platform/sre
+
+# ===== 文档（架构组）=====
+/docs/troubleshooting/     @edu-platform/arch
+/MIGRATION_GUIDE.md        @edu-platform/arch
+/README.md                 @edu-platform/arch
+/CHANGELOG.md              @edu-platform/arch
+
+# ===== 兜底（未匹配的文件由架构组 review）=====
+*                          @edu-platform/arch

.github/pull_request_template.md

@@ -0,0 +1,55 @@
+## 变更说明
+
+<!-- 简述本次变更的目的和实现方式 -->
+
+## 变更类型
+
+- [ ] feat: 新功能
+- [ ] fix: Bug 修复
+- [ ] perf: 性能优化
+- [ ] refactor: 重构
+- [ ] test: 测试
+- [ ] docs: 文档
+- [ ] build/ci: 构建/CI
+- [ ] chore: 杂项
+
+## 影响范围
+
+<!-- 列出受影响的服务/包 -->
+
+- 服务：
+- 包：
+- 数据库迁移：是 / 否
+- protobuf 契约变更：是 / 否（如变更是否向后兼容）
+- Kafka topic 变更：是 / 否
+- 架构文档变更：是 / 否
+
+## 测试情况
+
+- [ ] 单元测试通过
+- [ ] 集成测试通过
+- [ ] 本地手动测试通过
+- [ ] 新增测试覆盖新功能
+
+### 按语言的校验结果
+
+- TS 服务：`pnpm run lint` + `pnpm run typecheck`（如缺失脚本请说明）
+- Go 服务：`go vet ./...` + `go build ./...`
+- Python 服务：`ruff check src/`
+
+## 文档同步
+
+- [ ] 已更新服务 README（如涉及服务结构变更）
+- [ ] 已更新架构文档（如涉及架构变更）
+- [ ] 已运行 `pnpm run arch:scan` 更新 arch.db（arch.db 不入库，但本地验证必须通过）
+- [ ] 已更新 `docs/troubleshooting/known-issues.md`（如遇到新问题/经验）
+- [ ] 已更新 `.github/CODEOWNERS`（如新增服务/包）
+
+## Breaking Change
+
+- [ ] 否
+- [ ] 是（请在下方说明影响和迁移路径）
+
+## 关联 Issue
+
+Closes #

.husky/commit-msg

@@ -1 +1 @@
-npx --no-install commitlint --edit $1
+npx --no-install commitlint --edit $1

.husky/pre-commit

@@ -1 +1 @@
-npx --no-install lint-staged
+npx --no-install lint-staged

.trae/rules/project_rules.md

@@ -0,0 +1,372 @@
+# Edu 项目规则（微服务版）
+
+> 版本：1.0
+> 日期：2026-07-08
+> 适用范围：Edu 微服务架构（DDD + EDA + CQRS，多语言 monorepo）
+> 关联文档：
+>
+> - [004 架构影响地图](../../docs/architecture/004_architecture_impact_map.md)
+> - [理想蓝图 0010](../../docs/architecture/0010_architecture.md)
+> - [迁移指南](../../MIGRATION_GUIDE.md)
+> - [known-issues 速查](../../docs/troubleshooting/known-issues.md)
+
+---
+
+## 1. 架构图优先规则
+
+**任何任务开始前，必须先查阅架构影响地图，通过图定位代码和模块。**
+
+1. **先图后码**：执行任何分析、修改、搜索任务时，首先运行 `pnpm run arch:scan` 更新 arch.db，再通过 `pnpm run arch:query` 查询目标模块、函数、依赖关系，结合阅读 `docs/architecture/004_architecture_impact_map.md` 定位架构设计意图，最后按图索骥读取源码
+2. **图未覆盖则先补图**：如果发现项目中存在 arch.db 未记录的模块、函数、表、路由、proto 等结构，**必须先运行 `pnpm run arch:scan` 重新扫描**（多语言扫描器：TS + Go + Python + Proto），然后检查 004 是否需要补充
+3. **改码必同步图**：对源码的任何修改完成后，必须运行 `pnpm run arch:scan` 更新 arch.db；若架构设计意图有变化，同步更新 004
+
+### 架构文档清单
+
+| 文档                                               | 用途                                                     |
+| -------------------------------------------------- | -------------------------------------------------------- |
+| `docs/architecture/004_architecture_impact_map.md` | 架构设计意图唯一源（人类可读）                           |
+| `docs/architecture/0010_architecture.md`           | 理想蓝图（目标态）                                       |
+| `docs/architecture/roadmap/`                       | 长远规划（tech-debt / pending-features）                 |
+| `docs/architecture/runbooks/`                      | 运维手册（P6 硬化、post-p6-followup、incident-response） |
+| `docs/troubleshooting/known-issues.md`             | 已知问题速查（场景→技术映射 + 工作经验日志）             |
+
+### 需要同步图的场景
+
+- 新增/删除/重命名导出函数、组件、Hook、类型
+- 修改函数签名（参数、返回类型）
+- 修改权限点（Permissions 常量）或角色-权限映射
+- 新增/删除数据库表
+- 新增/删除路由页面、API 路由、gRPC 服务、proto message
+- 修改模块间依赖关系或服务间调用关系
+- 新增服务、新增模块、新增 proto 定义
+- 修改 Kafka topic、Outbox 事件命名
+
+### 同步方式
+
+- 修改源码后运行 `pnpm run arch:scan` 更新 arch.db（强制）
+- 若架构设计意图变化，同步更新 `docs/architecture/004_architecture_impact_map.md`
+- 若发现新的"场景→技术"映射或工作经验，更新 `docs/troubleshooting/known-issues.md`
+
+---
+
+## 2. 架构元数据库规则（arch.db）
+
+**arch.db 是代码结构唯一源，AI 工作前必须运行 `pnpm run arch:scan` 更新。**
+
+1. **多语言扫描**：arch.db 覆盖 TypeScript（ts-morph）、Go（tree-sitter-go）、Python（tree-sitter-python）、Proto（buf AST）四类语言
+2. **查询命令**：
+   - `pnpm run arch:query -- sql "<SQL>"` 自定义 SQL 查询
+   - `pnpm run arch:query -- module-deps` 查模块依赖
+   - `pnpm run arch:query -- module-reverse-deps <module>` 查反向依赖
+   - `pnpm run arch:query -- symbol-refs <symbol>` 查符号引用链
+   - `pnpm run arch:query -- tech-usage <tag>` 查技术使用
+   - `pnpm run arch:query -- violations` 查架构违规
+   - `pnpm run arch:query -- stats` 查总体统计
+   - `pnpm run arch:query -- modules` 查模块列表
+3. **arch.db 不替代 004**：arch.db 是"代码现状"，004 是"设计意图"，两者互补
+4. **预期规模**：模块数 ≥ 10（api-gateway、push-gateway、teacher-bff、iam、classes、core-edu、content、msg、data-ana、ai），符号数 ≥ 100
+
+---
+
+## 3. 编码规范
+
+详细规范见 `docs/standards/coding-standards.md`，以下为核心强制规则。
+
+### 3.1 代码质量规则
+
+- 每次修改后运行 `pnpm run lint` 和 `pnpm run typecheck` 确保零错误
+- TypeScript 服务必须用 `@RequirePermission()` 装饰器进行权限校验
+- 前端组件禁止使用 `role === "xxx"` 硬编码，统一使用 `usePermission().hasPermission()`
+- 单文件行数遵循企业级规范：
+  - 配置文件、常量文件、类型定义文件、proto：无限制
+  - Controller / Service：建议 ≤ 500 行
+  - Repository / data-access：建议 ≤ 800 行
+  - 工具函数：建议 ≤ 40 行
+  - 自定义 Hook：建议 ≤ 80 行
+  - 硬性上限：任何文件不超过 1000 行，超过必须拆分
+
+### 3.2 架构分层规则（微服务）
+
+- **四层分层**：Gateway → BFF → Services → Data
+- **依赖方向单向**：Gateway → BFF → Services → Data，禁止反向依赖
+- **服务间通信**：通过 protobuf gRPC 或 Kafka 事件，**禁止直接访问对方 DB**
+- **Gateway 职责**：JWT 校验、限流、熔断、CORS、请求 ID 注入
+- **BFF 职责**：聚合多个 Service 的数据，为前端提供场景化 API
+- **Service 职责**：业务逻辑，每服务独占 DB（DDD 限界上下文）
+
+### 3.3 模块标准结构（DDD）
+
+```
+services/[service]/src/
+├─ [domain]/                  # 限界上下文
+│  ├─ *.controller.ts         # Controller（HTTP/gRPC 入口）
+│  ├─ *.service.ts            # Application Service（编排层）
+│  ├─ *.repository.ts         # Repository（数据访问）
+│  ├─ *.schema.ts             # Zod 验证
+│  └─ *.dto.ts                # DTO
+├─ config/                    # 配置（database / env / kafka / neo4j / elasticsearch）
+├─ middleware/                # 中间件（auth.middleware / permission.guard）
+├─ shared/                    # 共享
+│  ├─ errors/                 # 错误（application-error / global-error.filter）
+│  ├─ health/                 # 健康检查
+│  ├─ lifecycle/              # 生命周期
+│  ├─ observability/          # 可观测性（logger / metrics / tracer）
+│  └─ outbox/                 # Outbox（仅事件驱动服务）
+├─ app.module.ts              # 根模块
+└─ main.ts                    # 入口
+```
+
+### 3.4 TypeScript 规则
+
+- **禁止 `any`**：未知类型用 `unknown` 并做类型守卫
+- **禁止 `as` 断言**（除非从 `unknown` 转换或测试中，需注释原因）
+- **函数返回值必须显式标注**，特别是 `Promise<T>`
+- **仅用于类型的导入必须使用 `import type`**
+- **可选链后禁止跟非空断言 `!`**
+- **ESM 模式**：NestJS ESM 模式下，相对 import 的 `.js` 后缀（构建产物）
+
+### 3.5 Go 规则
+
+- 包名小写单词，不使用下划线或驼峰
+- 导出函数必须有 doc comment（`// FuncName ...`）
+- 错误处理：`if err != nil { return err }`，禁止 `_ = err`
+- 不使用 `interface{}`，用 `any`（Go 1.18+）
+- 包内文件命名 lowercase，不使用下划线（除 `_test.go`）
+- 中间件位于 `internal/middleware/`，路由位于 `internal/routing/`
+
+### 3.6 Python 规则
+
+- 类型注解强制（所有函数签名、变量声明）
+- FastAPI 路由用 `APIRouter`
+- 异步优先：`async def`，IO 密集场景禁止同步阻塞调用
+- 模块名 snake_case，类名 PascalCase
+- 配置统一通过 `pydantic-settings` 管理（`config.py`）
+
+### 3.7 命名规范（多语言）
+
+| 对象        | 规范                                               | 示例                                             |
+| ----------- | -------------------------------------------------- | ------------------------------------------------ |
+| 目录        | kebab-case                                         | `api-gateway/`、`core-edu/`                      |
+| TS 组件     | PascalCase                                         | `UserController.ts`                              |
+| TS Hook     | camelCase                                          | `useAuth.ts`                                     |
+| Go 文件     | lowercase                                          | `circuitbreaker.go`                              |
+| Python 文件 | snake_case                                         | `clickhouse_client.py`                           |
+| Proto 文件  | snake_case                                         | `core_edu.proto`                                 |
+| 变量/函数   | camelCase（TS）/ lowercase（Go）/ snake_case（Py） | `getUserById` / `getUserById` / `get_user_by_id` |
+| 常量        | UPPER_SNAKE_CASE                                   | `MAX_RETRY_COUNT`                                |
+| 类/接口     | PascalCase，接口不加 `I` 前缀                      | `UserService`                                    |
+| 布尔值      | `is/has/can/should` 前缀                           | `isActive`、`hasPermission`                      |
+
+### 3.8 Controller / Server Action 规范
+
+- 每个 Controller 方法必须用 `@RequirePermission()` 装饰器声明权限
+- 输入用 Zod / class-validator 验证，验证失败返回结构化错误
+- 返回 protobuf message 或 DTO（结构同 ActionState）
+- 错误统一走 `GlobalErrorFilter`
+- BFF Controller 聚合多个 Service 调用，禁止直接访问 DB
+
+### 3.9 Tailwind 规范
+
+- 使用 `cn()` 工具函数管理条件类名
+- **禁止**字符串拼接动态类名（`bg-${color}-500`）
+- **禁止**使用任意值（`w-[137px]`），除非有充分理由并注释
+- 设计令牌在 `packages/shared-tokens/`（待建立）或 `apps/teacher-portal/src/app/styles/tokens/`
+
+### 3.10 设计令牌规范（强制）
+
+- **禁止硬编码颜色**：TSX/TS/CSS 中不得出现 `#hex` 颜色字面量，统一使用 `hsl(var(--*))` 或 Tailwind 类 `bg-*`
+- **禁止硬编码字体**：不得出现 `'Inter'`/`'Fraunces'`/`'JetBrains Mono'` 字面量，使用 `var(--font-family-sans/serif/mono)`
+- **禁止硬编码字号**：不得出现 `font-size: Npx`，使用 `var(--font-size-1~9)`
+- **禁止 Tailwind 任意值**：不得使用 `w-[Npx]`/`h-[Npx]`/`p-[Npx]` 等，映射到 `--space-*` 或 Tailwind 默认阶梯
+- **三层令牌**：
+  - Layer 1 Primitive：原始色板/字号/间距/阴影，业务代码不直接引用
+  - Layer 2 Semantic：语义令牌（light/dark），业务代码唯一引用入口
+  - Layer 3 Tailwind Theme：`@theme inline` 将 Semantic 令牌暴露为 `bg-*`/`text-*`/`font-*` 类
+- **改令牌必同步图**：修改令牌定义后，同步更新 004 与 arch.db
+- **ESLint 强制约束**：
+  - `no-restricted-syntax`：禁止 `#hex` 字面量
+  - `design-tokens/no-hardcoded-fonts`：禁止 `'Inter'`/`'Fraunces'` 字面量
+  - 白名单：`primitive.css`、`email-channel`、`manifest.ts`
+
+---
+
+## 4. 安全规范
+
+- **JWT RS256**：IAM 签发，Gateway 公钥校验（不共享密钥）
+- **Cookie**：`httpOnly + Secure + SameSite=Strict`
+- **环境变量**：服务端变量不加 `NEXT_PUBLIC_` 前缀；前端变量必须加
+- **环境校验**：用 `@t3-oss/env-nextjs` + Zod 或 `pydantic-settings` 校验
+- **禁止 `dangerouslySetInnerHTML`**（如必须使用，先用 DOMPurify 清洗）
+- **密码哈希**：bcrypt（cost ≥ 12），禁止 MD5/SHA1
+- **限流**：Gateway 层 IP 级令牌桶，登录接口额外加用户级限流
+- **CORS**：白名单域名，禁止 `*`
+- **WAF**：见 `infra/security/waf-rules.conf`
+
+---
+
+## 5. 契约规范
+
+- **契约先行**：服务间通信先定 `.proto`，再写实现
+- **工具链**：protobuf + buf v2
+- **buf lint**：`STANDARD` 规则集
+- **buf breaking**：`FILE` 级别检查（CI 强制）
+- **proto 文件位置**：`packages/shared-proto/proto/`
+- **包名规范**：`edu.<domain>.v1`（如 `edu.iam.v1`、`edu.core_edu.v1`）
+- **生成代码**：`buf generate`（TS 走 `buf.gen.yaml`，Go/Python 各自配置）
+- **gRPC 服务端口**：每服务独立端口，见 004 服务清单
+
+---
+
+## 6. 事件驱动规范
+
+- **Outbox 模式**：事务内写业务表 + outbox 表，独立 publisher 投递到 Kafka（保证 at-least-once）
+- **事件命名**：`<Aggregate>.<Action>`（如 `ExamCreated`、`HomeworkSubmitted`、`GradeReleased`）
+- **TOPIC_MAP 路由**：每个服务维护 `事件 → topic` 映射（见 `shared/outbox/`）
+- **幂等性**：
+  - Kafka producer：`idempotent=true` + `transactionalId`
+  - Consumer：基于 `event_id` 去重（Redis SETNX 或 DB 唯一索引）
+- **CDC**：MySQL → Debezium → Kafka（可选，用于读模型同步）
+- **事件版本**：schema 演化用 `v1`/`v2` 后缀，禁止破坏性变更
+
+---
+
+## 7. 提交规范
+
+- 使用 Conventional Commits 格式：`feat(scope): description`
+- **类型**：`feat`、`fix`、`chore`、`docs`、`style`、`refactor`、`test`、`perf`、`ci`
+- **scope**（服务名或包名）：
+  - 服务：`iam`、`classes`、`core-edu`、`content`、`msg`、`ai`、`data-ana`、`api-gateway`、`push-gateway`、`teacher-bff`
+  - 包：`shared-proto`、`shared-ts`、`shared-go`、`shared-py`、`shared-tokens`
+  - 基础设施：`infra`、`k8s`、`helm`、`ci`
+  - 文档：`docs`
+- **提交前必须运行**：`pnpm run lint` + `pnpm run typecheck`（TS）；`go vet ./...`（Go）；`ruff check src/`（Python）
+- **commitlint + husky**：强制校验（见 `.commitlintrc.js`、`.husky/commit-msg`）
+
+---
+
+## 8. Git 工作流
+
+- **分支策略**：trunk-based（直接提交 main 分支，小项目）
+- **大型团队**：feature branch + PR，PR 至少 1 人 review
+- **pre-commit hook**：`lint-staged` 自动修复 + 校验（见 `lint-staged.config.js`）
+- **commit-msg hook**：commitlint 校验格式
+- **禁止 force push**：除非显式要求并通知团队
+
+---
+
+## 9. 问题记录规则
+
+**所有工作完成后，必须将遇到的问题记录到 `docs/troubleshooting/known-issues.md`（索引式速查手册）。**
+
+### 必须记录的场景
+
+| 场景                                               | 记录要求                          |
+| -------------------------------------------------- | --------------------------------- |
+| 构建报错（dev/build/lint/tsc/go vet/ruff）         | 记录到"全局经验"对应主题分区      |
+| 运行时异常（白屏/API 报错/数据加载失败/gRPC 错误） | 记录到"模块经验"对应模块分区      |
+| 框架/库版本兼容问题                                | 记录到"全局经验: 框架与运行时"    |
+| 依赖配置问题（go mod / uv / pnpm workspace）       | 记录到"全局经验: 依赖管理"        |
+| 架构约束违规（跨服务访问 DB / 缺契约）             | 记录到"全局经验: 架构约束"        |
+| 多语言 monorepo 问题（共享包链接失败等）           | 记录到"全局经验: 多语言 monorepo" |
+
+### 记录格式
+
+索引式表格，指明"场景→技术/规则"映射，不写多行代码示例：
+
+```markdown
+### X.X 主题分区
+
+| 场景     | 技术/规则          |
+| -------- | ------------------ |
+| 简述场景 | 正确做法（一句话） |
+```
+
+### 记录要求
+
+- **索引式**：场景→技术/规则映射，不写代码示例和错误示范列
+- **去重**：同类问题在原条目补充，不重复创建
+- **引用架构规则**：架构分层、模块结构等规则引用 004 和本规则文件，不重复
+- **工作经验日志**：在"工作经验日志"区按时间倒序追加（50 条上限），记录"做了什么/学到什么/下次注意"
+
+---
+
+## 10. AI 工作强制流程
+
+**所有 AI 工作必须遵循此流程，违反即违规。**
+
+### 阶段 1：上下文加载
+
+1. `pnpm run arch:scan` 更新 arch.db
+2. `pnpm run arch:query -- module-deps` 查目标模块依赖
+3. `pnpm run arch:query -- symbol-refs <目标函数>` 查调用链
+4. 阅读 `services/[service]/README.md` 读模块工作流程
+5. 查 `docs/troubleshooting/known-issues.md` "模块经验"分区读相关经验
+6. 查 `docs/architecture/004_architecture_impact_map.md` 对应章节
+
+### 阶段 2：执行工作
+
+1. 按规划执行（契约先行：先 proto，再实现）
+2. 修改代码后立即运行 `pnpm run arch:scan` 更新 arch.db
+3. 运行质量校验确保零错误：
+   - TS：`pnpm run lint` + `pnpm run typecheck`
+   - Go：`go vet ./...` + `go build ./...`
+   - Python：`ruff check src/`
+
+### 阶段 3：经验沉淀（强制，不可跳过）
+
+1. 在 `docs/troubleshooting/known-issues.md` "工作经验日志"区追加一条记录：
+   - 日期 + 时间
+   - 模块
+   - 做了什么 + 学到什么
+2. 若发现新的"场景→技术"映射 → 提炼到对应模块分区
+3. 若发现新的架构决策 → 更新 004
+4. 若代码结构变化 → `pnpm run arch:scan` 确认 arch.db 已更新
+
+---
+
+## 11. 多语言 monorepo 规则
+
+- **包管理器分工**：
+  - TypeScript：pnpm workspace（`pnpm-workspace.yaml`）
+  - Go：go.work（`go.work`）
+  - Python：uv workspace（根 `pyproject.toml` 的 `[tool.uv.workspace]`）
+- **共享包**（`packages/`）：
+  - `shared-proto`：protobuf 契约定义（跨语言共享）
+  - `shared-ts`：TypeScript 共享类型与工具（待建立）
+  - `shared-go`：Go 共享工具（待建立）
+  - `shared-py`：Python 共享工具（待建立）
+  - `shared-tokens`：设计令牌（待建立）
+- **跨语言契约**：通过 protobuf，禁止 JSON Schema 或 OpenAPI 作为内部契约
+- **依赖版本对齐**：共享依赖（如 uuid、jwt）在多语言版本号保持一致
+
+---
+
+## 12. 可观测性规范
+
+- **三支柱必须同时启用**（所有服务）：
+  - **日志**：pino（TS）/ zap（Go）/ structlog（Python）—— 结构化 JSON
+  - **指标**：prom-client（TS）/ prometheus（Go）/ prometheus-client（Python）—— `/metrics` 端点
+  - **链路**：OpenTelemetry SDK + OTLP exporter —— 统一 traceparent
+- **健康检查**：`/health`（liveness）+ `/ready`（readiness），见各服务 `shared/health/`
+- **请求 ID**：Gateway 注入 `X-Request-Id`，全链路传递（日志、metrics、trace）
+- **指标命名**：`<service>_<module>_<operation>_<unit>`（如 `iam_login_duration_seconds`）
+- **告警规则**：见 `infra/prometheus/rules.yml` + `infra/alertmanager/alertmanager.yml`
+- **Grafana 面板**：见 `infra/grafana/dashboards/`
+
+---
+
+## 13. 部署与基础设施规范
+
+- **容器化**：每服务独立 Dockerfile（见 `services/[service]/Dockerfile`）
+- **K8s**：基础设施 manifest 位于 `infra/k8s/`，演化目标为 Helm chart（见 `infra/k8s/helm/`）
+- **命名空间**：`edu-system`、`edu-monitoring`、`edu-chaos`、`edu-backup`
+- **配置分离**：
+  - ConfigMap：非敏感配置（环境变量、特性开关）
+  - Secret：敏感配置（DB 密码、JWT 密钥、API key）—— 见 `infra/security/secrets.example.env`
+- **备份**：见 `infra/backup/backup-mysql.sh`，每服务独立备份，保留 7 天
+- **监控栈**：Prometheus + Grafana + Alertmanager（见 `infra/docker-compose.monitoring.yml`）
+- **混沌工程**：见 `infra/chaos/experiments.yaml`
+
+---
+
+**本规则文件是项目的强制约束，所有 contributor（含 AI）必须遵守。规则变更需同步更新 004 与 arch.db。**

MIGRATION_GUIDE.md

@@ -5,7 +5,8 @@
 > 状态：基线发布
 > 维护者：架构组
 > 关联文档：
-> - [项目规则](./project_rules.md)
+>
+> - [项目规则](./.trae/rules/project_rules.md)
 > - [编码规范](./docs/standards/coding-standards.md)
 > - [Git 工作流](./docs/standards/git-workflow.md)
 
@@ -31,7 +32,7 @@
 原始项目 CICD 是基于 Next.js 16 的单应用架构，承载 K12 智慧教务系统 35 个业务模块。随着业务规模扩张与团队增长，单应用架构在以下方面暴露瓶颈：
 
 | 维度     | 单应用瓶颈                         | 微服务目标                                        |
-|------|-----------|-----------|
+| -------- | ---------------------------------- | ------------------------------------------------- |
 | 团队协作 | 35 模块挤在同一仓库，合并冲突频繁  | 按领域拆分，6 领域团队独立迭代                    |
 | 部署节奏 | 全量构建发布，单模块变更牵动全站   | 服务粒度独立部署，故障爆炸半径缩小                |
 | 技术选型 | TypeScript 单语言，AI/分析场景受限 | TS（业务）+ Go（网关）+ Python（AI/分析）各取所长 |
@@ -53,7 +54,7 @@
 ### 2.1 基本概况
 
 | 属性       | 值                                                 |
-|------|-----|
+| ---------- | -------------------------------------------------- |
 | 仓库路径   | `e:\Desktop\CICD`                                  |
 | 技术栈     | Next.js 16 + React 19 + Tailwind v4 + Drizzle ORM  |
 | 语言       | TypeScript（全栈）                                 |
@@ -66,7 +67,7 @@
 ### 2.2 模块清单（按领域归类）
 
 | 领域       | 模块                                                   |
-|------|------|
+| ---------- | ------------------------------------------------------ |
 | 身份与权限 | auth、users、onboarding、settings、permissions         |
 | 教学组织   | classes、teachers、students、parents、subjects         |
 | 教学核心   | courses、lessons、schedule、attendance、leave-requests |
@@ -95,7 +96,7 @@
 ### 3.1 基本概况
 
 | 属性          | 值                                                                 |
-|------|-----|
+| ------------- | ------------------------------------------------------------------ |
 | 仓库路径      | `e:\Desktop\Edu`                                                   |
 | 远程仓库      | https://git.eazygame.cn/xiner/Edu.git                              |
 | 架构范式      | DDD + EDA + CQRS 微服务                                            |
@@ -165,14 +166,14 @@ flowchart TB
 ### 3.3 微前端与领域服务映射
 
 | 微前端        | 路由前缀   | 对接 BFF           | 主要消费的服务          |
-|--------|---------|---------|---------------|
+| ------------- | ---------- | ------------------ | ----------------------- |
 | Admin Shell   | `/admin`   | Admin BFF          | identity、org、insight  |
 | Teacher Shell | `/teacher` | Teacher BFF        | teaching、content、comm |
 | Student Shell | `/student` | Student/Parent BFF | teaching、content       |
 | Parent Shell  | `/parent`  | Student/Parent BFF | teaching、comm          |
 
 | 微服务                   | 原始模块映射                                                            | 主存储                | 对外契约           |
-|--------|------------|--------|---------|
+| ------------------------ | ----------------------------------------------------------------------- | --------------------- | ------------------ |
 | identity                 | auth、users、onboarding、settings、permissions                          | MySQL + Redis         | identity.proto     |
 | org                      | classes、teachers、students、parents、subjects                          | MySQL                 | org.proto          |
 | teaching                 | courses、lessons、schedule、attendance、leave-requests、exams、homework | MySQL                 | teaching.proto     |
@@ -191,7 +192,7 @@ flowchart TB
 ### 4.1 规范类资产
 
 | 资产                             | 策略     | 说明                                                                        |
-|------|------|------|
+| -------------------------------- | -------- | --------------------------------------------------------------------------- |
 | 项目规则（project_rules）        | 调整     | 架构图优先保留，分层规则从三层改为微服务分层，新增 DDD/契约/事件驱动规则    |
 | 编码规范（coding-standards）     | 调整     | TS 部分保留并补充 NestJS 装饰器/DI 规则，新增 Go、Python、protobuf 章节     |
 | Git 工作流                       | 调整     | trunk-based 替代分支策略，scope 改为服务/包名，新增多语言 monorepo 提交规则 |
@@ -204,7 +205,7 @@ flowchart TB
 ### 4.2 代码类资产
 
 | 资产                           | 策略     | 说明                                                          |
-|------|------|------|
+| ------------------------------ | -------- | ------------------------------------------------------------- |
 | Zod schema 定义                | 直接迁移 | 各模块 schema.ts 平移至对应微服务，复用验证规则               |
 | 权限点常量（Permissions）      | 直接迁移 | 集中迁入 identity 服务共享包                                  |
 | Drizzle schema（表结构）       | 调整     | 按领域拆分到各微服务独占库，关系型字段保持不变                |
@@ -221,7 +222,7 @@ flowchart TB
 ### 4.3 文档类资产
 
 | 资产                | 策略     | 说明                                   |
-|------|------|------|
+| ------------------- | -------- | -------------------------------------- |
 | 架构影响地图（004） | 重写     | 从单应用模块图改为微服务限界上下文图   |
 | K12 功能清单（006） | 直接迁移 | 功能清单与架构无关，直接平移           |
 | 差距审计报告（007） | 调整     | 重新审计各微服务的功能完成度           |
@@ -235,7 +236,7 @@ flowchart TB
 ## 五、文档体系映射表
 
 | CICD 文档                                          | Edu 对应文档                                     | 关系               |
-|-----------|------------|------|
+| -------------------------------------------------- | ------------------------------------------------ | ------------------ |
 | `.trae/rules/project_rules.md`                     | `project_rules.md`                               | 调整（微服务版）   |
 | `docs/standards/coding-standards.md`               | `docs/standards/coding-standards.md`             | 调整（多语言版）   |
 | —（散落在 project_rules）                          | `docs/standards/git-workflow.md`                 | 新建               |
@@ -284,7 +285,7 @@ gantt
 ### 6.2 各阶段目标
 
 | 阶段 | 名称     | 目标                                      | 关键交付物                                         | 验收信号                        |
-|------|------|------|-----------|---------|
+| ---- | -------- | ----------------------------------------- | -------------------------------------------------- | ------------------------------- |
 | P1   | 地基     | 仓库骨架、契约工具链、CI、可观测平台      | monorepo 结构、buf 配置、Kafka 集群、OpenTelemetry | 契约生成 + 一次端到端 trace     |
 | P2   | 身份     | identity + auth + notification 三服务打通 | JWT 颁发、RBAC、邮件/短信/站内通知                 | 用户注册→登录→收到通知          |
 | P3   | 核心教学 | org + teaching + content                  | 班级/课表/作业/题库/考试                           | 教师创建作业→学生提交→批改闭环  |
@@ -311,7 +312,7 @@ gantt
 **复用方式**：将 CICD 的 `src/app/styles/tokens/` 五层分层模型平移至微前端共享包。
 
 | CICD 位置                                      | Edu 位置                                    | 调整     |
-|-----------|---------|------|
+| ---------------------------------------------- | ------------------------------------------- | -------- |
 | `src/app/styles/tokens/primitive.css`          | `packages/ui-tokens/primitive.css`          | 直接平移 |
 | `src/app/styles/tokens/semantic-light.css`     | `packages/ui-tokens/semantic-light.css`     | 直接平移 |
 | `src/app/styles/tokens/semantic-dark.css`      | `packages/ui-tokens/semantic-dark.css`      | 直接平移 |
@@ -319,6 +320,7 @@ gantt
 | `src/app/styles/tokens/tailwind-theme.css`     | `packages/ui-tokens/tailwind-theme.css`     | 直接平移 |
 
 **强制规则保持不变**：
+
 - 禁止硬编码颜色（`#hex`）
 - 禁止硬编码字体（`'Inter'`/`'Fraunces'`/`'JetBrains Mono'`）
 - 禁止硬编码字号（`font-size: Npx`）
@@ -330,13 +332,14 @@ gantt
 **复用方式**：将 CICD 的 `src/shared/components/ui/` 平移至 `packages/ui-components/`，作为 Module Federation 共享依赖。
 
 | 组件类别                        | CICD 路径                 | Edu 路径                         | 复用要点                                                     |
-|---------|----------|---------|---------|
+| ------------------------------- | ------------------------- | -------------------------------- | ------------------------------------------------------------ |
 | 基础组件（Button/Input/Dialog） | `shared/components/ui/`   | `packages/ui-components/`        | 全部平移，保持 PascalCase 命名                               |
 | A11y 组件                       | `shared/components/a11y/` | `packages/ui-components/a11y/`   | skip-link、visually-hidden、focus-trap、aria-status 全部平移 |
 | 图表组件                        | 各模块内                  | `packages/ui-components/charts/` | 收集 recharts 封装，统一暴露                                 |
 | 表单组件                        | react-hook-form 封装      | `packages/ui-components/form/`   | 与 zod resolver 一同平移                                     |
 
 **复用规则**：
+
 - 组件必须为纯函数，使用 `function` 声明
 - 不使用 `React.FC`，直接用函数声明 + 显式标注 props 类型
 - 默认服务端组件（微前端 host），需要交互时才添加 `"use client"`
@@ -347,13 +350,14 @@ gantt
 **复用方式**：将 CICD 的 `requirePermission()` + `usePermission().hasPermission()` 模式平移至 identity 服务 + auth 基础设施服务。
 
 | CICD 资产                                       | Edu 位置                                                       | 调整                             |
-|-----------|---------|------|
+| ----------------------------------------------- | -------------------------------------------------------------- | -------------------------------- |
 | `shared/lib/auth-guard.ts`（requirePermission） | `services/auth/src/guards/permission.guard.ts`（NestJS Guard） | 改为 NestJS Guard 装饰器         |
 | `shared/types/permissions.ts`（权限点常量）     | `packages/contracts/src/permissions.ts`                        | 集中到 contracts 包，多服务共享  |
 | `usePermission` Hook                            | `packages/ui-components/hooks/use-permission.ts`               | 通过 BFF 拉取权限，Hook 接口不变 |
 | 角色权限矩阵（008）                             | `docs/architecture/role_mapping.md`                            | 直接平移                         |
 
 **强制规则保持不变**：
+
 - 每个 Controller/Action 必须调用 `requirePermission()` 等价物
 - 前端组件禁止使用 `role === "xxx"` 硬编码，统一使用 `usePermission().hasPermission()`
 
@@ -362,7 +366,7 @@ gantt
 **复用方式**：CICD 的 `cacheFn`（React `cache()` + 自定义缓存层）改为 NestJS Cache 模块 + Redis，**权限数据不跨请求缓存**的规则沿用。
 
 | CICD 模式                | Edu 模式                                            | 备注                                  |
-|-----------|---------|------|
+| ------------------------ | --------------------------------------------------- | ------------------------------------- |
 | `cacheFn`（React cache） | NestJS `@UseInterceptors(CacheInterceptor)` + Redis | 单请求内缓存改为 NestJS REQUEST scope |
 | `unstable_cache`         | 禁用                                                | CICD 已禁用，Edu 沿用禁用决策         |
 | 权限数据缓存             | 仅在 auth 服务内部缓存，TTL ≤ 60s                   | 跨服务不缓存权限                      |
@@ -373,7 +377,7 @@ gantt
 **复用方式**：CICD 的 Server Action 编排模式（权限 + Zod 验证 + 调用 data-access + revalidate）平移为 NestJS Application Service 编排模式。
 
 | CICD Server Action 步骤   | NestJS Application Service 对应             |
-|------------------------|-------------------------------|
+| ------------------------- | ------------------------------------------- |
 | `requirePermission(perm)` | `@RequirePermission(perm)` 装饰器 + Guard   |
 | Zod `safeParse`           | `ValidationPipe` + DTO class-validator      |
 | 调用 `data-access`        | 调用 Domain Service / Repository            |
@@ -385,7 +389,7 @@ gantt
 **复用方式**：CICD 的 5 层状态模型平移至微前端 host 应用。
 
 | 层级               | CICD 方案                     | Edu 方案                      | 备注     |
-|------|----------|---------|------|
+| ------------------ | ----------------------------- | ----------------------------- | -------- |
 | L1 URL             | nuqs                          | nuqs                          | 直接平移 |
 | L2 Server          | TanStack Query                | TanStack Query                | 直接平移 |
 | L3 Client Business | Zustand slice                 | Zustand slice                 | 直接平移 |
@@ -410,7 +414,7 @@ gantt
 **复用方式**：平移至 notification 服务，日志结构保持。
 
 | CICD 资产                     | Edu 位置                                             | 备注                         |
-|-----------|---------|------|
+| ----------------------------- | ---------------------------------------------------- | ---------------------------- |
 | `shared/lib/login-logger.ts`  | `services/notification/src/loggers/login-logger.ts`  | 登录尝试日志                 |
 | `shared/lib/change-logger.ts` | `services/notification/src/loggers/change-logger.ts` | 数据变更日志（监听领域事件） |
 | `shared/lib/audit-logger.ts`  | `services/notification/src/loggers/audit-logger.ts`  | 关键业务操作日志             |
@@ -420,12 +424,13 @@ gantt
 **复用方式**：三套工作流模式沿用（CI + 安全扫描 + 灾备演练），但执行方式改为多服务并行。
 
 | CICD 工作流    | Edu 工作流                      | 调整                                 |
-|------------|-----------|------|
+| -------------- | ------------------------------- | ------------------------------------ |
 | `ci.yml`       | `.gitea/workflows/ci.yml`       | 单体改为矩阵并行（每个服务一个 job） |
 | `security.yml` | `.gitea/workflows/security.yml` | 新增 Trivy 扫描 Docker 镜像          |
 | `dr-drill.yml` | `.gitea/workflows/dr-drill.yml` | 灾备演练改为多服务恢复顺序演练       |
 
 **CI 必须包含**（沿用 CICD 规则）：
+
 1. 安装依赖（多语言：pnpm install / go mod download / uv sync）
 2. Lint 检查（ESLint + golangci-lint + ruff）
 3. 类型检查（tsc --noEmit + go vet + mypy）
@@ -479,7 +484,7 @@ gantt
 ## 附录：迁移过程中的关键决策点
 
 | 决策点       | 选择                           | 理由                                             |
-|--------|------|------|
+| ------------ | ------------------------------ | ------------------------------------------------ |
 | 服务拆分粒度 | 6 业务 + 2 基础设施            | 平衡团队规模与拆分收益，避免过细导致 RPC 开销    |
 | 通信协议     | gRPC（内部）+ REST（BFF 对外） | 内部高性能，外部兼容性                           |
 | 事件总线     | Kafka + Debezium CDC           | CDC 减少业务代码侵入，Outbox 模式保证一致性      |

README.md

@@ -39,7 +39,7 @@ pnpm dev
 - [UI 设计系统](docs/standards/ui-design-system.md)
 - [Git 工作流](docs/standards/git-workflow.md)
 - [已知问题](docs/troubleshooting/known-issues.md)
-- [项目规则](project_rules.md)
+- [项目规则](.trae/rules/project_rules.md)
 - [迁移指南](MIGRATION_GUIDE.md)
 
 ## 开发阶段

apps/teacher-portal/next-env.d.ts

@@ -1,2 +1,5 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/building-your-application/configuring/typescript for more information.

apps/teacher-portal/tsconfig.json

@@ -2,16 +2,35 @@
   "extends": "../../tsconfig.base.json",
   "compilerOptions": {
     "target": "ES2022",
-    "lib": ["DOM", "DOM.Iterable", "ES2022"],
+    "lib": [
+      "DOM",
+      "DOM.Iterable",
+      "ES2022"
+    ],
     "module": "ESNext",
     "moduleResolution": "Bundler",
     "jsx": "preserve",
     "allowJs": true,
     "noEmit": true,
     "incremental": true,
-    "plugins": [{ "name": "next" }],
-    "paths": { "@/*": ["./src/*"] }
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": [
+        "./src/*"
+      ]
     },
-  "include": ["next-env.d.ts", "src/**/*", ".next/types/**/*.ts"],
-  "exclude": ["node_modules"]
+    "isolatedModules": true
+  },
+  "include": [
+    "next-env.d.ts",
+    "src/**/*",
+    ".next/types/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
 }

docs/architecture/004_architecture_impact_map.md

@@ -5,8 +5,9 @@
 > 状态：基线发布
 > 适用范围：Edu 微服务架构（DDD + EDA + CQRS）
 > 关联文档：
+>
 > - [理想蓝图](./0010_architecture.md)
-> - [项目规则](../../project_rules.md)
+> - [项目规则](../../.trae/rules/project_rules.md)
 > - [路线图](./roadmap/README.md)
 
 ---
@@ -32,22 +33,25 @@
 
 ## 1. 项目概述
 
-### 1.1 系统边界
+### 1.1a 技术分层视角（系统边界）
+
+> 本图展示**部署分层结构**（自上而下：用户 → 微前端 → 网关 → BFF → 业务服务 → 总线 → 数据）。
+> 用户层按"使用场景域"标注，BFF 层按场景域分（不是按角色分）。业务领域视角见 [1.1b](#11b-业务领域视角)。
 
 ```mermaid
 graph TB
-    subgraph Users["用户层"]
-        Teacher[教师]
-        Student[学生]
-        Parent[家长]
-        Admin[管理员]
+    subgraph Users["用户层（场景域用户）"]
+        Teacher["教学场景域用户<br/>（教师 / 教导主任 / 教研组长 共用）"]
+        Student["学习场景域用户<br/>（学生）"]
+        Parent["家长场景域用户<br/>（家长）"]
+        Admin["管理场景域用户<br/>（系统管理员 / 校管理员）"]
     end
 
     subgraph MFE["微前端层（Module Federation）"]
-        TeacherPortal[teacher-portal]
-        StudentPortal[student-portal]
-        ParentPortal[parent-portal]
-        AdminPortal[admin-portal]
+        TeacherPortal["teacher-portal<br/>教学场景域前端"]
+        StudentPortal["student-portal<br/>学习场景域前端"]
+        ParentPortal["parent-portal<br/>家长场景域前端"]
+        AdminPortal["admin-portal<br/>管理场景域前端"]
     end
 
     subgraph Gateway["网关层（Go）"]
@@ -55,10 +59,10 @@ graph TB
         PushGateway[push-gateway<br/>WebSocket/SSE]
     end
 
-    subgraph BFF["BFF 聚合层（NestJS）"]
-        TeacherBFF[teacher-bff<br/>GraphQL]
-        StudentBFF[student-bff<br/>GraphQL]
-        ParentBFF[parent-bff<br/>GraphQL]
+    subgraph BFF["BFF 聚合层（NestJS）<br/>按使用场景域分 BFF（不是按角色分）"]
+        TeacherBFF["teacher-bff<br/>教学场景域聚合"]
+        StudentBFF["student-bff<br/>学习场景域聚合"]
+        ParentBFF["parent-bff<br/>家长场景域聚合"]
     end
 
     subgraph Services["业务微服务（NestJS + FastAPI）"]
@@ -128,34 +132,90 @@ graph TB
     CoreEdu --> Redis
 ```
 
+### 1.1b 业务领域视角
+
+> 本图按 **DDD 限界上下文**展示 6 个业务领域及其依赖关系。同一服务可横跨多个领域（如 core-edu 同时承载"教学组织"与"教学核心"）。
+> 技术分层视角见 [1.1a](#11a-技术分层视角系统边界)。
+
+```mermaid
+graph TB
+    subgraph D1["D1 身份认证领域"]
+        IAM[iam 服务]
+        IAM_M[users / roles / permissions<br/>refresh_tokens / sessions]
+    end
+
+    subgraph D2["D2 教学组织领域"]
+        ORG[core-edu 服务<br/>classes 模块]
+        ORG_M[classes / subjects / enrollment]
+    end
+
+    subgraph D3["D3 教学核心领域"]
+        TEACH[core-edu 服务<br/>exams/homework/grades]
+        TEACH_M[exams / homework / grades<br/>courses / lessons / schedule / attendance]
+    end
+
+    subgraph D4["D4 内容资源领域"]
+        CONTENT[content 服务]
+        CONTENT_M[textbooks / knowledge-points<br/>questions / grading / search(ES)]
+    end
+
+    subgraph D5["D5 沟通通知领域"]
+        MSG[msg 服务]
+        MSG_M[messaging / notifications / announcements]
+    end
+
+    subgraph D6["D6 智能洞察领域"]
+        DATA[data-ana 服务]
+        AI[ai 服务]
+        DATA_M[analytics / dashboard / diagnostic(ClickHouse)]
+        AI_M[ai 备课/出题/分析 / search]
+    end
+
+    D1 --> D2
+    D1 --> D3
+    D1 --> D4
+    D1 --> D5
+    D2 --> D3
+    D3 --> D4
+    D3 --> D5
+    D4 --> D6
+    D3 --> D6
+```
+
+**双图并存说明**：
+
+- **1.1a 技术分层**：描述部署、流量路径、网络边界，关注"如何部署与调用"
+- **1.1b 业务领域**：描述 DDD 限界上下文、聚合根、领域依赖，关注"业务边界与归属"
+- 两图互补，分别服务于运维/SRE 与产品/架构视角
+
 ### 1.2 服务清单
 
-| 类别 | 服务名 | 语言/框架 | 限界上下文 | 阶段 |
-|------|--------|-----------|-----------|------|
-| 基础设施 | api-gateway | Go (Gin) | 网关 | P1 |
-| 基础设施 | push-gateway | Go (Gin) | 推送 | P5 |
-| BFF | teacher-bff | TS (NestJS) | 教师聚合 | P2 |
-| BFF | student-bff | TS (NestJS) | 学生聚合 | P3 |
-| BFF | parent-bff | TS (NestJS) | 家长聚合 | P4 |
-| 业务 | iam | TS (NestJS) | 身份认证 | P2 |
-| 业务 | core-edu | TS (NestJS) | 教学核心 | P3 |
-| 业务 | content | TS (NestJS) | 内容资源 | P4 |
-| 业务 | data-ana | Python (FastAPI) | 数据分析 | P4 |
-| 业务 | msg | TS (NestJS) | 消息通知 | P5 |
-| 业务 | ai | Python (FastAPI) | AI 网关 | P5 |
-| 微前端 | teacher-portal | TS (Next.js) | 教师端 | P2 |
-| 微前端 | student-portal | TS (Next.js) | 学生端 | P3 |
-| 微前端 | parent-portal | TS (Next.js) | 家长端 | P4 |
-| 微前端 | admin-portal | TS (Next.js) | 管理端 | P6 |
-| 共享包 | shared-proto | TS | protobuf 契约 | P1 |
-| 共享包 | shared-ts | TS | TS 共享工具 | P1 |
-| 共享包 | shared-go | Go | Go 共享工具 | P1 |
-| 共享包 | shared-py | Python | Python 共享工具 | P4 |
+| 类别     | 服务名         | 语言/框架        | 限界上下文      | 业务领域                      | 阶段 |
+| -------- | -------------- | ---------------- | --------------- | ----------------------------- | ---- |
+| 基础设施 | api-gateway    | Go (Gin)         | 网关            | —                             | P1   |
+| 基础设施 | push-gateway   | Go (Gin)         | 推送            | —                             | P5   |
+| BFF      | teacher-bff    | TS (NestJS)      | 教师聚合        | 教学场景域                    | P2   |
+| BFF      | student-bff    | TS (NestJS)      | 学生聚合        | 学习场景域                    | P3   |
+| BFF      | parent-bff     | TS (NestJS)      | 家长聚合        | 家长场景域                    | P4   |
+| 业务     | iam            | TS (NestJS)      | 身份认证        | **D1 身份认证**               | P2   |
+| 业务     | core-edu       | TS (NestJS)      | 教学核心        | **D2 教学组织 + D3 教学核心** | P3   |
+| 业务     | content        | TS (NestJS)      | 内容资源        | **D4 内容资源**               | P4   |
+| 业务     | data-ana       | Python (FastAPI) | 数据分析        | **D6 智能洞察**               | P4   |
+| 业务     | msg            | TS (NestJS)      | 消息通知        | **D5 沟通通知**               | P5   |
+| 业务     | ai             | Python (FastAPI) | AI 网关         | **D6 智能洞察**               | P5   |
+| 微前端   | teacher-portal | TS (Next.js)     | 教师端          | 教学场景域                    | P2   |
+| 微前端   | student-portal | TS (Next.js)     | 学生端          | 学习场景域                    | P3   |
+| 微前端   | parent-portal  | TS (Next.js)     | 家长端          | 家长场景域                    | P4   |
+| 微前端   | admin-portal   | TS (Next.js)     | 管理端          | 管理场景域                    | P6   |
+| 共享包   | shared-proto   | TS               | protobuf 契约   | —                             | P1   |
+| 共享包   | shared-ts      | TS               | TS 共享工具     | —                             | P1   |
+| 共享包   | shared-go      | Go               | Go 共享工具     | —                             | P1   |
+| 共享包   | shared-py      | Python           | Python 共享工具 | —                             | P4   |
 
 ### 1.3 CICD → Edu 模块映射
 
 | CICD 模块（旧）                           | Edu 服务（新） | 迁移阶段 |
-|----------------|---------------|----------|
+| ----------------------------------------- | -------------- | -------- |
 | auth + users + rbac                       | iam            | P2       |
 | classes + subjects + enrollment           | core-edu       | P3       |
 | courses + lessons + schedule + attendance | core-edu       | P3       |
@@ -174,7 +234,7 @@ graph TB
 ### 2.1 多语言技术栈矩阵
 
 | 层级     | 语言            | 框架                           | 用途                       |
-|------|------|------|------|
+| -------- | --------------- | ------------------------------ | -------------------------- |
 | 网关层   | Go 1.22+        | Gin                            | API Gateway、Push Gateway  |
 | 业务服务 | TypeScript 5.5+ | NestJS 10                      | IAM、CoreEdu、Content、Msg |
 | 分析/AI  | Python 3.12+    | FastAPI                        | DataAna、AI 网关           |
@@ -185,7 +245,7 @@ graph TB
 ### 2.2 多存储矩阵
 
 | 存储          | 用途                     | 使用服务                   |
-|------|------|----------|
+| ------------- | ------------------------ | -------------------------- |
 | MySQL 8       | 写模型主库（每服务独占） | IAM、CoreEdu、Content、Msg |
 | Redis 7       | 缓存、会话、限流计数     | 全部服务                   |
 | ClickHouse    | 读模型宽表、分析聚合     | DataAna、CoreEdu（读模型） |
@@ -195,7 +255,7 @@ graph TB
 ### 2.3 基础设施矩阵
 
 | 组件          | 用途                                |
-|------|------|
+| ------------- | ----------------------------------- |
 | Kafka         | 事件总线，领域事件异步通信          |
 | Debezium      | CDC，MySQL Binlog → Kafka 实时同步  |
 | Temporal      | 工作流编排（考试生命周期、AI 编排） |
@@ -260,6 +320,7 @@ L1 客户端 → L2 微前端 → L3 网关 → L4 BFF → L5 业务服务 → L
 ```
 
 **严格规则**：
+
 1. L3 网关层只做路由、鉴权、限流、熔断，**不写业务逻辑**
 2. L4 BFF 层只做聚合、裁剪、协议转换，**不持有业务状态**
 3. L5 业务服务之间通过 gRPC（同步）或 Kafka 事件（异步）通信，**不直接访问对方数据库**
@@ -340,7 +401,7 @@ graph TB
 ### 4.1 服务间通信矩阵
 
 | 调用方 → 被调用方  | 协议       | 场景             |
-|-------------------|------|------|
+| ------------------ | ---------- | ---------------- |
 | api-gateway → BFF  | gRPC       | 请求路由         |
 | BFF → 业务服务     | gRPC       | 同步查询聚合     |
 | CoreEdu → Content  | Kafka 事件 | 教学内容变更通知 |
@@ -390,7 +451,7 @@ sequenceDiagram
 ### 5.2 三层角色模型
 
 | 层级     | 来源          | 示例                            | 优先级 |
-|------|------|------|--------|
+| -------- | ------------- | ------------------------------- | ------ |
 | 系统角色 | 系统预设      | admin、teacher、student、parent | 最高   |
 | 组织角色 | 学校/班级分配 | 年级组长、班主任、学科组长      | 中     |
 | 临时角色 | 临时授权      | 代课教师、临时代理              | 最低   |
@@ -400,7 +461,7 @@ sequenceDiagram
 ### 5.3 DataScope 6 级数据范围
 
 | 级别 | 名称     | 数据范围   | 典型角色     |
-|------|------|----------|----------|
+| ---- | -------- | ---------- | ------------ |
 | L0   | SELF     | 仅本人数据 | 学生、家长   |
 | L1   | CLASS    | 本班数据   | 班主任、学生 |
 | L2   | GRADE    | 本年级数据 | 年级组长     |
@@ -410,6 +471,40 @@ sequenceDiagram
 
 **实现**：业务服务在 Repository 层根据 dataScope 级别动态注入 WHERE 条件。
 
+### 5.4 视口四层模型
+
+视口（Viewport）是用户在特定场景域下的可见范围。视口既可独立配置（RoleViewport 表），
+也可由权限推导（permission → viewport 默认映射）。新角色只需配置权限集，视口自动推导；
+需要差异化时再显式配置视口。
+
+| 层级    | 含义             | 配置载体                           | 示例                                         |
+| ------- | ---------------- | ---------------------------------- | -------------------------------------------- |
+| L1 导航 | 侧边栏菜单项     | navigation_config 表               | 教导主任看到"全校成绩分析"菜单               |
+| L2 路由 | 可访问路由       | route_permission 表 + Gateway 校验 | 教导主任可访问 /admin/grade-analysis         |
+| L3 组件 | 页面内组件可见性 | usePermission().hasPermission()    | 教导主任看到"导出全校报表"按钮               |
+| L4 数据 | 数据行级过滤     | DataScope 枚举                     | 教导主任 DataScope=grade_managed（管辖年级） |
+
+**场景域 BFF 复用策略**：
+
+按"使用场景域"分 BFF，而非按角色分。新角色复用现有 BFF，通过视口差异化。
+
+| BFF         | 场景域   | 复用角色                 |
+| ----------- | -------- | ------------------------ |
+| Teacher BFF | 教学场景 | 教师、教导主任、教研组长 |
+| Student BFF | 学习场景 | 学生                     |
+| Parent BFF  | 家长场景 | 家长                     |
+| Admin BFF   | 管理场景 | 系统管理员、校管理员     |
+
+**实现**：教导主任归入 Teacher BFF + 额外管理视口（L1 导航增加管理菜单项，L4 数据范围扩大到年级）。
+
+**iam 服务职责**：
+
+- 认证：登录/登出/JWT/2FA
+- RBAC：角色/权限/角色-权限映射 CRUD
+- 视口配置：导航/路由/组件级视口配置 CRUD
+- DataScope：数据范围解析（all/grade_managed/class_taught/children/owned + 自定义）
+- 权限解析 API：getEffectivePermissions(userId) → {permissions, viewports, dataScope}
+
 ---
 
 ## 6. 数据访问与缓存
@@ -462,7 +557,7 @@ flowchart TD
 ### 6.3 缓存策略矩阵
 
 | 数据类型      | 存储       | TTL     | 失效策略     |
-|----------|------|-----|----------|
+| ------------- | ---------- | ------- | ------------ |
 | 用户会话      | Redis      | 30 分钟 | 滑动过期     |
 | 权限列表      | Redis      | 5 分钟  | 事件驱动失效 |
 | 班级/年级列表 | Redis      | 5 分钟  | 事件驱动失效 |
@@ -521,7 +616,7 @@ graph LR
 ### 7.2 事件 Topic 分类
 
 | Topic 模式                          | 示例       | 生产者  | 消费者       |
-|-----------|------|--------|--------|
+| ----------------------------------- | ---------- | ------- | ------------ |
 | `edu.identity.user.created`         | 用户创建   | IAM     | CoreEdu、Msg |
 | `edu.identity.user.updated`         | 用户更新   | IAM     | CoreEdu、Msg |
 | `edu.org.class.created`             | 班级创建   | CoreEdu | DataAna      |
@@ -534,7 +629,7 @@ graph LR
 ### 7.3 核心领域事件
 
 | 事件                  | 触发场景       | 消费者动作                                       |
-|------|----------|-----------|
+| --------------------- | -------------- | ------------------------------------------------ |
 | UserRegistered        | 新用户注册     | CoreEdu 初始化默认班级关联；Msg 发送欢迎通知     |
 | ExamPublished         | 考试发布       | Msg 推送考试通知给学生；DataAna 创建考试分析骨架 |
 | HomeworkSubmitted     | 学生提交作业   | DataAna 记录提交行为；Msg 通知教师               |
@@ -768,6 +863,7 @@ flowchart LR
 ```
 
 **规则**：
+
 - 所有跨服务调用必须透传 W3C Trace Context
 - Kafka 事件必须将 traceId 写入消息 header
 - 日志必须包含 traceId 用于关联查询
@@ -822,7 +918,7 @@ graph TB
 ### 11.2 契约规则
 
 | 规则     | 说明                                   |
-|------|------|
+| -------- | -------------------------------------- |
 | 包命名   | `edu.[context].[aggregate].v[version]` |
 | 版本化   | 破坏性变更必须升版本（v1 → v2）        |
 | 字段编号 | 禁止复用已删除字段编号，使用 reserved  |
@@ -866,7 +962,7 @@ graph LR
 ### 12.1 服务独立性约束
 
 | 约束        | 说明                                   |
-|------|------|
+| ----------- | -------------------------------------- |
 | 数据库独占  | 每个微服务独占自身数据库，禁止跨库联表 |
 | 契约先行    | 所有跨服务通信必须先定义 protobuf 契约 |
 | Outbox 强制 | 所有领域事件必须通过 Outbox 模式发布   |
@@ -877,7 +973,7 @@ graph LR
 ### 12.2 通信约束
 
 | 场景                 | 允许             | 禁止                |
-|------|------|------|
+| -------------------- | ---------------- | ------------------- |
 | 客户端 → Gateway     | REST + WebSocket | 直连业务服务        |
 | Gateway → BFF        | gRPC             | REST                |
 | BFF → 业务服务       | gRPC             | 直接访问 DB         |
@@ -888,7 +984,7 @@ graph LR
 ### 12.3 数据一致性约束
 
 | 场景   | 一致性级别 | 实现                  |
-|------|-----------|------|
+| ------ | ---------- | --------------------- |
 | 聚合内 | 强一致     | 单事务                |
 | 聚合间 | 最终一致   | Kafka 事件            |
 | 服务间 | 最终一致   | Kafka 事件 / Saga     |
@@ -900,7 +996,7 @@ graph LR
 ## 13. ADR 记录
 
 | 编号    | 决策                          | 原因                              | 状态   |
-|------|------|------|------|
+| ------- | ----------------------------- | --------------------------------- | ------ |
 | ADR-001 | 采用 DDD 限界上下文划分服务   | 业务边界清晰，独立演进            | 已采纳 |
 | ADR-002 | 采用 NestJS 作为业务服务框架  | TS 生态成熟，装饰器 + DI 适合 DDD | 已采纳 |
 | ADR-003 | 采用 Go 作为网关语言          | 高并发、低内存、适合网关场景      | 已采纳 |
@@ -934,7 +1030,7 @@ graph LR
 ### 14.2 服务与阶段映射
 
 | 阶段        | 周期    | 交付服务                                              | 退出标准                       |
-|------|------|----------|----------|
+| ----------- | ------- | ----------------------------------------------------- | ------------------------------ |
 | P1 地基     | M1-M3   | api-gateway、classes（黄金模板）、shared-proto        | classes 域 CRUD 端到端跑通     |
 | P2 身份     | M4-M6   | iam、teacher-bff、teacher-portal 骨架                 | 教师可登录并看到空白 Dashboard |
 | P3 核心教学 | M7-M10  | core-edu（合并 classes）、student-bff、student-portal | 考试→作答→批改→成绩全链路      |

docs/standards/coding-standards.md

@@ -5,7 +5,8 @@
 > 状态：基线发布
 > 适用范围：Edu 微服务架构（TS + Go + Python + protobuf）
 > 关联文档：
-> - [项目规则](../../project_rules.md)
+>
+> - [项目规则](../../.trae/rules/project_rules.md)
 > - [迁移指南](../../MIGRATION_GUIDE.md)
 > - [Git 工作流](./git-workflow.md)
 > - [架构总览](../architecture/001_architecture_overview.md)
@@ -85,7 +86,7 @@ import type { UserEntity } from "@/modules/user/domain/user.entity";
 
 #### 2.4.1 模块组织
 
-每个 NestJS 模块对应一个 DDD 聚合，结构见 [project_rules.md §4.1](../../project_rules.md#41-nestjs-业务微服务标准结构)。
+每个 NestJS 模块对应一个 DDD 聚合，结构见 [project_rules.md §3.3](../../.trae/rules/project_rules.md#33-模块标准结构ddd)。
 
 #### 2.4.2 装饰器规则
 
@@ -111,6 +112,7 @@ export class UserController {
 ```
 
 **规则**：
+
 - Controller 必须使用 `@Controller(path)` 装饰器，path 使用 kebab-case 复数
 - Controller 类必须使用 `@RequirePermission()` 装饰器（类级默认权限）
 - 每个 Handler 可选覆盖类级权限（更细粒度）
@@ -131,6 +133,7 @@ export class UserService {
 ```
 
 **规则**：
+
 - 依赖通过构造函数注入，使用 `readonly` 修饰符
 - 接口绑定在 Module 的 `providers` 中：`{ provide: "UserRepository", useClass: UserRepoImpl }`
 - 禁止使用属性注入（`@Inject()` 属性装饰器）
@@ -152,6 +155,7 @@ export class UserModule {}
 ```
 
 **规则**：
+
 - Module 类名 PascalCase + `Module` 后缀
 - `exports` 仅暴露 Application Service，不暴露 Repository
 - 跨 Module 通信通过 exports 的 Service，不直接访问对方 Repository
@@ -190,6 +194,7 @@ export class GetUserByIdHandler implements IQueryHandler<GetUserByIdQuery> {
 ```
 
 **规则**：
+
 - Command 走写路径：Command → Handler → Domain → Repository → MySQL + Outbox
 - Query 走读路径：Query → Handler → Read Model（禁止查主库）
 - Command Handler 必须在事务内写 Outbox 表
@@ -207,7 +212,12 @@ export class UserEntity {
   ) {}
 
   static create(props: UserCreateProps): UserEntity {
-    return new UserEntity(crypto.randomUUID(), props.email, props.name, new Date());
+    return new UserEntity(
+      crypto.randomUUID(),
+      props.email,
+      props.name,
+      new Date(),
+    );
   }
 
   rename(newName: string): UserRenamedEvent {
@@ -218,6 +228,7 @@ export class UserEntity {
 ```
 
 **规则**：
+
 - Entity 构造函数私有，通过静态工厂方法创建
 - Entity 字段私有，通过方法变更状态
 - 状态变更方法返回领域事件，由 Application Service 发布
@@ -239,6 +250,7 @@ export class CreateUserDto {
 ```
 
 **规则**：
+
 - DTO 类名 `Create[Entity]Dto` / `Update[Entity]Dto` / `[Entity]Response`
 - DTO 字段使用 `readonly` 修饰
 - 使用 `class-validator` 装饰器校验
@@ -265,7 +277,7 @@ export class CreateUserDto {
 ### 2.10 状态管理（沿用 CICD 5 层模型）
 
 | 层级               | 场景                 | 方案                          |
-|------|------|------|
+| ------------------ | -------------------- | ----------------------------- |
 | L1 URL             | 可分享、可刷新的状态 | nuqs                          |
 | L2 Server          | 服务端数据           | TanStack Query                |
 | L3 Client Business | 客户端业务状态       | Zustand slice                 |
@@ -328,6 +340,7 @@ user, _ := h.userService.GetUser(ctx, id)
 ```
 
 **规则**：
+
 - 错误必须显式处理，**禁止 `_ = err`**
 - 使用 `errors.Is` 和 `errors.As` 判断错误类型，禁止字符串匹配
 - 自定义错误类型使用 `fmt.Errorf("...: %w", err)` 包装
@@ -349,6 +362,7 @@ type UserService struct {
 ```
 
 **规则**：
+
 - `context.Context` 作为函数第一个参数传递
 - **禁止**将 context 存储在结构体字段中
 - 超时/取消通过 context 传递，禁止使用 `time.Sleep` 等待
@@ -368,6 +382,7 @@ if err := g.Wait(); err != nil {
 ```
 
 **规则**：
+
 - 优先使用 `errgroup` 管理并发 goroutine
 - 禁止裸 `go func()` 不带 recover 和 context
 - 共享状态使用 channel 或 `sync` 包，禁止使用 `sync.Mutex` 嵌套锁
@@ -388,6 +403,7 @@ func RegisterRoutes(r *gin.Engine, h *Handler, mw *Middleware) {
 ```
 
 **规则**：
+
 - 路由分组按 API 版本（`/api/v1`）
 - 中间件链顺序：Recovery → RequestID → Logger → RateLimit → Auth → RequirePermission
 - Handler 函数签名固定：`func(c *gin.Context)`
@@ -404,6 +420,7 @@ logger.Info("user login", "user_id", userID, "ip", ip)
 ```
 
 **规则**：
+
 - 使用标准库 `log/slog` 结构化日志
 - 日志字段使用 kebab-case key
 - 必须包含 `request_id` 用于链路追踪
@@ -459,6 +476,7 @@ def get_user(user_id):
 ```
 
 **规则**：
+
 - 所有函数必须标注参数和返回值类型
 - 使用 `from __future__ import annotations` 启用延迟注解求值
 - 使用 `Optional[T]` 或 `T | None`（Python 3.10+）标注可选类型
@@ -480,6 +498,7 @@ async def fetch_user(user_id: str) -> User:
 ```
 
 **规则**：
+
 - I/O 操作（HTTP、DB、文件）必须使用 async/await
 - 禁止在 async 函数中调用同步阻塞 I/O，必须用 `asyncio.to_thread` 或 async 客户端
 - CPU 密集任务用 `asyncio.to_thread` 或进程池
@@ -509,6 +528,7 @@ class UserResponse(BaseModel):
 ```
 
 **规则**：
+
 - 请求模型命名 `[Action][Entity]Request`，响应模型命名 `[Entity]Response`
 - 必须使用 `Field` 添加描述、约束
 - 复杂校验使用 `@field_validator` 或 `@model_validator`
@@ -534,6 +554,7 @@ async def get_user(
 ```
 
 **规则**：
+
 - 路由分组使用 `APIRouter`，按 API 版本组织
 - 必须标注 `response_model`
 - 权限校验通过 `Depends` 注入，每个 endpoint 显式调用 `require_permission`
@@ -557,6 +578,7 @@ settings = Settings()
 ```
 
 **规则**：
+
 - 配置使用 `pydantic-settings` 的 `BaseSettings`
 - 环境变量前缀按服务名（`INSIGHT_AI_`）
 - 禁止在业务代码中直接读取环境变量（`os.getenv`），统一通过 `settings`
@@ -568,7 +590,7 @@ settings = Settings()
 ### 5.1 命名通用规则
 
 | 对象             | 风格                     | 示例                                      |
-|------|------|------|
+| ---------------- | ------------------------ | ----------------------------------------- |
 | 目录             | kebab-case               | `user-profile/`                           |
 | 常量             | UPPER_SNAKE_CASE         | `MAX_RETRY_COUNT`                         |
 | 布尔值           | `is/has/can/should` 前缀 | `isVisible`、`is_active`、`hasPermission` |
@@ -581,7 +603,7 @@ settings = Settings()
 ### 5.2 文件行数通用规则
 
 | 文件类型                  | 建议行数 | 硬性上限               |
-|---------|---------|---------|
+| ------------------------- | -------- | ---------------------- |
 | 配置/常量/类型/proto      | 无限制   | 无限制                 |
 | React 组件                | ≤ 500    | 800                    |
 | NestJS Controller/Service | ≤ 500    | 800                    |
@@ -594,12 +616,13 @@ settings = Settings()
 ### 5.3 错误处理通用规则
 
 | 语言       | 规则                                                           |
-|------|------|
+| ---------- | -------------------------------------------------------------- |
 | TypeScript | 错误通过抛出异常，Application Service 必须捕获并转为结构化响应 |
 | Go         | 错误必须显式处理，禁止 `_ = err`，使用 `errors.Is/As` 判断类型 |
 | Python     | 使用异常层次结构，自定义异常继承 `Exception`，禁止裸 `except:` |
 
 **通用规则**：
+
 - 错误信息对内详细（含上下文、堆栈），对外脱敏（不泄露实现细节）
 - 错误必须分类：业务错误（4xx）、系统错误（5xx）、依赖错误（502/503）
 - 错误必须记录日志，包含 request_id 用于链路追踪
@@ -608,12 +631,13 @@ settings = Settings()
 ### 5.4 日志通用规则
 
 | 语言       | 工具                 | 说明             |
-|------|------|------|
+| ---------- | -------------------- | ---------------- |
 | TypeScript | NestJS Logger + pino | 结构化 JSON 日志 |
 | Go         | log/slog             | 标准库结构化日志 |
 | Python     | structlog 或 loguru  | 结构化 JSON 日志 |
 
 **通用规则**：
+
 - 日志必须结构化（JSON），禁止纯文本
 - 必须包含 `timestamp`、`level`、`service`、`request_id`、`trace_id`
 - 日志级别：DEBUG（开发）、INFO（关键业务）、WARN（异常可恢复）、ERROR（系统错误）
@@ -623,12 +647,13 @@ settings = Settings()
 ### 5.5 测试通用规则
 
 | 语言       | 单元测试框架              | 覆盖率目标 |
-|------|------------|-----------|
+| ---------- | ------------------------- | ---------- |
 | TypeScript | Vitest + nestjs/testing   | ≥ 80%      |
 | Go         | 标准 testing 包 + testify | ≥ 80%      |
 | Python     | pytest + pytest-asyncio   | ≥ 80%      |
 
 **通用规则**：
+
 - 测试文件与源文件同目录或 `tests/` 子目录
 - 命名：`*.test.ts` / `*_test.go` / `test_*.py`
 - 测试描述说明预期行为（"should disable button while loading"）
@@ -714,6 +739,7 @@ enum UserStatus {
 ```
 
 **规则**：
+
 - 字段编号禁止复用，删除字段必须 `reserved` 标记
 - 枚举第一个值必须为 `*_UNSPECIFIED = 0`
 - 时间使用 `google.protobuf.Timestamp`，不使用 string
@@ -771,7 +797,7 @@ buf generate
 ### 7.1 令牌分层（沿用 CICD 模型，迁移至微前端共享包）
 
 | Layer             | 位置                                                          | 用途                                               |
-|-------|------|------|
+| ----------------- | ------------------------------------------------------------- | -------------------------------------------------- |
 | Layer 1 Primitive | `packages/ui-tokens/primitive.css`                            | 原始色板/字号/间距/阴影，业务代码不直接引用        |
 | Layer 2 Semantic  | `packages/ui-tokens/semantic-light.css` + `semantic-dark.css` | 语义令牌，业务代码唯一引用入口                     |
 | 模块命名空间      | `packages/ui-tokens/lesson-preparation.css`                   | `--lp-*` 令牌，明暗双份                            |
@@ -847,7 +873,7 @@ buf generate
 ### 8.6 依赖扫描
 
 | 语言   | 工具                       |
-|------|------|
+| ------ | -------------------------- |
 | TS     | `npm audit` + Snyk + Trivy |
 | Go     | `govulncheck`              |
 | Python | `pip-audit` + `safety`     |
@@ -874,7 +900,7 @@ buf generate
 ### 9.1 测试分层
 
 | 层级     | TS                      | Go                       | Python                  | 覆盖率       |
-|------|-----|-----|--------|--------|
+| -------- | ----------------------- | ------------------------ | ----------------------- | ------------ |
 | 单元测试 | Vitest                  | testing + testify        | pytest                  | ≥ 80%        |
 | 集成测试 | Vitest + Testcontainers | testing + Testcontainers | pytest + Testcontainers | 关键流程     |
 | E2E 测试 | Playwright              | -                        | -                       | 核心业务路径 |
@@ -966,7 +992,7 @@ pytest tests/integration -v
 ## 附录：与 CICD 单应用规范的差异
 
 | 项目         | CICD 单应用                       | Edu 微服务                                   | 原因           |
-|------|-----------|-----------|------|
+| ------------ | --------------------------------- | -------------------------------------------- | -------------- |
 | 项目结构     | 单 Next.js 应用                   | 多语言 monorepo                              | 微服务拆分     |
 | 数据获取层   | `modules/[module]/data-access.ts` | NestJS Repository + Domain Entity            | DDD 分层       |
 | 中间件       | `proxy.ts`（Next.js 16）          | Go Gin Gateway                               | 网关独立       |

docs/standards/git-workflow.md

@@ -1,11 +1,12 @@
 # Edu Git 工作流规范
 
-> 版本：1.0
-> 日期：2026-07-07
-> 状态：基线发布
+> 版本：1.1
+> 日期：2026-07-08
+> 状态：基线发布（v1.1：scope-enum 对齐 + CODEOWNERS）
 > 适用范围：Edu 多语言 monorepo（pnpm workspace + go.work + pyproject.toml）
 > 关联文档：
-> - [项目规则](../../project_rules.md)
+>
+> - [项目规则](../../.trae/rules/project_rules.md)
 > - [编码规范](./coding-standards.md)
 > - [迁移指南](../../MIGRATION_GUIDE.md)
 > - [架构总览](../architecture/001_architecture_overview.md)
@@ -33,6 +34,7 @@
 本项目采用**主干开发**模式，所有变更最终合并至 `main` 分支。
 
 **核心原则**：
+
 - `main` 分支始终保持可发布状态
 - 短生命周期特性分支（通常 ≤ 3 天）
 - 频繁集成，每天至少一次 rebase/merge 至最新 `main`
@@ -67,7 +69,7 @@ gitGraph
 ### 1.3 分支命名规范
 
 | 分支类型 | 前缀        | 示例                         | 生命周期   |
-|---------|------|------|---------|
+| -------- | ----------- | ---------------------------- | ---------- |
 | 主干     | `main`      | `main`                       | 永久       |
 | 特性     | `feat/`     | `feat/identity-service`      | ≤ 3 天     |
 | 修复     | `fix/`      | `fix/jwt-expiry`             | ≤ 1 天     |
@@ -78,6 +80,7 @@ gitGraph
 | 热修复   | `hotfix/`   | `hotfix/v0.3.1`              | ≤ 1 天     |
 
 **规则**：
+
 - 分支名使用 kebab-case
 - 一个分支只做一件事，禁止在一个分支内混合多个无关变更
 - 特性分支命名包含服务/模块名（`feat/identity-service` 而非 `feat/login`）
@@ -85,6 +88,7 @@ gitGraph
 ### 1.4 分支保护规则
 
 **`main` 分支保护**：
+
 - 禁止直接 push，必须通过 PR
 - 至少 1 名 Reviewer 审批通过（核心模块需 2 名）
 - 所有 CI 检查通过（lint + typecheck + test + build）
@@ -92,6 +96,7 @@ gitGraph
 - 禁止 force push
 
 **`release/*` 分支保护**：
+
 - 禁止直接 push，仅接受 cherry-pick 或特定 hotfix PR
 - 至少 2 名 Reviewer 审批
 - 发布完成后打 tag 并归档
@@ -115,7 +120,7 @@ gitGraph
 ### 2.2 类型（type）
 
 | 类型       | 含义                       | 是否触发发布 |
-|------|------|-------------|
+| ---------- | -------------------------- | ------------ |
 | `feat`     | 新功能                     | 是（MINOR）  |
 | `fix`      | Bug 修复                   | 是（PATCH）  |
 | `perf`     | 性能优化                   | 是（PATCH）  |
@@ -133,6 +138,7 @@ gitGraph
 scope 必须是服务名或包名，详见 [§3.3 scope-enum](#33-scope-enum-完整清单)。
 
 **示例**：
+
 - `feat(identity): 实现用户注册接口`
 - `fix(gateway): 修复路由匹配优先级`
 - `perf(teaching): 优化课表查询 N+1 问题`
@@ -141,6 +147,7 @@ scope 必须是服务名或包名，详见 [§3.3 scope-enum](#33-scope-enum-完
 ### 2.4 主题（subject）
 
 **规则**：
+
 - 使用中文简短描述
 - 不超过 50 个字符
 - 不以句号结尾
@@ -150,12 +157,14 @@ scope 必须是服务名或包名，详见 [§3.3 scope-enum](#33-scope-enum-完
 ### 2.5 正文（body）
 
 **规则**：
+
 - 解释"为什么"而非"做了什么"（代码已说明做了什么）
 - 每行不超过 72 个字符
 - 使用无序列表列出关键变更点
 - 涉及 breaking change 必须在正文开头说明
 
 **示例**：
+
 ```
 feat(teaching): 作业提交支持附件上传
 
@@ -195,7 +204,7 @@ pnpm exec husky init
 
 ### 3.2 commitlint 配置
 
-创建 `commitlint.config.cjs`：
+实际生效配置文件：仓库根 `.commitlintrc.js`（CommonJS）。
 
 ```javascript
 /** @type {import('@commitlint/types').UserConfig} */
@@ -224,46 +233,42 @@ module.exports = {
     "type-case": [2, "always", "lower-case"],
     // type 不能为空
     "type-empty": [2, "never"],
-    // scope 枚举（见 3.3）
+    // scope 枚举（见 3.3，与 .commitlintrc.js 保持同步）
     "scope-enum": [
       2,
       "always",
       [
-        // 业务微服务
-        "identity",
-        "org",
-        "teaching",
+        // 网关层（Go）
+        "api-gateway",
+        "push-gateway",
+        // 业务微服务（NestJS / FastAPI）
+        "iam",
+        "core-edu",
+        "classes",
         "content",
-        "comm",
-        "insight",
-        // 基础设施服务
-        "auth",
-        "notification",
-        // AI 服务
-        "insight-ai",
-        // 网关
-        "gateway",
-        // BFF
-        "admin-bff",
+        "data-ana",
+        "msg",
+        "ai",
+        // BFF 聚合层（NestJS）
         "teacher-bff",
         "student-bff",
-        // 微前端
-        "admin-shell",
-        "teacher-shell",
-        "student-shell",
-        "parent-shell",
-        // 共享包
-        "contracts",
-        "ui-tokens",
-        "ui-components",
+        "parent-bff",
+        // 微前端（Next.js）
+        "teacher-portal",
+        "student-portal",
+        "parent-portal",
+        "admin-portal",
+        // 共享包（packages/）
+        "shared-proto",
         "shared-ts",
-        // protobuf 契约
-        "proto",
-        // 平台级
-        "deps",
+        "shared-go",
+        "shared-py",
+        "shared-tokens",
+        // 工具与平台级
+        "arch-scan",
+        "infra",
         "docs",
-        "ci",
-        "chore",
+        "deps",
         "release",
       ],
     ],
@@ -285,100 +290,89 @@ module.exports = {
 };
 ```
 
+> **单一事实源**：实际生效的配置在仓库根 `.commitlintrc.js`，本节示例仅作说明。修改 scope 必须同步更新 `.commitlintrc.js` 与本节，并在 PR 中说明原因。
+
 ### 3.3 scope-enum 完整清单
 
-| 分类 | scope | 说明 |
-|------|-------|------|
-| 业务微服务 | `identity` | 身份与权限服务 |
-| 业务微服务 | `org` | 教学组织服务 |
-| 业务微服务 | `teaching` | 教学核心服务 |
-| 业务微服务 | `content` | 内容分析服务 |
-| 业务微服务 | `comm` | 沟通服务 |
-| 业务微服务 | `insight` | 智能洞察服务 |
-| 基础设施 | `auth` | 认证授权服务 |
-| 基础设施 | `notification` | 通知服务 |
-| AI 服务 | `insight-ai` | AI 分析服务（Python） |
-| 网关 | `gateway` | API 网关（Go） |
-| BFF | `admin-bff` | 管理端 BFF |
-| BFF | `teacher-bff` | 教师端 BFF |
-| BFF | `student-bff` | 学生/家长端 BFF |
-| 微前端 | `admin-shell` | 管理端 Shell |
-| 微前端 | `teacher-shell` | 教师端 Shell |
-| 微前端 | `student-shell` | 学生端 Shell |
-| 微前端 | `parent-shell` | 家长端 Shell |
-| 共享包 | `contracts` | protobuf 生成契约包 |
-| 共享包 | `ui-tokens` | 设计令牌包 |
-| 共享包 | `ui-components` | UI 组件库 |
-| 共享包 | `shared-ts` | TS 共享工具包 |
-| 契约 | `proto` | protobuf 定义文件 |
-| 平台级 | `deps` | 依赖升级 |
-| 平台级 | `docs` | 平台级文档 |
-| 平台级 | `ci` | CI/CD 配置 |
-| 平台级 | `chore` | 杂项 |
-| 平台级 | `release` | 发布相关 |
+> 与仓库根 `.commitlintrc.js` 保持同步；修改 scope 必须同时更新此处与 `.commitlintrc.js`。
+
+| 分类       | scope            | 对应目录                  | 说明                                                   |
+| ---------- | ---------------- | ------------------------- | ------------------------------------------------------ |
+| 网关层     | `api-gateway`    | `services/api-gateway/`   | API 网关（Go + Gin）                                   |
+| 网关层     | `push-gateway`   | `services/push-gateway/`  | WebSocket 推送网关（Go）                               |
+| 业务微服务 | `iam`            | `services/iam/`           | 身份与访问管理（NestJS）                               |
+| 业务微服务 | `core-edu`       | `services/core-edu/`      | 教学核心服务（NestJS，Outbox + Kafka）                 |
+| 业务微服务 | `classes`        | `services/classes/`       | 班级服务（P1 黄金模板，P3 并入 core-edu）              |
+| 业务微服务 | `content`        | `services/content/`       | 内容资源服务（NestJS + Neo4j）                         |
+| 业务微服务 | `data-ana`       | `services/data-ana/`      | 数据分析服务（Python + FastAPI + ClickHouse）          |
+| 业务微服务 | `msg`            | `services/msg/`           | 消息通知服务（NestJS + ES）                            |
+| 业务微服务 | `ai`             | `services/ai/`            | AI 网关服务（Python + FastAPI + LLM）                  |
+| BFF 聚合层 | `teacher-bff`    | `services/teacher-bff/`   | 教师端 BFF（NestJS）                                   |
+| BFF 聚合层 | `student-bff`    | `services/student-bff/`   | 学生端 BFF（待建立）                                   |
+| BFF 聚合层 | `parent-bff`     | `services/parent-bff/`    | 家长端 BFF（待建立）                                   |
+| 微前端     | `teacher-portal` | `apps/teacher-portal/`    | 教师端 Portal（Next.js）                               |
+| 微前端     | `student-portal` | `apps/student-portal/`    | 学生端 Portal（待建立）                                |
+| 微前端     | `parent-portal`  | `apps/parent-portal/`     | 家长端 Portal（待建立）                                |
+| 微前端     | `admin-portal`   | `apps/admin-portal/`      | 管理端 Portal（待建立）                                |
+| 共享包     | `shared-proto`   | `packages/shared-proto/`  | protobuf 契约定义                                      |
+| 共享包     | `shared-ts`      | `packages/shared-ts/`     | TS 共享类型与工具（待建立）                            |
+| 共享包     | `shared-go`      | `packages/shared-go/`     | Go 共享工具（待建立）                                  |
+| 共享包     | `shared-py`      | `packages/shared-py/`     | Python 共享工具（待建立）                              |
+| 共享包     | `shared-tokens`  | `packages/shared-tokens/` | 设计令牌（待建立）                                     |
+| 工具       | `arch-scan`      | `scripts/arch-scan/`      | 架构元数据库扫描器                                     |
+| 平台级     | `infra`          | `infra/`                  | 基础设施（K8s / docker-compose / backup / monitoring） |
+| 平台级     | `docs`           | `docs/`                   | 平台级文档（跨多模块）                                 |
+| 平台级     | `deps`           | -                         | 依赖升级                                               |
+| 平台级     | `release`        | -                         | 发布相关                                               |
+
+> `chore` / `ci` / `build` 等 Conventional Commits 标准 type 不需要 scope，可直接使用 `chore: xxx`、`ci: xxx`。
 
 ### 3.4 husky hooks
 
+实际生效的 hook 文件在仓库根 `.husky/` 目录。使用 `npx --no-install` 确保使用本地依赖。
+
 `.husky/commit-msg`：
 
 ```bash
-#!/usr/bin/env sh
-pnpm exec commitlint --edit "$1"
+npx --no-install commitlint --edit $1
 ```
 
 `.husky/pre-commit`：
 
 ```bash
-#!/usr/bin/env sh
-pnpm exec lint-staged
+npx --no-install lint-staged
 ```
 
-`.husky/pre-push`：
+`.husky/pre-push`（推送前类型检查，TS 服务 typecheck 通过后才允许推送）：
 
 ```bash
 #!/usr/bin/env sh
-# 推送前运行类型检查
-pnpm -r run typecheck
+# 推送前运行类型检查（TS 服务）
+pnpm -r run typecheck 2>/dev/null || echo "[pre-push] typecheck 跳过或不可用"
+# Go 服务编译检查
+for d in services/api-gateway services/push-gateway; do
+  if [ -d "$d" ]; then (cd "$d" && go build ./... ) || exit 1; fi
+done
 ```
 
+> **注意**：`pre-push` 中的 typecheck 在 TS 服务 ESLint 9 flat config 迁移完成前为可选（当前 `pnpm -r run typecheck` 缺失脚本，会 fallback 到 echo 提示）。Go `go build` 检查必须通过。
+
 ### 3.5 lint-staged 配置
 
-`package.json`（根目录）：
+实际生效配置文件：仓库根 `lint-staged.config.js`（CommonJS）。
 
-```json
-{
-  "lint-staged": {
-    // TypeScript / NestJS / Next.js
-    "*.{ts,tsx}": [
-      "eslint --fix",
-      "prettier --write"
-    ],
-    // Go
-    "*.go": [
-      "gofmt -w",
-      "golangci-lint run --fix"
-    ],
-    // Python
-    "*.py": [
-      "ruff check --fix",
-      "ruff format"
-    ],
-    // protobuf
-    "*.proto": [
-      "buf format --write"
-    ],
-    // Markdown
-    "*.md": [
-      "prettier --write"
-    ],
-    // JSON / YAML
-    "*.{json,yaml,yml}": [
-      "prettier --write"
-    ]
-  }
-}
+```javascript
+module.exports = {
+  "*.{ts,tsx}": ["eslint --fix", "prettier --write"],
+  "*.{go,mod,sum}": ["gofmt -w", "golangci-lint run --fix"],
+  "*.{py}": ["ruff check --fix", "ruff format"],
+  "*.proto": ["buf format --write"],
+  "*.md": ["prettier --write"],
+};
 ```
 
+> JSON / YAML 文件由 prettier 在 `*.md` 规则外按全局配置处理，如需显式规则可在 `lint-staged.config.js` 追加 `'*.{json,yaml,yml}': ['prettier --write']`。
+
 ---
 
 ## 四、PR 与 Code Review
@@ -435,6 +429,7 @@ feat(identity): 实现用户注册接口
 ## 影响范围
 
 <!-- 列出受影响的服务/包 -->
+
 - 服务：
 - 包：
 - 数据库迁移：是 / 否
@@ -468,7 +463,7 @@ Closes #
 ### 4.4 Reviewer 要求
 
 | 变更类型                  | 最少 Reviewer | 备注                |
-|---------|--------------|------|
+| ------------------------- | ------------- | ------------------- |
 | 普通业务变更              | 1             | 默认                |
 | 跨服务变更                | 2             | 涉及 ≥ 2 个服务     |
 | protobuf 契约变更         | 2             | 需包含架构组成员    |
@@ -479,6 +474,7 @@ Closes #
 ### 4.5 Code Review 清单
 
 **通用检查**：
+
 - [ ] 代码是否符合 [编码规范](./coding-standards.md)
 - [ ] 是否有明显的逻辑错误
 - [ ] 错误处理是否完整（不忽略 error/err/exception）
@@ -486,18 +482,21 @@ Closes #
 - [ ] 是否存在硬编码的密钥、token、连接字符串
 
 **架构检查**：
+
 - [ ] 是否违反限界上下文边界（跨服务直接查 DB）
 - [ ] 是否违反依赖方向（shared 反向依赖 services）
 - [ ] protobuf 变更是否向后兼容
 - [ ] 事件 schema 变更是否向后兼容
 
 **性能检查**：
+
 - [ ] 是否有 N+1 查询
 - [ ] 是否有未加索引的查询
 - [ ] 是否有不必要的大对象拷贝
 - [ ] 是否有阻塞事件循环的同步操作（Python/Node）
 
 **安全检查**：
+
 - [ ] 所有入口是否经过权限校验
 - [ ] 用户输入是否经过验证
 - [ ] SQL 是否使用参数化查询
@@ -506,18 +505,61 @@ Closes #
 ### 4.6 合并策略
 
 **默认使用 Squash Merge**：
+
 - 保留 PR 的完整变更作为一个 commit
 - commit message 使用 PR 标题
 - 删除特性分支
 
 **禁止使用 Merge Commit**（除非是发布分支合并回 main）：
+
 - 避免历史中充斥 "Merge branch" 噪音
 - 保持线性历史
 
 **Rebase Merge**：
+
 - 仅用于需要保留多个有意义 commit 的特性分支
 - 需在 PR 中说明原因
 
+### 4.7 模块 Owner 与 CODEOWNERS
+
+**实际生效文件**：仓库根 `.github/CODEOWNERS`（GitHub/Gitea 原生支持，自动为 PR 分配 reviewer）。
+
+**设计原则**：
+
+- 每个模块至少 1 名 owner，核心模块 2 名
+- 跨模块变更（如 proto 契约、arch.db、project_rules）由架构组 review
+- 基础设施变更（K8s/Helm/backup）由 SRE review
+- owner 名单变更需走 PR，由架构组审批
+
+**模块 Owner 分配矩阵**：
+
+| 模块分类   | 路径                                                                                                                                  | Owner Team                | 最少 Reviewer | 备注                  |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | ------------- | --------------------- |
+| 架构与规则 | `.trae/rules/`、`docs/architecture/`、`docs/standards/`                                                                               | `@edu-platform/arch`      | 2             | 架构组强制 review     |
+| 架构工具   | `scripts/arch-scan/`                                                                                                                  | `@edu-platform/arch`      | 1             |                       |
+| 根配置     | `.commitlintrc.js`、`lint-staged.config.js`、`package.json`、`pnpm-workspace.yaml`、`go.work`、`pyproject.toml`、`tsconfig.base.json` | `@edu-platform/arch`      | 2             | 影响全局              |
+| 共享包     | `packages/shared-proto/`                                                                                                              | `@edu-platform/arch`      | 2             | 契约变更影响所有服务  |
+| 网关层     | `services/api-gateway/`、`services/push-gateway/`                                                                                     | `@edu-platform/gateway`   | 1             |                       |
+| IAM 服务   | `services/iam/`                                                                                                                       | `@edu-platform/iam`       | 2             | 核心模块强制 2 人     |
+| 教学核心   | `services/core-edu/`、`services/classes/`                                                                                             | `@edu-platform/edu-core`  | 1             |                       |
+| 内容资源   | `services/content/`                                                                                                                   | `@edu-platform/content`   | 1             |                       |
+| 消息通知   | `services/msg/`                                                                                                                       | `@edu-platform/messaging` | 1             |                       |
+| 数据分析   | `services/data-ana/`                                                                                                                  | `@edu-platform/data`      | 1             |                       |
+| AI 服务    | `services/ai/`                                                                                                                        | `@edu-platform/ai`        | 1             |                       |
+| BFF 层     | `services/teacher-bff/`、`services/student-bff/`、`services/parent-bff/`                                                              | `@edu-platform/edu-core`  | 1             |                       |
+| 微前端     | `apps/teacher-portal/`、`apps/student-portal/`、`apps/parent-portal/`、`apps/admin-portal/`                                           | `@edu-platform/frontend`  | 1             |                       |
+| 基础设施   | `infra/k8s/`、`infra/backup/`、`infra/security/`、`infra/monitoring/`                                                                 | `@edu-platform/sre`       | 2             | 生产环境变更强制 2 人 |
+| CI/CD      | `.github/`、`.husky/`                                                                                                                 | `@edu-platform/sre`       | 1             |                       |
+| 文档       | `docs/troubleshooting/`、`docs/standards/`                                                                                            | `@edu-platform/arch`      | 1             | known-issues 更新     |
+
+> **Team handle 占位符**：上表 `@edu-platform/*` 为 team handle 模板。实际团队 handle 需在 GitHub/Gitea Organization 中创建对应 team 后，同步更新 `.github/CODEOWNERS`。
+
+**CODEOWNERS 文件维护规则**：
+
+1. 新增服务/包时，必须在同一 PR 中更新 `.github/CODEOWNERS`
+2. owner 变更（人员调动）需开独立 PR，由架构组审批
+3. CODEOWNERS 与本节表格保持同步，单一事实源为 `.github/CODEOWNERS` 文件
+
 ---
 
 ## 五、文档同步规则
@@ -525,7 +567,7 @@ Closes #
 ### 5.1 文档同步矩阵
 
 | 代码变更类型          | 需同步的文档                                 | 同步时机  |
-|-------------|-------------|---------|
+| --------------------- | -------------------------------------------- | --------- |
 | 新增/删除服务         | `001_architecture_overview.md` + 服务 README | PR 内同步 |
 | 新增/删除模块         | 服务 README + `arch:scan`                    | PR 内同步 |
 | 新增/删除导出函数     | `pnpm run arch:scan`                         | 提交前    |
@@ -551,6 +593,7 @@ git commit -m "feat(identity): 实现用户注册接口"
 ```
 
 **违规检查**：
+
 - 长文件（> 1000 行）
 - 未校验权限的 Handler
 - 循环依赖
@@ -568,26 +611,33 @@ git commit -m "feat(identity): 实现用户注册接口"
 > 技术栈：[语言 + 框架]
 
 ## 职责
+
 [一段话描述]
 
 ## 架构
+
 [mermaid 架构图]
 
 ## 核心流程
+
 [mermaid 时序图]
 
 ## 目录结构
+
 [树形结构 + 说明]
 
 ## 依赖
+
 - 上游服务：[列表]
 - 下游服务：[列表]
 - 共享包：[列表]
 
 ## 约束
+
 [业务规则、技术约束]
 
 ## 架构决策
+
 [关键设计决策记录]
 ```
 
@@ -599,11 +649,12 @@ git commit -m "feat(identity): 实现用户注册接口"
 ### X.X 主题分区
 
 | 场景     | 技术/规则          |
-|------|----------|
+| -------- | ------------------ |
 | 简述场景 | 正确做法（一句话） |
 ```
 
 **规则**：
+
 - 索引式：场景→技术/规则映射
 - 不写代码示例和错误示范
 - 同类问题在原条目补充，不重复创建
@@ -618,6 +669,7 @@ git commit -m "feat(identity): 实现用户注册接口"
 **规则**：一个 commit 只涉及一个服务或一个包的变更。
 
 **原因**：
+
 - 便于回滚（按服务粒度回滚）
 - 便于追踪（changelog 清晰）
 - 便于 review（聚焦单一职责）
@@ -653,12 +705,14 @@ git commit -m "build(contracts): 重新生成 proto 代码"
 ### 6.4 依赖升级规则
 
 **规则**：
+
 - 依赖升级使用 `build(deps):` 类型
 - 必须说明升级原因（安全、功能、兼容性）
 - 安全漏洞修复必须包含 CVE 编号
 - 大版本升级需单独 PR 并完整测试
 
 **示例**：
+
 ```
 build(deps): 升级 nestjs 至 10.3.0
 
@@ -692,14 +746,14 @@ git commit -m "feat(notification): 适配 UserRegistered v2 事件"
 本项目采用**双层版本号**：
 
 | 层级     | 格式                     | 说明                                      |
-|------|------|------|
+| -------- | ------------------------ | ----------------------------------------- |
 | 平台版本 | `v{阶段}.{迭代}.{patch}` | 如 `v0.3.1`（P3 阶段第 1 次迭代 patch 1） |
 | 服务版本 | `{service}:{semver}`     | 如 `identity:1.2.0`                       |
 
 ### 7.2 阶段版本范围
 
 | 阶段        | 平台版本范围 | 说明                            |
-|------|-------------|------|
+| ----------- | ------------ | ------------------------------- |
 | P1 地基     | `v0.1.x`     | monorepo 初始化、CI/CD、arch.db |
 | P2 身份     | `v0.2.x`     | identity + auth + notification  |
 | P3 核心教学 | `v0.3.x`     | org + teaching + content        |
@@ -712,7 +766,7 @@ git commit -m "feat(notification): 适配 UserRegistered v2 事件"
 **格式**：`{registry}/edu/{service}:{tag}`
 
 | tag 类型 | 格式                 | 示例              | 用途         |
-|---------|------|------|------|
+| -------- | -------------------- | ----------------- | ------------ |
 | 版本号   | `v{version}`         | `v0.3.1`          | 正式发布     |
 | 服务版本 | `{service}-{semver}` | `identity-1.2.0`  | 服务独立版本 |
 | Git SHA  | `sha-{short}`        | `sha-a1b2c3d`     | 精确追溯     |
@@ -752,19 +806,23 @@ flowchart TD
 ## [v0.3.0] - 2026-08-15
 
 ### Added
+
 - 教学核心服务新增作业管理功能
 - 内容服务支持题库导入
 - 教师端 Shell 新增作业批改界面
 
 ### Changed
+
 - identity 服务升级至 NestJS 10.3
 - gateway 路由匹配算法优化
 
 ### Fixed
+
 - 修复 JWT 刷新 token 过期判断错误
 - 修复课表查询时区问题
 
 ### Breaking Changes
+
 - UserRegistered 事件 schema 变更至 v2，消费方需升级
 ```
 
@@ -778,6 +836,7 @@ flowchart TD
 ```
 
 **版本号升级规则**：
+
 - **MAJOR**：Breaking Change（protobuf 不兼容变更、API 破坏性修改）
 - **MINOR**：新增功能，向后兼容
 - **PATCH**：Bug 修复，向后兼容
@@ -789,7 +848,7 @@ flowchart TD
 ### 8.1 回滚策略
 
 | 场景           | 回滚方式                | 耗时       |
-|------|---------|------|
+| -------------- | ----------------------- | ---------- |
 | 代码缺陷       | `git revert` + 重新部署 | 5-10 分钟  |
 | 镜像问题       | `kubectl rollout undo`  | 1-2 分钟   |
 | 数据库迁移问题 | 执行迁移 down 脚本      | 5-30 分钟  |
@@ -833,6 +892,7 @@ kubectl rollout status deployment/identity -n edu-prod
 ### 8.4 数据库迁移回滚
 
 **规则**：
+
 - 所有迁移必须提供 `up` 和 `down` 脚本
 - `down` 脚本必须在 CI 中测试
 - 回滚前必须备份生产数据
@@ -865,6 +925,7 @@ pnpm --filter identity run migrate:down -- --to <version>
 > 严重等级：P0/P1/P2/P3
 
 ## 时间线
+
 - HH:MM 告警触发
 - HH:MM 确认问题
 - HH:MM 决定回滚
@@ -872,15 +933,19 @@ pnpm --filter identity run migrate:down -- --to <version>
 - HH:MM 服务恢复
 
 ## 影响分析
+
 [受影响的功能、用户数、业务损失]
 
 ## 根本原因
+
 [技术原因 + 流程原因]
 
 ## 回滚过程
+
 [执行的操作]
 
 ## 改进措施
+
 - [ ] 短期：[立即修复项]
 - [ ] 中期：[流程改进项]
 - [ ] 长期：[架构改进项]
@@ -891,12 +956,12 @@ pnpm --filter identity run migrate:down -- --to <version>
 ## 九、附录：CICD 与 Edu Git 工作流差异
 
 | 维度                  | CICD（Next.js 单应用）           | Edu（微服务 monorepo）                                           |
-|------|----------------------|----------------------|
+| --------------------- | -------------------------------- | ---------------------------------------------------------------- |
 | 仓库结构              | 单一 Next.js 应用                | 多语言 monorepo（pnpm + go.work + uv）                           |
 | 分支策略              | trunk-based                      | trunk-based（沿用）                                              |
 | 提交规范              | Conventional Commits             | Conventional Commits（沿用，scope 扩展至服务/包）                |
-| scope 范围 | 模块名（如 `exams`、`homework`） | 服务/包名（如 `identity`、`contracts`） |
-| commitlint scope-enum | 35 个模块 | 27 个服务/包 |
+| scope 范围            | 模块名（如 `exams`、`homework`） | 服务/包名（如 `iam`、`api-gateway`、`shared-proto`）             |
+| commitlint scope-enum | 35 个模块                        | 26 个 scope（含服务/包/工具/平台级，与 `.commitlintrc.js` 同步） |
 | PR Reviewer           | 1 人                             | 1-2 人（核心模块/跨服务 2 人）                                   |
 | 合并策略              | Squash Merge                     | Squash Merge（沿用）                                             |
 | 版本号                | 单一应用版本                     | 双层（平台版本 + 服务独立版本）                                  |
@@ -914,5 +979,6 @@ pnpm --filter identity run migrate:down -- --to <version>
 ## 变更记录
 
 | 版本 | 日期       | 变更内容                                                                                                                                                 |
-|------|------|---------|
+| ---- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | 1.0  | 2026-07-07 | 基线发布，从 CICD 单应用规范迁移至微服务多语言 monorepo                                                                                                  |
+| 1.1  | 2026-07-08 | scope-enum 对齐实际服务名（identity→iam、teaching→core-edu 等）；新增 §4.7 模块 Owner 与 CODEOWNERS；husky hooks 与实际文件对齐；新增 pre-push hook 说明 |

docs/troubleshooting/known-issues.md

@@ -1,7 +1,7 @@
 # 已知问题速查
 
 > 索引式速查手册：场景 → 技术/规则映射。不写代码示例。
-> 架构规则见 [../architecture/004_architecture_impact_map.md](../architecture/004_architecture_impact_map.md) 与 [../../project_rules.md](../../project_rules.md)
+> 架构规则见 [../architecture/004_architecture_impact_map.md](../architecture/004_architecture_impact_map.md) 与 [../../.trae/rules/project_rules.md](../../.trae/rules/project_rules.md)
 > 工作经验日志按时间倒序追加（50 条上限），AI 发现更好方案时可更新本节。
 
 ---
@@ -11,10 +11,10 @@
 ### 1.1 多语言 monorepo 配置
 
 | 场景                     | 技术/规则                                                                                  |
-| ----------------------------- | ------------------------------------------------------------------------------------------ |
+| ------------------------ | ------------------------------------------------------------------------------------------ |
 | 多语言 workspace         | pnpm workspace（TS）+ go.work（Go）+ pyproject.toml/uv workspace（Python）三套并存         |
 | 根 package.json scripts  | 封装多语言命令入口：`pnpm dev` / `pnpm lint` / `pnpm test` / `pnpm build`                  |
-| pnpm-workspace.yaml           | 仅声明 TS 包路径（packages/*、services/classes、bff/*、apps/*、scripts/*），Go/Python 不入 |
+| pnpm-workspace.yaml      | 仅声明 TS 包路径（packages/_、services/classes、bff/_、apps/_、scripts/_），Go/Python 不入 |
 | go.work                  | 列出所有 Go 服务模块（services/api-gateway、services/push-gateway）                        |
 | pyproject.toml           | uv workspace members 列 Python 服务（services/data-ana、services/ai-gateway）              |
 | 跨语言共享类型           | protobuf 生成三端代码（TS/Go/Python），单一契约源                                          |
@@ -25,7 +25,7 @@
 ### 1.2 Docker Compose 基础设施
 
 | 场景             | 技术/规则                                                                                       |
-| ---------------------------- | ---------------------------------------------------------------------------------- |
+| ---------------- | ----------------------------------------------------------------------------------------------- |
 | 日常开发启动     | 用 `docker-compose.minimal.yml` 仅起 MySQL+Redis                                                |
 | 全量启动内存不足 | 按 `profiles` 分阶段启用（full/kafka/cdc/analytics/graph/search/config/observability）          |
 | 每服务 mem_limit | 避免单服务吃满内存：MySQL 512m、Redis 128m、Kafka 512m、ClickHouse 1g                           |
@@ -38,7 +38,7 @@
 ### 1.3 protobuf + buf 契约
 
 | 场景                 | 技术/规则                                                                   |
-| ----------------------- | ------------------------------------------------------------------------------------------ |
+| -------------------- | --------------------------------------------------------------------------- |
 | 契约唯一源           | `packages/shared-proto/proto/*.proto`，禁止 REST/gRPC 混用                  |
 | breaking change 检测 | `buf breaking --against '.git#branch=main'` CI 强制，必须升版本号           |
 | proto 版本化         | 包名带版本 `xxx.v1`、`xxx.v2`，新旧版本共存                                 |
@@ -51,7 +51,7 @@
 ### 1.4 NestJS 服务开发（TS）
 
 | 场景                  | 技术/规则                                                                                              |
-| ------------------------- | ----------------------------------------------------------------------------------------------- |
+| --------------------- | ------------------------------------------------------------------------------------------------------ |
 | 服务标准结构          | `src/{main.ts,app.module.ts,config,middleware,<domain>,shared,generated}` 黄金模板复制                 |
 | 三层配置              | env（环境变量）< yaml（业务参数）< 配置中心（P6 Consul）；每服务启动时合并                             |
 | 环境变量校验          | Zod schema 校验 process.env，失败立即抛错终止启动                                                      |
@@ -71,7 +71,7 @@
 ### 1.5 Go Gateway 开发
 
 | 场景              | 技术/规则                                                                               |
-| ------------------- | ------------------------------------------------------------------------------------------ |
+| ----------------- | --------------------------------------------------------------------------------------- |
 | 框架              | Gin + httputil.ReverseProxy 路由转发                                                    |
 | P1 鉴权           | Gateway 内置 HS256 JWT 校验（测试密钥），P2 改 RS256（IAM 签发，公钥校验）              |
 | JWT claims        | `{ user_id, roles[], registered_claims }`，校验后注入 `x-user-id`/`x-user-roles` 头转发 |
@@ -85,7 +85,7 @@
 ### 1.6 可观测性（OTel + Prometheus + Loki）
 
 | 场景            | 技术/规则                                                                        |
-| --------------------- | ---------------------------------------------------------------------------------- |
+| --------------- | -------------------------------------------------------------------------------- |
 | P1 最小可观测集 | 每服务结构化日志 + `/metrics` + OTel SDK 初始化（不引入完整后端）                |
 | 三支柱          | Logs（pino/winston/zap）+ Metrics（prom-client）+ Traces（OTel SDK）             |
 | traceId 注入    | Gateway 注入 → 服务读取 header → 日志/响应携带                                   |
@@ -97,7 +97,7 @@
 ### 1.7 微前端 Module Federation
 
 | 场景                   | 技术/规则                                                                    |
-| --------------------- | -------------------------------------------------------------------------------------------- |
+| ---------------------- | ---------------------------------------------------------------------------- |
 | 4 个稳定 portal        | teacher-portal / student-portal / parent-app / admin-console，按场景域划分   |
 | P1 测试页              | teacher-portal 仅一个测试页验证 classes CRUD 链路，P2 起配 Module Federation |
 | 视口驱动渲染           | 侧边栏由 `viewports.L1` 驱动渲染，路由由 `viewports.L2` 控制                 |
@@ -107,7 +107,7 @@
 ### 1.8 从旧项目迁移的通用经验
 
 | 场景                  | 技术/规则                                                                            |
-| ----------------------------- | ----------------------------------------------------------------------------------------------- |
+| --------------------- | ------------------------------------------------------------------------------------ |
 | React 19 乐观更新     | `useOptimistic` 替代手动 isPending，配合 `useTransition` 自动管理回滚                |
 | Zustand 细粒度选择器  | 单字段 selector 优于 `useShallow` 多字段包装                                         |
 | Tiptap SSR            | 必须 `immediatelyRender: false` 避免 hydration mismatch                              |
@@ -129,13 +129,13 @@
 ### 1.9 架构工具与验证命令
 
 | 场景                | 命令/规则                                                   |
-| --------------------- | ---------------------------------------------------------------------- |
-| arch.db 扫描          | `npm run arch:scan`（多语言：TS+Go+Python）                            |
-| arch.db 查询          | `npm run arch:query -- <command>`                                      |
-| 查服务依赖            | `npm run arch:query -- service <service>`                              |
-| 查 proto 契约         | `npm run arch:query -- contracts`                                      |
-| 查 Kafka 事件         | `npm run arch:query -- events`                                         |
-| 查架构违规            | `npm run arch:query -- violations`（输出 0 为合格）                    |
+| ------------------- | ----------------------------------------------------------- |
+| arch.db 扫描        | `pnpm run arch:scan`（多语言：TS+Go+Python+Proto）          |
+| arch.db 查询        | `pnpm run arch:query -- <command>`                          |
+| 查服务依赖          | `pnpm run arch:query -- deps <module>`                      |
+| 查 proto 契约       | `pnpm run arch:query -- sql "SELECT * FROM contracts"`      |
+| 查 Kafka 事件       | `pnpm run arch:query -- sql "SELECT * FROM events"`         |
+| 查架构违规          | `pnpm run arch:query -- violations`（骨架，P1 后期补全）    |
 | proto lint          | `cd packages/shared-proto && pnpm exec buf lint`            |
 | proto breaking 检测 | `pnpm exec buf breaking --against '.git#branch=main'`       |
 | proto 代码生成      | `pnpm proto:gen`                                            |
@@ -152,7 +152,7 @@
 ### 2.1 api-gateway（Go）
 
 | 场景           | 技术/规则                                                                       |
-| ------------------- | ------------------------------------------------------------------------------------------ |
+| -------------- | ------------------------------------------------------------------------------- |
 | P1 鉴权        | Gateway 内置 HS256 JWT，`jwt.ParseWithClaims` + `SigningMethodHMAC` 校验        |
 | P2 鉴权升级    | 改 RS256，IAM 私钥签发，Gateway 公钥校验，无需调 IAM                            |
 | 路由转发       | `gin.Group("/api/v1")` + `httputil.NewSingleHostReverseProxy`                   |
@@ -165,7 +165,7 @@
 ### 2.2 classes（TS/NestJS，P1 黄金模板）
 
 | 场景             | 技术/规则                                                                                        |
-| ------------------------- | ----------------------------------------------------------------------------------------------- |
+| ---------------- | ------------------------------------------------------------------------------------------------ |
 | 黄金模板定位     | P1 完整实现所有横切关注点，后续 8 个服务复制此模板                                               |
 | 黄金模板复制流程 | `cp -r services/classes services/xxx` → 改错误码前缀 → 改 proto → 改业务逻辑 → 改 README → 改 CI |
 | 横切关注点清单   | 错误处理 / 可观测 / 安全 / 契约 / 测试 / 文档 / 配置 / i18n / CI / Dockerfile                    |
@@ -184,7 +184,7 @@
 ### 2.3 iam（TS/NestJS，P2）
 
 | 场景           | 技术/规则                                                                                                           |
-| --------------------- | ------------------------------------------------------------------------------------------ |
+| -------------- | ------------------------------------------------------------------------------------------------------------------- |
 | 认证           | 登录/登出/JWT/2FA，RS256 非对称签名                                                                                 |
 | RBAC           | 角色/权限/角色-权限 CRUD + `getEffectivePermissions(userId)` API                                                    |
 | 视口配置       | 4 层模型（导航/路由/组件/数据），`role_viewports` 表                                                                |
@@ -197,7 +197,7 @@
 ### 2.4 core-edu（TS/NestJS，P3）
 
 | 场景           | 技术/规则                                                                                                               |
-| --------------------- | ------------------------------------------------------------------------------------------ |
+| -------------- | ----------------------------------------------------------------------------------------------------------------------- |
 | 考试全生命周期 | 教师创建 → 发布 → 学生作答 → 教师批改 → 成绩统计                                                                        |
 | Outbox 模式    | 业务事务同写 `outbox_events` 表，后台 relay worker 投递 Kafka                                                           |
 | Outbox relay   | Go 写独立服务 `services/outbox-relay/`，轻量高吞吐                                                                      |
@@ -210,7 +210,7 @@
 ### 2.5 content（TS/NestJS，P4）
 
 | 场景       | 技术/规则                                                          |
-| --------------------- | ------------------------------------------------------------------------------------------ |
+| ---------- | ------------------------------------------------------------------ |
 | 知识图谱   | Neo4j 查询前置依赖图（秒级返回）                                   |
 | 题库 CRUD  | P4 仅 CRUD，P5 引入 ES 实现检索，避免 MySQL FULLTEXT → ES 迁移成本 |
 | 双写避免   | Neo4j/ES 不直接双写，由消费 Kafka 事件同步，天然最终一致           |
@@ -219,7 +219,7 @@
 ### 2.6 data-ana（Python/FastAPI，P4）
 
 | 场景         | 技术/规则                                                                      |
-| --------------------- | ------------------------------------------------------------------------------------------ |
+| ------------ | ------------------------------------------------------------------------------ |
 | 学情诊断     | ClickHouse 宽表查询，5s 内返回                                                 |
 | CDC 链路     | Debezium 监听 MySQL binlog → Kafka（`mysql.cdc.*`）→ DataAna 消费写 ClickHouse |
 | CDC 延迟监控 | Debezium 暴露 lag metrics，超阈值告警                                          |
@@ -229,7 +229,7 @@
 ### 2.7 messaging（TS/NestJS，P5）
 
 | 场景           | 技术/规则                                                            |
-| --------------------- | ------------------------------------------------------------------------------------------ |
+| -------------- | -------------------------------------------------------------------- |
 | 消息 CRUD      | 会话/消息 + 调 Push Gateway 推送 + 通知偏好                          |
 | 通知批量化     | `createNotifications(items)` 单次 INSERT，沿用旧项目 dispatcher 模式 |
 | 多渠道         | 站内/SMS/邮件/微信，in_app 批量 + 其他渠道并行                       |
@@ -239,7 +239,7 @@
 ### 2.8 push-gateway（Go，P5）
 
 | 场景             | 技术/规则                                       |
-| --------------------- | ------------------------------------------------------------------------------------------ |
+| ---------------- | ----------------------------------------------- |
 | WebSocket 长连接 | 单节点支撑 10w+ 连接，业务服务只需发 Kafka 消息 |
 | 跨实例同步       | Redis PubSub                                    |
 | 离线消息         | 仅推在线用户，离线消息存 MySQL，上线时拉取      |
@@ -247,7 +247,7 @@
 ### 2.9 ai-gateway（Python/FastAPI，P5）
 
 | 场景              | 技术/规则                                   |
-| --------------------- | ------------------------------------------------------------------------------------------ |
+| ----------------- | ------------------------------------------- |
 | LLM Provider 适配 | OpenAI/Anthropic，langchain/litellm 生态    |
 | Prompt 模板管理   | 版本管理友好                                |
 | 流式 SSE          | AI 网关 → BFF → 前端三层透传，BFF 不缓冲    |
@@ -257,7 +257,7 @@
 ### 2.10 shared-proto（契约包）
 
 | 场景         | 技术/规则                                                                       |
-| --------------------- | ------------------------------------------------------------------------------------------ |
+| ------------ | ------------------------------------------------------------------------------- |
 | 目录结构     | `proto/*.proto` + `buf.yaml` + `buf.gen.yaml`                                   |
 | P1 契约      | 仅 `classes.proto`，`iam.proto`/`core_edu.proto` 占位                           |
 | 代码生成输出 | TS → `shared-ts/generated`，Go → `shared-go/`，Python → `services/*/generated/` |
@@ -265,10 +265,10 @@
 ### 2.11 arch-scan（多语言扫描器）
 
 | 场景           | 技术/规则                                                                                       |
-| --------------------- | ------------------------------------------------------------------------------------------ |
-| TS 扫描               | ts-morph 解析 AST，提取导出/函数/类/import                                                  |
-| Go 扫描               | P1 用正则提取（函数/类型/import），P2 起替换为 tree-sitter-go AST                           |
-| Python 扫描           | P1 用正则提取，P4 起替换为 tree-sitter-python AST                                          |
+| -------------- | ----------------------------------------------------------------------------------------------- |
+| TS 扫描        | regex 提取（function/class/interface/UPPER_CASE const），避免 ts-morph 对未安装依赖文件解析失败 |
+| Go 扫描        | 正则提取（行首锚定 `^func`/`^type`），P2 起替换为 tree-sitter-go AST                            |
+| Python 扫描    | 正则提取（行首锚定 `^def`/`^class`），P4 起替换为 tree-sitter-python AST                        |
 | arch.db schema | modules/symbols/dependencies/contracts/events/violations 六表                                   |
 | 全量扫描       | 先清空旧数据再扫描，避免残留                                                                    |
 | 并行扫描风险   | 并行子代理执行 arch:scan 可能因竞争报 FOREIGN KEY 错误，必须串行执行                            |
@@ -278,7 +278,7 @@
 ### 2.12 teacher-portal（微前端宿主，P1 测试页）
 
 | 场景                 | 技术/规则                                                                 |
-| --------------------- | ------------------------------------------------------------------------------------------ |
+| -------------------- | ------------------------------------------------------------------------- |
 | P1 测试页            | 单一 Next.js 应用，验证 classes CRUD 端到端链路                           |
 | API 调用             | `fetch(${API_BASE}/api/v1/classes)` + `Authorization: Bearer ${TEST_JWT}` |
 | P1 测试 JWT          | 开发工具生成 HS256 token，P2 起由 IAM 签发 RS256                          |
@@ -291,5 +291,14 @@
 > 按时间倒序，50 条上限。AI 发现更好方案时可更新本节。
 
 | 日期       | 时间 | 模块        | 做了什么 + 学到什么                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| ---------- | ----- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ---------- | ---- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 2026-07-08 | 全天 | 全局        | **P6 后续工作手册执行**：完整执行 post-p6-followup.md 12 节任务。环境准备（pnpm 925 包 + go mod tidy 双服务 + uv sync 双服务 + buf 安装）→ 代码质量校验（Go vet/build 0 错误，Python ruff 8 错误自动修复）→ arch.db 同步（实现 4 个扫描器骨架，输出 12 模块/233 符号/138 契约）→ project_rules.md P0 修复（迁移到 .trae/rules/，17881 字节）→ 004 架构图修复（1.1a/1.1b 双图 + 1.2 业务领域列 + 5.4 视口四层）→ P6 集成测试（10 Go + 17 bash = 27 用例全通过）→ Helm Chart 演化（8 chart lint 通过）。**学到**：多语言 monorepo 工具链配置需统一镜像源（npmmirror/goproxy.cn/tuna），go.work BOM 字符会导致 `unexpected input character` 错误必须重写文件。 |
+| 2026-07-08 | 上午 | 全局        | pnpm install 网络失败（ECONNRESET）→ 配置 `npm config set registry https://registry.npmmirror.com` + `pnpm config set registry https://registry.npmmirror.com` 重试成功。**学到**：Windows 下 pnpm 还需配置 `PNPM_HOME` 和 `TMP` 环境变量避免 `_tmp_` 文件 ENOENT 错误。                                                                                                                                                                                                                                                                                                                                                                                    |
+| 2026-07-08 | 上午 | 全局        | project_rules.md 损坏（72 字节乱码，从 P1 提交 2ba4250 就损坏，git 历史无完整版本）→ 从 CICD 项目完整版迁移到 `e:\Desktop\Edu\.trae\rules\project_rules.md`（按用户要求放 .trae/rules/），按 MIGRATION_GUIDE 4.1 策略矩阵调整为微服务版（13 章 17881 字节），删除根目录损坏文件，更新 7 处引用（README/MIGRATION_GUIDE/004/known-issues/git-workflow/coding-standards）。**学到**：迁移文件后必须 `Get-Item                                                                                                                                                                                                                                                 | Select Length` 验证完整性 + 全文搜索引用更新，git commit 前运行 cat 检查内容。 |
+| 2026-07-08 | 上午 | api-gateway | go.work BOM 字符 + 版本不匹配：`unexpected input character '\ufeff'` 和 `module requires go >= 1.22.0, but go.work lists go 1.22`。**修复**：重写 go.work 去除 BOM，版本改为 `go 1.26.0`，移除不存在的 `./packages/shared-go`。**学到**：PowerShell `Out-File` 默认加 BOM，写 go.work 这类敏感文件应用 `Write` 工具或 `[System.IO.File]::WriteAllText` 指定 UTF8 无 BOM。                                                                                                                                                                                                                                                                                   |
+| 2026-07-08 | 上午 | arch-scan   | arch:scan 返回 0 模块 0 符号 → 4 个扫描器（ts/go/py/proto）都是骨架实现。**修复**：完整实现 4 个扫描器，TS 用 regex 提取（避免 ts-morph 对未安装依赖文件解析失败），Go/Python 用行首锚定正则，Proto 扫描 service/message/rpc。结果：12 模块（≥10 ✓）、233 符号（≥100 ✓）、138 契约。**学到**：ts-morph Project 对未 `pnpm install` 的 workspace 文件会报模块解析失败，改用 regex 更鲁棒；scanner.ts main() 开头需 `DELETE FROM` 清空旧数据避免重跑重复。                                                                                                                                                                                                    |
+| 2026-07-08 | 下午 | 004         | 架构图视角讨论（技术分层 vs 业务领域）→ 双图并存方案：1.1a 技术分层视角（部署/流量/网络边界，Users 层标注"场景域用户"，BFF 层标注"按场景域分"）+ 1.1b 业务领域视角（6 DDD 限界上下文 subgraph：D1 身份/D2 教学组织/D3 教学核心/D4 内容/D5 沟通/D6 智能洞察）。1.2 服务清单新增"业务领域"列。**学到**：双图互补，1.1a 服务运维/SRE 视角，1.1b 服务产品/架构视角；同一服务可横跨多领域（core-edu 同时承载 D2+D3）。                                                                                                                                                                                                                                           |
+| 2026-07-08 | 下午 | 004         | 视口四层模型补充（5.4 章节）：L1 导航（navigation_config 表）/ L2 路由（route_permission + Gateway 校验）/ L3 组件（usePermission().hasPermission）/ L4 数据（DataScope 枚举）。场景域 BFF 复用策略：按使用场景域分 BFF 而非按角色分，教导主任复用 Teacher BFF + 额外管理视口。iam 服务职责：认证 + RBAC + 视口配置 + DataScope + 权限解析 API。**学到**：视口既可独立配置（RoleViewport 表）也可由权限推导，新角色只需配权限集，视口自动推导。                                                                                                                                                                                                             |
+| 2026-07-08 | 下午 | api-gateway | P6 集成测试补充：circuit-breaker_test.go（5 用例：ClosedToOpen/OpenToHalfOpen/HalfOpenToClosed/HalfOpenToOpen/4xxNotCounted）+ ratelimit_test.go（5 用例：AllowUnderBurst/RejectOverBurst/RefillTokens/PerIPIsolation/CleanupExpiredBuckets）+ test-backup-mysql.sh（8 用例 17 断言）。**学到**：gobreaker v2 ReadyToTrip 在 1 次失败后就触发（`TotalFailures*2 > Requests` 当 Requests=1 时 1*2>1=true），HALF_OPEN 状态只在探测执行期间可见，探测完成后立即转 CLOSED 或回 OPEN，测试需通过行为（503 vs 500）而非状态字段验证；rateLimiter cleanup 测试需用短周期参数（50ms/500ms）加速，且新鲜桶要在旧桶清理后再创建避免被一起清掉。                      |
+| 2026-07-08 | 下午 | infra/k8s   | Helm Chart 演化：安装 Helm v4.2.2，创建 edu-platform 平台级 chart（namespace/configmap/secret/ingress/hpa + 4 环境 values 文件）+ api-gateway 服务级 chart（完整迁移自原 deployment.yaml，参数化所有字段）+ 6 业务服务 chart 桩（iam/core-edu/content/msg/data-ana/ai）。删除原 api-gateway-deployment.yaml，保留 namespace.yaml。**学到**：Helm `{{- with ... -}}` 双向修剪会导致标签连在一行（`managed-by: Helmpart-of: edu-platform`），应改为 `{{- with ... }}` 只修剪左侧；`helm lint` 全部通过但 `helm template` 才能发现 YAML 渲染错误，验证时两个都要跑。                                                                                           |
 | 2026-07-07 | 全天 | 全局        | 文档体系初始化：从旧项目（e:\Desktop\CICD，Next.js 单体）迁移 spec + plan + known-issues 模板到新仓库（e:\Desktop\Edu，微服务架构）。known-issues 重组为微服务分区：多语言 monorepo / Docker Compose / protobuf+buf / NestJS / Go Gateway / 可观测性 / 微前端。从旧项目提炼可迁移经验：React 19 useOptimistic / Zustand 细粒度选择器 / Tiptap SSR / 请求级去重 / 批量 SQL / 动态导入模式 / arch:scan 串行执行。新增微服务特有经验：契约先行 / Outbox / CDC / 双轨读 / DataScope / 黄金模板复制流程。路线图按 6 阶段组织：P1 地基 → P2 身份 → P3 核心教学 → P4 内容分析 → P5 沟通AI → P6 硬化。                                                              |

go.work

@@ -1,7 +1,6 @@
-go 1.22
+go 1.26.0
 
 use (
   ./services/api-gateway
   ./services/push-gateway
-  ./packages/shared-go
 )

infra/backup/test-backup-mysql.sh

@@ -0,0 +1,112 @@
+#!/bin/bash
+# backup-mysql.sh 参数解析与校验的 dry-run 测试
+# 不实际执行 mysqldump，仅验证参数解析、必填校验、默认值、帮助信息等。
+#
+# 运行方式（需要 bash 环境，如 Git Bash / WSL）：
+#   bash infra/backup/test-backup-mysql.sh
+#
+# 退出码：0 表示全部通过，非 0 表示有失败用例。
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SCRIPT="${SCRIPT_DIR}/backup-mysql.sh"
+
+PASS=0
+FAIL=0
+
+# assertExit <expected_code> <description> <actual_code> <stderr>
+assertExit() {
+  local expected="$1" desc="$2" actual="$3" stderr="${4:-}"
+  if [[ "$actual" == "$expected" ]]; then
+    echo "[PASS] $desc (exit=$actual)"
+    PASS=$((PASS + 1))
+  else
+    echo "[FAIL] $desc: 期望 exit=$expected, 实际 exit=$actual"
+    [[ -n "$stderr" ]] && echo "       stderr: $stderr"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+# assertContains <needle> <description> <haystack>
+assertContains() {
+  local needle="$1" desc="$2" haystack="${3:-}"
+  if [[ "$haystack" == *"$needle"* ]]; then
+    echo "[PASS] $desc"
+    PASS=$((PASS + 1))
+  else
+    echo "[FAIL] $desc: 输出应包含 '$needle'"
+    echo "       实际输出: $haystack"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+echo "=== backup-mysql.sh dry-run 测试 ==="
+
+# ---------- 用例 1: 无参数应失败并提示 --service 必填 ----------
+output="$("$SCRIPT" 2>&1)"
+code=$?
+assertExit 1 "无参数应退出 1" "$code" "$output"
+assertContains "--service 参数必填" "无参数应提示 --service 必填" "$output"
+
+# ---------- 用例 2: --help 应退出 0 并输出 Usage ----------
+output="$("$SCRIPT" --help 2>&1)"
+code=$?
+assertExit 0 "--help 应退出 0" "$code" "$output"
+assertContains "Usage:" "--help 应输出 Usage" "$output"
+assertContains "--service" "--help 应说明 --service 参数" "$output"
+assertContains "--keep" "--help 应说明 --keep 参数" "$output"
+
+# ---------- 用例 3: --keep 默认值（未提供时）应在日志中体现 7 天 ----------
+# 设置 MYSQL_PASSWORD 让脚本通过环境变量校验，进入主流程打印日志；
+# 随后会在 mysqldump 阶段失败（CI 环境无 mysqldump）。
+output="$(MYSQL_PASSWORD=fake-pass "$SCRIPT" --service iam 2>&1)"
+code=$?
+assertExit 1 "无 mysqldump 时应最终退出 1" "$code" "$output"
+assertContains "保留 7 天" "未提供 --keep 时应使用默认值 7 天" "$output"
+
+# ---------- 用例 4: --keep 非数字应失败 ----------
+output="$("$SCRIPT" --service iam --keep abc 2>&1)"
+code=$?
+assertExit 1 "--keep 非数字应退出 1" "$code" "$output"
+assertContains "--keep 必须为正整数" "非数字 --keep 应报错" "$output"
+
+# ---------- 用例 5: --keep 小于 1 应失败 ----------
+output="$("$SCRIPT" --service iam --keep 0 2>&1)"
+code=$?
+assertExit 1 "--keep=0 应退出 1" "$code" "$output"
+assertContains "--keep 必须为正整数" "--keep=0 应报错" "$output"
+
+# ---------- 用例 6: 未知参数应失败 ----------
+output="$("$SCRIPT" --service iam --unknown-flag 2>&1)"
+code=$?
+assertExit 1 "未知参数应退出 1" "$code" "$output"
+assertContains "未知参数" "未知参数应报错" "$output"
+
+# ---------- 用例 7: --keep 自定义值应在日志中体现 ----------
+output="$(MYSQL_PASSWORD=fake-pass "$SCRIPT" --service iam --keep 30 2>&1)"
+code=$?
+assertExit 1 "无 mysqldump 时应最终退出 1（用例 7 预置）" "$code" "$output"
+assertContains "保留 30 天" "--keep=30 应在日志中体现" "$output"
+
+# ---------- 用例 8: MYSQL_PASSWORD 已设置但 mysqldump 不可用时应优雅失败 ----------
+# 此用例验证：参数校验通过后，脚本会尝试调用 mysqldump；若 mysqldump 不存在则失败。
+# 在无 MySQL 容器的 CI 环境中，这是最接近真实 dry-run 的验证。
+output="$(MYSQL_PASSWORD=fake-pass "$SCRIPT" --service iam 2>&1)"
+code=$?
+# mysqldump 不存在时，pipefail + gzip 写入空文件 → 脚本检测到空文件后 exit 1
+# 或 mysqldump 命令未找到 → set -e 触发 exit 1
+# 任一路径都应是非 0 退出
+if [[ "$code" -ne 0 ]]; then
+  echo "[PASS] mysqldump 不可用时应非 0 退出 (exit=$code)"
+  PASS=$((PASS + 1))
+else
+  echo "[FAIL] mysqldump 不可用时不应返回 0"
+  FAIL=$((FAIL + 1))
+fi
+
+echo "=== 测试结果 ==="
+echo "通过: $PASS  失败: $FAIL"
+if [[ "$FAIL" -gt 0 ]]; then
+  exit 1
+fi
+exit 0

infra/k8s/README.md

@@ -1,55 +1,118 @@
-# K8s 部署说明（骨架）
+# K8s 部署说明
 
-> **说明**：本目录为 K8s 部署**骨架**，仅提供最小可用 manifest，**生产环境请使用 Helm Chart**。
+> **状态**：已迁移到 Helm Chart 管理。本目录保留 `namespace.yaml` 作为基础资源，其余资源通过 `helm/` 下的 chart 部署。
 
-## 适用范围
+## 目录结构
 
-- 开发 / Staging 环境快速拉起
-- 验证服务在 K8s 上的基本可用性
-- 作为后续 Helm 化的过渡参考
-
-## Manifest 类别
-
-| 文件 | 类别 | 用途 |
-|------|------|------|
-| `namespace.yaml` | namespace | 划分 4 个命名空间：system / services / monitoring / ingress |
-| `configmap-*.yaml` | configmap | 非敏感配置（服务端口、特性开关等） |
-| `secret-*.yaml` | secret | 敏感配置（密钥、连接串），生产用 External Secrets |
-| `*-deployment.yaml` | deployment | 服务无状态部署，含探针 / 资源 / 副本数 |
-| `*-service.yaml` | service | ClusterIP 服务发现 |
-| `ingress.yaml` | ingress | 对外入口，TLS 终结 + 路由 |
-| `*-hpa.yaml` | hpa | 水平自动扩缩容 |
+```
+infra/k8s/
+├─ namespace.yaml              # 基础命名空间（4 个：system/services/monitoring/ingress）
+└─ helm/                       # Helm Chart 仓库
+   ├─ edu-platform/            # 平台级 chart（namespace/configmap/secret/ingress/hpa）
+   │  ├─ Chart.yaml
+   │  ├─ values.yaml           # 全局默认值
+   │  ├─ values-dev.yaml       # 开发环境覆盖
+   │  ├─ values-staging.yaml   # 预发布环境覆盖
+   │  ├─ values-prod.yaml      # 生产环境覆盖
+   │  └─ templates/
+   │     ├─ _helpers.tpl
+   │     ├─ namespace.yaml
+   │     ├─ configmap.yaml
+   │     ├─ secret.yaml        # 骨架；生产请用 External Secrets Operator
+   │     ├─ ingress.yaml
+   │     └─ hpa.yaml           # 全局 HPA 示例（默认不渲染）
+   ├─ api-gateway/             # 服务级 chart（完整迁移自原 manifest）
+   │  ├─ Chart.yaml
+   │  ├─ values.yaml
+   │  └─ templates/
+   │     ├─ _helpers.tpl
+   │     ├─ deployment.yaml
+   │     ├─ service.yaml
+   │     ├─ configmap.yaml
+   │     └─ hpa.yaml
+   ├─ iam/                     # 业务服务 chart 桩（P2）
+   ├─ core-edu/                # 业务服务 chart 桩（P3）
+   ├─ content/                 # 业务服务 chart 桩（P4）
+   ├─ msg/                     # 业务服务 chart 桩（P5）
+   ├─ data-ana/                # 业务服务 chart 桩（P4）
+   └─ ai/                      # 业务服务 chart 桩（P5）
+```
 
 ## 命名空间规划
 
 | Namespace        | 用途                                                       |
-|-----------|------|
+| ---------------- | ---------------------------------------------------------- |
 | `edu-system`     | 系统组件（数据库代理、配置等）                             |
 | `edu-services`   | 业务微服务（api-gateway / iam / core-edu / content / msg） |
 | `edu-monitoring` | 监控栈（Prometheus / Grafana / Alertmanager）              |
 | `edu-ingress`    | 入口控制器（NGINX Ingress / cert-manager）                 |
 
-## 部署顺序
+## 部署方式
+
+### 1. 安装平台级 chart（命名空间 / 全局 ConfigMap / Secret / Ingress）
+
+```bash
+# 开发环境
+helm install edu-platform ./helm/edu-platform -f ./helm/edu-platform/values-dev.yaml
+
+# 生产环境
+helm install edu-platform ./helm/edu-platform -f ./helm/edu-platform/values-prod.yaml \
+  --set secret.data.MYSQL_PASSWORD=<base64> \
+  --set secret.data.JWT_SECRET=<base64> \
+  --set secret.data.REDIS_PASSWORD=<base64>
+```
+
+### 2. 安装服务级 chart
+
+```bash
+# api-gateway
+helm install api-gateway ./helm/api-gateway
+
+# 其他业务服务（iam / core-edu / content / msg / data-ana / ai）
+helm install iam ./helm/iam
+helm install core-edu ./helm/core-edu
+# ...
+```
+
+### 3. 应用基础命名空间（如未通过 helm 安装 edu-platform）
 
 ```bash
 kubectl apply -f namespace.yaml
-kubectl apply -f configmap-*.yaml
-kubectl apply -f secret-*.yaml      # 生产请改用 External Secrets
-kubectl apply -f *-deployment.yaml
-kubectl apply -f *-service.yaml
-kubectl apply -f ingress.yaml
-kubectl apply -f *-hpa.yaml
 ```
 
-## Helm 化路线（后续）
+## 验证
 
-1. 将骨架迁移为 Helm Chart（`charts/edu-platform/`）
-2. 每个微服务一个子 Chart，统一通过 umbrella chart 编排
-3. 环境差异通过 values-<env>.yaml 管理
-4. 敏感配置接入 External Secrets Operator（对接 Vault / KMS）
-5. CI/CD 通过 ArgoCD / Flux 做 GitOps 部署
+```bash
+# lint 所有 chart
+helm lint helm/edu-platform helm/api-gateway helm/iam helm/core-edu helm/content helm/msg helm/data-ana helm/ai
 
-## 当前文件
+# 渲染模板（不实际部署）
+helm template edu-platform ./helm/edu-platform
+helm template api-gateway ./helm/api-gateway
+```
 
-- `namespace.yaml`：4 个命名空间定义
-- `api-gateway-deployment.yaml`：api-gateway Deployment + Service 骨架
+## 环境差异
+
+| 环境    | values 文件         | 副本数 | HPA  | TLS  |
+| ------- | ------------------- | ------ | ---- | ---- |
+| dev     | values-dev.yaml     | 1      | 关闭 | 关闭 |
+| staging | values-staging.yaml | 2      | 2-5  | 开启 |
+| prod    | values-prod.yaml    | 3      | 3-20 | 开启 |
+
+## 敏感配置
+
+⚠️ **生产环境禁止在 values.yaml 中硬编码密钥**。
+
+推荐方案：
+
+1. 使用 [External Secrets Operator](https://external-secrets.io/) 对接 Vault / KMS / 云 KMS
+2. 通过 `--set secret.data.<KEY>=<base64>` 临时注入
+3. 通过 ArgoCD / Flux GitOps + Sealed Secrets
+
+## 后续路线
+
+- [ ] 接入 External Secrets Operator
+- [ ] ArgoCD / Flux GitOps 部署
+- [ ] 各服务 chart 补充 configmap.yaml / hpa.yaml 模板（当前桩仅含 deployment/service）
+- [ ] 服务级 values-dev/staging/prod 覆盖文件
+- [ ] CI/CD 集成（helm chart 推送到 OCI registry）

infra/k8s/api-gateway-deployment.yaml

@@ -1,125 +0,0 @@
-# api-gateway Deployment + Service 骨架
-# 生产环境请通过 Helm Chart 管理，此处仅作骨架参考
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: api-gateway
-  namespace: edu-services
-  labels:
-    app.kubernetes.io/name: api-gateway
-    app.kubernetes.io/part-of: edu-platform
-    app.kubernetes.io/component: gateway
-spec:
-  replicas: 2
-  selector:
-    matchLabels:
-      app.kubernetes.io/name: api-gateway
-  strategy:
-    type: RollingUpdate
-    rollingUpdate:
-      maxSurge: 1
-      maxUnavailable: 0
-  template:
-    metadata:
-      labels:
-        app.kubernetes.io/name: api-gateway
-        app.kubernetes.io/part-of: edu-platform
-        app.kubernetes.io/component: gateway
-      annotations:
-        prometheus.io/scrape: "true"
-        prometheus.io/port: "8080"
-        prometheus.io/path: "/metrics"
-    spec:
-      containers:
-        - name: api-gateway
-          image: edu/api-gateway:latest  # 生产请固定 tag，避免 latest
-          imagePullPolicy: IfNotPresent
-          ports:
-            - name: http
-              containerPort: 8080
-              protocol: TCP
-          # 存活探针：失败触发重启
-          livenessProbe:
-            httpGet:
-              path: /healthz
-              port: http
-            initialDelaySeconds: 15
-            periodSeconds: 20
-            timeoutSeconds: 3
-            failureThreshold: 3
-          # 就绪探针：失败从 Service Endpoints 摘除
-          readinessProbe:
-            httpGet:
-              path: /readyz
-              port: http
-            initialDelaySeconds: 5
-            periodSeconds: 10
-            timeoutSeconds: 3
-            failureThreshold: 2
-          resources:
-            requests:
-              cpu: "250m"
-              memory: "256Mi"
-            limits:
-              cpu: "1000m"
-              memory: "1Gi"
-          env:
-            # 从 ConfigMap 引用非敏感配置
-            - name: NODE_ENV
-              valueFrom:
-                configMapKeyRef:
-                  name: api-gateway-config
-                  key: NODE_ENV
-            - name: LOG_LEVEL
-              valueFrom:
-                configMapKeyRef:
-                  name: api-gateway-config
-                  key: LOG_LEVEL
-            - name: MYSQL_HOST
-              valueFrom:
-                configMapKeyRef:
-                  name: api-gateway-config
-                  key: MYSQL_HOST
-            # 从 Secret 引用敏感配置
-            - name: MYSQL_PASSWORD
-              valueFrom:
-                secretKeyRef:
-                  name: api-gateway-secret
-                  key: MYSQL_PASSWORD
-            - name: JWT_SECRET
-              valueFrom:
-                secretKeyRef:
-                  name: api-gateway-secret
-                  key: JWT_SECRET
-            - name: REDIS_PASSWORD
-              valueFrom:
-                secretKeyRef:
-                  name: api-gateway-secret
-                  key: REDIS_PASSWORD
-          # 生产建议挂载 /tmp 并设置 readOnlyRootFilesystem: true
-          securityContext:
-            runAsNonRoot: true
-            runAsUser: 1000
-            allowPrivilegeEscalation: false
-            capabilities:
-              drop: ["ALL"]
----
-# api-gateway Service（ClusterIP）
-apiVersion: v1
-kind: Service
-metadata:
-  name: api-gateway
-  namespace: edu-services
-  labels:
-    app.kubernetes.io/name: api-gateway
-    app.kubernetes.io/part-of: edu-platform
-    app.kubernetes.io/component: gateway
-spec:
-  type: ClusterIP
-  selector:
-    app.kubernetes.io/name: api-gateway
-  ports:
-    - name: http
-      port: 8080
-      targetPort: http
-      protocol: TCP

infra/k8s/helm/ai/Chart.yaml

@@ -0,0 +1,11 @@
+apiVersion: v2
+name: ai
+description: ai 服务级 Helm Chart
+type: application
+version: 0.1.0
+appVersion: "1.0.0"
+keywords:
+  - edu
+  - ai
+maintainers:
+  - name: edu-arch

infra/k8s/helm/ai/templates/_helpers.tpl

@@ -0,0 +1,29 @@
+{{- define "ai.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{- define "ai.fullname" -}}
+{{- if .Values.fullnameOverride -}}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- $name := default .Chart.Name .Values.nameOverride -}}
+{{- if contains $name .Release.Name -}}
+{{- .Release.Name | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+{{- end -}}
+{{- end -}}
+
+{{- define "ai.labels" -}}
+helm.sh/chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}
+{{ include "ai.selectorLabels" . }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+app.kubernetes.io/part-of: edu-platform
+app.kubernetes.io/component: ai-gateway
+{{- end -}}
+
+{{- define "ai.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "ai.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end -}}

infra/k8s/helm/ai/templates/deployment.yaml

@@ -0,0 +1,77 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "ai.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "ai.labels" . | nindent 4 }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      {{- include "ai.selectorLabels" . | nindent 6 }}
+  strategy:
+    type: {{ .Values.strategy.type }}
+    rollingUpdate:
+      maxSurge: {{ .Values.strategy.maxSurge }}
+      maxUnavailable: {{ .Values.strategy.maxUnavailable }}
+  template:
+    metadata:
+      labels:
+        {{- include "ai.selectorLabels" . | nindent 8 }}
+        app.kubernetes.io/part-of: edu-platform
+        app.kubernetes.io/component: ai-gateway
+      {{- if .Values.metrics.enabled }}
+      annotations:
+        prometheus.io/scrape: "true"
+        prometheus.io/port: {{ .Values.metrics.port | quote }}
+        prometheus.io/path: {{ .Values.metrics.path | quote }}
+      {{- end }}
+    spec:
+      containers:
+        - name: {{ include "ai.name" . }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: {{ .Values.service.targetPort }}
+              protocol: TCP
+          livenessProbe:
+            httpGet:
+              path: {{ .Values.probes.liveness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.liveness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.liveness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.liveness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.liveness.failureThreshold }}
+          readinessProbe:
+            httpGet:
+              path: {{ .Values.probes.readiness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.readiness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.readiness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.readiness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.readiness.failureThreshold }}
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+          env:
+            {{- if .Values.configMap.enabled }}
+            {{- range $k, $v := .Values.configMap.data }}
+            - name: {{ $k }}
+              valueFrom:
+                configMapKeyRef:
+                  name: {{ include "ai.name" $ }}-config
+                  key: {{ $k }}
+            {{- end }}
+            {{- end }}
+            {{- range $secret := .Values.secretRefs }}
+            {{- range $key := $secret.keys }}
+            - name: {{ $key }}
+              valueFrom:
+                secretKeyRef:
+                  name: {{ $secret.name }}
+                  key: {{ $key }}
+            {{- end }}
+            {{- end }}
+          securityContext:
+            {{- toYaml .Values.securityContext | nindent 12 }}

infra/k8s/helm/ai/templates/service.yaml

@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "ai.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "ai.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  selector:
+    {{- include "ai.selectorLabels" . | nindent 4 }}
+  ports:
+    - name: http
+      port: {{ .Values.service.port }}
+      targetPort: http
+      protocol: TCP

infra/k8s/helm/ai/values.yaml

@@ -0,0 +1,85 @@
+# ai 服务默认值（AI 网关 - 业务领域 D6）
+
+# 副本数（生产建议 ≥ 2）
+replicaCount: 2
+
+image:
+  repository: edu/ai
+  tag: latest  # 生产请固定 tag，避免 latest
+  pullPolicy: IfNotPresent
+
+# 服务端口
+service:
+  type: ClusterIP
+  port: 3006
+  targetPort: 3006
+
+# 命名空间（默认 edu-services，由 edu-platform chart 创建）
+namespace: edu-services
+
+# 探针配置
+probes:
+  liveness:
+    path: /healthz
+    initialDelaySeconds: 15
+    periodSeconds: 20
+    timeoutSeconds: 3
+    failureThreshold: 3
+  readiness:
+    path: /readyz
+    initialDelaySeconds: 5
+    periodSeconds: 10
+    timeoutSeconds: 3
+    failureThreshold: 2
+
+# 资源配额
+resources:
+  requests:
+    cpu: 250m
+    memory: 256Mi
+  limits:
+    cpu: 1000m
+    memory: 1Gi
+
+# 滚动更新策略
+strategy:
+  type: RollingUpdate
+  maxSurge: 1
+  maxUnavailable: 0
+
+# Prometheus 指标采集
+metrics:
+  enabled: true
+  port: 3006
+  path: /metrics
+
+# 安全上下文
+securityContext:
+  runAsNonRoot: true
+  runAsUser: 1000
+  allowPrivilegeEscalation: false
+  capabilities:
+    drop: ["ALL"]
+
+# 服务级 ConfigMap（非敏感配置）
+configMap:
+  enabled: true
+  data:
+    NODE_ENV: production
+    LOG_LEVEL: info
+
+# HPA
+hpa:
+  enabled: true
+  minReplicas: 2
+  maxReplicas: 10
+  targetCPUUtilizationPercentage: 70
+  targetMemoryUtilizationPercentage: 80
+
+# 敏感配置（从 Secret 引用，Secret 由 edu-platform chart 或 ExternalSecrets 管理）
+secretRefs:
+  - name: edu-platform-secret
+    keys:
+      - MYSQL_PASSWORD
+      - JWT_SECRET
+      - REDIS_PASSWORD

infra/k8s/helm/api-gateway/Chart.yaml

@@ -0,0 +1,12 @@
+apiVersion: v2
+name: api-gateway
+description: api-gateway 服务级 Helm Chart（从 infra/k8s/api-gateway-deployment.yaml 迁移）
+type: application
+version: 0.1.0
+appVersion: "1.0.0"
+keywords:
+  - edu
+  - gateway
+  - api
+maintainers:
+  - name: edu-arch

infra/k8s/helm/api-gateway/templates/_helpers.tpl

@@ -0,0 +1,29 @@
+{{- define "api-gateway.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{- define "api-gateway.fullname" -}}
+{{- if .Values.fullnameOverride -}}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- $name := default .Chart.Name .Values.nameOverride -}}
+{{- if contains $name .Release.Name -}}
+{{- .Release.Name | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+{{- end -}}
+{{- end -}}
+
+{{- define "api-gateway.labels" -}}
+helm.sh/chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}
+{{ include "api-gateway.selectorLabels" . }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+app.kubernetes.io/part-of: edu-platform
+app.kubernetes.io/component: gateway
+{{- end -}}
+
+{{- define "api-gateway.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "api-gateway.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end -}}

infra/k8s/helm/api-gateway/templates/configmap.yaml

@@ -0,0 +1,13 @@
+{{- if .Values.configMap.enabled }}
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: {{ include "api-gateway.name" . }}-config
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "api-gateway.labels" . | nindent 4 }}
+data:
+{{- range $k, $v := .Values.configMap.data }}
+  {{ $k }}: {{ $v | quote }}
+{{- end }}
+{{- end }}

infra/k8s/helm/api-gateway/templates/deployment.yaml

@@ -0,0 +1,77 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "api-gateway.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "api-gateway.labels" . | nindent 4 }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      {{- include "api-gateway.selectorLabels" . | nindent 6 }}
+  strategy:
+    type: {{ .Values.strategy.type }}
+    rollingUpdate:
+      maxSurge: {{ .Values.strategy.maxSurge }}
+      maxUnavailable: {{ .Values.strategy.maxUnavailable }}
+  template:
+    metadata:
+      labels:
+        {{- include "api-gateway.selectorLabels" . | nindent 8 }}
+        app.kubernetes.io/part-of: edu-platform
+        app.kubernetes.io/component: gateway
+      {{- if .Values.metrics.enabled }}
+      annotations:
+        prometheus.io/scrape: "true"
+        prometheus.io/port: {{ .Values.metrics.port | quote }}
+        prometheus.io/path: {{ .Values.metrics.path | quote }}
+      {{- end }}
+    spec:
+      containers:
+        - name: {{ include "api-gateway.name" . }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: {{ .Values.service.targetPort }}
+              protocol: TCP
+          livenessProbe:
+            httpGet:
+              path: {{ .Values.probes.liveness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.liveness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.liveness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.liveness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.liveness.failureThreshold }}
+          readinessProbe:
+            httpGet:
+              path: {{ .Values.probes.readiness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.readiness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.readiness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.readiness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.readiness.failureThreshold }}
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+          env:
+            {{- if .Values.configMap.enabled }}
+            {{- range $k, $v := .Values.configMap.data }}
+            - name: {{ $k }}
+              valueFrom:
+                configMapKeyRef:
+                  name: {{ include "api-gateway.name" $ }}-config
+                  key: {{ $k }}
+            {{- end }}
+            {{- end }}
+            {{- range $secret := .Values.secretRefs }}
+            {{- range $key := $secret.keys }}
+            - name: {{ $key }}
+              valueFrom:
+                secretKeyRef:
+                  name: {{ $secret.name }}
+                  key: {{ $key }}
+            {{- end }}
+            {{- end }}
+          securityContext:
+            {{- toYaml .Values.securityContext | nindent 12 }}

infra/k8s/helm/api-gateway/templates/hpa.yaml

@@ -0,0 +1,29 @@
+{{- if .Values.hpa.enabled }}
+apiVersion: autoscaling/v2
+kind: HorizontalPodAutoscaler
+metadata:
+  name: {{ include "api-gateway.name" . }}-hpa
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "api-gateway.labels" . | nindent 4 }}
+spec:
+  scaleTargetRef:
+    apiVersion: apps/v1
+    kind: Deployment
+    name: {{ include "api-gateway.name" . }}
+  minReplicas: {{ .Values.hpa.minReplicas }}
+  maxReplicas: {{ .Values.hpa.maxReplicas }}
+  metrics:
+    - type: Resource
+      resource:
+        name: cpu
+        target:
+          type: Utilization
+          averageUtilization: {{ .Values.hpa.targetCPUUtilizationPercentage }}
+    - type: Resource
+      resource:
+        name: memory
+        target:
+          type: Utilization
+          averageUtilization: {{ .Values.hpa.targetMemoryUtilizationPercentage }}
+{{- end }}

infra/k8s/helm/api-gateway/templates/service.yaml

@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "api-gateway.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "api-gateway.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  selector:
+    {{- include "api-gateway.selectorLabels" . | nindent 4 }}
+  ports:
+    - name: http
+      port: {{ .Values.service.port }}
+      targetPort: http
+      protocol: TCP

infra/k8s/helm/api-gateway/values.yaml

@@ -0,0 +1,86 @@
+# api-gateway 服务默认值
+
+# 副本数（生产建议 ≥ 2）
+replicaCount: 2
+
+image:
+  repository: edu/api-gateway
+  tag: latest  # 生产请固定 tag，避免 latest
+  pullPolicy: IfNotPresent
+
+# 服务端口
+service:
+  type: ClusterIP
+  port: 8080
+  targetPort: 8080
+
+# 命名空间（默认 edu-services，由 edu-platform chart 创建）
+namespace: edu-services
+
+# 探针配置
+probes:
+  liveness:
+    path: /healthz
+    initialDelaySeconds: 15
+    periodSeconds: 20
+    timeoutSeconds: 3
+    failureThreshold: 3
+  readiness:
+    path: /readyz
+    initialDelaySeconds: 5
+    periodSeconds: 10
+    timeoutSeconds: 3
+    failureThreshold: 2
+
+# 资源配额
+resources:
+  requests:
+    cpu: 250m
+    memory: 256Mi
+  limits:
+    cpu: 1000m
+    memory: 1Gi
+
+# 滚动更新策略
+strategy:
+  type: RollingUpdate
+  maxSurge: 1
+  maxUnavailable: 0
+
+# Prometheus 指标采集
+metrics:
+  enabled: true
+  port: 8080
+  path: /metrics
+
+# 安全上下文
+securityContext:
+  runAsNonRoot: true
+  runAsUser: 1000
+  allowPrivilegeEscalation: false
+  capabilities:
+    drop: ["ALL"]
+
+# 服务级 ConfigMap（非敏感配置）
+configMap:
+  enabled: true
+  data:
+    NODE_ENV: production
+    LOG_LEVEL: info
+    MYSQL_HOST: mysql.edu-system.svc.cluster.local
+
+# HPA
+hpa:
+  enabled: true
+  minReplicas: 2
+  maxReplicas: 10
+  targetCPUUtilizationPercentage: 70
+  targetMemoryUtilizationPercentage: 80
+
+# 敏感配置（从 Secret 引用，Secret 由 edu-platform chart 或 ExternalSecrets 管理）
+secretRefs:
+  - name: edu-platform-secret
+    keys:
+      - MYSQL_PASSWORD
+      - JWT_SECRET
+      - REDIS_PASSWORD

infra/k8s/helm/content/Chart.yaml

@@ -0,0 +1,11 @@
+apiVersion: v2
+name: content
+description: content 服务级 Helm Chart
+type: application
+version: 0.1.0
+appVersion: "1.0.0"
+keywords:
+  - edu
+  - content
+maintainers:
+  - name: edu-arch

infra/k8s/helm/content/templates/_helpers.tpl

@@ -0,0 +1,29 @@
+{{- define "content.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{- define "content.fullname" -}}
+{{- if .Values.fullnameOverride -}}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- $name := default .Chart.Name .Values.nameOverride -}}
+{{- if contains $name .Release.Name -}}
+{{- .Release.Name | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+{{- end -}}
+{{- end -}}
+
+{{- define "content.labels" -}}
+helm.sh/chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}
+{{ include "content.selectorLabels" . }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+app.kubernetes.io/part-of: edu-platform
+app.kubernetes.io/component: content
+{{- end -}}
+
+{{- define "content.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "content.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end -}}

infra/k8s/helm/content/templates/deployment.yaml

@@ -0,0 +1,77 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "content.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "content.labels" . | nindent 4 }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      {{- include "content.selectorLabels" . | nindent 6 }}
+  strategy:
+    type: {{ .Values.strategy.type }}
+    rollingUpdate:
+      maxSurge: {{ .Values.strategy.maxSurge }}
+      maxUnavailable: {{ .Values.strategy.maxUnavailable }}
+  template:
+    metadata:
+      labels:
+        {{- include "content.selectorLabels" . | nindent 8 }}
+        app.kubernetes.io/part-of: edu-platform
+        app.kubernetes.io/component: content
+      {{- if .Values.metrics.enabled }}
+      annotations:
+        prometheus.io/scrape: "true"
+        prometheus.io/port: {{ .Values.metrics.port | quote }}
+        prometheus.io/path: {{ .Values.metrics.path | quote }}
+      {{- end }}
+    spec:
+      containers:
+        - name: {{ include "content.name" . }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: {{ .Values.service.targetPort }}
+              protocol: TCP
+          livenessProbe:
+            httpGet:
+              path: {{ .Values.probes.liveness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.liveness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.liveness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.liveness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.liveness.failureThreshold }}
+          readinessProbe:
+            httpGet:
+              path: {{ .Values.probes.readiness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.readiness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.readiness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.readiness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.readiness.failureThreshold }}
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+          env:
+            {{- if .Values.configMap.enabled }}
+            {{- range $k, $v := .Values.configMap.data }}
+            - name: {{ $k }}
+              valueFrom:
+                configMapKeyRef:
+                  name: {{ include "content.name" $ }}-config
+                  key: {{ $k }}
+            {{- end }}
+            {{- end }}
+            {{- range $secret := .Values.secretRefs }}
+            {{- range $key := $secret.keys }}
+            - name: {{ $key }}
+              valueFrom:
+                secretKeyRef:
+                  name: {{ $secret.name }}
+                  key: {{ $key }}
+            {{- end }}
+            {{- end }}
+          securityContext:
+            {{- toYaml .Values.securityContext | nindent 12 }}

infra/k8s/helm/content/templates/service.yaml

@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "content.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "content.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  selector:
+    {{- include "content.selectorLabels" . | nindent 4 }}
+  ports:
+    - name: http
+      port: {{ .Values.service.port }}
+      targetPort: http
+      protocol: TCP

infra/k8s/helm/content/values.yaml

@@ -0,0 +1,85 @@
+# content 服务默认值（内容资源 - 业务领域 D4）
+
+# 副本数（生产建议 ≥ 2）
+replicaCount: 2
+
+image:
+  repository: edu/content
+  tag: latest  # 生产请固定 tag，避免 latest
+  pullPolicy: IfNotPresent
+
+# 服务端口
+service:
+  type: ClusterIP
+  port: 3003
+  targetPort: 3003
+
+# 命名空间（默认 edu-services，由 edu-platform chart 创建）
+namespace: edu-services
+
+# 探针配置
+probes:
+  liveness:
+    path: /healthz
+    initialDelaySeconds: 15
+    periodSeconds: 20
+    timeoutSeconds: 3
+    failureThreshold: 3
+  readiness:
+    path: /readyz
+    initialDelaySeconds: 5
+    periodSeconds: 10
+    timeoutSeconds: 3
+    failureThreshold: 2
+
+# 资源配额
+resources:
+  requests:
+    cpu: 250m
+    memory: 256Mi
+  limits:
+    cpu: 1000m
+    memory: 1Gi
+
+# 滚动更新策略
+strategy:
+  type: RollingUpdate
+  maxSurge: 1
+  maxUnavailable: 0
+
+# Prometheus 指标采集
+metrics:
+  enabled: true
+  port: 3003
+  path: /metrics
+
+# 安全上下文
+securityContext:
+  runAsNonRoot: true
+  runAsUser: 1000
+  allowPrivilegeEscalation: false
+  capabilities:
+    drop: ["ALL"]
+
+# 服务级 ConfigMap（非敏感配置）
+configMap:
+  enabled: true
+  data:
+    NODE_ENV: production
+    LOG_LEVEL: info
+
+# HPA
+hpa:
+  enabled: true
+  minReplicas: 2
+  maxReplicas: 10
+  targetCPUUtilizationPercentage: 70
+  targetMemoryUtilizationPercentage: 80
+
+# 敏感配置（从 Secret 引用，Secret 由 edu-platform chart 或 ExternalSecrets 管理）
+secretRefs:
+  - name: edu-platform-secret
+    keys:
+      - MYSQL_PASSWORD
+      - JWT_SECRET
+      - REDIS_PASSWORD

infra/k8s/helm/core-edu/Chart.yaml

@@ -0,0 +1,11 @@
+apiVersion: v2
+name: core-edu
+description: core-edu 服务级 Helm Chart
+type: application
+version: 0.1.0
+appVersion: "1.0.0"
+keywords:
+  - edu
+  - core-edu
+maintainers:
+  - name: edu-arch

infra/k8s/helm/core-edu/templates/_helpers.tpl

@@ -0,0 +1,29 @@
+{{- define "core-edu.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{- define "core-edu.fullname" -}}
+{{- if .Values.fullnameOverride -}}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- $name := default .Chart.Name .Values.nameOverride -}}
+{{- if contains $name .Release.Name -}}
+{{- .Release.Name | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+{{- end -}}
+{{- end -}}
+
+{{- define "core-edu.labels" -}}
+helm.sh/chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}
+{{ include "core-edu.selectorLabels" . }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+app.kubernetes.io/part-of: edu-platform
+app.kubernetes.io/component: teaching
+{{- end -}}
+
+{{- define "core-edu.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "core-edu.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end -}}

infra/k8s/helm/core-edu/templates/deployment.yaml

@@ -0,0 +1,77 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "core-edu.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "core-edu.labels" . | nindent 4 }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      {{- include "core-edu.selectorLabels" . | nindent 6 }}
+  strategy:
+    type: {{ .Values.strategy.type }}
+    rollingUpdate:
+      maxSurge: {{ .Values.strategy.maxSurge }}
+      maxUnavailable: {{ .Values.strategy.maxUnavailable }}
+  template:
+    metadata:
+      labels:
+        {{- include "core-edu.selectorLabels" . | nindent 8 }}
+        app.kubernetes.io/part-of: edu-platform
+        app.kubernetes.io/component: teaching
+      {{- if .Values.metrics.enabled }}
+      annotations:
+        prometheus.io/scrape: "true"
+        prometheus.io/port: {{ .Values.metrics.port | quote }}
+        prometheus.io/path: {{ .Values.metrics.path | quote }}
+      {{- end }}
+    spec:
+      containers:
+        - name: {{ include "core-edu.name" . }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: {{ .Values.service.targetPort }}
+              protocol: TCP
+          livenessProbe:
+            httpGet:
+              path: {{ .Values.probes.liveness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.liveness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.liveness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.liveness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.liveness.failureThreshold }}
+          readinessProbe:
+            httpGet:
+              path: {{ .Values.probes.readiness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.readiness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.readiness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.readiness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.readiness.failureThreshold }}
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+          env:
+            {{- if .Values.configMap.enabled }}
+            {{- range $k, $v := .Values.configMap.data }}
+            - name: {{ $k }}
+              valueFrom:
+                configMapKeyRef:
+                  name: {{ include "core-edu.name" $ }}-config
+                  key: {{ $k }}
+            {{- end }}
+            {{- end }}
+            {{- range $secret := .Values.secretRefs }}
+            {{- range $key := $secret.keys }}
+            - name: {{ $key }}
+              valueFrom:
+                secretKeyRef:
+                  name: {{ $secret.name }}
+                  key: {{ $key }}
+            {{- end }}
+            {{- end }}
+          securityContext:
+            {{- toYaml .Values.securityContext | nindent 12 }}

infra/k8s/helm/core-edu/templates/service.yaml

@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "core-edu.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "core-edu.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  selector:
+    {{- include "core-edu.selectorLabels" . | nindent 4 }}
+  ports:
+    - name: http
+      port: {{ .Values.service.port }}
+      targetPort: http
+      protocol: TCP

infra/k8s/helm/core-edu/values.yaml

@@ -0,0 +1,85 @@
+# core-edu 服务默认值（教学核心 - 业务领域 D2+D3）
+
+# 副本数（生产建议 ≥ 2）
+replicaCount: 2
+
+image:
+  repository: edu/core-edu
+  tag: latest  # 生产请固定 tag，避免 latest
+  pullPolicy: IfNotPresent
+
+# 服务端口
+service:
+  type: ClusterIP
+  port: 3002
+  targetPort: 3002
+
+# 命名空间（默认 edu-services，由 edu-platform chart 创建）
+namespace: edu-services
+
+# 探针配置
+probes:
+  liveness:
+    path: /healthz
+    initialDelaySeconds: 15
+    periodSeconds: 20
+    timeoutSeconds: 3
+    failureThreshold: 3
+  readiness:
+    path: /readyz
+    initialDelaySeconds: 5
+    periodSeconds: 10
+    timeoutSeconds: 3
+    failureThreshold: 2
+
+# 资源配额
+resources:
+  requests:
+    cpu: 250m
+    memory: 256Mi
+  limits:
+    cpu: 1000m
+    memory: 1Gi
+
+# 滚动更新策略
+strategy:
+  type: RollingUpdate
+  maxSurge: 1
+  maxUnavailable: 0
+
+# Prometheus 指标采集
+metrics:
+  enabled: true
+  port: 3002
+  path: /metrics
+
+# 安全上下文
+securityContext:
+  runAsNonRoot: true
+  runAsUser: 1000
+  allowPrivilegeEscalation: false
+  capabilities:
+    drop: ["ALL"]
+
+# 服务级 ConfigMap（非敏感配置）
+configMap:
+  enabled: true
+  data:
+    NODE_ENV: production
+    LOG_LEVEL: info
+
+# HPA
+hpa:
+  enabled: true
+  minReplicas: 2
+  maxReplicas: 10
+  targetCPUUtilizationPercentage: 70
+  targetMemoryUtilizationPercentage: 80
+
+# 敏感配置（从 Secret 引用，Secret 由 edu-platform chart 或 ExternalSecrets 管理）
+secretRefs:
+  - name: edu-platform-secret
+    keys:
+      - MYSQL_PASSWORD
+      - JWT_SECRET
+      - REDIS_PASSWORD

infra/k8s/helm/data-ana/Chart.yaml

@@ -0,0 +1,11 @@
+apiVersion: v2
+name: data-ana
+description: data-ana 服务级 Helm Chart
+type: application
+version: 0.1.0
+appVersion: "1.0.0"
+keywords:
+  - edu
+  - data-ana
+maintainers:
+  - name: edu-arch

infra/k8s/helm/data-ana/templates/_helpers.tpl

@@ -0,0 +1,29 @@
+{{- define "data-ana.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{- define "data-ana.fullname" -}}
+{{- if .Values.fullnameOverride -}}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- $name := default .Chart.Name .Values.nameOverride -}}
+{{- if contains $name .Release.Name -}}
+{{- .Release.Name | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+{{- end -}}
+{{- end -}}
+
+{{- define "data-ana.labels" -}}
+helm.sh/chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}
+{{ include "data-ana.selectorLabels" . }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+app.kubernetes.io/part-of: edu-platform
+app.kubernetes.io/component: analytics
+{{- end -}}
+
+{{- define "data-ana.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "data-ana.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end -}}

infra/k8s/helm/data-ana/templates/deployment.yaml

@@ -0,0 +1,77 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "data-ana.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "data-ana.labels" . | nindent 4 }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      {{- include "data-ana.selectorLabels" . | nindent 6 }}
+  strategy:
+    type: {{ .Values.strategy.type }}
+    rollingUpdate:
+      maxSurge: {{ .Values.strategy.maxSurge }}
+      maxUnavailable: {{ .Values.strategy.maxUnavailable }}
+  template:
+    metadata:
+      labels:
+        {{- include "data-ana.selectorLabels" . | nindent 8 }}
+        app.kubernetes.io/part-of: edu-platform
+        app.kubernetes.io/component: analytics
+      {{- if .Values.metrics.enabled }}
+      annotations:
+        prometheus.io/scrape: "true"
+        prometheus.io/port: {{ .Values.metrics.port | quote }}
+        prometheus.io/path: {{ .Values.metrics.path | quote }}
+      {{- end }}
+    spec:
+      containers:
+        - name: {{ include "data-ana.name" . }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: {{ .Values.service.targetPort }}
+              protocol: TCP
+          livenessProbe:
+            httpGet:
+              path: {{ .Values.probes.liveness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.liveness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.liveness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.liveness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.liveness.failureThreshold }}
+          readinessProbe:
+            httpGet:
+              path: {{ .Values.probes.readiness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.readiness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.readiness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.readiness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.readiness.failureThreshold }}
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+          env:
+            {{- if .Values.configMap.enabled }}
+            {{- range $k, $v := .Values.configMap.data }}
+            - name: {{ $k }}
+              valueFrom:
+                configMapKeyRef:
+                  name: {{ include "data-ana.name" $ }}-config
+                  key: {{ $k }}
+            {{- end }}
+            {{- end }}
+            {{- range $secret := .Values.secretRefs }}
+            {{- range $key := $secret.keys }}
+            - name: {{ $key }}
+              valueFrom:
+                secretKeyRef:
+                  name: {{ $secret.name }}
+                  key: {{ $key }}
+            {{- end }}
+            {{- end }}
+          securityContext:
+            {{- toYaml .Values.securityContext | nindent 12 }}

infra/k8s/helm/data-ana/templates/service.yaml

@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "data-ana.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "data-ana.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  selector:
+    {{- include "data-ana.selectorLabels" . | nindent 4 }}
+  ports:
+    - name: http
+      port: {{ .Values.service.port }}
+      targetPort: http
+      protocol: TCP

infra/k8s/helm/data-ana/values.yaml

@@ -0,0 +1,85 @@
+# data-ana 服务默认值（数据分析 - 业务领域 D6）
+
+# 副本数（生产建议 ≥ 2）
+replicaCount: 2
+
+image:
+  repository: edu/data-ana
+  tag: latest  # 生产请固定 tag，避免 latest
+  pullPolicy: IfNotPresent
+
+# 服务端口
+service:
+  type: ClusterIP
+  port: 3005
+  targetPort: 3005
+
+# 命名空间（默认 edu-services，由 edu-platform chart 创建）
+namespace: edu-services
+
+# 探针配置
+probes:
+  liveness:
+    path: /healthz
+    initialDelaySeconds: 15
+    periodSeconds: 20
+    timeoutSeconds: 3
+    failureThreshold: 3
+  readiness:
+    path: /readyz
+    initialDelaySeconds: 5
+    periodSeconds: 10
+    timeoutSeconds: 3
+    failureThreshold: 2
+
+# 资源配额
+resources:
+  requests:
+    cpu: 250m
+    memory: 256Mi
+  limits:
+    cpu: 1000m
+    memory: 1Gi
+
+# 滚动更新策略
+strategy:
+  type: RollingUpdate
+  maxSurge: 1
+  maxUnavailable: 0
+
+# Prometheus 指标采集
+metrics:
+  enabled: true
+  port: 3005
+  path: /metrics
+
+# 安全上下文
+securityContext:
+  runAsNonRoot: true
+  runAsUser: 1000
+  allowPrivilegeEscalation: false
+  capabilities:
+    drop: ["ALL"]
+
+# 服务级 ConfigMap（非敏感配置）
+configMap:
+  enabled: true
+  data:
+    NODE_ENV: production
+    LOG_LEVEL: info
+
+# HPA
+hpa:
+  enabled: true
+  minReplicas: 2
+  maxReplicas: 10
+  targetCPUUtilizationPercentage: 70
+  targetMemoryUtilizationPercentage: 80
+
+# 敏感配置（从 Secret 引用，Secret 由 edu-platform chart 或 ExternalSecrets 管理）
+secretRefs:
+  - name: edu-platform-secret
+    keys:
+      - MYSQL_PASSWORD
+      - JWT_SECRET
+      - REDIS_PASSWORD

infra/k8s/helm/edu-platform/Chart.yaml

@@ -0,0 +1,12 @@
+apiVersion: v2
+name: edu-platform
+description: Edu 平台级 Helm Chart（命名空间 / 全局 ConfigMap / Secret / Ingress / HPA 模板）
+type: application
+version: 0.1.0
+appVersion: "1.0.0"
+keywords:
+  - edu
+  - platform
+  - infrastructure
+maintainers:
+  - name: edu-arch

infra/k8s/helm/edu-platform/templates/_helpers.tpl

@@ -0,0 +1,42 @@
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "edu-platform.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{/*
+Fully qualified app name.
+*/}}
+{{- define "edu-platform.fullname" -}}
+{{- if .Values.fullnameOverride -}}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- $name := default .Chart.Name .Values.nameOverride -}}
+{{- if contains $name .Release.Name -}}
+{{- .Release.Name | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+{{- end -}}
+{{- end -}}
+
+{{/*
+Common labels.
+*/}}
+{{- define "edu-platform.labels" -}}
+helm.sh/chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}
+{{ include "edu-platform.selectorLabels" . }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- with .Values.global.labels }}
+{{ toYaml . }}
+{{- end -}}
+{{- end -}}
+
+{{/*
+Selector labels.
+*/}}
+{{- define "edu-platform.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "edu-platform.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end -}}

infra/k8s/helm/edu-platform/templates/configmap.yaml

@@ -0,0 +1,13 @@
+{{- if .Values.configMap.enabled }}
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: {{ .Values.configMap.name }}
+  namespace: edu-system
+  labels:
+    {{- include "edu-platform.labels" . | nindent 4 }}
+data:
+{{- range $k, $v := .Values.configMap.data }}
+  {{ $k }}: {{ $v | quote }}
+{{- end }}
+{{- end }}

infra/k8s/helm/edu-platform/templates/hpa.yaml

@@ -0,0 +1,34 @@
+{{/*
+  全局 HPA 模板示例（参考用）。
+  实际 HPA 应在各服务自身的 chart 中定义，以便针对服务特性调参。
+  本模板在 edu-platform 中默认不渲染（hpa.targetService 为空时跳过）。
+*/}}
+{{- if and .Values.hpa.enabled .Values.hpa.targetService }}
+apiVersion: autoscaling/v2
+kind: HorizontalPodAutoscaler
+metadata:
+  name: {{ .Values.hpa.targetService }}-hpa
+  namespace: edu-services
+  labels:
+    {{- include "edu-platform.labels" . | nindent 4 }}
+spec:
+  scaleTargetRef:
+    apiVersion: apps/v1
+    kind: Deployment
+    name: {{ .Values.hpa.targetService }}
+  minReplicas: {{ .Values.hpa.minReplicas }}
+  maxReplicas: {{ .Values.hpa.maxReplicas }}
+  metrics:
+    - type: Resource
+      resource:
+        name: cpu
+        target:
+          type: Utilization
+          averageUtilization: {{ .Values.hpa.targetCPUUtilizationPercentage }}
+    - type: Resource
+      resource:
+        name: memory
+        target:
+          type: Utilization
+          averageUtilization: {{ .Values.hpa.targetMemoryUtilizationPercentage }}
+{{- end }}

infra/k8s/helm/edu-platform/templates/ingress.yaml

@@ -0,0 +1,35 @@
+{{- if .Values.ingress.enabled }}
+{{- range .Values.ingress.hosts }}
+---
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: {{ $.Release.Name }}-ingress
+  namespace: edu-ingress
+  labels:
+    {{- include "edu-platform.labels" $ | nindent 4 }}
+  {{- with $.Values.ingress.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+  ingressClassName: {{ $.Values.ingress.className }}
+  {{- with $.Values.ingress.tls }}
+  tls:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+  rules:
+    - host: {{ .host }}
+      http:
+        paths:
+          {{- range .paths }}
+          - path: {{ .path }}
+            pathType: {{ .pathType }}
+            backend:
+              service:
+                name: {{ .service }}
+                port:
+                  number: {{ .port }}
+          {{- end }}
+{{- end }}
+{{- end }}

infra/k8s/helm/edu-platform/templates/namespace.yaml

@@ -0,0 +1,10 @@
+{{- range .Values.namespaces }}
+---
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: {{ .name }}
+  labels:
+    {{- include "edu-platform.labels" $ | nindent 4 }}
+    app.kubernetes.io/component: {{ .component }}
+{{- end }}

infra/k8s/helm/edu-platform/templates/secret.yaml

@@ -0,0 +1,26 @@
+{{- if .Values.secret.enabled }}
+{{- /*
+  ⚠️ 生产环境警告：不要在 values.yaml 中硬编码真实密钥！
+  推荐方案：使用 External Secrets Operator 对接 Vault / KMS / 云 KMS
+  本模板仅作骨架；空字符串字段不会被渲染（避免覆盖已存在的 Secret）。
+*/ -}}
+apiVersion: v1
+kind: Secret
+metadata:
+  name: {{ .Values.secret.name }}
+  namespace: edu-system
+  labels:
+    {{- include "edu-platform.labels" . | nindent 4 }}
+  annotations:
+    "helm.sh/hook": pre-install
+    "helm.sh/hook-delete-policy": before-hook-creation
+type: Opaque
+data:
+{{- range $k, $v := .Values.secret.data }}
+{{- if $v }}
+  {{ $k }}: {{ $v }}
+{{- else }}
+  {{ $k }}: ""  # 占位：部署时通过 --set 或 ExternalSecrets 注入
+{{- end }}
+{{- end }}
+{{- end }}

infra/k8s/helm/edu-platform/values-dev.yaml

@@ -0,0 +1,24 @@
+# 开发环境覆盖
+global:
+  labels:
+    app.kubernetes.io/part-of: edu-platform
+    app.kubernetes.io/environment: dev
+
+configMap:
+  data:
+    NODE_ENV: development
+    LOG_LEVEL: debug
+
+ingress:
+  enabled: true
+  hosts:
+    - host: edu-dev.local
+      paths:
+        - path: /api
+          pathType: Prefix
+          service: api-gateway
+          port: 8080
+  tls: []  # 开发环境不强制 TLS
+
+hpa:
+  enabled: false  # 开发环境单副本即可

infra/k8s/helm/edu-platform/values-prod.yaml

@@ -0,0 +1,35 @@
+# 生产环境覆盖
+global:
+  labels:
+    app.kubernetes.io/part-of: edu-platform
+    app.kubernetes.io/environment: prod
+  imagePullSecrets:
+    - name: registry-credentials
+
+configMap:
+  data:
+    NODE_ENV: production
+    LOG_LEVEL: warn
+
+ingress:
+  hosts:
+    - host: edu.example.com
+      paths:
+        - path: /api
+          pathType: Prefix
+          service: api-gateway
+          port: 8080
+        - path: /auth
+          pathType: Prefix
+          service: api-gateway
+          port: 8080
+  tls:
+    - secretName: edu-tls
+      hosts:
+        - edu.example.com
+
+hpa:
+  minReplicas: 3
+  maxReplicas: 20
+  targetCPUUtilizationPercentage: 60
+  targetMemoryUtilizationPercentage: 70

infra/k8s/helm/edu-platform/values-staging.yaml

@@ -0,0 +1,23 @@
+# 预发布环境覆盖
+global:
+  labels:
+    app.kubernetes.io/part-of: edu-platform
+    app.kubernetes.io/environment: staging
+
+configMap:
+  data:
+    NODE_ENV: staging
+    LOG_LEVEL: info
+
+ingress:
+  hosts:
+    - host: edu-staging.example.com
+      paths:
+        - path: /api
+          pathType: Prefix
+          service: api-gateway
+          port: 8080
+
+hpa:
+  minReplicas: 2
+  maxReplicas: 5

infra/k8s/helm/edu-platform/values.yaml

@@ -0,0 +1,72 @@
+# Edu 平台全局默认值
+# 环境覆盖文件：values-dev.yaml / values-staging.yaml / values-prod.yaml
+
+# 全局标签（自动注入到所有资源）
+global:
+  labels:
+    app.kubernetes.io/part-of: edu-platform
+  # 镜像拉取凭证（生产建议使用 Secret + serviceAccount）
+  imagePullSecrets: []
+
+# 命名空间规划
+namespaces:
+  - name: edu-system
+    component: system
+  - name: edu-services
+    component: services
+  - name: edu-monitoring
+    component: monitoring
+  - name: edu-ingress
+    component: ingress
+
+# 全局 ConfigMap（非敏感配置）
+configMap:
+  enabled: true
+  name: edu-platform-config
+  data:
+    NODE_ENV: production
+    LOG_LEVEL: info
+    MYSQL_HOST: mysql.edu-system.svc.cluster.local
+    REDIS_HOST: redis.edu-system.svc.cluster.local
+    KAFKA_BROKERS: kafka.edu-system.svc.cluster.local:9092
+
+# 全局 Secret（仅骨架；生产请使用 External Secrets Operator 对接 Vault/KMS）
+secret:
+  enabled: true
+  name: edu-platform-secret
+  # 真实部署时通过 --set secret.data.MYSQL_PASSWORD=<base64> 注入
+  # 或通过 externalSecrets 引用
+  data:
+    MYSQL_PASSWORD: ""
+    JWT_SECRET: ""
+    REDIS_PASSWORD: ""
+
+# 全局 Ingress
+ingress:
+  enabled: true
+  className: nginx
+  annotations:
+    nginx.ingress.kubernetes.io/ssl-redirect: "true"
+  hosts:
+    - host: edu.example.com
+      paths:
+        - path: /api
+          pathType: Prefix
+          service: api-gateway
+          port: 8080
+        - path: /auth
+          pathType: Prefix
+          service: api-gateway
+          port: 8080
+  tls:
+    - secretName: edu-tls
+      hosts:
+        - edu.example.com
+
+# HPA 全局默认策略（各服务可在自身 chart 中覆盖）
+hpa:
+  enabled: true
+  minReplicas: 2
+  maxReplicas: 10
+  targetCPUUtilizationPercentage: 70
+  targetMemoryUtilizationPercentage: 80

infra/k8s/helm/iam/Chart.yaml

@@ -0,0 +1,11 @@
+apiVersion: v2
+name: iam
+description: iam 服务级 Helm Chart
+type: application
+version: 0.1.0
+appVersion: "1.0.0"
+keywords:
+  - edu
+  - iam
+maintainers:
+  - name: edu-arch

infra/k8s/helm/iam/templates/_helpers.tpl

@@ -0,0 +1,29 @@
+{{- define "iam.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{- define "iam.fullname" -}}
+{{- if .Values.fullnameOverride -}}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- $name := default .Chart.Name .Values.nameOverride -}}
+{{- if contains $name .Release.Name -}}
+{{- .Release.Name | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+{{- end -}}
+{{- end -}}
+
+{{- define "iam.labels" -}}
+helm.sh/chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}
+{{ include "iam.selectorLabels" . }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+app.kubernetes.io/part-of: edu-platform
+app.kubernetes.io/component: identity
+{{- end -}}
+
+{{- define "iam.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "iam.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end -}}

infra/k8s/helm/iam/templates/deployment.yaml

@@ -0,0 +1,77 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "iam.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "iam.labels" . | nindent 4 }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      {{- include "iam.selectorLabels" . | nindent 6 }}
+  strategy:
+    type: {{ .Values.strategy.type }}
+    rollingUpdate:
+      maxSurge: {{ .Values.strategy.maxSurge }}
+      maxUnavailable: {{ .Values.strategy.maxUnavailable }}
+  template:
+    metadata:
+      labels:
+        {{- include "iam.selectorLabels" . | nindent 8 }}
+        app.kubernetes.io/part-of: edu-platform
+        app.kubernetes.io/component: identity
+      {{- if .Values.metrics.enabled }}
+      annotations:
+        prometheus.io/scrape: "true"
+        prometheus.io/port: {{ .Values.metrics.port | quote }}
+        prometheus.io/path: {{ .Values.metrics.path | quote }}
+      {{- end }}
+    spec:
+      containers:
+        - name: {{ include "iam.name" . }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: {{ .Values.service.targetPort }}
+              protocol: TCP
+          livenessProbe:
+            httpGet:
+              path: {{ .Values.probes.liveness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.liveness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.liveness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.liveness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.liveness.failureThreshold }}
+          readinessProbe:
+            httpGet:
+              path: {{ .Values.probes.readiness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.readiness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.readiness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.readiness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.readiness.failureThreshold }}
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+          env:
+            {{- if .Values.configMap.enabled }}
+            {{- range $k, $v := .Values.configMap.data }}
+            - name: {{ $k }}
+              valueFrom:
+                configMapKeyRef:
+                  name: {{ include "iam.name" $ }}-config
+                  key: {{ $k }}
+            {{- end }}
+            {{- end }}
+            {{- range $secret := .Values.secretRefs }}
+            {{- range $key := $secret.keys }}
+            - name: {{ $key }}
+              valueFrom:
+                secretKeyRef:
+                  name: {{ $secret.name }}
+                  key: {{ $key }}
+            {{- end }}
+            {{- end }}
+          securityContext:
+            {{- toYaml .Values.securityContext | nindent 12 }}

infra/k8s/helm/iam/templates/service.yaml

@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "iam.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "iam.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  selector:
+    {{- include "iam.selectorLabels" . | nindent 4 }}
+  ports:
+    - name: http
+      port: {{ .Values.service.port }}
+      targetPort: http
+      protocol: TCP

infra/k8s/helm/iam/values.yaml

@@ -0,0 +1,85 @@
+# iam 服务默认值（身份认证 - 业务领域 D1）
+
+# 副本数（生产建议 ≥ 2）
+replicaCount: 2
+
+image:
+  repository: edu/iam
+  tag: latest  # 生产请固定 tag，避免 latest
+  pullPolicy: IfNotPresent
+
+# 服务端口
+service:
+  type: ClusterIP
+  port: 3001
+  targetPort: 3001
+
+# 命名空间（默认 edu-services，由 edu-platform chart 创建）
+namespace: edu-services
+
+# 探针配置
+probes:
+  liveness:
+    path: /healthz
+    initialDelaySeconds: 15
+    periodSeconds: 20
+    timeoutSeconds: 3
+    failureThreshold: 3
+  readiness:
+    path: /readyz
+    initialDelaySeconds: 5
+    periodSeconds: 10
+    timeoutSeconds: 3
+    failureThreshold: 2
+
+# 资源配额
+resources:
+  requests:
+    cpu: 250m
+    memory: 256Mi
+  limits:
+    cpu: 1000m
+    memory: 1Gi
+
+# 滚动更新策略
+strategy:
+  type: RollingUpdate
+  maxSurge: 1
+  maxUnavailable: 0
+
+# Prometheus 指标采集
+metrics:
+  enabled: true
+  port: 3001
+  path: /metrics
+
+# 安全上下文
+securityContext:
+  runAsNonRoot: true
+  runAsUser: 1000
+  allowPrivilegeEscalation: false
+  capabilities:
+    drop: ["ALL"]
+
+# 服务级 ConfigMap（非敏感配置）
+configMap:
+  enabled: true
+  data:
+    NODE_ENV: production
+    LOG_LEVEL: info
+
+# HPA
+hpa:
+  enabled: true
+  minReplicas: 2
+  maxReplicas: 10
+  targetCPUUtilizationPercentage: 70
+  targetMemoryUtilizationPercentage: 80
+
+# 敏感配置（从 Secret 引用，Secret 由 edu-platform chart 或 ExternalSecrets 管理）
+secretRefs:
+  - name: edu-platform-secret
+    keys:
+      - MYSQL_PASSWORD
+      - JWT_SECRET
+      - REDIS_PASSWORD

infra/k8s/helm/msg/Chart.yaml

@@ -0,0 +1,11 @@
+apiVersion: v2
+name: msg
+description: msg 服务级 Helm Chart
+type: application
+version: 0.1.0
+appVersion: "1.0.0"
+keywords:
+  - edu
+  - msg
+maintainers:
+  - name: edu-arch

infra/k8s/helm/msg/templates/_helpers.tpl

@@ -0,0 +1,29 @@
+{{- define "msg.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{- define "msg.fullname" -}}
+{{- if .Values.fullnameOverride -}}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- $name := default .Chart.Name .Values.nameOverride -}}
+{{- if contains $name .Release.Name -}}
+{{- .Release.Name | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+{{- end -}}
+{{- end -}}
+
+{{- define "msg.labels" -}}
+helm.sh/chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}
+{{ include "msg.selectorLabels" . }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+app.kubernetes.io/part-of: edu-platform
+app.kubernetes.io/component: messaging
+{{- end -}}
+
+{{- define "msg.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "msg.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end -}}

infra/k8s/helm/msg/templates/deployment.yaml

@@ -0,0 +1,77 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "msg.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "msg.labels" . | nindent 4 }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      {{- include "msg.selectorLabels" . | nindent 6 }}
+  strategy:
+    type: {{ .Values.strategy.type }}
+    rollingUpdate:
+      maxSurge: {{ .Values.strategy.maxSurge }}
+      maxUnavailable: {{ .Values.strategy.maxUnavailable }}
+  template:
+    metadata:
+      labels:
+        {{- include "msg.selectorLabels" . | nindent 8 }}
+        app.kubernetes.io/part-of: edu-platform
+        app.kubernetes.io/component: messaging
+      {{- if .Values.metrics.enabled }}
+      annotations:
+        prometheus.io/scrape: "true"
+        prometheus.io/port: {{ .Values.metrics.port | quote }}
+        prometheus.io/path: {{ .Values.metrics.path | quote }}
+      {{- end }}
+    spec:
+      containers:
+        - name: {{ include "msg.name" . }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: {{ .Values.service.targetPort }}
+              protocol: TCP
+          livenessProbe:
+            httpGet:
+              path: {{ .Values.probes.liveness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.liveness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.liveness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.liveness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.liveness.failureThreshold }}
+          readinessProbe:
+            httpGet:
+              path: {{ .Values.probes.readiness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.readiness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.readiness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.readiness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.readiness.failureThreshold }}
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+          env:
+            {{- if .Values.configMap.enabled }}
+            {{- range $k, $v := .Values.configMap.data }}
+            - name: {{ $k }}
+              valueFrom:
+                configMapKeyRef:
+                  name: {{ include "msg.name" $ }}-config
+                  key: {{ $k }}
+            {{- end }}
+            {{- end }}
+            {{- range $secret := .Values.secretRefs }}
+            {{- range $key := $secret.keys }}
+            - name: {{ $key }}
+              valueFrom:
+                secretKeyRef:
+                  name: {{ $secret.name }}
+                  key: {{ $key }}
+            {{- end }}
+            {{- end }}
+          securityContext:
+            {{- toYaml .Values.securityContext | nindent 12 }}

infra/k8s/helm/msg/templates/service.yaml

@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "msg.name" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "msg.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  selector:
+    {{- include "msg.selectorLabels" . | nindent 4 }}
+  ports:
+    - name: http
+      port: {{ .Values.service.port }}
+      targetPort: http
+      protocol: TCP

infra/k8s/helm/msg/values.yaml

@@ -0,0 +1,85 @@
+# msg 服务默认值（消息通知 - 业务领域 D5）
+
+# 副本数（生产建议 ≥ 2）
+replicaCount: 2
+
+image:
+  repository: edu/msg
+  tag: latest  # 生产请固定 tag，避免 latest
+  pullPolicy: IfNotPresent
+
+# 服务端口
+service:
+  type: ClusterIP
+  port: 3004
+  targetPort: 3004
+
+# 命名空间（默认 edu-services，由 edu-platform chart 创建）
+namespace: edu-services
+
+# 探针配置
+probes:
+  liveness:
+    path: /healthz
+    initialDelaySeconds: 15
+    periodSeconds: 20
+    timeoutSeconds: 3
+    failureThreshold: 3
+  readiness:
+    path: /readyz
+    initialDelaySeconds: 5
+    periodSeconds: 10
+    timeoutSeconds: 3
+    failureThreshold: 2
+
+# 资源配额
+resources:
+  requests:
+    cpu: 250m
+    memory: 256Mi
+  limits:
+    cpu: 1000m
+    memory: 1Gi
+
+# 滚动更新策略
+strategy:
+  type: RollingUpdate
+  maxSurge: 1
+  maxUnavailable: 0
+
+# Prometheus 指标采集
+metrics:
+  enabled: true
+  port: 3004
+  path: /metrics
+
+# 安全上下文
+securityContext:
+  runAsNonRoot: true
+  runAsUser: 1000
+  allowPrivilegeEscalation: false
+  capabilities:
+    drop: ["ALL"]
+
+# 服务级 ConfigMap（非敏感配置）
+configMap:
+  enabled: true
+  data:
+    NODE_ENV: production
+    LOG_LEVEL: info
+
+# HPA
+hpa:
+  enabled: true
+  minReplicas: 2
+  maxReplicas: 10
+  targetCPUUtilizationPercentage: 70
+  targetMemoryUtilizationPercentage: 80
+
+# 敏感配置（从 Secret 引用，Secret 由 edu-platform chart 或 ExternalSecrets 管理）
+secretRefs:
+  - name: edu-platform-secret
+    keys:
+      - MYSQL_PASSWORD
+      - JWT_SECRET
+      - REDIS_PASSWORD

lint-staged.config.js

@@ -1,7 +1,9 @@
-module.exports = {
-  '*.{ts,tsx}': ['eslint --fix', 'prettier --write'],
-  '*.{go,mod,sum}': ['gofmt -w', 'golangci-lint run --fix'],
-  '*.{py}': ['ruff check --fix', 'ruff format'],
+module.exports = {
+  // ESLint 9 flat config 迁移完成后恢复：['eslint --fix', 'prettier --write']
+  '*.{ts,tsx}': ['prettier --write'],
+  // Go 工具链不在 git hook PATH 中，Go 文件格式化由 go fmt 手动执行
+  // golangci-lint 安装后恢复：['gofmt -w', 'golangci-lint run --fix']
+  '*.py': ['ruff check --fix', 'ruff format'],
   '*.proto': ['buf format --write'],
   '*.md': ['prettier --write'],
 };

project_rules.md

@@ -1 +0,0 @@
-4. 若代ç <C3A7>结构å<E2809E>˜åŒ?â†?`pnpm run arch:scan` 确认 arch.db 已更æ–?

scripts/arch-scan/scanner.ts

@@ -1,17 +1,22 @@
 #!/usr/bin/env tsx
-import { createDb } from './schema.js';
-import { scanTypeScript } from './scanners/ts-scanner.js';
-import { scanGo } from './scanners/go-scanner.js';
-import { scanPython } from './scanners/py-scanner.js';
-import { scanProtobuf } from './scanners/proto-scanner.js';
-import path from 'node:path';
+import { createDb } from "./schema.js";
+import { scanTypeScript } from "./scanners/ts-scanner.js";
+import { scanGo } from "./scanners/go-scanner.js";
+import { scanPython } from "./scanners/py-scanner.js";
+import { scanProtobuf } from "./scanners/proto-scanner.js";
+import path from "node:path";
 
 const ROOT = process.cwd();
 
 function main(): void {
-  const db = createDb(path.join(ROOT, 'arch.db'));
+  const db = createDb(path.join(ROOT, "arch.db"));
 
-  console.log('🔍 arch-scan: 开始多语言扫描...');
+  // 清空旧数据（避免重跑产生重复符号）
+  db.exec(
+    "DELETE FROM calls; DELETE FROM dependencies; DELETE FROM symbols; DELETE FROM contracts; DELETE FROM events; DELETE FROM modules;",
+  );
+
+  console.log("🔍 arch-scan: 开始多语言扫描...");
 
   // 串行扫描（并行会导致 FOREIGN KEY 错误）
   const tsStats = scanTypeScript(db, ROOT);
@@ -26,7 +31,7 @@ function main(): void {
   const protoStats = scanProtobuf(db, ROOT);
   console.log(`  Protobuf: ${protoStats.contracts} 契约`);
 
-  console.log('✅ arch-scan 完成');
+  console.log("✅ arch-scan 完成");
   db.close();
 }
 

scripts/arch-scan/scanners/go-scanner.ts

@@ -1,12 +1,133 @@
-import type { Database as DBType } from 'better-sqlite3';
+import path from "node:path";
+import fs from "node:fs";
+import type { Database as DBType } from "better-sqlite3";
 
 interface ScanStats {
   modules: number;
   symbols: number;
 }
 
-export function scanGo(db: DBType, root: string): ScanStats {
-  // Go 扫描器骨架：P1 后期用 tree-sitter-go 实现
-  // 当前仅扫描 go.mod 识别模块
-  return { modules: 0, symbols: 0 };
+/** 递归收集目录下匹配扩展名的所有文件 */
+function walkDir(dir: string, exts: string[]): string[] {
+  if (!fs.existsSync(dir)) return [];
+  const results: string[] = [];
+  const stack: string[] = [dir];
+  while (stack.length > 0) {
+    const current = stack.pop()!;
+    let entries: fs.Dirent[];
+    try {
+      entries = fs.readdirSync(current, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const fullPath = path.join(current, entry.name);
+      if (entry.isDirectory()) {
+        if (["node_modules", "dist", ".git", "vendor"].includes(entry.name))
+          continue;
+        stack.push(fullPath);
+      } else if (entry.isFile()) {
+        const ext = path.extname(entry.name);
+        if (exts.includes(ext)) results.push(fullPath);
+      }
+    }
+  }
+  return results;
+}
+
+// Go 符号正则：匹配导出函数、类型、结构体、接口
+const GO_FUNC_RE = /^func\s+(?:\([^)]*\)\s+)?([A-Z]\w*)\s*\(/gm;
+const GO_TYPE_RE = /^type\s+([A-Z]\w*)\s+/gm;
+const GO_STRUCT_RE = /^type\s+([A-Z]\w*)\s+struct\s*\{/gm;
+const GO_INTERFACE_RE = /^type\s+([A-Z]\w*)\s+interface\s*\{/gm;
+
+export function scanGo(db: DBType, root: string): ScanStats {
+  const insertModule = db.prepare(
+    "INSERT OR IGNORE INTO modules (name, path, language, service, type) VALUES (?, ?, ?, ?, ?)",
+  );
+  const insertSymbol = db.prepare(
+    "INSERT INTO symbols (module_id, name, kind, language, file_path, line_start, line_end, is_exported) VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
+  );
+  const getModuleId = db.prepare("SELECT id FROM modules WHERE name = ?") as {
+    get: (name: string) => { id: number } | undefined;
+  };
+
+  let modules = 0;
+  let symbols = 0;
+
+  // 扫描 services/* 下有 go.mod 的服务
+  const servicesDir = path.join(root, "services");
+  if (!fs.existsSync(servicesDir)) return { modules, symbols };
+
+  const entries = fs.readdirSync(servicesDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const serviceName = entry.name;
+    const servicePath = path.join(servicesDir, serviceName);
+    const hasGoMod = fs.existsSync(path.join(servicePath, "go.mod"));
+    if (!hasGoMod) continue;
+
+    insertModule.run(serviceName, servicePath, "go", serviceName, "service");
+    const modRow = getModuleId.get(serviceName);
+    if (modRow) {
+      modules++;
+      // 扫描 .go 文件
+      const goFiles = walkDir(servicePath, [".go"]);
+      for (const filePath of goFiles) {
+        // 跳过测试文件
+        if (filePath.endsWith("_test.go")) continue;
+        let content: string;
+        try {
+          content = fs.readFileSync(filePath, "utf-8");
+        } catch {
+          continue;
+        }
+        const lines = content.split("\n");
+
+        // 函数
+        let match: RegExpExecArray | null;
+        const funcRe = new RegExp(GO_FUNC_RE);
+        while ((match = funcRe.exec(content)) !== null) {
+          const name = match[1];
+          const lineNum = content.slice(0, match.index).split("\n").length;
+          insertSymbol.run(
+            modRow.id,
+            name,
+            "function",
+            "go",
+            filePath,
+            lineNum,
+            lineNum,
+            1,
+          );
+          symbols++;
+        }
+
+        // 类型（struct / interface / type alias）
+        const typeRe = new RegExp(GO_TYPE_RE);
+        while ((match = typeRe.exec(content)) !== null) {
+          const name = match[1];
+          const lineNum = content.slice(0, match.index).split("\n").length;
+          // 判断是 struct 还是 interface 还是普通 type
+          const line = lines[lineNum - 1] || "";
+          let kind = "type";
+          if (line.includes("struct")) kind = "struct";
+          else if (line.includes("interface")) kind = "interface";
+          insertSymbol.run(
+            modRow.id,
+            name,
+            kind,
+            "go",
+            filePath,
+            lineNum,
+            lineNum,
+            1,
+          );
+          symbols++;
+        }
+      }
+    }
+  }
+
+  return { modules, symbols };
 }

scripts/arch-scan/scanners/proto-scanner.ts

@@ -1,10 +1,92 @@
-import type { Database as DBType } from 'better-sqlite3';
+import path from "node:path";
+import fs from "node:fs";
+import type { Database as DBType } from "better-sqlite3";
 
 interface ScanStats {
   contracts: number;
 }
 
+// Proto 符号正则
+const PROTO_SERVICE_RE = /^service\s+(\w+)\s*\{/gm;
+const PROTO_MESSAGE_RE = /^message\s+(\w+)\s*\{/gm;
+const PROTO_RPC_RE = /^\s*rpc\s+(\w+)\s*\(/gm;
+
 export function scanProtobuf(db: DBType, root: string): ScanStats {
-  // Protobuf 扫描器骨架：扫描 packages/shared-proto/proto/*.proto
-  return { contracts: 0 };
+  const insertContract = db.prepare(
+    "INSERT OR IGNORE INTO contracts (name, type, file_path, service, content) VALUES (?, ?, ?, ?, ?)",
+  );
+
+  let contracts = 0;
+
+  // 扫描 packages/shared-proto/proto/*.proto
+  const protoDir = path.join(root, "packages", "shared-proto", "proto");
+  if (!fs.existsSync(protoDir)) return { contracts };
+
+  const entries = fs.readdirSync(protoDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isFile() || !entry.name.endsWith(".proto")) continue;
+    const filePath = path.join(protoDir, entry.name);
+    const protoName = path.basename(entry.name, ".proto");
+    const serviceName = protoName.replace("_", "-");
+
+    let content: string;
+    try {
+      content = fs.readFileSync(filePath, "utf-8");
+    } catch {
+      continue;
+    }
+
+    // 提取 package 名
+    const pkgMatch = content.match(/^package\s+(\S+);/m);
+    const pkgName = pkgMatch ? pkgMatch[1] : "";
+
+    // 记录 proto 文件作为契约
+    insertContract.run(protoName, "proto-file", filePath, serviceName, pkgName);
+    contracts++;
+
+    // 提取 service 定义
+    let match: RegExpExecArray | null;
+    const serviceRe = new RegExp(PROTO_SERVICE_RE);
+    while ((match = serviceRe.exec(content)) !== null) {
+      const name = match[1];
+      insertContract.run(
+        `${protoName}.${name}`,
+        "service",
+        filePath,
+        serviceName,
+        name,
+      );
+      contracts++;
+    }
+
+    // 提取 message 定义
+    const messageRe = new RegExp(PROTO_MESSAGE_RE);
+    while ((match = messageRe.exec(content)) !== null) {
+      const name = match[1];
+      insertContract.run(
+        `${protoName}.${name}`,
+        "message",
+        filePath,
+        serviceName,
+        name,
+      );
+      contracts++;
+    }
+
+    // 提取 rpc 方法
+    const rpcRe = new RegExp(PROTO_RPC_RE);
+    while ((match = rpcRe.exec(content)) !== null) {
+      const name = match[1];
+      insertContract.run(
+        `${protoName}.rpc.${name}`,
+        "rpc",
+        filePath,
+        serviceName,
+        name,
+      );
+      contracts++;
+    }
+  }
+
+  return { contracts };
 }

scripts/arch-scan/scanners/py-scanner.ts

@@ -1,11 +1,142 @@
-import type { Database as DBType } from 'better-sqlite3';
+import path from "node:path";
+import fs from "node:fs";
+import type { Database as DBType } from "better-sqlite3";
 
 interface ScanStats {
   modules: number;
   symbols: number;
 }
 
-export function scanPython(db: DBType, root: string): ScanStats {
-  // Python 扫描器骨架：P1 后期用 tree-sitter-python 实现
-  return { modules: 0, symbols: 0 };
+/** 递归收集目录下匹配扩展名的所有文件 */
+function walkDir(dir: string, exts: string[]): string[] {
+  if (!fs.existsSync(dir)) return [];
+  const results: string[] = [];
+  const stack: string[] = [dir];
+  while (stack.length > 0) {
+    const current = stack.pop()!;
+    let entries: fs.Dirent[];
+    try {
+      entries = fs.readdirSync(current, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const fullPath = path.join(current, entry.name);
+      if (entry.isDirectory()) {
+        if (
+          [
+            "node_modules",
+            "dist",
+            ".git",
+            "__pycache__",
+            ".venv",
+            "venv",
+          ].includes(entry.name)
+        )
+          continue;
+        stack.push(fullPath);
+      } else if (entry.isFile()) {
+        const ext = path.extname(entry.name);
+        if (exts.includes(ext)) results.push(fullPath);
+      }
+    }
+  }
+  return results;
+}
+
+// Python 符号正则
+const PY_FUNC_RE = /^(?:async\s+)?def\s+(\w+)\s*\(/gm;
+const PY_CLASS_RE = /^class\s+(\w+)\s*[\(:]/gm;
+
+export function scanPython(db: DBType, root: string): ScanStats {
+  const insertModule = db.prepare(
+    "INSERT OR IGNORE INTO modules (name, path, language, service, type) VALUES (?, ?, ?, ?, ?)",
+  );
+  const insertSymbol = db.prepare(
+    "INSERT INTO symbols (module_id, name, kind, language, file_path, line_start, line_end, is_exported) VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
+  );
+  const getModuleId = db.prepare("SELECT id FROM modules WHERE name = ?") as {
+    get: (name: string) => { id: number } | undefined;
+  };
+
+  let modules = 0;
+  let symbols = 0;
+
+  // 扫描 services/* 下有 pyproject.toml 的服务
+  const servicesDir = path.join(root, "services");
+  if (!fs.existsSync(servicesDir)) return { modules, symbols };
+
+  const entries = fs.readdirSync(servicesDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const serviceName = entry.name;
+    const servicePath = path.join(servicesDir, serviceName);
+    const hasPyproject = fs.existsSync(
+      path.join(servicePath, "pyproject.toml"),
+    );
+    if (!hasPyproject) continue;
+
+    insertModule.run(
+      serviceName,
+      servicePath,
+      "python",
+      serviceName,
+      "service",
+    );
+    const modRow = getModuleId.get(serviceName);
+    if (modRow) {
+      modules++;
+      // 扫描 .py 文件
+      const pyFiles = walkDir(servicePath, [".py"]);
+      for (const filePath of pyFiles) {
+        let content: string;
+        try {
+          content = fs.readFileSync(filePath, "utf-8");
+        } catch {
+          continue;
+        }
+
+        // 函数（含 async def）
+        let match: RegExpExecArray | null;
+        const funcRe = new RegExp(PY_FUNC_RE);
+        while ((match = funcRe.exec(content)) !== null) {
+          const name = match[1];
+          const lineNum = content.slice(0, match.index).split("\n").length;
+          // Python 中以 _ 开头的为私有
+          const isExported = !name.startsWith("_") ? 1 : 0;
+          insertSymbol.run(
+            modRow.id,
+            name,
+            "function",
+            "python",
+            filePath,
+            lineNum,
+            lineNum,
+            isExported,
+          );
+          symbols++;
+        }
+
+        // 类
+        const classRe = new RegExp(PY_CLASS_RE);
+        while ((match = classRe.exec(content)) !== null) {
+          const name = match[1];
+          const lineNum = content.slice(0, match.index).split("\n").length;
+          insertSymbol.run(
+            modRow.id,
+            name,
+            "class",
+            "python",
+            filePath,
+            lineNum,
+            lineNum,
+            1,
+          );
+          symbols++;
+        }
+      }
+    }
+  }
+
+  return { modules, symbols };
 }

scripts/arch-scan/scanners/ts-scanner.ts

@@ -1,38 +1,211 @@
-import { Project, SyntaxKind } from 'ts-morph';
-import path from 'node:path';
-import type { Database as DBType } from 'better-sqlite3';
+import path from "node:path";
+import fs from "node:fs";
+import type { Database as DBType } from "better-sqlite3";
 
 interface ScanStats {
   modules: number;
   symbols: number;
 }
 
-export function scanTypeScript(db: DBType, root: string): ScanStats {
-  const project = new Project({
-    tsConfigFilePath: undefined,
-    skipAddingFilesFromTsConfig: true,
-    compilerOptions: {
-      allowJs: true,
-      declaration: false,
-      resolveJsonModule: true,
-    },
-  });
+/** 递归收集目录下匹配扩展名的所有文件 */
+function walkDir(dir: string, exts: string[]): string[] {
+  if (!fs.existsSync(dir)) return [];
+  const results: string[] = [];
+  const stack: string[] = [dir];
+  while (stack.length > 0) {
+    const current = stack.pop()!;
+    let entries: fs.Dirent[];
+    try {
+      entries = fs.readdirSync(current, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const fullPath = path.join(current, entry.name);
+      if (entry.isDirectory()) {
+        // 跳过 node_modules / dist / .git
+        if (
+          ["node_modules", "dist", ".git", ".next", "build"].includes(
+            entry.name,
+          )
+        )
+          continue;
+        stack.push(fullPath);
+      } else if (entry.isFile()) {
+        const ext = path.extname(entry.name);
+        if (exts.includes(ext)) results.push(fullPath);
+      }
+    }
+  }
+  return results;
+}
+
+export function scanTypeScript(db: DBType, root: string): ScanStats {
+  const insertModule = db.prepare(
+    "INSERT OR IGNORE INTO modules (name, path, language, service, type) VALUES (?, ?, ?, ?, ?)",
+  );
+  const insertSymbol = db.prepare(
+    "INSERT INTO symbols (module_id, name, kind, language, file_path, line_start, line_end, is_exported) VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
+  );
+  const getModuleId = db.prepare("SELECT id FROM modules WHERE name = ?") as {
+    get: (name: string) => { id: number } | undefined;
+  };
 
-  const patterns = ['services/*/src/**/*.ts', 'apps/*/src/**/*.ts', 'packages/*/src/**/*.ts'];
   let modules = 0;
   let symbols = 0;
 
-  const insertModule = db.prepare(
-    'INSERT OR IGNORE INTO modules (name, path, language, service, type) VALUES (?, ?, ?, ?, ?)'
-  );
-  const insertSymbol = db.prepare(
-    'INSERT INTO symbols (module_id, name, kind, language, file_path, line_start, line_end, is_exported) VALUES (?, ?, ?, ?, ?, ?, ?, ?)'
-  );
+  // 扫描 services/* 和 apps/* 和 packages/* 下的 TS 服务
+  const serviceDirs = ["services", "apps"];
+  const moduleList: { name: string; path: string; service: string }[] = [];
 
-  // 简化实现：扫描 services/*/src 目录作为模块
-  const servicesDir = path.join(root, 'services');
-  // 实际实现用 fast-glob 模式匹配
-  // 此处为骨架，P1 后期补全
+  for (const dir of serviceDirs) {
+    const baseDir = path.join(root, dir);
+    if (!fs.existsSync(baseDir)) continue;
+    const entries = fs.readdirSync(baseDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const serviceName = entry.name;
+      const servicePath = path.join(baseDir, serviceName);
+      // 确认是 TS 服务（有 src 目录或 package.json）
+      const hasSrc = fs.existsSync(path.join(servicePath, "src"));
+      const hasPkg = fs.existsSync(path.join(servicePath, "package.json"));
+      if (!hasSrc && !hasPkg) continue;
+
+      const moduleName = serviceName;
+      insertModule.run(moduleName, servicePath, "ts", serviceName, "service");
+      const row = getModuleId.get(moduleName);
+      if (row) {
+        modules++;
+        moduleList.push({
+          name: moduleName,
+          path: servicePath,
+          service: serviceName,
+        });
+      }
+    }
+  }
+
+  // packages/* 下的 TS 包
+  const packagesDir = path.join(root, "packages");
+  if (fs.existsSync(packagesDir)) {
+    const entries = fs.readdirSync(packagesDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const pkgName = entry.name;
+      const pkgPath = path.join(packagesDir, pkgName);
+      const hasSrc = fs.existsSync(path.join(pkgPath, "src"));
+      const hasPkg = fs.existsSync(path.join(pkgPath, "package.json"));
+      const hasProto = fs.existsSync(path.join(pkgPath, "proto"));
+      if (!hasSrc && !hasPkg && !hasProto) continue;
+      const moduleName = pkgName;
+      insertModule.run(moduleName, pkgPath, "ts", pkgName, "package");
+      const row = getModuleId.get(moduleName);
+      if (row) {
+        modules++;
+        moduleList.push({ name: moduleName, path: pkgPath, service: pkgName });
+      }
+    }
+  }
+
+  // 收集所有 .ts 文件并用 regex 提取符号（ts-morph 对未安装依赖的文件可能解析失败）
+  const TS_FUNC_RE = /(?:export\s+)?(?:async\s+)?function\s+(\w+)\s*\(/g;
+  const TS_CLASS_RE = /(?:export\s+)?(?:abstract\s+)?class\s+(\w+)/g;
+  const TS_INTERFACE_RE = /(?:export\s+)?interface\s+(\w+)/g;
+  const TS_CONST_RE = /(?:export\s+)?const\s+([A-Z][A-Z0-9_]+)\s*=/g;
+
+  for (const mod of moduleList) {
+    const srcDir = path.join(mod.path, "src");
+    if (!fs.existsSync(srcDir)) continue;
+    const tsFiles = walkDir(srcDir, [".ts", ".tsx"]);
+    const modRow = getModuleId.get(mod.name);
+    if (!modRow) continue;
+
+    for (const filePath of tsFiles) {
+      let content: string;
+      try {
+        content = fs.readFileSync(filePath, "utf-8");
+      } catch {
+        continue;
+      }
+
+      // 函数
+      let match: RegExpExecArray | null;
+      const funcRe = new RegExp(TS_FUNC_RE);
+      while ((match = funcRe.exec(content)) !== null) {
+        const name = match[1];
+        const lineNum = content.slice(0, match.index).split("\n").length;
+        const isExported = match[0].includes("export") ? 1 : 0;
+        insertSymbol.run(
+          modRow.id,
+          name,
+          "function",
+          "ts",
+          filePath,
+          lineNum,
+          lineNum,
+          isExported,
+        );
+        symbols++;
+      }
+
+      // 类
+      const classRe = new RegExp(TS_CLASS_RE);
+      while ((match = classRe.exec(content)) !== null) {
+        const name = match[1];
+        const lineNum = content.slice(0, match.index).split("\n").length;
+        const isExported = match[0].includes("export") ? 1 : 0;
+        insertSymbol.run(
+          modRow.id,
+          name,
+          "class",
+          "ts",
+          filePath,
+          lineNum,
+          lineNum,
+          isExported,
+        );
+        symbols++;
+      }
+
+      // 接口
+      const ifaceRe = new RegExp(TS_INTERFACE_RE);
+      while ((match = ifaceRe.exec(content)) !== null) {
+        const name = match[1];
+        const lineNum = content.slice(0, match.index).split("\n").length;
+        const isExported = match[0].includes("export") ? 1 : 0;
+        insertSymbol.run(
+          modRow.id,
+          name,
+          "interface",
+          "ts",
+          filePath,
+          lineNum,
+          lineNum,
+          isExported,
+        );
+        symbols++;
+      }
+
+      // 常量（UPPER_CASE）
+      const constRe = new RegExp(TS_CONST_RE);
+      while ((match = constRe.exec(content)) !== null) {
+        const name = match[1];
+        const lineNum = content.slice(0, match.index).split("\n").length;
+        const isExported = match[0].includes("export") ? 1 : 0;
+        insertSymbol.run(
+          modRow.id,
+          name,
+          "const",
+          "ts",
+          filePath,
+          lineNum,
+          lineNum,
+          isExported,
+        );
+        symbols++;
+      }
+    }
+  }
 
   return { modules, symbols };
 }

services/ai/src/health/health.py

@@ -9,7 +9,8 @@
     from health import router as health_router
     app.include_router(health_router)
 """
-from datetime import datetime, timezone
+
+from datetime import UTC, datetime
 
 from fastapi import APIRouter
 
@@ -32,5 +33,5 @@ async def readyz() -> dict:
     return {
         "status": "ok",
         "service": SERVICE_NAME,
-        "timestamp": datetime.now(timezone.utc).isoformat(),
+        "timestamp": datetime.now(UTC).isoformat(),
     }

services/api-gateway/README.md

@@ -1,11 +1,41 @@
-# API Gateway
+# API Gateway
 
 Go (Gin) 实现的 API 网关，所有外部请求的统一入口。
 
 ## 职责
-- 路由转发：/api/v1/classes/* → classes 服务
-- JWT 鉴权：P1 HS256，P2 RS256
-- 请求 ID 注入：全链路追踪
+
+- **路由转发**：`/api/v1/classes/*` → classes 服务（P1），后续阶段追加 iam/core-edu/content/msg 等路由
+- **JWT 鉴权**：P1 HS256（测试密钥），P2 起 RS256（IAM 签发，Gateway 公钥校验）
+- **请求 ID 注入**：生成或透传 `X-Request-ID`，全链路追踪
+- **限流**（P6）：基于令牌桶的 per-IP 限流，超限返回 429
+- **熔断**（P6）：基于 gobreaker v2 的下游服务熔断，5xx 错误率 > 50% 触发 OPEN
+- **CORS / 安全头 / Recovery**（P6）：标准化中间件链
+
+## 中间件链（P6）
+
+请求处理顺序（自外向内）：
+
+```
+Request → RequestID → CORS → Security → Recovery → RateLimit → Auth → CircuitBreaker → Proxy → Response
+```
+
+| 中间件         | 文件                                     | 职责                                         |
+| -------------- | ---------------------------------------- | -------------------------------------------- |
+| RequestID      | `internal/middleware/requestid.go`       | 生成/透传 `X-Request-ID`                     |
+| CORS           | `internal/middleware/cors.go`            | 跨域允许                                     |
+| Security       | `internal/middleware/security.go`        | 安全响应头（X-Content-Type-Options 等）      |
+| Recovery       | `internal/middleware/recovery.go`        | panic 兜底返回 500                           |
+| RateLimit      | `internal/middleware/ratelimit.go`       | per-IP 令牌桶限流，超限 429                  |
+| Auth           | `internal/middleware/auth.go`            | JWT 校验，注入 `x-user-id`/`x-user-roles` 头 |
+| CircuitBreaker | `internal/middleware/circuit-breaker.go` | 下游 5xx 错误率 > 50% 触发熔断，返回 503     |
+
+## 健康检查
+
+| 端点           | 用途                                     | 鉴权 |
+| -------------- | ---------------------------------------- | ---- |
+| `GET /healthz` | 存活探针（liveness）                     | 无   |
+| `GET /readyz`  | 就绪探针（readiness）                    | 无   |
+| `GET /health`  | 兼容端点（返回 `{ status, timestamp }`） | 无   |
 
 ## 开发
 
@@ -15,5 +45,45 @@ go mod tidy
 go run main.go
 ```
 
-## 健康检查
-GET /healthz
+## 测试
+
+```bash
+# 单元 + 集成测试
+cd services/api-gateway
+go test ./internal/middleware/... -v -cover
+
+# 测试覆盖
+# - circuit-breaker_test.go: 5 用例（ClosedToOpen / OpenToHalfOpen / HalfOpenToClosed / HalfOpenToOpen / 4xxNotCounted）
+# - ratelimit_test.go: 5 用例（AllowUnderBurst / RejectOverBurst / RefillTokens / PerIPIsolation / CleanupExpiredBuckets）
+```
+
+## 构建
+
+```bash
+# 本地构建
+go build ./...
+
+# Docker 构建
+docker build -t edu/api-gateway .
+```
+
+## 配置
+
+通过环境变量配置（见 `internal/config/config.go`）：
+
+| 变量                  | 默认值                | 说明                 |
+| --------------------- | --------------------- | -------------------- |
+| `PORT`                | 8080                  | 监听端口             |
+| `JWT_SECRET`          | （必填）              | HS256 签名密钥（P1） |
+| `JWT_PUBLIC_KEY`      | （P2）                | RS256 公钥           |
+| `CLASSES_SERVICE_URL` | http://localhost:3001 | classes 服务地址     |
+| `RATE_LIMIT_RPS`      | 10                    | 每秒令牌数           |
+| `RATE_LIMIT_BURST`    | 20                    | 突发容量             |
+
+## 关联文档
+
+- [架构影响地图](../../docs/architecture/004_architecture_impact_map.md)
+- [项目规则](../../.trae/rules/project_rules.md)
+- [P6 硬化 Runbook](../../docs/architecture/runbooks/p6-hardening.md)
+- [P6 后续工作手册](../../docs/architecture/runbooks/post-p6-followup.md)
+- [Helm Chart](../../infra/k8s/helm/api-gateway/)

services/api-gateway/go.mod

@@ -1,15 +1,46 @@
 module github.com/edu-cloud/api-gateway
 
-go 1.22
+go 1.22.0
 
 require (
 	github.com/gin-gonic/gin v1.10.0
 	github.com/golang-jwt/jwt/v5 v5.2.1
 	github.com/google/uuid v1.6.0
 	github.com/sony/gobreaker/v2 v2.1.0
-	go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin v0.52.0
-	go.opentelemetry.io/otel v1.27.0
-	go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.27.0
-	go.opentelemetry.io/otel/sdk v1.27.0
-	go.uber.org/zap v1.27.0
+)
+
+require (
+	github.com/bytedance/sonic v1.11.6 // indirect
+	github.com/bytedance/sonic/loader v0.1.1 // indirect
+	github.com/cespare/xxhash/v2 v2.2.0 // indirect
+	github.com/cloudwego/base64x v0.1.4 // indirect
+	github.com/cloudwego/iasm v0.2.0 // indirect
+	github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f // indirect
+	github.com/gabriel-vasile/mimetype v1.4.3 // indirect
+	github.com/gin-contrib/sse v0.1.0 // indirect
+	github.com/go-playground/locales v0.14.1 // indirect
+	github.com/go-playground/universal-translator v0.18.1 // indirect
+	github.com/go-playground/validator/v10 v10.20.0 // indirect
+	github.com/go-redsync/redsync/v4 v4.13.0 // indirect
+	github.com/goccy/go-json v0.10.2 // indirect
+	github.com/google/go-cmp v0.6.0 // indirect
+	github.com/hashicorp/errwrap v1.1.0 // indirect
+	github.com/hashicorp/go-multierror v1.1.1 // indirect
+	github.com/json-iterator/go v1.1.12 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.7 // indirect
+	github.com/leodido/go-urn v1.4.0 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
+	github.com/modern-go/reflect2 v1.0.2 // indirect
+	github.com/pelletier/go-toml/v2 v2.2.2 // indirect
+	github.com/redis/go-redis/v9 v9.7.0 // indirect
+	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
+	github.com/ugorji/go/codec v1.2.12 // indirect
+	golang.org/x/arch v0.8.0 // indirect
+	golang.org/x/crypto v0.23.0 // indirect
+	golang.org/x/net v0.25.0 // indirect
+	golang.org/x/sys v0.20.0 // indirect
+	golang.org/x/text v0.15.0 // indirect
+	google.golang.org/protobuf v1.34.1 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
 )

services/api-gateway/go.sum

@@ -0,0 +1,130 @@
+github.com/alicebob/gopher-json v0.0.0-20200520072559-a9ecdc9d1d3a h1:HbKu58rmZpUGpz5+4FfNmIU+FmZg2P3Xaj2v2bfNWmk=
+github.com/alicebob/gopher-json v0.0.0-20200520072559-a9ecdc9d1d3a/go.mod h1:SGnFV6hVsYE877CKEZ6tDNTjaSXYUk6QqoIK6PrAtcc=
+github.com/alicebob/miniredis/v2 v2.33.0 h1:uvTF0EDeu9RLnUEG27Db5I68ESoIxTiXbNUiji6lZrA=
+github.com/alicebob/miniredis/v2 v2.33.0/go.mod h1:MhP4a3EU7aENRi9aO+tHfTBZicLqQevyi/DJpoj6mi0=
+github.com/bsm/ginkgo/v2 v2.12.0 h1:Ny8MWAHyOepLGlLKYmXG4IEkioBysk6GpaRTLC8zwWs=
+github.com/bsm/ginkgo/v2 v2.12.0/go.mod h1:SwYbGRRDovPVboqFv0tPTcG1sN61LM1Z4ARdbAV9g4c=
+github.com/bsm/gomega v1.27.10 h1:yeMWxP2pV2fG3FgAODIY8EiRE3dy0aeFYt4l7wh6yKA=
+github.com/bsm/gomega v1.27.10/go.mod h1:JyEr/xRbxbtgWNi8tIEVPUYZ5Dzef52k01W3YH0H+O0=
+github.com/bytedance/sonic v1.11.6 h1:oUp34TzMlL+OY1OUWxHqsdkgC/Zfc85zGqw9siXjrc0=
+github.com/bytedance/sonic v1.11.6/go.mod h1:LysEHSvpvDySVdC2f87zGWf6CIKJcAvqab1ZaiQtds4=
+github.com/bytedance/sonic/loader v0.1.1 h1:c+e5Pt1k/cy5wMveRDyk2X4B9hF4g7an8N3zCYjJFNM=
+github.com/bytedance/sonic/loader v0.1.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU=
+github.com/cespare/xxhash/v2 v2.2.0 h1:DC2CZ1Ep5Y4k3ZQ899DldepgrayRUGE6BBZ/cd9Cj44=
+github.com/cespare/xxhash/v2 v2.2.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
+github.com/cloudwego/base64x v0.1.4 h1:jwCgWpFanWmN8xoIUHa2rtzmkd5J2plF/dnLS6Xd/0Y=
+github.com/cloudwego/base64x v0.1.4/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w=
+github.com/cloudwego/iasm v0.2.0 h1:1KNIy1I1H9hNNFEEH3DVnI4UujN+1zjpuk6gwHLTssg=
+github.com/cloudwego/iasm v0.2.0/go.mod h1:8rXZaNYT2n95jn+zTI1sDr+IgcD2GVs0nlbbQPiEFhY=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f h1:lO4WD4F/rVNCu3HqELle0jiPLLBs70cWOduZpkS1E78=
+github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f/go.mod h1:cuUVRXasLTGF7a8hSLbxyZXjz+1KgoB3wDUb6vlszIc=
+github.com/gabriel-vasile/mimetype v1.4.3 h1:in2uUcidCuFcDKtdcBxlR0rJ1+fsokWf+uqxgUFjbI0=
+github.com/gabriel-vasile/mimetype v1.4.3/go.mod h1:d8uq/6HKRL6CGdk+aubisF/M5GcPfT7nKyLpA0lbSSk=
+github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE=
+github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI=
+github.com/gin-gonic/gin v1.10.0 h1:nTuyha1TYqgedzytsKYqna+DfLos46nTv2ygFy86HFU=
+github.com/gin-gonic/gin v1.10.0/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y=
+github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s=
+github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
+github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA=
+github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
+github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
+github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
+github.com/go-playground/validator/v10 v10.20.0 h1:K9ISHbSaI0lyB2eWMPJo+kOS/FBExVwjEviJTixqxL8=
+github.com/go-playground/validator/v10 v10.20.0/go.mod h1:dbuPbCMFw/DrkbEynArYaCwl3amGuJotoKCe95atGMM=
+github.com/go-redis/redis v6.15.9+incompatible h1:K0pv1D7EQUjfyoMql+r/jZqCLizCGKFlFgcHWWmHQjg=
+github.com/go-redis/redis v6.15.9+incompatible/go.mod h1:NAIEuMOZ/fxfXJIrKDQDz8wamY7mA7PouImQ2Jvg6kA=
+github.com/go-redis/redis/v7 v7.4.1 h1:PASvf36gyUpr2zdOUS/9Zqc80GbM+9BDyiJSJDDOrTI=
+github.com/go-redis/redis/v7 v7.4.1/go.mod h1:JDNMw23GTyLNC4GZu9njt15ctBQVn7xjRfnwdHj/Dcg=
+github.com/go-redis/redis/v8 v8.11.5 h1:AcZZR7igkdvfVmQTPnu9WE37LRrO/YrBH5zWyjDC0oI=
+github.com/go-redis/redis/v8 v8.11.5/go.mod h1:gREzHqY1hg6oD9ngVRbLStwAWKhA0FEgq8Jd4h5lpwo=
+github.com/go-redsync/redsync/v4 v4.13.0 h1:49X6GJfnbLGaIpBBREM/zA4uIMDXKAh1NDkvQ1EkZKA=
+github.com/go-redsync/redsync/v4 v4.13.0/go.mod h1:HMW4Q224GZQz6x1Xc7040Yfgacukdzu7ifTDAKiyErQ=
+github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU=
+github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I=
+github.com/golang-jwt/jwt/v5 v5.2.1 h1:OuVbFODueb089Lh128TAcimifWaLhJwVflnrgM17wHk=
+github.com/golang-jwt/jwt/v5 v5.2.1/go.mod h1:pqrtFR0X4osieyHYxtmOUWsAWrfe1Q5UVIyoH402zdk=
+github.com/gomodule/redigo v1.8.9 h1:Sl3u+2BI/kk+VEatbj0scLdrFhjPmbxOc1myhDP41ws=
+github.com/gomodule/redigo v1.8.9/go.mod h1:7ArFNvsTjH8GMMzB4uy1snslv2BwmginuMs06a1uzZE=
+github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
+github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
+github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/hashicorp/errwrap v1.0.0/go.mod h1:YH+1FKiLXxHSkmPseP+kNlulaMuP3n2brvKWEqk/Jc4=
+github.com/hashicorp/errwrap v1.1.0 h1:OxrOeh75EUXMY8TBjag2fzXGZ40LB6IKw45YeGUDY2I=
+github.com/hashicorp/errwrap v1.1.0/go.mod h1:YH+1FKiLXxHSkmPseP+kNlulaMuP3n2brvKWEqk/Jc4=
+github.com/hashicorp/go-multierror v1.1.1 h1:H5DkEtf6CXdFp0N0Em5UCwQpXMWke8IA0+lD48awMYo=
+github.com/hashicorp/go-multierror v1.1.1/go.mod h1:iw975J/qwKPdAO1clOe2L8331t/9/fmwbPZ6JB6eMoM=
+github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
+github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
+github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
+github.com/klauspost/cpuid/v2 v2.2.7 h1:ZWSB3igEs+d0qvnxR/ZBzXVmxkgt8DdzP6m9pfuVLDM=
+github.com/klauspost/cpuid/v2 v2.2.7/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws=
+github.com/knz/go-libedit v1.10.1/go.mod h1:MZTVkCWyz0oBc7JOWP3wNAzd002ZbM/5hgShxwh4x8M=
+github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=
+github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
+github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
+github.com/pelletier/go-toml/v2 v2.2.2 h1:aYUidT7k73Pcl9nb2gScu7NSrKCSHIDE89b3+6Wq+LM=
+github.com/pelletier/go-toml/v2 v2.2.2/go.mod h1:1t835xjRzz80PqgE6HHgN2JOsmgYu/h4qDAS4n929Rs=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/redis/go-redis/v9 v9.7.0 h1:HhLSs+B6O021gwzl+locl0zEDnyNkxMtf/Z3NNBMa9E=
+github.com/redis/go-redis/v9 v9.7.0/go.mod h1:f6zhXITC7JUJIlPEiBOTXxJgPLdZcA93GewI7inzyWw=
+github.com/redis/rueidis v1.0.19 h1:s65oWtotzlIFN8eMPhyYwxlwLR1lUdhza2KtWprKYSo=
+github.com/redis/rueidis v1.0.19/go.mod h1:8B+r5wdnjwK3lTFml5VtxjzGOQAC+5UmujoD12pDrEo=
+github.com/sony/gobreaker/v2 v2.1.0 h1:av2BnjtRmVPWBvy5gSFPytm1J8BmN5AGhq875FfGKDM=
+github.com/sony/gobreaker/v2 v2.1.0/go.mod h1:dO3Q/nCzxZj6ICjH6J/gM0r4oAwBMVLY8YAQf+NTtUg=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
+github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
+github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
+github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
+github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
+github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=
+github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/stvp/tempredis v0.0.0-20181119212430-b82af8480203 h1:QVqDTf3h2WHt08YuiTGPZLls0Wq99X9bWd0Q5ZSBesM=
+github.com/stvp/tempredis v0.0.0-20181119212430-b82af8480203/go.mod h1:oqN97ltKNihBbwlX8dLpwxCl3+HnXKV/R0e+sRLd9C8=
+github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI=
+github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08=
+github.com/ugorji/go/codec v1.2.12 h1:9LC83zGrHhuUA9l16C9AHXAqEV/2wBQ4nkvumAE65EE=
+github.com/ugorji/go/codec v1.2.12/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
+github.com/yuin/gopher-lua v1.1.1 h1:kYKnWBjvbNP4XLT3+bPEwAXJx262OhaHDWDVOPjL46M=
+github.com/yuin/gopher-lua v1.1.1/go.mod h1:GBR0iDaNXjAgGg9zfCvksxSRnQx76gclCIb7kdAd1Pw=
+golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
+golang.org/x/arch v0.8.0 h1:3wRIsP3pM4yUptoR96otTUOXI367OS0+c9eeRi9doIc=
+golang.org/x/arch v0.8.0/go.mod h1:FEVrYAQjsQXMVJ1nsMoVVXPZg6p2JE2mx8psSWTDQys=
+golang.org/x/crypto v0.23.0 h1:dIJU/v2J8Mdglj/8rJ6UUOM3Zc9zLZxVZwwxMooUSAI=
+golang.org/x/crypto v0.23.0/go.mod h1:CKFgDieR+mRhux2Lsu27y0fO304Db0wZe70UKqHu0v8=
+golang.org/x/net v0.25.0 h1:d/OCCoBEUq33pjydKrGQhw7IlUPI2Oylr+8qLx49kac=
+golang.org/x/net v0.25.0/go.mod h1:JkAGAh7GEvH74S6FOH42FLoXpXbE/aqXSrIQjXgsiwM=
+golang.org/x/sync v0.3.0 h1:ftCYgMx6zT/asHUrPw8BLLscYtGznsLAnjq5RH9P66E=
+golang.org/x/sync v0.3.0/go.mod h1:FU7BRWz2tNW+3quACPkgCx/L+uEAv1htQ0V83Z9Rj+Y=
+golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.20.0 h1:Od9JTbYCk261bKm4M/mw7AklTlFYIa0bIp9BgSm1S8Y=
+golang.org/x/sys v0.20.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
+golang.org/x/text v0.15.0 h1:h1V/4gjBv8v9cjcR6+AR5+/cIYK5N/WAgiv4xlsEtAk=
+golang.org/x/text v0.15.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU=
+google.golang.org/protobuf v1.34.1 h1:9ddQBjfCyZPOHPUiPxpYESBLc+T8P3E+Vo4IbKZgFWg=
+google.golang.org/protobuf v1.34.1/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+nullprogram.com/x/optparse v1.0.0/go.mod h1:KdyPE+Igbe0jQUrVfMqDMeJQIJZEuyV7pjYmp6pbG50=
+rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4=

services/api-gateway/internal/middleware/circuit-breaker_test.go

@@ -0,0 +1,223 @@
+package middleware
+
+import (
+	"errors"
+	"net/http"
+	"net/http/httptest"
+	"strings"
+	"sync/atomic"
+	"testing"
+	"time"
+
+	"github.com/gin-gonic/gin"
+	"github.com/sony/gobreaker/v2"
+)
+
+// newTestCircuitBreaker 构造与生产 CircuitBreaker 中间件相同语义、但可配置时序参数的版本，
+// 用于在测试中加速 CLOSED → OPEN → HALF_OPEN → CLOSED 状态机验证。
+func newTestCircuitBreaker(t *testing.T, interval, timeout time.Duration) (gin.HandlerFunc, *gobreaker.CircuitBreaker[struct{}]) {
+	t.Helper()
+	cb := gobreaker.NewCircuitBreaker[struct{}](gobreaker.Settings{
+		Name:        "test-svc",
+		MaxRequests: 1,
+		Interval:    interval,
+		Timeout:     timeout,
+		ReadyToTrip: func(counts gobreaker.Counts) bool {
+			if counts.Requests == 0 {
+				return false
+			}
+			return counts.TotalFailures*2 > counts.Requests
+		},
+	})
+	return func(c *gin.Context) {
+		_, err := cb.Execute(func() (struct{}, error) {
+			c.Next()
+			if c.Writer.Status() >= 500 {
+				return struct{}{}, errors.New("downstream_error")
+			}
+			return struct{}{}, nil
+		})
+		if err != nil {
+			if errors.Is(err, gobreaker.ErrOpenState) || errors.Is(err, gobreaker.ErrTooManyRequests) {
+				c.AbortWithStatusJSON(http.StatusServiceUnavailable, gin.H{
+					"error":       "circuit_open",
+					"retry_after": 30,
+				})
+				return
+			}
+			return
+		}
+	}, cb
+}
+
+func setupRouter(cbMW gin.HandlerFunc, downstreamStatus int) *gin.Engine {
+	gin.SetMode(gin.TestMode)
+	r := gin.New()
+	r.Use(cbMW)
+	r.GET("/test", func(c *gin.Context) {
+		c.Status(downstreamStatus)
+	})
+	return r
+}
+
+// TestCircuitBreaker_ClosedToOpen 验证 5 秒窗口内错误率 > 50% 触发 CLOSED → OPEN。
+// ReadyToTrip 逻辑：TotalFailures*2 > Requests。
+// 第 1 次 5xx 后（Requests=1, Failures=1, 1*2>1）即触发；第 2 次请求被熔断直接返回 503。
+func TestCircuitBreaker_ClosedToOpen(t *testing.T) {
+	mw, cb := newTestCircuitBreaker(t, time.Second, 30*time.Second)
+	r := setupRouter(mw, http.StatusInternalServerError)
+
+	// 第 1 次 5xx：放行到下游，触发 ReadyToTrip
+	w := httptest.NewRecorder()
+	req := httptest.NewRequest(http.MethodGet, "/test", nil)
+	r.ServeHTTP(w, req)
+	if w.Code != http.StatusInternalServerError {
+		t.Fatalf("第 1 次请求期望 500，实际 %d", w.Code)
+	}
+
+	// 第 2 次请求应触发熔断：返回 503 + circuit_open
+	w = httptest.NewRecorder()
+	req = httptest.NewRequest(http.MethodGet, "/test", nil)
+	r.ServeHTTP(w, req)
+	if w.Code != http.StatusServiceUnavailable {
+		t.Fatalf("熔断后应返回 503，实际 %d", w.Code)
+	}
+	if !strings.Contains(w.Body.String(), "circuit_open") {
+		t.Fatalf("响应体应包含 circuit_open，实际 %s", w.Body.String())
+	}
+	if cb.State() != gobreaker.StateOpen {
+		t.Fatalf("CB 状态应为 OPEN，实际 %s", cb.State())
+	}
+}
+
+// TestCircuitBreaker_OpenToHalfOpen 验证 OPEN 状态经过 Timeout 后转 HALF_OPEN，允许 1 个探测请求。
+// 注意：HALF_OPEN 状态只在探测请求执行期间可见；探测完成后（无论成功失败）状态会立刻转 CLOSED 或回 OPEN。
+// 因此本测试通过行为验证：OPEN 期间请求被拒（503），Timeout 后请求放行到下游（500）证明进入了 HALF_OPEN。
+func TestCircuitBreaker_OpenToHalfOpen(t *testing.T) {
+	mw, cb := newTestCircuitBreaker(t, time.Second, 100*time.Millisecond)
+	r := setupRouter(mw, http.StatusInternalServerError)
+
+	// 触发熔断（1 次 5xx 即可）
+	w := httptest.NewRecorder()
+	req := httptest.NewRequest(http.MethodGet, "/test", nil)
+	r.ServeHTTP(w, req)
+	if cb.State() != gobreaker.StateOpen {
+		t.Fatalf("预置条件失败：CB 应为 OPEN，实际 %s", cb.State())
+	}
+
+	// 立即再次请求：应被熔断拒绝（503）
+	w = httptest.NewRecorder()
+	req = httptest.NewRequest(http.MethodGet, "/test", nil)
+	r.ServeHTTP(w, req)
+	if w.Code != http.StatusServiceUnavailable {
+		t.Fatalf("OPEN 期间请求应被拒（503），实际 %d", w.Code)
+	}
+
+	// 等待 Timeout + 少量缓冲 → 状态转为 HALF_OPEN
+	time.Sleep(150 * time.Millisecond)
+
+	// 探测请求应放行到下游（返回 500，而非 503）
+	// 证明状态已从 OPEN → HALF_OPEN（否则会返回 503）
+	w = httptest.NewRecorder()
+	req = httptest.NewRequest(http.MethodGet, "/test", nil)
+	r.ServeHTTP(w, req)
+	if w.Code != http.StatusInternalServerError {
+		t.Fatalf("HALF_OPEN 探测请求应放行到下游（500），实际 %d", w.Code)
+	}
+	// 探测失败（下游 500）→ 状态回 OPEN
+	if cb.State() != gobreaker.StateOpen {
+		t.Fatalf("探测失败后 CB 应回 OPEN，实际 %s", cb.State())
+	}
+}
+
+// TestCircuitBreaker_HalfOpenToClosed 验证 HALF_OPEN 探测成功后转 CLOSED。
+func TestCircuitBreaker_HalfOpenToClosed(t *testing.T) {
+	mw, cb := newTestCircuitBreaker(t, time.Second, 100*time.Millisecond)
+	// 下游成功（200），让探测能成功
+	r := setupRouter(mw, http.StatusOK)
+
+	// 先用另一个 router 触发熔断（下游 500）
+	badR := setupRouter(mw, http.StatusInternalServerError)
+	for i := 0; i < 4; i++ {
+		w := httptest.NewRecorder()
+		req := httptest.NewRequest(http.MethodGet, "/test", nil)
+		badR.ServeHTTP(w, req)
+	}
+	if cb.State() != gobreaker.StateOpen {
+		t.Fatalf("预置条件失败：CB 应为 OPEN，实际 %s", cb.State())
+	}
+
+	// 等待 Timeout → HALF_OPEN
+	time.Sleep(150 * time.Millisecond)
+
+	// 探测请求（下游 200）→ 成功 → 转 CLOSED
+	w := httptest.NewRecorder()
+	req := httptest.NewRequest(http.MethodGet, "/test", nil)
+	r.ServeHTTP(w, req)
+	if w.Code != http.StatusOK {
+		t.Fatalf("探测请求应返回 200，实际 %d", w.Code)
+	}
+	if cb.State() != gobreaker.StateClosed {
+		t.Fatalf("探测成功后 CB 应为 CLOSED，实际 %s", cb.State())
+	}
+}
+
+// TestCircuitBreaker_HalfOpenToOpen 验证 HALF_OPEN 探测失败后转回 OPEN。
+func TestCircuitBreaker_HalfOpenToOpen(t *testing.T) {
+	mw, cb := newTestCircuitBreaker(t, time.Second, 100*time.Millisecond)
+	r := setupRouter(mw, http.StatusInternalServerError)
+
+	// 触发熔断
+	for i := 0; i < 4; i++ {
+		w := httptest.NewRecorder()
+		req := httptest.NewRequest(http.MethodGet, "/test", nil)
+		r.ServeHTTP(w, req)
+	}
+	if cb.State() != gobreaker.StateOpen {
+		t.Fatalf("预置条件失败：CB 应为 OPEN，实际 %s", cb.State())
+	}
+
+	// 等待 Timeout → HALF_OPEN
+	time.Sleep(150 * time.Millisecond)
+
+	// 探测请求（下游 500）→ 失败 → 转 OPEN
+	w := httptest.NewRecorder()
+	req := httptest.NewRequest(http.MethodGet, "/test", nil)
+	r.ServeHTTP(w, req)
+	if cb.State() != gobreaker.StateOpen {
+		t.Fatalf("探测失败后 CB 应重新转 OPEN，实际 %s", cb.State())
+	}
+}
+
+// TestCircuitBreaker_4xxNotCounted 验证 4xx 响应不计入熔断失败计数。
+func TestCircuitBreaker_4xxNotCounted(t *testing.T) {
+	var callCount int32
+	mw, cb := newTestCircuitBreaker(t, time.Second, 30*time.Second)
+
+	gin.SetMode(gin.TestMode)
+	r := gin.New()
+	r.Use(mw)
+	r.GET("/test", func(c *gin.Context) {
+		atomic.AddInt32(&callCount, 1)
+		c.Status(http.StatusNotFound) // 404
+	})
+
+	// 触发 10 次 404，应不触发熔断
+	for i := 0; i < 10; i++ {
+		w := httptest.NewRecorder()
+		req := httptest.NewRequest(http.MethodGet, "/test", nil)
+		r.ServeHTTP(w, req)
+		if w.Code != http.StatusNotFound {
+			t.Fatalf("请求 %d 应返回 404，实际 %d", i+1, w.Code)
+		}
+	}
+
+	if cb.State() != gobreaker.StateClosed {
+		t.Fatalf("4xx 不应触发熔断，CB 应保持 CLOSED，实际 %s", cb.State())
+	}
+
+	// 所有请求应都到达下游（未被熔断短路）
+	if got := atomic.LoadInt32(&callCount); got != 10 {
+		t.Fatalf("下游应被调用 10 次，实际 %d", got)
+	}
+}

services/api-gateway/internal/middleware/ratelimit_test.go

@@ -0,0 +1,151 @@
+package middleware
+
+import (
+	"net/http"
+	"net/http/httptest"
+	"sync/atomic"
+	"testing"
+	"time"
+
+	"github.com/gin-gonic/gin"
+)
+
+// newRateLimitRouter 构造一个使用 RateLimit 中间件、所有请求都返回 200 的测试 router。
+// 返回 router 与下游被调用次数计数器，便于断言请求是否被放行。
+func newRateLimitRouter(rps float64, burst int) (*gin.Engine, *int32) {
+	gin.SetMode(gin.TestMode)
+	var count int32
+	r := gin.New()
+	r.Use(RateLimit(rps, burst))
+	r.GET("/test", func(c *gin.Context) {
+		atomic.AddInt32(&count, 1)
+		c.Status(http.StatusOK)
+	})
+	return r, &count
+}
+
+// doRequest 发起一次测试请求，返回响应状态码。
+func doRequest(r *gin.Engine, remoteAddr string) int {
+	w := httptest.NewRecorder()
+	req := httptest.NewRequest(http.MethodGet, "/test", nil)
+	req.RemoteAddr = remoteAddr
+	r.ServeHTTP(w, req)
+	return w.Code
+}
+
+// TestRateLimit_AllowUnderBurst 验证突发请求 ≤ burst 时全部放行。
+func TestRateLimit_AllowUnderBurst(t *testing.T) {
+	r, count := newRateLimitRouter(0.1 /*rps*/, 5 /*burst*/)
+
+	// 5 个请求应全部放行（初始满桶 5 令牌）
+	for i := 0; i < 5; i++ {
+		if code := doRequest(r, "1.1.1.1:1234"); code != http.StatusOK {
+			t.Fatalf("请求 %d 应放行（200），实际 %d", i+1, code)
+		}
+	}
+	if got := atomic.LoadInt32(count); got != 5 {
+		t.Fatalf("下游应被调用 5 次，实际 %d", got)
+	}
+}
+
+// TestRateLimit_RejectOverBurst 验证突发请求 > burst 时返回 429。
+func TestRateLimit_RejectOverBurst(t *testing.T) {
+	r, count := newRateLimitRouter(0.1 /*rps*/, 3 /*burst*/)
+
+	// 前 3 个放行
+	for i := 0; i < 3; i++ {
+		if code := doRequest(r, "2.2.2.2:1234"); code != http.StatusOK {
+			t.Fatalf("请求 %d 应放行（200），实际 %d", i+1, code)
+		}
+	}
+	// 第 4 个应被限流（429）
+	if code := doRequest(r, "2.2.2.2:1234"); code != http.StatusTooManyRequests {
+		t.Fatalf("第 4 个请求应被限流（429），实际 %d", code)
+	}
+	if got := atomic.LoadInt32(count); got != 3 {
+		t.Fatalf("下游应被调用 3 次，实际 %d", got)
+	}
+}
+
+// TestRateLimit_RefillTokens 验证令牌按 rps 速率补充。
+// rps=10 表示每秒补 10 个令牌，即每 100ms 补 1 个；消耗 1 个后等待 ~150ms 应补回 1+ 个。
+func TestRateLimit_RefillTokens(t *testing.T) {
+	r, count := newRateLimitRouter(10 /*rps*/, 1 /*burst*/)
+
+	// 第 1 个放行（消耗唯一令牌）
+	if code := doRequest(r, "3.3.3.3:1234"); code != http.StatusOK {
+		t.Fatalf("第 1 个请求应放行（200），实际 %d", code)
+	}
+	// 立即第 2 个应被限流（无令牌）
+	if code := doRequest(r, "3.3.3.3:1234"); code != http.StatusTooManyRequests {
+		t.Fatalf("第 2 个请求应被限流（429），实际 %d", code)
+	}
+	// 等待 150ms，应补充 1.5 个令牌（capped 至 burst=1）
+	time.Sleep(150 * time.Millisecond)
+	// 第 3 个应再次放行
+	if code := doRequest(r, "3.3.3.3:1234"); code != http.StatusOK {
+		t.Fatalf("等待补充后请求应放行（200），实际 %d", code)
+	}
+	if got := atomic.LoadInt32(count); got != 2 {
+		t.Fatalf("下游应被调用 2 次，实际 %d", got)
+	}
+}
+
+// TestRateLimit_PerIPIsolation 验证不同 IP 的桶相互独立。
+func TestRateLimit_PerIPIsolation(t *testing.T) {
+	r, count := newRateLimitRouter(0.1 /*rps*/, 2 /*burst*/)
+
+	// IP A 消耗 2 个令牌（满桶）
+	for i := 0; i < 2; i++ {
+		if code := doRequest(r, "10.0.0.1:1234"); code != http.StatusOK {
+			t.Fatalf("IP A 请求 %d 应放行，实际 %d", i+1, code)
+		}
+	}
+	// IP A 第 3 个应被限流
+	if code := doRequest(r, "10.0.0.1:1234"); code != http.StatusTooManyRequests {
+		t.Fatalf("IP A 第 3 个请求应被限流，实际 %d", code)
+	}
+	// IP B 仍有独立满桶，应放行
+	if code := doRequest(r, "10.0.0.2:1234"); code != http.StatusOK {
+		t.Fatalf("IP B 第 1 个请求应放行（独立桶），实际 %d", code)
+	}
+	if got := atomic.LoadInt32(count); got != 3 {
+		t.Fatalf("下游应被调用 3 次（A×2 + B×1），实际 %d", got)
+	}
+}
+
+// TestRateLimit_CleanupExpiredBuckets 验证 10 分钟无访问的桶被清理。
+// 使用短周期参数（50ms 间隔、500ms 过期）加速测试；直接构造 rateLimiter 而不经过 RateLimit
+// （后者会启动 5min/10min 的清理 goroutine，无法在测试中观察）。
+// 时序：创建旧桶（1h 前）→ 启动 cleanup → 等 100ms（旧桶被清，无新桶）→ 创建新桶 → 等 100ms（新桶未过 500ms，保留）。
+func TestRateLimit_CleanupExpiredBuckets(t *testing.T) {
+	rl := &rateLimiter{rps: 1, burst: 1}
+
+	// 创建旧桶并人为把 lastTime 调到 1 小时前
+	b := rl.getBucket("9.9.9.9:1234")
+	b.mu.Lock()
+	b.lastTime = time.Now().Add(-1 * time.Hour)
+	b.mu.Unlock()
+
+	// 启动 cleanup，50ms 间隔、500ms 过期
+	go rl.cleanup(50*time.Millisecond, 500*time.Millisecond)
+
+	// 等 100ms 让 cleanup 执行（旧桶 lastTime=1h 前，远超 500ms，必被清）
+	time.Sleep(100 * time.Millisecond)
+
+	// 旧桶应已清理
+	if _, ok := rl.buckets.Load("9.9.9.9:1234"); ok {
+		t.Fatal("1 小时无访问的旧桶应被清理")
+	}
+
+	// 此时创建新鲜桶（lastTime = now）
+	rl.getBucket("8.8.8.8:1234")
+
+	// 再等 100ms 让 cleanup 再执行
+	time.Sleep(100 * time.Millisecond)
+
+	// 新鲜桶 lastTime 仅 ~100ms 前，未超 500ms maxIdle，应保留
+	if _, ok := rl.buckets.Load("8.8.8.8:1234"); !ok {
+		t.Fatal("新鲜桶（<500ms）不应被清理")
+	}
+}

services/content/README.md

@@ -30,7 +30,7 @@ pnpm test
 ## 环境变量
 
 | 变量                          | 说明                            |
-|------|------|
+| ----------------------------- | ------------------------------- |
 | `PORT`                        | 服务端口（默认 3005）           |
 | `DATABASE_URL`                | MySQL 连接串                    |
 | `NEO4J_URL`                   | Neo4j Bolt 连接 URL             |
@@ -60,6 +60,15 @@ src/
 - `TextbooksService.createKnowledgeGraph` 在 Neo4j 构建知识点前置依赖
 - `TextbooksService.getPrerequisites` 查询知识点前置链路
 
+## 健康检查
+
+| 端点           | 用途                                              | 鉴权 |
+| -------------- | ------------------------------------------------- | ---- |
+| `GET /healthz` | 存活探针（liveness），仅返回进程状态，不检查依赖  | 无   |
+| `GET /readyz`  | 就绪探针（readiness），检查 DB 连接，失败返回 503 | 无   |
+
+实现见 `src/shared/health/health.controller.ts`，5 个 NestJS 服务（iam/core-edu/content/msg/classes）一致。
+
 ## 对外契约
 
 gRPC 服务 `TextbookService`、`KnowledgeGraphService` 定义见 `packages/shared-proto/proto/content.proto`。

services/core-edu/README.md

@@ -44,9 +44,18 @@ pnpm test
 ## 环境变量
 
 | 变量                          | 说明                          | 默认           |
-|------|------|------|
+| ----------------------------- | ----------------------------- | -------------- |
 | `PORT`                        | 服务端口                      | 3004           |
 | `DATABASE_URL`                | MySQL 连接串                  | -              |
 | `KAFKA_BROKERS`               | Kafka broker 列表（逗号分隔） | localhost:9092 |
 | `JWT_SECRET`                  | JWT 密钥                      | -              |
 | `OTEL_EXPORTER_OTLP_ENDPOINT` | OTLP 上报地址（可选）         | -              |
+
+## 健康检查
+
+| 端点           | 用途                                              | 鉴权 |
+| -------------- | ------------------------------------------------- | ---- |
+| `GET /healthz` | 存活探针（liveness），仅返回进程状态，不检查依赖  | 无   |
+| `GET /readyz`  | 就绪探针（readiness），检查 DB 连接，失败返回 503 | 无   |
+
+实现见 `src/shared/health/health.controller.ts`，5 个 NestJS 服务（iam/core-edu/content/msg/classes）一致。

services/data-ana/src/data_ana/clickhouse_client.py

@@ -1,5 +1,7 @@
 """ClickHouse 客户端."""
+
 import clickhouse_connect
+
 from .config import settings
 
 _client = None

services/data-ana/src/data_ana/main.py

@@ -1,12 +1,14 @@
 """数据分析服务入口."""
+
 from contextlib import asynccontextmanager
+
+import structlog
 from fastapi import FastAPI
 from opentelemetry import trace
+from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
 from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import BatchSpanProcessor
-from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
 from prometheus_client import make_asgi_app
-import structlog
 
 logger = structlog.get_logger()
 tracer = trace.get_tracer(__name__)

services/data-ana/src/health/health.py

@@ -8,7 +8,8 @@
     from health import router as health_router
     app.include_router(health_router)
 """
-from datetime import datetime, timezone
+
+from datetime import UTC, datetime
 
 from fastapi import APIRouter
 
@@ -30,5 +31,5 @@ async def readyz() -> dict:
     return {
         "status": "ok",
         "service": SERVICE_NAME,
-        "timestamp": datetime.now(timezone.utc).isoformat(),
+        "timestamp": datetime.now(UTC).isoformat(),
     }

services/iam/README.md

@@ -24,12 +24,21 @@
 ## API
 
 | Method | Path            | 说明                              |
-|--------|------|------|
+| ------ | --------------- | --------------------------------- |
 | POST   | `/iam/register` | 注册                              |
 | POST   | `/iam/login`    | 登录                              |
 | POST   | `/iam/refresh`  | 刷新令牌                          |
 | GET    | `/iam/me`       | 当前用户信息（需 `x-user-id` 头） |
 
+## 健康检查
+
+| 端点           | 用途                                              | 鉴权 |
+| -------------- | ------------------------------------------------- | ---- |
+| `GET /healthz` | 存活探针（liveness），仅返回进程状态，不检查依赖  | 无   |
+| `GET /readyz`  | 就绪探针（readiness），检查 DB 连接，失败返回 503 | 无   |
+
+实现见 `src/shared/health/health.controller.ts`，5 个 NestJS 服务（iam/core-edu/content/msg/classes）一致。
+
 ## 数据表
 
 `iam_users` / `iam_roles` / `iam_user_roles` / `iam_permissions` / `iam_role_permissions` / `iam_refresh_tokens`

services/msg/README.md

@@ -26,16 +26,25 @@ pnpm dev   # http://localhost:3007
 ## API
 
 | 方法 | 路径                     | 说明             |
-|------|------|------|
+| ---- | ------------------------ | ---------------- |
 | POST | /notifications           | 发送通知         |
 | GET  | /notifications           | 查询用户通知列表 |
 | POST | /notifications/:id/read  | 标记已读         |
 | GET  | /notifications/search?q= | 全文检索通知     |
 
+## 健康检查
+
+| 端点           | 用途                                              | 鉴权 |
+| -------------- | ------------------------------------------------- | ---- |
+| `GET /healthz` | 存活探针（liveness），仅返回进程状态，不检查依赖  | 无   |
+| `GET /readyz`  | 就绪探针（readiness），检查 DB 连接，失败返回 503 | 无   |
+
+实现见 `src/shared/health/health.controller.ts`，5 个 NestJS 服务（iam/core-edu/content/msg/classes）一致。
+
 ## 环境变量
 
 | 变量          | 默认值                | 说明               |
-|------|--------|------|
+| ------------- | --------------------- | ------------------ |
 | PORT          | 3007                  | 服务端口           |
 | DATABASE_URL  | -                     | MySQL 连接串       |
 | KAFKA_BROKERS | localhost:9092        | Kafka broker 列表  |

services/push-gateway/go.mod

@@ -5,7 +5,34 @@ go 1.22
 require (
 	github.com/gin-gonic/gin v1.10.0
 	github.com/golang-jwt/jwt/v5 v5.2.1
-	github.com/google/uuid v1.6.0
 	github.com/gorilla/websocket v1.5.3
-	go.uber.org/zap v1.27.0
+)
+
+require (
+	github.com/bytedance/sonic v1.11.6 // indirect
+	github.com/bytedance/sonic/loader v0.1.1 // indirect
+	github.com/cloudwego/base64x v0.1.4 // indirect
+	github.com/cloudwego/iasm v0.2.0 // indirect
+	github.com/gabriel-vasile/mimetype v1.4.3 // indirect
+	github.com/gin-contrib/sse v0.1.0 // indirect
+	github.com/go-playground/locales v0.14.1 // indirect
+	github.com/go-playground/universal-translator v0.18.1 // indirect
+	github.com/go-playground/validator/v10 v10.20.0 // indirect
+	github.com/goccy/go-json v0.10.2 // indirect
+	github.com/json-iterator/go v1.1.12 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.7 // indirect
+	github.com/leodido/go-urn v1.4.0 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
+	github.com/modern-go/reflect2 v1.0.2 // indirect
+	github.com/pelletier/go-toml/v2 v2.2.2 // indirect
+	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
+	github.com/ugorji/go/codec v1.2.12 // indirect
+	golang.org/x/arch v0.8.0 // indirect
+	golang.org/x/crypto v0.23.0 // indirect
+	golang.org/x/net v0.25.0 // indirect
+	golang.org/x/sys v0.20.0 // indirect
+	golang.org/x/text v0.15.0 // indirect
+	google.golang.org/protobuf v1.34.1 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
 )

services/push-gateway/go.sum

@@ -0,0 +1,93 @@
+github.com/bytedance/sonic v1.11.6 h1:oUp34TzMlL+OY1OUWxHqsdkgC/Zfc85zGqw9siXjrc0=
+github.com/bytedance/sonic v1.11.6/go.mod h1:LysEHSvpvDySVdC2f87zGWf6CIKJcAvqab1ZaiQtds4=
+github.com/bytedance/sonic/loader v0.1.1 h1:c+e5Pt1k/cy5wMveRDyk2X4B9hF4g7an8N3zCYjJFNM=
+github.com/bytedance/sonic/loader v0.1.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU=
+github.com/cloudwego/base64x v0.1.4 h1:jwCgWpFanWmN8xoIUHa2rtzmkd5J2plF/dnLS6Xd/0Y=
+github.com/cloudwego/base64x v0.1.4/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w=
+github.com/cloudwego/iasm v0.2.0 h1:1KNIy1I1H9hNNFEEH3DVnI4UujN+1zjpuk6gwHLTssg=
+github.com/cloudwego/iasm v0.2.0/go.mod h1:8rXZaNYT2n95jn+zTI1sDr+IgcD2GVs0nlbbQPiEFhY=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/gabriel-vasile/mimetype v1.4.3 h1:in2uUcidCuFcDKtdcBxlR0rJ1+fsokWf+uqxgUFjbI0=
+github.com/gabriel-vasile/mimetype v1.4.3/go.mod h1:d8uq/6HKRL6CGdk+aubisF/M5GcPfT7nKyLpA0lbSSk=
+github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE=
+github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI=
+github.com/gin-gonic/gin v1.10.0 h1:nTuyha1TYqgedzytsKYqna+DfLos46nTv2ygFy86HFU=
+github.com/gin-gonic/gin v1.10.0/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y=
+github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s=
+github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
+github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA=
+github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
+github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
+github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
+github.com/go-playground/validator/v10 v10.20.0 h1:K9ISHbSaI0lyB2eWMPJo+kOS/FBExVwjEviJTixqxL8=
+github.com/go-playground/validator/v10 v10.20.0/go.mod h1:dbuPbCMFw/DrkbEynArYaCwl3amGuJotoKCe95atGMM=
+github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU=
+github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I=
+github.com/golang-jwt/jwt/v5 v5.2.1 h1:OuVbFODueb089Lh128TAcimifWaLhJwVflnrgM17wHk=
+github.com/golang-jwt/jwt/v5 v5.2.1/go.mod h1:pqrtFR0X4osieyHYxtmOUWsAWrfe1Q5UVIyoH402zdk=
+github.com/google/go-cmp v0.5.5 h1:Khx7svrCpmxxtHBq5j2mp/xVjsi8hQMfNLvJFAlrGgU=
+github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
+github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
+github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg=
+github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
+github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
+github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
+github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
+github.com/klauspost/cpuid/v2 v2.2.7 h1:ZWSB3igEs+d0qvnxR/ZBzXVmxkgt8DdzP6m9pfuVLDM=
+github.com/klauspost/cpuid/v2 v2.2.7/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws=
+github.com/knz/go-libedit v1.10.1/go.mod h1:MZTVkCWyz0oBc7JOWP3wNAzd002ZbM/5hgShxwh4x8M=
+github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=
+github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
+github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
+github.com/pelletier/go-toml/v2 v2.2.2 h1:aYUidT7k73Pcl9nb2gScu7NSrKCSHIDE89b3+6Wq+LM=
+github.com/pelletier/go-toml/v2 v2.2.2/go.mod h1:1t835xjRzz80PqgE6HHgN2JOsmgYu/h4qDAS4n929Rs=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
+github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
+github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
+github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
+github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
+github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=
+github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI=
+github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08=
+github.com/ugorji/go/codec v1.2.12 h1:9LC83zGrHhuUA9l16C9AHXAqEV/2wBQ4nkvumAE65EE=
+github.com/ugorji/go/codec v1.2.12/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
+golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
+golang.org/x/arch v0.8.0 h1:3wRIsP3pM4yUptoR96otTUOXI367OS0+c9eeRi9doIc=
+golang.org/x/arch v0.8.0/go.mod h1:FEVrYAQjsQXMVJ1nsMoVVXPZg6p2JE2mx8psSWTDQys=
+golang.org/x/crypto v0.23.0 h1:dIJU/v2J8Mdglj/8rJ6UUOM3Zc9zLZxVZwwxMooUSAI=
+golang.org/x/crypto v0.23.0/go.mod h1:CKFgDieR+mRhux2Lsu27y0fO304Db0wZe70UKqHu0v8=
+golang.org/x/net v0.25.0 h1:d/OCCoBEUq33pjydKrGQhw7IlUPI2Oylr+8qLx49kac=
+golang.org/x/net v0.25.0/go.mod h1:JkAGAh7GEvH74S6FOH42FLoXpXbE/aqXSrIQjXgsiwM=
+golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.20.0 h1:Od9JTbYCk261bKm4M/mw7AklTlFYIa0bIp9BgSm1S8Y=
+golang.org/x/sys v0.20.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
+golang.org/x/text v0.15.0 h1:h1V/4gjBv8v9cjcR6+AR5+/cIYK5N/WAgiv4xlsEtAk=
+golang.org/x/text v0.15.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU=
+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543 h1:E7g+9GITq07hpfrRu66IVDexMakfv52eLZ2CXBWiKr4=
+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+google.golang.org/protobuf v1.34.1 h1:9ddQBjfCyZPOHPUiPxpYESBLc+T8P3E+Vo4IbKZgFWg=
+google.golang.org/protobuf v1.34.1/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+nullprogram.com/x/optparse v1.0.0/go.mod h1:KdyPE+Igbe0jQUrVfMqDMeJQIJZEuyV7pjYmp6pbG50=
+rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4=

uv.lock

@@ -0,0 +1,973 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+resolution-markers = [
+    "python_full_version >= '3.14'",
+    "python_full_version < '3.14'",
+]
+
+[manifest]
+members = [
+    "ai-service",
+    "data-ana-service",
+]
+
+[[package]]
+name = "ai-service"
+version = "0.1.0"
+source = { virtual = "services/ai" }
+dependencies = [
+    { name = "fastapi" },
+    { name = "httpx" },
+    { name = "opentelemetry-api" },
+    { name = "opentelemetry-sdk" },
+    { name = "prometheus-client" },
+    { name = "pydantic" },
+    { name = "pydantic-settings" },
+    { name = "structlog" },
+    { name = "uvicorn", extra = ["standard"] },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "fastapi", specifier = ">=0.115.0" },
+    { name = "httpx", specifier = ">=0.27.0" },
+    { name = "opentelemetry-api", specifier = ">=1.27.0" },
+    { name = "opentelemetry-sdk", specifier = ">=1.27.0" },
+    { name = "prometheus-client", specifier = ">=0.20.0" },
+    { name = "pydantic", specifier = ">=2.9.0" },
+    { name = "pydantic-settings", specifier = ">=2.5.0" },
+    { name = "structlog", specifier = ">=24.4.0" },
+    { name = "uvicorn", extras = ["standard"], specifier = ">=0.30.0" },
+]
+
+[[package]]
+name = "annotated-doc"
+version = "0.0.4"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/57/ba/046ceea27344560984e26a590f90bc7f4a75b06701f653222458922b558c/annotated_doc-0.0.4.tar.gz", hash = "sha256:fbcda96e87e9c92ad167c2e53839e57503ecfda18804ea28102353485033faa4", size = 7288, upload-time = "2025-11-10T22:07:42.062Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1e/d3/26bf1008eb3d2daa8ef4cacc7f3bfdc11818d111f7e2d0201bc6e3b49d45/annotated_doc-0.0.4-py3-none-any.whl", hash = "sha256:571ac1dc6991c450b25a9c2d84a3705e2ae7a53467b5d111c24fa8baabbed320", size = 5303, upload-time = "2025-11-10T22:07:40.673Z" },
+]
+
+[[package]]
+name = "annotated-types"
+version = "0.7.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081, upload-time = "2024-05-20T21:33:25.928Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" },
+]
+
+[[package]]
+name = "anyio"
+version = "4.14.1"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/3b/72/5562aabb8dd7181e8e860622a38bea08d17842b99ecd4c91f84ac95251b0/anyio-4.14.1.tar.gz", hash = "sha256:8d648a3544c1a700e3ff78615cd679e4c5c3f149904287e73687b2596963629e", size = 254831, upload-time = "2026-06-24T20:56:06.017Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b0/7b/90df4a0a816d98d6ea26f559d87836d494a2cf1fcf063be67df50a7bcc30/anyio-4.14.1-py3-none-any.whl", hash = "sha256:4e5533c5b8ff0a24f5d7a176cbe6877129cd183893f66b537f8f227d10527d72", size = 124875, upload-time = "2026-06-24T20:56:04.413Z" },
+]
+
+[[package]]
+name = "asgiref"
+version = "3.11.1"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/63/40/f03da1264ae8f7cfdbf9146542e5e7e8100a4c66ab48e791df9a03d3f6c0/asgiref-3.11.1.tar.gz", hash = "sha256:5f184dc43b7e763efe848065441eac62229c9f7b0475f41f80e207a114eda4ce", size = 38550, upload-time = "2026-02-03T13:30:14.33Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5c/0a/a72d10ed65068e115044937873362e6e32fab1b7dce0046aeb224682c989/asgiref-3.11.1-py3-none-any.whl", hash = "sha256:e8667a091e69529631969fd45dc268fa79b99c92c5fcdda727757e52146ec133", size = 24345, upload-time = "2026-02-03T13:30:13.039Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.6.17"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c9/c7/424b75da314c1045981bd9777432fad05a9e0c69daa4ed7e308bbaffe405/certifi-2026.6.17.tar.gz", hash = "sha256:024c88eeec92ca068db80f02b8b07c9cef7b9fe261d1d535abfd5abd6f6af432", size = 134594, upload-time = "2026-06-17T10:31:07.894Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ef/2f/c5464532e965badff2f4c4c1a3a83f5697f0d7c407ed0cda44aaa99bb451/certifi-2026.6.17-py3-none-any.whl", hash = "sha256:2227dcbaafe0d2f59279d1762ddddc37783ed4354594f194ffc31d20f41fc3db", size = 133289, upload-time = "2026-06-17T10:31:06.348Z" },
+]
+
+[[package]]
+name = "click"
+version = "8.4.2"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/76/d4/81420972a676e8ffea40450d8c8c92943e7218a78fe9b64359836cc9876b/click-8.4.2.tar.gz", hash = "sha256:9a6cea6e60b17ebe0a44c5cc636d94f09bd66142c1cd7d8b4cd731c4917a15f6", size = 338000, upload-time = "2026-06-24T17:45:15.148Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fb/e2/79c688af8b210d232694e31e59da9f6ec747bae31c3f5946e4e9b98860d5/click-8.4.2-py3-none-any.whl", hash = "sha256:e6f9f66136c816745b9d65817da91d61d957fb16e02e4dcd0552553c5a197b76", size = 119243, upload-time = "2026-06-24T17:45:13.73Z" },
+]
+
+[[package]]
+name = "clickhouse-connect"
+version = "1.4.2"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "lz4" },
+    { name = "tzdata", marker = "sys_platform == 'win32'" },
+    { name = "urllib3" },
+    { name = "zstandard" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9f/50/c182388d51f36e8c875d0355fffddd3edd8d024fe872b8f6b0482cd03e1b/clickhouse_connect-1.4.2.tar.gz", hash = "sha256:b7acd9f4054478ec1f33e021750cfb7835109bc9cbc29429aa23b526ec118b26", size = 167436, upload-time = "2026-07-06T20:27:58.18Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9d/e3/e38c4098c6f772c51a11c0fffec07a3913c02f42f7db88247fe67591886f/clickhouse_connect-1.4.2-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:711865cf2e0c3d5106f5e73450a186939f9ff141ad796d0be1a7701a4b67834e", size = 349368, upload-time = "2026-07-06T20:27:00.202Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/7d/cd/4d71b5228be111c501d153fe67636fa04a160044a025d49ebba70684a7c3/clickhouse_connect-1.4.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ffb1c30fca29aa1b2d81301ace94803a7a8508b28f0a1d2448e717522304b62d", size = 337787, upload-time = "2026-07-06T20:27:01.479Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/28/97/7ce322affe0ffb0db00fc0a5b496c15eb587ab0be2037ea0d47ddf968598/clickhouse_connect-1.4.2-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:329b22c13c5e92539011a1d0b718997616e9d9a0c751804b1b88a2bb71081a3b", size = 1298533, upload-time = "2026-07-06T20:27:02.829Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/cb/9f/ec1b6e286fd26c8528f68557a0614743692ad6267189d220b1b9bcf4736a/clickhouse_connect-1.4.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d87b6666d6e3732ec9fb2c29e37eb190f56720bd4ef9cdc9e7b400c66925977d", size = 1322368, upload-time = "2026-07-06T20:27:04.134Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8a/86/7e01a7cfee69fb935aedee3f5a717862ca0eafc64703aac6de8f3e84ca47/clickhouse_connect-1.4.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:247184beca8f4b33d40a0f6d06796be6a614668611d1a0aaffee354a254ccb94", size = 1275822, upload-time = "2026-07-06T20:27:05.374Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/96/15/9b319d1fa6f676644057b2170b240f2e8e46cc7a0aa3ce1a4f79928cea94/clickhouse_connect-1.4.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:62a3b0d5fc2cc5a201cbb0ec26b781b1a0ec05e3e369262d8da2439a0c683eeb", size = 1318392, upload-time = "2026-07-06T20:27:06.799Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/81/62/9c786dc25327397fe7e1acf63a5d91ea71b4717b61a09e88763d047ad569/clickhouse_connect-1.4.2-cp312-cp312-win32.whl", hash = "sha256:e9aa5f20caf0927c30749262d3dac8c9270823625950c17c9bcc2b4fb20fbeb7", size = 312237, upload-time = "2026-07-06T20:27:08.034Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ec/81/a064993bed1c821c20568348bb3319aa112b70a4ab4a9804a0dbf9f0f158/clickhouse_connect-1.4.2-cp312-cp312-win_amd64.whl", hash = "sha256:011449ff0be6a4ced278a717226898ee4d90b2ab82ab5b4fabafcef0f0f0a1b5", size = 331364, upload-time = "2026-07-06T20:27:09.323Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ce/21/b583f7479d8a28a451f8d1443da741a7ec8a42a01ae95cfb079fd8f1b0df/clickhouse_connect-1.4.2-cp312-cp312-win_arm64.whl", hash = "sha256:2dc0d7dffd6332704fdcff682a455ff8e0210d59fc139b5d37d21e2166c723d9", size = 312369, upload-time = "2026-07-06T20:27:10.533Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e3/01/a699ef5430afcb753eb938990cf3fb6b8de1beb8bb57d4033f6ab3eb6df7/clickhouse_connect-1.4.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:cd5a7acc8e4d74f0b37460aa3e2e5c17a30041c827ba1c9b7f2e2693c178a2ea", size = 347426, upload-time = "2026-07-06T20:27:11.67Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5e/b1/d9b03d3644dcb8e0dd222071b08cb32aac28aec397a955bb97f5e09057fb/clickhouse_connect-1.4.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:c5930cebdae3e8d7924ed7294871f0a84defc6a6a2616623bb5426914f43acb3", size = 336144, upload-time = "2026-07-06T20:27:13.219Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/43/e6/71fe3868cb5185b154234851d44fa1d7784f2aef9f8b9ed0679abd61272c/clickhouse_connect-1.4.2-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:613618df638fa131d7d78f2e5a768a942b08d7a6b92fc16f0deb3cd68905b031", size = 1269953, upload-time = "2026-07-06T20:27:14.629Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e8/ec/afe8cba187e83dd45b51418c241dbb9390594bf102fa38f138251afa15b7/clickhouse_connect-1.4.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4f5c4087f72ea97583cb4709f027950221ec851409f7188d43fa02f82b907abb", size = 1294261, upload-time = "2026-07-06T20:27:16.086Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/20/ca/90b897d6921a252aa6103002365d0f035dfacd94ea5ededa965686ad34cc/clickhouse_connect-1.4.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:cb86318e07aa884b3f8ee7b7265a1eedde24e27eaa3ab21d9a6d37cb92c501dc", size = 1246968, upload-time = "2026-07-06T20:27:17.635Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/93/87/1454be1ed4534c11e4d22fbf1eeecf249e7c84cc58c2f349f7e8b9f97d9e/clickhouse_connect-1.4.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:f4c697a638103a46bd94720f63579c6ad210bea89222e903d6ea169d43ac4698", size = 1290256, upload-time = "2026-07-06T20:27:18.984Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/2e/0e/b8ea7917c66ffddcdd50d179bff83307d2b1831c2577f55d55ad92fd3f9a/clickhouse_connect-1.4.2-cp313-cp313-win32.whl", hash = "sha256:9820ace8d22a375c395afe520038a7593901606af5d0ab747d3dbf68c6e368f6", size = 311636, upload-time = "2026-07-06T20:27:20.892Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a8/c9/9812a597c011dc9f305641dd5fcdb864c9717846414ee411549b277faee1/clickhouse_connect-1.4.2-cp313-cp313-win_amd64.whl", hash = "sha256:7d7b6b55a5137dc15eac3647e3477d8bd5f2f914265a7a0381c07047c3b00ef1", size = 329895, upload-time = "2026-07-06T20:27:22.326Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b6/e1/c067fc819a09e1fae3b1037f294eec50f6cad94d95b13c7a4f4e2731c1fe/clickhouse_connect-1.4.2-cp313-cp313-win_arm64.whl", hash = "sha256:b447384bbf7211d4eb6983099cbb1aff582a9b99a0f3cd9f6299db998ee6609e", size = 311717, upload-time = "2026-07-06T20:27:23.808Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/4c/f0/b2527b44a7ac84862f155744e903605ef7ebc23509c21613fc9aa0371255/clickhouse_connect-1.4.2-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:b4628fc1e7c2bfb7a1729ff978fa19d0b6d1702f5510ca97e0bb496e34ad6c07", size = 347712, upload-time = "2026-07-06T20:27:25.236Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/63/a8/9c9f82515b7f7ac8a39aa289bd84e79a6dabd1438b3191cb3db786efc00e/clickhouse_connect-1.4.2-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:e26883406ae07d5333d2ce7cb11808c097e0a8be95199d0b5d683caf9d786356", size = 337029, upload-time = "2026-07-06T20:27:26.653Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e8/f4/888ce2804dbb4d36e27c4c48ac16e62dbc035bf2522ccf83735268c41f12/clickhouse_connect-1.4.2-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d764ae430df98e1f4cbb2366bcdb07719e362bf482d4a2bd75249f6a9eb9c33f", size = 1267654, upload-time = "2026-07-06T20:27:27.868Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d4/64/828b4da76f7d5ca7aa6bc3d5e347ec72896f14afb9a4b797125688b2c146/clickhouse_connect-1.4.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0d9f7ac1b0af39c5a08c66663a92a586bbf9db58959bd376f11ccb5ea5010d93", size = 1283640, upload-time = "2026-07-06T20:27:29.303Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/68/c8/febc7ee7558cabac7cf75d7f18af7974cc773007d4b39f153e9a71241c74/clickhouse_connect-1.4.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:f4a75c6660061e9bfe7ee7dae56492027b0d4c35bb2531147b58103485abb638", size = 1246334, upload-time = "2026-07-06T20:27:30.779Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/0d/f0/cefb1cca19fb170da9adf6801a1a98cf0ef1d55297ad8b814b1d843ddcc8/clickhouse_connect-1.4.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ba7b9746b0cb939a779e35ef43b7fe8351f52a62750d3d4fc9bcf22f1de99ee2", size = 1280820, upload-time = "2026-07-06T20:27:32.58Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/90/bd/d4ad4ae33d4c847cb7dd68821a829b6eb08a57c825865301b329dc14090c/clickhouse_connect-1.4.2-cp314-cp314-win32.whl", hash = "sha256:f1e42c8329318230a6197f88dc81756458d5b7eacf9a10dd9c3a376048ed6f6f", size = 314653, upload-time = "2026-07-06T20:27:34.135Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/93/06/3eb3c4b0dd2030bba9eab0dd5693acf3c46122df3ad670e6c3ef51d1daed/clickhouse_connect-1.4.2-cp314-cp314-win_amd64.whl", hash = "sha256:1d12636bc5181fd5b7aba79a39824adf702d69c57a8df49408304a85af9943db", size = 334666, upload-time = "2026-07-06T20:27:35.406Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/93/97/4fa1f8e3a4bcaa65fed8ea9c4bba95fe84eb582953d188bccdf09260cabd/clickhouse_connect-1.4.2-cp314-cp314-win_arm64.whl", hash = "sha256:74f257256cd44c3408f0368b7b480e1f7c41f6da8824a620273b48a391a0729c", size = 316672, upload-time = "2026-07-06T20:27:36.712Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b8/97/a78153a54e9c4c26f5de83f749255ee9224f56a11abaf1cbea9446843fb9/clickhouse_connect-1.4.2-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:faffacb825ec932d5e49858fd9a3b4a2efe0e12b9bb2bb7661a6caf4f1117127", size = 365724, upload-time = "2026-07-06T20:27:38.081Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9f/33/e378feb9ecc96e02cfa07a91ad8950822db093f868d700c2430f3698e391/clickhouse_connect-1.4.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:a26ce548078de65c5a078bccef70e3517c4c3e36e910ecbf046d23bccbb8edcf", size = 358390, upload-time = "2026-07-06T20:27:39.381Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c5/fa/f69b8da46ce536b2106f52f3a248efc6b179430e558207bba9ad07899d06/clickhouse_connect-1.4.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b8f8df5a137e395f5ca760fc1bb0ea82344f71dc826ac522adafb052ae925f2d", size = 1355492, upload-time = "2026-07-06T20:27:40.755Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/01/06/6c754ebf8fd66b7d153b424d14937fc110450e2ff77baab697aaf3fb5876/clickhouse_connect-1.4.2-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:21893a01b73f5bb7f3fb8cfaae18c8c3f9aed581d7a189918be1d4b90668b7db", size = 1339713, upload-time = "2026-07-06T20:27:42.119Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f1/b6/3f4c0650b00330839aeaee542f31ad286cd277b6e6306fef9aa71d426d35/clickhouse_connect-1.4.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:77cf46a6202e48ac1bf709110b397a06b1ca3fd27d3f261c42226718bd013110", size = 1312554, upload-time = "2026-07-06T20:27:43.686Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c2/c4/964f5cb97f8dd65cf89d0d98fc076780e92028c8c916930687768bd43cb4/clickhouse_connect-1.4.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:a8001b35314c93c72df4acf9cff3d5629efb7ca099ad8f4baf9c7c685c918aae", size = 1329529, upload-time = "2026-07-06T20:27:45.263Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/70/01/23c5c7279e94c83266633c459e08c5641ca527c16d57b54bec935920a978/clickhouse_connect-1.4.2-cp314-cp314t-win32.whl", hash = "sha256:20344a662876e892285ec2eef059e2893ee85ac73b0c8c5528d29747c818942f", size = 327971, upload-time = "2026-07-06T20:27:46.806Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/99/49/ad2cf296a8d9239cc52290520b76401d012a826bdbdaeb99759c9d1eca4b/clickhouse_connect-1.4.2-cp314-cp314t-win_amd64.whl", hash = "sha256:31dbf7aebb7d2396be2b812b3f448e8988cc7967c518617079abb8f02ed8ba8b", size = 349347, upload-time = "2026-07-06T20:27:48.18Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/2b/ec/7a379fb90bc90783d5cdec9b65482df62cd746c107babd658a92aa942268/clickhouse_connect-1.4.2-cp314-cp314t-win_arm64.whl", hash = "sha256:1212f8892a1cab51000cfc4b72699ca704d3fd4d266550a38018d2959791b860", size = 327610, upload-time = "2026-07-06T20:27:49.752Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "data-ana-service"
+version = "0.1.0"
+source = { virtual = "services/data-ana" }
+dependencies = [
+    { name = "clickhouse-connect" },
+    { name = "fastapi" },
+    { name = "opentelemetry-api" },
+    { name = "opentelemetry-instrumentation-fastapi" },
+    { name = "opentelemetry-sdk" },
+    { name = "prometheus-client" },
+    { name = "pydantic" },
+    { name = "pydantic-settings" },
+    { name = "structlog" },
+    { name = "uvicorn", extra = ["standard"] },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "clickhouse-connect", specifier = ">=0.7.0" },
+    { name = "fastapi", specifier = ">=0.115.0" },
+    { name = "opentelemetry-api", specifier = ">=1.27.0" },
+    { name = "opentelemetry-instrumentation-fastapi", specifier = ">=0.48b0" },
+    { name = "opentelemetry-sdk", specifier = ">=1.27.0" },
+    { name = "prometheus-client", specifier = ">=0.20.0" },
+    { name = "pydantic", specifier = ">=2.9.0" },
+    { name = "pydantic-settings", specifier = ">=2.5.0" },
+    { name = "structlog", specifier = ">=24.4.0" },
+    { name = "uvicorn", extras = ["standard"], specifier = ">=0.30.0" },
+]
+
+[[package]]
+name = "fastapi"
+version = "0.139.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "annotated-doc" },
+    { name = "pydantic" },
+    { name = "starlette" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d3/af/a5f50ccfa659ec1802cb4ca842c23f06d906a8cc9aef6016a2caeea3d4ed/fastapi-0.139.0.tar.gz", hash = "sha256:99ab7b2d92223c76d6cf10757ab3f89d45b38267fc20b2a136cf02f6beac3145", size = 423016, upload-time = "2026-07-01T16:35:33.436Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9e/7c/8e3c6ad324ea5cb36604fc3f968554887891c316d9dfde57761611d907ad/fastapi-0.139.0-py3-none-any.whl", hash = "sha256:cf15e1e9e667ddb0ad63811e60bd11390d1aac838ca4a7a23f421807b2308189", size = 130339, upload-time = "2026-07-01T16:35:32.19Z" },
+]
+
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httptools"
+version = "0.8.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/43/e5/d471fcb0e14523fe1c3f4ba58ca52480e7bd70ad7109a3846bc75892f7fb/httptools-0.8.0.tar.gz", hash = "sha256:6b2a32f18d97e16e90827d7a819ffa8dbd8cc245fc4e1fa9d1095b54ef4bd999", size = 271342, upload-time = "2026-05-25T22:17:48.841Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/14/88/1d21a36da8f5cb0fa49eafd4b169eba5608d57e75bbcf61845cbc6243216/httptools-0.8.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:880490234c10f70a9830743097e8958d6e4b9f5a0ffc24515023afeef984054d", size = 208247, upload-time = "2026-05-25T22:17:07.843Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a5/42/cc4feea2945cb3051038f090c9b36bd5b8a9d7f5a894a506a8983e33fd1c/httptools-0.8.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:5931891fb7b441b8a3853cf1b85c82c903defce084dd5f6771ca46e31bf862c5", size = 113064, upload-time = "2026-05-25T22:17:09.136Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e3/a6/febbb8b8db0f58b38e44ad6cb946e6a255ae49b55f2e8543408fb7501ccd/httptools-0.8.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:b15fc622b0f869d19207c4089a501d9bcc63ca5e071ffdd2f03f922df882dcb2", size = 523851, upload-time = "2026-05-25T22:17:10.106Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b7/e4/f90a0df0b83beff265b7e3b65f2a4cefd95792d4be0ac3e16049f2acd3c2/httptools-0.8.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:425f83884fd6343828d8c565f046cb72b6d19063f6924093e11bcd8e1548cd09", size = 518842, upload-time = "2026-05-25T22:17:11.218Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9e/2d/0c9ac76dd2c893841fbf6498d6acec4f2442e1b7067f6e3e316a80e494e8/httptools-0.8.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:ef7c3c97f4311c7be57e2986629df89d49cb434dbff78eafcd48c2bff986b15a", size = 501238, upload-time = "2026-05-25T22:17:12.728Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ca/42/906adc91ae3a5fa9c59c0a2f21c139725bd7e5b41ae6acd485cd14123ebf/httptools-0.8.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a1afd7c9fbff0d9f5d489c4ce2768bd09c84a46ddefc7161e6aa82ae35c85745", size = 509567, upload-time = "2026-05-25T22:17:13.842Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/05/0b/4240efeb672751ee5b9b380cb0e3fdc050bc05f68adc7a8aefc4fcd9a69a/httptools-0.8.0-cp312-cp312-win_amd64.whl", hash = "sha256:cd96f29b4bab1d42fa6e3d008711c75e0f79e94e06827330160e3a304227f150", size = 90918, upload-time = "2026-05-25T22:17:15.155Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5e/e5/8cfcabc5546e8022f168be28bcdaa128a240a0befdd03b59d558b4f18bd6/httptools-0.8.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:614ceea8ea606848bece2338ac03b3ce5324bcb4be8dc7d377ed708012fa4db8", size = 205148, upload-time = "2026-05-25T22:17:16.333Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/2a/0e/0fb14848c19a686c8062ff9067c1a48793e3224b47bc5b201535b6036fce/httptools-0.8.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2d689918c15a013c65ef52d9fd495d766893ab831a2c8d89f2ac5940a5df847c", size = 111368, upload-time = "2026-05-25T22:17:17.586Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/2e/1b/46f1cecf06b9bbde8e4b8c88034ac7908989e5ff7a3a388ef38392949c1f/httptools-0.8.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:eb3028cca2fc0a6d720e52ef61d8ebb62fcbfeb1de56874546d858d3f25a26b7", size = 486447, upload-time = "2026-05-25T22:17:18.564Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/77/00/258bfc0837221f81d9725c45f9b948a6a6b2994a147a4fb66e85100c668f/httptools-0.8.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:88bdd940f2b5d487b4d032c6afa5489a7dc4694410d43de3c38c4fb3af0dc45d", size = 482448, upload-time = "2026-05-25T22:17:19.912Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/04/ab/d1cef3b5523f4d272a70f42a776c3169a2dddfe3a54de4b2ce4a36341528/httptools-0.8.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:6a43c9dd399758ccc0531acb0a3c4a6c299ee893ee9400e9c893b7bdcfae0681", size = 464460, upload-time = "2026-05-25T22:17:20.882Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ce/48/5d1d072442277bb2b3434e0e60690b8e8c23840ef7de8b6ea54040a536d3/httptools-0.8.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:0770728beb05094c809b98e814edff5fef69d26ad7d21185f2f6d5884a0ba683", size = 471312, upload-time = "2026-05-25T22:17:22.085Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/0d/66/b96623b27e51a68199ef4efdda0613cced9233fe3062ac74e50749c5ad37/httptools-0.8.0-cp313-cp313-win_amd64.whl", hash = "sha256:7685df791fad561384bfb139e77fde27a1ffd93134e016f95a0db424ffbf77b1", size = 90117, upload-time = "2026-05-25T22:17:23.074Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1a/12/fa3fbf5f9517b273edea2dc982aa82a8c634091e67c590792b729017bc6f/httptools-0.8.0-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:de242a49b5d18e0a8776e654e9f6bf6d89f3875a5c35b425a0e7ce940feb3fd6", size = 206183, upload-time = "2026-05-25T22:17:24.004Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/30/fc/5e7c4cb443370f2090a3aba0453a07384d29ff66b7435bb90e77e1037599/httptools-0.8.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:159e9ab5f701ccd42e555a12f1ad8ff69702910fc1c996cf2bb66e5fcb7a231b", size = 112079, upload-time = "2026-05-25T22:17:25.216Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ba/53/771bd891eb0f236f32145d6a1775777ec85745f3cc983a1f23d1a3b8ddfe/httptools-0.8.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:c4a9f1707e4823d54dfec6c33fa3697d302aed536ed352a7ebb5a061ddb869d0", size = 481596, upload-time = "2026-05-25T22:17:26.186Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/62/42/94e15bc68ce3d423243c45d7f1b0c7561f13844f97dc52ae23182fb65628/httptools-0.8.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d76ad7b951387e3632c8716a9bb03ac5b45c5f16119aa409db0459520887944e", size = 480865, upload-time = "2026-05-25T22:17:27.542Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1c/7c/fe2980fc03723272e30f135b62360b075f513dfe7cc73aef36c7f04012bd/httptools-0.8.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:a3b7387147361c3fd47a0bde763c5c91b5b4cd4dc9989b8ece84ff436c99843b", size = 463189, upload-time = "2026-05-25T22:17:28.546Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/15/1b/47fc5fff68acd1bfa20b4734059c9a06cadb88119dcd5258b5b0d21d91c8/httptools-0.8.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:f256d6ce930c52ca1cb2a960b7da03548c454e7d28b06059ad41bfe789036ce0", size = 466610, upload-time = "2026-05-25T22:17:29.816Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/60/bd/07b13c93ffd9bec9546e0d43f8e19378dd696dbd278511406bc07371ef1f/httptools-0.8.0-cp314-cp314-win_amd64.whl", hash = "sha256:19d1ee275bb59ba2643ba9a3a1e51cc0c788caf2b8df506368e03f56fdd08527", size = 92705, upload-time = "2026-05-25T22:17:31.133Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fd/c4/121648f68ce066d7bd762d6b6d97e620847642d38d54f3d90ff11d947629/httptools-0.8.0-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:de1ed58a974e75d56560acc7e7fed01a454994429456f65209789992e41f2568", size = 215023, upload-time = "2026-05-25T22:17:32.401Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b9/b0/312a062ae741ae3e8baa8c8bf20be81b2e67337b259ab4349bebc7b6142e/httptools-0.8.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:e93c227b595c6926c1acee96891dd9da4be338cfbe82e5cd3bb9d8dd7dc4ac0b", size = 117405, upload-time = "2026-05-25T22:17:33.742Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fc/37/fccd705f795386bb05bf413012fecff2a33e5aa8c2f069096de3e9fd8702/httptools-0.8.0-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:2a021c3a8e65cc125390d72f59b968afca3bdcaff25bd67965e0a055a14946ca", size = 558497, upload-time = "2026-05-25T22:17:34.732Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/bd/39/f172e8003576de35f5ba77ff417cf0e34429d35dc014deef15afa337a72c/httptools-0.8.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:48774d39cbb70e2b1f71f88852a3087ae1d3a1eb80482bb48c13067ab080c14f", size = 571585, upload-time = "2026-05-25T22:17:35.813Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/3e/b9/f5564760af99f3dbbf3f9104dc00e5da27e96cf433c6bdcf77617f70bf3f/httptools-0.8.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:88eead8ec8680a9f146c655bc88445a325bd7921cfd8194c7337e9467282427d", size = 543297, upload-time = "2026-05-25T22:17:37.08Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/99/67/8d9f2c313618e161b82f3873188e7196126da1d6e29688df40eb3997c77a/httptools-0.8.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:2c032fa028f46871ec7e1fc59fc15e8023eab3e6bbe6ece786a1611719a5d081", size = 539535, upload-time = "2026-05-25T22:17:38.032Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/48/63/b906c01e53f50d432c0defe43ce52764a111dc1bdd028bafbeb54dcfd008/httptools-0.8.0-cp314-cp314t-win_amd64.whl", hash = "sha256:384c17174464c8e873398b7af24f0b1f44d992c820328413951a625323155d77", size = 108209, upload-time = "2026-05-25T22:17:39.473Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.18"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/cd/63/9496c57188a2ee585e0f1db071d75089a11e98aa86eb99d9d7618fc1edce/idna-3.18.tar.gz", hash = "sha256:ffb385a7e039654cef1ab9ef32c6fafe283c0c0467bba1d9029738ce4a14a848", size = 196711, upload-time = "2026-06-02T14:34:07.794Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1e/5e/d4e9f1a599fb8e573b7b87160658329fbf28d19eac2718f51fc3def3aa5a/idna-3.18-py3-none-any.whl", hash = "sha256:7f952cbe720b688055e3f87de14f5c3e5fdaa8bc3928985c4077ca689de849a2", size = 65455, upload-time = "2026-06-02T14:34:06.319Z" },
+]
+
+[[package]]
+name = "lz4"
+version = "4.4.5"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/57/51/f1b86d93029f418033dddf9b9f79c8d2641e7454080478ee2aab5123173e/lz4-4.4.5.tar.gz", hash = "sha256:5f0b9e53c1e82e88c10d7c180069363980136b9d7a8306c4dca4f760d60c39f0", size = 172886, upload-time = "2025-11-03T13:02:36.061Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1b/ac/016e4f6de37d806f7cc8f13add0a46c9a7cfc41a5ddc2bc831d7954cf1ce/lz4-4.4.5-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:df5aa4cead2044bab83e0ebae56e0944cc7fcc1505c7787e9e1057d6d549897e", size = 207163, upload-time = "2025-11-03T13:01:45.895Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8d/df/0fadac6e5bd31b6f34a1a8dbd4db6a7606e70715387c27368586455b7fc9/lz4-4.4.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6d0bf51e7745484d2092b3a51ae6eb58c3bd3ce0300cf2b2c14f76c536d5697a", size = 207150, upload-time = "2025-11-03T13:01:47.205Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b7/17/34e36cc49bb16ca73fb57fbd4c5eaa61760c6b64bce91fcb4e0f4a97f852/lz4-4.4.5-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:7b62f94b523c251cf32aa4ab555f14d39bd1a9df385b72443fd76d7c7fb051f5", size = 1292045, upload-time = "2025-11-03T13:01:48.667Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/90/1c/b1d8e3741e9fc89ed3b5f7ef5f22586c07ed6bb04e8343c2e98f0fa7ff04/lz4-4.4.5-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2c3ea562c3af274264444819ae9b14dbbf1ab070aff214a05e97db6896c7597e", size = 1279546, upload-time = "2025-11-03T13:01:50.159Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/55/d9/e3867222474f6c1b76e89f3bd914595af69f55bf2c1866e984c548afdc15/lz4-4.4.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:24092635f47538b392c4eaeff14c7270d2c8e806bf4be2a6446a378591c5e69e", size = 1368249, upload-time = "2025-11-03T13:01:51.273Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b2/e7/d667d337367686311c38b580d1ca3d5a23a6617e129f26becd4f5dc458df/lz4-4.4.5-cp312-cp312-win32.whl", hash = "sha256:214e37cfe270948ea7eb777229e211c601a3e0875541c1035ab408fbceaddf50", size = 88189, upload-time = "2025-11-03T13:01:52.605Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a5/0b/a54cd7406995ab097fceb907c7eb13a6ddd49e0b231e448f1a81a50af65c/lz4-4.4.5-cp312-cp312-win_amd64.whl", hash = "sha256:713a777de88a73425cf08eb11f742cd2c98628e79a8673d6a52e3c5f0c116f33", size = 99497, upload-time = "2025-11-03T13:01:53.477Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/6a/7e/dc28a952e4bfa32ca16fa2eb026e7a6ce5d1411fcd5986cd08c74ec187b9/lz4-4.4.5-cp312-cp312-win_arm64.whl", hash = "sha256:a88cbb729cc333334ccfb52f070463c21560fca63afcf636a9f160a55fac3301", size = 91279, upload-time = "2025-11-03T13:01:54.419Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/2f/46/08fd8ef19b782f301d56a9ccfd7dafec5fd4fc1a9f017cf22a1accb585d7/lz4-4.4.5-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:6bb05416444fafea170b07181bc70640975ecc2a8c92b3b658c554119519716c", size = 207171, upload-time = "2025-11-03T13:01:56.595Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8f/3f/ea3334e59de30871d773963997ecdba96c4584c5f8007fd83cfc8f1ee935/lz4-4.4.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:b424df1076e40d4e884cfcc4c77d815368b7fb9ebcd7e634f937725cd9a8a72a", size = 207163, upload-time = "2025-11-03T13:01:57.721Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/41/7b/7b3a2a0feb998969f4793c650bb16eff5b06e80d1f7bff867feb332f2af2/lz4-4.4.5-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:216ca0c6c90719731c64f41cfbd6f27a736d7e50a10b70fad2a9c9b262ec923d", size = 1292136, upload-time = "2025-11-03T13:02:00.375Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/89/d1/f1d259352227bb1c185288dd694121ea303e43404aa77560b879c90e7073/lz4-4.4.5-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:533298d208b58b651662dd972f52d807d48915176e5b032fb4f8c3b6f5fe535c", size = 1279639, upload-time = "2025-11-03T13:02:01.649Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d2/fb/ba9256c48266a09012ed1d9b0253b9aa4fe9cdff094f8febf5b26a4aa2a2/lz4-4.4.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:451039b609b9a88a934800b5fc6ee401c89ad9c175abf2f4d9f8b2e4ef1afc64", size = 1368257, upload-time = "2025-11-03T13:02:03.35Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a5/6d/dee32a9430c8b0e01bbb4537573cabd00555827f1a0a42d4e24ca803935c/lz4-4.4.5-cp313-cp313-win32.whl", hash = "sha256:a5f197ffa6fc0e93207b0af71b302e0a2f6f29982e5de0fbda61606dd3a55832", size = 88191, upload-time = "2025-11-03T13:02:04.406Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/18/e0/f06028aea741bbecb2a7e9648f4643235279a770c7ffaf70bd4860c73661/lz4-4.4.5-cp313-cp313-win_amd64.whl", hash = "sha256:da68497f78953017deb20edff0dba95641cc86e7423dfadf7c0264e1ac60dc22", size = 99502, upload-time = "2025-11-03T13:02:05.886Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/61/72/5bef44afb303e56078676b9f2486f13173a3c1e7f17eaac1793538174817/lz4-4.4.5-cp313-cp313-win_arm64.whl", hash = "sha256:c1cfa663468a189dab510ab231aad030970593f997746d7a324d40104db0d0a9", size = 91285, upload-time = "2025-11-03T13:02:06.77Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/49/55/6a5c2952971af73f15ed4ebfdd69774b454bd0dc905b289082ca8664fba1/lz4-4.4.5-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:67531da3b62f49c939e09d56492baf397175ff39926d0bd5bd2d191ac2bff95f", size = 207348, upload-time = "2025-11-03T13:02:08.117Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/4e/d7/fd62cbdbdccc35341e83aabdb3f6d5c19be2687d0a4eaf6457ddf53bba64/lz4-4.4.5-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:a1acbbba9edbcbb982bc2cac5e7108f0f553aebac1040fbec67a011a45afa1ba", size = 207340, upload-time = "2025-11-03T13:02:09.152Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/77/69/225ffadaacb4b0e0eb5fd263541edd938f16cd21fe1eae3cd6d5b6a259dc/lz4-4.4.5-cp313-cp313t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:a482eecc0b7829c89b498fda883dbd50e98153a116de612ee7c111c8bcf82d1d", size = 1293398, upload-time = "2025-11-03T13:02:10.272Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c6/9e/2ce59ba4a21ea5dc43460cba6f34584e187328019abc0e66698f2b66c881/lz4-4.4.5-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e099ddfaa88f59dd8d36c8a3c66bd982b4984edf127eb18e30bb49bdba68ce67", size = 1281209, upload-time = "2025-11-03T13:02:12.091Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/80/4f/4d946bd1624ec229b386a3bc8e7a85fa9a963d67d0a62043f0af0978d3da/lz4-4.4.5-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a2af2897333b421360fdcce895c6f6281dc3fab018d19d341cf64d043fc8d90d", size = 1369406, upload-time = "2025-11-03T13:02:13.683Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/02/a2/d429ba4720a9064722698b4b754fb93e42e625f1318b8fe834086c7c783b/lz4-4.4.5-cp313-cp313t-win32.whl", hash = "sha256:66c5de72bf4988e1b284ebdd6524c4bead2c507a2d7f172201572bac6f593901", size = 88325, upload-time = "2025-11-03T13:02:14.743Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/4b/85/7ba10c9b97c06af6c8f7032ec942ff127558863df52d866019ce9d2425cf/lz4-4.4.5-cp313-cp313t-win_amd64.whl", hash = "sha256:cdd4bdcbaf35056086d910d219106f6a04e1ab0daa40ec0eeef1626c27d0fddb", size = 99643, upload-time = "2025-11-03T13:02:15.978Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/77/4d/a175459fb29f909e13e57c8f475181ad8085d8d7869bd8ad99033e3ee5fa/lz4-4.4.5-cp313-cp313t-win_arm64.whl", hash = "sha256:28ccaeb7c5222454cd5f60fcd152564205bcb801bd80e125949d2dfbadc76bbd", size = 91504, upload-time = "2025-11-03T13:02:17.313Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/63/9c/70bdbdb9f54053a308b200b4678afd13efd0eafb6ddcbb7f00077213c2e5/lz4-4.4.5-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:c216b6d5275fc060c6280936bb3bb0e0be6126afb08abccde27eed23dead135f", size = 207586, upload-time = "2025-11-03T13:02:18.263Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b6/cb/bfead8f437741ce51e14b3c7d404e3a1f6b409c440bad9b8f3945d4c40a7/lz4-4.4.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c8e71b14938082ebaf78144f3b3917ac715f72d14c076f384a4c062df96f9df6", size = 207161, upload-time = "2025-11-03T13:02:19.286Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e7/18/b192b2ce465dfbeabc4fc957ece7a1d34aded0d95a588862f1c8a86ac448/lz4-4.4.5-cp314-cp314-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:9b5e6abca8df9f9bdc5c3085f33ff32cdc86ed04c65e0355506d46a5ac19b6e9", size = 1292415, upload-time = "2025-11-03T13:02:20.829Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/67/79/a4e91872ab60f5e89bfad3e996ea7dc74a30f27253faf95865771225ccba/lz4-4.4.5-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3b84a42da86e8ad8537aabef062e7f661f4a877d1c74d65606c49d835d36d668", size = 1279920, upload-time = "2025-11-03T13:02:22.013Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f1/01/d52c7b11eaa286d49dae619c0eec4aabc0bf3cda7a7467eb77c62c4471f3/lz4-4.4.5-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0bba042ec5a61fa77c7e380351a61cb768277801240249841defd2ff0a10742f", size = 1368661, upload-time = "2025-11-03T13:02:23.208Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f7/da/137ddeea14c2cb86864838277b2607d09f8253f152156a07f84e11768a28/lz4-4.4.5-cp314-cp314-win32.whl", hash = "sha256:bd85d118316b53ed73956435bee1997bd06cc66dd2fa74073e3b1322bd520a67", size = 90139, upload-time = "2025-11-03T13:02:24.301Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/18/2c/8332080fd293f8337779a440b3a143f85e374311705d243439a3349b81ad/lz4-4.4.5-cp314-cp314-win_amd64.whl", hash = "sha256:92159782a4502858a21e0079d77cdcaade23e8a5d252ddf46b0652604300d7be", size = 101497, upload-time = "2025-11-03T13:02:25.187Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ca/28/2635a8141c9a4f4bc23f5135a92bbcf48d928d8ca094088c962df1879d64/lz4-4.4.5-cp314-cp314-win_arm64.whl", hash = "sha256:d994b87abaa7a88ceb7a37c90f547b8284ff9da694e6afcfaa8568d739faf3f7", size = 93812, upload-time = "2025-11-03T13:02:26.133Z" },
+]
+
+[[package]]
+name = "opentelemetry-api"
+version = "1.43.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ae/cc/e4c9584181f86494df0f6bdec1a4f3280c50db44704dc2a407e994fc87bb/opentelemetry_api-1.43.0.tar.gz", hash = "sha256:107d0d03857ea8fc7c5fcbbbd83f800c281f0d560553d61c1d675fccfd1761c1", size = 73476, upload-time = "2026-06-24T15:19:55.323Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/17/83/6dba32b85f31868400440dc7ad2ca1eab94cbbf3a7b0459ed39f8311a9e2/opentelemetry_api-1.43.0-py3-none-any.whl", hash = "sha256:20acf45e9b21851926835292e4045d290acade1edd2ff3de86d2f069687ba1fd", size = 61912, upload-time = "2026-06-24T15:19:35.434Z" },
+]
+
+[[package]]
+name = "opentelemetry-instrumentation"
+version = "0.64b0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "opentelemetry-api" },
+    { name = "opentelemetry-semantic-conventions" },
+    { name = "packaging" },
+    { name = "wrapt" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/7e/97/02fe6e1c8b1ffac42d0b429c18080edb24e0e0d18c86612edf72b5752382/opentelemetry_instrumentation-0.64b0.tar.gz", hash = "sha256:b47d528dead6271d7743114417eb67fc915bd9258111c48dbf9a4951d2efa88d", size = 41935, upload-time = "2026-06-24T15:19:12.951Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d2/0c/cb9fe342de5299c7af24582eb7d788661cc53a1c4b904da92309caaa9417/opentelemetry_instrumentation-0.64b0-py3-none-any.whl", hash = "sha256:133ab7ffca796557aec059bf6be3190a34b6dea987f25be3d9409e230cbdad8b", size = 35880, upload-time = "2026-06-24T15:18:17.277Z" },
+]
+
+[[package]]
+name = "opentelemetry-instrumentation-asgi"
+version = "0.64b0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "asgiref" },
+    { name = "opentelemetry-api" },
+    { name = "opentelemetry-instrumentation" },
+    { name = "opentelemetry-semantic-conventions" },
+    { name = "opentelemetry-util-http" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/85/0c/71c696fccb86d37af383ea1604af4729fabad0af2fabaf203e4c79c1e859/opentelemetry_instrumentation_asgi-0.64b0.tar.gz", hash = "sha256:4dd3eee566a4303f8e6b9b84f2a0a7abc57a6640df768926c68a3868bf5b2090", size = 26136, upload-time = "2026-06-24T15:19:17.003Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/51/20/218b65a63d847a7ed28d1bea84c39234689160b74480b8702272e37f4240/opentelemetry_instrumentation_asgi-0.64b0-py3-none-any.whl", hash = "sha256:e0840b66e15303a9254b0540946010bd008aa0504f4d89b8e1b7fb63490a36f0", size = 15906, upload-time = "2026-06-24T15:18:23.107Z" },
+]
+
+[[package]]
+name = "opentelemetry-instrumentation-fastapi"
+version = "0.64b0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "opentelemetry-api" },
+    { name = "opentelemetry-instrumentation" },
+    { name = "opentelemetry-instrumentation-asgi" },
+    { name = "opentelemetry-semantic-conventions" },
+    { name = "opentelemetry-util-http" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/db/a1/52282e2cc5c08f4df13b087896d9907258fe2ff4f34035d3b21aa92684c3/opentelemetry_instrumentation_fastapi-0.64b0.tar.gz", hash = "sha256:05f75149929e433c1630de381688e650bf651c1e1cce7f9a7b649a807dac8a98", size = 26236, upload-time = "2026-06-24T15:19:27.219Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/72/2d/4f48dc2d6f289f2febc5b871940dbea9f3b04ab9186d23342581b49cb984/opentelemetry_instrumentation_fastapi-0.64b0-py3-none-any.whl", hash = "sha256:43cbbfb2d3079dc81104478a2950ae93ac6d0e90a5020fa3987a236f8f2bdef1", size = 13263, upload-time = "2026-06-24T15:18:38.553Z" },
+]
+
+[[package]]
+name = "opentelemetry-sdk"
+version = "1.43.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "opentelemetry-api" },
+    { name = "opentelemetry-semantic-conventions" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/3e/eb/5041074274ac0956b03637cc039d434569112468e875eddfcc9a0674ce06/opentelemetry_sdk-1.43.0.tar.gz", hash = "sha256:d8187c81c162df9913e4003dd6485f7390d9a24fc17026ec7387b8b8218b08e9", size = 254744, upload-time = "2026-06-24T15:20:08.467Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/49/e3/b17be23af124201c9f52eececd4cc8ddfed1597d37b4ee771895d325805c/opentelemetry_sdk-1.43.0-py3-none-any.whl", hash = "sha256:d1323a547c1ce69d6a069a17a44b7da82bb8b332051ecb074041f87642c86823", size = 178852, upload-time = "2026-06-24T15:19:52.169Z" },
+]
+
+[[package]]
+name = "opentelemetry-semantic-conventions"
+version = "0.64b0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "opentelemetry-api" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5a/30/5f26df29509eccd86b99b481ac9ffa39da49ba9577cc69071c552ae30447/opentelemetry_semantic_conventions-0.64b0.tar.gz", hash = "sha256:72f76fb2d1582d9d033dd1fcd84532e961e6ff3d90d24ba6fabc72975a83864c", size = 148340, upload-time = "2026-06-24T15:20:09.267Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f2/ca/23ba87a221b574a7c5a99d48849d80bfe8b047624681357e2b002e566187/opentelemetry_semantic_conventions-0.64b0-py3-none-any.whl", hash = "sha256:ea77e85e354b8f604ddbe5f3d9135216f982fa4d77e5859ac30f6d8a50505aa6", size = 203713, upload-time = "2026-06-24T15:19:53.339Z" },
+]
+
+[[package]]
+name = "opentelemetry-util-http"
+version = "0.64b0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c3/1b/1029a805fd7242f7dfce91633b244c3b14a94d703232878f71e01ce862b1/opentelemetry_util_http-0.64b0.tar.gz", hash = "sha256:8a86a220dbfc56d736f47f1e5c4e7932a21fcf69052312e1bcf166444dc79322", size = 11102, upload-time = "2026-06-24T15:19:48.974Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1c/c7/5f8ec5b30546f2dc22cd5fc5759bce2ab5be6e89a2e710a405ac9ef64ed3/opentelemetry_util_http-0.64b0-py3-none-any.whl", hash = "sha256:c1e5350d25507c1afcd6076cf9ac062485a0a4f79cd9971366996fd3056bacdb", size = 8204, upload-time = "2026-06-24T15:19:09.02Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.2"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d7/f1/e7a6dd94a8d4a5626c03e4e99c87f241ba9e350cd9e6d75123f992427270/packaging-26.2.tar.gz", hash = "sha256:ff452ff5a3e828ce110190feff1178bb1f2ea2281fa2075aadb987c2fb221661", size = 228134, upload-time = "2026-04-24T20:15:23.917Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/df/b2/87e62e8c3e2f4b32e5fe99e0b86d576da1312593b39f47d8ceef365e95ed/packaging-26.2-py3-none-any.whl", hash = "sha256:5fc45236b9446107ff2415ce77c807cee2862cb6fac22b8a73826d0693b0980e", size = 100195, upload-time = "2026-04-24T20:15:22.081Z" },
+]
+
+[[package]]
+name = "prometheus-client"
+version = "0.25.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1b/fb/d9aa83ffe43ce1f19e557c0971d04b90561b0cfd50762aafb01968285553/prometheus_client-0.25.0.tar.gz", hash = "sha256:5e373b75c31afb3c86f1a52fa1ad470c9aace18082d39ec0d2f918d11cc9ba28", size = 86035, upload-time = "2026-04-09T19:53:42.359Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8d/9b/d4b1e644385499c8346fa9b622a3f030dce14cd6ef8a1871c221a17a67e7/prometheus_client-0.25.0-py3-none-any.whl", hash = "sha256:d5aec89e349a6ec230805d0df882f3807f74fd6c1a2fa86864e3c2279059fed1", size = 64154, upload-time = "2026-04-09T19:53:41.324Z" },
+]
+
+[[package]]
+name = "pydantic"
+version = "2.13.4"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "annotated-types" },
+    { name = "pydantic-core" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/18/a5/b60d21ac674192f8ab0ba4e9fd860690f9b4a6e51ca5df118733b487d8d6/pydantic-2.13.4.tar.gz", hash = "sha256:c40756b57adaa8b1efeeced5c196f3f3b7c435f90e84ea7f443901bec8099ef6", size = 844775, upload-time = "2026-05-06T13:43:05.343Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fd/7b/122376b1fd3c62c1ed9dc80c931ace4844b3c55407b6fb2d199377c9736f/pydantic-2.13.4-py3-none-any.whl", hash = "sha256:45a282cde31d808236fd7ea9d919b128653c8b38b393d1c4ab335c62924d9aba", size = 472262, upload-time = "2026-05-06T13:43:02.641Z" },
+]
+
+[[package]]
+name = "pydantic-core"
+version = "2.46.4"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9d/56/921726b776ace8d8f5db44c4ef961006580d91dc52b803c489fafd1aa249/pydantic_core-2.46.4.tar.gz", hash = "sha256:62f875393d7f270851f20523dd2e29f082bcc82292d66db2b64ea71f64b6e1c1", size = 471464, upload-time = "2026-05-06T13:37:06.98Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ce/8c/af022f0af448d7747c5154288d46b5f2bc5f17366eaa0e23e9aa04d59f3b/pydantic_core-2.46.4-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:3245406455a5d98187ec35530fd772b1d799b26667980872c8d4614991e2c4a2", size = 2106158, upload-time = "2026-05-06T13:38:57.215Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/19/95/6195171e385007300f0f5574592e467c568becce2d937a0b6804f218bc49/pydantic_core-2.46.4-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:962ccbab7b642487b1d8b7df90ef677e03134cf1fd8880bf698649b22a69371f", size = 1951724, upload-time = "2026-05-06T13:37:02.697Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8e/bc/f47d1ff9cbb1620e1b5b697eef06010035735f07820180e74178226b27b3/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8233f2947cf85404441fd7e0085f53b10c93e0ee78611099b5c7237e36aacbf7", size = 1975742, upload-time = "2026-05-06T13:37:09.448Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5b/11/9b9a5b0306345664a2da6410877af6e8082481b5884b3ddd78d47c6013ce/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:3a233125ac121aa3ffba9a2b59edfc4a985a76092dc8279586ab4b71390875e7", size = 2052418, upload-time = "2026-05-06T13:37:38.234Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f1/b7/a65fec226f5d78fc39f4a13c4cc0c768c22b113438f60c14adc9d2865038/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5b712b53160b79a5850310b912a5ef8e57e56947c8ad690c227f5c9d7e561712", size = 2232274, upload-time = "2026-05-06T13:38:27.753Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/68/f0/92039db98b907ef49269a8271f67db9cb78ae2fc68062ef7e4e77adb5f61/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9401557acd873c3a7f3eb9383edef8ac4968f9510e340f4808d427e75667e7b4", size = 2309940, upload-time = "2026-05-06T13:38:05.353Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5f/97/2aab507d3d00ca626e8e57c1eac6a79e4e5fbcc63eb99733ff55d1717f65/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:926c9541b14b12b1681dca8a0b75feb510b06c6341b70a8e500c2fdcff837cce", size = 2094516, upload-time = "2026-05-06T13:39:10.577Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/22/37/a8aca44d40d737dde2bc05b3c6c07dff0de07ce6f82e9f3167aeaf4d5dea/pydantic_core-2.46.4-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:56cb4851bcaf3d117eddcef4fe66afd750a50274b0da8e22be256d10e5611987", size = 2136854, upload-time = "2026-05-06T13:40:22.59Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/24/99/fcef1b79238c06a8cbec70819ac722ba76e02bc8ada9b0fd66eba40da01b/pydantic_core-2.46.4-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c68fcd102d71ea85c5b2dfac3f4f8476eff42a9e078fd5faefff6d145063536b", size = 2180306, upload-time = "2026-05-06T13:40:10.666Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ae/6c/fc44000918855b42779d007ae63b0532794739027b2f417321cddbc44f6a/pydantic_core-2.46.4-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:b2f69dec1725e79a012d920df1707de5caf7ed5e08f3be4435e25803efc47458", size = 2190044, upload-time = "2026-05-06T13:40:43.231Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/6b/65/d9cadc9f1920d7a127ad2edba16c1db7916e59719285cd6c94600b0080ba/pydantic_core-2.46.4-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:8d0820e8192167f80d88d64038e609c31452eeca865b4e1d9950a27a4609b00b", size = 2329133, upload-time = "2026-05-06T13:39:57.365Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d0/cf/c873d91679f3a30bcf5e7ac280ce5573483e72295307685120d0d5ad3416/pydantic_core-2.46.4-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:fbdb89b3e1c94a30cc5edfce477c6e6a5dc4d8f84665b455c27582f211a1c72c", size = 2374464, upload-time = "2026-05-06T13:38:06.976Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/47/bd/6f2fc8188f31bf10590f1e98e7b306336161fac930a8c514cd7bd828c7dc/pydantic_core-2.46.4-cp312-cp312-win32.whl", hash = "sha256:9aa768456404a8bf48a4406685ac2bec8e72b62c69313734fa3b73cf33b3a894", size = 1974823, upload-time = "2026-05-06T13:40:47.985Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/40/8c/985c1d41ea1107c2534abd9870e4ed5c8e7669b5c308297835c001e7a1c4/pydantic_core-2.46.4-cp312-cp312-win_amd64.whl", hash = "sha256:e9c26f834c65f5752f3f06cb08cb86a913ceb7274d0db6e267808a708b46bc89", size = 2072919, upload-time = "2026-05-06T13:39:21.153Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c4/ba/f463d006e0c47373ca7ec5e1a261c59dc01ef4d62b2657af925fb0deee3a/pydantic_core-2.46.4-cp312-cp312-win_arm64.whl", hash = "sha256:4fc73cb559bdb54b1134a706a2802a4cddd27a0633f5abb7e53056268751ac6a", size = 2027604, upload-time = "2026-05-06T13:39:03.753Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/51/a2/5d30b469c5267a17b39dec53208222f76a8d351dfac4af661888c5aee77d/pydantic_core-2.46.4-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:5d5902252db0d3cedf8d4a1bc68f70eeb430f7e4c7104c8c476753519b423008", size = 2106306, upload-time = "2026-05-06T13:37:48.029Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c1/81/4fa520eaffa8bd7d1525e644cd6d39e7d60b1592bc5b516693c7340b50f1/pydantic_core-2.46.4-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:c94f0688e7b8d0a67abf40e57a7eaaecd17cc9586706a31b76c031f63df052b4", size = 1951906, upload-time = "2026-05-06T13:37:17.012Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/03/d5/fd02da45b659668b05923b17ba3a0100a0a3d5541e3bd8fcc4ecb711309e/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f027324c56cd5406ca49c124b0db10e56c69064fec039acc571c29020cc87c76", size = 1976802, upload-time = "2026-05-06T13:37:35.113Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/21/f2/95727e1368be3d3ed485eaab7adbd7dda408f33f7a36e8b48e0144002b91/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e739fee756ba1010f8bcccb534252e85a35fe45ae92c295a06059ce58b74ccd3", size = 2052446, upload-time = "2026-05-06T13:37:12.313Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9c/86/5d99feea3f77c7234b8718075b23db11532773c1a0dbd9b9490215dc2eeb/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9d56801be94b86a9da183e5f3766e6310752b99ff647e38b09a9500d88e46e76", size = 2232757, upload-time = "2026-05-06T13:39:01.149Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d2/3a/508ac615935ef7588cf6d9e9b91309fdc2da751af865e02a9098de88258c/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2412e734dcb48da14d4e4006b82b46b74f2518b8a26ee7e58c6844a6cd6d03c4", size = 2309275, upload-time = "2026-05-06T13:37:41.406Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/07/f8/41db9de19d7987d6b04715a02b3b40aea467000275d9d758ffaa31af7d50/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9551187363ffc0de2a00b2e47c25aeaeb1020b69b668762966df15fc5659dd5a", size = 2094467, upload-time = "2026-05-06T13:39:18.847Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/2c/e2/f35033184cb11d0052daf4416e8e10a502ea2ac006fc4f459aee872727d1/pydantic_core-2.46.4-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:0186750b482eefa11d7f435892b09c5c606193ef3375bcf94aa00ae6bfb66262", size = 2134417, upload-time = "2026-05-06T13:40:17.944Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/7e/7b/6ceeb1cc90e193862f444ebe373d8fdf613f0a82572dde03fb10734c6c71/pydantic_core-2.46.4-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:5855698a4856556d86e8e6cd8434bc3ac0314ee8e12089ae0e143f64c6256e4e", size = 2179782, upload-time = "2026-05-06T13:40:32.618Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5a/f2/c8d7773ede6af08036423a00ae0ceffce266c3c52a096c435d68c896083f/pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:cbaf13819775b7f769bf4a1f066cb6df7a28d4480081a589828ef190226881cd", size = 2188782, upload-time = "2026-05-06T13:36:51.018Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/59/31/0c864784e31f09f05cdd87606f08923b9c9e7f6e51dd27f20f62f975ce9f/pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:633147d34cf4550417f12e2b1a0383973bdf5cdfde212cb09e9a581cf10820be", size = 2328334, upload-time = "2026-05-06T13:40:37.764Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c2/eb/4f6c8a41efa30baa755590f4141abf3a8c370fab610915733e74134a7270/pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:82cf5301172168103724d49a1444d3378cb20cdee30b116a1bd6031236298a5d", size = 2372986, upload-time = "2026-05-06T13:39:34.152Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5b/24/b375a480d53113860c299764bfe9f349a3dc9108b3adc0d7f0d786492ebf/pydantic_core-2.46.4-cp313-cp313-win32.whl", hash = "sha256:9fa8ae11da9e2b3126c6426f147e0fba88d96d65921799bb30c6abd1cb2c97fb", size = 1973693, upload-time = "2026-05-06T13:37:55.072Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/7e/e8/cff247591966f2d22ec8c003cd7587e27b7ba7b81ab2fb888e3ab75dc285/pydantic_core-2.46.4-cp313-cp313-win_amd64.whl", hash = "sha256:6b3ace8194b0e5204818c92802dcdca7fc6d88aabbb799d7c795540d9cd6d292", size = 2071819, upload-time = "2026-05-06T13:38:49.139Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c6/1a/f4aee670d5670e9e148e0c82c7db98d780be566c6e6a97ee8035528ca0b3/pydantic_core-2.46.4-cp313-cp313-win_arm64.whl", hash = "sha256:184c081504d17f1c1066e430e117142b2c77d9448a97f7b65c6ac9fd9aee238d", size = 2027411, upload-time = "2026-05-06T13:40:45.796Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8d/74/228a26ddad29c6672b805d9fd78e8d251cd04004fa7eed0e622096cd0250/pydantic_core-2.46.4-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:428e04521a40150c85216fc8b85e8d39fece235a9cf5e383761238c7fa9b96fb", size = 2102079, upload-time = "2026-05-06T13:38:41.019Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ad/1f/8970b150a4b4365623ae00fc88603491f763c627311ae8031e3111356d6e/pydantic_core-2.46.4-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:23ace664830ee0bfe014a0c7bc248b1f7f25ed7ad103852c317624a1083af462", size = 1952179, upload-time = "2026-05-06T13:36:59.812Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/95/30/5211a831ae054928054b2f79731661087a2bc5c01e825c672b3a4a8f1b3e/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce5c1d2a8b27468f433ca974829c44060b8097eedc39933e3c206a90ee49c4a9", size = 1978926, upload-time = "2026-05-06T13:37:39.933Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/57/e9/689668733b1eb67adeef047db3c2e8788fcf65a7fd9c9e2b46b7744fe245/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:7283d57845ecf5a163403eb0702dfc220cc4fbdd18919cb5ccea4f95ee1cdab4", size = 2046785, upload-time = "2026-05-06T13:38:01.995Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/60/d9/6715260422ff50a2109878fd24d948a6c3446bb2664f34ee78cd972b3acd/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8daafc69c93ee8a0204506a3b6b30f586ef54028f52aeeeb5c4cfc5184fd5914", size = 2228733, upload-time = "2026-05-06T13:40:50.371Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/18/ae/fdb2f64316afca925640f8e70bb1a564b0ec2721c1389e25b8eb4bf9a299/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:cd2213145bcc2ba85884d0ac63d222fece9209678f77b9b4d76f054c561adb28", size = 2307534, upload-time = "2026-05-06T13:37:21.531Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/89/1d/8eff589b45bb8190a9d12c49cfad0f176a5cbd1534908a6b5125e2886239/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7a5f930472650a82629163023e630d160863fce524c616f4e5186e5de9d9a49b", size = 2099732, upload-time = "2026-05-06T13:39:31.942Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/06/d5/ee5a3366637fee41dee51a1fc91562dcf12ddbc68fda34e6b253da2324bb/pydantic_core-2.46.4-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:c1b3f518abeca3aa13c712fd202306e145abf59a18b094a6bafb2d2bbf59192c", size = 2129627, upload-time = "2026-05-06T13:37:25.033Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/94/33/2414be571d2c6a6c4d08be21f9292b6d3fdb08949a97b6dfe985017821db/pydantic_core-2.46.4-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:1a7dd0b3ee80d90150e3495a3a13ac34dbcbfd4f012996a6a1d8900e91b5c0fb", size = 2179141, upload-time = "2026-05-06T13:37:14.046Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/7b/79/7daa95be995be0eecc4cf75064cb33f9bbbfe3fe0158caf2f0d4a996a5c7/pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:3fb702cd90b0446a3a1c5e470bfa0dd23c0233b676a9099ddcc964fa6ca13898", size = 2184325, upload-time = "2026-05-06T13:36:53.615Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9f/cb/d0a382f5c0de8a222dc61c65348e0ce831b1f68e0a018450d31c2cace3a5/pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:b8458003118a712e66286df6a707db01c52c0f52f7db8e4a38f0da1d3b94fc4e", size = 2323990, upload-time = "2026-05-06T13:40:29.971Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/05/db/d9ba624cc4a5aced1598e88c04fdbd8310c8a69b9d38b9a3d39ce3a61ed7/pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:372429a130e469c9cd698925ce5fc50940b7a1336b0d82038e63d5bbc4edc519", size = 2369978, upload-time = "2026-05-06T13:37:23.027Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f2/20/d15df15ba918c423461905802bfd2981c3af0bfa0e40d05e13edbfa48bc3/pydantic_core-2.46.4-cp314-cp314-win32.whl", hash = "sha256:85bb3611ff1802f3ee7fdd7dbff26b56f343fb432d57a4728fdd49b6ef35e2f4", size = 1966354, upload-time = "2026-05-06T13:38:03.499Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fc/b6/6b8de4c0a7d7ab3004c439c80c5c1e0a3e8d78bbae19379b01960383d9e5/pydantic_core-2.46.4-cp314-cp314-win_amd64.whl", hash = "sha256:811ff8e9c313ab425368bcbb36e5c4ebd7108c2bbf4e4089cfbb0b01eff63fac", size = 2072238, upload-time = "2026-05-06T13:39:40.807Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/32/36/51eb763beec1f4cf59b1db243a7dcc39cbb41230f050a09b9d69faaf0a48/pydantic_core-2.46.4-cp314-cp314-win_arm64.whl", hash = "sha256:bfec22eab3c8cc2ceec0248aec886624116dc079afa027ecc8ad4a7e62010f8a", size = 2018251, upload-time = "2026-05-06T13:37:26.72Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e8/91/855af51d625b23aa987116a19e231d2aaef9c4a415273ddc189b79a45fee/pydantic_core-2.46.4-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:af8244b2bef6aaad6d92cda81372de7f8c8d36c9f0c3ea36e827c60e7d9467a0", size = 2099593, upload-time = "2026-05-06T13:39:47.682Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fb/1b/8784a54c65edb5f49f0a14d6977cf1b209bba85a4c77445b255c2de58ab3/pydantic_core-2.46.4-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:5a4330cdbc57162e4b3aa303f588ba752257694c9c9be3e7ebb11b4aca659b5d", size = 1935226, upload-time = "2026-05-06T13:40:40.428Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e8/e7/1955d28d1afc56dd4b3ad7cc0cf39df1b9852964cf16e5d13912756d6d6b/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:29c61fc04a3d840155ff08e475a04809278972fe6aef51e2720554e96367e34b", size = 1974605, upload-time = "2026-05-06T13:37:32.029Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/93/e2/3fedbf0ba7a22850e6e9fd78117f1c0f10f950182344d8a6c535d468fdd8/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c50f2528cf200c5eed56faf3f4e22fcd5f38c157a8b78576e6ba3168ec35f000", size = 2030777, upload-time = "2026-05-06T13:38:55.239Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f8/61/46be275fcaaba0b4f5b9669dd852267ce1ff616592dccf7a7845588df091/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0cbe8b01f948de4286c74cdd6c667aceb38f5c1e26f0693b3983d9d74887c65e", size = 2236641, upload-time = "2026-05-06T13:37:08.096Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/60/db/12e93e46a8bac9988be3c016860f83293daea8c716c029c9ace279036f2f/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:617d7e2ca7dcb8c5cf6bcb8c59b8832c94b36196bbf1cbd1bfb56ed341905edd", size = 2286404, upload-time = "2026-05-06T13:40:20.221Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e2/4a/4d8b19008f38d31c53b8219cfedc2e3d5de5fe99d90076b7e767de29274f/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7027560ee92211647d0d34e3f7cd6f50da56399d26a9c8ad0da286d3869a53f3", size = 2109219, upload-time = "2026-05-06T13:38:12.153Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/88/70/3cbc40978fefb7bb09c6708d40d4ad1a5d70fd7213c3d17f971de868ec1f/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:f99626688942fb746e545232e7726926f3be91b5975f8b55327665fafda991c7", size = 2110594, upload-time = "2026-05-06T13:40:02.971Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9d/20/b8d36736216e29491125531685b2f9e61aa5b4b2599893f8268551da3338/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fc3e9034a63de20e15e8ade85358bc6efc614008cab72898b4b4952bea0509ff", size = 2159542, upload-time = "2026-05-06T13:39:27.506Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1d/a2/367df868eb584dacf6bf82a389272406d7178e301c4ac82545ab98bc2dd9/pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:97e7cf2be5c77b7d1a9713a05605d49460d02c6078d38d8bef3cbe323c548424", size = 2168146, upload-time = "2026-05-06T13:38:31.93Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c1/b8/4460f77f7e201893f649a29ab355dddd3beee8a97bcb1a320db414f9a06e/pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:3bf92c5d0e00fefaab325a4d27828fe6b6e2a21848686b5b60d2d9eeb09d76c6", size = 2306309, upload-time = "2026-05-06T13:37:44.717Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/64/c4/be2639293acd87dc8ddbcec41a73cee9b2ebf996fe6d892a1a74e88ad3f7/pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:3ecbc122d18468d06ca279dc26a8c2e2d5acb10943bb35e36ae92096dc3b5565", size = 2369736, upload-time = "2026-05-06T13:37:05.645Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/30/a6/9f9f380dbb301f67023bf8f707aaa75daadf84f7152d95c410fd7e81d994/pydantic_core-2.46.4-cp314-cp314t-win32.whl", hash = "sha256:e846ae7835bf0703ae43f534ab79a867146dadd59dc9ca5c8b53d5c8f7c9ef02", size = 1955575, upload-time = "2026-05-06T13:38:51.116Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/40/1f/f1eb9eb350e795d1af8586289746f5c5677d16043040d63710e22abc43c9/pydantic_core-2.46.4-cp314-cp314t-win_amd64.whl", hash = "sha256:2108ba5c1c1eca18030634489dc544844144ee36357f2f9f780b93e7ddbb44b5", size = 2051624, upload-time = "2026-05-06T13:38:21.672Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f6/d2/42dd53d0a85c27606f316d3aa5d2869c4e8470a5ed6dec30e4a1abe19192/pydantic_core-2.46.4-cp314-cp314t-win_arm64.whl", hash = "sha256:4fcbe087dbc2068af7eda3aa87634eba216dbda64d1ae73c8684b621d33f6596", size = 2017325, upload-time = "2026-05-06T13:40:52.723Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9d/1d/8987ad40f65ae1432753072f214fb5c74fe47ffbd0698bb9cbbb585664f8/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:1d8ba486450b14f3b1d63bc521d410ec7565e52f887b9fb671791886436a42f7", size = 2095527, upload-time = "2026-05-06T13:39:52.283Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/64/d3/84c282a7eee1d3ac4c0377546ef5a1ea436ce26840d9ac3b7ed54a377507/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:3009f12e4e90b7f88b4f9adb1b0c4a3d58fe7820f3238c190047209d148026df", size = 1936024, upload-time = "2026-05-06T13:40:15.671Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d7/ca/eac61596cdeb4d7e174d3dc0bd8a6238f14f75f97a24e7b7db4c7e7340a0/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ad785e92e6dc634c21555edc8bd6b64957ab844541bcb96a1366c202951ae526", size = 1990696, upload-time = "2026-05-06T13:38:34.717Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fa/c3/7c8b240552251faf6b3a957db200fcfbbcec36763c050428b601e0c9b83b/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:00c603d540afdd6b80eb39f078f33ebd46211f02f33e34a32d9f053bba711de0", size = 2147590, upload-time = "2026-05-06T13:39:29.883Z" },
+]
+
+[[package]]
+name = "pydantic-settings"
+version = "2.14.2"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "pydantic" },
+    { name = "python-dotenv" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5c/b5/8f48e906c3e0205276e8bd8cb7512217a87b2685304d64be27cad5b3019f/pydantic_settings-2.14.2.tar.gz", hash = "sha256:c19dd64b19097f1de80184f0cc7b0272a13ae6e170cbf240a3e27e381ed14a5f", size = 237700, upload-time = "2026-06-19T13:44:56.324Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/77/c1/6e422f34e569cf8e18df68d1939c81c099d2b61e4f7d9621c8a77560799c/pydantic_settings-2.14.2-py3-none-any.whl", hash = "sha256:a20c97b37910b6550d5ea50fbcc2d4187defe58cd57070b73863d069419c9440", size = 61715, upload-time = "2026-06-19T13:44:55.02Z" },
+]
+
+[[package]]
+name = "python-dotenv"
+version = "1.2.2"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/82/ed/0301aeeac3e5353ef3d94b6ec08bbcabd04a72018415dcb29e588514bba8/python_dotenv-1.2.2.tar.gz", hash = "sha256:2c371a91fbd7ba082c2c1dc1f8bf89ca22564a087c2c287cd9b662adde799cf3", size = 50135, upload-time = "2026-03-01T16:00:26.196Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/0b/d7/1959b9648791274998a9c3526f6d0ec8fd2233e4d4acce81bbae76b44b2a/python_dotenv-1.2.2-py3-none-any.whl", hash = "sha256:1d8214789a24de455a8b8bd8ae6fe3c6b69a5e3d64aa8a8e5d68e694bbcb285a", size = 22101, upload-time = "2026-03-01T16:00:25.09Z" },
+]
+
+[[package]]
+name = "pyyaml"
+version = "6.0.3"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/05/8e/961c0007c59b8dd7729d542c61a4d537767a59645b82a0b521206e1e25c2/pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f", size = 130960, upload-time = "2025-09-25T21:33:16.546Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d1/33/422b98d2195232ca1826284a76852ad5a86fe23e31b009c9886b2d0fb8b2/pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196", size = 182063, upload-time = "2025-09-25T21:32:11.445Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/89/a0/6cf41a19a1f2f3feab0e9c0b74134aa2ce6849093d5517a0c550fe37a648/pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0", size = 173973, upload-time = "2025-09-25T21:32:12.492Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ed/23/7a778b6bd0b9a8039df8b1b1d80e2e2ad78aa04171592c8a5c43a56a6af4/pyyaml-6.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28", size = 775116, upload-time = "2025-09-25T21:32:13.652Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/65/30/d7353c338e12baef4ecc1b09e877c1970bd3382789c159b4f89d6a70dc09/pyyaml-6.0.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c", size = 844011, upload-time = "2025-09-25T21:32:15.21Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8b/9d/b3589d3877982d4f2329302ef98a8026e7f4443c765c46cfecc8858c6b4b/pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc", size = 807870, upload-time = "2025-09-25T21:32:16.431Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/05/c0/b3be26a015601b822b97d9149ff8cb5ead58c66f981e04fedf4e762f4bd4/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e", size = 761089, upload-time = "2025-09-25T21:32:17.56Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/be/8e/98435a21d1d4b46590d5459a22d88128103f8da4c2d4cb8f14f2a96504e1/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea", size = 790181, upload-time = "2025-09-25T21:32:18.834Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/74/93/7baea19427dcfbe1e5a372d81473250b379f04b1bd3c4c5ff825e2327202/pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5", size = 137658, upload-time = "2025-09-25T21:32:20.209Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/86/bf/899e81e4cce32febab4fb42bb97dcdf66bc135272882d1987881a4b519e9/pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b", size = 154003, upload-time = "2025-09-25T21:32:21.167Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1a/08/67bd04656199bbb51dbed1439b7f27601dfb576fb864099c7ef0c3e55531/pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd", size = 140344, upload-time = "2025-09-25T21:32:22.617Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d1/11/0fd08f8192109f7169db964b5707a2f1e8b745d4e239b784a5a1dd80d1db/pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8", size = 181669, upload-time = "2025-09-25T21:32:23.673Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b1/16/95309993f1d3748cd644e02e38b75d50cbc0d9561d21f390a76242ce073f/pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1", size = 173252, upload-time = "2025-09-25T21:32:25.149Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/50/31/b20f376d3f810b9b2371e72ef5adb33879b25edb7a6d072cb7ca0c486398/pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c", size = 767081, upload-time = "2025-09-25T21:32:26.575Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/49/1e/a55ca81e949270d5d4432fbbd19dfea5321eda7c41a849d443dc92fd1ff7/pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5", size = 841159, upload-time = "2025-09-25T21:32:27.727Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/74/27/e5b8f34d02d9995b80abcef563ea1f8b56d20134d8f4e5e81733b1feceb2/pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6", size = 801626, upload-time = "2025-09-25T21:32:28.878Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f9/11/ba845c23988798f40e52ba45f34849aa8a1f2d4af4b798588010792ebad6/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6", size = 753613, upload-time = "2025-09-25T21:32:30.178Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/3d/e0/7966e1a7bfc0a45bf0a7fb6b98ea03fc9b8d84fa7f2229e9659680b69ee3/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be", size = 794115, upload-time = "2025-09-25T21:32:31.353Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/de/94/980b50a6531b3019e45ddeada0626d45fa85cbe22300844a7983285bed3b/pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26", size = 137427, upload-time = "2025-09-25T21:32:32.58Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/97/c9/39d5b874e8b28845e4ec2202b5da735d0199dbe5b8fb85f91398814a9a46/pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c", size = 154090, upload-time = "2025-09-25T21:32:33.659Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246, upload-time = "2025-09-25T21:32:34.663Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9d/8c/f4bd7f6465179953d3ac9bc44ac1a8a3e6122cf8ada906b4f96c60172d43/pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac", size = 181814, upload-time = "2025-09-25T21:32:35.712Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/bd/9c/4d95bb87eb2063d20db7b60faa3840c1b18025517ae857371c4dd55a6b3a/pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310", size = 173809, upload-time = "2025-09-25T21:32:36.789Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/92/b5/47e807c2623074914e29dabd16cbbdd4bf5e9b2db9f8090fa64411fc5382/pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7", size = 766454, upload-time = "2025-09-25T21:32:37.966Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/02/9e/e5e9b168be58564121efb3de6859c452fccde0ab093d8438905899a3a483/pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788", size = 836355, upload-time = "2025-09-25T21:32:39.178Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/88/f9/16491d7ed2a919954993e48aa941b200f38040928474c9e85ea9e64222c3/pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5", size = 794175, upload-time = "2025-09-25T21:32:40.865Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/dd/3f/5989debef34dc6397317802b527dbbafb2b4760878a53d4166579111411e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764", size = 755228, upload-time = "2025-09-25T21:32:42.084Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d7/ce/af88a49043cd2e265be63d083fc75b27b6ed062f5f9fd6cdc223ad62f03e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35", size = 789194, upload-time = "2025-09-25T21:32:43.362Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/23/20/bb6982b26a40bb43951265ba29d4c246ef0ff59c9fdcdf0ed04e0687de4d/pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac", size = 156429, upload-time = "2025-09-25T21:32:57.844Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f4/f4/a4541072bb9422c8a883ab55255f918fa378ecf083f5b85e87fc2b4eda1b/pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3", size = 143912, upload-time = "2025-09-25T21:32:59.247Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/7c/f9/07dd09ae774e4616edf6cda684ee78f97777bdd15847253637a6f052a62f/pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3", size = 189108, upload-time = "2025-09-25T21:32:44.377Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/4e/78/8d08c9fb7ce09ad8c38ad533c1191cf27f7ae1effe5bb9400a46d9437fcf/pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba", size = 183641, upload-time = "2025-09-25T21:32:45.407Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/7b/5b/3babb19104a46945cf816d047db2788bcaf8c94527a805610b0289a01c6b/pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c", size = 831901, upload-time = "2025-09-25T21:32:48.83Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8b/cc/dff0684d8dc44da4d22a13f35f073d558c268780ce3c6ba1b87055bb0b87/pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702", size = 861132, upload-time = "2025-09-25T21:32:50.149Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b1/5e/f77dc6b9036943e285ba76b49e118d9ea929885becb0a29ba8a7c75e29fe/pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c", size = 839261, upload-time = "2025-09-25T21:32:51.808Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ce/88/a9db1376aa2a228197c58b37302f284b5617f56a5d959fd1763fb1675ce6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065", size = 805272, upload-time = "2025-09-25T21:32:52.941Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/da/92/1446574745d74df0c92e6aa4a7b0b3130706a4142b2d1a5869f2eaa423c6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65", size = 829923, upload-time = "2025-09-25T21:32:54.537Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f0/7a/1c7270340330e575b92f397352af856a8c06f230aa3e76f86b39d01b416a/pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9", size = 174062, upload-time = "2025-09-25T21:32:55.767Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341, upload-time = "2025-09-25T21:32:56.828Z" },
+]
+
+[[package]]
+name = "starlette"
+version = "1.3.1"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/eb/e3/7c1dc7381d9f8ab7d854328ebfa884e62cb3f3d8549ddfd37c7814f42afa/starlette-1.3.1.tar.gz", hash = "sha256:05d0213193f2fbaae60e2ecb593b4add4262ad4e46536b54abe36f11a71724e0", size = 2703240, upload-time = "2026-06-12T09:23:11.602Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ec/bb/2799cc2ede3ed41131f8975621e7213dfc7ef4acbbaadfa440f32500c370/starlette-1.3.1-py3-none-any.whl", hash = "sha256:c7372aae11c3c3f26a42df7bd626cec2f47d03483d261d369516a615a53714c6", size = 73632, upload-time = "2026-06-12T09:23:10.017Z" },
+]
+
+[[package]]
+name = "structlog"
+version = "26.1.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5e/89/b4a0bcfdf4f71a3dea31379f095929613d7e4528a0996bca6aa964cd0dca/structlog-26.1.0.tar.gz", hash = "sha256:f63a716cbd1b1291cf7661de7794b455acfa4c43c5bcf1630e6ad5ddc1adb3b7", size = 1459881, upload-time = "2026-06-06T07:33:39.348Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a9/18/489c97b834dfff9cf2fc2507cede4bcd4b11e67f84bc462acd1992496f86/structlog-26.1.0-py3-none-any.whl", hash = "sha256:e081a26d6c373e6d201eca24eede26d8ffab07f88f477822e679183428d3d91e", size = 73764, upload-time = "2026-06-06T07:33:38.046Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.16.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f6/cc/6253133b5bb138fc3306cebfbda2c520f545d36b5be2c7255cc528bb45d6/typing_extensions-4.16.0.tar.gz", hash = "sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5", size = 113555, upload-time = "2026-07-02T08:40:05.92Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/49/d3/b8441a820a491ddfc024b0b0cf0393375b75ea13866d9c66727e54c2fc80/typing_extensions-4.16.0-py3-none-any.whl", hash = "sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8", size = 45571, upload-time = "2026-07-02T08:40:04.659Z" },
+]
+
+[[package]]
+name = "typing-inspection"
+version = "0.4.2"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" },
+]
+
+[[package]]
+name = "tzdata"
+version = "2026.2"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ba/19/1b9b0e29f30c6d35cb345486df41110984ea67ae69dddbc0e8a100999493/tzdata-2026.2.tar.gz", hash = "sha256:9173fde7d80d9018e02a662e168e5a2d04f87c41ea174b139fbef642eda62d10", size = 198254, upload-time = "2026-04-24T15:22:08.651Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ce/e4/dccd7f47c4b64213ac01ef921a1337ee6e30e8c6466046018326977efd95/tzdata-2026.2-py2.py3-none-any.whl", hash = "sha256:bbe9af844f658da81a5f95019480da3a89415801f6cc966806612cc7169bffe7", size = 349321, upload-time = "2026-04-24T15:22:05.876Z" },
+]
+
+[[package]]
+name = "urllib3"
+version = "2.7.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/53/0c/06f8b233b8fd13b9e5ee11424ef85419ba0d8ba0b3138bf360be2ff56953/urllib3-2.7.0.tar.gz", hash = "sha256:231e0ec3b63ceb14667c67be60f2f2c40a518cb38b03af60abc813da26505f4c", size = 433602, upload-time = "2026-05-07T16:13:18.596Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/7f/3e/5db95bcf282c52709639744ca2a8b149baccf648e39c8cc87553df9eae0c/urllib3-2.7.0-py3-none-any.whl", hash = "sha256:9fb4c81ebbb1ce9531cce37674bbc6f1360472bc18ca9a553ede278ef7276897", size = 131087, upload-time = "2026-05-07T16:13:17.151Z" },
+]
+
+[[package]]
+name = "uvicorn"
+version = "0.50.2"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "click" },
+    { name = "h11" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9f/f6/cc9aadc0e481344a42095d222bfa764122fb8cfba708d1922917bd8bfb01/uvicorn-0.50.2.tar.gz", hash = "sha256:b92bf03509b82bcb9d49e7335b4fd364518ad021c2dc18b4e6a2fec8c955a0bb", size = 93716, upload-time = "2026-07-06T10:38:31.984Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/aa/f0/7c228ee10c7ab8fd3a21d06579a6f7c6075c6ce72594a20fb5d2f206ff24/uvicorn-0.50.2-py3-none-any.whl", hash = "sha256:4ae72a385630bcc17a0adb8290f26c993865e0b43a2114c2aab96420172c056a", size = 72846, upload-time = "2026-07-06T10:38:30.543Z" },
+]
+
+[package.optional-dependencies]
+standard = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "httptools" },
+    { name = "python-dotenv" },
+    { name = "pyyaml" },
+    { name = "uvloop", marker = "platform_python_implementation != 'PyPy' and sys_platform != 'cygwin' and sys_platform != 'win32'" },
+    { name = "watchfiles" },
+    { name = "websockets" },
+]
+
+[[package]]
+name = "uvloop"
+version = "0.22.1"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/06/f0/18d39dbd1971d6d62c4629cc7fa67f74821b0dc1f5a77af43719de7936a7/uvloop-0.22.1.tar.gz", hash = "sha256:6c84bae345b9147082b17371e3dd5d42775bddce91f885499017f4607fdaf39f", size = 2443250, upload-time = "2025-10-16T22:17:19.342Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/3d/ff/7f72e8170be527b4977b033239a83a68d5c881cc4775fca255c677f7ac5d/uvloop-0.22.1-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:fe94b4564e865d968414598eea1a6de60adba0c040ba4ed05ac1300de402cd42", size = 1359936, upload-time = "2025-10-16T22:16:29.436Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c3/c6/e5d433f88fd54d81ef4be58b2b7b0cea13c442454a1db703a1eea0db1a59/uvloop-0.22.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:51eb9bd88391483410daad430813d982010f9c9c89512321f5b60e2cddbdddd6", size = 752769, upload-time = "2025-10-16T22:16:30.493Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/24/68/a6ac446820273e71aa762fa21cdcc09861edd3536ff47c5cd3b7afb10eeb/uvloop-0.22.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:700e674a166ca5778255e0e1dc4e9d79ab2acc57b9171b79e65feba7184b3370", size = 4317413, upload-time = "2025-10-16T22:16:31.644Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5f/6f/e62b4dfc7ad6518e7eff2516f680d02a0f6eb62c0c212e152ca708a0085e/uvloop-0.22.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7b5b1ac819a3f946d3b2ee07f09149578ae76066d70b44df3fa990add49a82e4", size = 4426307, upload-time = "2025-10-16T22:16:32.917Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/90/60/97362554ac21e20e81bcef1150cb2a7e4ffdaf8ea1e5b2e8bf7a053caa18/uvloop-0.22.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:e047cc068570bac9866237739607d1313b9253c3051ad84738cbb095be0537b2", size = 4131970, upload-time = "2025-10-16T22:16:34.015Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/99/39/6b3f7d234ba3964c428a6e40006340f53ba37993f46ed6e111c6e9141d18/uvloop-0.22.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:512fec6815e2dd45161054592441ef76c830eddaad55c8aa30952e6fe1ed07c0", size = 4296343, upload-time = "2025-10-16T22:16:35.149Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/89/8c/182a2a593195bfd39842ea68ebc084e20c850806117213f5a299dfc513d9/uvloop-0.22.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:561577354eb94200d75aca23fbde86ee11be36b00e52a4eaf8f50fb0c86b7705", size = 1358611, upload-time = "2025-10-16T22:16:36.833Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d2/14/e301ee96a6dc95224b6f1162cd3312f6d1217be3907b79173b06785f2fe7/uvloop-0.22.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:1cdf5192ab3e674ca26da2eada35b288d2fa49fdd0f357a19f0e7c4e7d5077c8", size = 751811, upload-time = "2025-10-16T22:16:38.275Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b7/02/654426ce265ac19e2980bfd9ea6590ca96a56f10c76e63801a2df01c0486/uvloop-0.22.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6e2ea3d6190a2968f4a14a23019d3b16870dd2190cd69c8180f7c632d21de68d", size = 4288562, upload-time = "2025-10-16T22:16:39.375Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/15/c0/0be24758891ef825f2065cd5db8741aaddabe3e248ee6acc5e8a80f04005/uvloop-0.22.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0530a5fbad9c9e4ee3f2b33b148c6a64d47bbad8000ea63704fa8260f4cf728e", size = 4366890, upload-time = "2025-10-16T22:16:40.547Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d2/53/8369e5219a5855869bcee5f4d317f6da0e2c669aecf0ef7d371e3d084449/uvloop-0.22.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:bc5ef13bbc10b5335792360623cc378d52d7e62c2de64660616478c32cd0598e", size = 4119472, upload-time = "2025-10-16T22:16:41.694Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f8/ba/d69adbe699b768f6b29a5eec7b47dd610bd17a69de51b251126a801369ea/uvloop-0.22.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:1f38ec5e3f18c8a10ded09742f7fb8de0108796eb673f30ce7762ce1b8550cad", size = 4239051, upload-time = "2025-10-16T22:16:43.224Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/90/cd/b62bdeaa429758aee8de8b00ac0dd26593a9de93d302bff3d21439e9791d/uvloop-0.22.1-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:3879b88423ec7e97cd4eba2a443aa26ed4e59b45e6b76aabf13fe2f27023a142", size = 1362067, upload-time = "2025-10-16T22:16:44.503Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/0d/f8/a132124dfda0777e489ca86732e85e69afcd1ff7686647000050ba670689/uvloop-0.22.1-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:4baa86acedf1d62115c1dc6ad1e17134476688f08c6efd8a2ab076e815665c74", size = 752423, upload-time = "2025-10-16T22:16:45.968Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a3/94/94af78c156f88da4b3a733773ad5ba0b164393e357cc4bd0ab2e2677a7d6/uvloop-0.22.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:297c27d8003520596236bdb2335e6b3f649480bd09e00d1e3a99144b691d2a35", size = 4272437, upload-time = "2025-10-16T22:16:47.451Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b5/35/60249e9fd07b32c665192cec7af29e06c7cd96fa1d08b84f012a56a0b38e/uvloop-0.22.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c1955d5a1dd43198244d47664a5858082a3239766a839b2102a269aaff7a4e25", size = 4292101, upload-time = "2025-10-16T22:16:49.318Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/02/62/67d382dfcb25d0a98ce73c11ed1a6fba5037a1a1d533dcbb7cab033a2636/uvloop-0.22.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:b31dc2fccbd42adc73bc4e7cdbae4fc5086cf378979e53ca5d0301838c5682c6", size = 4114158, upload-time = "2025-10-16T22:16:50.517Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f0/7a/f1171b4a882a5d13c8b7576f348acfe6074d72eaf52cccef752f748d4a9f/uvloop-0.22.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:93f617675b2d03af4e72a5333ef89450dfaa5321303ede6e67ba9c9d26878079", size = 4177360, upload-time = "2025-10-16T22:16:52.646Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/79/7b/b01414f31546caf0919da80ad57cbfe24c56b151d12af68cee1b04922ca8/uvloop-0.22.1-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:37554f70528f60cad66945b885eb01f1bb514f132d92b6eeed1c90fd54ed6289", size = 1454790, upload-time = "2025-10-16T22:16:54.355Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d4/31/0bb232318dd838cad3fa8fb0c68c8b40e1145b32025581975e18b11fab40/uvloop-0.22.1-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:b76324e2dc033a0b2f435f33eb88ff9913c156ef78e153fb210e03c13da746b3", size = 796783, upload-time = "2025-10-16T22:16:55.906Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/42/38/c9b09f3271a7a723a5de69f8e237ab8e7803183131bc57c890db0b6bb872/uvloop-0.22.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:badb4d8e58ee08dad957002027830d5c3b06aea446a6a3744483c2b3b745345c", size = 4647548, upload-time = "2025-10-16T22:16:57.008Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c1/37/945b4ca0ac27e3dc4952642d4c900edd030b3da6c9634875af6e13ae80e5/uvloop-0.22.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b91328c72635f6f9e0282e4a57da7470c7350ab1c9f48546c0f2866205349d21", size = 4467065, upload-time = "2025-10-16T22:16:58.206Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/97/cc/48d232f33d60e2e2e0b42f4e73455b146b76ebe216487e862700457fbf3c/uvloop-0.22.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:daf620c2995d193449393d6c62131b3fbd40a63bf7b307a1527856ace637fe88", size = 4328384, upload-time = "2025-10-16T22:16:59.36Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e4/16/c1fd27e9549f3c4baf1dc9c20c456cd2f822dbf8de9f463824b0c0357e06/uvloop-0.22.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:6cde23eeda1a25c75b2e07d39970f3374105d5eafbaab2a4482be82f272d5a5e", size = 4296730, upload-time = "2025-10-16T22:17:00.744Z" },
+]
+
+[[package]]
+name = "watchfiles"
+version = "1.2.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+dependencies = [
+    { name = "anyio" },
+]
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/cd/41/5e1a4bb12aac5f1493fa1bdc11154eca3b258ca4eba65d39c473fe19d8e9/watchfiles-1.2.0.tar.gz", hash = "sha256:c995fba777f1ea992f090f9236e9284cf7a5d1a0130dd5a3d82c598cacd76838", size = 108252, upload-time = "2026-05-18T04:32:04.251Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b8/2f/e42c992d2afda3108ea1c02acecc991b9f31d05c14adc2a7cee9ee211fc4/watchfiles-1.2.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:bc13eb17538be00c874699dc0abe4ee2bc8d50bb1166a6b9e175ef3fd7eb8f26", size = 400115, upload-time = "2026-05-18T04:32:02.06Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5f/8f/6af2ea19065c91d8b0ea3516fdfc8c0d349f407e8e9fbf4e5a17360de8ad/watchfiles-1.2.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:2d95ddc1eb6914154253d239089900813f6a767e174b8e6a50e7fdacb7e4236c", size = 393659, upload-time = "2026-05-18T04:30:50.951Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/13/01/b32a967c56fb3e3e5be3db52c3d3b87fa4513aa367d8ed1ad96d42952e5f/watchfiles-1.2.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8f70d8b291ef6e88d19b1f297a6905ddb978888d9272b0d05e6f53309856bcfc", size = 453207, upload-time = "2026-05-18T04:31:04.231Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/04/98/97557a812180338cb1abd32e1cffcc4588f59b5f23e0cb006b2ba95ba64a/watchfiles-1.2.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:56d8641cf834c2836922899105bd3ce3d0dfc69291d52edf0b4d0436829b34c0", size = 459273, upload-time = "2026-05-18T04:31:50.377Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e8/a8/b4b08dcb7653b8087c6586f7ce649505900e866bbcfe40dc9587af02e686/watchfiles-1.2.0-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2581a94056e55d7d0a31a823ea92bf73749c489ca2285bfdc0fbe6b2bb49d50c", size = 489927, upload-time = "2026-05-18T04:31:42.485Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/50/94/3dceea03545d2e5ddfd839f0ddd5e1cecbf1697b5a428d5ba11cef6af95d/watchfiles-1.2.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:41bc1199f7523b3f82843c88cbb979180c949caef0342cf90968f178e5d49b01", size = 570476, upload-time = "2026-05-18T04:31:03.071Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/cc/f2/d39a5450c3532092b91f81d274360e613c2371bc874a89c7a1a3c5e8d138/watchfiles-1.2.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:7571e4464cb6e434958f867f7f730b8ab0b75e3f8e5eac0499168486ab3c33a8", size = 465650, upload-time = "2026-05-18T04:30:12.701Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/22/24/ed72f68cbc1333ca9b9f2200aa048bb6658ae41709bc1caad4310f4bdffd/watchfiles-1.2.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e53a384f76b631c3ae5334ce6a52f0baa3a911eb94a4eac7f160079868b716d5", size = 456398, upload-time = "2026-05-18T04:30:13.784Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/0d/64/982ef4a4e5bab5b6e5b6becc8cd5e732f6130a78b855f0abec6439a9a135/watchfiles-1.2.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:d20029a60a71a052a24c4db7673bc4de39ab89adbaccbfb5d67987c5d73f424d", size = 465140, upload-time = "2026-05-18T04:31:52.111Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a0/0c/95282abf4ed680b6096010bcfc30c5fa7a041fc5aa5a2ad17a2cc6c75bba/watchfiles-1.2.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:2cb93af48550faf1cea04c303107c8b75833de7013e57ce27d3b8d21d8d0f58c", size = 630259, upload-time = "2026-05-18T04:31:25.676Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/30/45/607c1de1530c4bdcf2cf1d1ecc2505ddba5d96bd43ba9f2b0e79876f850f/watchfiles-1.2.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:2995c176de7692b86a2e4c58d9ec718f753150a979cb4a754e2b4ffa38e70906", size = 659859, upload-time = "2026-05-18T04:30:24.333Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fa/08/d9e2e0f9e8e6791d33aefc694ad7eefa7f901f63caff84a81ded38692f9c/watchfiles-1.2.0-cp312-cp312-win32.whl", hash = "sha256:7a2cffd17d27d2ecbb310c2b1d8174f222a5495b1a721894afa88ec11e25b898", size = 275480, upload-time = "2026-05-18T04:30:31.307Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1c/e6/9d42569c0102645cc8cea5d8c7d8a1e9d4ada2cb7f05f75e554b8aa2202a/watchfiles-1.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:f155b3a1b2a5fc89cdc70d47ee5d54e3b75e88efa34982028a35daef9ba00379", size = 288718, upload-time = "2026-05-18T04:32:10.745Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/0a/26/88e0dc6ee3898169d7fa22bb6a69cabf2502d2ee25cb8c876d1262d204f8/watchfiles-1.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:8fa585ede612ee9f9e91b18bebf9ba11b9ae29a4e3a0d0cf6fca3e382133f0d5", size = 281026, upload-time = "2026-05-18T04:30:22.23Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d1/4d/70a7feced9f87e2ff26dba42667290f41694fc64646c67261fbb8cab5d5c/watchfiles-1.2.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:01ea8d66f0693b9b60a6541c8d10263091ca9a9060d242f3c1f3143f9aad2c98", size = 399730, upload-time = "2026-05-18T04:31:38.162Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/31/3a/0da302f2307aee316922806ebd5726c542cbd787c938271cf14a074c7daf/watchfiles-1.2.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:7ba0480b9a74af058f43b337e937a451e109295c420916d68ad24e3dc02f5e44", size = 392842, upload-time = "2026-05-18T04:30:27.051Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/db/ef/d5bdb705c224dbc256aa0c1ec47bf4e61ec52558f2afb44a71a1fe4d7015/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4f34e26a19f91f710c08e0183429f0d1d15df734e6bc78c31e77b9ea9c433658", size = 452989, upload-time = "2026-05-18T04:31:11.945Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/71/29/5495f2c1661949ef7a35e4d71111d129cfe7606414a26887a919d0a55406/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b4e77f6a55f858504069abd35d336a637555c09bca453dde1ee1e5ada8a6a1fb", size = 458978, upload-time = "2026-05-18T04:30:52.606Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d5/8c/7f9c07c433811c2fffd93e13fdfb7135de9aab5f2ae41be08960fa0047dc/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0cb4d80e212f116474a545c21c912b445f16bb0cef9e6a73a498164223e14e2f", size = 490248, upload-time = "2026-05-18T04:31:36.003Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/3c/11/d93632febc52fbc21be90231bb7c17fd5387f46c9076fd40a5f9c2ae6910/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b974946a10af379d425e2eef5b62f5c6ebeaccf91d45eaad6f5b27ecd4f91aa0", size = 571847, upload-time = "2026-05-18T04:31:10.862Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/55/b4/383173e73aabb07ad1d9c7aa859d95437ac46a6d6a1e11005facda0c9d19/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:86bc13c25a8d1fcd70b51d0ce7c9b65e90de5666fcbfd3e34957cc73ee19aeb5", size = 465974, upload-time = "2026-05-18T04:30:17.006Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a7/6c/89b1a230a78f57c52dd8893adb1f92f94411721b6ec12596c56d98c74356/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ca148d73dea36c9763aaa351e4d7a51780ec1584217c45276f4fe8239c768b71", size = 454782, upload-time = "2026-05-18T04:30:35.656Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/24/62/1732118367cfff0a9fce3bf62ff4bfded09ef5df21d9d446b858b3f70a96/watchfiles-1.2.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:c525543d91961c6955b2636b308569e84a1d1c5f5f2932041ab9ef46422f43e3", size = 465182, upload-time = "2026-05-18T04:30:20.846Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/28/96/716f7e5f51339bf22963f3345f9f27d7f3b30e2eadc597e257c881dd3c53/watchfiles-1.2.0-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:a204794696ffb8f9b10fba6f7cb5216d42f3b2b71860ccac6b6e42f5f10973b0", size = 629841, upload-time = "2026-05-18T04:31:05.397Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/4c/fe/c40783950fd771ccf66ab3ec2722d188a9af1c7f96c6e811f36e40c6e03f/watchfiles-1.2.0-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:10d86db20695afe7997ac9e1717637d6714a8d0220458c33f3d2061f54cec427", size = 658028, upload-time = "2026-05-18T04:31:48.22Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/71/72/4508db1856d1d87fcbb3b63f4839bab1b5682cb0e8d224d122263c09654a/watchfiles-1.2.0-cp313-cp313-win32.whl", hash = "sha256:eb283ee99e21ad6443c8cdb06ac5b34b1308c329cbdf03fa02b445363714c799", size = 275183, upload-time = "2026-05-18T04:30:59.57Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f9/36/14b76ca57652e5cc5fd1c11f32a261292c08a0d19a00351013c2549cbfb2/watchfiles-1.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:a0f27f01bee51861392bb6b7c4fdb290b27d1eb194e9e28788d68102a0e898d9", size = 288059, upload-time = "2026-05-18T04:32:07.937Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1b/8d/0a85e395398d8d20fadfe5c5d32c726eee17a519e78fb356f2cf7531bffe/watchfiles-1.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:3651aa7058595e9cfb75d35dd5ada2bf9f48a5b8a0f3562821d3e210c507e077", size = 280186, upload-time = "2026-05-18T04:31:54.484Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/37/68/36db056f1fdcc5f07302f56e631774d6835bcd6fa3ace402304621d5f9e5/watchfiles-1.2.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:faea288b6f0ab1902ef08f4ca6de005dccf856c4e0c4f21b8c5fce02d90a1b08", size = 399031, upload-time = "2026-05-18T04:30:44.576Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c1/64/01a9d6f66a82a5c101ce939274106cc72759d62427e153f01edd2b9f87c2/watchfiles-1.2.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:01859b11fd9fbca670f4d5da00fbac282cfea9bd67a2125d8b2833a3b5617ea9", size = 391205, upload-time = "2026-05-18T04:30:25.413Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/84/2c/0a44fe058cb4bb7b8ede6b6670698bbb7c0400740e378d00022189b7b31d/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:fff610d7bb2256a317bb1e96f0d7862c7aa8076733ee5df0fd41bbe76a24a4f4", size = 451892, upload-time = "2026-05-18T04:32:14.005Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/67/a1/351e0d56cd35e6488b5c8b4fb11a809a5bc923e8fe8fed9faf8920be0c89/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b141a4891c995a039cd89e9a49e62df1dc8a559a5d1a6e4c7106d16c12777a55", size = 458867, upload-time = "2026-05-18T04:31:22.279Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d5/7d/9d09605187f1b838998624049fcf8bf47b73c1a3b76901fcac1782f62277/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f22943b7770483f6ea0721c6b11d022947a98eb0acae14694de034f4d0d38925", size = 490217, upload-time = "2026-05-18T04:31:43.657Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/60/5d/a17a16eccb182f04188cd308ec24b1a71a9b5c4e7098269cf35d9fa56d02/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1bc6195825b7dcd217968bb1f801a60fd4c16e8eeab5bedc7fe917d7d5995ab4", size = 571458, upload-time = "2026-05-18T04:32:11.875Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d3/3d/4dd457062083ab1938e5dfd45032eb425cee2ac817287ca8ff4356183e5d/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d4a4b147f5dca2a5d325a06a832fb43f345751adfbc63204aec30e0d9ca965a2", size = 464707, upload-time = "2026-05-18T04:30:43.492Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c6/71/ea8c57b128f5383de74d0c7d2d9c57ad7c9a65a930c451bd25d524b295b7/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4543579a9bdb0c9560039b4ffddbdb39545707659fbc430ce4c10f3f68d557f9", size = 454663, upload-time = "2026-05-18T04:30:16.061Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/53/fd/2e812bf938406d7db351f0703ddd3fc6c061cf30d96153a77bc79a943a44/watchfiles-1.2.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:20aa0e708b920bde876a4aa82dc7dd6ebea228a63a67cda6632c2fc87b787efa", size = 463537, upload-time = "2026-05-18T04:31:44.9Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/86/56/d17a7f1dd1bc3035f1072694a551301272f1739c2d8e319c927cb9e29b38/watchfiles-1.2.0-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:d413349d565dab74297f2a63e84a097936be69bf8f3b3801f27f380e32040f44", size = 629194, upload-time = "2026-05-18T04:31:14.141Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/be/06/f1ff66bf5cae50aa4062779a0ecd0bbaf15e466195719074078947d9a17d/watchfiles-1.2.0-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f28b2725eb8cce327b9b3ab02415c853011dc55c95832fe90de6bc56f5315f72", size = 656194, upload-time = "2026-05-18T04:31:47.14Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e7/54/a9c7ea9a82a4ac65e7004c0a03920b5cdd2f9c3b678757d9cd425aa51d53/watchfiles-1.2.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:b8c8358484d5fa12ef34f05b7f4168eaf1932f408725ff6d023c33ec17bd79d4", size = 400205, upload-time = "2026-05-18T04:32:05.153Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/aa/5d/c9ab3534374a4a67450696905d6ef16a04405448b8dc52bd752ae50423d4/watchfiles-1.2.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:9f04b092229ad2c50126dd3c922c8822e51e605993764a33058d4a791ab42281", size = 392508, upload-time = "2026-05-18T04:30:54.849Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/26/ca/1ad30103535cf0cecd7b993e8d50edc5351b1820e38f2d22e3df58962feb/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7a7ce236284f002a156f70add88efe5c70879cccbb658be0822c54b1306fc09d", size = 452448, upload-time = "2026-05-18T04:30:53.727Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/37/a1/ceee2cdf2afbd715fa07758d39c9859513eae411b23196f7fd039e5feedd/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b9909cc2b48468b575eefa944919e1fe8a36c5849d5c7c168f80a8c1db69398e", size = 459605, upload-time = "2026-05-18T04:30:23.312Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e8/f6/421e30fd1cb3907a84ed92ab3f1983e37ba2dca015e9a894a048418417a2/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0a37faaed405c67e28e6be45a1fa4f206ef5a2860f27c237db9fa30704c38242", size = 490757, upload-time = "2026-05-18T04:30:47.358Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/41/b0/55ed1b97ed08be7bba6f9a541cac15f2a858e1d74d2b07b6da70a82aab00/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9649193aa27bd9ff2e80ff29bfaa93085496c7a3a377592823cc58b77ee88add", size = 568672, upload-time = "2026-05-18T04:30:38.915Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d1/cf/d8ae8a80dd7bafab395ea7681c10237311bbf34d37704a8c744e7cf31fc7/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4e4ff8e37f99cf1da89e255e07c9c4b37c214038c4283707bdec308cb1b0ea1f", size = 464197, upload-time = "2026-05-18T04:30:09.914Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/7c/8a/3076c496ca8dafe0e8cd03fcebdfc47be4b1174b4e5b24ff6e396e6b3af2/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:054dc20fd2e3132b4c3883b4a00d72fd6e1f56fdaf89fccd12e8057d74cd74d7", size = 453181, upload-time = "2026-05-18T04:30:14.829Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e5/10/9745e17c98e7b8a86454df0a3c7b5686bd650383f1e9f26e4ebcbd6cc0c0/watchfiles-1.2.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:e140ed30ebde76796b686e67c182cff10ea2fbab186fafd1560f74bb5a473a6e", size = 465109, upload-time = "2026-05-18T04:30:28.123Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8f/95/8ef4a95481d3e0cb52d62a06fa6e972e81424be2d9698b91a2fecca9904c/watchfiles-1.2.0-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:bb7e52ecf68ba46d22df23467b87cffeb2146908aa523ebfe803019618cfda06", size = 630653, upload-time = "2026-05-18T04:31:49.304Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fd/e4/3b3bf36b0f829b50c6ebcb8d031583863c59f923d6a6af3d485e470d0fac/watchfiles-1.2.0-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:23282a321c8baf9b3a3c4afff673f9fe65eb7fdc2338d765ccad9d3d1916a5ba", size = 657838, upload-time = "2026-05-18T04:31:06.497Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/21/b1/6cbbb50c1f3002ab568777d44aa21206dfb8807a840990c4037523b51812/watchfiles-1.2.0-cp314-cp314-win32.whl", hash = "sha256:c0db965c5f79aa49fe672d297cf1febc5ad149b658594944f49a54a2b96270a7", size = 275108, upload-time = "2026-05-18T04:30:06.891Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/92/45/190ce6db8dcb4536682cf75d3889ff1a27182a58cb519d343cb6d9ea63d8/watchfiles-1.2.0-cp314-cp314-win_amd64.whl", hash = "sha256:71283b39fd17e5408eb123bd37aeecfd9d54c81fc184421943208aadb879d103", size = 288441, upload-time = "2026-05-18T04:32:12.901Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/74/0d/3eae1c2313ab08378431d907c3f8095ecca00f3eda33111cf4f0f2591799/watchfiles-1.2.0-cp314-cp314-win_arm64.whl", hash = "sha256:c5c19526f4e54a00f2666a6c0e9e40d582c09e865055ea7378bf0009aab857b3", size = 280684, upload-time = "2026-05-18T04:31:26.902Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b1/75/fb64e6c25d6b5ca636d03df34ffb1c6e9873303e76d27967e045f8df088f/watchfiles-1.2.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:d73a585accffa5ae39c17264c36ec3166d2fad7000c780f5ef83b2722afb9dd2", size = 398857, upload-time = "2026-05-18T04:32:17.108Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/73/4e/9f7adf01754cbf81843722ccfec169d8f26c69778281a302855cecd2ee08/watchfiles-1.2.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:ae99b14c5f21e026e0e9d96f40e07d8570ebee6cafd9d8fc318354606daa7a28", size = 392413, upload-time = "2026-05-18T04:31:07.911Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/47/c8/bec626bcc2d69f44b9acb24ce7d60ed7b16b73628eea747fcbd169d8edda/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4429f3b105524a10b72c3a819b091c495d2811d419c1e1e8df773a5a5974f831", size = 452409, upload-time = "2026-05-18T04:31:20.142Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/00/b7/b6362068e81e7c556d155a34c35d40ac3ef42d747b06d7f6e5bf58e359c2/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:43d818978d06062d9b22c4fab2ebe44cf5213d42dc8e62bda8c2760cfa2eeb33", size = 458827, upload-time = "2026-05-18T04:32:06.219Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/67/f8/9a813fa42afb1e0b4625e75f0479826644d3ee8dc287e093799bc01f390c/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b9f732dc58b2dbe69e464ccf8fff7a03b0dd0be439da4c0720d3558527d3d6b4", size = 490104, upload-time = "2026-05-18T04:31:56.034Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/2f/bf/27dfb6094ca4c9aad21298b5525b6c53cb36121ee454331d05161e58d130/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8f200104103feb097de4cab8fe4f5dd18a2026934c7dea98c55a2f5fd6d5a33b", size = 571360, upload-time = "2026-05-18T04:31:57.133Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fb/39/44a096d67270ea93df91d33877dbe91fbda3aa4f8ec2edf799d93eda8736/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:63ac26eefbf4af1741247d6fb68b11c49a25b2f7413fbd318a83a12aaa9cf666", size = 464644, upload-time = "2026-05-18T04:30:57.33Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/0e/80/c7472203bad6268e3ef1ad260739704847898938ad7ea8b63a5131f46b50/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0c4997d4e4a55f0d02b6cde327322daf3a0400e5df6c6b15948994bf72497925", size = 454771, upload-time = "2026-05-18T04:30:48.736Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/51/cf/3b10b268b4b7f0fc26e9debb5eef1998b515887840f444cd3ec80c688755/watchfiles-1.2.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:4c887eba18b7945ac73067a8b4a66f21cd46c2539b2bc68588f7be6c7eb6d26b", size = 463494, upload-time = "2026-05-18T04:31:33.826Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/3d/3e/a4302545cd589262a0dc7d140e86f7688eba3f9c72776c27f7e23b8864c4/watchfiles-1.2.0-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:3416ff151bb6b5a8d8d11664974fbef4d9305b9b2957839ab5a270468fd8df30", size = 629383, upload-time = "2026-05-18T04:31:15.596Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/db/99/d5649df0a9a410d45b7c882304d0b790903ac9b6e8f2cfd12114e0c6b9f2/watchfiles-1.2.0-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:0e831a271c035d89789cffc386b6aa1375f39f1cd25eb7ca0997e4970d152fc5", size = 656093, upload-time = "2026-05-18T04:31:58.707Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/92/b9/362702539275019a54dd2e94511b31a9b89c5f9e6a21966de7eb692549fc/watchfiles-1.2.0-cp315-cp315-macosx_10_12_x86_64.whl", hash = "sha256:37a6721cdf3f65dbb13aa9503510ccb4451603ac837e44d265d7992a597e1374", size = 400109, upload-time = "2026-05-18T04:31:16.879Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8f/75/71d5ba62db781e5587bded1d944c675374bc4aa37ff33d5018d98e8b6538/watchfiles-1.2.0-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:2b37d10b5a63bd4d87e18472d80fa525bd670586fae62e5dd580452764879b65", size = 392167, upload-time = "2026-05-18T04:31:28.058Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/3c/01/c66dd95d0423fe30d31820e2d1d5bda773764131bbb6ac0cb1cf303ac328/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0a105bc2283f67e8fbec74253ec2d94925de92ed72c0393f1206bf326b7b7b69", size = 452372, upload-time = "2026-05-18T04:31:00.836Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/91/15/2fe99557e72f85627c6a8eed50d889e8d101623e060a22ad75b875cb932d/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5327989a465505f05cfe06f04fa9d0c2fd5432bb243e10e6f012b1bdca3c8579", size = 459596, upload-time = "2026-05-18T04:31:34.96Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ed/23/d4acfa0023367428ed48351b3b9b267893037b6cadae55620c61c24bcfd4/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ecb47f183a8025b2aa18b546725c3657e542112ae9c0613a2af79b4fa8d04ad7", size = 490869, upload-time = "2026-05-18T04:31:59.923Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a4/5f/3164cbdce06c9fb95c4f7b9e2f9760b5e2797af43a9ecc317ef42a23a278/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8520a4ab0e37f770afc34459c4f8f7019e153f9124dc101c15538365875d1ab2", size = 571641, upload-time = "2026-05-18T04:32:00.948Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/41/e6/85d3731c55e65cd7690f3f803d24c139588aaf863e4bf2148fe7a7fa1a19/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:71cd71740ed2c15211ebb237ced4e39a1cdf6f80566e5fe95428da1626f4fde6", size = 464444, upload-time = "2026-05-18T04:30:34.298Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f4/7d/562641012b8b09872742c3b8adf9629ec479fd78f8d68ae4a0c13da8add6/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f88af53d6ddaf72179ef613ddc905e6f4785f712b49b80b3bef9f3525e6194b4", size = 453593, upload-time = "2026-05-18T04:31:23.464Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/56/fe/cb8ef3d6f929d14158fdaaad9925985b7310abc9384dcd4d82dd0016fb59/watchfiles-1.2.0-cp315-cp315-manylinux_2_31_riscv64.whl", hash = "sha256:cee9d5efd929efdac5f7e58f72b3376f676b64050a91c5b99a7094c5b2317488", size = 465096, upload-time = "2026-05-18T04:31:30.384Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/25/91/80908e835e100527a9267147b08c0eee1fa6ab0ffec15edc04d1d44885f7/watchfiles-1.2.0-cp315-cp315-musllinux_1_1_aarch64.whl", hash = "sha256:b718bf356bbc15e559bd8ef41782b573b8ae0e3f177ab244b440568d7ea02cfb", size = 630638, upload-time = "2026-05-18T04:30:49.89Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/46/4b/95ab2f256bb4af3cb2eb23b9317bda984ee6e0f11733a5c004a6c95b06e3/watchfiles-1.2.0-cp315-cp315-musllinux_1_1_x86_64.whl", hash = "sha256:922c0e019fe68b3ae392965a766b02a71ba1168c932cebc3733cd52c5fe5b377", size = 657684, upload-time = "2026-05-18T04:31:32.027Z" },
+]
+
+[[package]]
+name = "websockets"
+version = "16.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/04/24/4b2031d72e840ce4c1ccb255f693b15c334757fc50023e4db9537080b8c4/websockets-16.0.tar.gz", hash = "sha256:5f6261a5e56e8d5c42a4497b364ea24d94d9563e8fbd44e78ac40879c60179b5", size = 179346, upload-time = "2026-01-10T09:23:47.181Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/84/7b/bac442e6b96c9d25092695578dda82403c77936104b5682307bd4deb1ad4/websockets-16.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:71c989cbf3254fbd5e84d3bff31e4da39c43f884e64f2551d14bb3c186230f00", size = 177365, upload-time = "2026-01-10T09:22:46.787Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b0/fe/136ccece61bd690d9c1f715baaeefd953bb2360134de73519d5df19d29ca/websockets-16.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:8b6e209ffee39ff1b6d0fa7bfef6de950c60dfb91b8fcead17da4ee539121a79", size = 175038, upload-time = "2026-01-10T09:22:47.999Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/40/1e/9771421ac2286eaab95b8575b0cb701ae3663abf8b5e1f64f1fd90d0a673/websockets-16.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:86890e837d61574c92a97496d590968b23c2ef0aeb8a9bc9421d174cd378ae39", size = 175328, upload-time = "2026-01-10T09:22:49.809Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/18/29/71729b4671f21e1eaa5d6573031ab810ad2936c8175f03f97f3ff164c802/websockets-16.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:9b5aca38b67492ef518a8ab76851862488a478602229112c4b0d58d63a7a4d5c", size = 184915, upload-time = "2026-01-10T09:22:51.071Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/97/bb/21c36b7dbbafc85d2d480cd65df02a1dc93bf76d97147605a8e27ff9409d/websockets-16.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e0334872c0a37b606418ac52f6ab9cfd17317ac26365f7f65e203e2d0d0d359f", size = 186152, upload-time = "2026-01-10T09:22:52.224Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/4a/34/9bf8df0c0cf88fa7bfe36678dc7b02970c9a7d5e065a3099292db87b1be2/websockets-16.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:a0b31e0b424cc6b5a04b8838bbaec1688834b2383256688cf47eb97412531da1", size = 185583, upload-time = "2026-01-10T09:22:53.443Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/47/88/4dd516068e1a3d6ab3c7c183288404cd424a9a02d585efbac226cb61ff2d/websockets-16.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:485c49116d0af10ac698623c513c1cc01c9446c058a4e61e3bf6c19dff7335a2", size = 184880, upload-time = "2026-01-10T09:22:55.033Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/91/d6/7d4553ad4bf1c0421e1ebd4b18de5d9098383b5caa1d937b63df8d04b565/websockets-16.0-cp312-cp312-win32.whl", hash = "sha256:eaded469f5e5b7294e2bdca0ab06becb6756ea86894a47806456089298813c89", size = 178261, upload-time = "2026-01-10T09:22:56.251Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c3/f0/f3a17365441ed1c27f850a80b2bc680a0fa9505d733fe152fdf5e98c1c0b/websockets-16.0-cp312-cp312-win_amd64.whl", hash = "sha256:5569417dc80977fc8c2d43a86f78e0a5a22fee17565d78621b6bb264a115d4ea", size = 178693, upload-time = "2026-01-10T09:22:57.478Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/cc/9c/baa8456050d1c1b08dd0ec7346026668cbc6f145ab4e314d707bb845bf0d/websockets-16.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:878b336ac47938b474c8f982ac2f7266a540adc3fa4ad74ae96fea9823a02cc9", size = 177364, upload-time = "2026-01-10T09:22:59.333Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/7e/0c/8811fc53e9bcff68fe7de2bcbe75116a8d959ac699a3200f4847a8925210/websockets-16.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:52a0fec0e6c8d9a784c2c78276a48a2bdf099e4ccc2a4cad53b27718dbfd0230", size = 175039, upload-time = "2026-01-10T09:23:01.171Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/aa/82/39a5f910cb99ec0b59e482971238c845af9220d3ab9fa76dd9162cda9d62/websockets-16.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e6578ed5b6981005df1860a56e3617f14a6c307e6a71b4fff8c48fdc50f3ed2c", size = 175323, upload-time = "2026-01-10T09:23:02.341Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/bd/28/0a25ee5342eb5d5f297d992a77e56892ecb65e7854c7898fb7d35e9b33bd/websockets-16.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:95724e638f0f9c350bb1c2b0a7ad0e83d9cc0c9259f3ea94e40d7b02a2179ae5", size = 184975, upload-time = "2026-01-10T09:23:03.756Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f9/66/27ea52741752f5107c2e41fda05e8395a682a1e11c4e592a809a90c6a506/websockets-16.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c0204dc62a89dc9d50d682412c10b3542d748260d743500a85c13cd1ee4bde82", size = 186203, upload-time = "2026-01-10T09:23:05.01Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/37/e5/8e32857371406a757816a2b471939d51c463509be73fa538216ea52b792a/websockets-16.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:52ac480f44d32970d66763115edea932f1c5b1312de36df06d6b219f6741eed8", size = 185653, upload-time = "2026-01-10T09:23:06.301Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9b/67/f926bac29882894669368dc73f4da900fcdf47955d0a0185d60103df5737/websockets-16.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6e5a82b677f8f6f59e8dfc34ec06ca6b5b48bc4fcda346acd093694cc2c24d8f", size = 184920, upload-time = "2026-01-10T09:23:07.492Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/3c/a1/3d6ccdcd125b0a42a311bcd15a7f705d688f73b2a22d8cf1c0875d35d34a/websockets-16.0-cp313-cp313-win32.whl", hash = "sha256:abf050a199613f64c886ea10f38b47770a65154dc37181bfaff70c160f45315a", size = 178255, upload-time = "2026-01-10T09:23:09.245Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/6b/ae/90366304d7c2ce80f9b826096a9e9048b4bb760e44d3b873bb272cba696b/websockets-16.0-cp313-cp313-win_amd64.whl", hash = "sha256:3425ac5cf448801335d6fdc7ae1eb22072055417a96cc6b31b3861f455fbc156", size = 178689, upload-time = "2026-01-10T09:23:10.483Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f3/1d/e88022630271f5bd349ed82417136281931e558d628dd52c4d8621b4a0b2/websockets-16.0-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:8cc451a50f2aee53042ac52d2d053d08bf89bcb31ae799cb4487587661c038a0", size = 177406, upload-time = "2026-01-10T09:23:12.178Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f2/78/e63be1bf0724eeb4616efb1ae1c9044f7c3953b7957799abb5915bffd38e/websockets-16.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:daa3b6ff70a9241cf6c7fc9e949d41232d9d7d26fd3522b1ad2b4d62487e9904", size = 175085, upload-time = "2026-01-10T09:23:13.511Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/bb/f4/d3c9220d818ee955ae390cf319a7c7a467beceb24f05ee7aaaa2414345ba/websockets-16.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:fd3cb4adb94a2a6e2b7c0d8d05cb94e6f1c81a0cf9dc2694fb65c7e8d94c42e4", size = 175328, upload-time = "2026-01-10T09:23:14.727Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/63/bc/d3e208028de777087e6fb2b122051a6ff7bbcca0d6df9d9c2bf1dd869ae9/websockets-16.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:781caf5e8eee67f663126490c2f96f40906594cb86b408a703630f95550a8c3e", size = 185044, upload-time = "2026-01-10T09:23:15.939Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ad/6e/9a0927ac24bd33a0a9af834d89e0abc7cfd8e13bed17a86407a66773cc0e/websockets-16.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:caab51a72c51973ca21fa8a18bd8165e1a0183f1ac7066a182ff27107b71e1a4", size = 186279, upload-time = "2026-01-10T09:23:17.148Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b9/ca/bf1c68440d7a868180e11be653c85959502efd3a709323230314fda6e0b3/websockets-16.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:19c4dc84098e523fd63711e563077d39e90ec6702aff4b5d9e344a60cb3c0cb1", size = 185711, upload-time = "2026-01-10T09:23:18.372Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c4/f8/fdc34643a989561f217bb477cbc47a3a07212cbda91c0e4389c43c296ebf/websockets-16.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:a5e18a238a2b2249c9a9235466b90e96ae4795672598a58772dd806edc7ac6d3", size = 184982, upload-time = "2026-01-10T09:23:19.652Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/dd/d1/574fa27e233764dbac9c52730d63fcf2823b16f0856b3329fc6268d6ae4f/websockets-16.0-cp314-cp314-win32.whl", hash = "sha256:a069d734c4a043182729edd3e9f247c3b2a4035415a9172fd0f1b71658a320a8", size = 177915, upload-time = "2026-01-10T09:23:21.458Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8a/f1/ae6b937bf3126b5134ce1f482365fde31a357c784ac51852978768b5eff4/websockets-16.0-cp314-cp314-win_amd64.whl", hash = "sha256:c0ee0e63f23914732c6d7e0cce24915c48f3f1512ec1d079ed01fc629dab269d", size = 178381, upload-time = "2026-01-10T09:23:22.715Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/06/9b/f791d1db48403e1f0a27577a6beb37afae94254a8c6f08be4a23e4930bc0/websockets-16.0-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:a35539cacc3febb22b8f4d4a99cc79b104226a756aa7400adc722e83b0d03244", size = 177737, upload-time = "2026-01-10T09:23:24.523Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/bd/40/53ad02341fa33b3ce489023f635367a4ac98b73570102ad2cdd770dacc9a/websockets-16.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:b784ca5de850f4ce93ec85d3269d24d4c82f22b7212023c974c401d4980ebc5e", size = 175268, upload-time = "2026-01-10T09:23:25.781Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/74/9b/6158d4e459b984f949dcbbb0c5d270154c7618e11c01029b9bbd1bb4c4f9/websockets-16.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:569d01a4e7fba956c5ae4fc988f0d4e187900f5497ce46339c996dbf24f17641", size = 175486, upload-time = "2026-01-10T09:23:27.033Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e5/2d/7583b30208b639c8090206f95073646c2c9ffd66f44df967981a64f849ad/websockets-16.0-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:50f23cdd8343b984957e4077839841146f67a3d31ab0d00e6b824e74c5b2f6e8", size = 185331, upload-time = "2026-01-10T09:23:28.259Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/45/b0/cce3784eb519b7b5ad680d14b9673a31ab8dcb7aad8b64d81709d2430aa8/websockets-16.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:152284a83a00c59b759697b7f9e9cddf4e3c7861dd0d964b472b70f78f89e80e", size = 186501, upload-time = "2026-01-10T09:23:29.449Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/19/60/b8ebe4c7e89fb5f6cdf080623c9d92789a53636950f7abacfc33fe2b3135/websockets-16.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:bc59589ab64b0022385f429b94697348a6a234e8ce22544e3681b2e9331b5944", size = 186062, upload-time = "2026-01-10T09:23:31.368Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/88/a8/a080593f89b0138b6cba1b28f8df5673b5506f72879322288b031337c0b8/websockets-16.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:32da954ffa2814258030e5a57bc73a3635463238e797c7375dc8091327434206", size = 185356, upload-time = "2026-01-10T09:23:32.627Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c2/b6/b9afed2afadddaf5ebb2afa801abf4b0868f42f8539bfe4b071b5266c9fe/websockets-16.0-cp314-cp314t-win32.whl", hash = "sha256:5a4b4cc550cb665dd8a47f868c8d04c8230f857363ad3c9caf7a0c3bf8c61ca6", size = 178085, upload-time = "2026-01-10T09:23:33.816Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9f/3e/28135a24e384493fa804216b79a6a6759a38cc4ff59118787b9fb693df93/websockets-16.0-cp314-cp314t-win_amd64.whl", hash = "sha256:b14dc141ed6d2dde437cddb216004bcac6a1df0935d79656387bd41632ba0bbd", size = 178531, upload-time = "2026-01-10T09:23:35.016Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/6f/28/258ebab549c2bf3e64d2b0217b973467394a9cea8c42f70418ca2c5d0d2e/websockets-16.0-py3-none-any.whl", hash = "sha256:1637db62fad1dc833276dded54215f2c7fa46912301a24bd94d45d46a011ceec", size = 171598, upload-time = "2026-01-10T09:23:45.395Z" },
+]
+
+[[package]]
+name = "wrapt"
+version = "2.2.2"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fe/a4/282c8e64300a59fc834518a54bf0afabb4ff9218b5fa76958b450459a844/wrapt-2.2.2.tar.gz", hash = "sha256:0788e321027c999bf221b667bd4a54aaefd1a36283749a860ac3eb77daed0302", size = 129068, upload-time = "2026-06-20T23:49:44.49Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/2a/85/180b40628b23772692a0c76e8030114e1c0ae068470ed531919f0a5f2a4a/wrapt-2.2.2-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:8417fd3c674d3c8023d080292d29301531a12daf8bd938dd419710dd2f464f2b", size = 81484, upload-time = "2026-06-20T23:47:59.924Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/94/f2/21c90f2a16689702e2aaff45795b11018dff2c9b1242bac10d225483f676/wrapt-2.2.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:0e7070c7472582e31af3dfc2622b2381a0df7435110a9388ed8db5ffbce67efb", size = 82151, upload-time = "2026-06-20T23:48:01.303Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5f/b3/7e6e9fcf4fe7e1b69a49fe6cc5a44e8224bab6283c5233c97e132f14908e/wrapt-2.2.2-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:2e096c9d39a59b35b63c9aacfbbbec2088ff51ff1fc31051acc60a07f42f273a", size = 169828, upload-time = "2026-06-20T23:48:02.719Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/0b/43/894f132d857ed5a9904d937baf368badcbe5ea9e436e2f1930fe21c9f1f0/wrapt-2.2.2-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6d1a6050405bf334be33bf66296f113563622972a34900ae6fa60fd283a1a900", size = 171544, upload-time = "2026-06-20T23:48:04.266Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/29/de/3c833e03725b477e9ea34028224dd21a48781830101e4e036f77e8b6b102/wrapt-2.2.2-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:10adb01371408c6de504a6658b9886480f1a4919a83752748a387a504a21df79", size = 160663, upload-time = "2026-06-20T23:48:05.708Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/33/be/27edce350b24e3054d9d047f65f16d4c4d4c1f3f31c4278a1f8a95c723c8/wrapt-2.2.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3442eee2a5798f9b451f1b2cd7518ce8b7e28a2a364696c414460a0e295c012a", size = 169387, upload-time = "2026-06-20T23:48:07.243Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e2/c4/9fd9679af8bf38e146652c7f47b6b352c3e5795b4ad1c0b7f94e15ac2aa7/wrapt-2.2.2-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:6c99012a22f735a85eed7c4b86a3e99c30fdd57d9e115b2b45f796264b58d0bf", size = 158849, upload-time = "2026-06-20T23:48:08.91Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/bc/c2/aa6c0c2206803068c6859dabe01f8c84c43744da93d4c67b8946d21655ee/wrapt-2.2.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:3b686cfc008776a3952d6213cb296ed7f45d782a8453936406faa89eac0835ab", size = 168147, upload-time = "2026-06-20T23:48:10.374Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/42/63/3eb25da41049d20ae18fcab2dd8b056e02387c4bfa626cbdfb7c3b872e4f/wrapt-2.2.2-cp312-cp312-win32.whl", hash = "sha256:ef2cce266b5b0b07e19fa82e59673b81142b7a3607c8ed1254113d048ed668da", size = 77734, upload-time = "2026-06-20T23:48:11.769Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/da/09/0390e008a305360948fa9ce69507d041ac12cb2ee5d28e34467e2ee79391/wrapt-2.2.2-cp312-cp312-win_amd64.whl", hash = "sha256:abf8c20a2d72ee69e16328b3c91342c446e723bfe48bfcc4dded3b9722ac027f", size = 80585, upload-time = "2026-06-20T23:48:13.117Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d3/b3/84c445c66969f2d3457276b183a48c91097d59bbef9af6c075366b0f8c36/wrapt-2.2.2-cp312-cp312-win_arm64.whl", hash = "sha256:c6c64c5d02578bc4c4bca4f0aef1504de933c1d5b4ac2710b9131111459506c8", size = 79553, upload-time = "2026-06-20T23:48:14.5Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/43/fc/f32f4b22c6511173c11d9e541ab4e7d8467a0f1b3455acaf784115d31ff8/wrapt-2.2.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:9e8b648270c613720a202d9a45ebabc33261b22c3a839b115ac5bce8c0bb0d69", size = 81296, upload-time = "2026-06-20T23:48:15.881Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/72/06/4d117d5d77a9344776c0248b24dae3d3dd2f58e5f765fa08cf887072e719/wrapt-2.2.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e6fb7e94e8fe3e4c3067bb1653a91cce7c5e83acc119fdd41501b1bf74654617", size = 81841, upload-time = "2026-06-20T23:48:17.262Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/15/ff/63ad96f98eb58a742b1a20d80f21da88924405910149950b912368150468/wrapt-2.2.2-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:fb18fc51e813df0d9c98049e3bf2298a5495a648602040e21fa3c7329371159e", size = 167882, upload-time = "2026-06-20T23:48:18.764Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/20/1f/8bb62d8933df7acf3247194e6e9fc68edf9d2fa203252c89c94b319dd472/wrapt-2.2.2-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:94b00b00f806eb3ef2abe9049ed45994a81ee9284884d96e6b8314927c6cea3d", size = 167411, upload-time = "2026-06-20T23:48:20.315Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/17/09/8789dcb09ee1de715727db7521aabbb68ffa68dfade3a49468440cfced49/wrapt-2.2.2-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:62415fd095bc590b842b6d092f2b5d9ccbaeb7e0b28535c03dcea2718b48636b", size = 158607, upload-time = "2026-06-20T23:48:21.728Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9c/20/66e02562d53ee67d841f175e38e3c993c2d78a3e104c576cad61c028b43c/wrapt-2.2.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a41e758d80dc0ab8c210f641ac892009d356cf1f955d97db544c8dd317b4d14c", size = 166367, upload-time = "2026-06-20T23:48:23.177Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/bd/a3/832ac4e41222fb263b3042d42c2f08d305db7d0f0c9b1d3a271a9eede8f6/wrapt-2.2.2-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:b84cd4058001c9727b0e9980b7a9e66325b5ca748b1b578e822cade1bc6b304f", size = 157176, upload-time = "2026-06-20T23:48:24.711Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b7/01/1bd5e4d2df9c0178989ac8da9186543465388588ee2ef153e2591accebef/wrapt-2.2.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:26fc73a1b15e0946d2942b9a4426d162b51676338327dc067ccd8d2d76385f94", size = 167025, upload-time = "2026-06-20T23:48:26.118Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1c/69/583ed25291ab53e1ec117135fb1c33425e2f46d2bc8f29c17f7a94cf4274/wrapt-2.2.2-cp313-cp313-win32.whl", hash = "sha256:3c4095803491f6ef72128914c28ec05bbad9758433bb35f6715a3e9c8e46fb2d", size = 77605, upload-time = "2026-06-20T23:48:27.643Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/29/68/e69fc6d06e1523c68e0d00f95c9aed1158ce9908ee41603f7f2eae3d5db6/wrapt-2.2.2-cp313-cp313-win_amd64.whl", hash = "sha256:2cb07f414fab25dbe6b5c7398e1491423a5c81a6209533639969a6c928d474a4", size = 80508, upload-time = "2026-06-20T23:48:29.013Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/55/21/fe7a393d9e5dc0923bed8f5d857e9dcff210f1fa0888c02cc8f3ffaa55aa/wrapt-2.2.2-cp313-cp313-win_arm64.whl", hash = "sha256:1fc7691f070220215cccb2a20836b9adbaecb8ff22ad47abe63de5f110994fac", size = 79565, upload-time = "2026-06-20T23:48:30.429Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b6/e5/c120d13bf5091164f68c3c1657e84f16f57e71d978421b626393ac5bd7eb/wrapt-2.2.2-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:ec8f83949028366531383603139403cac7a826e4011955813cdd640017845ce5", size = 83264, upload-time = "2026-06-20T23:48:31.807Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d3/b0/d4a1eb97e0e286625bdf21bc7f702637f9607787ffbbdb5ec14d50c79dbf/wrapt-2.2.2-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:4b481fb0c40d9fd90a5809911208da700987d373a20a4709dc9e3944af7a6bec", size = 83791, upload-time = "2026-06-20T23:48:33.482Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/18/1e/f060df47755e87b57684cee7bfc1362b204df55fac96ffebc0631b697b79/wrapt-2.2.2-cp313-cp313t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:0065a3b657cec06813b4241d2462ccec287f6863103d7445b725fb3a889736f9", size = 203399, upload-time = "2026-06-20T23:48:34.97Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c4/de/2316a757a1abb6453700b79d83e532146dcef2611348282d4d8889792161/wrapt-2.2.2-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:30f7424af5c5c345b7f26490e097f74a2ef45b3d08b664dc33571aee3bd3b56c", size = 210461, upload-time = "2026-06-20T23:48:36.569Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ed/29/d1160785ae18ca2495a6d82a21154103d74f656c9fd457fb35f6b11b965a/wrapt-2.2.2-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:07fdcb012821859168641acf68afad61ef9783cf37100af85f152550e9677194", size = 195313, upload-time = "2026-06-20T23:48:38.175Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f5/2d/7caa9598ae61a9cf0989cc501739cbeeb7d650ab3193cca1407b9af0c6ab/wrapt-2.2.2-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:f90038ab58fafb584801ca62d72384d7d5225d93c76f7b773c22fae545bd8066", size = 206116, upload-time = "2026-06-20T23:48:39.804Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ac/02/281ea1088b8650d865f311b35cf86fd21df89128e2909714f1161e01c9d0/wrapt-2.2.2-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:c5d7825491bfa2d08b97e9557768987952c7b9ae687d06c3320b40a37ccb7f20", size = 192668, upload-time = "2026-06-20T23:48:41.346Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/be/7d/976e2d5b4b5c5babda40974edd54d0a5585cb60132ed86b46f4b80239b16/wrapt-2.2.2-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:0ad520e6daa9bbf136f14de735474dbec7dcc0891f718e1d274ce8dc92e645af", size = 198891, upload-time = "2026-06-20T23:48:43.056Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/59/b7/e47651797c097f75a37e2ce86dcf04048ff576f3a674f7c558df7b5e9622/wrapt-2.2.2-cp313-cp313t-win32.whl", hash = "sha256:25904acb9475f46c24fe0423dbc8fda8cc5fbc282ab3dc6e72e919748c53f4e9", size = 78537, upload-time = "2026-06-20T23:48:44.509Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d1/6f/9fa5d59fb06d890defb5a8f727ce6a14d2932c8760153f96956628559fee/wrapt-2.2.2-cp313-cp313t-win_amd64.whl", hash = "sha256:305d4c247d61c4115794a169141823c62f719525ddb90b23aa332741c77d2c28", size = 82005, upload-time = "2026-06-20T23:48:46.391Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/15/80/4c7bd9873d1f9f7d138d93556b500469dbe24f42710b877519c2b9eb380d/wrapt-2.2.2-cp313-cp313t-win_arm64.whl", hash = "sha256:c20279cd1a29800815d7b2d6338b60a6c6e78263f9d6e62e0eda251ba9cae2d0", size = 80762, upload-time = "2026-06-20T23:48:47.964Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/24/05/7fd9c3f83b2c74cbfc572a0b88aa37431e04bd8aed70d2c0efd3464206de/wrapt-2.2.2-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:0e64826f920c42d9d9f87e8cc09ffae66c51ede12d59061a5a426deb9aa71745", size = 81341, upload-time = "2026-06-20T23:48:49.39Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/4b/68/1bfa43100dd90d4ef74a05897b86275cf57e1313ca14aae2545bc9f872c9/wrapt-2.2.2-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:dcaa5e1451bd8751d7bd1568dfa3321c78092a52a7ecb5d1a0f18a5791e1fd00", size = 81921, upload-time = "2026-06-20T23:48:50.986Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/74/eb/df7b7f0b631dbbc750f39be27d8b55f65777d8ac86da80e12be41a644c4b/wrapt-2.2.2-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:0abfd648dac9ac9c5b3aa9b523d27f1789046640b58dcd5652a720ddb325e1fc", size = 167713, upload-time = "2026-06-20T23:48:52.598Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/4d/9a/d1bd36f6d088c8e652a9383cabbd49af30b8c576302a7eccddbab6963e3f/wrapt-2.2.2-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f4bfd8d1eb438153eff8b8cfe87f032ba65731e1ce06138b5090f745a33f6f95", size = 166779, upload-time = "2026-06-20T23:48:54.33Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/4c/ae/24ffacd4187fac2740a1972093929e836dea092d42c87d728cd98fee11a6/wrapt-2.2.2-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c427c9d06d859848a69f0d928fe28b5c33a941b2265d10a0e1f15cd244f1ee33", size = 158407, upload-time = "2026-06-20T23:48:55.944Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a3/ed/974427668249a356051e8d67d47fa54ef6c777f0fcf3bae9d292c047d4b6/wrapt-2.2.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:4250b43d1a129d947e083c4dc6baf333c9bb34edd26f912d5b0457841fc858ab", size = 166594, upload-time = "2026-06-20T23:48:57.617Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fb/5f/e1d7c6e4523f78db2fbd7826babd0348da1d5e0834c4f918b9ab5757dfae/wrapt-2.2.2-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:173e5bb5ca350a6e0abab60b7ec7cdd7992a814cb14b4de670a28f067f105663", size = 157068, upload-time = "2026-06-20T23:48:59.171Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1e/c1/7ebd1027f00700c0b0233b20aceef2b4784294ed64971424c4a78e069e34/wrapt-2.2.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:aa14b01804bce36c6d63d7b6a4f55df390f29f8648cc13a1f40b166f4d54680d", size = 166470, upload-time = "2026-06-20T23:49:00.737Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/99/eb/974e471a6a978b8180186b8a9dc5ae3361ce269a967190b709b8ce17abfb/wrapt-2.2.2-cp314-cp314-win32.whl", hash = "sha256:58f9f8d637c9a6e245c6ef5b109b67ec187d2faed23d1405656b51d96e0a5b56", size = 78062, upload-time = "2026-06-20T23:49:02.327Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/49/ec/e1281156cdc7a66693838ad7a0865ad641c74abd337a957d668b575aaffb/wrapt-2.2.2-cp314-cp314-win_amd64.whl", hash = "sha256:385cb1866f20479e83299af585375bfa0a4b0c6c9907a981483ea782ea8ae406", size = 80832, upload-time = "2026-06-20T23:49:03.837Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/45/7d/1b6b5ddd94005a2dac97a4490c9838f3154977850d633abcb65b30089437/wrapt-2.2.2-cp314-cp314-win_arm64.whl", hash = "sha256:8ffbeaea6771a6eba6e6eeb09767864995726bc8240bb54baf88a9bb1db34d5c", size = 80029, upload-time = "2026-06-20T23:49:05.237Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b0/33/9ebcf8aafe91c601127cbd93708c16aa8f688f34a10bf004046803ecdc4f/wrapt-2.2.2-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:09f811d43f6f33ec7515f0be76b159569f4057ab54d3e079c3204dddb90afa2a", size = 83357, upload-time = "2026-06-20T23:49:06.632Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/39/38/ec45b635153327b52e52732a0ea980e5f00b7efba65f9e018828f1e69daa/wrapt-2.2.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:a795d3c06e5fbf9ea2f13196180b77aeab1b4685917256ee0d014cc163d90063", size = 83794, upload-time = "2026-06-20T23:49:08.098Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/4e/ea/1a89e6d3b7a83c3affe5c09cde77792c947e63e4bc85ad84cd5bb9abb0d8/wrapt-2.2.2-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:45c2f2768e790c9f8db90f239ef23a2af8e7570f25a35619ef902df4a738447f", size = 203362, upload-time = "2026-06-20T23:49:09.811Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/19/d8/3b58763d9863b5a73771c0d97110f9595d248db454009e07e1535ee905a4/wrapt-2.2.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:bbf00ee0cb55ec24e2b0995a71942b85b21a066db8f3f46e1dbfdb9433ffba81", size = 210449, upload-time = "2026-06-20T23:49:11.521Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/2d/6f/17fd9e053103d8be148d20d5d7505facc72d5fe1f9127973904ceaed79cf/wrapt-2.2.2-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:2252f77663651b89255895f58cc6ac08fcb206d4371813e5af61bb62d4f7689c", size = 195349, upload-time = "2026-06-20T23:49:13.346Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ef/04/d0d1ccaaa12cb7dccf28a23f0279a608ba498f71e81d949d5ed54bcfd5c1/wrapt-2.2.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:2cd7181ab1c31192ff5219269830744b5a62020b3a6d433588c4f1c95b8f8bff", size = 206099, upload-time = "2026-06-20T23:49:15.051Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/44/b3/e8aa07b619890a2aa6cde1931b1887abb08820721b564a5f80b7ca3f3aa0/wrapt-2.2.2-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:6fe35fd51b74867d8b80174c277bd6bbf6a73e443f908129dc531c4b688a20d5", size = 192728, upload-time = "2026-06-20T23:49:16.854Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b7/f0/1819fb50f0d3c9bd758d8a83b56f1b470dee8b5b8eac8702b7c137cea9d4/wrapt-2.2.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:11d95fc2fbad3163596c39d440e6f21ca9fccece74b56e30a37ac2fca786a07c", size = 198842, upload-time = "2026-06-20T23:49:18.504Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/67/7c/e88313f16a99930b899ef970d91c281544a470749a359decad994483bbda/wrapt-2.2.2-cp314-cp314t-win32.whl", hash = "sha256:d8a15813215f33fa83667bfc978b300e35669ea8bb424e970a1426bcb7bc6cca", size = 79059, upload-time = "2026-06-20T23:49:20.107Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a0/4f/ac12fda57a55068a094ec42851fb0a40e8489d8941863d517452de62e507/wrapt-2.2.2-cp314-cp314t-win_amd64.whl", hash = "sha256:d09db0f7e8357060d3c38fc22a018aba683a796bf184360fd1a58f6fc180dc77", size = 82462, upload-time = "2026-06-20T23:49:21.631Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/48/a7/df732dac86d9b2027c56bd163dbc883e037b16c3469614752e148d219c61/wrapt-2.2.2-cp314-cp314t-win_arm64.whl", hash = "sha256:f32fe639c39561ccc187bcae17e9271be0eb45f1c2952510d2f29b33ab577347", size = 81182, upload-time = "2026-06-20T23:49:23.199Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/6e/d2/6317eb6d4554855bbf12d61857774af34747bf88a42c19bf306de67e2fa3/wrapt-2.2.2-py3-none-any.whl", hash = "sha256:5bad217350f19ce99ca5b5e71d406765ea86fe541628426772b657375ee1c048", size = 61460, upload-time = "2026-06-20T23:49:42.966Z" },
+]
+
+[[package]]
+name = "zstandard"
+version = "0.25.0"
+source = { registry = "https://pypi.tuna.tsinghua.edu.cn/simple" }
+sdist = { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fd/aa/3e0508d5a5dd96529cdc5a97011299056e14c6505b678fd58938792794b1/zstandard-0.25.0.tar.gz", hash = "sha256:7713e1179d162cf5c7906da876ec2ccb9c3a9dcbdffef0cc7f70c3667a205f0b", size = 711513, upload-time = "2025-09-14T22:15:54.002Z" }
+wheels = [
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/82/fc/f26eb6ef91ae723a03e16eddb198abcfce2bc5a42e224d44cc8b6765e57e/zstandard-0.25.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7b3c3a3ab9daa3eed242d6ecceead93aebbb8f5f84318d82cee643e019c4b73b", size = 795738, upload-time = "2025-09-14T22:16:56.237Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/aa/1c/d920d64b22f8dd028a8b90e2d756e431a5d86194caa78e3819c7bf53b4b3/zstandard-0.25.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:913cbd31a400febff93b564a23e17c3ed2d56c064006f54efec210d586171c00", size = 640436, upload-time = "2025-09-14T22:16:57.774Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/53/6c/288c3f0bd9fcfe9ca41e2c2fbfd17b2097f6af57b62a81161941f09afa76/zstandard-0.25.0-cp312-cp312-manylinux2010_i686.manylinux2014_i686.manylinux_2_12_i686.manylinux_2_17_i686.whl", hash = "sha256:011d388c76b11a0c165374ce660ce2c8efa8e5d87f34996aa80f9c0816698b64", size = 5343019, upload-time = "2025-09-14T22:16:59.302Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1e/15/efef5a2f204a64bdb5571e6161d49f7ef0fffdbca953a615efbec045f60f/zstandard-0.25.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:6dffecc361d079bb48d7caef5d673c88c8988d3d33fb74ab95b7ee6da42652ea", size = 5063012, upload-time = "2025-09-14T22:17:01.156Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b7/37/a6ce629ffdb43959e92e87ebdaeebb5ac81c944b6a75c9c47e300f85abdf/zstandard-0.25.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:7149623bba7fdf7e7f24312953bcf73cae103db8cae49f8154dd1eadc8a29ecb", size = 5394148, upload-time = "2025-09-14T22:17:03.091Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/e3/79/2bf870b3abeb5c070fe2d670a5a8d1057a8270f125ef7676d29ea900f496/zstandard-0.25.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:6a573a35693e03cf1d67799fd01b50ff578515a8aeadd4595d2a7fa9f3ec002a", size = 5451652, upload-time = "2025-09-14T22:17:04.979Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/53/60/7be26e610767316c028a2cbedb9a3beabdbe33e2182c373f71a1c0b88f36/zstandard-0.25.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:5a56ba0db2d244117ed744dfa8f6f5b366e14148e00de44723413b2f3938a902", size = 5546993, upload-time = "2025-09-14T22:17:06.781Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/85/c7/3483ad9ff0662623f3648479b0380d2de5510abf00990468c286c6b04017/zstandard-0.25.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:10ef2a79ab8e2974e2075fb984e5b9806c64134810fac21576f0668e7ea19f8f", size = 5046806, upload-time = "2025-09-14T22:17:08.415Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/08/b3/206883dd25b8d1591a1caa44b54c2aad84badccf2f1de9e2d60a446f9a25/zstandard-0.25.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:aaf21ba8fb76d102b696781bddaa0954b782536446083ae3fdaa6f16b25a1c4b", size = 5576659, upload-time = "2025-09-14T22:17:10.164Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9d/31/76c0779101453e6c117b0ff22565865c54f48f8bd807df2b00c2c404b8e0/zstandard-0.25.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:1869da9571d5e94a85a5e8d57e4e8807b175c9e4a6294e3b66fa4efb074d90f6", size = 4953933, upload-time = "2025-09-14T22:17:11.857Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/18/e1/97680c664a1bf9a247a280a053d98e251424af51f1b196c6d52f117c9720/zstandard-0.25.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:809c5bcb2c67cd0ed81e9229d227d4ca28f82d0f778fc5fea624a9def3963f91", size = 5268008, upload-time = "2025-09-14T22:17:13.627Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1e/73/316e4010de585ac798e154e88fd81bb16afc5c5cb1a72eeb16dd37e8024a/zstandard-0.25.0-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:f27662e4f7dbf9f9c12391cb37b4c4c3cb90ffbd3b1fb9284dadbbb8935fa708", size = 5433517, upload-time = "2025-09-14T22:17:16.103Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5b/60/dd0f8cfa8129c5a0ce3ea6b7f70be5b33d2618013a161e1ff26c2b39787c/zstandard-0.25.0-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:99c0c846e6e61718715a3c9437ccc625de26593fea60189567f0118dc9db7512", size = 5814292, upload-time = "2025-09-14T22:17:17.827Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/fc/5f/75aafd4b9d11b5407b641b8e41a57864097663699f23e9ad4dbb91dc6bfe/zstandard-0.25.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:474d2596a2dbc241a556e965fb76002c1ce655445e4e3bf38e5477d413165ffa", size = 5360237, upload-time = "2025-09-14T22:17:19.954Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ff/8d/0309daffea4fcac7981021dbf21cdb2e3427a9e76bafbcdbdf5392ff99a4/zstandard-0.25.0-cp312-cp312-win32.whl", hash = "sha256:23ebc8f17a03133b4426bcc04aabd68f8236eb78c3760f12783385171b0fd8bd", size = 436922, upload-time = "2025-09-14T22:17:24.398Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/79/3b/fa54d9015f945330510cb5d0b0501e8253c127cca7ebe8ba46a965df18c5/zstandard-0.25.0-cp312-cp312-win_amd64.whl", hash = "sha256:ffef5a74088f1e09947aecf91011136665152e0b4b359c42be3373897fb39b01", size = 506276, upload-time = "2025-09-14T22:17:21.429Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/ea/6b/8b51697e5319b1f9ac71087b0af9a40d8a6288ff8025c36486e0c12abcc4/zstandard-0.25.0-cp312-cp312-win_arm64.whl", hash = "sha256:181eb40e0b6a29b3cd2849f825e0fa34397f649170673d385f3598ae17cca2e9", size = 462679, upload-time = "2025-09-14T22:17:23.147Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/35/0b/8df9c4ad06af91d39e94fa96cc010a24ac4ef1378d3efab9223cc8593d40/zstandard-0.25.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:ec996f12524f88e151c339688c3897194821d7f03081ab35d31d1e12ec975e94", size = 795735, upload-time = "2025-09-14T22:17:26.042Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/3f/06/9ae96a3e5dcfd119377ba33d4c42a7d89da1efabd5cb3e366b156c45ff4d/zstandard-0.25.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:a1a4ae2dec3993a32247995bdfe367fc3266da832d82f8438c8570f989753de1", size = 640440, upload-time = "2025-09-14T22:17:27.366Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d9/14/933d27204c2bd404229c69f445862454dcc101cd69ef8c6068f15aaec12c/zstandard-0.25.0-cp313-cp313-manylinux2010_i686.manylinux2014_i686.manylinux_2_12_i686.manylinux_2_17_i686.whl", hash = "sha256:e96594a5537722fdfb79951672a2a63aec5ebfb823e7560586f7484819f2a08f", size = 5343070, upload-time = "2025-09-14T22:17:28.896Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/6d/db/ddb11011826ed7db9d0e485d13df79b58586bfdec56e5c84a928a9a78c1c/zstandard-0.25.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:bfc4e20784722098822e3eee42b8e576b379ed72cca4a7cb856ae733e62192ea", size = 5063001, upload-time = "2025-09-14T22:17:31.044Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/db/00/87466ea3f99599d02a5238498b87bf84a6348290c19571051839ca943777/zstandard-0.25.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:457ed498fc58cdc12fc48f7950e02740d4f7ae9493dd4ab2168a47c93c31298e", size = 5394120, upload-time = "2025-09-14T22:17:32.711Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/2b/95/fc5531d9c618a679a20ff6c29e2b3ef1d1f4ad66c5e161ae6ff847d102a9/zstandard-0.25.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:fd7a5004eb1980d3cefe26b2685bcb0b17989901a70a1040d1ac86f1d898c551", size = 5451230, upload-time = "2025-09-14T22:17:34.41Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/63/4b/e3678b4e776db00f9f7b2fe58e547e8928ef32727d7a1ff01dea010f3f13/zstandard-0.25.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8e735494da3db08694d26480f1493ad2cf86e99bdd53e8e9771b2752a5c0246a", size = 5547173, upload-time = "2025-09-14T22:17:36.084Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/4e/d5/ba05ed95c6b8ec30bd468dfeab20589f2cf709b5c940483e31d991f2ca58/zstandard-0.25.0-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:3a39c94ad7866160a4a46d772e43311a743c316942037671beb264e395bdd611", size = 5046736, upload-time = "2025-09-14T22:17:37.891Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/50/d5/870aa06b3a76c73eced65c044b92286a3c4e00554005ff51962deef28e28/zstandard-0.25.0-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:172de1f06947577d3a3005416977cce6168f2261284c02080e7ad0185faeced3", size = 5576368, upload-time = "2025-09-14T22:17:40.206Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5d/35/398dc2ffc89d304d59bc12f0fdd931b4ce455bddf7038a0a67733a25f550/zstandard-0.25.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:3c83b0188c852a47cd13ef3bf9209fb0a77fa5374958b8c53aaa699398c6bd7b", size = 4954022, upload-time = "2025-09-14T22:17:41.879Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/9a/5c/36ba1e5507d56d2213202ec2b05e8541734af5f2ce378c5d1ceaf4d88dc4/zstandard-0.25.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:1673b7199bbe763365b81a4f3252b8e80f44c9e323fc42940dc8843bfeaf9851", size = 5267889, upload-time = "2025-09-14T22:17:43.577Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/70/e8/2ec6b6fb7358b2ec0113ae202647ca7c0e9d15b61c005ae5225ad0995df5/zstandard-0.25.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:0be7622c37c183406f3dbf0cba104118eb16a4ea7359eeb5752f0794882fc250", size = 5433952, upload-time = "2025-09-14T22:17:45.271Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/7b/01/b5f4d4dbc59ef193e870495c6f1275f5b2928e01ff5a81fecb22a06e22fb/zstandard-0.25.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:5f5e4c2a23ca271c218ac025bd7d635597048b366d6f31f420aaeb715239fc98", size = 5814054, upload-time = "2025-09-14T22:17:47.08Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/b2/e5/fbd822d5c6f427cf158316d012c5a12f233473c2f9c5fe5ab1ae5d21f3d8/zstandard-0.25.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4f187a0bb61b35119d1926aee039524d1f93aaf38a9916b8c4b78ac8514a0aaf", size = 5360113, upload-time = "2025-09-14T22:17:48.893Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8e/e0/69a553d2047f9a2c7347caa225bb3a63b6d7704ad74610cb7823baa08ed7/zstandard-0.25.0-cp313-cp313-win32.whl", hash = "sha256:7030defa83eef3e51ff26f0b7bfb229f0204b66fe18e04359ce3474ac33cbc09", size = 436936, upload-time = "2025-09-14T22:17:52.658Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d9/82/b9c06c870f3bd8767c201f1edbdf9e8dc34be5b0fbc5682c4f80fe948475/zstandard-0.25.0-cp313-cp313-win_amd64.whl", hash = "sha256:1f830a0dac88719af0ae43b8b2d6aef487d437036468ef3c2ea59c51f9d55fd5", size = 506232, upload-time = "2025-09-14T22:17:50.402Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/d4/57/60c3c01243bb81d381c9916e2a6d9e149ab8627c0c7d7abb2d73384b3c0c/zstandard-0.25.0-cp313-cp313-win_arm64.whl", hash = "sha256:85304a43f4d513f5464ceb938aa02c1e78c2943b29f44a750b48b25ac999a049", size = 462671, upload-time = "2025-09-14T22:17:51.533Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/3d/5c/f8923b595b55fe49e30612987ad8bf053aef555c14f05bb659dd5dbe3e8a/zstandard-0.25.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:e29f0cf06974c899b2c188ef7f783607dbef36da4c242eb6c82dcd8b512855e3", size = 795887, upload-time = "2025-09-14T22:17:54.198Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/8d/09/d0a2a14fc3439c5f874042dca72a79c70a532090b7ba0003be73fee37ae2/zstandard-0.25.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:05df5136bc5a011f33cd25bc9f506e7426c0c9b3f9954f056831ce68f3b6689f", size = 640658, upload-time = "2025-09-14T22:17:55.423Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/5d/7c/8b6b71b1ddd517f68ffb55e10834388d4f793c49c6b83effaaa05785b0b4/zstandard-0.25.0-cp314-cp314-manylinux2010_i686.manylinux_2_12_i686.manylinux_2_28_i686.whl", hash = "sha256:f604efd28f239cc21b3adb53eb061e2a205dc164be408e553b41ba2ffe0ca15c", size = 5379849, upload-time = "2025-09-14T22:17:57.372Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a4/86/a48e56320d0a17189ab7a42645387334fba2200e904ee47fc5a26c1fd8ca/zstandard-0.25.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:223415140608d0f0da010499eaa8ccdb9af210a543fac54bce15babbcfc78439", size = 5058095, upload-time = "2025-09-14T22:17:59.498Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f8/ad/eb659984ee2c0a779f9d06dbfe45e2dc39d99ff40a319895df2d3d9a48e5/zstandard-0.25.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:2e54296a283f3ab5a26fc9b8b5d4978ea0532f37b231644f367aa588930aa043", size = 5551751, upload-time = "2025-09-14T22:18:01.618Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/61/b3/b637faea43677eb7bd42ab204dfb7053bd5c4582bfe6b1baefa80ac0c47b/zstandard-0.25.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:ca54090275939dc8ec5dea2d2afb400e0f83444b2fc24e07df7fdef677110859", size = 6364818, upload-time = "2025-09-14T22:18:03.769Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/31/dc/cc50210e11e465c975462439a492516a73300ab8caa8f5e0902544fd748b/zstandard-0.25.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e09bb6252b6476d8d56100e8147b803befa9a12cea144bbe629dd508800d1ad0", size = 5560402, upload-time = "2025-09-14T22:18:05.954Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c9/ae/56523ae9c142f0c08efd5e868a6da613ae76614eca1305259c3bf6a0ed43/zstandard-0.25.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:a9ec8c642d1ec73287ae3e726792dd86c96f5681eb8df274a757bf62b750eae7", size = 4955108, upload-time = "2025-09-14T22:18:07.68Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/98/cf/c899f2d6df0840d5e384cf4c4121458c72802e8bda19691f3b16619f51e9/zstandard-0.25.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:a4089a10e598eae6393756b036e0f419e8c1d60f44a831520f9af41c14216cf2", size = 5269248, upload-time = "2025-09-14T22:18:09.753Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/1b/c0/59e912a531d91e1c192d3085fc0f6fb2852753c301a812d856d857ea03c6/zstandard-0.25.0-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:f67e8f1a324a900e75b5e28ffb152bcac9fbed1cc7b43f99cd90f395c4375344", size = 5430330, upload-time = "2025-09-14T22:18:11.966Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/a0/1d/7e31db1240de2df22a58e2ea9a93fc6e38cc29353e660c0272b6735d6669/zstandard-0.25.0-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:9654dbc012d8b06fc3d19cc825af3f7bf8ae242226df5f83936cb39f5fdc846c", size = 5811123, upload-time = "2025-09-14T22:18:13.907Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f6/49/fac46df5ad353d50535e118d6983069df68ca5908d4d65b8c466150a4ff1/zstandard-0.25.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:4203ce3b31aec23012d3a4cf4a2ed64d12fea5269c49aed5e4c3611b938e4088", size = 5359591, upload-time = "2025-09-14T22:18:16.465Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/c2/38/f249a2050ad1eea0bb364046153942e34abba95dd5520af199aed86fbb49/zstandard-0.25.0-cp314-cp314-win32.whl", hash = "sha256:da469dc041701583e34de852d8634703550348d5822e66a0c827d39b05365b12", size = 444513, upload-time = "2025-09-14T22:18:20.61Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/3a/43/241f9615bcf8ba8903b3f0432da069e857fc4fd1783bd26183db53c4804b/zstandard-0.25.0-cp314-cp314-win_amd64.whl", hash = "sha256:c19bcdd826e95671065f8692b5a4aa95c52dc7a02a4c5a0cac46deb879a017a2", size = 516118, upload-time = "2025-09-14T22:18:17.849Z" },
+    { url = "https://pypi.tuna.tsinghua.edu.cn/packages/f0/ef/da163ce2450ed4febf6467d77ccb4cd52c4c30ab45624bad26ca0a27260c/zstandard-0.25.0-cp314-cp314-win_arm64.whl", hash = "sha256:d7541afd73985c630bafcd6338d2518ae96060075f9463d7dc14cfb33514383d", size = 476940, upload-time = "2025-09-14T22:18:19.088Z" },
+]