xfy/yggdrasil
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
888 Commits 1 Branch 8 Tags
Commit Graph

603 Commits

Author SHA1 Message Date
xfy
acfddb3e17 style(admin/write): overhaul write page to modern minimalist layout 2026-07-03 16:44:39 +08:00
xfy
d3a50728ed style(admin): overhaul layout to modern minimalist sidebar design 2026-07-03 15:50:59 +08:00
xfy
38ba6692d3 style(admin): redesign admin UI with soft rounded corners and Catppuccin theme 2026-07-03 15:46:18 +08:00
xfy
9f69a132fa refactor(admin): redesign write page for industrial aesthetic 2026-07-03 15:37:41 +08:00
xfy
cad0e3d83b fix(admin): restrict write page width to match other pages 2026-07-03 15:35:06 +08:00
xfy
d1041a84dd feat(admin): complete redesign of backend ui with industrial minimalist aesthetic 2026-07-03 15:32:02 +08:00
xfy
45f4e9cde0 refactor(ui): 去除 Rust 中硬编码颜色，统一语义色阶 
跟随 Catppuccin 配色迁移，清理 src/ 中绕过 paper-* 语义 token 的
硬编码 dark:[#hex] 任意值，改用 Tailwind 默认灰阶（gray-700/800），
它们随主题切换自然适配。

- post.rs 状态徽章：dark:bg-[#333]/dark:text-[#9b9c9d] → gray-800/gray-400/500
  （同步更新测试断言）
- comments/* 与 skeletons/* 的 dark:[#2a2a2a]/[#2e2e33]/[#333]/[#5a5a62]
  → 对应 gray-600/700/800
- trash.rs 状态灯发光圈 rgba 由旧鼠尾草绿(92,122,94) 改 Latte green(64,160,43)
- ui.rs BTN_SECONDARY 注释更新为新 Teal 强调色值

注：src/pages/admin/posts.rs 的 clippy redundant_closure 报错为既有问题，
与本次配色迁移无关，不在范围内。
 2026-07-03 14:25:40 +08:00
xfy
cb77d28a68 fix(theme): 跟随系统切换改为瞬切，放弃 VT 动画 
诊断确认：跟随系统与手动点击的 VT 流程在 JS/CSS 层完全等价（animationName、
--tt-r、bg 翻转、clip-path 全部正确），但视觉上跟随系统场景下圆形展开动画
不显示，仅瞬切。系统偏好变化是后台事件，VT 在此上下文下动画不可靠。

改用设置语义的瞬切：JS 侧新增 applyResolvedTheme(isDark) 入口（非翻转语义，
直接 add/remove dark class），Rust effect 改调 __applyResolvedTheme 传实际
明暗值，移除圆心计算逻辑。职责清晰：
- 手动点击 → __startThemeTransition → VT 圆形展开（用户手势，动画可靠）
- 跟随系统 → __applyResolvedTheme → 瞬切（后台同步语义）
 2026-07-03 13:42:17 +08:00
xfy
eb3087edf4 fix(theme): 跟随系统切换用主题按钮位置作为 VT 圆心 
诊断发现跟随系统与手动点击的 JS 路径完全一致（__startViewTransition 全程
正常，无降级、无 reject），「看起来像淡入淡出」实为圆形展开动画在屏幕中心
圆心下的必然视觉效果：从中心向四周等距扩散，各方向同步推进，近似整体覆盖，
与手动点击（按钮在右上角，圆弧明显横扫）观感差异大。

改用 .theme-toggle 按钮的 getBoundingClientRect() 中心作为 VT 圆心，与手动
点击的动画起点一致；按钮不在 DOM 时回退到视口中心。同步更新注释说明。
 2026-07-03 13:26:40 +08:00
xfy
188fc464e2 fix(theme): System 模式下系统偏好变化时同步 dark class 
原实现存在缺口：<html> 的 dark class 运行时写入点只有「首屏预加载脚本」与
「手动点击 ThemeToggle」两处，System 模式下系统颜色偏好自动变化时无人同步——
尽管 system_dark signal 与 resolved memo 都会更新，下游（CodeMirror 等）也
能跟随，但页面配色纹丝不动，与文件头注释承诺的「实时同步 .dark class」不符。

新增 use_effect 兜底：仅 System 模式下 resolved 实际翻转时，以视口中心为圆心
复用 __startThemeTransition 触发 VT 圆形展开动画。Light/Dark 显式模式由
ThemeToggle::onclick 全权负责，effect 不介入，避免重复触发；首次挂载通过
prev_resolved 信号记录基线，自然跳过（DOM 已由 ThemePreload 设好）。
 2026-07-03 11:35:10 +08:00
xfy
c79c390482 fix(ui): ADMIN_TABLE_CLASS 去掉 overflow-hidden，修复 tooltip 被裁 
overflow-hidden 用于圆角裁剪表格，但会硬裁掉行内按钮的 tooltip
（无论朝上朝下）。去掉后：表格行 hover 背景 (bg-paper-entry) 与
容器背景同色，圆角处无视觉差异，tooltip 可正常溢出表格边界。
全局生效，所有 admin 表格的 tooltip 不再被裁。
 2026-07-03 11:15:48 +08:00
xfy
64ad40ca61 fix(admin/posts): Tooltip 包裹后操作按钮恢复垂直居中 
- Tooltip 外层 div 由块级改为 inline-flex，作为行内伸缩盒参与
  flex 行对齐，不再撑高或破坏基线
- 操作列容器补 items-center，显式锁定所有子项垂直居中
 2026-07-03 11:08:04 +08:00
xfy
73b9cad550 refactor(ui): 抽取 Tooltip 组件，行内重建按钮补 tooltip 
新增可复用 Tooltip 组件（group-hover 显现，支持 top/bottom 朝向），
消除顶部重建按钮手写的内联 tooltip div 重复，并为表格行内重建
按钮补上 tooltip（朝上，避免被表格容器的 overflow-hidden 裁掉）。
 2026-07-03 11:03:56 +08:00
xfy
b6fe0ae082 style(admin/posts): 删除按钮 loading 用 spinner 覆盖文字 
- 删除改为非乐观：点击后保留行并显示 loading，服务端成功才移除行、
  失败保留行并弹提示（顺带修掉原先「删除失败行却没了」的隐患）
- deleting 信号由 Option<i32> 改为 HashSet<i32>，支持并发删除
- 删除按钮 loading 样式与重建一致：文案恒为「删除」，spinner
  居中覆盖、文字 opacity-40 衬底
 2026-07-03 10:51:16 +08:00
xfy
1530d3a2f4 style(admin/posts): 顶部重建按钮 loading 用 spinner 覆盖文字 
工具条「重建内容」「重建全部」按钮 loading 时由「重建中...」文案
改为 spinner 居中覆盖、文字 opacity-40 衬底，与行内重建按钮的
loading 样式统一。
 2026-07-03 10:46:57 +08:00
xfy
db87d3c886 fix(admin/posts): 重建支持并发 loading，spinner 覆盖文字 
- rebuilding 信号由 Option<i32> 改为 HashSet<i32>，连续点击多篇
  文章的重建按钮可同时处于 loading 态（单值会被后点的覆盖）
- loading 样式调整：按钮文案恒为「重建」，spinner 绝对定位覆盖在
  文字上方居中，文字 opacity 调至 40% 衬底，不再切换文案
 2026-07-03 10:40:11 +08:00
xfy
a5c00caa80 style(admin/posts): 操作列加宽横排，重建按钮 loading 用 spinner 图标 
- 操作列宽 w-24 → w-44，三个按钮一行排开不换行
- 重建按钮 loading 态由「重建中...」文案改为 spinner 图标 + 「重建中」
- spinner 复用 public/icons/90-ring-with-gradient.svg，作为 SPINNER_SVG
  常量收入 ui.rs（修正原 SVG 损坏的孤立 ':' 选择器，重命名 id/类名
  避免多处内联时冲突），用 currentColor 继承按钮文字色
 2026-07-03 10:26:14 +08:00
xfy
e55f2e12bd refactor(admin/posts): 重建按钮文案改「重建」并去掉完成弹窗 
按钮态文案与原有一致（「重建中...」）；on_rebuild 改为静默执行，
仅按行切换 rebuilding 按钮态，完成后不再弹浏览器 alert。
 2026-07-03 10:16:13 +08:00
xfy
0fe0387ea3 feat(admin/posts): 文章列表操作列新增「重建内容」按钮 
新增 rebuild_post_content_html(post_id) server function，从 DB 读取
content_md（事务内 FOR UPDATE 锁行）重新渲染 content_html/toc_html
并更新 word_count/reading_time，按影响范围精准失效列表、slug 单篇
与搜索缓存。

PostRow 操作列在「编辑」「删除」之间插入「重建内容」按钮（鼠尾草绿
文字样式），按行禁用并切换「重建中...」文案，成功/失败弹出浏览器
提示，与删除按钮的反馈模式一致。

为避免与单篇 rebuilding 信号冲突，将原批量重建工具条信号 renaming
为 batch_rebuilding。
 2026-07-03 10:13:15 +08:00
xfy
edee09596c test(api/markdown): 解耦 wrap_images_with_blur 并脱离文件系统依赖 
把 wrap_images_with_blur 拆成两部分:
- wrap_images_with_blur_with(html, dims_fn):纯函数核心,接受 dimensions
  查询闭包,不碰文件系统
- wrap_images_with_blur(html):薄包装,注入真实 get_image_dimensions

测试改用纯函数核心,注入确定性 dimensions(如 Some((800,600)) 或 None),
彻底脱离 uploads/ 真实文件依赖。此前的 aspect-ratio 测试硬编码了
/uploads/2026/06/18/...webp 真实路径——文件不存在则静默走缺省分支,
断言虽能过但实际验证内容被削弱。

新增覆盖(共 8 个 wrap 相关测试):
- --ar 缺省/有值两种路径
- rel_path 去查询的验证(用 RefCell 捕获 Fn 闭包入参)
- alt 保留(双层)/空 alt 不生成属性
- 斜杠分隔的 --ar 格式 + sanitizer 管线不破坏斜杠
 2026-07-02 17:39:15 +08:00
xfy
ab05c01f76 test(api/database): 备份恢复补单测 + 修复 backup_path 路径穿越漏洞 
backup.rs 是恢复流程的安全关键路径,此前无任何单测。本次:

提取纯函数(便于单测,无行为变更):
- is_valid_backup_filename:文件名白名单校验,替换三处内联 Regex
- parse_backup_mode:从 -- mode: 行提取模式值
- has_valid_signature:首行签名头校验

新增 15 个单测,覆盖:
- 文件名白名单(正常/路径穿越/特殊字符三类边界)
- backup_path 路径穿越纵深防御
- 签名校验(精确/前导空白/非系统文件/空内容)
- 模式解析(pg_dump/sql-fallback/缺失/空值/多次)

修复一个真实的路径穿越漏洞(测试驱动发现):
backup_path("/etc/passwd") 之前返回 /etc/passwd 而非 backups/——
因为 [BACKUP_DIR, filename].collect::<PathBuf>() 在 filename 为绝对
路径时会丢弃 BACKUP_DIR 前缀(PathBuf 语义),随后的 components 检查
在错位的路径上运行而漏判。改为先校验 filename 自身的 components
(只允许 Normal 段),从根上杜绝穿越。

注:第一道白名单 is_valid_backup_filename 已拒绝含 / 的文件名,
故该漏洞实际不可达;但纵深防御必须健壮,本修复使其名副其实。
 2026-07-02 17:37:07 +08:00
xfy
533cabb0b5 test(api/database): SQL 控制台护栏补表驱动单测 + 加固 
sql_console.rs 是 SQL 控制台的安全关键路径,此前无任何单测。本次:

测试(新增 24 个,覆盖护栏 1+2 全分支):
- check_guards: DROP SCHEMA/CREATE DATABASE 绝禁、DROP/TRUNCATE/ALTER
  需确认、UPDATE/DELETE 无 WHERE 绝禁(且 confirm 不能救)、多语句短路
- is_absolutely_forbidden: 大小写不敏感、误拦检查、报错名
- statement_type_name / is_read_only: AST 变体映射
- 两条安全不变量测试(见下)

加固(测试驱动发现的两个真实缺口):
1. 字符串预检 contains() 改为 token 序列匹配 is_absolutely_forbidden()——
   防多空格/制表符/换行绕过 DROP/CREATE DATABASE。
2. check_guards 补 Statement::CreateDatabase 绝禁分支——此前 sqlparser
   能解析 CREATE DATABASE(可绕过字符串预检进 AST),但 AST 层无对应分支,
   字符串预检是其唯一防线。现在双重拦截。

并锁定两条安全不变量,防止 sqlparser 升级时悄悄回退:
- DROP DATABASE 不可解析 → 字符串预检是唯一防线
- CREATE DATABASE 可解析 → 双重防线都生效
 2026-07-02 17:33:19 +08:00
xfy
65b15509a7 chore(wasm): 清理 wasm32 target 下残留的 clippy lint 
这些 lint 在 server build(默认 --all-features)下被 cfg 剥离故未暴露,
仅 wasm32 web-only target 触发。逐项清理:

- footer.rs: 两处 redundant closure(web_sys::window 直接传函数引用、
  sync_visible 直接传闭包)+ let _ = unit 绑定(scroll_to_*)。
- hooks/event_listener.rs: 复杂类型 Rc<RefCell<Option<(Closure,T)>>>
  抽 type ListenerState<T> 别名。
- system.rs: 两处单模式 match { Ok=>.., _=>{} } 改 if let。
- write.rs: split(|c| matches!(c,...)) 改 split([char; N]) 数组模式。
- codemirror_bridge.rs: let _ = instance.destroy() 删 unit 绑定,
  与 tiptap_bridge.rs 同处写法对齐。

wasm32 与 server 两 target clippy -D warnings 均通过。
 2026-07-02 17:15:27 +08:00
xfy
fee5b7ba94 refactor(wasm): 消除 DOM 互操作中的 js_sys::eval 字符串求值 
对照 Dioxus "Breaking Out" 文档审查后,将 3 处 js_sys::eval 改为
类型化调用,与 tiptap_bridge/codemirror_bridge 风格统一:

- utils/time.rs sleep_ms:eval("new Promise(r=>setTimeout(r,n))")
  改为 js_sys::Promise + web_sys::Window::set_timeout_*,复用项目内
  system.rs::wasm_sleep 同款写法。
- theme.rs 主题切换:format!-into-eval 拼 __startThemeTransition(x,y)
  改为 Reflect::get 取函数 + Function::call2,消除字符串注入面
  (原坐标虽为 f64 无实际风险,但属不必要 eval)。
- post_content.rs:__initPostContent / __initLightbox 两处 eval 字面量
  改为 invoke_optional_global 辅助函数(Reflect::get + Function::apply),
  消除旧版 "eval 字符串粘贴" 模式;__lightboxSelectors 直接复用 JsValue
  传入,省去一次回读。
 2026-07-02 17:15:18 +08:00
xfy
ba5b146dfa fix(theme): 消除 detect_initial_theme 的 unreachable_code 警告 
wasm 分支末尾的 return Theme::System 在 wasm target 下让尾部兜底
Theme::System 不可达（unreachable_code 警告）。把尾部兜底用
#[cfg(not(target_arch = "wasm32"))] 限定，使其只在 server 分支
（cookie 未命中）或边角构建时编译，wasm target 下函数以 wasm
分支的 return 自然结束，两端都零警告。
 2026-07-02 16:49:31 +08:00
xfy
2b6b2ca9e4 fix(hooks): 修复 wasm32 target 编译失败 
之前验证只跑了 server target（cargo build --all-features），漏掉 wasm32
前端 target，导致三类错误未被捕获：

1. event_listener.rs wasm 分支缺 use dioxus::prelude::*：
   use_hook/use_effect/use_drop 来自 prelude，之前重写时误删。补回。

2. event_listener.rs use_effect 闭包 move 冲突（E0507/E0310）：
   use_effect 回调是 FnMut，但 acquire 是 FnOnce、handler 要 move 进事件
   闭包。用 Option::take 模式包裹，首次运行消费，避免重复 move。同时给
   A 加上 'static 约束。

3. query.rs items/total/footer.rs sync_visible 缺 mut：
   wasm 分支的 .set() 调用需要 mut 绑定。之前为消 server target 的
   unused_mut 警告误删，改用 cfg_attr 在非 wasm 时压制警告。

教训：fullstack 项目必须同时验证 wasm32 与 server 两个 target，单一
target 通过不代表整体可用。
 2026-07-02 16:43:15 +08:00
xfy
291189fb77 fix(sanitizer): 折叠嵌套 if 修复 clippy::collapsible_if 
865871f 引入的 checkbox type 白名单逻辑用了嵌套 if，触发 rust 1.96
的 clippy::collapsible_if，导致 make clippy 直接失败。按 clippy 建议
合并为单个 if 链，行为不变。
 2026-07-02 16:36:05 +08:00
xfy
59359b18ce refactor(hooks): 新增 use_paginated 并迁移 posts/trash 分页加载 
按 Dioxus 0.7 custom hooks 范式，把后台分页列表页反复出现的
use_effect + spawn + (loading/items/total/error) 三件套收口到
use_paginated 组合式 hook。统一非 wasm cfg 处理（SSR 不发请求、
loading 立即置 false），调用方只关心 fetch 闭包与页码依赖。

迁移范围（按降级预案，只做最规整的两处）：
- pages/admin/posts.rs：顺手补 error signal（原先吞掉 Err），向
  trash 看齐，消除一致性债。
- pages/admin/trash.rs：直接替换，error 已有。

保留手写的形态（强行套 hook 反而更复杂）：
- comments.rs：依赖 (page, status) 双 signal，status 是额外维度，
  套不进 (page, per_page) 模型；改 hook 会为单一调用点变复杂。
- system.rs 三个 tab：load_once + use_future 轮询形态，与 hook 的
  单次加载模型不契合。
- dashboard.rs：多源聚合（3 个并发 spawn 分别 set 不同 signal）。

list_posts / list_deleted_posts 是 server function，两端都生成
（wasm 端 client stub、server 端真实实现），故去掉原 cfg import。
 2026-07-02 16:30:47 +08:00
xfy
759bbab7ee refactor(utils): comment_storage 从 hooks/ 迁至 utils/ 
该文件全是普通函数（save_author / load_pending_comments 等），没有任何
use_ 开头的 Hook，放在 hooks/ 下名不副实。内部只剩结构体与 localStorage
读写（时间/HTML 工具已在上一 commit 拆出），迁到 utils/ 后文件名与内容
自洽，hooks/ 目录回归只放真正的渲染期 Hook。

机械替换 4 个组件文件的 use 路径（hooks::comment_storage → utils::comment_storage）。
 2026-07-02 16:18:52 +08:00
xfy
dcdd72a8c2 refactor(utils): 拆分 comment_storage 的时间/HTML 工具函数 
消除 server 端对 hooks 模块的跨层引用：

- escape_html（+ 两份重复实现：comment_storage 用 &#39;、helpers 用 &#x27;）
  统一到 utils/html.rs，单引号采用 HTML5 标准 &#x27;。
- now_millis / relative_label_from_millis / format_relative_time_iso 及其
  单元测试迁到 utils/time.rs，与既有 sleep_ms 同构（wasm32/非 wasm 双版本）。

调用方迁移：
- api/comments/helpers.rs：删掉本地 escape_html，format_relative_time 改引
  utils::time；其 escape_html 测试随之删除（utils/html.rs 已覆盖）。
- api/comments/create.rs：两处 helpers::escape_html 改 utils::html。
- api/markdown.rs：escape_heading_text 改 utils::html。
- components/comments/pending_item.rs：format_relative_time_iso 改从
  utils::time 引入；render_pending_content 留在 comment_storage（语义紧贴
  待审核评论）。
- hooks/comment_storage.rs：is_expired 的 now_millis 改引 utils::time。

comment_storage.rs 现在只剩结构体与 localStorage 读写，文件名即将自洽。
 2026-07-02 16:15:23 +08:00
xfy
f00c2bf963 refactor(hooks): 新增 use_event_listener 通用事件监听 hook 
把 theme.rs 与 footer.rs 两处手写的 "use_hook 持有 Closure+target、
use_effect 注册 add_event_listener、use_drop 移除" 样板收口到一个
通用 hook，按 Dioxus 0.7 custom hooks 范式封装。

hook 设计：
- target 通过 acquire 闭包在 use_effect 首次运行时获取（此时 DOM 一定
  可用），调用方无需再自己包 use_effect。
- 泛型 AsRef<EventTarget> 统一 Window / Element / MediaQueryList。
- 非 wasm32 整体编译为 noop，调用方用 #[cfg] 隔离 web_sys 调用即可。

footer 的 "注册后首次同步" 业务逻辑保留在 hook 之外（语义不属于
事件监听）。theme 的 handler 改为重新 match_media 读取 matches，
功能等价（低频事件，开销可忽略）。
 2026-07-02 16:02:51 +08:00
xfy
62bd281684 fix(admin/posts): 重建结果消息改为独立行，修复悬浮溢出表格的错位 
RebuildCacheBar 的「已重建 X 篇文章」结果消息原用 absolute top-full mt-2
悬挂在按钮行下方，但 mt-2(8px) + text-sm(20px) = 28px 大于外层 space-y-6
的 24px 间距，消息底边向下溢出 4px 侵入表格容器上沿；横向 left-0 又使消息
落在右上角按钮组正下方、覆盖状态/日期/操作列，语义位置错位。

将 rebuilding / rebuild_result 状态上提到 PostsPage：
- 结果消息在 header 与表格之间独立成行，进入文档流，吃 space-y-6 正常间距，
  既不撑高 header 触发 items-center 重排（曾用 absolute 规避的旧问题），
  也不脱离流溢进表格（absolute 引入的新问题）。
- RebuildCacheBar 改为接收父级 Signal props，只渲染按钮行本身。
 2026-07-02 14:19:06 +08:00
xfy
865871f45c fix(markdown): 修复任务列表 checkbox 在前台被 sanitizer 剥离 
编辑器端已挂 TaskList/TaskItem,但前台渲染走 pulldown-cmark,其输出的
<input type="checkbox"> 不在 sanitizer 白名单内,被 remove_and_keep_content
剥离,导致任务列表在前台只剩裸 <li> 文本。

- sanitizer: 白名单放开 input,但强制 type="checkbox" 属性值校验
  - attrs_to_remove 增加 input.type 值校验,非 checkbox 一律删除属性
  - element_handler 末尾兜底:缺 type 或非 checkbox 的 input 整标签移除
    (void 元素无内容,remove() 不丢正文,封堵 type=image/text 等 XSS 滥用)
- 仅 clean_html 放开,clean_comment_html 保持不放开(评论无需任务列表)
- input.css 补 .md-content 任务列表样式(pulldown-cmark 裸 li>input 结构,
  用 :has() 识别,不支持 :has() 的浏览器降级为普通列表仍可读)
- 新增 sanitizer 5 个测试(白名单/XSS 边界)+ markdown 1 个端到端测试
 2026-07-02 13:22:37 +08:00
xfy
a10003c90d feat(theme): 切换按钮点击立即换图标并播放进入动画 
将 theme.set 从 450ms 延迟改为立即执行——图标在点击瞬间切换，不再
等待圆形 VT 动画结束。原作者担心重渲染打断 VT 实属多余：VT 伪元素
快照在 __startThemeTransition 内已同步拍好，后续真实 DOM 变化不影响。

- 移除 click_gen 防抖机制与 spawn_local 延迟回调（不再需要）。
- SVG 加 key 属性，theme 变化时 Dioxus 重新挂载 SVG，触发 CSS 进入动画。
- input.css 新增 @keyframes theme-icon-enter（缩放 0.5→1 + 旋转 -60°→0°
  + 淡入，0.3s ease-out），仅在 .theme-toggle svg 上生效。
- prefers-reduced-motion 下禁用该动画，遵循项目既有约定。
 2026-07-02 12:00:00 +08:00
xfy
9a4e6c3e6e docs(agents): 校正构建/测试/迁移说明，对齐当前代码库 
- 移除不存在的 ./migrate.sh：迁移实际由 src/db/migrate.rs 在启动期自动运行，
  目标库由 db/pool.rs::ensure_database_exists 自举创建；补充新增迁移需在
  MIGRATIONS 数组登记（编译期校验磁盘与数组一致）
- npm → pnpm：4 个 libs 均使用 pnpm-lock.yaml，Makefile 全程 pnpm
- make test / make build 覆盖 4 个 libs（补充 codemirror-editor）
- 补充 restore-webp 兜底步骤的成因（dx 0.7.9 重编码 .webp）
- 补全 make clippy（-D warnings）、make fix、make clean 真实行为
- 模块树补齐 context/router/ssr_cache/sysinfo_sampler 及 *_bridge
- 4 个前端子项目合并为对比表，保留 wasm-bindgen 接线等关键细节
- 保留 Workflow 提交规范
 2026-07-02 11:40:47 +08:00
xfy
eacc79ed83 feat(theme): 新增跟随系统主题模式与三态循环切换 
Theme 枚举从 {Light, Dark} 扩展为 {Light, Dark, System}，新增
ResolvedTheme 表示实际生效明暗。

- System 模式移除 localStorage 持久化，首屏防闪烁脚本因此自动回退到
  prefers-color-scheme 分支，首屏零闪烁。
- use_theme_provider 提供 Theme + ResolvedTheme 双 context；resolved 是
  theme 与 system_dark 的派生 memo。WASM 端注册 matchMedia change 监听，
  系统偏好变化时实时同步 .dark class 与下游（CodeMirror 等）。
- ThemeToggle 由二态 toggle 改为三态循环（Light→Dark→System→Light），
  图标按当前模式切换（太阳/月亮/显示器）；仅当实际明暗翻转时才触发
  圆形展开动画，避免 System 与同向 Light/Dark 间无意义动画。
- system.rs CodeMirror 传参改读 resolved，使 System 模式下系统偏好变化
  时编辑器主题自动跟随。
 2026-07-02 11:35:28 +08:00
xfy
9a218db478 refactor(assets): 编辑器背景图缩小至 w-24 并贴近右下角 
原图无宽度约束，按原始尺寸渲染占满编辑器；现固定 w-24（与评论区
一致）并用 bottom-2 right-2 定位到右下角。一并提交新增的线条小狗
素材图与图标资源。
 2026-07-02 11:22:34 +08:00
xfy
48a21564c4 refactor(assets): 背景图固定 opacity-10，移除动态透明度逻辑 
动态判断不生效，统一固定为 10% 透明度，移除聚焦/有内容的条件类。
 2026-07-02 11:17:41 +08:00
xfy
5fd883d7a1 feat(comments): 评论区有内容时自动调淡背景图透明度 
与 tiptap 编辑器保持一致：无内容时 60%，有内容或聚焦时淡出到
10%。content_md 由 oninput 实时维护，输入即触发重渲染。
 2026-07-02 11:14:58 +08:00
xfy
fe22d6dad8 feat(editor): tiptap 编辑器有内容时自动调淡背景图透明度 
无内容时背景图保持 60% 透明度；当编辑器内有内容(非纯空白)时，
背景图淡出到 10%，与聚焦时行为一致。content signal 由 onUpdate
回调实时维护，输入即触发重渲染，无需额外状态。
 2026-07-02 11:11:04 +08:00
xfy
48107d8e18 refactor(assets): 评论区与后台编辑器背景图换用 xiantiaoxiaogou_input_bg 2026-07-02 10:58:52 +08:00
xfy
9cf0e605d4 fix(admin): 修复服务器/数据库状态自动刷新失效 Bug 
use_future 旧实现在同步闭包体内捕获 status/loading/error signal，
导致这些 signal 每次 .set() 后都触发 use_future 重建新 loop，
旧 loop 同时继续运行，造成并发 loop 指数增长（请求爆炸），
实际效果等同于自动刷新完全失效或行为异常。

修复：采用 Dioxus 0.7 官方推荐模式——
- use_future 闭包直接返回 async move {}，不在同步层读任何 signal
- loop 内每次迭代读 refresh_interval/refresh_ms 的实时值
- 手动模式（interval = 0）改为 200ms yield + continue，
  使切换到自动模式时最多延迟 200ms 生效，避免忙等
- sleep 结束后二次检查 interval，防止 sleep 期间用户切回手动时
  仍然发起一次无意义请求

同时修复 DbStatusTab 和 ServerStatusTab 两处。
 2026-07-01 17:09:39 +08:00
xfy
404f85b732 refactor(web): 用 document::Link 注入 favicon，移除手写 index.html 
Dioxus 0.7 提供 document::Link 组件，可在 Rust 代码里声明 <link rel="icon">
注入 <head>，与已有的 document::Stylesheet / document::Title 同机制。

之前的方案手写 index.html（复制 dx CLI 默认 shell + 加 favicon 链接），
脆弱：嵌入了 toast 基础设施 JS/CSS，升级 dioxus-cli 后需手动同步。
改用 document::Link 后，favicon 由 SSR 运行时注入，无需维护静态模板。
 2026-07-01 17:00:58 +08:00
xfy
afa6bf892e feat(register): 输入框支持回车键提交表单 
注册页 4 个输入框（用户名/邮箱/密码/确认密码）原先 onkeydown 为 None，
无法用回车提交。改为监听 Enter 触发 on_submit，与登录页行为一致。
 2026-07-01 17:00:58 +08:00
xfy
78f3ff4b2f fix(admin): 登出按钮补 cursor-pointer 
登出按钮缺少 cursor-pointer，鼠标悬停时仍显示文本光标而非手型，与
其他可点击元素不一致。
 2026-07-01 17:00:58 +08:00
xfy
3faff98dc8 fix(layout): 后台导航栏与正文宽度对齐 
Header 的导航宽度写死 max-w-3xl（前台阅读宽度），后台直接复用导致
导航栏(768px)比正文(max-w-5xl=1024px)窄 256px，左边缘错位。

给 Header 加 max_width prop（默认 max-w-3xl 保持前台行为不变），后台
两处调用点传 max-w-5xl，与 admin_layout 的 main 同宽对齐。
 2026-07-01 17:00:58 +08:00
xfy
7de97d8222 fix(write): 编辑模式回显空白由 effect 竞态导致 
编辑文章时编辑器空白。根因：edit_post 由 None→Some 时，回填 effect
（写 content signal）与初始化 effect（读 content signal）在同一 tick
触发，无保证先后顺序。初始化 effect 经常先跑，读到 content()= 跳过
setMarkdown，且 editor_content_set=true 永久阻止重试。

修复：初始化 effect 直接从 edit_post（真值源）取 content_md 回填，不再
依赖 content signal——后者是派生值，与回填 effect 存在竞态。两个 effect
都已在 edit_post 上订阅，回填时读取它没有竞态。
 2026-07-01 17:00:58 +08:00
xfy
90734446b5 refactor(ui): remove redundant Tabs component 
Tabs 现已无调用方(/admin/system 已改用 FilterTabs),删除以消除 DRY 违反。
全局只保留 FilterTabs 一个 tab 组件,动画/样式统一。
 2026-06-30 18:12:03 +08:00
xfy
26d37f7271 refactor(admin): use FilterTabs in /admin/system 
system.rs 的 tab 栏从 Tabs 改用既有 FilterTabs,视觉与评论页完全一致
(平滑滑动指示条 + 选中文字 text-paper-primary)。Props 形状相同,仅改组件名;
SystemTab::as_str/from_str 桥接与枚举 match 穷举逻辑不变。
 2026-06-30 18:05:05 +08:00
xfy
5426458f4a fix(docs): resolve rustdoc broken links and dead_code warnings
Some checks failed
CI / check (push) Failing after 5m18s
Details
CI / build (push) Has been skipped
Details 
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 全部干净。
 2026-06-30 17:42:52 +08:00