SakuraNav

简体中文

English

简体中文

English

Appearance

更新日志 ​

[1.8.0] - 2026-05-17 ​

✨ 新功能 ​

  • 悬浮快捷新建按钮 — 新增悬浮快捷新建按钮，支持快速创建网站、社交、笔记三类卡片
  • 移动端底部固定按钮栏 — 移动端悬浮按钮改为底部固定操作栏，提升触屏操作体验
  • 移动端设置弹窗响应式优化 — 设置弹窗 Tab 导航改为卡片滑块式交互，修复面板溢出问题
  • 标签栏搜索过滤 — 标签栏新增搜索过滤功能，标签视图顶部增加提示横幅
  • 网站详细信息查看弹窗 — 右键菜单新增「查看详情」选项，统一右键菜单项图标样式
  • AI 标签关联分数展示 — AI 分析结果展示标签关联分数，智能跳过已有标签的重复推荐
  • MCP 社交卡片 hint 字段 — MCP update_social_card 工具支持修改 hint 字段
  • 全局自定义滚动条 — 新增全局自定义滚动条样式，替代浏览器默认滚动条
  • 第三方登录配置面板重构 — OAuth 配置面板重构为列表+独立编辑弹窗模式
  • 内容标题栏精简 — 移除内容标题栏的视图标签和卡片计数显示

🐛 Bug 修复 ​

  • 社交卡片跳转失败 — 修复社交卡片点击跳转失败的问题
  • URL 校验与补全优化 — 移除输入层 URL 校验与自动补全，改为跳转时按需补全协议前缀
  • 备选 URL 编辑校验 — 备选 URL 编辑弹窗增加即时校验和协议自动补全
  • 虚拟标签排序丢失 — 修复虚拟标签刷新后排序丢失的问题
  • 连续拖拽排序失败 — 修复连续拖拽排序失败的问题
  • MCP 笔记卡片参数 — 移除笔记卡片 MCP 工具的无效标签关联参数
  • 暗黑模式图标反转 — 移除暗黑模式下网站卡片图标的颜色反转效果
  • AI 关联网站推荐为空 — 修复 AI 全部分析时关联网站推荐为空的问题
  • 快捷新建按钮 tooltip — 快捷新建按钮折叠态不再误显 tooltip
  • 透明背景文字图标 — 透明背景文字图标在亮色模式下使用黑色文字
  • 默认主题调整 — 默认主题从跟随系统偏好改为明亮模式，种子数据同步更新
  • 移动端壁纸显示 — 修复移动端壁纸显示不全的问题
  • 移动端弹窗布局 — 弹窗在移动端垂直居中，优化布局层级
  • 主题水合不一致 — 修复 SSR/客户端主题水合不一致导致的 Hydration Mismatch 错误
  • 账号密码空格 — 禁止注册账号密码包含空格，登录时自动去除前后空格
  • 弹窗黑框伪影 — 修复弹窗遮罩层 backdrop-blur 导致的多处黑框渲染伪影
  • 笔记卡片删除撤销 — 修复从列表删除笔记卡片时无法撤销的问题
  • 即时在线检测 — 修复即时在线检测 API 参数名不匹配导致卡片状态不刷新
  • CSRF Token 缺失 — 修复前端多处 API 调用未携带 CSRF Token 的问题

[1.7.5] - 2026-05-10 ​

✨ 新功能 ​

  • API Token 认证 — 新增 API Token 系统，支持创建、管理和吊销 Token，用于 MCP 和第三方集成
  • MCP 协议支持 — 新增 MCP (Model Context Protocol) 支持，允许 AI Agent 通过标准协议操作导航站，同时兼容 Streamable HTTP 和 SSE 两种传输协议
  • MCP 工具集 — 提供标签、网站卡片、社交卡片、笔记卡片、快照、搜索等完整 MCP 工具，支持 CRUD、排序、批量操作
  • 操作日志 — 为 API 和 MCP 写操作添加操作日志记录
  • 在线检查集成 — API/MCP 创建或更新网站时自动触发在线检查
  • 全部卡片导航 API — 新增 GET /api/navigation/cards 返回全部类型卡片（网站+社交+笔记）
  • 虚拟标签说明 — 标签 API 响应体和 MCP 工具返回中添加虚拟标签说明，标注其特殊行为
  • 自动化测试 — 新增 API 和 MCP 自动化测试脚本（Python 标准库，无额外依赖）

🐛 Bug 修复 ​

  • 数据导入签名校验 — 使用跨实例共享密钥替换实例独有 sessionSecret，修复跨实例导入签名校验失败
  • MCP 更新语义 — 将 MCP update 工具从 PUT 语义改为 PATCH 语义，只修改传递的字段

