用途:在编写、修改或排查代码时,按多吉云官方文档选择正确的 SDK、上传方式和 API,完成最小、安全、可维护的 OSS 接入;优先复用项目现有框架、HTTP 客户端与 S3 SDK。
主要能力与接入路径:先检查项目语言、框架、依赖与现有上传/网络代码,确认需要上传、临时密钥、Bucket、文件管理、远程抓取还是统计能力。浏览器、Android、iOS 直传读取 references/client-upload.md,由业务服务端签发临时密钥;微信小程序或 uni-app 用平台 uploadFile 流程,不照搬浏览器 S3 SDK;服务端上传或文件管理读取 references/server-sdks.md,选对应语言官方 SDK,小文件可用简单上传 API;无合适 SDK、需 Bucket/文件/统计接口或排查签名时读取 references/api-reference.md;构建图床同时读 references/image-hosting.md。只读取当前任务所需 reference,并打开其中官方链接核对字段、限制与示例,不凭记忆补造参数。
编码流程:定位对应 reference,仅打开直接相关的官方页面;按现有技术栈选 SDK 或 REST API,不替换框架、不新增无必要依赖;从官方页面核对安装方式、初始化参数、请求与响应字段、限制和错误处理;生成可运行代码并沿用仓库配置、类型、错误处理与测试风格;客户端上传由服务端签发最小权限临时密钥;为鉴权、key/scope 生成、签名、上传或分页逻辑跑最小验证;交付时指出所用官方页面、需配置的环境变量,以及仍需用户提供的 Bucket 或访问域名。
安全边界:永久密钥不得写入客户端、仓库、日志、示例响应或错误信息;临时密钥最长 2 小时,按响应过期时间使用;不硬编码 s3Bucket 或 s3Endpoint;客户端默认只授予单一对象 key,批量上传才授予用户隔离的窄前缀,不用 *;先完成业务身份认证、权限检查、限流和 key 归属校验再签发;服务端校验大小、扩展名/MIME 白名单和生成的 key,不信任客户端文件名与 MIME;列表、复制、删除、下载默认放服务端;不可逆操作保留确认与错误处理;不关闭 TLS 验证,不把演示占位密钥当可运行配置。
限制:具体价格、套餐、Bucket 数量及其他未在资料中提供的信息暂未提供;文档与依赖版本冲突时先查该依赖当前官方文档,再适配多吉云返回的 S3 兼容参数。