upyun-upload-image

name	upyun-upload-image
description	在用户明确授权外部上传后，将本地 PNG、JPEG、GIF 或 WebP 图片上传到已配置的又拍云 S3 兼容存储，并以 JSON 返回 HTTPS URL 和对象键。适用于公众号预览所需的本地图片公网化或单独上传图片；不负责扫描文章、改写 Markdown、排版或发布，不得回显凭据。

又拍云图片上传

该技能会产生外部写入。只有用户明确要求上传、公网图片或复制页预览时执行。

前置

图片上传配置统一由工作台“系统与配置中心”的 upyun-image-upload 工具资源维护，并在调用 image.cdn.upload 时由工具运行时注入。技能不得读取项目或技能目录中的 .env，也不得直接读取 UPYUN_* 环境变量；日志、文章和最终回复不得显示凭据。

执行

图片上传由 `image.cdn.upload` 工具能力执行。Bucket、域名与凭据统一在工作台“系统与配置中心”维护；技能不读取或回显凭据。配置未完成时工具返回 `needs_configuration`，请先完成“又拍云图片上传”配置。

仅用于工具适配器的底层脚本必须显式接收完整参数，不会读取 `.env`：

```bash
node upyun-upload-image.js <image-path> --bucket <bucket> --operator <operator> --password <password> --domain <domain> [--prefix uploads]

上传前检查文件存在、非空且扩展名受支持。成功 stdout 必须是：

```json
{"success":true,"data":{"url":"https://...","key":"..."}}

失败时非零退出并返回不含凭据的错误。只有 success: true、URL 使用 HTTPS 且对象键非空时才更新调用方文档。

批量上传逐张执行并记录原路径到 URL 的映射；任一失败时保留原引用，不用占位 URL 伪装成功。上传后不自动删除本地文件。