Lsky-Upload Pro 插件

Typecho 粘贴图片自动上传到兰空图床插件

📋 功能介绍

LskyProUpload 是一个 Typecho 插件，允许用户在文章/页面编辑器中直接粘贴图片，自动上传到兰空图床（Lsky Pro），并自动返回 Markdown 格式的图片链接，从isYangs的插件改版优化而来。

✨ 核心特性

• 🎯 即粘即传 - Ctrl+V 粘贴截图，自动上传无需手动操作
• 📝 自定义名称 - 上传前可输入自定义图片名称（支持直接回车使用默认名）
• 📊 实时进度 - 显示上传进度条，实时反馈上传状态
• 🔗 自动插入 - 上传完成后自动在粘贴位置插入 Markdown 链接
• 🖼️ 智能位置 - 支持在编辑器的任意位置粘贴，链接插入在正确位置
• ✅ 格式验证 - 自动验证文件格式，仅支持图片文件
• 🎨 兼容性强 - 支持 CodeMirror 编辑器、textarea、contenteditable 等多种编辑器

🚀 快速开始

1. 安装插件

1. 将插件文件解压到 Typecho/usr/plugins/LskyProUpload/ 目录
2. 登录 Typecho 后台 → 插件管理
3. 找到 LskyProUpload Pro+ 插件，点击启用

2. 配置插件

启用插件后，点击设置按钮，填写以下信息：

获取 Token 步骤：

1. 登录兰空图床后台
2. 进入 设置 → API Token
3. 生成新的 Token
4. 复制 Token 值粘贴到插件设置中

💡 使用方法

基础步骤

1. 进入编辑页面

   • 点击后台 撰写 → 新建文章或编辑已有文章

2. 粘贴图片

   • 在编辑器中点击要插入图片的位置
   • 按 Ctrl+V（Windows）或 Cmd+V（Mac）粘贴截图

3. 输入图片名称

   • 弹出对话框，默认显示文件名（去除扩展名）
   • 修改为自定义名称，或直接按 Enter 使用默认名称

4. 查看上传进度

   • 显示上传进度条，实时显示上传百分比
   • 上传完成后自动关闭进度条

5. 自动插入链接

   • Markdown 链接自动插入到粘贴位置
   • 显示"图片上传成功"提示

完整示例

# 我的文章

这是第一段内容。[在这里粘贴图片 Ctrl+V]

这是第二段内容。

粘贴并上传图片后：

# 我的文章

这是第一段内容。![示例图片](https://lsky.yeyhome.com:8443/i/2026/02/28/xxxxx.png)

这是第二段内容。

🎨 功能演示

粘贴图片对话框

┌─────────────────────────────────┐
│  请输入图片名称                 │
│  不包含扩展名，直接回车使用默认名称 │
│                                 │
│  [示例图片________________]      │
│                                 │
│  [取消]      [确认]             │
└─────────────────────────────────┘

上传进度显示

┌─────────────────────────┐
│  正在上传图片...        │
│  ▓▓▓▓▓░░░░░░░░░░░ 32%  │
└─────────────────────────┘

⚙️ 高级配置

支持的图片格式

插件支持以下图片格式：

• 常见格式：JPG、PNG、GIF、WebP
• 其他格式：BMP、TIFF、ICO、PSD

兰空图床存储策略

如果兰空图床配置了多个存储策略，可以在插件设置中指定 Strategy_id：

1. 登录兰空图床后台
2. 进入 管理 → 存储策略
3. 获取策略 ID
4. 填写到插件设置中

🐛 故障排查

问题 1：粘贴图片没有反应

可能原因：

• 脚本加载失败
• 浏览器不支持 Clipboard API

解决方案：

1. 清空浏览器缓存（Ctrl+Shift+Delete）
2. 重新刷新页面
3. 尝试更换浏览器（推荐 Chrome、Firefox 最新版本）

问题 2：上传失败，显示"图片上传失败"

可能原因：

• 兰空图床 API 配置有误
• Token 已过期或无效
• 网络连接问题
• 图片过大

解决方案：

1. 检查 API 地址是否正确
2. 重新生成并更新 Token
3. 检查服务器网络是否能访问兰空图床
4. 确保图片大小在合理范围内

问题 3：对话框无法关闭

解决方案：

• 按 Esc 键关闭对话框
• 点击对话框外的半透明遮罩区域

📊 系统要求

🔒 安全性说明

• ✅ Token 不在前端传输，后端认证
• ✅ 文件格式严格校验，仅允许图片文件
• ✅ 所有操作都在后台进行，避免直接暴露 API

📝 更新日志

v1.0.0 (Pro+)

新增功能：

• ✨ 完整的粘贴上传功能
• ✨ 自定义图片名称对话框
• ✨ 实时上传进度显示
• ✨ 支持多种编辑器（CodeMirror、textarea 等）
• ✨ 自动在正确位置插入 Markdown 链接
• ✨ 实时成功/失败提示

优化：

• 🚀 代码精简优化，删除调试代码
• 🚀 提高上传稳定性和兼容性
• 🚀 改进错误提示信息

🤝 贡献

如有 Bug 反馈或功能建议，欢迎提出！

📄 许可证

MIT License

✉️ 联系方式

• 博客：https://www.yeyhome.com
• 问题反馈：请在评论区留言

祝你使用愉快！ 🎉

如有任何问题或建议，欢迎在文章评论区反馈。

📋 下载地址

LskyProUpload