ByteNoteByteNote

字节笔记本

2026年8月29日

PicList:基于 PicGo 重构的开源图床管理

API中转
¥120

写 Markdown 教程时,截图一多,图床就变成日常摩擦:粘贴、上传、换链接,再在各个云盘之间翻相册。PicGo 一直是这个场景里的老工具,但很多人对「只能上传、不太会管云端文件」不满意。PicList 就是在 PicGo 基础上重构出来的开源图床管理客户端:上传流程和插件生态尽量兼容,同时把云存储管理、图片预处理、剪贴板监听这些事补齐了。

PicList 是什么

PicList 由 Kuingsmile 维护,官网是 piclist.cn。它基于 PicGo 重构,不是简单改个皮肤:保留熟悉的上传配置和大部分 PicGo 插件,再叠一层「云端文件也能管」的能力。

适合这些人:

  • 写博客 / 文档 / README,经常截图贴 Markdown
  • 已经在用 Typora、Obsidian、VS Code,想少改工作流
  • 图床不止一个(GitHub、OSS、COS、S3、WebDAV…),需要统一入口
  • 想在本机压缩、加水印,再上传,而不是另开一堆小工具

和 PicGo 比,多了什么

大致可以记成四块:

  1. 云存储管理:浏览、搜索、云端删除、批量重命名,不只是「传上去就完了」。
  2. 相册与多端同步:相册删除可跟云端联动;配置和相册也能通过 WebDAV / Git 在设备间同步。
  3. 内置图片处理:水印、压缩、缩放、旋转、格式转换,还能按图床分别开关。
  4. 剪贴板与自动化:监听剪贴板后,最近截图可以自动上传;还有轻量脚本系统、本地 HTTP 上传服务、和手机端 PicHoro 联动。

对写教程的人来说,最直观的是剪贴板监听:打开软件后,截图会进上传队列,链接直接可用,少点几次鼠标。

安装

官方给了常见平台的安装方式,Release 在 GitHub Releases

Windows

bash
winget install Kuingsmile.PicList

或 Scoop:

bash
scoop bucket add lemon https://github.com/hoilc/scoop-lemon
scoop install lemon/piclist

macOS

bash
brew install piclist --cask

Linux

从 Releases 下 AppImage / Snap / Deb 即可。

也可用 Docker 跑服务端模式(适合当本机上传 API):

bash
docker pull kuingsmile/piclist:latest
docker run -d \
  --name piclist \
  --restart always \
  -p 36677:36677 \
  -v "./piclist:/root/.piclist" \
  kuingsmile/piclist:latest \
  node /usr/local/bin/picgo-server -k piclist123456

把密钥 piclist123456 换成自己的。

配置一个图床

安装后打开客户端,进图床设置。常见选择:

类型例子备注
对象存储阿里云 OSS、腾讯 COS、AWS S3 兼容适合长期自管
代码托管GitHub / Gitee简单,公开仓库要注意隐私
公共图床SM.MS / Imgur 等上手快,容量和可用性看服务方
自建 / 网盘协议WebDAV、SFTP、本地目录、Lsky Pro适合私有化

填好 token、bucket、域名之类字段后,先上传一张测试图,确认返回的 URL 能打开,再接到编辑器。

接到 Markdown 编辑器

Typora

  • Typora ≥ 1.6.0:图片设置里直接选 PicList
  • 更早版本:图片上传选 PicGo(app),路径指到 PicList 可执行文件

Obsidian

  1. 装 Image Auto Upload 插件
  2. Default Uploader 选 PicGo(app)
  3. API 填 http://127.0.0.1:36677/upload(先保证 PicList 的本地服务开着)

VS Code

装扩展 VS-PicList

通用 HTTP

任何能 POST 到本地上传接口的工具,都可以对接 36677 端口,和 PicGo 那套本地 API 习惯接近。

剪贴板自动上传怎么开

在设置里打开剪贴板监听(具体文案可能随版本微调)。开启后:

  1. 用系统截图工具截一张图
  2. PicList 检测到剪贴板里的图片
  3. 按当前默认图床上传
  4. 链接进相册 / 可复制为 Markdown

写长文时,截图节奏会顺很多。注意:自动上传意味着剪贴板里的敏感截图也会走图床,临时关掉监听,或单独建一个测试图床,会更安心。

上传前处理一下图

在图床或全局规则里可以打开:

  • 压缩:减小体积,博客加载更快
  • 水印:站点品牌或防搬运
  • 缩放 / 格式:例如统一转 WebP

按图床分别配置很有用:公开 CDN 图床开压缩和水印,内网 WebDAV 就保持原图。

相关项目

  • PicList-Core:CLI 核心
  • PicHoro:安卓端
  • ThemeHub / ScriptsHub:主题和脚本

小结

PicList 的定位很清楚:在 PicGo 熟悉的上传体验上,补上云端管理、预处理和剪贴板自动上传。如果你已经在用 PicGo 插件和 Typora / Obsidian 工作流,迁移成本通常不高;如果只是偶尔传几张图,官方客户端加一个稳定的对象存储就够用。源码在 GitHub 的 Kuingsmile/PicList,文档和下载见 piclist.cn。

更多入口:

分享: