# openlist **Repository Path**: deshuofa/openlist ## Basic Information - **Project Name**: openlist - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-08-27 - **Last Updated**: 2025-08-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # AList 文件浏览器插件 > 🚀 将 AList(OpenList) 文件管理器无缝集成到思源笔记侧边栏的强大插件 [![GitHub release](https://img.shields.io/github/v/release/jeasionr-ui/openlist)](https://github.com/jeasionr-ui/openlist/releases) [![License](https://img.shields.io/github/license/jeasionr-ui/openlist)](https://github.com/jeasionr-ui/openlist/blob/main/LICENSE) [![Downloads](https://img.shields.io/github/downloads/jeasionr-ui/openlist/total)](https://github.com/jeasionr-ui/openlist/releases) ## 📖 项目简介 **AList 文件浏览器插件** 为思源笔记用户提供了完整的文件管理解决方案。通过深度集成 AList(OpenList) 文件管理器，您可以： - 🗂️ 在思源笔记侧边栏中直接浏览和管理文件 - 📎 将 AList 文件无缝嵌入到笔记内容中 - 🔄 实现笔记与文件管理的一体化体验 - 🌐 支持本地和远程文件服务器访问 ## 💝 支持开发 如果这个插件对您有帮助，欢迎支持开发者： - 🎯 **自愿赞助**：0.5元/月起（完全自愿，无任何功能限制） - 🚀 **持续更新**：您的支持将激励我持续完善插件功能 - ⭐ **免费使用**：插件免费，赞助仅用于激励开发
支付宝赞助 微信赞助
扫码赞助支持开发 ❤️
## ✨ 功能特性 ### 🗂️ 文件管理 - ✅ **完整文件操作**：浏览、上传、下载、删除、重命名、移动 - 📁 **文件夹管理**：创建、删除、重命名、移动文件夹 - 🔄 **批量操作**：多选文件进行批量处理 - 🎯 **拖拽上传**：直观的拖拽式文件上传体验 - 🔍 **智能搜索**：快速定位和筛选文件 ### 🎬 多媒体预览 - 🖼️ **图片预览**：JPG、PNG、GIF、WebP、SVG、BMP - 🎥 **视频播放**：MP4、WebM、OGV、AVI、MOV - 🎵 **音频播放**：MP3、WAV、OGG、FLAC、AAC - 📄 **文档查看**：TXT、MD、JSON、XML、CSV - 📋 **PDF 支持**：在线 PDF 文档预览 ### 🔐 安全与认证 - 🔑 **令牌认证**：基于 AList 服务器的安全身份验证 - 🚀 **自动登录**：启动时自动连接服务器 - 👥 **权限控制**：完全遵循 AList 服务器权限设置 - 🛡️ **数据安全**：所有操作通过加密连接传输 ### 🌟 用户体验 - 🌍 **多语言支持**：中文、英文界面完整支持 - 📱 **响应式设计**：完美适配桌面端和移动端 - ⚡ **实时反馈**：文件操作进度实时显示 - 🎨 **现代界面**：简洁美观的用户界面设计 - 🔧 **智能错误处理**：友好的错误提示和自动恢复 ## 📦 安装方式 ### 🏪 方式一：思源笔记集市（推荐） 1. 📱 打开思源笔记应用 2. ⚙️ 进入 `设置` → `集市` → `插件` 3. 🔍 搜索 "**AList File Browser**" 或 "**openlist**" 4. ⬇️ 点击 `下载` 并启用插件 5. 🎉 安装完成，即可在侧边栏使用 ### 📦 方式二：手动安装 1. 🌐 访问 [GitHub Releases](https://github.com/jeasionr-ui/openlist/releases) 页面 2. ⬇️ 下载最新版本的 `alist.zip` 文件 3. 📁 解压到思源笔记工作空间的 `data/plugins/` 目录 4. 🔄 重启思源笔记应用 5. ✅ 在 `设置` → `集市` → `已下载` 中启用插件 > 💡 **提示**：推荐使用集市安装，可自动获取更新通知 ## ⚙️ 配置设置 ### 🔧 首次配置 #### 1. 打开插件设置 - 📋 进入 `设置` → `插件` → `AList 文件浏览器` #### 2. 配置连接参数 | 配置项 | 说明 | 示例 | |--------|------|------| | 🌐 **服务器地址** | AList 服务器的完整地址 | `http://localhost:5244`
`https://files.example.com` | | 👤 **用户名** | AList 服务器登录用户名 | `admin` 或您的用户名 | | 🔐 **密码** | 对应的登录密码 | 您的 AList 密码 | | 📁 **根路径** | 文件浏览的起始目录 | `/`（默认）或 `/documents` | | 🚀 **自动登录** | 启动时自动连接服务器 | ✅ 推荐开启 | #### 3. 保存设置 - 💾 点击 `保存` 按钮完成配置 - 🔄 插件将自动尝试连接服务器 ### 📋 AList 服务器要求 | 要求项目 | 最低要求 | 推荐配置 | |----------|----------|----------| | 🔢 **AList 版本** | v3.0+ | v3.8+ | | 🌐 **网络访问** | HTTP/HTTPS 可达 | HTTPS + 域名 | | 👥 **用户权限** | 读取权限 | 完整文件操作权限 | | 🔒 **安全设置** | 基础认证 | 启用 CORS + Token | > ⚠️ **注意**：确保思源笔记可以正常访问您的 AList 服务器地址 ## 🚀 使用指南 ### 🎯 基本操作流程 #### 1. 🔗 连接服务器 - 🖱️ 点击思源笔记侧边栏中的 **文件夹图标**（AList 文件浏览器） - ⚙️ 首次使用需要在插件设置中配置服务器地址、用户名和密码 - 🚀 启用自动登录后，每次打开会自动连接到 AList 服务器 - ✅ 连接成功后显示文件列表，失败时会显示详细错误信息 #### 2. 📁 文件浏览 - 📂 **目录导航**：点击文件夹名称进入子目录 - 🔙 **返回上级**：点击路径中的上级目录名称快速跳转 - 📍 **路径显示**：顶部显示当前完整路径 - 🔄 **刷新列表**：点击刷新按钮重新加载当前目录 #### 3. ⚡ 文件操作 - 👆 **文件预览**：点击文件名预览支持的文件类型（图片、视频、音频、PDF、Office文档、文本等） - ⬇️ **文件下载**：通过预览对话框或直接访问文件链接下载 - 📋 **复制链接**：获取文件的直接访问链接 - 🔗 **协议链接**：支持 `alist://` 协议链接，可在思源笔记中创建文件引用 ### 🚀 高级功能 #### 📦 文件管理操作 - ⬆️ **文件上传**：支持在线上传和离线下载两种模式 - 📁 **新建文件夹**：在当前目录创建新文件夹 - 🗑️ **删除操作**：删除选中的文件或文件夹 - 📋 **批量选择**：支持多选文件进行批量操作 - 🔄 **移动文件**：将文件或文件夹移动到其他目录 #### 🔍 文件预览功能 - 🖼️ **图片预览**：支持 JPG、PNG、GIF、WebP 等格式 - 🎬 **视频播放**：支持 MP4、WebM、AVI、MOV 等格式 - 🎵 **音频播放**：支持 MP3、WAV、FLAC、AAC 等格式 - 📄 **文档预览**：支持 PDF、Office 文档（Word、Excel、PowerPoint） - 📝 **文本查看**：支持 Markdown、TXT 等文本文件的渲染显示 #### ⚡ 上传与下载管理 - 📊 **上传进度**：实时显示文件上传进度 - 🌐 **离线下载**：支持通过 URL 进行离线下载 - 📋 **任务管理**：查看和管理上传/下载任务状态 - ⚙️ **上传选项**：可配置覆盖模式、流式上传等参数 ## 🔧 故障排除 ### 常见问题解决 | 问题 | 可能原因 | 解决方案 | |------|----------|----------| | 登录失败 | 服务器地址、用户名或密码错误 | 检查配置信息，确认 AList 服务器状态 | | 连接超时 | 网络问题或服务器不可达 | 检查网络连接，确认服务器地址正确 | | 上传失败 | 文件权限或存储空间不足 | 检查 AList 服务器的存储空间和权限设置 | | 插件无响应 | 插件未正确加载 | 重启思源笔记，确认插件已启用 | | 文件预览异常 | 文件格式不支持或文件损坏 | 尝试下载文件或使用其他工具打开 | ### ⚠️ 已知问题 | 问题描述 | 影响程度 | 临时解决方案 | 修复状态 | |----------|----------|--------------|----------| | 上传文件后不立即显示 | 🟡 中等 | 手动点击刷新按钮 | 🔄 开发中 | | 移动文件后原位置仍显示 | 🟡 中等 | 关闭功能组重新打开 | 🔄 开发中 | > 📝 **说明**：这些问题主要由 AList 缓存机制导致，我们正在开发自动刷新功能来解决 ### 调试模式 1. 在插件设置中启用 `调试模式` 2. 打开浏览器开发者工具 3. 查看 Console 标签页中的详细日志信息 4. 将错误信息反馈给开发者 ### 性能优化建议 - **大文件处理**：建议分批上传大量文件 - **网络优化**：使用稳定的网络连接 - **缓存清理**：定期清理浏览器缓存 ## 🤝 支持与反馈 ### 获取帮助 - 📧 **邮件联系**：[jeasionr@foxmail.com](mailto:jeasionr@foxmail.com) - 🐛 **问题反馈**：[GitHub Issues](https://github.com/jeasionr-ui/openlist/issues) - 💡 **功能建议**：欢迎在 GitHub 上提出新功能建议 - ⭐ **项目支持**：如果插件对您有帮助，请为项目点星 ### 贡献方式 - 🔍 **测试反馈**：报告使用中遇到的问题 - 📝 **文档改进**：帮助完善使用文档 - 🌐 **翻译贡献**：协助多语言本地化 - 💻 **代码贡献**：提交功能改进或修复 ## 📋 更新日志 ### 🎉 v1.0.0 (2025-01-05) - ✨ **核心功能**：完整的文件浏览和管理功能 - 🔗 **服务器集成**：AList 服务器深度集成支持 - 👀 **文件预览**：多种文件类型预览支持 - 📦 **批量操作**：批量文件操作功能 - 🎨 **界面优化**：现代化用户界面设计 - 🌍 **多语言**：中英文界面支持 ## 🛣️ 开发路线图 ### 🔄 v1.1.0 (计划中) - 🔧 修复缓存刷新问题 - ⚡ 自动刷新机制优化 - 🎯 文件操作体验改进 ### 🚀 v1.2.0 (规划中) - 🌐 更多语言支持 - 📱 移动端体验优化 - 🔍 高级搜索功能 - 🎨 主题定制支持 ## 📚 常见问题 (FAQ)
Q: 为什么上传文件后不立即显示？ **A:** 这是由于 AList 服务器的缓存机制导致的。解决方案： - 🔄 点击界面上的刷新按钮 - ⏱️ 等待 5-10 秒后自动刷新 - 🔧 我们正在开发自动刷新功能来解决此问题
Q: 移动文件后为什么原位置还显示文件？ **A:** 同样是缓存机制问题。解决方案： - 🔄 关闭侧边栏功能组，重新打开 - 🖱️ 点击刷新按钮更新文件列表 - ⚡ 即将推出的版本将自动处理此问题
Q: 插件支持哪些文件操作？ **A:** 支持完整的文件管理操作： - 文件：上传、下载、删除、重命名、移动、预览 - 文件夹：创建、删除、重命名、移动 - 批量操作：多选文件进行批量处理
Q: 如何报告问题或建议功能？ **A:** 您可以通过以下方式联系我们： - 在 [GitHub Issues](https://github.com/jeasionr-ui/openlist/issues) 提交问题 - 发送邮件至 [jeasionr@foxmail.com](mailto:jeasionr@foxmail.com) - 我们会及时回复并处理您的反馈
Q: 插件是否支持多个 AList 服务器？ **A:** 当前版本仅支持单个 AList 服务器连接。多服务器支持功能已列入开发计划，将在后续版本中提供。
Q: 文件上传有大小限制吗？ **A:** 上传限制主要取决于以下因素： - 🖥️ **AList 服务器配置**：查看服务器的上传大小限制 - 🌐 **网络环境**：建议大文件使用稳定网络上传 - 💾 **存储空间**：确保目标目录有足够存储空间 - 📊 **建议**：单文件建议不超过 2GB，以获得最佳体验
Q: 如何提高文件传输速度？ **A:** 优化传输速度的方法： - 🌐 **网络优化**：使用有线网络或稳定的 WiFi - 📦 **分批上传**：大量文件建议分批次上传 - 🔧 **服务器优化**：确保 AList 服务器性能良好 - ⚡ **并发控制**：避免同时进行过多文件操作