GoFly框架通过uploads.New("tencentcos")调用腾讯云COS上传，需预先在config.yaml中正确配置cos.secret_id、cos.secret_key、cos.bucket（含APPID）、cos.region等字段，否则会panic或返回空URL；默认本地存储，不传参即不走COS。
直接用 uploads.New("tencentcos") 就能走 COS 上传，但必须先配好 config.yaml 里的密钥和 Bucket 信息，否则会 panic 或返回空 URL。
确认 COS 配置已写入 config.yaml
GoFly 框架（或类似封装）依赖配置驱动云存储行为，不是靠代码硬编码。COS 相关字段必须存在且合法：
-
cos.secret_id和cos.secret_key是腾讯云 API 密钥，不能用主账号密钥，建议新建子用户并限制 COS 权限 -
cos.bucket格式为my-bucket-1250000000（含 APPID），不是控制台看到的“my-bucket” -
cos.region必须匹配 Bucket 所在地域，比如ap-shanghai，填错会导致签名失败 -
cos.base_url是可选的 CDN 域名或 COS 访问域名，如未填则 fallback 到默认https://.cos. .myqcloud.com
UploadFile 调用时传参不能漏掉 "tencentcos"
框架里 uploads.New() 默认走本地存储；要切到 COS，必须显式传字符串参数：
url, cover_url, err := uploads.New("tencentcos").UploadFile(c, file)
常见错误：
- 忘了传
"tencentcos"→ 上传成功但文件存到本地uploads/目录，前端拿不到 COS 地址 - 传了
"cos"或"tencent"→ 初始化失败，New()返回 nil，后续调用 panic -
file是*multipart.FileHeader，必须从c.FormFile("file")获取，不能直接读c.Request.Body
COS 上传失败时，错误信息通常暴露在 err 的 Error() 字符串里
腾讯云 SDK 返回的错误不总是 HTTP 状态码，而是结构化错误，比如：
腾讯云harness最佳实践-skills
下载
把一个已有 git 仓库装配成"TAPD 故事 → feature 分支 → PR → CNB AI 代码评审 → 合入 main → TAPD 故事自动回写 commit"的闭环工程挽具（harness）。适用于腾讯云 CNB（cnb.cool）+ TAPD 组合的团队。触发场景：(1) 用户要求把 git 仓库接入 CNB 和/或 TAPD；(2) 要求 commit/PR 自动关联 TAPD 故事；(3) 要求启用 CNB AI 代码评审（cnbcool/ai-review）；(
-
ERROR: cos: service returned error: StatusCode=403, ErrorCode=AccessDenied→ 密钥无权限或 Bucket 不存在 -
ERROR: cos: service returned error: StatusCode=400, ErrorCode=InvalidArgument→ region 或 bucket 名格式不对 -
ERROR: cos: service returned error: StatusCode=0, Err: context deadline exceeded→ 网络超时，检查服务端能否访问cos.ap-shanghai.myqcloud.com
别只看 err == nil 就认为成功；建议加日志打印完整 err.Error()，尤其上线前。
上传后返回的 url 是公开可访问地址，但需确认 Bucket 公共读权限
即使上传成功，前端仍 403，大概率是 COS 控制台没开「公共读」：
- 进入 COS 控制台 → Bucket → 权限管理 → 存储桶 ACL → 勾选「公共读私有写」
- 或更安全的做法：用预签名 URL（需改框架源码），但 GoFly 当前封装不支持
- 如果用了 CDN 域名，记得在 CDN 控制台配置回源路径，并开启「过滤参数」避免缓存污染
真正容易被忽略的是：COS 的「对象 ACL」默认继承 Bucket，但如果你代码里手动设置了 x-cos-acl: private（某些 SDK 默认行为），那哪怕 Bucket 是公共读，单个文件仍是私有——而 GoFly 封装层一般不暴露这个开关，得查它内部 SDK 调用是否强制设了 private。
