refactor: 对原本的过长style.css进行拆分

assets/README.md

@@ -4,7 +4,7 @@
 
 - [目录概述](#目录概述)
 - [资源列表](#资源列表)
-- [资源使用说明](#资源使用说明)
+- [CSS 模块化架构](#css-模块化架构)
 - [添加新资源](#添加新资源)
 
 ## 目录概述
@@ -15,59 +15,84 @@
 
 目录包含以下主要资源：
 
-- **style.css**: 网站的主样式表文件
+- **style.css**: 样式入口文件
-  - 定义了网站的整体样式、布局和主题
+  - 通过 `@import` 聚合所有模块化 CSS
-  - 包含响应式设计和动画效果的实现
+  - 构建时由 esbuild 合并压缩为单文件
+
+- **styles/**: CSS 模块目录（详见下方）
 
 - **menav.svg**: 网站图标和项目logo
   - 显示在浏览器标签页、书签和收藏夹中
-  - 作为网站的标识符
   - SVG格式，包含黑色字母"M"和蓝色向上箭头设计
 
-- **preview_light.png**: 明亮主题预览图
+- **preview_light.png / preview_dark.png**: 主题预览图
-  - 用于README文档中展示网站明亮主题效果
+  - 用于 README 文档展示
-  - 作为项目展示素材
 
-- **preview_dark.png**: 暗黑主题预览图
+## CSS 模块化架构
-  - 用于README文档中展示网站暗黑主题效果
-  - 作为项目展示素材
 
-## 资源使用说明
+样式采用模块化组织，构建时自动合并：
 
-### 样式表
+```
+assets/
+├── style.css              # 入口文件（@import 聚合）
+└── styles/
+    ├── _variables.css     # CSS 变量、主题色
+    ├── _base.css          # 全局重置、滚动条
+    ├── _animations.css    # @keyframes 动画
+    ├── _layout.css        # 页面容器布局
+    ├── _sidebar.css       # 侧边栏组件
+    ├── _search.css        # 搜索框组件
+    ├── _cards.css         # 卡片组件（站点卡片、tooltip）
+    ├── _modal.css         # 模态框、表单
+    ├── _content.css       # Markdown 内容页
+    ├── _dashboard.css     # 仪表盘（时钟/Todo）
+    └── _main.css          # 兜底样式（分类、热力图、响应式）
+```
 
-`style.css` 文件包含网站的所有样式定义，遵循以下组织结构：
+### 模块说明
 
-- 基础样式 - 通用元素样式定义
+| 模块 | 职责 |
-- 布局样式 - 页面结构和布局定义
+|------|------|
-- 组件样式 - 特定UI组件的样式定义
+| `_variables.css` | CSS 变量、深色/浅色主题、间距/圆角系统 |
-- 响应式样式 - 适配不同设备屏幕的媒体查询
+| `_base.css` | 全局重置、滚动条、遮罩层、主题切换按钮 |
-- 主题样式 - 明亮和暗黑主题的颜色方案
+| `_animations.css` | 所有 `@keyframes` 定义 |
+| `_layout.css` | 页面容器、欢迎区域、模板布局 |
+| `_sidebar.css` | 侧边栏、导航项、折叠状态、子菜单 |
+| `_search.css` | 搜索框、引擎下拉、快捷键提示 |
+| `_cards.css` | 站点卡片、网格布局、tooltip、编辑按钮 |
+| `_modal.css` | 模态框、表单控件、按钮样式 |
+| `_content.css` | Markdown 渲染（标题、代码块、表格等） |
+| `_dashboard.css` | 仪表盘网格、时钟卡片、Todo 列表 |
+| `_main.css` | 分类层级、GitHub 热力图、全局响应式 |
 
-样式表支持主题切换功能，通过CSS变量实现不同主题下的颜色变换。
+### 构建流程
 
-### 图标与图片
+构建时 esbuild 会：
+1. 解析 `style.css` 中的 `@import` 语句
+2. 合并所有模块为单文件
+3. 压缩输出到 `dist/style.css`
 
-- 网站图标 (`menav.svg`) 自动应用于生成的网站
+> **开发提示**：修改 CSS 后运行 `npm run build` 或 `npm run dev` 查看效果。
-- 预览图片用于项目文档和宣传
 
 ## 添加新资源
 
-向资源目录添加新文件时，请遵循以下指南：
+### 文件命名规范
 
-1. **文件命名**:
+- 使用小写字母和连字符 (`-`)
-   - 使用小写字母和连字符 (`-`)
+- 避免使用空格和特殊字符
-   - 避免使用空格和特殊字符
+- 名称应清晰表达文件用途
-   - 名称应清晰表达文件用途
 
-2. **图片优化**:
+### CSS 扩展指南
-   - 压缩图片以减小文件大小
-   - 使用适合web的格式 (PNG, JPG, WebP)
-   - 考虑添加合适的分辨率版本
 
-3. **样式扩展**:
+1. **找到合适的模块**：根据功能选择对应的 `_*.css` 文件
-   - 新的样式应该添加到 `style.css` 的合适部分
+2. **遵循命名规范**：使用 BEM 风格或现有选择器模式
-   - 遵循现有的命名规范和组织结构
+3. **添加响应式支持**：在同一模块内添加 `@media` 查询
-   - 确保添加响应式设计支持
+4. **变量优先**：优先使用 `_variables.css` 中定义的变量
+
+### 图片优化
+
+- 压缩图片以减小文件大小
+- 使用 PNG、JPG、WebP 等 web 友好格式
+- 考虑添加合适的分辨率版本
 
 添加新资源后，构建系统会自动将这些文件复制到生成的网站中。

assets/styles/_animations.css

@@ -0,0 +1,49 @@
+/* ============================================
+   Animations & Keyframes
+   ============================================ */
+
+@keyframes glow {
+  from {
+    filter: drop-shadow(0 0 2px rgba(118, 148, 185, 0.2))
+      drop-shadow(0 0 4px rgba(168, 85, 247, 0.2));
+  }
+
+  to {
+    filter: drop-shadow(0 0 4px rgba(118, 148, 185, 0.4))
+      drop-shadow(0 0 8px rgba(168, 85, 247, 0.4));
+  }
+}
+
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+    transform: translateY(10px);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+@keyframes modalFadeIn {
+  from {
+    opacity: 0;
+  }
+
+  to {
+    opacity: 1;
+  }
+}
+
+@keyframes modalContentShow {
+  from {
+    opacity: 0;
+    transform: scale(0.95);
+  }
+
+  to {
+    opacity: 1;
+    transform: scale(1);
+  }
+}

assets/styles/_base.css

@@ -0,0 +1,238 @@
+/* ============================================
+   Base Styles & Global Reset
+   ============================================ */
+
+/* 可访问性：视觉隐藏但保留屏幕阅读器可读 */
+.visually-hidden {
+  position: absolute !important;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
+}
+
+/* 主题切换按钮 - 调整为 iOS 风格 */
+.theme-toggle {
+  position: fixed;
+  bottom: var(--spacing-xl);
+  right: var(--spacing-xl);
+  width: 2.5rem;
+  height: 2.5rem;
+  border-radius: var(--radius-lg);
+  background: rgba(var(--card-bg-rgb), 0.65);
+  border: 1px solid var(--border-color);
+  backdrop-filter: blur(12px);
+  -webkit-backdrop-filter: blur(12px);
+  color: var(--text-color);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  transition: all var(--transition-normal);
+  transition-timing-function: var(--transition-bounce);
+  z-index: 100;
+  box-shadow: 0 4px 16px var(--shadow-color);
+}
+
+.theme-toggle:hover {
+  transform: translateY(-2px);
+  background: rgba(var(--card-bg-rgb), 0.75);
+  box-shadow: 0 6px 20px var(--shadow-color);
+  color: var(--accent-color);
+}
+
+.theme-toggle:active {
+  transform: translateY(0);
+  box-shadow: 0 2px 8px var(--shadow-color);
+}
+
+.theme-toggle i {
+  font-size: 18px;
+}
+
+/* 全局样式 */
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+/* 全局 Focus Visible 样式 */
+:focus-visible {
+  outline: 2px solid var(--accent-color);
+  outline-offset: 2px;
+}
+
+/* 导航项 Focus 样式 */
+.nav-item:focus-visible,
+.submenu-item:focus-visible,
+.site-card:focus-visible,
+.theme-toggle:focus-visible,
+.category-toggle:focus-visible,
+.menu-toggle:focus-visible,
+.search-toggle:focus-visible {
+  outline: 2px solid var(--accent-color);
+  outline-offset: 2px;
+  z-index: 10;
+}
+
+/* 通用滚动条样式 */
+.custom-scrollbar {
+  scrollbar-width: thin;
+  /* Firefox */
+  scrollbar-color: var(--scrollbar-color) transparent;
+  /* Firefox */
+}
+
+/* Webkit滚动条样式（Chrome, Safari, Edge等） */
+.custom-scrollbar::-webkit-scrollbar {
+  width: 7px;
+  /* 统一滚动条宽度 */
+}
+
+.custom-scrollbar::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+.custom-scrollbar::-webkit-scrollbar-thumb {
+  background-color: var(--scrollbar-color);
+  /* 使用变量 */
+  border-radius: 4px;
+}
+
+.custom-scrollbar::-webkit-scrollbar-thumb:hover {
+  background-color: var(--scrollbar-hover-color);
+  /* 使用变量 */
+}
+
+/* 防止滚动条导致的布局偏移 */
+html {
+  overflow-y: hidden;
+  /* 改为hidden，移除强制显示的滚动条 */
+  scrollbar-width: thin;
+  /* Firefox */
+  /* 明确 rem 基准字号：便于用 rem 统一管理字号（1rem = 16px） */
+  font-size: 16px;
+}
+
+/* 搜索高亮样式 */
+.highlight {
+  background-color: var(--highlight-bg);
+  border-radius: var(--radius-sm);
+  padding: 0 2px;
+  font-weight: bold;
+  color: var(--text-color);
+}
+
+body {
+  font-family: var(
+    --font-body,
+    system-ui,
+    -apple-system,
+    'Segoe UI',
+    Roboto,
+    'Noto Sans',
+    'Helvetica Neue',
+    Arial,
+    sans-serif
+  );
+  font-weight: var(--font-weight-body, normal);
+  line-height: 1.6;
+  background-color: var(--bg-color);
+  color: var(--text-color);
+  min-height: var(--app-height, 100vh);
+  overflow: hidden;
+  /* 防止body滚动 */
+  padding-right: 0 !important;
+  /* 防止滚动条导致的布局偏移 */
+  transition:
+    background-color 0.3s ease,
+    color 0.3s ease;
+}
+
+/* 布局 */
+.layout {
+  display: flex;
+  min-height: var(--app-height, 100vh);
+  position: relative;
+  z-index: 1;
+  overflow: hidden;
+  /* 防止layout滚动 */
+  opacity: 0;
+  transition: opacity 0.3s ease;
+}
+
+/* 确保加载后立即显示 */
+body.loaded .layout {
+  opacity: 1;
+}
+
+/* 移动端基础样式 */
+.mobile-buttons {
+  display: none;
+  position: fixed;
+  top: var(--spacing-md);
+  top: calc(env(safe-area-inset-top) + var(--spacing-md));
+  left: 0;
+  right: 0;
+  width: 100%;
+  padding: 0 var(--spacing-md);
+  padding-left: calc(env(safe-area-inset-left) + var(--spacing-md));
+  padding-right: calc(env(safe-area-inset-right) + var(--spacing-md));
+  justify-content: space-between;
+  z-index: 910;
+  pointer-events: none;
+}
+
+.menu-toggle,
+.search-toggle {
+  background: var(--sidebar-bg);
+  border: none;
+  color: var(--text-color);
+  width: 2.5rem;
+  height: 2.5rem;
+  border-radius: var(--radius-md);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  transition: all 0.25s var(--transition-bounce);
+  box-shadow: 0 2px 8px var(--shadow-color);
+  pointer-events: auto;
+}
+
+.menu-toggle:hover,
+.search-toggle:hover {
+  background: var(--secondary-bg);
+  transform: translateY(-2px);
+  box-shadow: 0 4px 12px var(--shadow-color);
+}
+
+.menu-toggle:active,
+.search-toggle:active {
+  transform: translateY(0);
+}
+
+/* 遮罩层 */
+.overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  background: rgba(0, 0, 0, 0.5);
+  opacity: 0;
+  visibility: hidden;
+  transition: all 0.25s cubic-bezier(0.4, 0, 0.2, 1);
+  z-index: 950;
+  /* 调整遮罩层z-index，处于按钮与弹出面板之间 */
+}
+
+.overlay.active {
+  opacity: 1;
+  visibility: visible;
+}

assets/styles/_content.css

@@ -0,0 +1,216 @@
+/* Markdown Content Page */
+
+/* ------------------------------------------------------------------
+   Markdown Content Styling (GitHub-like) - Scoped to .content-page
+   ------------------------------------------------------------------ */
+
+/* Increase inner spacing for content pages to separate text from card border */
+.content-category .content-page {
+  padding-left: var(--spacing-sm);
+  padding-right: var(--spacing-sm);
+}
+
+@media (max-width: 480px) {
+  .content-category .content-page {
+    padding-left: var(--spacing-xs);
+    padding-right: var(--spacing-xs);
+  }
+}
+
+.content-page {
+  font-family: var(
+    --font-body,
+    -apple-system,
+    BlinkMacSystemFont,
+    'Segoe UI',
+    'Noto Sans',
+    Helvetica,
+    Arial,
+    sans-serif,
+    'Apple Color Emoji',
+    'Segoe UI Emoji'
+  );
+  font-size: 16px;
+  line-height: 1.6;
+  color: var(--text-color);
+  word-wrap: break-word;
+  padding-bottom: 2rem;
+}
+
+.content-page h1,
+.content-page h2,
+.content-page h3,
+.content-page h4,
+.content-page h5,
+.content-page h6 {
+  margin-top: 24px;
+  margin-bottom: 16px;
+  font-weight: 600;
+  line-height: 1.25;
+  color: var(--text-bright);
+}
+
+.content-page h1 {
+  font-size: 2em;
+  padding-bottom: 0.3em;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.content-page h2 {
+  font-size: 1.5em;
+  padding-bottom: 0.3em;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.content-page h3 {
+  font-size: 1.25em;
+}
+
+.content-page h4 {
+  font-size: 1em;
+}
+
+.content-page h5 {
+  font-size: 0.875em;
+}
+
+.content-page h6 {
+  font-size: 0.85em;
+  color: var(--text-muted);
+}
+
+.content-page p {
+  margin-top: 0;
+  margin-bottom: 16px;
+}
+
+.content-page blockquote {
+  margin: 0 0 16px;
+  padding: 0 1em;
+  color: var(--text-muted);
+  border-left: 0.25em solid var(--border-color);
+  background-color: transparent;
+}
+
+.content-page ul,
+.content-page ol {
+  margin-top: 0;
+  margin-bottom: 16px;
+  padding-left: 2em;
+}
+
+.content-page li + li {
+  margin-top: 0.25em;
+}
+
+/* Inline code */
+.content-page code {
+  font-family:
+    ui-monospace,
+    SFMono-Regular,
+    SF Mono,
+    Menlo,
+    Consolas,
+    Liberation Mono,
+    monospace;
+  font-size: 85%;
+  padding: 0.2em 0.4em;
+  margin: 0;
+  border-radius: var(--radius-sm);
+  background-color: rgba(127, 127, 127, 0.15);
+  color: var(--text-bright);
+}
+
+/* Block code (pre) */
+.content-page pre {
+  padding: 16px;
+  overflow: auto;
+  font-size: 85%;
+  line-height: 1.45;
+  /* 代码块背景需要与内容卡片区分开：避免与 card-bg 过于接近 */
+  background-color: rgba(127, 127, 127, 0.08);
+  border-radius: var(--radius-md);
+  margin-top: 0;
+  margin-bottom: 16px;
+  border: 1px solid var(--border-color);
+}
+
+.content-page pre code {
+  background-color: transparent;
+  padding: 0;
+  font-size: 100%;
+  color: inherit;
+  word-break: normal;
+  border-radius: 0;
+}
+
+.content-page hr {
+  height: 0.25em;
+  padding: 0;
+  margin: 24px 0;
+  background-color: var(--border-color);
+  border: 0;
+}
+
+/* Tables */
+.content-page table {
+  border-spacing: 0;
+  border-collapse: collapse;
+  margin-top: 0;
+  margin-bottom: 16px;
+  display: block;
+  width: max-content;
+  max-width: 100%;
+  overflow: auto;
+}
+
+.content-page table th,
+.content-page table td {
+  padding: 6px 13px;
+  border: 1px solid var(--border-color);
+}
+
+.content-page table th {
+  font-weight: 600;
+  background-color: rgba(var(--card-bg-rgb), 0.3);
+}
+
+.content-page table tr {
+  background-color: transparent;
+  border-top: 1px solid var(--border-color);
+}
+
+.content-page table tr:nth-child(2n) {
+  background-color: rgba(127, 127, 127, 0.04);
+}
+
+.content-page img {
+  max-width: 100%;
+  box-sizing: content-box;
+  background-color: transparent;
+  border-radius: var(--radius-sm);
+}
+
+.content-page a {
+  color: var(--accent-color);
+  text-decoration: none;
+}
+
+.content-page a:hover {
+  text-decoration: underline;
+}
+
+/* Task lists */
+.content-page ul.contains-task-list {
+  list-style-type: none;
+  padding-left: 0;
+}
+
+.content-page .task-list-item input {
+  margin-right: 0.5em;
+  vertical-align: middle;
+}
+
+/* GitHub Calendar Fixes (HTML Table Version)
+ * 注：此处样式已合并到上方「projects：GitHub 热力图（github-calendar.js）」区域，避免重复维护。
+ */

assets/styles/_dashboard.css

@@ -0,0 +1,371 @@
+/* Dashboard (Clock & Todo) */
+
+/* =========================================
+   Home Dashboard Styles
+   ========================================= */
+
+.dashboard-grid {
+  display: grid;
+  grid-template-columns: 1fr;
+  /* Mobile first: stack vertically */
+  gap: var(--spacing-xl);
+  margin-bottom: var(--spacing-xl);
+}
+
+@media (min-width: 992px) {
+  .dashboard-grid {
+    grid-template-columns: 5fr 7fr;
+    /* Desktop: 5/12 - 7/12 ratio like 1.html */
+    align-items: stretch;
+    /* Stretch to align bottoms */
+    gap: var(--spacing-lg);
+    /* Reduced gap */
+    margin-bottom: var(--spacing-lg);
+    /* Reduced margin */
+  }
+}
+
+/* --- Left Column: Welcome & Clock --- */
+.dashboard-intro {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  /* Match grid row height */
+  gap: var(--spacing-md);
+  /* Reduced gap */
+  justify-content: space-between;
+  /* Spread welcome and clock */
+}
+
+.dashboard-welcome {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-md);
+}
+
+.welcome-title {
+  font-size: 3.5rem;
+  font-family: var(--font-heading, var(--font-body, sans-serif));
+  font-weight: 800;
+  /* Extra Bold */
+  font-style: normal;
+  /* Remove italic */
+  text-transform: uppercase;
+  /* Pop Style */
+  letter-spacing: -0.03em;
+  /* Tight spacing */
+  color: var(--text-color);
+  /* Use primary text color, accent reserved for highlights */
+  line-height: 0.95;
+  margin: 0;
+  padding-left: var(--spacing-xl);
+  /* Shift right */
+}
+
+.welcome-subtitle {
+  font-size: 0.9rem;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: var(--accent-color);
+  /* Accent color for subtitle */
+  font-weight: 600;
+  margin-top: 1rem;
+  padding-left: var(--spacing-xl);
+  opacity: 0.9;
+}
+
+@media (min-width: 768px) {
+  .welcome-title {
+    font-size: 3.5rem;
+    padding-left: 2rem;
+    /* Reduced from 5rem */
+  }
+
+  .welcome-subtitle {
+    font-size: 1.125rem;
+    padding-left: 2rem;
+  }
+}
+
+/* Clock Card - Apple Style: Flat + Soft Shadow */
+.dashboard-clock-card {
+  position: relative;
+  background-color: var(--card-bg-gradient-1);
+  /* Solid color, no gradient needed for flat look */
+  border: 0.5px solid var(--border-color);
+  /* Very subtle border */
+  border-radius: var(--radius-xl);
+  display: flex;
+  flex-direction: column;
+  justify-content: space-between;
+  flex: 1;
+  box-shadow: 0 8px 24px var(--shadow-color);
+  /* Soft, diffused shadow */
+  transition:
+    transform var(--transition-normal),
+    box-shadow var(--transition-normal);
+  overflow: hidden;
+  padding: var(--spacing-xl);
+  /* More padding for spatial luxury */
+}
+
+body.light-theme .dashboard-clock-card {
+  box-shadow: 0 8px 32px rgba(0, 0, 0, 0.08);
+  /* Lighter shadow for light mode */
+}
+
+.clock-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  z-index: 1;
+}
+
+.clock-meta {
+  display: flex;
+  flex-direction: column;
+}
+
+.clock-main {
+  align-self: flex-end;
+  /* Time at bottom right */
+  z-index: 1;
+}
+
+.clock-time {
+  font-size: 3.5rem;
+  /* Reduced from 4.5rem to prevent overflow */
+  font-weight: 700;
+  color: var(--text-bright);
+  line-height: 1;
+  font-family: var(--font-body);
+  letter-spacing: -0.02em;
+}
+
+.clock-greeting {
+  font-size: 0.85rem;
+  color: var(--accent-color);
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.1em;
+  margin-bottom: 0.2rem;
+}
+
+.clock-week {
+  font-size: 0.75rem;
+  color: var(--text-muted);
+  border: 1px solid var(--border-color);
+  padding: 2px 8px;
+  border-radius: 12px;
+}
+
+.clock-date {
+  font-size: 1.25rem;
+  /* Reduced from 1.5rem */
+  color: var(--text-muted);
+  font-family: var(--font-body);
+}
+
+/* --- Right Column: Stats / Todo --- */
+.dashboard-stats {
+  height: 100%;
+  min-height: 300px;
+}
+
+.dashboard-panel {
+  background-color: var(--card-bg-gradient-1);
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-xl);
+  display: flex;
+  height: 310px;
+  /* Increased from 280px to align with clock card better */
+  overflow: hidden;
+  box-shadow: 4px 4px 0px 0px rgba(255, 255, 255, 0.15);
+  transition: box-shadow 0.2s ease;
+}
+
+body.light-theme .dashboard-panel {
+  box-shadow: 4px 4px 0px 0px rgba(0, 0, 0, 0.2);
+}
+
+.panel-sidebar {
+  width: 4rem;
+  background-color: var(--sidebar-bg);
+  border-right: 4px solid var(--border-color);
+  display: flex;
+  flex-direction: column;
+  justify-content: space-between;
+  /* Icon at top, button at bottom */
+  align-items: center;
+  padding: var(--spacing-md) 0;
+}
+
+.panel-static-icon {
+  color: var(--text-muted);
+  font-size: 1.5rem;
+  padding: 0.5rem;
+}
+
+.panel-icon-btn {
+  background: none;
+  border: none;
+  color: var(--text-muted);
+  font-size: 1.5rem;
+  cursor: pointer;
+  padding: 0.5rem;
+  border-radius: var(--radius-md);
+  transition: color 0.2s;
+}
+
+.panel-icon-btn:hover {
+  color: var(--accent-color);
+}
+
+.panel-content-wrapper {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  height: 100%;
+}
+
+.panel-content {
+  flex: 1;
+  padding: var(--spacing-lg);
+  overflow-y: auto;
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-md);
+}
+
+/* Todo Items */
+.todo-item {
+  display: flex;
+  align-items: center;
+  gap: var(--spacing-md);
+  padding: 4px 0;
+  /* Tighter spacing */
+  cursor: pointer;
+  transition: opacity 0.2s;
+  opacity: 1;
+  position: relative;
+}
+
+.todo-item:hover .todo-delete-btn {
+  opacity: 1;
+  pointer-events: auto;
+}
+
+.todo-checkbox {
+  width: 1.25rem;
+  height: 1.25rem;
+  border: 2px solid var(--text-muted);
+  border-radius: var(--radius-sm);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  transition: all 0.2s;
+}
+
+.todo-checkbox.checked {
+  background-color: var(--accent-color);
+  border-color: var(--accent-color);
+  color: white;
+}
+
+.todo-checkbox.checked span {
+  font-size: 0.8rem;
+}
+
+.todo-text {
+  font-size: 1.1rem;
+  color: var(--text-bright);
+  flex: 1;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.todo-item.done .todo-text {
+  text-decoration: line-through;
+  opacity: 0.5;
+}
+
+/* Delete Button */
+.todo-delete-btn {
+  opacity: 0;
+  pointer-events: none;
+  background: none;
+  border: none;
+  color: var(--error-color);
+  padding: 0 0.5rem;
+  cursor: pointer;
+  transition: opacity 0.2s;
+  font-size: 0.85rem;
+}
+
+/* Todo Input Area */
+.todo-input-container {
+  padding-top: var(--spacing-sm);
+  border-top: 1px solid var(--border-color);
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  width: 100%;
+  /* Ensure full width */
+  margin-top: auto;
+  /* Push to bottom if flex child */
+}
+
+.todo-input {
+  flex: 1;
+  background: transparent;
+  border: none;
+  border-bottom: 2px solid var(--border-color);
+  color: var(--text-bright);
+  padding: 0.4rem 0;
+  font-size: 1rem;
+  font-family: var(--font-body);
+}
+
+.todo-input:focus {
+  outline: none;
+  border-bottom-color: var(--accent-color);
+}
+
+.todo-add-btn-small {
+  background: none;
+  border: none;
+  color: var(--accent-color);
+  cursor: pointer;
+  font-size: 1.2rem;
+}
+
+/* Light Mode Overrides for Specific Dashboard Colors if needed */
+
+@media (max-width: 768px) {
+  /* 移动端隐藏首页的时间卡片和Todo面板 */
+  .dashboard-clock-card,
+  .dashboard-stats {
+    display: none !important;
+  }
+
+  /* 调整移动端首页欢迎语布局 */
+  .dashboard-intro {
+    height: auto;
+    gap: 0;
+    margin-bottom: var(--spacing-md);
+  }
+
+  /* 适当减小欢迎语字号 */
+  .welcome-title {
+    font-size: 2.5rem;
+    padding-left: 1rem;
+  }
+
+  .welcome-subtitle {
+    padding-left: 1rem;
+    margin-top: 0.5rem;
+  }
+}

assets/styles/_layout.css

@@ -0,0 +1,101 @@
+/* ============================================
+   Page Layout & Containers
+   ============================================ */
+
+/* 页面容器 */
+.page {
+  position: relative;
+  width: 100%;
+  display: none;
+  flex-direction: column;
+  align-items: center;
+  padding-top: 2rem;
+  padding-left: 0.5rem;
+  padding-right: 0.5rem;
+}
+
+.page.active {
+  display: flex;
+}
+
+/* 页面模板容器（friends/articles/projects 等） */
+.page-template {
+  width: 100%;
+  max-width: var(--page-max-width);
+  margin: 0 auto;
+}
+
+/* 欢迎区域 - Design A (Minimalist) */
+.welcome-section {
+  width: 100%;
+  max-width: var(--page-max-width);
+  margin: 0 auto 1.2rem auto;
+  padding: 0 var(--spacing-lg);
+  text-align: left;
+  position: relative;
+  z-index: 5;
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-end;
+  flex-wrap: wrap;
+  gap: var(--spacing-md);
+}
+
+.welcome-section-main {
+  flex: 1;
+  min-width: 220px;
+}
+
+.welcome-section-side {
+  flex: 0 0 auto;
+}
+
+.welcome-section h2 {
+  font-size: 1.75rem;
+  color: var(--text-bright);
+  margin-bottom: 0.25rem;
+  letter-spacing: 0.5px;
+  transition: color 0.3s ease;
+}
+
+.welcome-section h3 {
+  font-family: var(--font-body);
+  font-weight: 400;
+  font-size: 1rem;
+  margin-bottom: 0.5rem;
+  letter-spacing: 0.3px;
+  color: var(--text-muted);
+  position: relative;
+  display: block;
+}
+
+.welcome-section h3::before {
+  display: none;
+}
+
+.welcome-section .subtitle {
+  color: var(--text-muted);
+  font-size: 0.95rem;
+  line-height: 1.5;
+  transition: color 0.3s ease;
+}
+
+/* bookmarks：标题后追加"更新时间"小字 */
+.welcome-title-row {
+  display: flex;
+  align-items: baseline;
+  flex-wrap: wrap;
+  gap: 0.6rem;
+  margin-bottom: 0.5rem;
+}
+
+.welcome-title-row h2 {
+  margin: 0;
+}
+
+.page-updated-inline {
+  color: var(--text-muted);
+  font-size: 0.9rem;
+  opacity: 0.85;
+  white-space: nowrap;
+}

assets/styles/_modal.css

@@ -0,0 +1,152 @@
+/* Modal & Forms */
+
+/* 模态框样式 */
+.modal {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  background-color: rgba(0, 0, 0, 0.6);
+  display: none;
+  justify-content: center;
+  align-items: center;
+  z-index: 1000;
+}
+
+.modal.active {
+  display: flex;
+  animation: modalFadeIn 0.3s ease-out forwards;
+}
+
+.modal-content {
+  background-color: var(--sidebar-bg);
+  border-radius: var(--radius-xl);
+  padding: var(--spacing-xl);
+  width: 90%;
+  max-width: 520px;
+  position: relative;
+  box-shadow: 0 8px 32px var(--shadow-color);
+  transform: scale(0.95);
+  opacity: 0;
+  animation: modalContentShow 0.3s ease-out forwards;
+  transition: background-color 0.3s ease;
+}
+
+.modal-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 2rem;
+}
+
+.modal-header h3 {
+  color: var(--text-bright);
+  font-size: 1.3rem;
+  letter-spacing: 0.3px;
+  font-weight: 500;
+  transition: color 0.3s ease;
+}
+
+.close-modal {
+  background: none;
+  border: none;
+  color: var(--text-muted);
+  cursor: pointer;
+  font-size: 1.5rem;
+  padding: var(--spacing-sm);
+  transition: all var(--transition-normal);
+  border-radius: var(--radius-md);
+}
+
+.close-modal:hover {
+  color: var(--text-bright);
+  background-color: var(--secondary-bg);
+}
+
+/* 表单样式 */
+.site-form {
+  display: flex;
+  flex-direction: column;
+  gap: 1.2rem;
+}
+
+.form-group {
+  display: flex;
+  flex-direction: column;
+  gap: 0.6rem;
+}
+
+.form-group label {
+  color: var(--text-muted);
+  font-size: 0.95rem;
+  letter-spacing: 0.2px;
+  transition: color 0.3s ease;
+}
+
+.form-group input,
+.form-group select {
+  background-color: var(--secondary-bg);
+  border: 1px solid transparent;
+  border-radius: var(--radius-md);
+  padding: var(--spacing-md) var(--spacing-lg);
+  color: var(--text-color);
+  font-size: 1rem;
+  transition: all var(--transition-normal);
+  box-shadow: 0 2px 6px var(--shadow-color);
+}
+
+.form-group input:focus,
+.form-group select:focus {
+  outline: none;
+  background-color: var(--secondary-bg);
+  border-color: var(--accent-color);
+  box-shadow: 0 2px 8px rgba(118, 148, 185, 0.15);
+}
+
+.form-group input::placeholder {
+  color: var(--text-muted);
+}
+
+.form-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 1rem;
+  margin-top: 2rem;
+}
+
+.btn {
+  padding: var(--spacing-md) var(--spacing-xl);
+  border: none;
+  border-radius: var(--radius-md);
+  cursor: pointer;
+  font-size: 1rem;
+  font-weight: 500;
+  letter-spacing: 0.3px;
+  transition: all var(--transition-normal);
+  transition-timing-function: var(--transition-bounce);
+  box-shadow: 0 2px 6px var(--shadow-color);
+}
+
+.btn-primary {
+  background-color: var(--accent-color);
+  color: var(--white-color);
+}
+
+.btn-primary:hover {
+  background-color: var(--accent-hover);
+  transform: translateY(-2px);
+  box-shadow: 0 4px 12px rgba(118, 148, 185, 0.2);
+}
+
+.btn-secondary {
+  background-color: var(--secondary-bg);
+  color: var(--text-muted);
+}
+
+.btn-secondary:hover {
+  background-color: var(--secondary-bg);
+  color: var(--text-bright);
+  transform: translateY(-2px);
+  box-shadow: 0 4px 12px var(--shadow-color);
+}

assets/styles/_search.css

@@ -0,0 +1,306 @@
+/* ============================================
+   Search Box Component
+   ============================================ */
+
+/* 搜索框容器 - 固定在顶部 */
+.search-container {
+  width: 100%;
+  display: flex;
+  justify-content: center;
+  padding: 0 2rem;
+  margin-bottom: 1rem;
+  position: sticky;
+  top: 0;
+  /* 搜索框必须始终位于页面内容之上，避免搜索结果卡片滚动时遮挡 */
+  z-index: 200;
+}
+
+/* 分类切换按钮 */
+.category-toggle {
+  position: fixed;
+  bottom: 5rem;
+  right: var(--spacing-xl);
+  width: 2.5rem;
+  height: 2.5rem;
+  border-radius: var(--radius-lg);
+  background: rgba(var(--card-bg-rgb), 0.65);
+  border: 1px solid var(--border-color);
+  backdrop-filter: blur(12px);
+  -webkit-backdrop-filter: blur(12px);
+  color: var(--text-color);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  transition: all var(--transition-normal);
+  transition-timing-function: var(--transition-bounce);
+  z-index: 100;
+  box-shadow: 0 4px 16px var(--shadow-color);
+}
+
+.category-toggle:hover {
+  transform: translateY(-2px);
+  background: rgba(var(--card-bg-rgb), 0.75);
+  box-shadow: 0 6px 20px var(--shadow-color);
+  color: var(--accent-color);
+}
+
+.category-toggle:active {
+  transform: translateY(0);
+  box-shadow: 0 2px 8px var(--shadow-color);
+}
+
+.category-toggle i {
+  font-size: 18px;
+}
+
+/* 搜索框 */
+.search-box {
+  position: relative;
+  width: 100%;
+  max-width: 600px;
+  display: flex;
+  align-items: stretch;
+  --search-status-right: 0.9rem;
+  --search-hint-right: 1.6rem;
+  background: rgba(var(--card-bg-rgb), 0.65);
+  border: 1px solid var(--border-color);
+  backdrop-filter: blur(12px);
+  -webkit-backdrop-filter: blur(12px);
+  border-radius: var(--radius-lg);
+  box-shadow: 0 4px 16px var(--shadow-color);
+  transition:
+    background var(--transition-normal),
+    border-color var(--transition-normal),
+    box-shadow var(--transition-normal);
+}
+
+.search-box:focus-within {
+  border-color: rgba(var(--accent-rgb), 0.55);
+  box-shadow:
+    0 0 0 1px rgba(var(--accent-rgb), 0.28),
+    0 0 18px rgba(var(--accent-rgb), 0.18),
+    0 6px 24px var(--shadow-color);
+}
+
+.search-box::after {
+  content: '';
+  position: absolute;
+  right: var(--search-status-right);
+  top: 50%;
+  transform: translateY(-50%);
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  opacity: 0;
+  transition: all var(--transition-normal);
+  pointer-events: none;
+}
+
+.search-box.has-results::after {
+  background-color: var(--success-color);
+  opacity: 1;
+}
+
+.search-box.no-results::after {
+  background-color: var(--error-color);
+  opacity: 1;
+}
+
+.search-box input {
+  flex: 1;
+  min-width: 0;
+  width: 100%;
+  padding: var(--spacing-md) calc(var(--spacing-lg) + 4.8rem) var(--spacing-md) var(--spacing-md);
+  border: none;
+  border-radius: 0 var(--radius-lg) var(--radius-lg) 0;
+  background-color: transparent;
+  color: var(--text-color);
+  font-family: inherit;
+  font-weight: inherit;
+  font-size: 1rem;
+  transition:
+    background-color var(--transition-normal),
+    color var(--transition-normal);
+  box-shadow: none;
+}
+
+.search-box input:focus {
+  outline: none;
+  background-color: rgba(var(--card-bg-rgb), 0.25);
+  box-shadow: none;
+}
+
+.search-box input::placeholder {
+  color: var(--text-muted);
+  font-family: inherit;
+  font-weight: inherit;
+}
+
+.search-shortcut-hint {
+  position: absolute;
+  top: 50%;
+  right: var(--search-hint-right);
+  transform: translateY(-50%);
+  padding: 0.1rem 0.4rem;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-md);
+  background: rgba(var(--card-bg-rgb), 0.25);
+  font-size: 0.78rem;
+  line-height: 1.2;
+  color: var(--text-muted);
+  opacity: 0.65;
+  pointer-events: none;
+  user-select: none;
+}
+
+.search-box:focus-within .search-shortcut-hint {
+  opacity: 0.85;
+}
+
+/* 搜索引擎前缀按钮（方案B：输入框前缀一体化） */
+.search-engine-button {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0 0.75rem;
+  width: 120px;
+  flex: 0 0 120px;
+  border: none;
+  border-right: 1px solid var(--border-color);
+  border-radius: var(--radius-lg) 0 0 var(--radius-lg);
+  background: transparent;
+  color: var(--text-muted);
+  cursor: pointer;
+  font: inherit;
+  transition:
+    background var(--transition-normal),
+    color var(--transition-normal),
+    transform var(--transition-normal);
+}
+
+.search-engine-button:hover {
+  background: rgba(var(--card-bg-rgb), 0.25);
+}
+
+.search-engine-button:focus-visible {
+  outline: 2px solid var(--accent-color);
+  outline-offset: 2px;
+}
+
+.search-box:focus-within .search-engine-button {
+  color: var(--accent-color);
+}
+
+.search-engine-icon {
+  display: grid;
+  place-items: center;
+  height: 1.2em;
+  width: 1.2em;
+  min-width: 1.2em;
+  font-size: 1.25rem;
+  line-height: 1;
+  text-align: center;
+  flex: 0 0 1.2em;
+}
+
+.search-engine-icon.search-engine-icon-svg {
+  font-size: 1.25rem;
+}
+
+.search-engine-icon.search-engine-icon-svg svg {
+  width: 100%;
+  height: 100%;
+  display: block;
+}
+
+.search-engine-label {
+  flex: 1;
+  min-width: 0;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  font-size: 0.95rem;
+}
+
+.search-box.dropdown-open .search-engine-button {
+  background: rgba(var(--card-bg-rgb), 0.25);
+}
+
+/* 搜索引擎下拉菜单 */
+.search-engine-dropdown {
+  position: absolute;
+  top: calc(100% + 6px);
+  left: 0;
+  background: rgba(var(--card-bg-rgb), 0.9);
+  backdrop-filter: blur(12px);
+  -webkit-backdrop-filter: blur(12px);
+  border-radius: var(--radius-md);
+  box-shadow: 0 4px 15px var(--shadow-color);
+  display: none;
+  z-index: 100;
+  padding: 0.35rem;
+  border: 1px solid var(--border-color);
+  min-width: 190px;
+  flex-direction: column;
+  gap: 0.25rem;
+}
+
+.search-engine-dropdown.active {
+  display: flex;
+  animation: fadeIn 0.2s ease-out forwards;
+}
+
+.search-engine-option {
+  display: flex;
+  align-items: center;
+  justify-content: flex-start;
+  gap: 0.6rem;
+  width: 100%;
+  height: 40px;
+  padding: 0 0.75rem;
+  border: none;
+  border-radius: var(--radius-md);
+  cursor: pointer;
+  transition: all 0.2s ease;
+  background: transparent;
+  color: var(--text-color);
+  font: inherit;
+}
+
+.search-engine-option:hover {
+  background: rgba(var(--card-bg-rgb), 0.22);
+}
+
+.search-engine-option:focus-visible {
+  outline: 2px solid var(--accent-color);
+  outline-offset: 2px;
+}
+
+.search-engine-option.active {
+  background-color: var(--secondary-bg);
+  color: var(--text-bright);
+}
+
+.search-engine-option i {
+  display: grid;
+  place-items: center;
+  position: static;
+  transform: none;
+  font-size: 1.25rem;
+  width: 1.35em;
+  height: 1.35em;
+  line-height: 1;
+  text-align: center;
+  flex: 0 0 1.35em;
+}
+
+.search-engine-option i.search-engine-option-svg svg {
+  width: 100%;
+  height: 100%;
+  display: block;
+}
+
+.search-engine-option-label {
+  font-size: 0.95rem;
+}

