快速上手：上传第一张图片

本教程从一个无需账号的 本地图床开始：创建配置、上传一张图片、在相册中找到它，再把同样的流程用于在线图床。已经有可用配置时，可以直接跳到上传第一张图片。

开始前准备

• 安装并打开 PicList 桌面应用。无需单独安装 Node.js。
• 准备一张小的 PNG 或 JPG，例如你自己绘制的示例图片。
• 在电脑上创建一个用于练习的文件夹。Windows 示例：D:\PicList-Practice；macOS / Linux 示例：~/Pictures/PicList-Practice，配置时填写它的完整绝对路径。

为什么先用本地目录？

本地练习可以让你认识界面与上传流程。文件保存在自己的电脑上，不需要注册服务或填写密钥。

1. 创建并选择上传配置

打开本地上传图床

1. 在主窗口左侧点击 图床，展开平台列表。
2. 选择 本地上传。
3. 点击 新增配置 卡片。

图床中列出上传服务。选择本地上传开始无需账号的练习。 查看大图 ↗

图床是服务类型，例如本地上传或 GitHub；配置是该服务的一套具体设置，例如“练习目录”或“博客图片”。同一个平台可以保存多套配置。

填写最少必要的字段

界面字段	练习中填写什么
配置名	练习，或一个你容易识别的名字
设定路径	你刚创建的目录的完整路径
设定自定义域名	留空
设定网站路径	留空

截图中的 R: 路径是演示目录。请改成你自己的目录，点击右下角确认保存。 查看大图 ↗

点击 确认 后返回配置列表。这里保存的是文件写入位置；名称练习只是帮助你辨认配置。

让它成为本次上传目标

1. 点击练习卡片，使其显示 已启用。
2. 如果本地上传尚未成为默认平台，点击右上角 设为默认图床。
3. 返回 上传 页面，确认顶部同时显示 本地上传 与 练习。

卡片上的已启用表示正在使用这一套配置；右上角按钮控制默认图床平台。 查看大图 ↗

保存配置、选择配置与设置默认平台是三个相关但独立的动作。上传前检查主窗口顶部，是最直接的验证方法。

2. 上传第一张图片

在上传页面底部选择 URL，方便观察本地练习的结果；使用在线图床写文章时再选择 Markdown。

顶部本地上传 / 练习是目标；中央虚线框接收文件；底部输出格式决定复制什么。 查看大图 ↗

将图片拖到中央虚线框，或点击该区域，在文件选择窗口中选中图片。第一次先只上传一张，等待进度结束。

预期结果：练习目录中出现一个新文件。如果保持原始文件名，文件名应与源图片一致；开启重命名或图片处理后，名称、格式或尺寸可能改变。

如果启用了自动复制，结果会进入剪贴板；未启用时可以从相册重新复制。无论是否自动复制，都先检查实际保存的文件。

3. 在相册中找到结果

1. 点击左侧 相册。
2. 找到刚上传的文件；记录较多时，在“搜索文件名”中输入名称的一部分。
3. 使用卡片上的 打开 / 预览 打开预览。需要复制时，使用复制操作或选中记录后点击 复制。

相册保存上传记录。顶部可以搜索和筛选，卡片用于预览与后续复制链接。 查看大图 ↗

相册可以帮助你找回之前的上传结果。它记录本机的上传历史，不会自动列出某个云存储账号的全部文件；后者由云存储管理提供。

4. 验证文件与链接

本地练习的结果

使用本地上传且不填写公开域名时，返回的是本地文件路径，例如：

D:\PicList-Practice\first-upload.png

这说明文件保存成功。另一个人的电脑无法通过这个路径读取你的图片。相册可能使用本机预览缓存来显示图片；缓存地址也不是公开链接。

在线图床的结果

配置在线服务后，选择 Markdown，复制的内容通常类似：

![first-upload](https://images.example.com/docs/first-upload.png)

这是输出形式示例，example.com 不是可用的图床。验证你自己的 URL 时，只复制括号里的 HTTPS 地址到浏览器地址栏。公开图片应在不登录存储账号的浏览器中正常显示，再把整段 Markdown 粘贴进文章。

上传成功与公开可读分别检查

先确认目标目录或存储桶里存在文件，再确认读者使用的 URL 可以打开。上传接口、存储桶名与公开域名如何对应，见 S3 / R2 指南。

5. 连接你的在线图床

回到 图床，为在线平台新建配置，保存并选择它，再重复上传一张图片的练习。

你已经有什么	跟随哪篇教程
对象存储账号，或打算使用 Cloudflare R2	S3、R2 与 MinIO
GitHub 账号与公开仓库	GitHub 图床
WebDAV 或 SFTP 服务器	文件服务
S.EE、OSS、COS、七牛等服务	其他内置图床
还不确定	选择上传目标

在线配置需要你自己的账号凭据。仅选择某个平台并不能让它工作；配置名和公开图片域名也不能替代上传凭据。

其他上传入口

输入	操作	适合什么情况
本地图片或文件	拖入上传区，或点击区域多选	日常文件上传
剪贴板图片	复制图片，再点击剪贴板图片	截图与临时图片
绝对文件路径文本	复制完整路径，再使用剪贴板上传	从其他程序传递文件
图片 URL	URL上传，每行一个可直接读取的图片地址	把已有图片转存到自己的目标
多个文件组成的队列	任务上传，添加文件、检查间隔后开始	批量上传并观察每一项的状态

详细步骤见上传图片与文件；可控批量上传见任务队列。

迷你窗口上传

主窗口标题栏的迷你窗口按钮可以切换到小窗口；也可以查看系统托盘菜单中的入口。在迷你窗口拖入文件，或通过右键菜单执行剪贴板上传。使用前仍需配置可用图床。

顶部栏与托盘上传

macOS 菜单栏和 Windows 托盘提供紧凑的上传入口。具体菜单随平台与启动模式变化；首次使用建议在主窗口完成配置并验证一次上传，再使用托盘方式。

主窗口快捷切换

在顶部当前配置旁点击加号，把它加入常用图床快捷切换；最多收藏六套。选择另一项后检查显示的配置名，再进行下一次上传。

第一张图片遇到问题

你看到什么	先做什么	如何确认
提示缺少配置或认证失败	回到图床，检查必填字段并点击确认	上传顶部显示正确平台与配置名
本地上传写入失败	使用已存在、可写的绝对目录	用系统文件管理器检查目录与权限
没有自动复制链接	在相册选中记录，选择格式并复制	粘贴到编辑器检查输出
上传成功，但网页打不开	检查公开域名、路径与读取权限	在未登录的浏览器中打开原始 URL
图片没有出现在预期目录	检查当前配置、上传前缀与重命名规则	对照最终文件名与对象路径
显示“文件已上传，但保存结果失败”	使用该记录的恢复 / 重试此任务操作	按结果保存恢复完成；避免重新拖入文件

更多问题见故障排查。

下一步

完成后，你应当能确认 当前配置正确、目标中存在文件、相册有记录、复制的结果符合使用场景。

• 图片处理：用 85% 质量、等比例缩放与命名规则处理新图片。
• 相册与链接：搜索历史、批量复制、预览 URL 修改。
• 编辑器集成：让 Typora 或 VS Code 调用 PicList。