OSS 上传

一个动作:本地文件 → OSS → 返回链接。

python3 scripts/upload.py 图.jpg 片子.mp4
# https://vd.moimg.net/images/2026/08/3f9a1c2e8b74.jpg
# https://vd.moimg.net/videos/2026/08/7d8e9f0a1b2c.mp4

每行一个 URL,顺序与传入文件一致。要给程序读加 --json:

{"ok": true, "files": [
  {"path": "图.jpg", "key": "images/2026/08/3f9a1c2e8b74.jpg",
   "url": "https://vd.moimg.net/images/2026/08/3f9a1c2e8b74.jpg",
   "bytes": 394088, "existed": false}], "failed": []}

退出码 0 全成功 / 1 有失败。换机器、换人第一件事跑 python3 scripts/upload.py --check(真跑一遍上传+回读)。

命名规则(代码定,调用方无从干预)

{images|videos|files}/{年}/{月}/{内容sha256前12位}{后缀}

• 对象名由文件内容决定 → 同一个文件传多少次都落到同一个 key,天然幂等、自动去重、永不误覆盖(两个都叫 cover.jpg 的不同文件互不影响)
• 传之前先探一遍,已存在就直接返回链接不重传(existed: true),上行慢的机器上省的是几十分钟;真要重传加 --force
• 类型只分三个桶:图 → images/,视频 → videos/,其他一律 files/(文案、字幕、JSON、PDF 都行)
• 后缀统一小写,.jpeg 归到 .jpg,免得同一张图存两份
• 跨月的同一个文件会各存一份(key 含年月),这是有意的:按月归档好清理

不做什么

这个 skill 只上传。被问到下面这些,直接说不支持,别自己想办法绕:

红线

• 桶是公共读,STS 网关无鉴权 —— 传上去的东西等于公开发布。绝不要传合同、凭证、身份信息、内部资料、未公开的商业数据。
• 传别人的内容前先确认能不能用。从社交平台抓下来的图片视频通常带水印和版权,能存进 OSS 不等于能对外发布 —— 授权与使用范围由调用方自己负责。
• 只在公司内网跑。STS 网关是内网服务,外网连不上会直接报错;不要试图绕过它去找长期密钥。

排错

部署坐标

bucket mdfile / region cn-beijing / STS 网关 http://api-ai.modianinc.com:8080/oss/get_sts / 读取域名 https://vd.moimg.net。 全部可用 OSS_BUCKET、OSS_REGION、OSS_STS_URL、OSS_PUBLIC_BASE 覆盖。

零依赖:只用 Python 标准库,OSS V4 签名是手写的,不需要 pip install 任何东西。