obsidian-plugin/bobostudio_obsidian-imgur-plugin
1
0
Fork 0
mirror of https://github.com/bobostudio/obsidian-imgur-plugin.git synced 2026-07-22 11:40:32 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
71 commits 6 branches 18 tags 9 MiB
TypeScript 96.3%
CSS 2.3%
JavaScript 1.4%
Find a file
bobostudio b6ec172c7e feat: 添加外链图片同步到COS功能 
- 支持识别并上传Markdown中的外链图片到COS
- 自动从URL获取图片并推断正确的MIME类型
- 将外链图片URL替换为COS链接
- 修复菜单名称为"同步COS"
2026-04-06 11:18:32 +08:00
images fix: update banner image and adjust formatting in README.md 2026-02-11 21:50:24 +08:00
.editorconfig Initial commit 2024-12-20 15:43:05 +08:00
.eslintignore Initial commit 2024-12-20 15:43:05 +08:00
.eslintrc Initial commit 2024-12-20 15:43:05 +08:00
.gitignore feat: add COS image upload functionality and update version to 1.2.5 2026-03-03 23:10:02 +08:00
.npmrc Initial commit 2024-12-20 15:43:05 +08:00
esbuild.config.mjs Initial commit 2024-12-20 15:43:05 +08:00
LICENSE update docs 2024-12-21 16:18:25 +08:00
main.ts feat: 添加外链图片同步到COS功能 2026-04-06 11:18:32 +08:00
manifest.json feat: 添加外链图片同步到COS功能 2026-04-06 11:18:32 +08:00
package-lock.json feat: 新增图片有效期刷新功能 2025-04-25 11:05:28 +08:00
package.json feat: 添加外链图片同步到COS功能 2026-04-06 11:18:32 +08:00
README.md feat: update README to reflect multi-format file upload support and usage instructions 2026-03-26 17:09:50 +08:00
styles.css feat(plugin): Add image management and backup functionality 2026-02-05 15:50:33 +08:00
tsconfig.json update: 更新插件功能 2024-12-21 15:37:50 +08:00
version-bump.mjs Initial commit 2024-12-20 15:43:05 +08:00
versions.json update manifest 2024-12-21 21:28:34 +08:00

README.md

banner

腾讯云 COS 图床插件

这是一个用于 Obsidian 的图片上传插件，可将笔记中的图片自动上传到腾讯云 COS，实现云端存储、管理与备份。

新增功能 (2026-03-26)

  • 支持拖拽/粘贴上传多格式文件（PDF、MP3、MP4、WAV、DOC、DOCX、XLS、XLSX、PPT、PPTX、ZIP、MOV、WebM）

  • 本地和在线笔记备份，备份路径自定义

  • 鼠标悬浮图片，支持拖拽图片改图片大小(支持本地和线上图片)

  • 图片管理功能，可查看和删除已上传的图片，支持面板和命令方式打开

  • 新增设置图片链接的有效期，新增测试连接功能

  • 新增是否开启公有读存储桶

备份笔记演示

笔记备份

笔记备份

注意：

  • 本地笔记备份：这篇笔记的图片都是本地链接还没上传与备份
  • 在线笔记备份：这篇笔记的图片都是线上链接还没备份

拖拽图片演示

拖拽图片

新增的设置

设置

  • 备份路径支持自定义，默认当前笔记仓库下

  • 新增设置图片链接的有效期 20年,50年,永久

  • 测试连接可以调试你配置是否正常

设置打开图片管理面板

图片管理删除

命令打开图片管理面板

图片管理删除命令

是否开启公有读存储桶

腾讯云进入 COS 控制台 找到你的存储桶 → 权限管理 → 存储桶访问权限设置

公有读存储桶

公有读存储桶

开启公有读存储桶 图片为短链接如 https://xxx.com/20260210143554.png

建议：如果图片是公开的（如博客配图），可以开启公有读； 如果图片包含隐私内容，保持私有读模式更安全。

功能特点

  • 支持拖拽、复制粘贴上传图片
  • 自动替换本地图片链接为云端链接
  • 支持图片悬浮拖拽调整大小（本地与线上图片均支持）
  • 支持本地笔记备份与在线笔记备份，且备份路径可自定义
  • 支持图片管理面板（预览、分页、单选/全选、批量删除）
  • 支持通过命令面板或设置页快速打开图片管理
  • 支持图片链接有效期设置（20年、50年、永久）与刷新有效期
  • 支持测试连接，快速校验 COS 配置是否可用
  • 支持公有读存储桶开关，适配公开图片与私有图片场景
  • 支持存储桶地域选择与自定义存储路径前缀
  • 支持图片格式（PNG、JPG、JPEG、GIF、SVG、WebP）
  • 支持多格式文件上传（PDF、MP3、MP4、WAV、DOC、DOCX、XLS、XLSX、PPT、PPTX、ZIP、MOV、WebM）

