picgo-plugin-alist/README.md

使用alist作为中转并实现对各个网盘的图床应用

## picgo-plugin-alist

plugin for picgo

通过alist实现对oneDrive、阿里云盘、天翼云盘、GoogleDrive、夸克网盘、迅雷云盘等的文件上传，并通过alist实现直链获取（alist可以处理动态直链问题），最终达成对上述各网盘的图床实现。

支持alist `v2`和`v3`版本。

## alist简介

[alist](https://github.com/alist-org/alist)是一个支持多存储的文件列表程序，使用 `Gin` 和 `Solidjs`。使用alist可以利用OneDrive等网盘快速搭建一个下载站。
![](/readme/alist.png)

## 参数

| key            | 是否必填 | description                                                                          | example                                                                                   |
| -------------- | -------- |--------------------------------------------------------------------------------------| ----------------------------------------------------------------------------------------- |
| alist版本      | √        | 2或者3                                                                                 | 3                                                                                         |
| alist地址      | √        | 你的alist地址                                                                            | https://alist.example.com                                                                 |
| 上传路径       | √        | 上传的相对路径（alist内的路径，根据路径上传到对应网盘）                                                       | assets                                                                                    |
| 用户token      | ×        | 用户token([获取方式参考alist文档](https://alist-doc.nn.ci/docs/driver/alist/#token)，与用户名密码二选一) | balabala                                                                                  |
| 用户名         | ×        | 登录用户名（与token二选一，此模式可以自动获取化和刷新token，v2不支持）                                            | username                                                                                  |
| 密码           | ×        | 登录密码（与token二选一）                                                                      | password                                                                                  |
| 访问路径       | ×        | 自定义访问路径（资源最终链接的路径部分，默认为 'd/'+上传路径，'d/'是Alist额外加的，手动配置访问路径时如果有需要也记得加上）                    | public                                                                                    |
| 访问域名       | ×        | 自定义访问域名（为空则与alist地址一致）                                                               | https://custom.example.com                                                                |
| 访问文件名模板 | ×        | 用于alist会重映射文件名的情况，使用后资源链接中的文件名会被修改，注意上传的文件名不受影响，只用于生成资源链接。                           | `prefix_${fileName}_suffix` ，应用以上模板后，文件名 `abc.png` -> `prefix_abc_suffix.png` |

## 说明
### 高版本签名

高版本alist加入了“签名”特性，并默认开启“签名所有”。改选项打开后，会向所有文件的直接链接添加签名(无论是否有密码)。
如果遇到代码401错误，请在alist设置中关闭“签名所有”（Alist管理-设置-全局-签名所有）。
![](/readme/sign_off.png)
- 目前尝试仿照alist源码进行签名，但签名并不一致（失败~）。

## 安装

- 在线安装
    打开 [PicGo](https://github.com/Molunerfinn/PicGo) 详细窗口，选择`插件设置`，搜索`alist`安装。

- 离线安装
  克隆该项目，复制项目到 以下目录：
  - Windows: `%APPDATA%\picgo\`
  - Linux: `$XDG_CONFIG_HOME/picgo/` or `~/.config/picgo/`
  - macOS: `~/Library/Application\ Support/picgo/`

  切换到新目录执行 `npm install ./picgo-plugin-alist`，然后重启应用即可。