assets/styles/_sidebar.css

@@ -0,0 +1,613 @@
+/* ============================================
+   Sidebar Component
+   ============================================ */
+
+/* 侧边栏样式 */
+.sidebar {
+  width: var(--sidebar-width);
+  background-color: var(--sidebar-bg);
+  position: fixed;
+  top: 0;
+  left: 0;
+  bottom: 0;
+  box-shadow: 2px 0 10px var(--shadow-color);
+  z-index: 100;
+  -webkit-backface-visibility: hidden;
+  backface-visibility: hidden;
+  transform: translateZ(0);
+  height: var(--app-height, 100vh);
+  display: grid;
+  grid-template-rows: auto 1fr auto auto;
+  grid-template-areas:
+    'header'
+    'content'
+    'social'
+    'footer';
+  scrollbar-width: thin;
+  scrollbar-color: var(--scrollbar-color) transparent;
+  overflow-y: hidden;
+  transition: background-color var(--transition-normal);
+}
+
+/* 侧边栏折叠状态 */
+.sidebar.collapsed {
+  width: var(--sidebar-collapsed-width);
+  overflow-x: hidden;
+}
+
+/* 优化侧边栏折叠时的Logo部分 */
+.sidebar.collapsed .logo {
+  padding: 1.2rem 0.5rem 0.6rem;
+  justify-content: center;
+  display: flex;
+  align-items: center;
+  height: 3.75rem;
+  /* 确保与展开状态高度一致 */
+  margin-bottom: 0.8rem;
+  /* 收起态同样拉开与按钮的间距 */
+}
+
+/* 调整折叠侧边栏的部分元素间距 */
+.sidebar.collapsed .nav-section {
+  gap: 2px;
+}
+
+/* 折叠状态下隐藏底部版权区域（不占位） */
+.sidebar.collapsed .sidebar-footer {
+  padding: 0;
+  height: 0;
+  min-height: 0;
+  margin: 0;
+  overflow: hidden;
+  border: none;
+}
+
+/* 侧边栏头部区域 */
+.sidebar .logo {
+  grid-area: header;
+  padding: 1.2rem 1.2rem 0.6rem;
+  /* 调整上下padding更紧凑 */
+  display: flex;
+  align-items: center;
+  overflow: hidden;
+  /* 防止内容溢出 */
+  position: relative;
+  /* 添加相对定位，作为按钮的参考 */
+  height: 3.75rem;
+  /* 固定高度 60px */
+  margin-bottom: 0.8rem;
+  /* 与下方按钮区域拉开间距 */
+  transition: padding 0.3s ease;
+  /* 添加padding过渡，避免突变 */
+}
+
+.logo-brand {
+  display: flex;
+  align-items: center;
+  gap: 0.6rem;
+  min-width: 0;
+  flex: 1;
+  padding-right: 2.2rem;
+  /* 预留右侧折叠按钮空间 */
+}
+
+.logo-brand h1 {
+  padding-left: 0;
+}
+
+.logo-image {
+  width: 26px;
+  height: 26px;
+  flex-shrink: 0;
+}
+
+.sidebar.collapsed .logo-image {
+  display: none;
+}
+
+.logo h1 {
+  font-size: 1.4rem;
+  color: var(--text-bright);
+  margin-bottom: 0;
+  padding-left: 0.5rem;
+  letter-spacing: 0.5px;
+  transition:
+    opacity 0.3s ease,
+    transform 0.3s ease;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  flex: 1;
+}
+
+/* 侧边栏折叠按钮 */
+.sidebar-toggle {
+  background: transparent;
+  border: none;
+  color: var(--accent-color);
+  height: 28px;
+  width: 28px;
+  border-radius: 50%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  transition: background 0.3s ease;
+  /* 只过渡背景色，移除all避免位置过渡 */
+  padding: 0;
+  flex-shrink: 0;
+  /* 防止按钮被压缩 */
+  position: absolute;
+  /* 在两种状态下都使用绝对定位 */
+  right: 1.2rem;
+  /* 展开状态下固定在右侧 */
+  top: 60%;
+  transform: translateY(-50%);
+  /* 垂直居中 */
+}
+
+.sidebar-toggle .toggle-icon {
+  font-size: 0.9rem;
+  transition: transform 0.3s ease;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  height: 100%;
+}
+
+.sidebar-toggle:hover {
+  background: var(--secondary-bg);
+}
+
+.sidebar-toggle:active {
+  background: var(--secondary-bg);
+}
+
+/* 收起状态下按钮居中 */
+.sidebar.collapsed .sidebar-toggle {
+  left: 50%;
+  /* 水平居中 */
+  right: auto;
+  /* 移除右侧定位 */
+  transform: translate(-50%, -50%);
+  /* 同时水平和垂直居中 */
+}
+
+.sidebar.collapsed .sidebar-toggle:hover {
+  background: var(--secondary-bg);
+}
+
+.sidebar.collapsed .sidebar-toggle:active {
+  background: var(--secondary-bg);
+}
+
+/* 侧边栏折叠状态下的按钮图标旋转180度 */
+.sidebar.collapsed .toggle-icon {
+  transform: rotate(180deg);
+}
+
+/* 侧边栏内容区域：导航项常驻显示，分类列表在独立面板内滚动 */
+.sidebar-content {
+  grid-area: content;
+  min-height: 0;
+  /* 允许在 CSS Grid 内正确收缩与滚动，避免把 footer 挤出可视区域 */
+  overflow: hidden;
+  /* 导航项常驻显示，分类列表在独立面板内滚动 */
+  padding: 0 1.2rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.6rem;
+  /* 从1rem减小到0.6rem */
+}
+
+.sidebar-content::-webkit-scrollbar {
+  display: none;
+  /* Webkit browsers（默认不滚动，保留兼容） */
+}
+
+/* 展开态：子菜单不在导航项内部展开，改在独立面板展示（避免把"页面列表"挤出首屏） */
+.sidebar:not(.collapsed) .nav-item-wrapper > .submenu {
+  display: none;
+}
+
+/* 侧边栏：页面分类面板（容器本身可滚动，隐藏滚动条） */
+.sidebar-submenu-panel {
+  flex: 1 1 auto;
+  min-height: 0;
+  overflow-y: auto;
+  padding: 0 0 0.6rem;
+  /* 移除顶部 padding，避免标题上方出现缝隙 */
+  scrollbar-width: none;
+  /* Firefox 隐藏滚动条 */
+}
+
+.sidebar-submenu-panel:empty {
+  display: none;
+}
+
+.sidebar-submenu-panel::-webkit-scrollbar {
+  display: none;
+  /* Webkit 浏览器隐藏滚动条 */
+}
+
+/* 面板内的 submenu 始终可见（不依赖 wrapper.expanded） */
+.sidebar-submenu-panel .submenu {
+  max-height: none;
+  overflow: visible;
+  opacity: 1;
+  visibility: visible;
+  margin-left: 0;
+  transition: none;
+}
+
+/* 折叠状态下的内容区域调整 */
+.sidebar.collapsed .sidebar-content {
+  padding: 0 0.5rem;
+  overflow-y: auto;
+  overflow-x: hidden;
+  scrollbar-width: none;
+  /* 隐藏滚动条 */
+}
+
+.sidebar.collapsed .sidebar-content::-webkit-scrollbar {
+  display: none;
+  /* 隐藏WebKit浏览器的滚动条 */
+}
+
+.sidebar.collapsed .sidebar-submenu-panel {
+  display: none;
+}
+
+/* 子菜单标题：默认隐藏（在导航栏内折叠时） */
+.submenu-header {
+  display: none;
+  font-size: 0.85rem;
+  font-weight: 500;
+  text-transform: uppercase;
+  color: var(--text-muted);
+  letter-spacing: 0.5px;
+  padding: 0.8rem 1rem 0.6rem;
+  margin-bottom: 0.2rem;
+  border-bottom: 1px solid var(--border-color);
+  transition:
+    color var(--transition-normal),
+    background-color var(--transition-normal),
+    border-bottom-color var(--transition-normal);
+  opacity: 0.8;
+}
+
+/* 当子菜单在面板中显示时：显示标题并固定在顶部 */
+.sidebar-submenu-panel .submenu-header {
+  display: block;
+  position: sticky;
+  top: 0;
+  margin-top: 0;
+  margin-bottom: 0.2rem;
+  /* 覆盖基础样式的 margin-bottom */
+  background-color: var(--sidebar-bg);
+  opacity: 1;
+  /* 覆盖基础样式的半透明，确保背景完全不透明 */
+  z-index: 1;
+  /* 确保标题在滚动时覆盖下方内容 */
+}
+
+/* 子菜单项样式优化 */
+.submenu-item {
+  display: flex;
+  align-items: center;
+  gap: 0.8rem;
+  padding: 0.6rem 1rem;
+  color: var(--nav-item-color);
+  text-decoration: none;
+  border-radius: var(--radius-md);
+  transition: all var(--transition-normal);
+  margin-bottom: 2px;
+  font-size: 0.95rem;
+  position: relative;
+  overflow: hidden;
+}
+
+.submenu-item i {
+  width: 1.4rem;
+  text-align: center;
+  font-size: 1rem;
+  opacity: 0.8;
+  transition: transform var(--transition-normal);
+}
+
+.submenu-item span {
+  flex: 1;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+/* 悬浮状态 */
+.submenu-item:hover {
+  background-color: var(--secondary-bg);
+  color: var(--text-bright);
+  padding-left: 1.2rem;
+  /* 悬浮时轻微右移增加动感 */
+}
+
+.submenu-item:hover i {
+  transform: scale(1.1);
+  color: var(--accent-color);
+  opacity: 1;
+}
+
+/* 激活状态 */
+.submenu-item.active {
+  background-color: rgba(var(--accent-rgb), 0.15);
+  color: var(--accent-color);
+  font-weight: 500;
+}
+
+.submenu-item.active i {
+  color: var(--accent-color);
+  opacity: 1;
+}
+
+/* 在激活状态左侧添加指示条 */
+.submenu-item.active::before {
+  content: '';
+  position: absolute;
+  left: 0;
+  top: 50%;
+  transform: translateY(-50%);
+  height: 60%;
+  width: 3px;
+  background-color: var(--accent-color);
+  border-radius: 0 2px 2px 0;
+}
+
+/* 折叠状态下的Logo文本 */
+.sidebar.collapsed .logo h1 {
+  opacity: 0;
+  transform: translateX(-20px);
+  width: 0;
+  visibility: hidden;
+  /* 确保完全隐藏，防止干扰布局 */
+  pointer-events: none;
+  /* 禁用交互，避免影响布局 */
+}
+
+/* 导航区域样式 */
+.nav-section {
+  display: flex;
+  flex-direction: column;
+  gap: 0;
+  /* wrapper 之间不需要 gap，由 nav-item 的 margin 控制 */
+  flex: 0 0 auto;
+  /* 不伸缩，根据内容大小 */
+  overflow: visible;
+  /* 导航项不滚动，保持常驻显示 */
+}
+
+.section-title {
+  font-size: 1rem;
+  color: var(--accent-color);
+  padding: 0.4rem 0.5rem;
+  /* 减小上下padding */
+  margin-bottom: 0.2rem;
+  /* 增大与下方按钮组的间距 */
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  transition: color 0.3s ease;
+}
+
+.section-title i {
+  font-size: 1.2rem;
+}
+
+/* 调整侧边栏折叠状态下的章节标题 */
+.sidebar.collapsed .section-title {
+  justify-content: center;
+  /* 统一与展开态的垂直间距 */
+  padding: 0.4rem 0;
+  text-align: center;
+  margin-bottom: 0.2rem;
+  /* 与展开态保持一致且更大 */
+}
+
+.sidebar.collapsed .section-title i {
+  margin: 0 auto;
+  font-size: 1.2rem;
+}
+
+/* 折叠状态下的导航项布局优化 */
+.sidebar.collapsed .nav-section {
+  gap: 0.4rem;
+  align-items: center;
+}
+
+.sidebar.collapsed .nav-item {
+  padding: 0;
+  justify-content: center;
+  width: 2.75rem;
+  /* 增大按钮方块尺寸 44px */
+  height: 2.75rem;
+  /* 增大按钮方块尺寸 44px */
+  text-align: center;
+  margin-left: auto;
+  margin-right: auto;
+  border-radius: var(--radius-md);
+  /* 略增圆角 */
+  display: flex;
+  align-items: center;
+  box-sizing: border-box;
+}
+
+.sidebar.collapsed .nav-item i {
+  font-size: 1.25rem;
+  width: auto;
+  margin: 0;
+  padding: 0;
+}
+
+.sidebar.collapsed .nav-item .icon-container {
+  margin: 0;
+  width: 100%;
+  height: 100%;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+}
+
+/* 折叠状态下的导航项文本 */
+.sidebar.collapsed .nav-item .nav-text,
+.sidebar.collapsed .nav-item .external-icon {
+  opacity: 0;
+  transform: translateX(-10px);
+  width: 0;
+  display: none;
+  /* 完全移除，防止干扰布局 */
+  visibility: hidden;
+}
+
+.nav-item {
+  display: flex;
+  align-items: center;
+  height: 44px;
+  padding: 0 0.9rem;
+  margin-bottom: 0.4rem;
+  /* 导航按钮之间的间距 */
+  color: var(--nav-item-color);
+  text-decoration: none;
+  border-radius: var(--radius-md);
+  transition:
+    background-color var(--transition-normal),
+    color var(--transition-normal),
+    box-shadow var(--transition-normal);
+  position: relative;
+}
+
+.nav-item-wrapper:last-child .nav-item {
+  margin-bottom: 0;
+  /* 最后一个导航按钮不需要底部间距 */
+}
+
+.nav-item .icon-container {
+  width: 24px;
+  height: 100%;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  margin-right: var(--spacing-md);
+  transition: margin var(--transition-normal);
+}
+
+.nav-item .nav-text {
+  flex: 1;
+  transition:
+    opacity var(--transition-normal),
+    transform var(--transition-normal);
+  white-space: nowrap;
+  overflow: hidden;
+}
+
+.nav-item .external-icon {
+  font-size: 0.9rem;
+  opacity: 0.6;
+  margin-left: 0.5rem;
+  transition: all var(--transition-normal);
+}
+
+.nav-item:hover {
+  background-color: var(--secondary-bg);
+  color: var(--text-bright);
+}
+
+.nav-item:hover .external-icon {
+  opacity: 1;
+  transform: translateX(2px);
+}
+
+.nav-item.active {
+  background-color: var(--secondary-bg);
+  color: var(--text-bright);
+}
+
+.nav-item i {
+  width: 20px;
+  text-align: center;
+}
+
+/* 折叠状态下：底部区域不可见且不可交互 */
+.sidebar.collapsed .sidebar-footer {
+  visibility: hidden;
+  pointer-events: none;
+}
+
+/* 主内容区域 - 修复滚动条问题 */
+main.content {
+  flex: 1;
+  margin-left: var(--sidebar-width);
+  padding: 1.5rem 1rem;
+  background-color: var(--bg-color);
+  position: relative;
+  height: var(--app-height, 100vh);
+  /* 固定高度（移动端避免 100vh 问题） */
+  overflow-y: auto;
+  /* 使用auto替代scroll，只在需要时显示滚动条 */
+  overflow-x: hidden;
+  width: calc(100vw - var(--sidebar-width));
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  /* 防止"有无滚动条"导致内容横向平移（支持的浏览器会稳定预留滚动条槽位） */
+  scrollbar-gutter: stable;
+  /* 自定义滚动条颜色（Firefox） */
+  scrollbar-width: thin;
+  scrollbar-color: var(--scrollbar-color) transparent;
+}
+
+/* 自定义滚动条（Chromium / Safari） */
+main.content::-webkit-scrollbar {
+  width: 8px;
+}
+
+main.content::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+main.content::-webkit-scrollbar-thumb {
+  background-color: var(--scrollbar-color);
+  border-radius: var(--radius-full);
+  /* 用透明边框制造"内边距"，更贴合卡片阴影风格 */
+  border: 2px solid transparent;
+  background-clip: content-box;
+}
+
+main.content::-webkit-scrollbar-thumb:hover {
+  background-color: var(--scrollbar-hover-color);
+}
+
+/* 回退：不支持 scrollbar-gutter 的浏览器，强制始终显示滚动条以避免横向抖动 */
+@supports not (scrollbar-gutter: stable) {
+  main.content {
+    overflow-y: scroll;
+  }
+}
+
+/* 优化内容区域在侧边栏折叠状态下的边距 */
+body main.content.expanded {
+  margin-left: var(--sidebar-collapsed-width);
+  width: calc(100vw - var(--sidebar-collapsed-width));
+}
+
+/* 仅在交互时启用布局相关过渡，避免首帧闪烁 */
+.with-anim .sidebar {
+  transition:
+    width 0.3s ease,
+    background-color 0.3s ease;
+}
+
+.with-anim main.content {
+  transition:
+    background-color 0.3s ease,
+    margin-left 0.3s ease,
+    width 0.3s ease;
+}

assets/styles/_variables.css

@@ -0,0 +1,147 @@
+/* ============================================
+   CSS Variables & Theme System
+   ============================================ */
+
+/* 主题颜色变量 - Apple Design System */
+:root {
+  /* 深色主题 (iOS Dark Mode Inspired) */
+  --bg-color: #000000;
+  /* Pure Black background */
+  --sidebar-bg: #1c1c1e;
+  /* System Gray 6 */
+  --secondary-bg: #2c2c2e;
+  /* System Gray 5 */
+
+  /* 卡片背景 - 仪表盘卡片 */
+  --card-bg-gradient-1: #1c1c1e;
+  --card-bg-gradient-2: #1c1c1e;
+
+  /* 站点卡片 - 提升亮度以区分层级 (Optimize: Use System Gray 5 for cards on black bg) */
+  --site-card-bg-gradient-1: #2c2c2e;
+  --site-card-bg-gradient-2: #2c2c2e;
+  --site-card-hover-bg: #3a3a3c;
+  /* System Gray 4 for hover */
+
+  /* 文字颜色 */
+  --text-color: #ffffff;
+  --text-muted: #8e8e93;
+  /* System Gray */
+  --text-bright: #ffffff;
+
+  /* 边框与阴影 */
+  --border-color: rgba(255, 255, 255, 0.12);
+  --shadow-color: rgba(0, 0, 0, 0.3);
+
+  /* 功能色 */
+  --highlight-bg: rgba(118, 148, 185, 0.3);
+  /* Restore original Highlight */
+  --scrollbar-color: rgba(255, 255, 255, 0.2);
+  --scrollbar-hover-color: rgba(255, 255, 255, 0.3);
+
+  /* 恢复原有强调色 (Restore Original Accent) */
+  --accent-color: #7694b9;
+  --accent-hover: #6684a9;
+  --accent-rgb: 118, 148, 185;
+
+  --nav-item-color: #98989d;
+  --success-color: #30d158;
+  --error-color: #ff453a;
+  --white-color: #ffffff;
+
+  /* 恢复原有渐变 (Restore Original Gradient) */
+  --gradient-color: linear-gradient(135deg, #7694b9 0%, #a855f7 50%, #ff6b6b 100%);
+  --gradient-color-simple: linear-gradient(135deg, #7694b9 0%, #a855f7 100%);
+
+  --sidebar-width: 240px;
+  --sidebar-collapsed-width: 60px;
+  --app-height: 100vh;
+
+  /* Spacing System */
+  --spacing-xs: 0.25rem;
+  --spacing-sm: 0.5rem;
+  --spacing-md: 1rem;
+  --spacing-lg: 1.5rem;
+  --spacing-xl: 2rem;
+  --spacing-2xl: 3rem;
+
+  --page-max-width: 1300px;
+
+  /* UI Tuning - Apple Style (Kept) */
+  --radius-sm: 6px;
+  --radius-md: 10px;
+  --radius-lg: 14px;
+  --radius-xl: 20px;
+  --radius-full: 9999px;
+
+  /* Transitions - Kept iOS Spring */
+  --transition-fast: 0.2s ease;
+  --transition-normal: 0.35s cubic-bezier(0.25, 1, 0.5, 1);
+  --transition-slow: 0.5s cubic-bezier(0.25, 1, 0.5, 1);
+  --transition-bounce: cubic-bezier(0.175, 0.885, 0.32, 1.275);
+
+  --card-bg-rgb: 28, 28, 30;
+}
+
+/* 浅色主题 - 恢复原有配色 (Restored Morandi/Warm) */
+html.theme-preload,
+body.light-theme {
+  --bg-color: #e0e0d8;
+  --sidebar-bg: #f0f0eb;
+  --secondary-bg: #e6e6e1;
+  /* Slightly darker than sidebar for hover state */
+  --card-bg-gradient-1: #f0f0eb;
+  --card-bg-gradient-2: #e9e9e4;
+  --site-card-bg-gradient-1: #ffffff;
+  --site-card-bg-gradient-2: #f4f5f0;
+  --site-card-hover-bg: linear-gradient(145deg, #fafaf8, #eef0eb);
+
+  --text-color: #333333;
+  --text-muted: #666666;
+  --text-bright: #000000;
+
+  --border-color: rgba(0, 0, 0, 0.08);
+  --shadow-color: rgba(0, 0, 0, 0.1);
+
+  --highlight-bg: rgba(118, 148, 185, 0.15);
+  --scrollbar-color: rgba(0, 0, 0, 0.1);
+  --scrollbar-hover-color: rgba(0, 0, 0, 0.2);
+
+  --accent-color: #7694b9;
+  --accent-hover: #6684a9;
+  --accent-rgb: 118, 148, 185;
+
+  --nav-item-color: #666666;
+  --success-color: #4caf50;
+  --error-color: #f44336;
+  --white-color: #ffffff;
+
+  /* Restore original gradients */
+  --gradient-color: linear-gradient(135deg, #7694b9 0%, #a855f7 50%, #ff6b6b 100%);
+  --gradient-color-simple: linear-gradient(135deg, #7694b9 0%, #a855f7 100%);
+
+  --card-bg-rgb: 240, 240, 235;
+}
+
+/* 预加载主题 - 在JS完全加载前显示正确的主题 */
+html.theme-preload body {
+  background-color: #e0e0d8;
+  color: #333333;
+}
+
+/* 预加载侧边栏状态 - 在JS完全加载前显示正确的侧边栏宽度 */
+html.sidebar-collapsed-preload .sidebar {
+  width: var(--sidebar-collapsed-width);
+}
+
+html.sidebar-collapsed-preload main.content {
+  margin-left: var(--sidebar-collapsed-width);
+}
+
+/* 控制页面预加载状态 */
+html.preload .layout {
+  opacity: 0;
+}
+
+html.preload * {
+  transition: none !important;
+}

src/generator/main.js

@@ -125,6 +125,65 @@ function generateHTML(config) {
   }
 }
 
+/**
+ * 使用 esbuild bundle 模式合并 CSS @import
+ * 注意：transformSync 不支持 bundle，必须用 buildSync
+ * @param {string} srcPath - 源 CSS 文件路径
+ * @param {string} destPath - 目标文件路径
+ * @returns {boolean} 是否成功
+ */
+function tryBundleCss(srcPath, destPath) {
+  let esbuild;
+  try {
+    esbuild = require('esbuild');
+  } catch {
+    return false;
+  }
+
+  try {
+    // buildSync 需要绝对路径
+    const absoluteSrc = path.resolve(srcPath);
+    const absoluteDest = path.resolve(destPath);
+
+    esbuild.buildSync({
+      entryPoints: [absoluteSrc],
+      outfile: absoluteDest,
+      bundle: true, // 关键：合并 @import
+      minify: true,
+      logLevel: 'silent',
+    });
+    return true;
+  } catch (error) {
+    const log = createLogger('assets');
+    log.warn('CSS bundle 失败，降级为复制', {
+      message: error && error.message ? error.message : String(error),
+    });
+    if (isVerbose() && error && error.stack) console.error(error.stack);
+    return false;
+  }
+}
+
+/**
+ * 递归复制目录（降级方案：当 esbuild 不可用时复制 styles 目录）
+ * @param {string} src - 源目录
+ * @param {string} dest - 目标目录
+ */
+function copyDirRecursive(src, dest) {
+  if (!fs.existsSync(src)) return;
+  fs.mkdirSync(dest, { recursive: true });
+
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
 function tryMinifyStaticAsset(srcPath, destPath, loader) {
   let esbuild;
   try {
@@ -162,10 +221,13 @@ function copyStaticFiles(config) {
     fs.mkdirSync('dist', { recursive: true });
   }
 
-  // 复制 CSS 文件
+  // 复制 CSS 文件（支持模块化 @import）
   try {
-    if (!tryMinifyStaticAsset('assets/style.css', 'dist/style.css', 'css')) {
+    if (!tryBundleCss('assets/style.css', 'dist/style.css')) {
+      // 降级：复制入口 + styles 目录
       fs.copyFileSync('assets/style.css', 'dist/style.css');
+      copyDirRecursive('assets/styles', 'dist/styles');
+      log.warn('CSS 未合并，浏览器将发起多个请求');
     }
   } catch (e) {
     log.error('复制 style.css 失败', { message: e && e.message ? e.message : String(e) });

templates/README.md

@@ -143,6 +143,7 @@ templates/
 **主要组件**:
 
 - `page-header.hbs` - 统一页面标题区（首页/非首页/书签更新时间/项目热力图）
+- `home-dashboard.hbs` - 首页仪表盘（时钟卡片、TODO 待办卡片）
 - `navigation.hbs` - 导航菜单
 - `site-card.hbs` - 站点卡片
 - `category.hbs` - 分类容器（支持多层级嵌套）