🔧 改进 ​

  • 数据层重命名 — 统一数据层命名 Site→Card，按卡片类型拆分 API 路由，字段语义化重命名
  • MCP 工具精简 — 移除 get_settings 和 get_profile 工具，减少不必要的信息暴露；标签管理拆分为 list_tags（含虚拟标签）和 list_site_tags（仅网站标签）
  • 图标优化 — 更新浏览器标签页和站点默认图标，大幅减小体积

[1.7.1] - 2026-05-08 ​

🔧 改进 ​

  • Docker 构建修复 — 升级基础镜像至 Node.js 22，改用 npm install 替代 npm ci 解决 lock file 版本不兼容问题
  • CI 修复 — 修正 Release 工作流中 changelog 文件路径大小写问题
  • README 优化 — 新增在线体验链接

[1.7.0] - 2026-05-08 ​

✨ 新功能 ​

  • Webhook 通知系统 — 新增通知配置功能，支持 Webhook 通知渠道的创建、编辑、测试和管理，站点离线时自动推送通知
  • 站点离线通知 — 站点离线时触发 Webhook 通知，支持按站点独立开关控制
  • URL 在线状态缓存 — 新增 url_online_cache 缓存表，相同 URL 多站点共享检查结果，20 小时内免重复检查
  • 在线检查定时调度 — 新增 OnlineCheckScheduler，每天 4 AM 自动批量检查并含重试机制
  • 首次加载自动在线检查 — 首次初始化后自动触发批量在线检查并刷新前端状态
  • 即时检测重试机制 — 单站点即时在线检测失败时自动重试，新增检测中 UI 状态

🐛 Bug 修复 ​

  • 首次加载重复在线检查 — 修复首次加载时重复触发批量在线检查的问题
  • GitHub/抖音图标暗黑模式不可见 — 修复社交卡片中 GitHub 和抖音图标在暗黑模式下不可见
  • 标签行截断溢出 — 修复标签行截断时部分标签被溢出隐藏的问题
  • 关联双向缓存刷新 — 移除锁定和允许被关联功能，修复双向关联缓存刷新异常
  • 虚拟标签关联限制 — 禁止网站卡片关联社交卡片和笔记卡片虚拟标签
  • 虚拟标签注入与搜索引擎种子 — 统一虚拟标签注入逻辑并添加搜索引擎种子数据
  • 切换用户弹窗 — 支持双击快速切换并同步最新头像

🔧 改进 ​

  • 备选 URL 简化 — 简化备选 URL 功能，移除自动/条件模式和开关机制，改为直接展示
  • 编辑器 UI 优化 — 移除备选 URL 和关联网站的折叠按钮改为直接展示；优化 AI 可读开关为带标签按钮
  • 导出选项简化 — 导出选项简化为全部卡片/仅网站卡片，快照仅记录卡片和标签
  • 快照去重 — 创建快照前与最新快照比较数据，相同时跳过避免冗余
  • 开发文档完善 — 新增 VitePress 文档站点的中英文完整开发文档

[1.6.5] - 2026-05-05 ​

✨ 新功能 ​

  • 笔记卡片 — 全新笔记卡片模块，支持 Markdown 编辑预览、图片/文件粘贴上传、图片灯箱、附件管理、引用网站卡片并自动同步 Todo，支持定位与底色区分
  • 多数据库支持 — 支持 SQLite / MySQL / PostgreSQL 一键切换，新增 DatabaseAdapter 统一 API 和 SQL 方言层
  • 版本历史快照 — 新增版本历史快照功能，支持创建、恢复和删除快照，误操作一键回退
  • 虚拟标签拖拽排序 — 虚拟标签（全部卡片、社交卡片）支持拖拽排序并持久化位置，默认出现在标签栏顶部
  • 在线检查触发优化 — 在线检查仅在新建站点、URL 变更或访问控制字段变更时触发，减少不必要的检查请求
  • AI 分析关联网站重置 — AI 分析时始终重置非锁定的关联网站，由 AI 重新推荐并自动勾选双向关联

🐛 Bug 修复 ​

  • 导出导入关联网站丢失 — 修复导出/导入遗漏关联网站数据导致无法恢复
  • 编辑后显示未刷新 — 修复卡片编辑后显示未立即更新并补全导出关联推荐数据
  • 多用户数据隔离 — 修复多用户场景下站点数据查询未按用户隔离的问题
  • scrypt 内存超限 — 降低 scrypt 成本因子修复内存超限错误
  • 安全加固 — 加固 CSRF/SSRF/XSS 防护、速率限制、Token 吊销等多项安全机制
  • 编辑弹窗关闭页面跳动 — 修复编辑弹窗关闭时页面跳动、附件下载校验和表单变更检测问题

