中文文档 · Releases · Bug Reports

Extensions live in the extensions/ directory and can be enabled or disabled independently per profile.

Note: Extensions process files server-side before they are sent to cloud storage. The original file is never modified.

Install the AdminBeautify plugin, then open AB-Store in the admin panel, search for PicUp, and install with one click. Updates are delivered the same way.

1. Download the latest ZIP from GitHub Releases
2. Extract the archive and rename the folder to PicUp
3. Upload it to usr/plugins/ in your Typecho installation
4. Go to Admin → Console → Plugins → enable PicUp

cd /path/to/typecho/usr/plugins/
git clone https://github.com/lhl77/Typecho-Plugin-PicUp.git PicUp

After activating the plugin, go to Admin → Settings → PicUp.

Profiles are stored as JSON. Each top-level key is a profile name. Choose a driver with "driver" and fill in the required fields for that driver. Add a "_extensions" block to configure image processing per profile.

Example — Alibaba Cloud OSS with compression and WebP:

{
  "my-oss": {
    "driver": "aliyunoss",
    "endpoint": "oss-cn-hangzhou.aliyuncs.com",
    "bucket": "my-bucket",
    "accessKeyId": "YOUR_KEY_ID",
    "accessKeySecret": "YOUR_KEY_SECRET",
    "prefix": "images",
    "urlPrefix": "https://cdn.example.com",
    "_extensions": {
      "compress": { "enabled": true, "quality": "82" },
      "webp":     { "enabled": true, "quality": "85" },
      "watermark": { "enabled": false }
    }
  }
}

Keep your credentials private. Never commit your JSON config to a public repository.

After saving, pick the profile you want to activate from the dropdown and save again. All subsequent uploads will use that profile.

"compress": {
  "enabled": true,
  "quality": "80"
}

quality is 1–100. For JPEG/WebP it maps directly to lossy quality; for PNG it maps to compression level as (100 - quality) / 10.

"webp": {
  "enabled": true,
  "quality": "85"
}

When enabled, JPEG/PNG/GIF files are converted to .webp before upload. Requires PHP GD compiled with WebP support (--with-webp).

"watermark": {
  "enabled": true,
  "type": "text",
  "text": "© example.com",
  "font_size": "16",
  "font_color": "#ffffff",
  "opacity": "80",
  "position": "bottom-right",
  "font_path": "",
  "image_path": "",
  "image_scale": "20"
}

The plugin bundles Noto Sans for text watermarks. For CJK text watermarks, provide a TTF/OTF font containing CJK characters (e.g. NotoSansCJK-Regular.ttc) or rely on a system font that the plugin auto-detects.

PicUp/
├── Plugin.php        # Main plugin file
├── README.md
├── vendor/           # Storage drivers
└── extensions/       # Image processing extensions

Issues and pull requests are welcome on GitHub.