2023-09-01 03:22:03 -04:00
< div align = "center" >
< img src = "https://imgx.horosama.com/admin_uploads/2022/10/2022_10_05_633d79e401694.png" alt = "" >
< h1 > PicList< / h1 >
< a href = "https://github.com/Kuingsmile/PicList/actions" >
< img src = "https://img.shields.io/badge/code%20style-standard-green.svg?style=flat-square" alt = "" >
< / a >
< a href = "https://github.com/Kuingsmile/PicList/releases" >
< img src = "https://img.shields.io/github/downloads/Kuingsmile/PicList/total.svg?style=flat-square" alt = "" >
< / a >
< a href = "https://github.com/Kuingsmile/PicList/actions" >
< img src = "https://github.com/Kuingsmile/PicList/actions/workflows/manually.yml/badge.svg" alt = "" >
< / a >
< a href = "https://github.com/Kuingsmile/PicList/releases/latest" >
< img src = "https://img.shields.io/github/release/Kuingsmile/PicList.svg?style=flat-square" alt = "" >
< / a >
< / div >
简体中文 | [English ](https://github.com/Kuingsmile/PicList/blob/dev/README.md )
PicList是一款高效的云存储和图床平台管理工具， ， ， ， ， ，
## 如何从PicGo迁移
PicList `V1.5.0` 以上版本提供 `一键迁移` 功能，进入 `设置` 页面，然后在 `从PicGo迁移` 选项点击右侧按钮即可，迁移后请重启应用生效。
## PicList-Core
2023-10-09 11:18:09 -04:00
PicList的内核使用的是原版PicGo-Core基础上修改的[PicList-core](https://github.com/Kuingsmile/PicList-Core)，为云端删除等功能做了适配，同时，新增了水印添加和图片压缩/缩放/旋转/格式转换等功能， ，
2023-09-01 03:22:03 -04:00
如果您希望使用PicList-core，
## 特色功能
- 保留了PicGo的所有功能， ，
2024-01-07 01:28:12 -05:00
- 新增了多个内置图床， ，
2023-09-01 03:22:03 -04:00
- 相册中可同步删除云端图片，支持所有内置图床和多个插件
- 相册新增了高级搜索和排序，
- 内置水印添加、图片压缩、图片缩放、图片旋转和图片格式转换等功能，同时支持高级重命名
2023-10-09 11:18:09 -04:00
- 上传接口支持表单上传文件，可多电脑共用
2024-01-07 01:28:12 -05:00
- 支持配置同步至Github/Gitee/Gitea仓库
2023-09-01 03:22:03 -04:00
- 支持管理十余种图床，可以在线进行云端目录查看、文件搜索、批量上传、批量下载、删除文件等
- 支持预览多种格式的文件， ，
- 支持启用正则表达式的批量云端文件重命名
- 对于私有存储桶等支持复制预签名链接进行分享
- 支持软件自动更新，支持多种启动模式，还有更多功能细节新增和优化
- 优化了PicGo的界面， ，
- mac平台安装包已签名，
2023-12-06 23:31:41 -05:00
## 如何使用
2023-09-01 03:22:03 -04:00
### 如何在Vscode中使用
请安装我的配套插件 [VS-PicList ](https://marketplace.visualstudio.com/items?itemName=Kuingsmile.vs-piclist ),相比于vs-picgo插件， ，
### 如何在Typora中使用
#### **1.6.0版本及以上**
2023-11-07 19:27:10 -05:00
**Typora 1.6.0-dev以及以上版本现在已经原生支持PicList了**
2024-01-07 01:28:12 -05:00
目前Typora中需要同时设置上传服务PicList和PicGo（ ） ，
2023-09-01 03:22:03 -04:00
[下载地址 ](https://typora.io/releases/all )
#### 1.6.0版本以下
Windows:
进入Typora设置界面， ， `PicGo(app)` ，然后在 `PicGo路径` 中填写PicList的安装路径， ：
或者，您也可以使用 `npm install piclist` 命令安装PicList-core， `PicGo-Core(command line)` 。
MacOS:
进入Typora设置界面， ， `Custom Command` ，然后在 `Command` 中填写 `/Applications/PicList.app/Contents/MacOS/PicList upload` ，如下图所示：
验证上传选项可能会出现问题，可以忽略，直接使用是正常的。
### 如何在Obsidian中使用
在社区插件中搜索安装 `Image auto upload Plugin` ，然后进入插件设置页面，修改默认上传器为 `PicGo(app)` ，设置 `PicGo server` 为 `http://127.0.0.1:36677/upload` 即可，如下图所示, 此外该插件还额外支持通过PicList进行云端删除， `http://127.0.0.1:36677/delete` ：
2023-12-06 23:31:41 -05:00
### 如何在Docker中使用
#### docker run
2024-02-19 01:05:21 -05:00
修改`./piclist`为你自己的配置文件`config.json`所在的路径，修改`piclist123456`为你自己的密钥。
2023-12-06 23:31:41 -05:00
```bash
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
```
#### docker-compose
从piclist-core仓库下载`docker-compose.yml`文件，或者复制以下内容到`docker-compose.yml`文件中：
```yaml
version: '3.3'
services:
node:
image: 'kuingsmile/piclist:latest'
container_name: piclist
restart: always
ports:
- 36677:36677
volumes:
- './piclist:/root/.piclist'
command: node /usr/local/bin/picgo-server -k piclist123456
```
2024-02-19 01:05:21 -05:00
你可以修改`./piclist`为你自己的配置文件`config.json`所在的路径，修改`command`为你自己的密钥。
2023-12-06 23:31:41 -05:00
然后运行
```bash
docker-compose up -d
```
2023-09-01 03:22:03 -04:00
## 已支持平台
| 平台 | 相册云删除 | 云存储管理 |
| :------------: | :--------: | :--------: |
| SM.MS | ✔️ | ✔️ |
| Github | ✔️ | ✔️ |
| Imgur | ✔️ | ✔️ |
| 腾讯COS V5 | ✔️ | ✔️ |
| 阿里云OSS | ✔️ | ✔️ |
| 又拍云 | ✔️ | ✔️ |
| 七牛云 | ✔️ | ✔️ |
| S3 API兼容平台 | ✔️ | ✔️ |
| WebDAV | ✔️ | ✔️ |
| 本地文件夹 | ✔️ | ✔️ |
| 内置SFTP | ✔️ | ✔️ |
| 多吉云 | ✔️ | ✔️ |
2023-10-14 07:11:17 -04:00
| PicList(套娃) | ✔️ | ✔️ |
2024-01-07 01:28:12 -05:00
| Telegra.ph | ✔️ | x |
| 兰空图床 | ✔️ | ✔️ |
2023-09-01 03:22:03 -04:00
| 插件 | 相册云删除 |
| :----------------------------------------------------------------------------------------: | :--------: |
| [picgo-plugin-s3 ](https://github.com/wayjam/picgo-plugin-s3 ) | ✔️ |
| [picgo-plugin-alist ](https://github.com/jinzhi0123/picgo-plugin-alist ) | ✔️ |
| [picgo-plugin-huawei-uploader ](https://github.com/YunfengGao/picgo-plugin-huawei-uploader ) | ✔️ |
| [picgo-plugin-dogecloud ](https://github.com/w4j1e/picgo-plugin-dogecloud ) | ✔️ |
## 下载安装
[https://github.com/Kuingsmile/PicList/releases/latest ](https://github.com/Kuingsmile/PicList/releases/latest )
### Homebrew
MacOS用户现在可以使用Homebrew来安装PicList了， ：
```bash
brew install piclist --cask
```
卸载命令：
```bash
brew uninstall piclist
```
## 应用截图
## 开发说明
1. 你需要有 Node、Git 环境，了解 npm 的相关知识。
2. git clone [https://github.com/Kuingsmile/PicList.git ](https://github.com/Kuingsmile/PicList.git ) 并进入项目。
`yarn` 下载依赖
注意如果你没有`yarn`，请去 官网 下载安装后再使用。 用 `npm install` 将导致未知错误！
3. Mac 需要有 `Xcode` 环境， `VS` 环境。
4. 如果需要贡献代码，可以参考[贡献指南](https://github.com/Kuingsmile/PicList/blob/dev/CONTRIBUTING.md)。
### 开发模式
输入 `yarn run dev` 进入开发模式，开发模式具有热重载特性。不过需要注意的是，开发模式不稳定，会有进程崩溃的情况。此时需要：
`ctrl+c` # 退出开发模式
`yarn run dev` # 重新进入开发模式
注：
### 生产模式
如果你需要自行构建，可以 `yarn run build` 开始进行构建。构建成功后，会在 `dist_electron` 目录里出现构建成功的相应安装文件。
注意：如果你的网络环境不太好，可能会出现 `electron-builder` 下载 electron 二进制文件失败的情况。这个时候需要在 `npm run electron:build` 之前指定一下 electron 的源为国内源：
`export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"`
**在 Windows 上，则可以使用 `set ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/` （无需引号）**
## 其它相关
- [PicList-Core ](https://github.com/Kuingsmile/PicList-Core ) : 基于 PicGo-Core 二次开发的核心库，用于 CLI 操作和项目开发
- [PicHoro ](https://github.com/Kuingsmile/PicHoro ): 与 PicList 搭配使用的手机端 APP
- [VS-PicList ](https://github.com/Kuingsmile/vs-PicList/ ): 与 PicList 搭配使用的VScode插件
2024-01-25 23:02:25 -05:00
## 交流群
2024-02-24 20:56:15 -05:00
如果有任何问题，可以加入微信群进行交流，目前群已满，请添加微信号`pku_sq_ma`，备注`PicList`，我会拉你入群。
2024-01-25 23:02:25 -05:00
2023-09-01 03:22:03 -04:00
## License
本项目基于MIT协议开源， ，
[MIT ](https://opensource.org/licenses/MIT )
Copyright (c) 2017-present Molunerfinn
Copyright (c) 2023-present Kuingsmile
## Star Me
- Star 趋势 [](https://github.com/kuingsmile/PicList/stargazers)
[](https://github.com/kuingsmile/PicList/stargazers)
