本地图床服务器 (Local Image Server)

为 Eagle 中的本地图片和视频提供 HTTP 访问服务，自动生成链接和 Markdown 格式

📖 简介

本地图床服务器是一个 Eagle 插件，它可以在本地启动一个 HTTP 服务器，为你在 Eagle 中管理的图片和视频提供 Web 访问服务。你可以轻松获取图片的 HTTP 链接，并在 Markdown 文档、网站或其他需要图片链接的场景中使用。

主要特性

• 🚀 本地HTTP服务器：在本地启动HTTP服务器，无需上传到云端
• 📝 Markdown支持：自动生成Markdown格式的图片链接
• 📁 文件夹分类：按Eagle文件夹自动组织图片链接
• 🌐 多网络支持：支持本地、IPv4和IPv6访问
• 🎨 总览页面：现代化的图片总览和管理界面
• 🔄 后台服务：插件窗口关闭后服务器继续运行
• 🌍 多语言：支持中文和英文界面

🚀 快速开始

安装

1. 将插件文件夹复制到 Eagle 的插件目录
2. 重启 Eagle 或在插件设置中启用该插件
3. 插件会自动启动本地服务器

使用方法

1. 生成图片链接

1. 在 Eagle 中选中一个或多个图片或视频
2. 打开"本地图床服务器"插件
3. 点击"生成选中图片的本地链接"按钮
4. 链接会自动复制到剪贴板

2. 复制Markdown格式

1. 选中图片或视频
2. 点击"复制所有选中项的MD"按钮
3. Markdown格式的链接会自动复制到剪贴板

3. 查看图片总览

1. 点击"打开图片总览页面"按钮
2. 在新窗口中浏览所有已生成链接的图片
3. 支持搜索、筛选、按文件夹分类查看

📋 功能详解

支持的格式

图片格式：

• JPG / JPEG
• PNG
• GIF
• WebP
• SVG
• BMP
• ICO

视频格式：

• MP4
• WebM
• AVI
• MOV
• MKV
• FLV
• WMV
• M4V

链接格式

链接格式为：http://localhost:端口号/文件夹ID/文件名

例如：

http://localhost:8000/abc123/image.jpg

如果文件名包含特殊字符，会自动进行URL编码。

访问方式

插件界面会显示三种访问地址：

1. 本地访问：http://localhost:端口号

   • 仅在当前电脑上可访问
   • 适用于本地开发或文档编写

2. 局域网IPv4访问：http://192.168.x.x:端口号

   • 同一局域网内的设备可以访问
   • 适用于在手机、平板等设备上查看图片

3. 局域网IPv6访问：http://[IPv6地址]:端口号

   • 如果系统支持IPv6，会显示IPv6地址
   • 适用于IPv6网络环境

图片总览页面

图片总览页面提供以下功能：

功能特性

• 文件夹分类：左侧边栏显示所有文件夹，点击可快速筛选
• 搜索功能：支持搜索图片名称、注释、链接、标签等
• 视图切换：网格视图和列表视图
• 图片预览：点击图片可放大查看
• 快速复制：鼠标悬停显示复制按钮
• 响应式设计：支持桌面和移动设备

使用方法

1. 浏览图片：默认显示所有图片，使用网格布局
2. 按文件夹筛选：点击左侧边栏的文件夹名称
3. 搜索图片：在顶部搜索框输入关键词
4. 复制链接：
   • 网格视图：鼠标悬停在图片上，点击"复制链接"或"复制MD"
   • 列表视图：点击每行的复制按钮
5. 查看大图：点击图片打开预览窗口
6. 切换视图：点击顶部的"网格"或"列表"按钮

后台服务模式

插件运行在服务模式下，这意味着：

• ✅ Eagle 启动时自动启动服务器
• ✅ 关闭插件窗口后服务器继续运行
• ✅ 服务器会在 Eagle 关闭或插件禁用时才停止
• ✅ 可以随时打开插件窗口查看服务器状态

⚙️ 技术说明

服务器端口

• 服务器默认从端口 8000 开始尝试
• 如果端口被占用，会自动尝试下一个端口（8001, 8002...）
• 界面会显示当前使用的端口号

服务器健康检查

访问 http://localhost:端口号/health 可以检查服务器状态。

性能优化

• 图片采用懒加载，提升加载速度
• 大量图片时使用分页显示
• 服务器使用流式传输，减少内存占用

🔧 常见问题

Q: 服务器启动失败怎么办？

A: 请检查：

1. 端口是否被其他程序占用
2. 防火墙是否阻止了端口访问
3. 查看 Eagle 控制台的错误日志

Q: 局域网设备无法访问？

A: 请确保：

1. 设备连接到同一网络
2. 防火墙允许该端口访问
3. 使用正确的IPv4或IPv6地址

Q: 图片链接失效了？

A: 链接只在服务器运行时有效：

1. 确保 Eagle 正在运行
2. 确保服务器已启动（查看插件界面状态）
3. 确保图片文件未被移动或删除

Q: 如何停止服务器？

A: 服务器会在以下情况停止：

• 关闭 Eagle
• 禁用该插件

如果需要手动停止，可以暂时禁用插件。

Q: 支持自定义端口吗？

A: 当前版本自动分配端口。如果需要自定义端口，请等待后续版本更新。

📝 使用示例

Markdown文档

![图片描述](http://localhost:8000/folder123/image.jpg)

HTML

<img src="http://localhost:8000/folder123/image.jpg" alt="图片描述">

视频链接

<video src="http://localhost:8000/folder456/video.mp4" controls></video>

🌐 多语言支持

插件支持以下语言：

• 🇨🇳 简体中文
• 🇬🇧 English

界面语言会自动跟随 Eagle 的语言设置。

📄 许可证

本插件为开源项目，欢迎贡献和反馈。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📞 支持

如有问题或建议，请通过以下方式联系：

• 提交 Issue
• 发送邮件反馈

---

版本: 1.0.0
最后更新: 2024-12-XX