v1.2.0

本次更新全面重构后台管理设置体系，将配置中心重组为八大独立板块，提供全宽与居中布局切换及统一表单规范；新增关于页并支持国内 AtomGit 镜像源检查更新；悬浮工具栏支持悬停展开与自动收起，进一步提升前台浏览的沉浸感与日常操作效率。

亮点

• 管理设置体系重构：重组为通用、外观、分类、搜索、素材、账号安全、数据备份与关于八大板块，支持全宽与居中布局切换
• 独立关于与更新中心：集中展示版本信息、运行环境与发布记录，支持通过国内 AtomGit 镜像加速检查更新并提供一键升级命令
• 账号安全与数据中心独立：账号与安全从通用页独立，密码设置支持显隐切换与高强度校验；数据备份与危险恢复独立分区
• 悬浮工具栏悬停展开：前台工具栏默认轻量收起为单图标，鼠标悬停或键盘聚焦时平滑展开，触屏设备自动保持常显
• 统一表单规范与保存反馈：引入行级设置规范与轻量选项卡，配置即时保存并支持撤销，交互响应更流畅

管理后台与设置

• 后台设置划分为通用、外观、分类、搜索、素材、账号与安全、数据与备份、关于八大板块，侧栏支持分组导航
• 设置页顶部新增布局切换控件，支持在全宽铺满工作区与受控居中之间自由切换
• 新增独立「关于」设置页，集中呈现官方入口、系统运行规格、核心组件版本与历史亮点
• 版本更新检测新增「国内镜像加速」开关，国内服务器可通过 AtomGit 镜像仓拉取发布信息
• 发现新版本时展示推荐的容器升级命令，支持一键复制到剪贴板
• 新增独立「账号与安全」设置页，提供密码明暗文切换显示，并对新密码强化 8 位长度校验
• 新增独立「数据与备份」设置页，将一键整包导出与全量数据恢复隔离至安全分区，危险操作采用警告视觉呈现
• 规范表单与设置行设计体系，引入 SettingRow 与 OptionTile，优化保存反馈与撤销提示
• 优化管理员与游客的主题端云偏好对齐机制，收敛账号缓存请求

交互与体验

• 主页悬浮工具栏在桌面端默认收起为单图标，鼠标悬停或键盘获得焦点时自动展开，移开后平滑收起
• 触屏移动设备自动保持悬浮工具栏常驻展开，确保功能入口完整可用
• 设置页面移除浮动工具栏并隐藏内容区滚动条，页面排版更清爽专注
• 搜索引擎管理列表支持实时标记当前默认引擎，拖拽排序更直观

部署与运维

• 优化本地与容器数据库初始化逻辑，为缺少 DATABASE_URL 的环境提供默认 SQLite 路径回退
• 数据库种子数据写入前自动生成 Prisma 客户端，防止初始化流程报错退出
• 发版脚本与 Release 同步流水线支持 AtomGit 官方镜像仓，发版时同步推送代码与发行说明

v1.1.0

本次更新全面升级界面自适应与排版对齐体系，支持游客自定义外观与本地私有壁纸，新增低版本浏览器兼容探针与内网离线安装包引导，并将核心依赖与运行环境全面升级至 Node.js 24 Active LTS。

亮点

• 界面显示密度与自适应：支持按屏幕分辨率自动缩放，也可在外观设置中选择紧凑、标准或宽松模式
• 游客自定义外观与壁纸：未登录也能调整外观和切换预置壁纸，并支持从本地电脑上传仅自己可见的私有壁纸
• Widget 小组件栏与卡片网格同宽对齐：首屏两个区块宽度一致、左右边界对齐，窗口缩放同步自适应
• 低版本浏览器兼容拦截与离线引导：内核探针自动检测特性支持，为纯内网环境内置离线浏览器安装包下载
• 核心依赖与运行环境升级：全阶段基础镜像升级至 Node.js 24 Active LTS，全面迁移至 React 19.3 与 TypeScript 7

界面与布局

• Widget 小组件栏改用与卡片网格相同的宽度，居中显示并与卡片左右边界对齐
• 优化不同屏幕尺寸下的页面留白，大屏与宽屏下内容居中排版更协调
• 新增界面显示密度设置，提供自动（按分辨率自适应）、紧凑、标准、宽松四档切换
• 优化网址卡片宽度与图标比例，修复四周留白过大问题，卡片标题支持 6 个汉字完整单行显示
• 修复各显示密度档位下卡片网格列数自适应问题

外观与交互

• 未登录的游客也可以打开「外观」面板调整主题、字体和壁纸，修改仅保存在当前浏览器
• 游客支持上传本地电脑中的图片作为壁纸，刷新页面后仍然有效
• 游客外观面板底部新增「恢复默认」按钮，可一键还原为站长设置的全局外观
• 右上角悬浮工具栏改为常态展开，常用功能一步直达，省去额外点击

兼容与离线引导

• 新增浏览器内核特性检测探针，低版本内核访问时自动重定向至引导页
• 新增纯静态离线提示页，自动识别当前操作系统并提供 Chrome、Edge、Firefox 离线安装包下载
• 离线引导页提供「暂不升级，继续访问」选项，支持在受限环境下临时跳过提示
• 新增离线浏览器安装包拉取脚本并修复容器部署挂载缺失，支持纯内网环境一键离线部署

网络与服务状态

• 修复点击切换内网/外网模式后卡片跳转链接没有立即刷新的问题
• 改进服务在线状态检测，兼容更多类型的返回状态码，避免带防火墙的服务被误判离线
• 修复卡片未填内网或外网地址时可能点击打开空白页的问题

安全与依赖

