xfy
f6b7ab4333
直接访问 /post/slug#heading 或刷新该 URL 时，目标标题停在屏幕中间偏下，但点击目录 或标题跳转却正常。根因是时序竞争： post_content 的 use_effect 同步依次调用 __initMermaid（注册 IntersectionObserver， 异步）→ __scrollToHash。scrollToHash 的"立即 + 两帧"校正只覆盖浏览器原生 fragment-scroll；而 mermaid 懒加载（加载 ~1MB bundle → render → pre.innerHTML=svg） 是数百毫秒的异步链，发生在两帧之后。mermaid 块从源码文本膨胀成 SVG 图时撑高内容， 把目标标题推离已校准的落点。mermaid.ts 渲染完成后无任何落点修正。点击目录正常是 因为那时 mermaid 已渲染、布局稳定。 解法：scrollToHash 末尾新增 stabilizeScrollOnResize——在 STABILIZE_WINDOW_MS(2s) 内 用 ResizeObserver 观察 .post-content 容器，检测到布局变化即用 rAF 合并重新校正一次 落点。与 mermaid 解耦，同时覆盖图片/字体等所有异步位移源。用户主动滚动（wheel/ touchmove/keydown）或超时后自动停止，不与交互打架。重入安全：主题切换重跑 use_effect 时先 dispose 上一次稳定器，避免泄漏/叠加。 测试（hash-scroll.test.ts）新增 3 例：resize 后再校正、用户 wheel 后停止、重入清理旧 RO。
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。详见 部署指南。