PicList-Core

English | 简体中文

PicList-Core 是一个功能强大的图片上传工具，提供 CLI 和 API 两种调用方式。它在 PicGo-Core 的基础上增强了功能，同时保持插件兼容性。查看 Awesome-PicGo 获取丰富的插件资源。

你可以查看 PiclList-Core 的 DeepWiki 获取更多信息。

原生支持 Typora 集成。

增强功能

• 图像处理能力：

  • 添加水印、压缩图片和转换格式
  • 通过 picgo set buildin watermark 和 picgo set buildin compress CLI 命令进行配置
  • 处理过程发生在 beforeTransform 阶段，确保与所有插件兼容

• 高级重命名：

  • 通过 picgo set buildin rename 设置自定义重命名规则

• 额外内置图床：

  • WebDAV、SFTP、本地路径、AWS S3
  • 改进的 Imgur 支持，支持账户上传

• 内置服务器：

  • 类似于 PicList-Desktop 服务器
  • 使用 picgo-server 命令启动

• 错误修复：

  • 解决了原始 PicGo-Core 的多个问题

安装

PicList 需要 Node.js >= 20

前置条件

PicList 依赖 sharp，请先安装它：

npm config set sharp_binary_host "https://npmmirror.com/mirrors/sharp"
npm config set sharp_libvips_binary_host "https://npmmirror.com/mirrors/sharp-libvips"
npm install sharp

全局安装

npm install piclist -g

# 或者

yarn global add piclist

本地安装

npm install piclist -D

# 或者

yarn add piclist -D

使用方法

Docker

你可以使用Docker运行PicList-Core。

docker run

将./piclist更改为你自己的路径，该路径是放置config.json文件的位置，并将piclist123456更改为你自己的密钥。

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

从本仓库下载docker-compose.yml，或将以下内容复制到docker-compose.yml:

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

你可以将./piclist更改为你自己的路径，该路径是放置config.json文件的位置，并在command中更改密钥。

然后运行:

docker-compose up -d

在Docker中安装插件

你可以使用docker exec在Docker中安装插件。

docker exec -it piclist sh
picgo install picgo-plugin-xxx

在Docker中更新配置

你可以使用docker exec在Docker中更新配置。

docker exec -it piclist sh
picgo set xxx

服务器

你可以使用picgo-server启动服务器，默认端口为36677。

启动服务器:

picgo-server
node ./bin/picgo-server

强烈建议添加--key参数以避免未经授权的访问。例如：picgo-server --key 123456

显示帮助:

$ picgo-server -h

  Usage: picgo-server [options]

  Options:

    -h, --help          显示帮助信息
    -c, --config        设置配置路径
    -p, --port          设置端口，默认端口为36677
    --host              设置主机，默认主机为0.0.0.0
    -k, --key           设置密钥以避免未经授权的访问
    -v, --version       显示版本号

  Examples:
    picgo-server -c /path/to/config.json
    picgo-server -k 123456
    picgo-server -c /path/to/config.json -k 123456

接口

• /upload?picbed=xxx&key=xxx 上传图片，picbed用于设置图床，key用于设置密钥
• /heartbeat 心跳检测

CLI使用

PicList-Core使用SM.MS作为默认上传图床。

显示帮助:

$ picgo -h

  Usage: picgo [options] [command]

  Options:

    -v, --version                 输出版本号
    -d, --debug                   调试模式
    -s, --silent                  静默模式
    -c, --config <path>           设置配置路径
    -h, --help                    输出使用信息

  Commands:

    install|add <plugins...>             安装picgo插件
    uninstall|rm <plugins...>            卸载picgo插件
    update <plugins...>                  更新picgo插件
    set|config <module> [name]           配置picgo模块
    upload|u [input...]                  上传，开始上传
    use [module]                         使用picgo模块
    init [options] <template> [project]  创建picgo插件的开发模板

从路径上传图片

picgo upload /xxx/xx/xx.jpg

从剪贴板上传图片

从剪贴板获取的图片将被转换为png格式

picgo upload

在Node项目中使用

CommonJS

const { PicGo } = require('piclist')

ES模块

import { PicGo } from 'piclist'

API使用示例

const picgo = new PicGo()

// 从路径上传图片
picgo.upload(['/xxx/xxx.jpg'])

// 从剪贴板上传图片
picgo.upload()

文档

获取更多详细信息，请查看PicGo-Core文档。