更新日志

亮点

本次发布引入了 MCP（Model Context Protocol）服务器支持，使 AI 助手（如 Claude Desktop）可以搜索和访问你在 Glean 中订阅的 RSS 内容。同时新增了完整的 API Token 管理系统，用于 MCP 客户端的安全认证。

🚀 新功能

MCP 服务器

内置 MCP 服务器，通过 Streamable HTTP 传输协议向 LLM 客户端暴露 Glean 核心功能。可用工具：

• search_entries — 按关键词搜索文章，匹配标题、正文和摘要
• get_entry — 获取指定文章的完整详情
• list_entries_by_date — 按日期范围列出文章，支持已读状态和订阅源筛选
• list_subscriptions — 列出 RSS 订阅源及未读数量

API Token 管理

为 MCP 认证提供完整的令牌生命周期管理：

• 创建命名的长期有效 API Token，可选过期时间（30 天 / 90 天 / 1 年 / 永不过期）
• Token 以 bcrypt 哈希存储，明文仅在创建时展示一次
• 支持列出、吊销令牌，并自动记录最近使用时间

设置页面 — API Tokens 标签页

在设置页面新增标签页，可在浏览器中管理 API Token：

• Token 创建对话框，支持设置名称和过期时间
• 新创建的 Token 支持一键复制到剪贴板
• 吊销操作带确认对话框
• 内置 MCP 配置指南，展示 Claude Desktop JSON 配置示例并自动填充当前域名

🚀 新功能

桌面端与 PWA 支持

• Electron 桌面应用：支持 Windows、macOS 和 Linux 原生桌面应用
• 渐进式 Web 应用 (PWA)：可在移动端和桌面浏览器上安装为独立应用
• 改进的服务器配置：增强 API 配置对话框，支持健康检查、超时管理和 URL 验证

用户管理

• 默认管理员账户：首次启动时自动创建默认管理员账户，简化部署流程
• 管理员创建脚本：新增命令行脚本用于创建管理员用户 (backend/scripts/create-admin.py)
• 简化设置：移除密码强度要求，提供更灵活的用户管理

界面与交互优化

• 增强的移动端导航：改进移动端界面，优化过渡动画和导航体验
• 文章阅读器改进：增强文章阅读器和侧边栏组件的按钮可见性和可访问性
• 智能排序：优化文件夹和订阅源的智能排序逻辑
• 布局优化：改进设置页面布局，调整网格间距

🐛 错误修复

• 设置界面：修复设置页面中外观选择器重叠的问题
• 智能过滤器：明确智能过滤器行为，更新 ReaderPage 中的条件渲染
• Electron 构建：解决 Electron 构建问题
• 部署问题：修复部署相关问题
• 会话管理：更新创建管理员脚本中的会话管理

📚 文档

• 最佳实践更新：添加在浏览器特定 API 中使用 window 与 globalThis 的指南
• 部署指南：增强部署文档，添加新的管理员账户设置说明
• 注释改进：增强代码注释以阐明过滤器行为

🔧 依赖更新

• 更新 react-i18next 至 v16.5.3
• 更新 typescript-eslint 至 v8.53.0
• 更新 turbo 至 v2.7.4
• 更新 zod 至 v4.3.5
• 更新 @tanstack/react-query 至 v5.90.16
• 更新 react-hook-form 至 v7.69.0

🚀 新功能

全文内容提取

• 书签全文内容：自动提取并显示书签的完整文章内容，让阅读和搜索保存的内容更加便捷
• RSS 全文支持：增强 RSS 解析器，可从订阅源中提取完整的文章内容
• 改进的 HTML 处理：更好地处理 HTML 内容，支持行内代码格式化

安全性与代码质量

• XSS 防护：使用 DOMPurify 添加 HTML 清理功能，防止跨站脚本攻击
• 提交前检查：实现提交前自动代码质量检查

🐛 错误修复

• 嵌入系统：修复 Milvus 连接问题和竞态条件导致的”集合未找到”错误
• 数据库会话：解决嵌入功能中的数据库会话管理问题
• HTML 处理：移除重复脚本，改进 HTML 内容处理
• 管理界面设置：更新嵌入功能和管理界面设置

🐛 错误修复与改进

• 部署修复：修复部署流程中的问题，提升升级稳定性（Hotfix/Deployment）
• 加密兼容性：改进安全上下文（Secure Context）检测；在不支持安全上下文时回退到 crypto-js，避免功能不可用

🐛 错误修复与改进

• 部署/迁移修复：修复数据库迁移错误并更新 docker-compose 配置
• 运行环境兼容：回退到更稳定的运行环境配置以保证可用性

⚠️ 重要提示

从旧版本升级可能存在数据不兼容问题。根据发布说明，升级前可能需要执行 docker compose down -v 清理旧数据（该命令会永久删除数据）。