字节笔记本
2026年8月29日
PicList:基于 PicGo 重构的开源图床管理
写 Markdown 教程时,截图一多,图床就变成日常摩擦:粘贴、上传、换链接,再在各个云盘之间翻相册。PicGo 一直是这个场景里的老工具,但很多人对「只能上传、不太会管云端文件」不满意。PicList 就是在 PicGo 基础上重构出来的开源图床管理客户端:上传流程和插件生态尽量兼容,同时把云存储管理、图片预处理、剪贴板监听这些事补齐了。
PicList 是什么
PicList 由 Kuingsmile 维护,官网是 piclist.cn。它基于 PicGo 重构,不是简单改个皮肤:保留熟悉的上传配置和大部分 PicGo 插件,再叠一层「云端文件也能管」的能力。
适合这些人:
- 写博客 / 文档 / README,经常截图贴 Markdown
- 已经在用 Typora、Obsidian、VS Code,想少改工作流
- 图床不止一个(GitHub、OSS、COS、S3、WebDAV…),需要统一入口
- 想在本机压缩、加水印,再上传,而不是另开一堆小工具
和 PicGo 比,多了什么
大致可以记成四块:
- 云存储管理:浏览、搜索、云端删除、批量重命名,不只是「传上去就完了」。
- 相册与多端同步:相册删除可跟云端联动;配置和相册也能通过 WebDAV / Git 在设备间同步。
- 内置图片处理:水印、压缩、缩放、旋转、格式转换,还能按图床分别开关。
- 剪贴板与自动化:监听剪贴板后,最近截图可以自动上传;还有轻量脚本系统、本地 HTTP 上传服务、和手机端 PicHoro 联动。
对写教程的人来说,最直观的是剪贴板监听:打开软件后,截图会进上传队列,链接直接可用,少点几次鼠标。
安装
官方给了常见平台的安装方式,Release 在 GitHub Releases。
Windows
winget install Kuingsmile.PicList或 Scoop:
scoop bucket add lemon https://github.com/hoilc/scoop-lemon
scoop install lemon/piclistmacOS
brew install piclist --caskLinux
从 Releases 下 AppImage / Snap / Deb 即可。
也可用 Docker 跑服务端模式(适合当本机上传 API):
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
- 装 Image Auto Upload 插件
- Default Uploader 选 PicGo(app)
- API 填
http://127.0.0.1:36677/upload(先保证 PicList 的本地服务开着)
VS Code
装扩展 VS-PicList。
通用 HTTP
任何能 POST 到本地上传接口的工具,都可以对接 36677 端口,和 PicGo 那套本地 API 习惯接近。
剪贴板自动上传怎么开
在设置里打开剪贴板监听(具体文案可能随版本微调)。开启后:
- 用系统截图工具截一张图
- PicList 检测到剪贴板里的图片
- 按当前默认图床上传
- 链接进相册 / 可复制为 Markdown
写长文时,截图节奏会顺很多。注意:自动上传意味着剪贴板里的敏感截图也会走图床,临时关掉监听,或单独建一个测试图床,会更安心。
上传前处理一下图
在图床或全局规则里可以打开:
- 压缩:减小体积,博客加载更快
- 水印:站点品牌或防搬运
- 缩放 / 格式:例如统一转 WebP
按图床分别配置很有用:公开 CDN 图床开压缩和水印,内网 WebDAV 就保持原图。
相关项目
- PicList-Core:CLI 核心
- PicHoro:安卓端
- ThemeHub / ScriptsHub:主题和脚本
小结
PicList 的定位很清楚:在 PicGo 熟悉的上传体验上,补上云端管理、预处理和剪贴板自动上传。如果你已经在用 PicGo 插件和 Typora / Obsidian 工作流,迁移成本通常不高;如果只是偶尔传几张图,官方客户端加一个稳定的对象存储就够用。源码在 GitHub 的 Kuingsmile/PicList,文档和下载见 piclist.cn。
更多入口: