1085 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
xfy	f6b7ab4333	fix(post): scrollToHash 增加 ResizeObserver 布局稳定期，修正 mermaid 异步渲染导致的锚点落点偏移 ... 直接访问 /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。	2026-07-16 16:05:11 +08:00
xfy	1ea11b6434	style(checkbox): 文章页 task-list checkbox 改用 appearance:none 自绘圆角方框 ... 原生 checkbox 形状随浏览器而异(Safari 圆角小框/Chrome 直角), accent-color 只能上色无法统一形状。改为全自定义: - appearance:none + 4px 圆角 + 1.15rem 方框 - 勾选时 accent 绿填充,对勾用内联 SVG background (<input> 是替换元素,吃不到伪元素) - 亮色:中绿底 #40a02b + 白对勾(对比 ≥4.5:1) - 暗色:浅绿底 #a6e3a1 + 深对勾 #1e1e2e(白对勾在浅绿上对比不足) - 文章内 checkbox 是 disabled 展示态,故不加 focus/cursor 交互	2026-07-16 15:58:54 +08:00
xfy	e526da0571	style(code-block): 代码块字号从 13.6px 调整为 16px ... .md-content pre code 的 font-size 由 0.85em 改为 1rem, 锚定根字号 16px 以提升代码块可读性。行间 code 保持 0.85em 不变。	2026-07-16 15:52:58 +08:00
xfy	445b92f407	fix(mermaid): 改用 script 标签加载 IIFE bundle,修正全局变量取值 ... 根因:mermaid bundle 是 IIFE 格式(与项目其他前端库一致),挂全局变量 而非 ES module export。但 mermaid.ts 错用了 import() 取 .default—— IIFE 无 export,mod.default 是 undefined,导致 mermaid.initialize 调用 TypeError,流程图永远不渲染(数学公式不受影响,因为是服务端渲染)。 修复: - mermaid.ts: loadMermaidBundle 改用动态注入 <script src=/mermaid/mermaid.js> 标签,加载后从 window.MermaidRenderer 取(与 codemirror/lightbox 的 Reflect::get(window,...) 模式一致) - mermaid-renderer/index.ts: 显式 globalThis.MermaidRenderer = mermaid, 避免 vite IIFE 把 export default 编译成 .default 多一层 - markdown.rs: mermaid 代码块跳过 syntect 高亮(无语法定义且会包 <span> 污染 textContent),直接输出转义纯源码 前端 28 测试 + Rust 557 测试 + 双 target 编译通过。	2026-07-16 15:36:07 +08:00
xfy	ac04b23b59	chore(build): make clean 清除 static/ SSR 缓存目录	2026-07-16 15:15:55 +08:00
xfy	f613460742	fix(docker): 修复 DX 下载 case 分支行延续导致的解析失败 ... Dockerfile 的 RUN 指令只在行尾有反斜杠时延续到下一行。 DX 下载步骤的 amd64/arm64 分支把 DX_TRIPLET 和 DX_SHA256 拆成两行, 首行缺少续行符,Docker 把次行 DX_SHA256=... 当成新的顶层指令, 报错 unknown instruction: DX_SHA256=...。 改成与同文件其它 case 块(Node/Tailwind/musl)一致的写法: 每个分支单行、以 ;; 收尾。SHA256 值已对照 GitHub 官方 .sha256 旁挂文件核对一致。	2026-07-16 15:15:12 +08:00
xfy	438a5e1046	fix(ssr): 文章写入后物理删除 SSR 磁盘缓存,根治'重建后内容不更新' ... Dioxus 0.7 增量渲染器把每路由 SSR 结果落盘到 static/<route>/index/<hash>.html, 只暴露 invalidate_after(ttl) 一个失效手段,无按路由失效的公开 API。 之前 bump_global_generation 在 Dioxus 0.7 不生效(ssr_cache.rs 注释已承认), 导致文章重建/编辑后,即便 DB content_html 已是新内容,SSR 缓存仍返回旧页面, 最长滞后 SSR_CACHE_SECS(默认 3600s)。本次 katex/mermaid 渲染不生效即因此。 修复:在 ssr_cache.rs 新增物理删除缓存的函数: - invalidate_ssr_route(route): 删 static/<route>/ (含路径穿越防护) - invalidate_ssr_all_public(): 删 static/ 下除 .well-known/admin 外全部 - invalidate_ssr_home(): 删 static/index/ (细粒度,allow dead_code) 所有写路径(create/update/rebuild/delete/trash)在事务提交后调用: - 单篇操作失效 /post/{slug} + 全量公开页(列表项变化影响首页/归档/标签) - 批量操作直接全量失效 世代号保留作 X-SSR-Generation 可观测性,实际失效靠删文件。 顺带修 katex.rs 的 clippy(field_reassign_with_default)+ cmp_owned。 556 Rust 测试 + clippy -D warnings + 双 target 编译通过。	2026-07-16 15:11:34 +08:00
xfy	09ca480842	chore(docker): 移除 gh-proxy,改用 GitHub 直连下载 dx 与 Tailwind ... Dioxus CLI 与 Tailwind CSS 独立二进制此前经 gh-proxy.com 镜像下载, 现移除 GH_PROXY 前缀及相关注释,直接从 GitHub Releases 拉取。	2026-07-16 14:51:21 +08:00
xfy	78a8d188d1	fix(admin): 重建结果消息改绝对定位,避免撑高容器顶起按钮 ... RebuildCacheBar 原用 flex-col 把「已重建 x 篇文章」消息排在按钮下方, 参与文档流。其祖先 header 为 md:items-end(底边固定),消息出现时 新增高度全部转化为按钮上移,「重建内容/重建全部」被顶起、「发布文章」 相对下沉,三者错位。 改为外层 relative + 消息 absolute top-full 脱离文档流:出现/消失都 不影响按钮行高度,布局稳定。双 target 编译通过。	2026-07-16 14:36:33 +08:00
xfy	f39cb35a31	docs: 补充数学公式与流程图架构说明 ... AGENTS.md 新增 'Math & Diagrams' 章节详述两条渲染路径: - KaTeX 服务端渲染:katex-rs + pulldown-cmark ENABLE_MATH + sanitizer span 白名单 + 自托管 CSS/字体(make katex-css) - mermaid 客户端懒加载:IntersectionObserver + 动态 import 独立 bundle 同步更新:Server-only deps 加 katex-rs、Frontend Lib 表加 mermaid-renderer 行、 Build Artifacts 加 public/{katex,mermaid}、markdown.rs 描述。	2026-07-16 14:24:38 +08:00
xfy	70edc5e46c	feat(frontend): mermaid 流程图懒加载渲染 ... mermaid 无官方 SSR 支持,采用客户端 IntersectionObserver 懒加载:服务端 markdown.rs 只产出普通 <pre><code class="language-mermaid"> 代码块, 前端在块进视口时动态 import 独立 bundle(~1MB)渲染成 SVG。 新增 libs/mermaid-renderer/:mermaid 11.16 IIFE bundle,输出 public/mermaid/ yggdrasil-core/mermaid.ts:扫描 language-mermaid 块,视口可见时动态 import /mermaid/mermaid.js(单例缓存),mermaid.initialize 适配 light/dark 主题, securityLevel=strict;渲染失败加 .mermaid-error class 保留源码;幂等守卫 post-content.ts:initCopyButtons 跳过 language-mermaid 块(图无需 copy) post_content.rs:use_effect 调 __initMermaid('.post-content', theme), 读 use_resolved_theme() 传主题并建立订阅 新增 6 个 mermaid 单测(扫描/主题/幂等/非mermaid/未命中/错误回退)。 550 Rust + 28 前端测试全过,双 target 编译通过。	2026-07-16 14:22:43 +08:00
xfy	218533402b	feat(css): 自托管 KaTeX CSS 与 woff2 字体 ... 服务端 katex-rs 只输出 HTML span,字体/排版靠配套 CSS。从 npm 包 katex 0.16.x 的 dist/ 拷贝 katex.min.css + woff2 字体(省去 woff/ttf)到 public/katex/, CSS 用相对 url(fonts/) 引用故两者须同级。 - libs/package.json: katex ^0.16.22 作 workspace 根 devDependency - Makefile: 新增 katex-css target,接入 build/build-linux/dev;clean 清 public/katex - Dioxus.toml: [web.resource]/[web.resource.dev] style 列表注册 /katex/katex.min.css - .gitignore: public/katex 作构建产物忽略(同 highlight.css 等) make katex-css 验证通过:23KB CSS + 20 个 woff2 字体就位。	2026-07-16 14:15:20 +08:00
xfy	84f6223c68	feat(markdown): 评论支持数学公式渲染 ... - comments/markdown.rs: 开启 ENABLE_MATH,InlineMath/DisplayMath 事件 渲染成 katex HTML 注入事件流(评论不用块级 <p> 包裹,保持紧凑) - sanitizer.rs: 评论路径 span 白名单加 style(KaTeX 内联定位 style 需保留, 与文章正文 sanitizer.rs:382 对齐) - 新增 3 个评论公式测试(内联/块级/style 保留) 双 target 编译通过,24 个评论测试 + 36 个 sanitizer 测试全过。	2026-07-16 14:12:20 +08:00
xfy	95fe9d862d	feat(markdown): 文章支持数学公式 SSR 渲染 ... render_markdown_enhanced 事件循环新增 InlineMath/DisplayMath 分支: - $...$ 内联公式调 katex::render_inline 注入 span - $$...$$ 块级公式用 <p class="math-display"> 包裹 katex 输出 - 标题内公式按内联渲染,不产生块级 <p> pulldown-cmark 的 Options::all() 已含 ENABLE_MATH,无需改 options。 新增 5 个端到端测试(内联/块级/标题内/坏公式不破坏全文)。 双 target 编译通过,16 个 markdown 测试全过。	2026-07-16 14:11:05 +08:00
xfy	891a576dc0	feat(deps): 引入 katex-rs 服务端数学公式渲染 ... 纯 Rust 的 katex-rs 0.2.4 重实现 KaTeX,把 TeX 公式渲染成 HTML span, 供后续 pulldown-cmark 的 InlineMath/DisplayMath 事件调用。 - Cargo.toml: katex-rs 作为 optional dep 经 server feature 启用 - src/api/katex.rs: thread_local 缓存 KatexContext/Settings(因含 RefCell 宏表非 Sync,不能放全局 static);OutputFormat::Html 避开 MathML 标签 使 sanitizer 无需开白名单;throw_on_error=false 防坏公式中断全文 - src/api/mod.rs: #[cfg(feature="server")] 注册 katex 模块 双 target 编译通过(server + wasm32),4 个单测通过。	2026-07-16 14:09:14 +08:00
xfy	1935321da1	build(deps): 升级 TypeScript 至 7.0.2(Go 原生编译器) ... TypeScript 7 已将 Go 重写版(代号 Corsa)合并进主线 typescript 包, npm latest 即 7.0.2,无需再依赖 @typescript/native-preview 预览包。 本项目单点改动:libs/package.json devDependencies.typescript ^6.0.3 -> ^7.0.2 (6 个子包均从 workspace 根继承版本,无需逐包改动)。 兼容性核对(TS 7 破坏性变更 vs tsconfig.base.json): - target ES2020 / module ESNext / moduleResolution bundler 均在支持范围 - 未使用 baseUrl / node10 / es5 等 TS 7 移除的选项 - esModuleInterop=true / strict=true 满足 TS 7 的新下限要求 - css 副作用导入已有 css.d.ts 声明,满足 noUncheckedSideEffectImports 新默认值 验证:typecheck(6 包 tsc --noEmit) + build(6 包 tsc && vite build) + test(187 个 vitest 用例)全部通过。	2026-07-16 13:36:54 +08:00
xfy	debe7dabe3	fix(test): Docker 集成测试在无 daemon 环境优雅跳过而非失败 ... docker.rs 的 4 个 test_run_in_container_* 此前直接 unwrap Docker 客户端， 在没有 Docker daemon 的环境（如 CI、纯服务端交叉编译检查）会 panic 失败， 拖累整套 cargo test 的退出码——即便这些测试本就无法在那里运行。 加 require_docker() 守卫：socket 缺失（DOCKER_CLIENT == None）或 daemon 无响应（轻量 version() 探测）时返回 None，测试 eprintln + 提前 return。 选动态探测而非 #[ignore]：#[ignore] 会在所有环境一律跳过、需 cargo test --ignored 显式触发；探测守卫让测试在有 Docker 时自动运行， 在无 Docker 的 CI 上静默放行，且在 --nocapture 下可见跳过原因。 验证：cargo test --bin yggdrasil 从 535 passed / 4 failed → 539 passed / 0 failed。	2026-07-16 13:22:49 +08:00
xfy	fa8b1d9968	test: 补齐安全关键路径的单元测试盲区 ... 针对前期测试评估发现的高性价比纯函数与安全不变量盲区补测， 共新增 35 个回归测试（全部通过），分布如下： - infra/docker.rs (+5): 扩展 build_host_config 的隔离断言——cap_drop=ALL、 security_opt=no-new-privileges、pids_limit=64、memory_swap==memory（禁 swap）、 tmpfs 的 exec 仅落在 /tmp、ulimits 只保留 nofile（无 nproc）。这些配置若被 误删会让容器隔离悄悄失效，此前 test_host_config_generation 仅断言 cpu/memory。 - api/code_runner/execute.rs (+8): validate_exec_request 此前零测试。覆盖 语言白名单（大小写/空白容忍、多 token 拒绝、未注册拒绝）、源码大小边界 （恰好 max 放行 / max+1 拒绝）、校验顺序（语言优先于大小）。 - api/database/export.rs (+12): is_simple_ident / parse_source 此前零测试。 覆盖表名白名单（SQL 注入 / 路径穿越 / Unicode 拒绝）、query: 来源的只读 AST 校验（INSERT/UPDATE/DELETE/DROP/TRUNCATE/CREATE/ALTER/GRANT 全拦截）。 - api/sanitizer.rs (+10): 补 XSS 攻击向量回归——事件处理器属性（onerror/onload/ onclick + 大小写混淆）、script/style 连内容移除、iframe/object/svg/form 等 危险标签整体移除、javascript:/vbscript: scheme（含 HTML 实体编码绕过）、 data URI 在文章正文路径（allow_data_uri=false）的拒绝、svg data URI 风险点锁定。 顺带记录一个既有可维护性问题：docker.rs 的 4 个 test_run_in_container_* 依赖真实 Docker daemon，无 daemon 环境会失败而非跳过，建议后续加 #[ignore] 或 daemon 探测守卫。本次未改动它们。	2026-07-16 11:55:58 +08:00
xfy	fdf2243299	docs(env): 补全 .env.example 缺失的 5 个环境变量 ... 代码中经 env::var 读取但示例文件遗漏: - EXPOSE_VERSION_HEADERS (main.rs:232, 安全相关, 控制版本暴露响应头) - SYSINFO_SAMPLE_SECS (sysinfo_sampler.rs:46, 后台采样间隔) - CODE_RUNNER_MAX_SOURCE_BYTES (runner_config.rs:67) - CODE_RUNNER_QUEUE_TIMEOUT_SECS (runner_config.rs:79) - CODE_RUNNER_TASK_TTL_SECS (runner_config.rs:83) 默认值与代码一致, 注释风格沿用现有分组(安全段 / tuning 段 / Code Runner 段)。交叉核对确认示例文件无多余项。	2026-07-16 11:42:30 +08:00
xfy	d1c41e8fc5	fix(wasm): hooks 模块移出 server gate，双端可见 ... mod hooks 原被 cfg(feature = "server") 包裹，WASM 前端无法引用 hooks 中的 代码。移出后 server 与 WASM 两端均能访问 hooks 模块。 同步修正 backup.rs 的 import 排序（cargo fmt 自动调整）	2026-07-16 11:37:13 +08:00
xfy	5b6cb7d796	feat(middleware): COMPRESSION_ALGORITHMS 默认值改为 off ... 未设置环境变量时不再默认启用全部压缩算法，改为默认关闭。显式设为 "all" 或具体算法组合仍可按需开启。 - src/middleware.rs: fallback 由 "all" 改为 "off"，同步更新文档注释 与默认值测试（compression_default_env_is_all → _is_off） - .env.example: 示例值与说明同步更新	2026-07-16 11:33:14 +08:00
xfy	593c0322bc	fix(server): 端口被占用时优雅退出而非 panic ... dioxus::server::serve() 内部对 TcpListener::bind 失败直接 unwrap（dioxus-server 0.7.9 launch.rs:143），端口占用会触发 裸 panic + SIGABRT。在迁移完成后、serve() 前先探测同一地址， 失败走统一的 exit(1) 路径并给出可操作的提示（lsof / PORT）。	2026-07-16 11:23:45 +08:00
xfy	c2263e6bf1	chore(lint): 修复 rust-1.97 clippy useless_borrows_in_formatting 告警 ... 新版 clippy 在 format! 参数的冗余 & 上新增 lint(与 mimalloc 改动无关), 移除 export.rs 的 &table_name 以保持 make lint 零告警。	2026-07-16 10:53:59 +08:00
xfy	5b183007a7	perf(server): 用 mimalloc 替换系统全局分配器 ... 多线程高频小对象分配场景下,mimalloc 吞吐显著优于系统 malloc,且对全静态 musl 链接友好(生产 Docker 镜像即 musl 目标)。选 mimalloc 而非 jemalloc: 本项目生产 server 是全静态 musl 二进制,jemalloc 在 musl 上有 pthread_getname_np (musl<1.2.3)/unprefixed-malloc 符号冲突的已知坑。 cfg 双门控(与项目双目标编译约定一致): - feature=server:分配器只服务端二进制需要 - not(wasm32):mimalloc_rust 在 wasm32 上无法编译(Issue #76),前端走默认分配器 mimalloc 声明为 optional + 经 server feature 启用,与 argon2/uuid 等 server-only 依赖同栏位。验证:server native + WASM 双目标编译通过 + clippy 零告警。 musl 目标受本机无 musl-gcc 限制,需 Docker 内构建验证(同 zenwebp 等任何 C 依赖)。	2026-07-16 10:53:51 +08:00
xfy	8c907e4c67	chore(skill): 移除未使用的 writing-great-skills 技能及其 lock 注册	2026-07-16 10:29:06 +08:00
xfy	dc24de0dbb	chore: 更新 skills 配置与术语；新增 rust-advanced-performance 技能；清理 Makefile	2026-07-16 10:27:51 +08:00
xfy	c6cb401522	refactor(admin): 拆分 system.rs 为 system/ 目录（按 tab 分文件） ... pages/admin/system.rs 单文件 1792 行装 5 个 tab（数据库状态/服务器状态/SQL控制台/导出/备份恢复），按已有 api/database/ 的对称模式拆成 system/ 目录。 关键前提（已验证）：5 个 tab 状态完全独立、互不共享，切换时父组件用 key 强制卸载，零跨文件状态耦合。 拆分结构（与 api/database/mod.rs 全路径风格对称）: - system/mod.rs: SystemTab enum + System 入口 + format_bytes(pub(super),3 tab 共用) + tests - system/db_status.rs: DbStatusTab - system/server_status.rs: ServerStatusTab + format_uptime(仅它用) - system/sql_console.rs: SqlConsoleTab(codemirror_bridge 依赖) - system/export.rs: ExportTab + urlencode(wasm32) - system/backup.rs: BackupTab + BackupRow + urlencode_dl(自包含,不再跨文件依赖 export.rs) 路由侧零改动: admin/mod.rs 的 pub mod system + pub use system::System 不变(Rust 自动认 system/mod.rs)。双目标编译 + clippy 严格 + dx check + SystemTab 测试全部通过。	2026-07-15 18:28:39 +08:00
xfy	110be35c54	refactor: 抽 main.rs 中间件到 src/middleware.rs ... main.rs 混合了配置校验、压缩层、cache-control、admin guard、迁移 runtime、后台任务、路由注册,其中 5 个 server-only 中间件/纯函数可独立测试。迁出到新建 src/middleware.rs(#![cfg(feature=server)]):CompressionAlgorithms + parse_compression_algorithms + compression_layer_from_env + cache_control_for_path + add_cache_control + admin_guard,连同 12 个单元测试。main.rs 调用点改为全路径 crate::middleware::xxx。无新 crate、无循环依赖。main.rs 756 -> 382 行,中间件现已可独立测试。	2026-07-15 18:20:56 +08:00
xfy	5a88531543	refactor(api): 收敛 mod.rs 逐行 allow 为文件级 #![allow] ... api/posts/mod.rs(7处) 与 api/comments/mod.rs(3处) 在 pub use 行上方逐行加 #[allow(unused_imports)],而文件顶部已有 #![allow(clippy::unused_unit, deprecated)]。这些 allow 经核实真实必要(消费侧 server fn 多仅在 WASM 路径,SSR 编译时 unused),故收敛为 #![allow(..., unused_imports)] 等价替代,删掉 10 处逐行 attribute。clippy 严格模式 -D warnings 通过。	2026-07-15 18:16:49 +08:00
xfy	5e2365ef7c	docs: 补全 xterm-terminal / shared 库说明并修正 libs 数量 ... AGENTS.md 通篇写 4 个 libs,但实际有 6 个(pnpm workspace): xterm-terminal 已接入(Dioxus.toml + src/xterm_bridge.rs + code_runner/runner.rs),文档未记录; shared 是内部源码共享包(无 public 产物),同样未提。 修正: 各处 4 个 libs 改全部 libs; Frontend Lib Subprojects 表格新增 xterm-terminal 行; 章节导语 Four 改 Five + 注明 shared; Code Runner render layer 补 xterm 终端渲染说明; JS workspace 段补 @yggdrasil/shared 包说明; Makefile build-libs 注释改全部并新增 build-xterm target。	2026-07-15 18:15:47 +08:00
xfy	22d05a98b3	chore(lint): 修复 Biome 告警（schema 版本/optional chain/CSS !important 抑制） ... - biome.json: $schema 2.5.1 → 2.5.3，对齐已安装的 CLI 版本（消除 info） - code-block-view.ts:157: `a && a.b()` → `a?.b()`（等价 optional chain） - style.css:56: 保留刻意的 `transform: none !important`（删除会重新引入 animation-fill-mode: both 导致的堆叠上下文 bug），仅加 scoped biome-ignore 抑制 noImportantStyles，不做全局禁用	2026-07-15 18:12:04 +08:00
xfy	27ed605223	fix(comments): 修复 section.rs / dashboard.rs 括号不匹配导致编译失败 ... 两处同一类错误：match arm 内 `if {} else {}` 表达式后多了一个 `}`， 导致 arm 被提前关闭，触发 "unexpected closing delimiter" 编译错误。 - section.rs:125 — `if !has_any {…}` 块后多余的 `}`，删除使 if-else 合一 - dashboard.rs:119 — 同类问题，另需补 `;` 终止 `let` 语句	2026-07-15 18:12:00 +08:00
xfy	bdc9f0f711	chore(make): fix 目标新增 cargo fmt 与 dx fmt ... 自动修复流程此前只跑 biome format + cargo fix，缺少格式化收尾： cargo fix 应用编译器建议会重写代码，dx fmt 会改写 rsx!， 两者都可能留下不符合 rustfmt 风格的输出。 现在按 Biome → cargo fix → cargo fmt → dx fmt 顺序执行， 两道格式化收尾保证最终文件状态整洁。	2026-07-15 17:50:00 +08:00
xfy	886eeca915	style: 全项目 rsx! 格式规范化（cargo fmt）	2026-07-15 17:49:03 +08:00
xfy	cbb8be7441	feat(make): 新增 docker-amd64 与 docker-apple 目标构建 x86_64 镜像 ... docker target 只出当前宿主架构(Apple Silicon 上为 arm64),无法直接得到 x86 镜像;docker-multiarch 虽支持 amd64 但强制 --push 到 registry,无法本地 验证。补两个本地可用的 x86_64 构建 target: - docker-amd64:docker buildx --platform linux/amd64 --load,走 QEMU 交叉仿真, 产物进 Docker 本地 daemon,可直接 docker run / docker save。 - docker-apple:Apple Container CLI(macos 26 Tahoe)原生构建,无需 Docker Desktop, 用 --arch(非 --platform)。 Dockerfile 本身按 dpkg --print-architecture 自适应选 musl target,无需修改。	2026-07-15 17:36:57 +08:00
xfy	832b7c626d	fix(infra): Docker daemon 不可用时不再 panic ... DOCKER_CLIENT 是 LazyLock<Docker>，socket 缺失时 .expect() 直接 panic； 而 release profile 是 panic="abort"，会让整个服务进程挂掉——但博客本身并不依赖 Docker。 改为 LazyLock<Option<Docker>>：连接失败记 error 日志后存 None。 新增 get_docker() 在 None 时返回 IOError(NotFound)，run_in_container / run_in_container_stream 通过 ? 向上冒泡，最终在 execute.rs 的错误脱敏层映射为 「系统暂时不可用」，其余功能不受影响。	2026-07-15 17:23:56 +08:00
xfy	65a7b1226f	style: 全项目格式规范化（cargo fmt）+ Docker daemon 断连容错 ... - 全项目 .rs 统一 cargo fmt 排版（换行/缩进/参数分行/导入排序） - infra/docker: DOCKER_CLIENT 连接失败不 panic，降级返回 None （博客不依赖 Docker，panic=abort 下会导致整个进程崩溃） - infra/mod: 去除多余空行 - database/mod: 模块声明按字母序重新排序	2026-07-15 17:22:06 +08:00
xfy	71f3351c99	feat(server): 通过响应头主动暴露版本与 git 描述信息 ... 新增 version_headers_middleware,为所有响应附加三个头: - Server: yggdrasil/<version>(遵循 product/version 习惯) - X-Yggdrasil-Version: Cargo 版本号 - X-Yggdrasil-Git: git describe(版本+提交数+短hash+脏标记) 数据源复用 build_info::BUILD_INFO,与启动日志 log_build_info() 同源, 零新依赖。 关键设计:中间件挂在最终合并 router 的最外层(Ok(router) 前),因此 /healthz、/uploads/*、被 CSRF 拒(403)/超时/admin_guard 重定向的响应 都会带头,探测价值最大。此前 app_routes 的中间件栈只覆盖 Dioxus 路由, 无法覆盖这些端点。 受 EXPOSE_VERSION_HEADERS 控制,默认 true;设 0/false/no 关闭。 bool 解析沿用 COOKIE_SECURE 的 matches!("1"/"true"/"yes") 约定, 此处取反为"非 false 值即开"使默认行为对应「暴露」。启动时记录一条 info 日志便于确认生效值。	2026-07-15 17:12:55 +08:00
xfy	a3ca08f3f6	chore(docker): 完善 .dockerignore 规则 ... 原 .dockerignore 仅覆盖 target/.git/node_modules 与部分 public 产物, 遗漏多个会导致上下文膨胀或信息泄露的路径: - 修复信息泄露: .env(含真实 DATABASE_URL)此前会进入构建上下文 - 新增未忽略的构建产物: public/xterm/、public/doc/ - 排除机器本地/无关目录: others/(55M 引用博客)、.freebsd-sysroot/、 docker/(runner 镜像源,单独构建)、docs/、tests/、scripts/ - 排除 agent/IDE/CI 工具: .zcode/、.superpowers/、.agents/、.gitea/、 .vscode/、.idea/、rust-analyzer.toml 等 - 补充常见本地文件: .DS_Store、*.swp、profile.json.gz、compose*.yaml 保留所有真实构建输入(Cargo.toml、build.rs、Dioxus.toml、input.css、 .cargo/config.toml、src/、migrations/、libs/ 工作区、themes/、syntaxes/ 及 public 运行时资源 favicon.ico/icons/images/),已逐一核对。	2026-07-15 15:18:13 +08:00
xfy	62d06fb35d	chore(skill): 清理已卸载的第三方 skills 及其 lock 注册	2026-07-15 14:32:04 +08:00
xfy	875dc39b61	chore(skill): 补全 skills-lock.json 注册并格式化 SKILL.md 表格	2026-07-15 14:21:20 +08:00
xfy	2d5c7f3d2a	style(main): 修复缩进格式与模块/导入排序	2026-07-15 13:56:43 +08:00
xfy	acfdfb03f5	fix(image): 为 ImageFmt 别名补上 #[cfg(feature = "server")] 门控 ... type ImageFmt = image::ImageFormat 未加 server feature 门控， 而 image crate 是 server-only 可选依赖。WASM 构建 (web feature) 解析到该别名时找不到 image crate，报 E0433。 detect_format (唯一使用方) 已有 #[cfg(feature = "server")]， 测试也在 #[cfg(all(test, feature = "server"))] 下，别名只需对齐门控。	2026-07-15 13:30:38 +08:00
xfy	8efd8c8021	perf(image): cache_key 单次拼接 + detect_format 零分配后缀匹配 ... cache_key：旧实现 vec![path.to_string()] + 最多 6 个 format! + join， 最坏 9 次堆分配（path clone + 6 个参数 String + Vec 指针数组 + join String）。 改用 with_capacity + write! 直写，1 次分配。每次未命中缓存的图片请求都走。 detect_format：旧实现对整条路径 to_lowercase() 分配 String，只为查后缀。 改用 rsplit('.').next() 取后缀 + eq_ignore_ascii_case 零分配匹配。 每次图片请求调用 1-2 次。 注：rotate 在 resize 之前是刻意设计（让 w/h 作用于旋转后的最终方向）， 不动以保持 URL 语义与缓存一致性。	2026-07-15 11:48:59 +08:00
xfy	b269fcf205	perf(posts): list/search 零 capacity Vec 改 collect 预分配 + helpers retain ... list.rs 5 处、search.rs 1 处用 Vec::new()+循环 push，初始 capacity 为 0， 循环触发多次指数 realloc。rows.iter().map().collect() 用 slice 迭代器的 精确 size_hint 一次性预分配。首页/列表/搜索/标签分页路径。 helpers.rs row_to_post_list_item / row_to_post_full：tags 从 into_iter().filter().collect() 改 retain 原地过滤。unwrap_or_default() 已返回 owned Vec，旧写法重建第二个 Vec。每行文章记录省一次 Vec 分配。 顺带修 slugify 一个 dead store（prev_dash=false 后被 true 无条件覆盖）。	2026-07-15 11:46:56 +08:00
xfy	a41a1d3ae1	perf(markdown): 消除双解析 + format! 改 write! 直写 ... 双解析：旧实现对同一份 md 调两次 Parser::new_ext（一遍收集标题、 一遍生成 HTML），等于两倍的 tokenize + 解析 CPU。现 collect 成 Vec<Event> 一次，两遍遍历复用（Event 内含 CowStr 借用 md 切片， collect 后仍可重复借用）。解析 CPU 减半。 format! → write!：标题开始/结束、TOC li、runnable pre、language class 共 5 处在循环内用 format! 拼接 HTML 片段，每次先分配临时 String 再 push_str 复制进去、临时串立即丢弃。改用 write!(html, ...) 直写目标 String，零中间分配。N 个标题省约 3N 次临时分配。 顺带：html 与 toc_html 用 with_capacity 预分配（旧 String::new 多次 realloc）。 全部 68 个 markdown 测试通过。	2026-07-15 11:41:55 +08:00
xfy	d4f8b463d2	perf(slug): slugify 单遍状态机重写，分配 4→1 ... 旧实现 4 次堆分配、3 遍扫描： 1. title.to_lowercase() 分配整串 String（中文/符号根本不受影响却全量拷） 2. split('-').filter().collect::<Vec<&str>>() 分配 Vec 3. parts.join('-') 再分配 String 4. slug.chars().take(100).collect() 截断又分配 新实现用 prev_dash 状态机在单遍内完成：拼音成词、ASCII 小写化、 分隔符合并去首尾、按 char 截断到 100。1 次预分配、1 遍扫描。 与同仓库 markdown.rs::slugify_heading 的单遍写法对齐。 全部 27 个 slug 测试通过（含拼音边界、连续 dash、首尾 dash、下划线保留）。	2026-07-15 11:38:54 +08:00
xfy	b34f44d3e7	perf(html): escape_html 链式 5 次 replace 改单遍扫描 ... 旧实现链式 5 次 str::replace，每次全量扫描 + 分配新 String， 5 个特殊字符 = 5 次堆分配 + 5 遍全文扫描，中间 4 个 String 立即丢弃。 新实现：先按字节快速检测是否含特殊字符（纯文本直接 clone 返回）， 否则单遍 match 扫描 + 单次 with_capacity 分配。 分配 5→1（-80%），扫描 5→1。该函数被 markdown 渲染管线密集调用 （每个标题文本、每个 runnable 代码块的 overrides/source 转义）。	2026-07-15 11:32:36 +08:00
xfy	604febde98	perf(upload): 消除 data.to_vec() 多次全文件深拷贝 ... data 是引用计数的 Bytes，clone 廉价（原子 +1）。 - validate 路径：data.to_vec() → data.clone()，省一次全文件拷贝 - 转码闭包：original_data = data.to_vec() → data.clone()， 仅在「保留原格式」回退分支才 to_vec() 出落盘所需 Vec<u8> - 路径拼接：用 chrono DelayedFormat 内联，省 year/month/day 三个中间 String 5MB 图片上传：转码成功路径从 10MB 堆分配降到 0（仅 Bytes 引用计数）； 回退路径从 10MB 降到 5MB。	2026-07-15 11:28:21 +08:00
xfy	0835811487	style(header): 调整 nav 高度 80px → 64px (h-16)	2026-07-15 11:03:27 +08:00