Foxel v2.2.2 发布说明

• 新增 recent-files 后端 API 和 RecentFile 模型
• 增强了缩略图处理,支持原生缩略图(VirtualFS)
• 优化了 TelegramAdapter 消息缓存与连接管理
• 新增下载锁和等待处理(TelegramAdapter)
• 插件卸载时清理 frame,改进了 iframe 处理
• 文件列表支持类型分类和文件大小格式化
• 支持设置默认文件视图模式和 UI 配置
• 系统设置页配置处理和状态管理优化
• 新增 notices 功能(API、数据库模型、UI 整合)
• 多组件/接口引入基于游标的分页
• Release Drafter 工作流现在包含直推 summary
• 版本号更新至 v2.2.2
• 修复部分 bug(如 dav_get 文件不存在返回 404、缩略图提取等)

Changes

• feat: add recent-files backend API and RecentFile model @DrizzleTime (#119)
• chore(deps): bump the uv group across 1 directory with 2 updates @dependabot[bot] (#118)
• chore(deps): bump pillow from 12.1.1 to 12.2.0 in the uv group across 1 directory @dependabot[bot] (#117)

Direct Commits

🚀 Features

• c2015dd feat: enhance thumbnail handling and add native thumbnail support in VirtualFS @DrizzleTime
• 93d5e5e feat: enhance TelegramAdapter with message caching and connection management @DrizzleTime
• bd24d7e feat: add download locking and flood wait handling in TelegramAdapter @DrizzleTime
• deddbdf feat: implement plugin frame cleanup on unload and enhance iframe handling @DrizzleTime
• ee4de69 feat: add file type categorization and size formatting in FileListView @DrizzleTime
• 19825c2 feat: add default file view mode configuration and UI support @DrizzleTime
• a745c59 feat: enhance SystemSettingsPage with improved config handling and state management @DrizzleTime
• 56b48b2 feat: add notices feature with API, database model, and UI integration @DrizzleTime
• f89292e feat: implement cursor-based pagination across various components and APIs @DrizzleTime
• 70a57f6 feat: enhance release drafter workflow to include direct commits summary @DrizzleTime
• e410c49 feat: update version to v2.2.2 @DrizzleTime

🐛 Bug Fixes

• ca500cb fix: handle FileNotFoundError in dav_get function and return 404 response @DrizzleTime
• 7741c1f fix: handle native video thumbnail availability in get_or_create_thumb function @DrizzleTime

Contributors

• @DrizzleTime

Foxel v2.2.1 发布说明

本次为补丁版本(Patch),聚焦 PikPak 配置完善、Token 刷新稳定性与适配器用量统计能力

v2.2.1 主要围绕 PikPak 适配器的配置与鉴权流程做增强:补齐/调整适配器配置项(新增 user_id 等)、强化 Token 处理与刷新错误兜底;同时引入适配器用量(usage)缓存与容量展示,提升 AdaptersPage 的可观测性与使用体验。并对 WebDAV API 增加 LOCK / UNLOCK 方法与路径处理改进。

新增(Features)

• Adapter Usage:适配器用量统计、缓存与页面展示

  • 新增适配器用量 tracking 接口与获取方法(覆盖多个适配器)
  • 为用量查询引入缓存机制,减少重复请求与提升页面响应
  • AdaptersPage 增加用量汇总(summary)与容量使用(capacity usage)展示,便于快速了解资源消耗情况

• WebDAV API:新增 LOCK / UNLOCK 方法

  • 增加 LOCK、UNLOCK 方法支持
  • 优化既有方法的路径处理逻辑,提升兼容性与稳定性

优化(Improvements)

• PikPak:配置能力更新与 Token 处理增强
  • 更新 PikPak 适配器配置结构/读取逻辑,提升可配置性与一致性
  • 新增 user_id 配置项,完善鉴权/刷新链路所需信息
  • 强化 Token 处理策略与刷新流程,减少边界场景下的异常

修复(Fixes)

• Token Refresh:错误处理与稳定性改进
  • 改善 Token 刷新失败时的错误处理与提示信息
  • 降低刷新异常导致的链路中断风险,提升整体可用性

v2.2.1 是一次面向"存储适配稳定性 + 可观测性增强"的补丁更新:在 PikPak 的配置与 Token 刷新链路上进一步补齐细节,并通过适配器用量统计与缓存/页面展示,让容量与消耗更直观可控,同时完善 WebDAV 能力覆盖。

Foxel Team

Foxel v2.2.0 发布说明

本次为功能版本(Minor),新增客户端授权、存储适配与配置能力增强

v2.2.0 重点引入 TopHeader 的客户端授权能力,并新增 PikPak 适配器,同时补齐默认语言配置、增强向量数据库(Vector DB)配置处理与 Provider 初始化流程,进一步提升权限过滤与文件状态校验的可配置性与稳定性。另包含少量工程维护项与版本号更新。

新增(Features)

• TopHeader:客户端授权(Client Authorization)能力

  • 新增客户端授权入口/交互能力(TopHeader 集成)
  • 同步更新本地化(Localization)文案与语言资源,保证多语言一致性

• Adapter:新增 PikPak 适配器实现

  • 增加 PikPak 的适配层实现,为后续存储/资源接入提供支持

• i18n / 配置:新增默认语言配置(Default Language)

  • 支持配置默认语言,用于首次进入或无显式语言设置时的兜底策略

• 文件状态校验:新增元数据(Metadata)配置项

  • 为文件状态检查提供更多可配置的元数据选项
  • 优化权限过滤逻辑,提升筛选准确性与可维护性

优化(Improvements)

• Vector Database:配置处理与 Provider 初始化增强
  • 强化向量数据库配置的解析与兼容处理
  • 改善 Provider 初始化流程,减少配置边界情况导致的初始化异常

维护(Maintenance)

• 版本更新
  • 服务配置中版本号提升至 v2.2.0

v2.2.0 是一次面向"能力扩展 + 配置增强"的版本:在前端增加客户端授权入口、后端/平台侧补齐存储适配与 Vector DB 配置能力,并对权限与文件状态校验做了更细粒度的可配置优化。

Foxel Team

Foxel v2.1.1 发布说明

本次为补丁版本(Patch),聚焦移动端体验与稳定性

v2.1.1 主要优化移动端 Header 的响应式表现,并修复 ContextMenu 的交互问题,让菜单在触屏/移动端更不容易误触、误关闭,同时减少边界情况下的报错。另外,本版本也对 agent 的工具调用做 MCP 统一。

优化(Improvements)

• Header:移动端布局增强

  • 增加更适合移动端的独立按钮布局
  • 提升小屏幕下的响应式表现与可用性
  • 进一步完善 v2.1.0 的移动端体验

• LayoutShell:响应式与溢出处理优化

  • 调整布局样式以提升不同视口下的适配效果
  • 改善 overflow 处理,减少小屏幕下的裁切/滚动异常

修复(Fixes)

• ContextMenu:点击交互与事件处理修复
  • 修复菜单点击时的事件冒泡问题,避免触发父级点击事件或导致菜单异常关闭
  • 优化 handler 调用逻辑,防止特定情况下的调用错误/异常

开发者 / 平台(Developer / Platform)

• Agent:基于 MCP 的工具调用统一
  • 将工具调用统一到 MCP 方案
  • 新增接口:/api/mcp

维护(Maintenance)

• 版本更新
  • 版本号提升至 v2.1.1

v2.1.1 是对 v2.1.0 移动端首轮适配的"打磨版",重点提升移动端 UI 细节与菜单交互稳定性,并带来 MCP 工具调用体系的升级。

Foxel Team

Foxel v2.1.0 Release Notes

This is a feature release focused on mobile support

This release highlights first-pass mobile responsiveness, including web responsive improvements, better SideNav behavior on mobile, and an enhanced upload menu.

Features

• Web: First-pass mobile responsive support

  • Introduces an initial responsive layout for mobile devices to improve browsing and interaction on smaller screens
  • Improves component layout and readability for phone-sized viewports

• SideNav: Improved mobile visibility control

  • Adds a hideOnMobile property to NavItem
  • Filters/hides navigation items based on mobile view to keep the mobile navigation cleaner and more focused

• Header: Upload menu enhancement

  • Adds an "Upload folder" option to the upload menu
  • Better supports batch uploads and folder-based content organization

Maintenance

• Version update
  • Bumps version to v2.1.0

v2.1.0 is a mobile-first experience update that completes the first step of responsive support, with additional navigation and upload improvements. If you frequently use Foxel on mobile, we recommend upgrading to this version.

Foxel Team

Foxel v2.0.1 发布说明

🔧 这是一个补丁版本更新

📌 本次更新主要修复了依赖问题,建议 v2.0.0 用户尽快升级

问题修复(Fixes)

• 📦 依赖管理优化
  • 修复缺失的 setuptools 依赖问题,添加明确的版本约束,确保安装过程的稳定性
  • 解决因 setuptools 缺失可能导致的安装失败或运行时错误

维护(Maintenance)

• 📦 版本迭代
  • 补丁版本升级至 v2.0.1

🛠️ v2.0.1 是 v2.0.0 的快速修复版本,解决了部分用户在安装或运行时遇到的依赖问题。如果您在使用 v2.0.0 时遇到相关错误,请升级至此版本。

Foxel 团队

Foxel v2.0.0 发布说明

🎉 这是一个重大版本更新!

⚠️ 重要提醒:本次更新涉及权限体系重构,可能导致数据异常,请务必在升级前备份数据!

功能更新(Features)

• 🔐 用户与角色管理

  • 新增完整的用户管理和角色管理页面,支持 API 集成,实现细粒度的权限控制
  • 新增权限装饰器,增强 API 访问控制能力

• ⚙️ 系统设置优化

  • 重构系统设置页面,移除独立的认证设置选项卡,将注册设置整合至应用设置中,简化配置流程
  • 优化 Divider 组件,使用 titlePlacement 属性提升 UI 一致性

• 🔍 搜索与向量数据库

  • 优化向量数据库(Vector DB)提供者处理逻辑,改进初始化设置页面配置体验
  • 搜索对话框新增 destroyOnHidden 属性,优化内存管理与组件生命周期

• 📂 目录处理增强

  • 增强目录处理能力,新增任务队列与输入处理机制,提升批量操作性能
  • 实现面包屑导航双击跳转与点击计时器功能,优化导航交互体验

• 🌐 Agent 工具集

  • 新增 Web 抓取工具(Web Fetching Tools),扩展数据获取能力

维护(Maintenance)

• 📦 版本迭代

  • 核心版本升级至 v2.0.0

• 🔧 依赖更新

  • 更新前端及后端相关依赖包版本,提升系统整体稳定性与兼容性

🚀 v2.0.0 引入了全新的用户与角色权限管理体系,标志着 Foxel 在多用户协作与安全管控方面迈出重要一步。建议所有用户升级以获得更完善的权限控制体验。

Foxel 团队

Foxel v1.7.4 发布说明

功能更新(Features)

• 📁 文件系统功能增强

  • 新增创建文件功能,支持模态框和右键菜单集成,提升文件操作便捷性与交互体验

• 💾 备份功能优化

  • 增强备份功能,新增区域选择和导入模式选项,提供更灵活的备份配置与数据管理能力

• 🔐 适配器增强

  • 强化 Alist 和 OpenList 适配器,可选配置用户名和密码

维护(Maintenance)

• 📦 版本迭代

  • 核心版本升级至 v1.7.4

• 🔧 依赖更新

  • 更新 pyasn1 依赖包版本,提升系统稳定性

Foxel 团队

Foxel v1.7.3 发布说明

功能更新(Features)

• 📁 文件系统全面增强

  • 实现多适配器文件上传方法,支持统一的文件上传处理机制
  • 优化虚拟文件系统的文件上传处理与响应数据规范化
  • 新增公共文件访问的文件名支持,改进临时链接生成逻辑

• 🤖 AI 助手智能优化

  • 系统提示词支持语言自适应,根据用户输入自动调整响应语言
  • AI 助手组件 UI 升级,将 Drawer(抽屉)替换为 Modal(模态框),提升交互体验与视觉一致性

• 🕐 时间工具增强

  • 新增时间工具,支持时区偏移功能
  • 星期显示增加本地化支持,提升多语言环境下的用户体验

维护(Maintenance)

• 📦 版本迭代

  • 核心版本升级至 v1.7.3

• 🎨 品牌优化

  • 更新系统 Logo 设计

Foxel 团队

Foxel v1.7.2 发布说明

功能更新(Features)

• ⏰ 自动化任务调度

  • 支持基于 Cron 表达式 的自动化任务调度功能
  • 更新任务配置,用户可自定义定时任务执行方式,满足多样化自动化需求

• 🔔 系统通知功能

  • 新增"通知"功能,内置弹窗展示与 API 集成,提升系统消息的实时推送与用户互动体验

维护(Maintenance)

• 📦 版本迭代
  • 核心版本升级至 v1.7.2

Foxel 团队