| name | surgepix-upload |
| description | Upload local files to SurgePix cloud storage and return a public HTTPS URL. Use when the user says "upload", "get a URL", "上传文件", "传到CDN", needs a remote-accessible URL for an API call, or wants to convert a local file path into a public link. |
SurgePix Upload
Upload a local file to SurgePix storage and get back a public CDN URL.
When to use
- User says "upload this file", "get a URL for this image", "上传", "传到线上"
- Before calling any web API that needs a remote URL instead of a local path
Prerequisites
- Node.js >= 18
SURGEPIX_API_KEY configured (see Step 0)
Workflow
Step 0: Check environment (required)
Before running upload, verify config:
node "<skills-dir>/surgepix-setup/scripts/check_env.mjs"
- Exit 0 → proceed to Step 1
- Exit 1 → follow surgepix-setup skill to configure
.env, then retry
Do NOT check $SURGEPIX_API_KEY in shell — the script loads .env automatically.
Step 1: Identify the file
- Get the absolute path to the local file
- Confirm the file exists
Step 2: Run upload
node "<skills-dir>/surgepix-upload/scripts/file_upload.mjs" "<absolute-file-path>"
Step 3: Parse output
Success (stdout):
{"ok":true,"url":"https://...","filename":"photo.png","size":12345,"contentType":"image/png","existing":false}
Failure (stderr, non-zero exit):
{"ok":false,"error":"..."}
If error is "API_KEY not found" → run surgepix-setup first.
Step 4: Use the URL
- Show the
url to the user
- Pass it to any API that needs a remote file URL
Rules
- ALWAYS run check_env before first use in a session
- NEVER pass local paths to web APIs — upload first, use the returned URL
- NEVER invent or guess a URL
- NEVER echo auth tokens