🔧 改进 ​

  • Session Secret 独立存储 — session secret 改为独立 .secret 文件，不再修改配置文件
  • 编辑器刷新策略 — 优化单个卡片编辑后的刷新策略，消除在线检测引起的二次全量刷新
  • UI 优化 — 统一主页标题为"全部卡片"，新建弹窗选项按钮精简并显示描述提示
  • 渲染稳定性 — 优化 backdrop-filter 渲染稳定性与过渡动画精确化
  • 启动横幅 — 重构启动 banner 为统一脚本，动态读取版本号展示
  • 种子数据更新 — 使用当前数据库实际数据更新种子数据

[1.6.0] - 2026-05-03 ​

✨ 新功能 ​

  • 网站备忘便签 — 为网站添加备注和待办列表，Todo 项在卡片上显示角标，支持 AI 可读开关
  • AI 工作流助手 — 新增 AI 工作流助手功能，AI 辅助自动化任务
  • 关联推荐 — 网站卡片支持关联推荐，基于 AI 分析推荐相关站点，推荐上下文参与站内搜索
  • 访问控制规则 — 新增备选 URL、右键菜单、互斥悬浮窗等访问控制规则
  • 右键菜单 — 网站卡片支持右键快捷操作菜单
  • 备选 URL — 为网站设置备选访问地址，支持条件自动切换
  • 数据导出/导入增强 — 支持仅网站卡片导出/导入、HMAC 签名校验、AI 分析并移除重复项
  • 标签编辑双 Tab — 标签编辑弹窗改为基本信息与关联网站双 Tab 布局，支持关联网站绑定与撤回
  • 站点级在线检测 — 在线检测从全局设置改为站点级别配置，支持超时时间、判定模式、连续失败阈值
  • 重复 URL 检测 — 创建网站时自动检测重复 URL 并提示
  • 重复卡片增强 — 增强重复卡片提示，支持直接编辑、删除和跳转到已有卡片
  • 快速搜索过滤 — 用户管理、标签关联网站、书签导入列表均支持快速搜索过滤
  • 用户名密码校验增强 — 增强用户名和密码的格式校验规则
  • 自定义 Tooltip — 新增 Tooltip 组件替代原生 title 属性，悬浮提示体验更佳

🐛 Bug 修复 ​

  • 撤销失败修复 — 修复标签与网站同时删除时撤销失败的问题，统一撤销系统可扩展性约束
  • 搜索闪烁修复 — 修复搜索过程中闪烁无关卡片，统一搜索结果卡片样式
  • 图标选中状态 — 修复切换 Tab 后图标选中状态丢失
  • Tooltip 定位失效 — 修复 Tooltip 组件因 display:contents 导致定位失效
  • 备选 URL 开关 — 修复备选 URL 开关逻辑，优化拖拽和菜单交互

🔧 改进 ​

  • 前端架构重构 — 主应用组件拆分为 Composition Root 架构，消除 props drilling，提升可维护性
  • 统一 AI 分析入口 — 统一 AI 分析入口，移除废弃关联分析 API
  • 移除 AI 助手浮动按钮 — 移除主页右下角 AI 助手浮动按钮
  • 搜索性能优化 — 优化首次搜索性能
  • 卡片匹配策略 — 统一数据导入中的卡片匹配策略，动态化导入构建，增强可扩展性

[1.5.5] - 2026-04-27 ​

✨ 新功能 ​

  • 多用户注册登录 — 支持多用户注册与登录，每位用户拥有独立的数据空间
  • 用户数据隔离 — 标签、网站、外观配置等数据按用户隔离，管理员与游客共享公开数据
  • 切换用户 — 新增切换用户弹窗，支持免密码快速切换、添加/删除用户，提供专用注册页
  • 个人空间 — 新增个人空间页面，支持用户资料管理、头像上传和密码修改
  • 注销账号 — 支持用户自主注销账号，彻底删除个人数据
  • OAuth 第三方登录 — 实现 OAuth 第三方登录系统，支持 GitHub、微信、企业微信、飞书、钉钉
  • 第三方账号绑定 — 个人空间支持绑定/解绑第三方账号，切换用户弹窗支持第三方登录
  • OAuth 管理面板 — 管理面板新增 OAuth 配置管理，支持在线配置和连通性测试
  • AI 模型在线配置 — AI 模型配置从配置文件迁移到管理面板，支持在线切换模型和供应商
  • 通知系统 — 新增站内通知系统，支持系统公告和用户通知

