COSCLI v1.0.9 迭代改动点
一、新增能力
- 新增 stat 命令（查询对象元数据）
- 新增文件：cmd/stat.go、util/stat.go
- 功能：通过 HEAD Object 接口查询对象元数据，输出 ETag、Content-Type、Content-Length、Last-Modified、Cache-Control、Content-Disposition、Content-Encoding、Content-Language、Expires、存储类型、版本号、对象类型、CRC64，以及全部自定义元数据 x-cos-meta-*。
- 用法：
- ./coscli stat cos://bucket-1234567890/test.txt
- ./coscli stat cos://bucket-1234567890/test.txt --version-id
- 参数：--version-id 指定查询的对象版本。
- 自定义域名支持写入配置文件（Bucket 级 customized）
- util/types.go：Bucket 结构体新增 Customized bool 字段（yaml: customized）。
- cmd/config_add.go：新增 --customized flag，可在添加桶时持久化自定义域名标记。
- cmd/config_init.go：交互式初始化时新增询问「是否对该桶使用自定义 endpoint」。
- cmd/config_show.go：展示桶的 Customized 字段。
- util/url.go GenURL：URL 生成时 --customized 命令行参数优先，未指定则回退到配置文件中桶的 customized 字段。
- 新增列举存储桶的 Service 域名配置（ServiceDomain）
- util/types.go：Base 结构体新增 ServiceDomain string（yaml: servicedomain）。
- util/const.go：新增默认常量 CosServiceDomain = "service.cos.myqcloud.com"。
- cmd/config_set.go：新增 --service_domain flag（@ 可清空）。
- cmd/config_init.go：初始化时新增询问默认 service 域名。
- cmd/config_show.go：展示 ServiceDomain。
- util/url.go GenBaseURL：始终显式构造 ServiceURL，不再返回 nil，避免 SDK 回退到写死的 http://service.cos.myqcloud.com。优先级：命令行 --endpoint > 配置文件 base.servicedomain > 默认 service.cos.myqcloud.com。
- 新增代理（Proxy）支持
- util/types.go：Base 新增 Proxy string（yaml: proxy）；Param 新增 Proxy string。
- cmd/config_set.go：新增 --proxy flag（@ 可清空）。
- cmd/config_show.go：展示 Proxy。
- cmd/root.go：新增全局持久化参数 --proxy，支持 http://user:[email protected]:8080、socks5://127.0.0.1:1080 等。
- util/client.go：新增 getProxyFunc，优先级 命令行 --proxy > 配置文件 base.proxy；对 URL 校验 scheme 与 host，非法输入回退为不使用代理并打印 warning；Service 客户端与 Bucket 客户端均注入代理。
- signurl 支持 PUT（上传预签名 URL）
- cmd/signurl.go：新增 --method / -m flag（默认 GET），支持 GET（下载）与 PUT（上传）；对非 GET/PUT 的 method 报错。
- 短描述更新为 "Gets the signed URL for upload or download"。
- restore 并发重构 + 进度显示
- util/restore_objects.go 大幅重构：
- 用 restoreCounter（sync/atomic）替代包级全局计数器 succeedNum/failedNum/errTypeNum，消除多次调用间的状态残留，保证并发安全。
- 引入 worker pool（taskCh + sync.WaitGroup）：list 阶段生产 restoreTask，多个 worker 并发执行 HEAD/POST restore。
- list 与回热解耦：produceCosRestoreTasks / produceOfsRestoreTasks 只负责扫描并投递任务，回热逻辑集中在 worker。
- 新增单行刷新的进度条（restoreProgressLoop）：list 未结束时按已完成数展示，list 结束后切换为百分比。
- cmd/restore.go 新增 --routines flag（默认 3，范围 1~10000），批量 restore 时的并发数。
- cmd/restore.go 单对象 restore 遇到 HTTP 409（对象已在回热中）视为提交成功，不再报错。
二、性能/并发优化
7. 分片并发线程数推导重写（util/helper.go getThreadNumByPartSize）
- 默认并发上限由硬编码 12 提升至 32（defaultMaxThreadNum），覆盖 16GB+ 大文件场景。
- 档位表扩展：新增 partNum<=2000 → 20、default → 32。
- 新增带宽感知：按单连接 8MB/s（singleConnThroughputMB）估算，限速场景下收敛线程数。
- 新增上限封顶：受 --max-thread-num 控制；并保证 >=1 且不超过分片数。
- 新增命令行参数 --max-thread-num（cmd/cp.go、cmd/sync.go，默认 32），util/types.go Operation 新增 MaxThreadNum int。
- 语义：--thread-num（>0）显式设置时覆盖自动推导并忽略 --max-thread-num；--thread-num=0 时按文件大小自动推导，上限由 --max-thread-num 控制。
- 调用点同步改造：util/upload.go、util/download.go、util/copy.go 的单文件处理传入 RateLimiting 与 MaxThreadNum。
- 重试逻辑去叠加（util/helper.go isSDKHandledError）
- SDK（cos-go-sdk-v5）已对 5xx 响应做 HTTP 级重试（默认 10 次），应用层（默认 5 次）叠加会放大到最坏 66 次。
- 新增 isSDKHandledError：识别 5xx 结构化错误后，upload/download/copy 不再叠加应用层重试，直接放弃并在 process.log 标注 skip coscli-retry。
- 网络错误（body 为 io.Reader 无法重放）仍由应用层兜底重试。
