配置管理#
工具会读取 src/config 下的主要配置文件，并把常用设置做成表单：
左侧导航栏可以折叠，适合在小屏幕或编辑长配置时腾出更多横向空间。
-
站点与 SEO：标题、副标题、站点 URL、语言、描述、关键词、favicon、建站日期、时区、OpenGraph、分享海报、最后修改时间。
-
主题与布局：主题色、默认亮暗模式、页面宽度、卡片边框、分类栏、文章列表布局、分页、图片优化。
-
首页与壁纸：banner / overlay / none 模式、桌面和移动端壁纸、首页标题和副标题、打字机、署名、透明导航栏、轮播、水波、遮罩透明度。
-
导航与页面：导航 Logo、导航标题、菜单对齐、粘性导航栏、搜索方式、朋友页、赞助页、留言页、Bangumi、画廊、侧边栏组件。
-
导航栏高级配置：navBarConfig.ts 中 getDynamicNavBarConfig() 的基础 links 数组和后续 links.push(...) 动态追加逻辑都可以在“导航与页面”页直接编辑，支持 LinkPreset.*、自定义链接、多级菜单、外链和图标。
-
个人资料：头像、名称、简介、社交链接、许可证、页脚配置、页脚 HTML。
-
内容组件：公告、随机封面、友链、画廊、赞助、广告。
-
评论系统：none、Twikoo、Waline、Giscus、Disqus、Artalk 及其详细参数。
-
音乐播放器：Meting、本地播放列表、平台、歌单 ID、音量、循环模式、歌词、备用 API。
-
外观增强：字体、樱花、Live2D / Spine、代码块、PlantUML。
-
统计分析：Google Analytics、Microsoft Clarity、Umami、Relpays、51la。
新版 Firefly 的部分配置支持多种写法，例如壁纸 src 可以是字符串、数组或 { desktop, mobile } 对象，Banner 署名、水波、Overlay 可切换项也可以是布尔值或桌面/移动端对象。管理器会优先提供直观字段，同时保留“完整配置”编辑框，方便处理这些联合类型结构。
新版 siteConfig.ts 顶部使用 SITE_LANG 常量定义站点语言，表单里的“站点语言”会直接读写这个常量，不再把底部 lang: SITE_LANG 改成固定字符串。
新版 navBarConfig.ts 的导航链接由 getDynamicNavBarConfig() 动态生成，普通表单只管理搜索方式和页面开关。若要调整复杂导航层级、自定义菜单或动态逻辑，请到“源码编辑”页打开 navBarConfig.ts 修改原始 TypeScript。
如果某些设置过于复杂，或者配置文件中有动态函数，可以到“源码编辑”页直接修改原始 TypeScript / HTML。
新版进一步把赞助方式、赞助者列表、广告、看板娘、页脚开关等配置做成了结构化表单，减少直接写 JSON 的情况。
如果某个配置字段在当前文件中没有显式写出，但类型定义允许它作为可选字段存在，管理器会先显示一个默认空值；修改后会自动把该属性插入到对应配置对象中。这样上游新增的可选字段不会再因为“未找到”而只能去源码页手改。
上游近期把樱花特效配置从 sakuraConfig.ts 重命名并集中到 effectsConfig.ts，壁纸配置也把首页文字、导航透明、水波和渐变等通用项移动到了 backgroundWallpaper.common.*，并新增 fullscreen 壁纸模式。当前管理器已按这些新字段读取和写入。
侧边栏组件数组支持编辑组件类型、启用状态、位置、文章页/非文章页显示、广告配置 ID、响应式隐藏设备、折叠阈值和自定义属性。复杂对象仍可通过对应完整配置或源码页兜底编辑。
备份恢复#
每次点击“保存全部修改”前，工具会在仓库根目录创建备份：
.firefly-config-manager-backups
备份包含一个 JSON manifest 和对应文件的 .bak 内容。manifest 会记录本次保存前备份的原因、涉及文件，以及每个文件对应的改动说明；为了避免泄露文章密码、API token 等内容，说明只记录字段名和来源，不记录具体新旧值。界面中的“备份恢复”页可以按保存会话整体恢复，并显示这些改动说明。
保存前可以在右上角填写“备份名称”。名称会写入 manifest，也会作为安全化后的片段加入备份文件名，方便在 .firefly-config-manager-backups 文件夹中直接识别。备份页支持重命名和删除备份；删除会同时移除 manifest 和对应的 .bak 文件。
备份页支持全选、取消选择和批量删除。批量删除会并行移除选中会话的 manifest 和 .bak 文件，适合清理多次试错产生的备份。
为减少保存卡顿，保存后不会重新全量扫描配置和文章；只会清空当前脏状态、追加本次备份会话并刷新当前界面。多个待保存文件和备份文件会并行写入。
恢复备份前，工具还会再创建一次“恢复前备份”，用于避免误恢复后无法找回当前状态。
说明：旧版本工具曾把备份放在 src/config/.firefly-config-manager-backups，新版不会删除旧备份，但“备份恢复”页只管理新版根目录备份。
