xfy
5426458f4a
doc 构建报 8 个 broken_intra_doc_links + dx 构建报 7 个 dead_code 警告。 两者根源相同:被引用的常量/类型/模块要么是 server-only(消费方都在 #[cfg(feature="server")] 块里),要么是跨 cfg 引用(host doc 构建看不到 wasm32-only 类型)。 dead_code:给 sql_console 的 MAX_ROWS/ABSOLUTELY_FORBIDDEN/GuardResult 与 backup 的 BACKUP_DIR/FILENAME_RE/BACKUP_SIGNATURE 加 #[cfg(feature="server")] gate——这些都是安全护栏常量,消费方全在 server fn 体里,WASM 构建剥掉 fn 体后 常量即成死代码。sysinfo_sampler 的 WASM 桩 read_snapshot 加 allow(dead_code) (与 codemirror_bridge 既有处理一致)。 rustdoc 链接:跨模块引用改全路径(crate::xxx),跨 cfg 引用(EditorHandle 在 wasm32 mod 内、host doc 构建不可见)转义为纯文本。 验证:cargo doc(0 warning)+ cargo check(default)+ wasm32 check 全部干净。
Yggdrasil
基于 Dioxus 0.7 的全栈博客系统，Rust 单一代码库同时编译为 WASM 前端和原生服务端。
技术栈
- 框架: Dioxus 0.7 (fullstack)
- 数据库: PostgreSQL + tokio-postgres
- 样式: Tailwind CSS v4
- 密码: Argon2
- 会话: UUID token + cookie
功能
- 邮箱注册 / 登录（单管理员模式，首次注册后关闭）
- 会话管理与自动过期清理
- 暗色 / 亮色主题切换
- 后台文章撰写（Tiptap Markdown 编辑器）
- 文章归档与标签浏览
开发
依赖 Rust 1.95+、wasm32 目标、dx CLI、tailwindcss CLI v4 和 PostgreSQL。
# 配置数据库
DATABASE_URL=postgres://postgres:postgres@localhost:5432/yggdrasil
# 运行迁移（自动创建数据库并按顺序执行 migrations/ 下所有 SQL）
./migrate.sh
# 启动开发服务器
make dev
构建
make build
生产部署
生产环境必须前置反向代理（nginx/Caddy）做 TLS 终结，并设置 APP_BASE_URL、
COOKIE_SECURE=true、TRUSTED_PROXY_COUNT=1。详见 部署指南。