🐛 Bug 修复 ​

  • 修复标签排序丢失 — 修复多用户场景下标签排序可能错乱
  • 修复搜索结果分页 — 修复搜索结果与分页加载冲突

🔧 改进 ​

  • 数据库架构升级 — 所有表增加 user_id 字段，支持多用户数据隔离
  • 认证系统增强 — JWT + HttpOnly Cookie 双重认证，新增 Token 吊销机制
  • 权限控制细化 — 区分管理员、普通用户和游客三种角色权限

[1.5.0] - 2026-04-20 ​

✨ 新功能 ​

  • AI 智能分析 — 接入 AI 模型，支持自动分析网站并生成描述和关键词
  • 书签智能导入 — 支持导入浏览器书签 HTML 文件，AI 辅助分类
  • 社交卡片 — 新增社交平台卡片类型，支持 12 种主流社交平台
  • 卡片详情页 — 社交卡片支持独立详情页展示
  • 壁纸管理增强 — 支持多壁纸管理、壁纸分类和收藏

🐛 Bug 修复 ​

  • 修复拖拽排序异常 — 修复快速拖拽时排序错乱
  • 修复主题切换闪烁 — 修复明暗主题切换时页面闪烁

🔧 改进 ​

  • 性能优化 — 引入 React Compiler，自动优化渲染性能
  • 代码质量 — 全面引入 Zod Schema 校验，增强类型安全

[1.4.0] — 2026-04-10 ​

✨ 新功能 ​

  • 备忘便签 — 为网站添加备注和待办列表
  • 网站在线检测 — 批量检测网站可访问性
  • 数据导出导入 — 支持 ZIP 格式的完整数据导出和导入
  • 浏览器书签导入 — 支持从 Chrome/Firefox/Safari 导入书签

🔧 改进 ​

  • 数据库优化 — SQLite 启用 WAL 模式提升并发性能
  • UI 优化 — 优化移动端适配和动画流畅度

[1.3.0] — 2026-03-25 ​

✨ 新功能 ​

  • 自定义壁纸 — 支持上传自定义壁纸和通过 URL 设置壁纸
  • 毛玻璃效果 — 桌面端和移动端可独立开关卡片毛玻璃效果
  • 字体预设 — 三种字体预设（Space Grotesk / Noto Serif SC / Noto Sans SC）
  • Logo 自定义 — 支持上传自定义 Logo 和 Favicon

🔧 改进 ​

  • 渲染优化 — 优化 backdrop-filter 渲染稳定性
  • 动画优化 — 精确化过渡动画

[1.2.0] — 2026-03-10 ​

✨ 新功能 ​

  • 隐藏标签 — 可设置隐藏标签，仅登录后可见
  • 网站置顶 — 支持网站置顶显示
  • 搜索增强 — 多引擎搜索切换、搜索建议、键盘导航

🔧 改进 ​

  • 响应式优化 — 完善移动端自适应布局
  • 安全性增强 — 增强 CSRF 防护和输入校验

[1.1.0] — 2026-02-20 ​

✨ 新功能 ​

  • 明暗主题 — 支持明亮/暗黑主题切换，支持跟随系统
  • 动态背景 — 明亮模式樱花花瓣、暗黑模式星空背景
  • 标签管理 — 支持标签分类、拖拽排序、Logo 设置

🔧 改进 ​

  • 数据库迁移 — 自动检测和迁移表结构
  • 日志系统 — 自定义日志记录器，支持文件输出

[1.0.0] — 2025-04-01 ​

🎉 首个正式版本发布 ​

SakuraNav 是一个基于 Next.js + React + TypeScript + SQLite 的优雅个人导航页。

界面体验 ​

  • 响应式设计 — 完美适配桌面端和移动端
  • 明暗主题 — 支持明亮 / 暗黑主题切换
  • 动态背景 — 明亮模式飘落樱花花瓣，暗黑模式闪烁星星
  • 毛玻璃卡片 — 桌面端和移动端可独立开关
  • 三种字体预设 — Space Grotesk / Noto Serif SC / Noto Sans SC

登录管理 ​

  • 隐藏登录路由 — 自定义登录入口路径
  • 管理员二次确认 — 执行敏感操作时需输入密码确认
  • 权限控制 — 登录后可见隐藏标签与隐藏站点

技术特性 ​

  • 全栈 TypeScript — 前后端统一类型安全
  • React 19 — 使用最新 React 特性
  • Repository Pattern — 数据访问层采用 Repository 模式
  • JWT 认证 — 基于 jose 库的安全认证
  • Docker 部署 — 多阶段构建，非 root 用户运行