SuperAPI AI 工具集

piclist-upload

通用与其它

查看项目

更新于 10-15 20:10

技能介绍

用途:将 Markdown 文件中的本地图片上传到已配置的图床,并把本地路径替换为云端链接,便于跨设备访问;支持批量处理多个 Markdown 文件或目录。

主要能力:识别普通路径、尖括号路径及 Obsidian 的 file:// 写法,URL 内百分号编码会解码;上传后解析返回 JSON,输出成功、跳过、失败统计;单图失败自动重试一次,仍是失败则保留原始路径并继续;--in-place 模式每张图替换后原子写回,中断后可重跑续传(幂等)。

使用方式:前置条件为已安装并启用 PicList HTTP Server、已在 PicList 中配置图床、已安装 jq 与 curl。所有操作必须通过脚本执行,禁止手动 curl 上传: bash scripts/process.sh --in-place <file.md|directory...> 仅在用户明确要求保留本地图片时加 --keep-local: bash scripts/process.sh --in-place --keep-local <file.md|directory...> 预览模式: bash scripts/process.sh --dry-run <file.md|directory...> 默认地址为 http://127.0.0.1:36677/upload,可用环境变量 PICLIST_SERVER 覆盖,另可调 PICLIST_START_WAIT、MAX_RETRIES、RETRY_DELAY。

适用场景:需要上传 Markdown 中本地图片、批量处理含本地图片引用的 Markdown 文件或目录、把本地路径替换为云端链接以实现跨设备访问。

限制:默认行为是上传成功后删除本地图片,只有明确要求时才可保留;脚本兼容 bash 3.2+、Linux 与 Git Bash,lsof 缺失时回退 /dev/tcp 探测;PicList 未运行时会尝试自动启动(仅 macOS)并等待,业务端点 503/000 通常是应用卡死或图床后端未配置;支持 png、jpg、jpeg、gif、webp、svg、bmp 格式。