• Docker 容器基础镜像与开发环境全面升级至 Node.js 24 Active LTS，升级 Next.js 16.4
• 升级 React 19.3 与 TypeScript 7.0.2 编译环境
• 升级 Prisma 数据库引擎与适配器全套至 7.10.0 最新稳定版
• 升级 Astryx 组件库与中性主题至 0.6.8
• 修正 sharp 与 source-map-js 传递依赖版本，实现 npm 漏洞检测零风险

部署与运维

• 镜像构建流水线改为原生双架构矩阵：linux/arm64 改用 GitHub 原生 arm64 运行器，不再经 QEMU 模拟，与 amd64 并行构建后合并多架构清单
• 构建缓存由 Actions 缓存切换为镜像库缓存并按架构隔离，跨版本复用，缩短发布构建耗时
• 发布工具链升级：action 全部升至 Node 24 对应版本，运行器固定 Ubuntu 24.04，消除 GitHub 弃用与迁移告警

v1.0.0

首个正式版本。自托管服务导航站的核心能力在这一版全部就位：卡片化服务导航、Docker 容器与主机资源监控、内外网双地址自动切换、小组件自由布局、全局搜索、PWA 离线访问与安全防护。

亮点

• 卡片化服务导航：拖拽排序、分类管理、批量删除与撤销，支持浏览器链接直接拖入或粘贴创建
• Docker 容器与系统资源监控：NAS 状态总览、CPU / 内存 / 磁盘水位实时呈现，集成 qBittorrent 做种感知
• 内外网双地址自动切换：每张卡片可配内网与外网双地址，根据网络策略自动跳转至可达地址
• 小组件自由布局与外观快捷面板：4 列网格自由摆放并持久化坐标，一键唤出面板随心调节主题、字体与壁纸
• PWA 离线与服务端安全防护：静态资源本地离线缓存，出站请求安全网关拦截回环与元数据探测

导航与卡片

• 分类化的服务卡片网格，支持分类与卡片拖拽排序、批量删除与撤销
• 编辑模式支持将卡片拖入空分类并显示放置预览，支持快捷增删分类
• 每张卡片可同时配置内网 / 外网地址，配合网络策略自动跳转到可达地址
• 在线状态灯按 60 秒轮询刷新，显示在线（实心绿点）/ 离线（空心红环），未知状态不显示标记
• 浏览器链接可直接拖入页面或 ⌘ / Ctrl + V 粘贴创建卡片，优先抓取网站标题与 favicon
• 卡片支持新标签页 / 弹框 iframe 两种打开方式，弹框尺寸可四向拖拽并持久化

Widget 小组件

• 实例化 Widget 系统：同一类型可重复添加多个实例，独立配置顺序与 S / M / L 尺寸
• Widget 栏支持自由拖拽布局并记录绝对坐标，窄屏自适应单列紧凑排布
• NAS 状态：聚合展示 Docker 容器总览
• 资源水位：CPU / 内存 / 磁盘 IO，5 秒自动刷新
• qBittorrent：下载 / 上传速度与做种统计，接入 sync/maindata 实时呈现下载目录剩余空间
• 倒数日 / 正数日：每个实例维护一个日期项，倒数日可设每周 / 每月 / 每年重复

搜索与外观

• ⌘ / Ctrl + K 全局搜索面板，支持子串、拼音与首字母缩写匹配
• 顶部搜索框可配置多个搜索引擎并排序，内置 5 个引擎
• 头像菜单新增外观入口，打开快捷面板即可调整主题、字体、壁纸与遮罩
• 明亮 / 暗黑 / 跟随系统三种主题，12 张内置壁纸与自定义壁纸上传
• 全新品牌 Mark 标识，全站品牌标识符采用专用字体呈现
• 全局字体大小 90%–150% 可调，网格自适应排版

离线与安全

• 支持 PWA 离线兜底：静态资源本地离线缓存，断网时仍可打开导航页并支持安装至主屏幕
• 服务端请求安全网关：抓取图标与外链探测增加安全防护，拦截云元数据与回环地址探测
• 首页免登录模式：支持配置公开只读访问，兼顾访客查阅与后台管理安全
• 游客免登录模式下自动隐藏敏感服务小组件并放行公共静态资源

集成与数据

• 图标来源三选一：内置图标库、上传自定义图标、favicon 自动抓取
• 一键导出配置数据与上传文件为 zip，支持导入恢复到任意实例
• 单用户账号认证（Credentials + JWT，30 天有效期）

部署与运维

• 官方开源渠道与凭据标准化，解耦 GITHUB_TOKEN 代码发版与 GHCR_TOKEN 镜像推送权限
• 新增 GitHub Actions 工作流，监听版本标签自动构建并分发多架构容器镜像至 GHCR
• 官方镜像默认提供 GHCR 与 Docker Hub 双源，支持自建私有平台（MIRROR_*）镜像同步
• 容器启动自动完成数据库迁移与种子写入，数据持久化在宿主机 ./data
• 自动探测 Docker socket 属组；DOCKER_GID / PUID / PGID 在 .env 设置生效
• 无鉴权健康检查端点 /api/health，已接入容器 HEALTHCHECK
• 重构轻量化镜像同步工具 image:sync 与 release:sync / release:check 多仓发布核验工具
• 拆分重构《用户指南》与《管理指南》，全量对齐架构与部署文档矩阵

开发与质量

• Next.js 16（App Router + Turbopack） + React 19 + Astryx 组件库 + Tailwind CSS v4
• Prisma 7 + SQLite（libsql driver adapter），单一初始迁移即可建库
• Biome 统一 lint 与格式化，react-doctor 扫描 React 反模式
• 提交信息遵循 Conventional Commits（type 英文、scope 中文模块名、描述中文）