Sidebar Widgets

Sidebar-Widgets

侧栏由 sidebarConfig.ts 的左右组件列表驱动；每个条目有 type + enable。
出厂类型表：docs/official/02-基础配置/侧边栏.md、侧边栏小组件.md。

本站在官方类型之外加了若干 widget（花园笔记、热门、多层时钟、礼盒相关等）——以 sidebarConfig 与 src/components/widget/ 为准；type 字符串必须能映射到组件，否则侧栏装配会断。

改侧栏的一般步骤

1. 打开 src/config/sidebarConfig.ts
2. 调整 leftComponents / rightComponents 顺序与 enable
3. 某组件的细项：看官方「侧边栏小组件」+ 本站对应 *Config.ts
4. pnpm dev 看左右栏

公告「不期而至」+ 节日礼盒（fork）

官方 05-扩展功能/公告.md 只有静态 title / content / link。
本站公告标题常为「不期而至」，并增加 loveLetter 惊喜信封：

配置：src/config/announcementConfig.ts

键	作用
title / content / link	常规公告（与官方同构）
loveLetter.enable	是否显示惊喜入口
loveLetter.version	期号；换文案务必 bump，访客「已开启」按期号存 localStorage
loveLetter.heading / message	信封标题与正文
loveLetter.note	入口提示短句

交互约定（改 UI 时遵守）：

1. 常驻：3D 礼盒缓慢自转
2. 悬停：同形态轻晃（不切酒红包装盒）
3. 点击：confetti → 拆盒 → 全屏信封 → 「我已阅读」/Esc → 收起 → 粒子 → 侧栏卡高度收合

实现入口：Announcement.astro · src/components/widget/gift/* · gift-surprise.css。

音乐侧栏

即使 musicPlayerConfig.showInSidebar: true，仍要在 sidebarConfig 里有 type: "music" 且 enable。
本站可能关掉侧栏音乐、只留顶栏音符——以现行配置为准。见 Music-Player。

日历备用封面（fork）

侧栏日历若启用封面 GIF，仓库内备有 style-17 库存（路径以现行为准）：

public/assets/images/widgets/calendar/stock/（含 stock-*.gif 与 README）

换季或缺封面时可先用库存，不必立刻生图。

标签墙 listOnly（移动底栏）

Tags 组件支持 listOnly：只出列表、不 SSR 那份 TagChalkSphere 立体球巨型脚本。移动底栏（side: "bottom"）的标签默认走列表态，避免与左栏重复挂一份球体。改标签墙时注意别把这个分支删了。

官方文档怎么用

标准 widget 的 specificConfig 键 → 官方两篇侧栏文档。
礼盒 / 花园笔记 / 多层时钟等 → 只看本站配置与组件，别在官方篇里找。