Expand description
Yggdrasil 库目标：承载全部业务模块。
服务端二进制（src/main.rs）调用 startup::run；浏览器 WASM 由 cargo-leptos
以 hydrate feature 编译本库，入口是文件末尾的 hydrate()。
server 与 hydrate 互斥，不要同时开启。
Modules§
- api
- API 层根模块。
- app
- HTML 外壳、应用根组件与路由表。
- auth
- 认证辅助模块。
- bridges
- libs/ 下各 JS IIFE 库的 wasm-bindgen 桥接层。
- build_
info - 编译期注入的构建元信息。
- cache
- 基于 moka 的内存缓存层。
- components
- 组件模块 —— 按「可复用层级」组织，从通用到特定。
- compression
- HTTP 响应压缩：
COMPRESSION_ALGORITHMS配置、Accept-Encoding协商、编码器与动态压缩中间件。 - config
- 启动期一次性加载的进程级配置（Tier B：重启生效）。
- context
- 前端全局上下文定义。
- db
- 数据库连接模块。
- highlight
- 语法高亮模块。
- hooks
- 共享的 Leptos Hooks 模块。
- infra
- mcp
- MCP（Model Context Protocol）服务器。
- middleware
- Axum 中间件与启动期纯函数。
- models
- 数据模型模块。
- navigation
- 站内导航：JS 协调器与 Leptos 路由器之间的握手。
- og
- 分享图渲染：文章图与站点图，均为 1200×630 PNG（见 docs/v1.0-重设计方案.md「分享图」）。
- pages
- 前端路由页面模块。
- request_
ctx - 请求上下文访问：server fn 与服务端渲染期间读取当前请求、写入响应。
- route_
prefetch - 链接悬停预取：把站内地址映射到路由，提前下载目标页面的 WASM 分包。
- routes
- 站内地址枚举：只负责生成 href，不参与路由匹配。
- shutdown
- 进程退出协调。
- ssr_
cache - 有容量和 TTL 上限的匿名公开页 HTML 缓存。
- startup
- 服务端启动流程与 Axum 路由组装。
- static_
assets - 固定路径静态资源的内容版本号。
- tasks
- 后台任务调度入口。
- theme
- 主题（浅色 / 深色 / 跟随系统）管理。
- utils
- 通用工具函数子模块。