新手快速上手（3分钟）

  1. 在腾讯云创建 COS 存储桶，并准备好 SecretId / SecretKey
  2. 在 Obsidian 安装并启用插件
  3. 在插件设置填写 SecretId、SecretKey、Bucket、Region
  4. 点击“测试连接”确认配置可用
  5. 在笔记中直接拖拽或粘贴图片，自动上传并替换为云端链接

使用前准备

  1. 注册腾讯云账号并开通 COS 服务 开通 COS 服务
  2. 创建存储桶，记录存储桶名称（Bucket）和所在地域（Region）
  3. 获取 SecretId 和 SecretKey
  4. 访问 腾讯云控制台
  5. 进入「访问密钥」-> API 密钥管理

获取密钥

跨域访问 CORS 设置（注意）

复制到来源 Origin 的输入框内

app://obsidian.md

跨域访问 CORS 设置1 跨域访问 CORS 设置2

❗❗❗ 注意想在手机上使用需要把 app://obsidian.md 改成 *

手机端安装方法(以 IOS 为例，安卓同理)
  1. 打开 Obsidian 设置
  2. 点击 Community plugins
  3. 搜索 tencent
  4. 安装并开启插件
  5. 填写图床信息
  6. 笔记上传图片
{1} {2} {3}
{4} {5} {6}
{7} {8} {9}
{10} {11}

电脑端安装方法

  1. 打开 Obsidian 设置
  2. 进入 "第三方插件" -> "浏览"
  3. 搜索 "Obsidian Imgur Plugin" 或者浏览器访问 Obsidian Imgur Plugin
  4. 点击安装并启用插件

启用插件

配置说明

  1. 进入插件设置页面
  2. 填写以下信息：
    • SecretId：腾讯云 API 密钥 ID
    • SecretKey：腾讯云 API 密钥 Key
    • Bucket：存储桶名称（例如：my-bucket-1250000000）
    • Region：存储桶所在地域
    • 存储路径前缀：文件在 COS 中的目录（例如：images）

存储路径前缀说明

比如你设置 img

存储路径前缀说明1

那你的 COS 的图片就会上传到 /img 文件夹下

存储路径前缀说明1

使用方法

方式一：拖拽上传

  • 直接将图片文件拖拽到编辑器中
  • 插件会自动上传图片并插入云端链接
  • 支持拖拽非图片文件（需在设置中开启"启用多格式文件上传"）

方式二：复制粘贴

  • 复制图片后，直接在编辑器中粘贴
  • 插件会自动上传图片并插入云端链接
  • 支持粘贴非图片文件（需在设置中开启"启用多格式文件上传"）

方式三：本地/线上笔记备份

  1. 在插件设置中先配置备份路径（默认在当前仓库下，可自定义）
  2. 按需选择备份方式并执行
  3. 备份类型说明：
    • 本地笔记备份：适用于图片仍为本地链接、尚未上传/备份的笔记
    • 在线笔记备份：适用于图片已是线上链接、尚未备份的笔记
  4. 执行后会按设置路径生成对应备份文件

方式四：图片管理

  1. 通过命令面板：

    • 按 Ctrl+P（Mac: Cmd+P）打开命令面板
    • 输入 "管理COS图片" 并选择该命令

  2. 通过设置页面：

    • 进入插件设置页面
    • 点击 "图片管理" 部分的 "打开图片管理" 按钮

  3. 功能说明：

    • 查看配置的存储路径下所有已上传的图片
    • 支持图片预览和基本信息显示（文件名、大小、上传时间）
    • 支持单选/全选图片
    • 支持批量删除选中的图片，删除前会弹出确认对话框
    • 支持分页加载，避免一次性加载过多图片
    • 删除操作会同步到COS，确保云端存储的一致性

方式五：多格式文件上传

  1. 在插件设置中开启 "启用多格式文件上传" 开关
  2. 默认支持的文件格式：pdf,mp3,mp4,wav,doc,docx,xls,xlsx,ppt,pptx,zip,mov,webm
  3. 如需添加其他格式，可在 "允许的文件类型" 设置中添加扩展名（用英文逗号分隔）
  4. 拖拽或粘贴非图片文件到编辑器中，插件会自动上传并插入链接
  5. 注意：非图片文件插入的是 [文件名](URL) 格式的链接

操作预览

操作预览

注意事项

  1. 首次使用请确保已正确配置腾讯云 COS 相关信息
  2. 上传前请确保网络连接正常
  3. 建议定期检查存储桶用量，避免超出配额
  4. 请妥善保管 SecretId 和 SecretKey，不要泄露给他人
  5. 存储路径前缀不要以斜杠开头或结尾

支持与反馈

如果您在使用过程中遇到任何问题，或有功能建议，请通过以下方式反馈：

打赏

打赏

许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

Copyright (c) 2024 bobostudio