Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
cat-xierluo avatar

Piclist Upload

  • 82 installs
  • 543 repo stars
  • Updated August 5, 2026
  • cat-xierluo/legal-skills

Upload local images referenced in Markdown to an image host via the PicList HTTP server and replace paths with cloud links.

About

Uploads local images referenced in Markdown files to a configured image host via the PicList HTTP server and replaces local paths with cloud links. A developer uses it to batch-process Markdown files or directories so images are accessible across devices.

  • Uploads local Markdown images via PicList server
  • Batch processes files or directories

Piclist Upload by the numbers

  • 82 all-time installs (skills.sh)
  • Ranked #886 of 2,715 Automation & Workflows skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/cat-xierluo/legal-skills --skill piclist-upload

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs82
repo stars543
Last updatedAugust 5, 2026
Repositorycat-xierluo/legal-skills

What it does

Upload local images referenced in Markdown to an image host via the PicList HTTP server and replace paths with cloud links.

Files

SKILL.mdMarkdownGitHub ↗

PicList 图片上传

将 Markdown 文件中的本地图片上传到配置的图床,并将本地路径替换为云端链接。

前置条件

  • 已安装 PicList 并启用 HTTP Server
  • 已在 PicList 中配置图床
  • 已安装 jq
  • 已安装 curl

首次配置: 请参阅 references/setup.md 安装和配置指南。

⚠️ 强制规则:必须通过脚本执行

禁止手动 curl 上传。所有操作必须通过 `scripts/process.sh` 脚本执行。 脚本已内置上传、URL 替换和本地文件删除的完整逻辑,手动操作容易遗漏步骤。

默认行为是上传成功后删除本地图片。 只有当用户明确要求保留时,才可添加 --keep-local。不得擅自保留本地图片。

使用方法

处理文件或目录(默认删除本地图片)

bash scripts/process.sh --in-place <file.md|directory...>

保留本地图片(仅在用户明确要求时使用)

bash scripts/process.sh --in-place --keep-local <file.md|directory...>

预览模式(不修改文件)

bash scripts/process.sh --dry-run <file.md|directory...>

命令选项

选项说明
--in-place直接修改原文件(必须指定,否则仅输出到终端)
--keep-local保留本地图片文件。仅在用户明确要求时使用
--dry-run预览模式,不上传、不修改文件

响应格式

解析上传返回的 JSON:

{"success":true,"result":["https://example.com/image.png"]}

统计报告

处理完成后显示:

📊 Summary:
  Total uploaded: 5
  Total skipped: 3
  Total failed: 0
  • Uploaded: 成功上传并替换(已删除本地图片)
  • Skipped: 已是云端 URL(无需操作)
  • Failed: 上传错误(保留原始路径)

错误处理

  • PicList Server 未运行: 提示启动 PicList 应用
  • 文件不存在: 跳过并显示 ⚠️ 警告,继续处理
  • 上传失败: 保留原始路径,标记 ❌,继续
  • 无效 JSON: 视为上传失败

配置

PicList Server 默认地址为 http://127.0.0.1:36677/upload。可通过环境变量覆盖:

export PICLIST_SERVER=http://127.0.0.1:PORT

支持格式

png, jpg, jpeg, gif, webp, svg, bmp

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.