[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-DrizzleTime--Foxel":3,"tool-DrizzleTime--Foxel":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",150037,2,"2026-04-10T23:33:47",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":77,"owner_email":78,"owner_twitter":78,"owner_website":78,"owner_url":79,"languages":80,"stars":108,"forks":109,"last_commit_at":110,"license":111,"difficulty_score":10,"env_os":112,"env_gpu":113,"env_ram":113,"env_deps":114,"category_tags":127,"github_topics":129,"view_count":32,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":140,"updated_at":141,"faqs":142,"releases":180},6495,"DrizzleTime\u002FFoxel","Foxel","A highly extensible private cloud storage solution for individuals and teams, featuring AI-powered semantic search.","Foxel 是一款专为个人和团队打造的高可扩展私有云存储解决方案，旨在帮助用户统一管理分散在不同地方的文件。它解决了传统网盘无法跨平台整合、搜索功能单一以及数据隐私难以保障的痛点。无论是拥有多个云盘账号的普通用户，还是需要构建内部文件系统的开发团队，都能通过 Foxel 将本地硬盘、S3 对象存储、WebDAV 以及 Google Drive、OneDrive 等主流云服务汇聚到一个界面中，实现统一的浏览、上传与权限管控。\n\nFoxel 的核心亮点在于其强大的 AI 语义搜索能力。不同于仅能匹配文件名的传统工具，Foxel 利用嵌入模型和向量数据库，让用户能用自然语言描述直接搜到图片、文档等非结构化数据中的具体内容。此外，它还内置了丰富的文件预览功能、细粒度的角色权限控制（RBAC）以及独特的插件系统，允许开发者在不修改核心代码的情况下动态扩展前端组件或后端逻辑。配合内置的 AI 智能体，Foxel 不仅能存储数据，还能自动执行文件处理等复杂任务。对于希望搭建安全、智能且高度定制化私有云环境的极客、研究人员及中小企业而言，Foxel 是一个理想的选择。","\u003Cdiv align=\"right\">\n  \u003Cb>English\u003C\u002Fb> | \u003Ca href=\".\u002FREADME_zh.md\">简体中文\u003C\u002Fa>\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n\n# Foxel\n\n**A highly extensible private cloud storage solution for individuals and teams, featuring AI-powered semantic search.**\n\n![Python Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.14+-blue.svg)\n![React](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FReact-19.0-blue.svg)\n![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green.svg)\n\n![GitHub stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FDrizzleTime\u002Ffoxel?style=social)\n\n---\n  \u003Cblockquote>\n    \u003Cem>\u003Cstrong>The ocean of data is boundless, let the eye of insight guide the voyage, yet its intricate connections lie deep, not fully discernible from the surface.\u003C\u002Fstrong>\u003C\u002Fem>\n  \u003C\u002Fblockquote>\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDrizzleTime_Foxel_readme_246e77994334.png\" alt=\"UI Screenshot\">\n\u003C\u002Fdiv>\n\n## 👀 Online Demo\n\n> [https:\u002F\u002Fdemo.foxel.cc](https:\u002F\u002Fdemo.foxel.cc)\n>\n> Account\u002FPassword: `admin` \u002F `admin`\n\n## ✨ Core Features\n\n### 📁 Unified File Management\n\nCentralize management of files distributed across different storage backends. Browse, upload, download, move, copy, and delete — all through a single, unified interface.\n\n### 🔌 Pluggable Storage Backends\n\nUtilizes an extensible adapter pattern to easily integrate various storage types:\n\n| Category | Adapters |\n|---|---|\n| **Standard Protocols** | Local, S3-compatible, WebDAV, SFTP, FTP |\n| **Cloud Drives** | Google Drive, OneDrive, Dropbox, Quark |\n| **Special** | Telegram, AList, Foxel-to-Foxel |\n\n### 🔍 AI-Powered Semantic Search\n\nGo beyond filename matching — search by natural language descriptions to find content within images, documents, and other unstructured data. Powered by configurable embedding providers and vector databases (Milvus, Qdrant).\n\n### 👁️ Built-in File Preview\n\nPreview images, videos, PDFs, Office documents, text, and code files directly in the browser — no downloads required.\n\n### 🔐 Permissions & Access Control\n\nA full-featured **Role-Based Access Control (RBAC)** system to secure your data:\n\n- **Built-in Roles**: Three system roles — **Admin** (full access), **User** (configurable access), and **Viewer** (read-only).\n- **Custom Roles**: Create tailored roles with fine-grained system and adapter permissions.\n- **Path-based Rules**: Define read \u002F write \u002F delete \u002F share permissions per path, with support for **wildcards**, **regex patterns**, and **priority-based rule ordering**.\n- **Audit Logging**: Every user action is recorded with full traceability (user, IP, method, status, duration).\n### 🔗 Sharing\n\nGenerate public or password-protected share links with configurable expiration dates. Recipients can browse shared files and folders without logging in.\n\n### 🧩 Plugin System\n\nExtend Foxel's capabilities through a manifest-based plugin architecture. Load React frontend components and custom backend routes at runtime, without modifying the core codebase.\n\n### ⚙️ Task Processing Center\n\nRun asynchronous background tasks — file indexing, data backups, scheduled jobs — without impacting the main application.\n\n### 🤖 AI Agent\n\nAn integrated AI agent with built-in tools for VFS operations, web fetching, and file processing — bringing intelligent automation directly into your cloud storage.\n\n### 🌐 Protocol Mappings\n\nAccess your files through familiar protocols:\n\n- **S3 API** — S3-compatible endpoint for programmatic access\n- **WebDAV** — Mount as a network drive in your OS file manager\n- **Direct Links** — Temporary signed URLs for direct file access\n\n## 🛠️ Tech Stack\n\n| Layer | Technologies |\n|---|---|\n| **Backend** | Python 3.14+, FastAPI, Tortoise ORM, SQLite |\n| **Frontend** | React 19, TypeScript, Vite, Ant Design |\n| **Auth** | JWT (OAuth2), bcrypt |\n| **Vector DB** | Milvus Lite \u002F Server, Qdrant |\n| **Deployment** | Docker, Gunicorn + Uvicorn |\n| **Package Managers** | uv (Python), Bun (JS) |\n\n## 🚀 Quick Start\n\nUsing Docker Compose is the most recommended way to start Foxel.\n\n### 1. Create Data Directories\n\nCreate a `data` folder for persistent data:\n\n```bash\nmkdir -p data\u002Fdb data\u002Fmount\nchmod 777 data\u002Fdb data\u002Fmount\n```\n\n### 2. Download Docker Compose File\n\n```bash\ncurl -L -O https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fraw\u002Fmain\u002Fcompose.yaml\n```\n\nAfter downloading, it is **strongly recommended** to modify the environment variables in the `compose.yaml` file to ensure security:\n\n- Modify `SECRET_KEY` and `TEMP_LINK_SECRET_KEY`: Replace the default keys with randomly generated strong keys.\n\n### 3. Start the Services\n\n```bash\ndocker-compose up -d\n```\n\n### 4. Access the Application\n\nOnce the services are running, open the page in your browser.\n\n> On the first launch, please follow the setup guide to initialize the administrator account.\n\n## 🤝 How to Contribute\n\nWe welcome contributions from the community! Whether it's submitting bugs, suggesting new features, or contributing code directly.\n\nBefore you start, please read our [`CONTRIBUTING.md`](CONTRIBUTING.md) file, which explains the development environment and submission process. A Simplified Chinese translation is available in [`CONTRIBUTING_zh.md`](CONTRIBUTING_zh.md).\n\n## 🌐 Community\n\nJoin our community on [Telegram](https:\u002F\u002Ft.me\u002F+thDsBfyqJxZkNTU1) to discuss with developers and other users!\n\nYou can also join our WeChat group for more real-time communication and support. Please scan the QR code below to join:\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDrizzleTime_Foxel_readme_72b937f0b982.png\" alt=\"WeChat Group QR Code\" width=\"180\">\n\n> If the QR code is invalid, please add WeChat ID **drizzle2001**, and we will invite you to the group.\n\n## 📄 License\n\nFoxel is open-sourced under the [MIT License](LICENSE).\n","\u003Cdiv align=\"right\">\n  \u003Cb>English\u003C\u002Fb> | \u003Ca href=\".\u002FREADME_zh.md\">简体中文\u003C\u002Fa>\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n\n# Foxel\n\n**一款高度可扩展的个人与团队私有云存储解决方案，具备AI驱动的语义搜索功能。**\n\n![Python Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.14+-blue.svg)\n![React](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FReact-19.0-blue.svg)\n![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green.svg)\n\n![GitHub stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FDrizzleTime\u002Ffoxel?style=social)\n\n---\n  \u003Cblockquote>\n    \u003Cem>\u003Cstrong>数据的海洋浩瀚无垠，让洞察之眼指引航程；然而其错综复杂的关联深藏其中，仅凭表面难以完全辨识。\u003C\u002Fstrong>\u003C\u002Fem>\n  \u003C\u002Fblockquote>\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDrizzleTime_Foxel_readme_246e77994334.png\" alt=\"UI Screenshot\">\n\u003C\u002Fdiv>\n\n## 👀 在线演示\n\n> [https:\u002F\u002Fdemo.foxel.cc](https:\u002F\u002Fdemo.foxel.cc)\n>\n> 账号\u002F密码: `admin` \u002F `admin`\n\n## ✨ 核心功能\n\n### 📁 统一文件管理\n\n集中管理分布在不同存储后端的文件。通过单一、统一的界面即可浏览、上传、下载、移动、复制和删除文件。\n\n### 🔌 可插拔存储后端\n\n采用可扩展的适配器模式，轻松集成多种存储类型：\n\n| 类别 | 适配器 |\n|---|---|\n| **标准协议** | 本地、S3兼容、WebDAV、SFTP、FTP |\n| **云盘** | Google Drive、OneDrive、Dropbox、Quark |\n| **特殊** | Telegram、AList、Foxel-to-Foxel |\n\n### 🔍 AI驱动的语义搜索\n\n超越文件名匹配——通过自然语言描述搜索图像、文档及其他非结构化数据中的内容。由可配置的嵌入提供商和向量数据库（Milvus、Qdrant）提供支持。\n\n### 👁️ 内置文件预览\n\n直接在浏览器中预览图片、视频、PDF、Office文档、文本和代码文件——无需下载。\n\n### 🔐 权限与访问控制\n\n功能完善的**基于角色的访问控制（RBAC）**系统，确保您的数据安全：\n\n- **内置角色**：三种系统角色——**管理员**（完全访问权限）、**用户**（可配置访问权限）和**查看者**（只读）。\n- **自定义角色**：创建具有细粒度系统和适配器权限的定制角色。\n- **路径级规则**：按路径定义读\u002F写\u002F删除\u002F共享权限，支持**通配符**、**正则表达式模式**以及**优先级规则排序**。\n- **审计日志**：记录每个用户操作，具备完整追溯能力（用户、IP、方法、状态、耗时）。\n### 🔗 共享\n\n生成可配置过期时间的公开或受密码保护的共享链接。接收者无需登录即可浏览共享文件和文件夹。\n\n### 🧩 插件系统\n\n通过基于清单的插件架构扩展Foxel的功能。可在运行时加载React前端组件和自定义后端路由，无需修改核心代码库。\n\n### ⚙️ 任务处理中心\n\n运行异步后台任务——文件索引、数据备份、定时任务——而不会影响主应用程序。\n\n### 🤖 AI智能体\n\n集成AI智能体，内置用于VFS操作、网页抓取和文件处理的工具——将智能自动化直接引入您的云存储。\n\n### 🌐 协议映射\n\n通过熟悉的协议访问您的文件：\n\n- **S3 API** — S3兼容端点，用于程序化访问\n- **WebDAV** — 可作为网络驱动挂载到您的操作系统文件管理器中\n- **直链** — 临时签名URL，用于直接访问文件\n\n## 🛠️ 技术栈\n\n| 层 | 技术 |\n|---|---|\n| **后端** | Python 3.14+、FastAPI、Tortoise ORM、SQLite |\n| **前端** | React 19、TypeScript、Vite、Ant Design |\n| **认证** | JWT（OAuth2）、bcrypt |\n| **向量数据库** | Milvus Lite \u002F Server、Qdrant |\n| **部署** | Docker、Gunicorn + Uvicorn |\n| **包管理器** | uv（Python）、Bun（JS） |\n\n## 🚀 快速开始\n\n使用Docker Compose是启动Foxel最推荐的方式。\n\n### 1. 创建数据目录\n\n创建一个用于持久化数据的`data`文件夹：\n\n```bash\nmkdir -p data\u002Fdb data\u002Fmount\nchmod 777 data\u002Fdb data\u002Fmount\n```\n\n### 2. 下载Docker Compose文件\n\n```bash\ncurl -L -O https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fraw\u002Fmain\u002Fcompose.yaml\n```\n\n下载后，**强烈建议**修改`compose.yaml`文件中的环境变量以确保安全性：\n\n- 修改`SECRET_KEY`和`TEMP_LINK_SECRET_KEY`：将默认密钥替换为随机生成的强密钥。\n\n### 3. 启动服务\n\n```bash\ndocker-compose up -d\n```\n\n### 4. 访问应用\n\n服务启动后，在浏览器中打开页面。\n\n> 首次启动时，请按照设置指南初始化管理员账号。\n\n## 🤝 如何贡献\n\n我们欢迎社区的贡献！无论是提交Bug、提出新功能建议，还是直接贡献代码。\n\n在开始之前，请阅读我们的[`CONTRIBUTING.md`](CONTRIBUTING.md)文件，其中介绍了开发环境和提交流程。简体中文翻译版本可在[`CONTRIBUTING_zh.md`](CONTRIBUTING_zh.md)中找到。\n\n## 🌐 社区\n\n加入我们的Telegram社区（[https:\u002F\u002Ft.me\u002F+thDsBfyqJxZkNTU1](https:\u002F\u002Ft.me\u002F+thDsBfyqJxZkNTU1)），与开发者和其他用户交流讨论！\n\n您也可以加入我们的微信交流群，获取更实时的沟通和支持。请扫描下方二维码加入：\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDrizzleTime_Foxel_readme_72b937f0b982.png\" alt=\"微信群二维码\" width=\"180\">\n\n> 如果二维码无效，请添加微信号**drizzle2001**，我们将邀请您入群。\n\n## 📄 许可证\n\nFoxel根据[MIT许可证](LICENSE)开源。","# Foxel 快速上手指南\n\nFoxel 是一款高度可扩展的私有云存储解决方案，专为个人和团队设计，核心特色是支持 **AI 驱动的语义搜索**。它允许你统一管理分散在不同后端（如本地、S3、网盘等）的文件，并通过自然语言检索内容。\n\n## 环境准备\n\n在开始之前，请确保你的服务器或开发环境满足以下要求：\n\n*   **操作系统**：Linux \u002F macOS \u002F Windows (需安装 Docker)\n*   **核心依赖**：\n    *   [Docker](https:\u002F\u002Fwww.docker.com\u002F) (推荐 v20.10+)\n    *   [Docker Compose](https:\u002F\u002Fdocs.docker.com\u002Fcompose\u002F) (推荐 v2.0+)\n*   **硬件建议**：\n    *   内存：至少 2GB RAM（若启用 AI 向量数据库如 Milvus\u002FQdrant，建议 4GB+）\n    *   磁盘：根据存储需求配置，需预留空间给 `data` 目录\n\n> **注意**：本项目后端基于 Python 3.14+，前端基于 React 19，但通过 Docker 部署时无需在宿主机单独安装这些运行时环境。\n\n## 安装步骤\n\n使用 Docker Compose 是最推荐的部署方式，只需三步即可完成。\n\n### 1. 创建数据持久化目录\n\n在终端执行以下命令，创建用于存储数据库和挂载文件的目录，并设置权限：\n\n```bash\nmkdir -p data\u002Fdb data\u002Fmount\nchmod 777 data\u002Fdb data\u002Fmount\n```\n\n### 2. 下载配置文件\n\n获取官方的 `compose.yaml` 文件：\n\n```bash\ncurl -L -O https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fraw\u002Fmain\u002Fcompose.yaml\n```\n\n> **国内加速提示**：如果 `curl` 下载缓慢，可尝试使用镜像源：\n> ```bash\n> curl -L -O https:\u002F\u002Fghproxy.net\u002Fhttps:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fraw\u002Fmain\u002Fcompose.yaml\n> ```\n\n### 3. 配置安全密钥（重要）\n\n在启动前，**必须**修改 `compose.yaml` 中的默认密钥以确保安全。使用编辑器打开文件：\n\n```bash\nnano compose.yaml\n# 或使用 vim, code 等其他编辑器\n```\n\n找到并修改以下环境变量，将其替换为你生成的随机强字符串：\n*   `SECRET_KEY`\n*   `TEMP_LINK_SECRET_KEY`\n\n### 4. 启动服务\n\n执行以下命令后台启动所有服务：\n\n```bash\ndocker-compose up -d\n```\n\n等待容器启动完成后，可通过 `docker-compose ps` 检查状态，确保所有服务均为 `Up`。\n\n## 基本使用\n\n### 1. 访问管理界面\n\n在浏览器中打开部署地址（默认为本机 8080 端口，具体视 `compose.yaml` 配置而定）：\n\n```text\nhttp:\u002F\u002Flocalhost:8080\n```\n\n### 2. 初始化管理员账户\n\n首次访问时，系统将引导你完成初始化设置：\n1.  按照页面提示创建 **管理员账户**（设置用户名和密码）。\n2.  登录系统。\n\n### 3. 添加存储后端\n\n登录后，进入 **设置 (Settings)** -> **存储适配器 (Storage Adapters)**：\n*   点击“添加适配器”。\n*   选择类型（如 **Local** 本地存储、**S3**、**WebDAV** 或 **Google Drive** 等）。\n*   填写相应配置信息（例如本地路径或云厂商的 Access Key）。\n*   保存后，即可在文件管理界面看到并操作该存储源的文件。\n\n### 4. 体验 AI 语义搜索\n\n上传一些文档或图片后，直接在顶部搜索框输入自然语言描述（例如：“查找去年的财务报表”或“包含猫的图片”），Foxel 将利用嵌入模型进行语义匹配，而不仅仅是文件名匹配。\n\n---\n*更多高级功能（如权限控制、插件系统、AI Agent）请参考官方完整文档。*","某设计团队需要在本地硬盘、Google Drive 和 S3 对象存储中管理数千份分散的设计稿、合同文档及素材视频，并频繁进行跨平台协作与内容检索。\n\n### 没有 Foxel 时\n- **存储孤岛严重**：成员需分别登录不同网盘或连接多个映射驱动器才能找齐项目文件，操作繁琐且容易遗漏。\n- **检索效率低下**：只能依靠文件名关键词搜索，无法查找图片内容或文档内部语义（如“去年夏天的海边活动照片”），导致大量时间浪费在人工翻找上。\n- **权限管控混乱**：缺乏统一的细粒度控制，难以针对特定路径设置“只读”或“禁止下载”规则，敏感资料存在泄露风险。\n- **预览体验割裂**：查看 PDF 合同或高清视频时必须先下载到本地，不仅占用带宽，还降低了即时评审的效率。\n\n### 使用 Foxel 后\n- **统一资源视图**：通过插件化适配器将本地、Google Drive 和 S3 无缝整合至单一界面，团队成员在一个窗口即可浏览和管理所有后端数据。\n- **AI 语义秒级定位**：利用内置的 AI 语义搜索，直接输入自然语言描述（如“包含红色 Logo 的海报初稿”）即可精准定位图片与文档内容，无需记忆具体文件名。\n- **精细化安全防御**：基于角色的访问控制（RBAC）支持路径级正则匹配，轻松实现“实习生仅可查看素材库但不可下载源文件”等复杂策略，并全程记录审计日志。\n- **浏览器即开即用**：依托强大的内置预览引擎，直接在浏览器中流畅查看 Office 文档、代码及 4K 视频，大幅缩短从查找到的决策周期。\n\nFoxel 通过打破存储边界并赋予数据“理解力”，将原本碎片化的文件管理升级为智能、安全且高效的统一知识中枢。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDrizzleTime_Foxel_246e7799.png","DrizzleTime","时雨","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FDrizzleTime_16b4d23c.png","千里之行，始於足下","Jiangsu University","China",null,"https:\u002F\u002Fgithub.com\u002FDrizzleTime",[81,85,89,93,97,101,105],{"name":82,"color":83,"percentage":84},"Python","#3572A5",54.6,{"name":86,"color":87,"percentage":88},"TypeScript","#3178c6",42.2,{"name":90,"color":91,"percentage":92},"CSS","#663399",1.7,{"name":94,"color":95,"percentage":96},"Shell","#89e051",1,{"name":98,"color":99,"percentage":100},"HTML","#e34c26",0.4,{"name":102,"color":103,"percentage":104},"Dockerfile","#384d54",0.1,{"name":106,"color":107,"percentage":104},"JavaScript","#f1e05a",1016,91,"2026-04-10T11:40:52","MIT","Linux, macOS, Windows","未说明",{"notes":115,"python":116,"dependencies":117},"推荐使用 Docker Compose 部署。首次启动需初始化管理员账户。若启用 AI 语义搜索功能，需配置嵌入提供商及向量数据库（Milvus 或 Qdrant）。生产环境建议修改 compose.yaml 中的 SECRET_KEY 以确保安全。","3.14+",[118,119,120,121,86,122,123,124,125,126],"FastAPI","Tortoise ORM","SQLite","React 19","Vite","Ant Design","Milvus Lite\u002FServer","Qdrant","uv",[13,14,128,15],"视频",[130,131,132,133,134,135,136,137,138,139],"ai","image","react","photo-gallery","photos","typescript","filesystem","python","cloud","video","2026-03-27T02:49:30.150509","2026-04-11T10:01:20.574031",[143,148,153,157,161,166,171,175],{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},29393,"Docker 容器重启后数据丢失或需要重新初始化怎么办？","这通常是因为数据库迁移未正确应用或镜像版本问题。建议强制重新拉取最新镜像，或者先删除旧的镜像再重新拉取。如果问题依旧，建议清理之前的容器和数据库卷后重新安装，以确保数据库结构正确初始化。","https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fissues\u002F29",{"id":149,"question_zh":150,"answer_zh":151,"source_url":152},29394,"如何配置 OpenAI 兼容的 AI 服务（如硅基流动）及模型？","系统支持 OpenAI 格式配置。以硅基流动为例，API 地址填写 `https:\u002F\u002Fapi.siliconflow.cn\u002Fv1`。注意必须同时配置视觉模型（用于图片生成标签等）和嵌入模型（Embedding Model），例如 `deepseek-ai\u002FDeepSeek-V3` 作为对话模型，`Pro\u002FBAAI\u002Fbge-m3` 作为嵌入模型。请确保在设置中启用了这两类模型。","https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fissues\u002F8",{"id":154,"question_zh":155,"answer_zh":156,"source_url":152},29395,"如何对接 Alist 云盘作为 WebDAV 存储？","可以在设置中配置 WebDAV 来对接 Alist。具体参数如下：\n- WebDAVServerUrl: 填写 Alist 的访问域名（如 `https:\u002F\u002Falist.xxx.net`）\n- WebDAVUserName: 填写 Alist 用户名（需在 Alist 中开启 WebDAV 权限）\n- WebDAVPassword: 填写对应的密码\n- WebDAVBasePath: 填写存储根路径（如 `\u002Fdav\u002Fimage`）\n- WebDAVPublicUrl: 填写对外访问域名",{"id":158,"question_zh":159,"answer_zh":160,"source_url":152},29396,"谁是系统管理员？有默认账号吗？","系统没有预设的默认管理员账号。**首个注册的用户**将自动成为管理员。请注意保护好首次注册的账号安全，因为该账号拥有最高权限。",{"id":162,"question_zh":163,"answer_zh":164,"source_url":165},29397,"升级 Docker 镜像后登录报错 \"relation does not exist\" 怎么办？","这是因为新版本与旧版本的数据库结构变动较大且不兼容。如果数据不重要，建议直接全新安装（删除旧容器和数据库卷后重新部署）。如果数据非常重要，无法接受丢失，则需要联系维护者协助手动更新数据库结构，自动升级可能无法生效。","https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fissues\u002F18",{"id":167,"question_zh":168,"answer_zh":169,"source_url":170},29398,"如何修改容器内部的服务端口？","从版本 1.5.3 开始，可以通过添加环境变量 `FOXEL_PORT` 来修改容器内部的服务端口。这对于使用 host 网络模式部署时非常有用，可以避免端口冲突。","https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fissues\u002F45",{"id":172,"question_zh":173,"answer_zh":174,"source_url":152},29399,"本地部署时上传图片到 Telegram 失败或超时怎么办？","如果在本地部署环境下使用 Telegram 图床，由于网络限制，通常需要配置代理。虽然服务端默认支持代理模式，但本地部署可能需要额外配置 HTTP 或 SOCKS5 代理选项，专门让 Telegram 相关的请求走代理通道。如果是国外 VPS 部署且网络通畅，则无需额外设置。",{"id":176,"question_zh":177,"answer_zh":178,"source_url":179},29400,"是否支持多账号及文件权限管理？","是的，系统已支持多账号和权限管理功能。用户可以创建不同的账号，并授权它们访问特定的文件或目录，从而实现隐私隔离和细粒度的权限控制。","https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fissues\u002F49",[181,186,191,196,201,206,211,216,221,226,231,236,241,246,251,256,261,266,271,276],{"id":182,"version":183,"summary_zh":184,"released_at":185},198175,"v2.1.1","## Foxel v2.1.1 发布说明\n\n### 本次为补丁版本（Patch），聚焦移动端体验与稳定性\n\n**v2.1.1 主要优化移动端 Header 的响应式表现，并修复 ContextMenu 的交互问题**，让菜单在触屏\u002F移动端更不容易误触、误关闭，同时减少边界情况下的报错。另外，本版本也对 agent 的工具调用做 MCP 统一。\n\n---\n\n### 优化（Improvements）\n\n- Header：移动端布局增强  \n  - 增加更适合移动端的独立按钮布局  \n  - 提升小屏幕下的响应式表现与可用性  \n  - 进一步完善 **v2.1.0** 的移动端体验\n\n- LayoutShell：响应式与溢出处理优化  \n  - 调整布局样式以提升不同视口下的适配效果  \n  - 改善 overflow 处理，减少小屏幕下的裁切\u002F滚动异常\n\n---\n\n### 修复（Fixes）\n\n- ContextMenu：点击交互与事件处理修复  \n  - 修复菜单点击时的事件冒泡问题，避免触发父级点击事件或导致菜单异常关闭  \n  - 优化 handler 调用逻辑，防止特定情况下的调用错误\u002F异常\n\n---\n\n### 开发者 \u002F 平台（Developer \u002F Platform）\n\n- Agent：基于 MCP 的工具调用统一  \n  - 将工具调用统一到 **MCP** 方案  \n  - 新增接口：`\u002Fapi\u002Fmcp`\n\n---\n\n### 维护（Maintenance）\n\n- 版本更新  \n  - 版本号提升至 **v2.1.1**\n\n---\n\nv2.1.1 是对 v2.1.0 移动端首轮适配的“打磨版”，重点提升移动端 UI 细节与菜单交互稳定性，并带来 MCP 工具调用体系的升级。\n\n**Foxel Team**","2026-03-15T08:11:26",{"id":187,"version":188,"summary_zh":189,"released_at":190},198176,"v2.1.0","## Foxel v2.1.0 发行说明\n\n### 这是一个以移动端支持为重点的功能发布\n\n**本次发布重点实现了初步的移动端响应式设计**，包括网页响应式改进、移动端侧边导航栏行为优化以及上传菜单的增强。\n\n---\n\n### 新特性\n\n- 网页：初步的移动端响应式支持  \n  - 引入了针对移动设备的初始响应式布局，以提升在小屏幕上的浏览和交互体验  \n  - 改进了组件布局和可读性，适应手机尺寸的视口\n\n- 侧边导航栏：优化移动端可见性控制  \n  - 为 `NavItem` 添加了 `hideOnMobile` 属性  \n  - 根据是否为移动端视图来过滤或隐藏导航项，使移动端导航更加简洁、聚焦\n\n- 页头：上传菜单增强  \n  - 在上传菜单中新增“上传文件夹”选项  \n  - 更好地支持批量上传和基于文件夹的内容组织\n\n---\n\n### 维护与更新\n\n- 版本更新  \n  - 版本号升级至 **v2.1.0**\n\n---\n\nv2.1.0 是一次以移动端为核心的体验更新，完成了响应式支持的第一步，并进一步优化了导航和上传功能。如果您经常在移动端使用 Foxel，建议升级到此版本。\n\n**Foxel 团队**","2026-03-09T08:49:36",{"id":192,"version":193,"summary_zh":194,"released_at":195},198177,"v2.0.1","## Foxel v2.0.1 发布说明\n\n### 🔧 这是一个补丁版本更新\n\n> 📌 **本次更新主要修复了依赖问题，建议 v2.0.0 用户尽快升级**\n\n---\n\n### 问题修复（Fixes）\n\n- **📦 依赖管理优化**\n  - 修复缺失的 setuptools 依赖问题，添加明确的版本约束，确保安装过程的稳定性\n  - 解决因 setuptools 缺失可能导致的安装失败或运行时错误\n\n### 维护（Maintenance）\n\n- **📦 版本迭代**\n  - 补丁版本升级至 **v2.0.1**\n\n---\n\n> 🛠️ v2.0.1 是 v2.0.0 的快速修复版本，解决了部分用户在安装或运行时遇到的依赖问题。如果您在使用 v2.0.0 时遇到相关错误，请升级至此版本。\n\n**Foxel 团队**","2026-02-10T02:23:17",{"id":197,"version":198,"summary_zh":199,"released_at":200},198178,"v2.0.0","## Foxel v2.0.0 发布说明\n\n### 🎉 这是一个重大版本更新！\n\n> ⚠️ **重要提醒：本次更新涉及权限体系重构，可能导致数据异常，请务必在升级前备份数据！**\n\n---\n\n### 功能更新（Features）\n\n- **🔐 用户与角色管理**\n  - 新增完整的**用户管理**和**角色管理**页面，支持 API 集成，实现细粒度的权限控制\n  - 新增**权限装饰器**，增强 API 访问控制能力\n\n- **⚙️ 系统设置优化**\n  - 重构系统设置页面，移除独立的认证设置选项卡，将**注册设置**整合至应用设置中，简化配置流程\n  - 优化 Divider 组件，使用 `titlePlacement` 属性提升 UI 一致性\n\n- **🔍 搜索与向量数据库**\n  - 优化向量数据库（Vector DB）提供者处理逻辑，改进初始化设置页面配置体验\n  - 搜索对话框新增 `destroyOnHidden` 属性，优化内存管理与组件生命周期\n\n- **📂 目录处理增强**\n  - 增强目录处理能力，新增**任务队列**与输入处理机制，提升批量操作性能\n  - 实现面包屑导航**双击跳转**与点击计时器功能，优化导航交互体验\n\n- **🌐 Agent 工具集**\n  - 新增 **Web 抓取工具（Web Fetching Tools）**，扩展数据获取能力\n\n### 维护（Maintenance）\n\n- **📦 版本迭代**\n  - 核心版本升级至 **v2.0.0**\n\n- **🔧 依赖更新**\n  - 更新前端及后端相关依赖包版本，提升系统整体稳定性与兼容性\n\n---\n\n> 🚀 v2.0.0 引入了全新的用户与角色权限管理体系，标志着 Foxel 在多用户协作与安全管控方面迈出重要一步。建议所有用户升级以获得更完善的权限控制体验。\n\n**Foxel 团队**","2026-02-09T09:38:53",{"id":202,"version":203,"summary_zh":204,"released_at":205},198179,"v1.7.4","## Foxel v1.7.4 发布说明\n\n### 功能更新（Features）\n\n- **📁 文件系统功能增强**\n  - 新增创建文件功能，支持模态框和右键菜单集成，提升文件操作便捷性与交互体验\n\n- **💾 备份功能优化**\n  - 增强备份功能，新增**区域选择**和**导入模式**选项，提供更灵活的备份配置与数据管理能力\n\n- **🔐 适配器增强**\n  - 强化 Alist 和 OpenList 适配器，可选配置**用户名和密码**\n\n### 维护（Maintenance）\n\n- **📦 版本迭代**\n  - 核心版本升级至 **v1.7.4**\n  \n- **🔧 依赖更新**\n  - 更新 pyasn1 依赖包版本，提升系统稳定性\n\n---\n\n**Foxel 团队**","2026-01-19T08:52:02",{"id":207,"version":208,"summary_zh":209,"released_at":210},198180,"v1.7.3","## Foxel v1.7.3 发布说明\n\n### 功能更新（Features）\n\n- **📁 文件系统全面增强**\n  - 实现多适配器文件上传方法，支持统一的文件上传处理机制\n  - 优化虚拟文件系统的文件上传处理与响应数据规范化\n  - 新增公共文件访问的文件名支持，改进临时链接生成逻辑\n\n- **🤖 AI 助手智能优化**\n  - 系统提示词支持**语言自适应**，根据用户输入自动调整响应语言\n  - AI 助手组件 UI 升级，将 Drawer（抽屉）替换为 Modal（模态框），提升交互体验与视觉一致性\n\n- **🕐 时间工具增强**\n  - 新增时间工具，支持**时区偏移**功能\n  - 星期显示增加本地化支持，提升多语言环境下的用户体验\n\n### 维护（Maintenance）\n\n- **📦 版本迭代**\n  - 核心版本升级至 **v1.7.3**\n  \n- **🎨 品牌优化**\n  - 更新系统 Logo 设计\n\n---\n\n**Foxel 团队**","2026-01-18T10:19:02",{"id":212,"version":213,"summary_zh":214,"released_at":215},198181,"v1.7.2","## Foxel v1.7.2 发布说明\n\n### 功能更新（Features）\n\n- **⏰ 自动化任务调度**\n  - 支持基于 **Cron 表达式** 的自动化任务调度功能\n  - 更新任务配置，用户可自定义定时任务执行方式，满足多样化自动化需求\n\n- **🔔 系统通知功能**\n  - 新增“通知”功能，内置弹窗展示与 API 集成，提升系统消息的实时推送与用户互动体验\n\n### 维护（Maintenance）\n\n- **📦 版本迭代**\n  - 核心版本升级至 **v1.7.2**\n\n---\n\n**Foxel 团队**","2026-01-16T03:23:23",{"id":217,"version":218,"summary_zh":219,"released_at":220},198182,"v1.7.1","## Foxel v1.7.1 发布说明\n\n### 功能更新（Features）\n\n- **🤖 AI 模型与提供商扩展**\n  - 新增多个 **AI 模型**支持，提供更丰富的模型选择\n  - 扩展 **AI Provider（提供商）**支持范围，接入更多服务商\n  - 优化 AI 提供商的**描述信息**，帮助用户更好地理解各提供商特性与适用场景\n\n- **⚙️ 设置界面优化**\n  - 改进**设置页面 UI 布局**，信息组织更清晰、操作更便捷\n  - 优化 AI 模型与提供商的展示逻辑，配置流程更直观\n\n### 维护（Maintenance）\n\n- **📦 版本迭代**\n  - 核心版本升级至 **v1.7.1**\n\n---\n\n**Foxel 团队**\n\n---","2026-01-12T02:26:50",{"id":222,"version":223,"summary_zh":224,"released_at":225},198183,"v1.7.0","## Foxel v1.7.0 发布说明\n\n### 功能更新（Features）\n\n- **🤖 AI 代理能力上线与增强**\n  - 新增 **AI 代理**（智能代理）能力，支持更完整的工具处理流程（Tool Processing）\n  - 提供工具的**列表\u002F调度\u002F运行**能力，并补充了 Agent Chat 请求与 Tool Call 的数据模型\n  - 打通 **API 集成**，支持对话与**流式响应（Streaming）**，交互更顺滑\n  - 上线 **AI 代理 Widget** 交互组件，并持续优化界面样式与体验一致性\n\n- **🛠️ AI 助手工具能力扩展**\n  - 增强 AI 助手的工具功能，新增**文件操作**与**搜索**相关能力\n  - 更新组件实现与展示逻辑，提升可用性与信息呈现清晰度\n\n- **📱 Telegram 适配器增强**\n  - 新增 **会话锁（Session Locking）机制**，降低并发\u002F重复登录导致的会话冲突风险\n  - 兼容解析 **legacy session_string**，提升旧会话数据迁移与兼容性\n  - 支持**缩略图（Thumbnails）抓取**能力，媒体展示更完整\n  - 改进 **SPA fallback** 处理逻辑，前端路由场景下访问更稳定\n\n- **📁 WebDAV\u002F文件服务稳定性改进**\n  - 改进 `propfind` 的错误处理逻辑，异常场景反馈更明确\n  - 增强目录列表（directory listing）生成与边界处理，提升兼容性与可靠性\n\n- **⚙️ 设置与鉴权体验优化**\n  - 调整 **AIProvider** 数据结构，新增 `has_api_key`\n  - 优化 API Key 的处理与展示逻辑，配置流程更直观\n\n### 维护（Maintenance）\n\n- **🔧 结构与工程整理**\n  - 重构 import，并重新组织 domain 结构，降低耦合、提升可维护性\n\n- **📦 版本迭代**\n  - 核心版本升级至 **v1.7.0**（包含 service 配置版本同步更新）\n\n---\n\n**Foxel 团队**","2026-01-11T06:11:43",{"id":227,"version":228,"summary_zh":229,"released_at":230},198184,"v1.6.1","## Foxel v1.6.1 发布说明\n\n### 功能更新（Features）\n\n- **🌐 插件 Frame URL 构建增强**\n  - 优化插件 Frame 的 URL 生成逻辑，兼容更多场景与参数组合\n  - 改进与插件样式（styles）和入口（entry）相关的查询参数处理，减少异常与边缘问题\n\n- **🧩 插件资源版本化支持**\n  - 为插件静态资源引入**版本标识\u002F版本管理机制**，提升缓存可控性与更新一致性\n  - 降低因浏览器缓存导致的资源不同步问题，插件升级后加载更可靠\n\n- **⏳ 加载状态体验改进**\n  - 完善插件加载过程中的状态处理与反馈逻辑\n  - 提升加载过程的稳定性与可观测性，减少“看起来卡住”的体验\n\n### 维护（Maintenance）\n\n- **版本迭代**：核心版本升级至 **v1.6.1**，聚焦插件加载链路与资源管理的稳定性提升\n\n---\n\n**Foxel 团队**","2026-01-08T04:21:52",{"id":232,"version":233,"summary_zh":234,"released_at":235},198185,"v1.6.0","## Foxel v1.6.0 发布 🎉\r\n\r\n### 重大更新\r\n\r\n- **🔌 插件系统彻底重构**\r\n  - **全新架构设计**：采用 `.foxpkg` 标准化插件包格式（基于 ZIP），支持前后端一体化扩展能力\r\n  - **三大扩展方向**：\r\n    - **前端扩展**：开发自定义 UI 组件，创建文件查看器（图片\u002F视频\u002FPDF\u002FOffice 等）\r\n    - **后端扩展**：通过 FastAPI 创建 API 路由，提供数据服务与第三方集成\r\n    - **自动化处理**：开发文件处理器，实现缩略图生成、转码、格式转换等工作流\r\n  - **开发者友好**：\r\n    - 提供完整的插件脚手架与构建工具链\r\n    - 支持 React + TypeScript 前端开发\r\n    - 内置 5 个示例插件（Image Viewer、Text Editor、PDF Viewer、Video Library、Office Viewer）\r\n    - 通过 `foxelApi.vfs` 虚拟文件系统 API 安全访问用户文件\r\n  - **标准化清单**：`manifest.json` 统一管理插件元数据（key\u002Fname\u002Fversion\u002Fdescription）\r\n\r\n### 功能增强\r\n\r\n- **插件管理界面优化**\r\n  - **智能搜索**：新增插件搜索功能，支持对 `fetchFoxelCoreApps` 的查询过滤，快速定位目标插件\r\n  - **布局改进**：调整插件页面与 AI 设置页面的网格列尺寸，提升响应式布局体验\r\n\r\n### 维护\r\n\r\n- **版本迭代**：核心版本升级至 **v1.6.0**，标志插件生态进入全新阶段\r\n\r\n---\r\n\r\n**Foxel 团队**\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fcompare\u002Fv1.5.4...v1.6.0","2026-01-06T13:23:27",{"id":237,"version":238,"summary_zh":239,"released_at":240},198186,"v1.5.5","## Foxel v1.5.5 发布说明 🎉\r\n\r\n### 亮点\r\n\r\n- **功能增强**\r\n  - **文件搜索能力（File Explorer）**：在 **FileExplorerPage** 中新增文件搜索功能，支持在文件列表中快速定位目标文件，提升大规模文件场景下的浏览与操作效率。\r\n  - **向量\u002F文件集合能力完善**：新增 **vector** 与 **file collection** 相关常量定义，并优化向量索引（vector index）的处理逻辑，为后续检索与索引管理提供更稳定的基础能力。\r\n\r\n---\r\n\r\n**Foxel 团队**\r\n\r\n**Full Changelog**：https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fcompare\u002Fv1.5.4...v1.5.5","2026-01-03T13:20:15",{"id":242,"version":243,"summary_zh":244,"released_at":245},198187,"v1.5.4","## Foxel v1.5.4 发布 🎉\r\n\r\n### 亮点\r\n\r\n- **功能增强**\r\n  - **Adapter 支持与本地化补全**：新增 **Foxel Adapter** 支持，并补充对应的多语言（localization）条目，为更多集成场景与国际化展示打下基础。\r\n  - **审计日志能力增强**：优化请求处理中的 **客户端 IP 提取逻辑**，提升在反向代理\u002F转发等场景下的识别准确性与审计可靠性。\r\n\r\n- **修复与体验优化**\r\n  - **文档展示一致性**：修复 README 中的 UI 截图链接，避免引用不一致导致的展示异常。\r\n  - **界面视觉一致性**：更新字体样式表与字体族配置，统一整体设计表现与细节观感。\r\n\r\n- **维护**\r\n  - **依赖更新**\r\n    - fastapi **0.127.0 → 0.128.0**（#85）\r\n    - antd **6.1.2 → 6.1.3**（#84）\r\n    - typescript-eslint **8.50.1 → 8.51.0**（#86）\r\n\r\n---\r\n\r\n**Foxel 团队**\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fcompare\u002Fv1.5.3...v1.5.4","2026-01-02T03:44:18",{"id":247,"version":248,"summary_zh":249,"released_at":250},198188,"v1.5.3","## Foxel v1.5.3 发布 🎉\r\n\r\n### 亮点\r\n\r\n- **功能增强**\r\n  - **审计日志（Audit Logs）可读性提升**：调整表格列宽与对齐方式，信息展示更清晰，便于快速浏览与定位关键字段。\r\n  - **Docker 部署更灵活**：支持在 Docker Compose 与 entrypoint 脚本中进行**动态端口配置**，适配更多部署环境与端口规划需求。\r\n\r\n- **修复与体验优化**\r\n  - **审计日志清理交互优化**：更新“清空日志”确认提示文案，并移除冗余校验逻辑，操作更直观、流程更顺滑。\r\n\r\n- **维护**\r\n  - **插件模块精简**：移除未使用的 repository 相关代码，并简化部分 UI 结构，为后续功能迭代做准备。\r\n\r\n---\r\n\r\n**Foxel 团队**\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fcompare\u002Fv1.5.2...v1.5.3","2025-12-30T09:37:08",{"id":252,"version":253,"summary_zh":254,"released_at":255},198189,"v1.5.2","## Foxel v1.5.2 发布 🎉\r\n\r\n### 亮点\r\n\r\n- **功能增强**\r\n  - **S3 分片上传（Multipart Upload）支持**：实现分片上传核心能力，并新增\u002F完善相关 API endpoints，提升大文件上传的稳定性与可恢复性。\r\n\r\n- **修复与体验优化**\r\n  - **S3 签名鉴权增强**：优化 S3 Signature Authorization 处理逻辑，兼容性更好。\r\n  - **错误响应改进**：完善异常场景下的错误返回与提示信息，便于定位问题与排查故障。\r\n\r\n- **维护**\r\n  - **Funding 链接清理**：更新 funding URL，移除末尾多余的 `.html`，保持配置规范一致。\r\n\r\n---\r\n\r\n**Foxel 团队**\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fcompare\u002Fv1.5.1...v1.5.2","2025-12-30T04:56:08",{"id":257,"version":258,"summary_zh":259,"released_at":260},198190,"v1.5.1","## Foxel v1.5.1 发布 🎉\r\n\r\n### 亮点\r\n\r\n- **功能增强**\r\n  - **审计日志（Audit）支持**：为 **S3 \u002F WebDAV 映射相关 API** 增加审计日志记录，便于追踪关键操作与排查问题。\r\n  - **S3 Region 体验优化**：Region 允许留空，并增强输入引导与提示。\r\n   \r\n- **修复与体验优化**\r\n    - `setConfig` 支持可选 value，并修复相关 API endpoint。\r\n    - `ConfigProvider` 的 `cssVar` 属性更新，并改进 HTTP Method 标签渲染效果。\r\n\r\n\r\n- **依赖与维护**\r\n  - **依赖更新与清理**：更新前后端依赖，移除未使用包；多项 Dependabot 升级合并。\r\n\r\n---\r\n\r\n**Foxel 团队**\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fcompare\u002Fv1.5.0...v1.5.1","2025-12-29T08:58:21",{"id":262,"version":263,"summary_zh":264,"released_at":265},198191,"v1.5.0","# Foxel v1.5.0 发布 🎉\r\n\r\n本次发布围绕「存储适配器生态扩展」「视频库能力落地」「安装与运维体验增强」三大方向推进：新增并完善多类适配器接入能力，打通视频库处理与展示链路，进一步优化安装与管理工具；同时引入 Dependabot 自动化依赖更新、补齐审计日志关键字段，并持续打磨前端交互与后端稳定性，整体提升系统的可扩展性与长期维护效率。\r\n\r\n---\r\n\r\n## 亮点\r\n\r\n### 存储适配器生态扩展（Adapters）\r\n- 新增 **Dropbox 适配器**：支持文件管理能力，并完善本地化（Localization）支持，便于在多语言环境下更自然地使用与配置。\r\n- 新增 **AList \u002F OpenList 适配器类型**：补齐对应的配置 Schema，方便后续接入与统一管理多种外部文件源。\r\n- 优化 **S3 Region 处理逻辑**：允许 Region 为空输入，并增强配置引导与提示，降低首次配置成本、减少误配。\r\n\r\n### 视频库（Video Library）能力落地\r\n- 上线视频库处理流程与 API 集成，形成端到端闭环能力（数据处理 → 接口 → 前端展示）。\r\n- 优化视频封面渲染与加载体验：新增\u002F完善骨架屏（Skeleton）、统计信息展示与头部样式，提升浏览流畅度与信息密度。\r\n- 增强视频缩略图生成逻辑，并支持获取视频转码 URL，为后续播放与转码链路扩展打下基础。\r\n\r\n### 安装、CLI 与运维体验增强\r\n- 安装器（setup）体验优化：改进交互流程与默认值策略，让首次部署更顺滑、更少踩坑。\r\n- 新增 `foxel_cli.py`：提供用户密码管理能力，并支持创建\u002F维护 symlink，便于在服务器环境快速执行常用管理操作。\r\n\r\n### 审计与可观测性增强\r\n- 审计日志新增 **客户端 IP 提取**，补齐关键溯源字段，便于安全审计、问题定位与访问分析。\r\n\r\n### 稳定性与工程化改进\r\n- 数据库：为 `aiosqlite` 增加连接处理补丁，提升连接行为的可靠性与一致性。\r\n- 异常处理与代码清晰度：修复错误处理逻辑中未使用的 catch 变量等问题，减少噪声并提高可读性。\r\n- 依赖治理：引入 **Dependabot 配置**，并更新多项依赖（后端与前端构建\u002FCI 相关 Action、Python\u002FJS 依赖等），降低供应链风险与维护成本。\r\n\r\n---\r\n\r\n## 升级建议 \u002F 注意事项\r\n\r\n- 建议所有用户升级至 v1.5.0，以获得更丰富的存储接入能力、视频库新功能与更完善的运维工具链。\r\n- 升级后建议重点验证以下内容：\r\n  - **适配器配置兼容性**：Dropbox \u002F AList \u002F OpenList \u002F S3 的配置项是否与现有环境一致，尤其是 S3 Region 允许为空后，你的默认 Region\u002F端点策略是否符合预期；\r\n  - **视频库流程**：视频处理、封面\u002F缩略图生成、统计信息展示、转码 URL 获取是否在你的存储与算力环境下稳定运行；\r\n  - **CLI 使用路径**：`foxel_cli.py` 与 symlink 的安装位置、权限、运行用户是否符合你的部署规范（容器环境需特别关注挂载与权限）；\r\n  - **审计日志**：客户端 IP 是否能在反向代理\u002F网关（如 Nginx、Traefik、Cloudflare）场景正确获取（必要时检查 `X-Forwarded-For` 等头的传递策略）；\r\n  - **数据库行为**：若使用 SQLite\u002Faiosqlite，请关注升级后连接管理是否符合预期（并发访问、长连接、异常退出后的恢复等）。\r\n\r\n---\r\n\r\n## 完整变更对比（代码与提交）\r\nhttps:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fcompare\u002Fv1.4.0...v1.5.0\r\n\r\n感谢每一位参与设计、开发与使用 Foxel 的伙伴！— Foxel 团队","2025-12-23T08:15:03",{"id":267,"version":268,"summary_zh":269,"released_at":270},198192,"v1.4.0","# Foxel v1.4.0 发布 🎉\r\n\r\n本次发布围绕「部署体验优化」「虚拟文件系统模块拆分」与「备份与日志可观测性增强」展开，同时完善后端异常处理链路，进一步提升系统稳定性与可维护性。\r\n\r\n---\r\n\r\n### 亮点\r\n\r\n- 部署与镜像优化  \r\n  - 新增前端 SPA 无需依赖 Nginx 的服务模式，降低部署复杂度，便于在多种运行环境中快速上线。  \r\n  - 精简 Docker 镜像体积，减少拉取时间与资源占用，提升交付与升级效率。\r\n\r\n- 虚拟文件系统结构重构  \r\n  - 将虚拟文件系统（Virtual FS）的路径映射与搜索模块进行拆分重构，模块职责边界更清晰。  \r\n  - 优化内部结构为后续扩展搜索能力（如多字段筛选、跨源索引）与自定义映射逻辑打下基础。\r\n\r\n- 备份数据模型扩展  \r\n  - 扩展 `BackupData` 模型，支持承载更丰富的备份元信息与数据结构。  \r\n  - 为后续多版本备份策略、更精细的恢复与迁移能力提供模型基础。\r\n\r\n- 日志可观测性提升  \r\n  - 优化日志详情展示，增强关键信息的可读性与结构化程度。  \r\n  - 便于在运维与排查问题时快速定位核心字段、上下文信息与异常链路。\r\n\r\n- 后端异常处理增强  \r\n  - 新增\u002F完善 HTTP 与参数校验（Validation）相关的异常处理分支。  \r\n  - 在错误场景下提供更明确的响应与日志输出，减少前后端沟通成本并提升错误诊断效率。  \r\n  - 优化后端模块结构，统一部分通用处理逻辑，提升整体可维护性。\r\n\r\n---\r\n\r\n### 升级建议 \u002F 注意事项\r\n\r\n- 建议所有用户升级，以获得更精简的部署体验与更完善的日志与错误处理能力。  \r\n- 升级后建议重点验证以下内容：\r\n  - 新的 SPA 服务方式在你的部署环境中（Docker、本机、云平台等）能否正常启动与访问，是否存在静态资源或路由问题；\r\n  - Docker 镜像更新后启动参数、环境变量与原有版本是否兼容，如有自定义 Entrypoint 或反向代理配置请同步检查；\r\n  - 虚拟文件系统的映射与搜索相关功能是否仍按预期工作（包括路径映射规则、生效优先级与搜索结果准确性）；\r\n  - 备份相关功能在扩展后的 `BackupData` 模型下是否能正常创建、导出与恢复数据；\r\n  - 日志详情页面或接口输出是否清晰地展示了请求、上下文与错误信息，便于快速定位问题；\r\n  - 针对常见的 HTTP 错误与参数校验错误（如必填字段缺失、格式不合法），前端\u002F调用方是否能收到更明确的错误提示且无意外异常。\r\n\r\n---\r\n\r\n完整变更对比（代码与提交）：  \r\nhttps:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fcompare\u002Fv1.3.8...v1.4.0\r\n\r\n感谢每一位参与设计、开发与使用 Foxel 的伙伴！— Foxel 团队","2025-12-09T07:25:03",{"id":272,"version":273,"summary_zh":274,"released_at":275},198193,"v1.3.8","# Foxel v1.3.8 发布 🎉\r\n\r\n此次发布主要侧重对象存储适配器的扩展与后端兼容性增强，进一步完善 S3 路由的边界处理，并引入 Google Drive 适配器以支持更多存储场景。同时，修复了 WebDAV 文件信息的精准性，并优化了部分系统组件体验。\r\n\r\n### 亮点\r\n\r\n- S3 路由边界行为处理\r\n  - 新增 S3 路由端点，支持带斜杠结尾的对象列举（list），修复部分特殊路径下对象检索的准确性，提高 Bucket 场景兼容性。\r\n\r\n- 对象存储适配器扩展\r\n  - 新增 Google Drive 存储适配器，支持将 Google Drive 作为后端挂载，同时完善适配器类型的归一化（normalize）与参数验证，提升多源存储集成体验。\r\n\r\n- WebDAV 兼容性修复\r\n  - 改进 WebDAV 文件信息获取，对缺失 size 和 modification time 的文件提供默认处理，提升文件展示及后续操作的准确性。\r\n\r\n- 系统组件与开发体验优化\r\n  - 整合 .gitignore 文件，统一忽略规则，简化项目协作与开发环境一致性维护。\r\n  - 优化 Flex 组件在加载状态下的宽度表现，增强 UI 的一致性和稳定性。\r\n\r\n---\r\n\r\n### 升级建议 \u002F 注意事项\r\n- 推荐所有用户升级以获得更广泛的对象存储支持与更流畅的操作体验。\r\n- 升级后验证：\r\n  - S3 路由带斜杠结尾的对象列举是否符合预期；\r\n  - 新增 Google Drive 挂载适配器在后端配置与使用流程是否通畅；\r\n  - WebDAV 文件信息（size, modification time）在缺失时的处理是否准确且无报错；\r\n  - 系统组件的展示与上传、检索等功能是否保持稳定。\r\n\r\n---\r\n\r\n完整变更对比（代码与提交）：  \r\nhttps:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fcompare\u002Fv1.3.7...v1.3.8\r\n\r\n感谢每一位关注并贡献 Foxel 的伙伴！— Foxel 团队","2025-11-27T10:09:22",{"id":277,"version":278,"summary_zh":279,"released_at":280},198194,"v1.3.7","# Foxel v1.3.7 发布 🎉\r\n\r\n本次发布聚焦对象存储（S3）与 WebDAV 的映射与兼容性改进，同时完善了后端路由对上传与检索的处理，并同步更新了 Nginx 配置与版本信息，旨在提升文件存取的稳定性与系统集成体验。\r\n\r\n### 亮点\r\n\r\n- S3 映射与兼容性增强\r\n  - 在系统中新增 S3 映射配置与对应的 API 端点，使 Foxel 能更灵活地将对象存储作为后端映射挂载并对外提供服务。\r\n  - 在 S3 路由中增强对象检索与上传处理逻辑，优化了对常见异常场景的容错与重试策略，提升上传成功率与下载稳定性。\r\n\r\n- Nginx 与 S3 集成配置\r\n  - 在 Nginx 配置中加入 S3 endpoint 支持，便于通过反向代理或静态转发更高效地暴露对象存储资源，支持更广泛的部署拓扑。\r\n\r\n- WebDAV 映射与系统设置 UI\r\n  - 新增 WebDAV 映射配置项，并在「系统设置」中提供对应的 UI，方便管理员在 Web 面板中配置与管理 WebDAV 后端挂载。\r\n\r\n---\r\n\r\n### 升级建议 \u002F 注意事项\r\n- 强烈建议所有用户尽快升级以获得更稳定的对象存取与 WebDAV 支持。\r\n- 升级后验证：\r\n  - S3 映射的挂载与列举（list）\u002F下载（get）\u002F上传（put）操作是否正常；\r\n  - WebDAV 映射在系统设置 UI 中是否可见且可保存、编辑；\r\n  - 常见上传失败场景（超时、中断）能否按预期重试或返回明确错误信息。\r\n\r\n---\r\n\r\n完整变更对比（代码与提交）：  \r\nhttps:\u002F\u002Fgithub.com\u002FDrizzleTime\u002FFoxel\u002Fcompare\u002Fv1.3.6...v1.3.7\r\n\r\n感谢每一位关注并贡献 Foxel 的同学！— Foxel 团队","2025-11-10T03:06:36"]