flymd-web-uploader

简单图床 easyImage2.0上传工具【flymd插件】

演示图文教程：图文教程

🚀 Web 图床上传插件 使用说明书 (V1.0.0)

📋 插件功能概述

功能	描述	触发方式
自定义上传	将本地图片上传到任何支持 multipart/form-data 的 Web API。	菜单项、右键菜单
粘贴自动上传	粘贴截图或图片文件时，自动上传并替换 Markdown 链接。	Ctrl/Cmd + V (粘贴)
拖拽自动上传	将本地图片拖拽到编辑器区域时，自动上传并插入 Markdown 链接。	拖拽文件
配置兼容	支持配置 URL、文件字段名、JSON 路径、自定义 Header 和 Body。	配置菜单

---

⚙️ 第一步：配置图床参数 (核心步骤)

1. 访问配置界面

1. 在 flyMD 编辑器中，点击 「插件」 或 「工具」 菜单。
2. 选择 「Web 图床」。
3. 点击 「⚙️ 打开图床配置」。

2. 依次填写 5 个配置项

配置过程将依次弹出 5 个输入框，请根据您的目标图床 API 文档准确填写。

步骤	配置项	描述	示例值
1/5	[URL]	上传 API 地址 (必填)。完整的 HTTP 或 HTTPS 接口地址。	https://api.example.com/
2/5	[paramName]	POST 文件参数名。API 用来接收图片文件的字段名。	file 或 image等参数
3/5	[jsonPath]	图片 URL 路径。图片链接在 API 返回的 JSON 数据中的路径。使用点号 (.) 分隔。	url 或 src等参数
4/5	[customHeader]	自定义请求头。用于携带鉴权信息（如 Token）。必须是标准 JSON 格式。	自定义请求头 标准JSON(eg: {"key":"value"}或留空
5/5	[customBody]	自定义 Body 字段。用于携带额外的文本字段（如用户 ID、策略名称）。必须是标准 JSON 格式。	自定义请求头 标准JSON(eg: {"key":"value"}

❗ 重要提醒：JSON 格式

步骤 4 和 5 必须使用标准的 JSON 格式。如果格式错误，配置流程将中止并给出错误提示。

---

📸 第二步：使用上传功能 (三种方式)

一旦配置完成，您就可以通过以下三种方式上传图片：

1. 粘贴 (推荐)

• 操作: 截图后或复制本地图片文件后，直接在 flyMD 编辑器中按下 Ctrl + V / Cmd + V。
• 效果: 自动上传，并插入上传后的 Markdown 链接。

2. 拖拽 (推荐)

• 操作: 将本地图片文件拖拽到 flyMD 编辑器区域。
• 效果: 自动上传，并插入 Markdown 链接。

3. 手动选择文件

• 操作: 通过 「插件」 -> 「Web 图床」 -> 「📤 上传本地图片」 菜单，打开文件选择框。
• 效果: 自动上传，并插入 Markdown 链接。

---

⚠️ 常见问题与排查

问题	可能原因	解决方案
“上传失败：HTTP 错误 4xx/5xx”	API URL 或鉴权信息 (Header/Body) 配置错误。	重新运行 配置 流程，仔细检查 URL、CustomHeader 和 CustomBody 是否正确。
“找不到 URL，请检查 JsonPath”	API 接口返回成功，但插件无法解析到图片链接。	重新运行 配置 流程，检查 JsonPath 是否准确（例如应该是 data.url 而不是 url）。
配置无法保存，且流程提前退出	CustomHeader 或 CustomBody 中的 JSON 格式错误。	确保您输入的是标准的 JSON 字符串，例如：{"key": "value"}。