```

feat(bash): 添加阿里云OSS上传脚本并优化环境变量加载

- 实现 aliyun-oss-put.sh 脚本，支持阿里云OSS文件上传功能
- 采用脚本专属环境文件约定 (aliyun-oss-put.env 和
  aliyun-oss-put.env.local)，避免与通用 .env 文件冲突
- 优化环境变量加载逻辑，仅当工作目录与脚本目录不同时才加载工作
  目录下的环境文件
- 简化请求头构建过程，直接构造而无需辅助函数
- 添加内容SHA256校验和OSS日期头部支持
- 完成真实OSS上传smoke test验证

更新跨平台单文件脚本最佳实践文档，明确脚本专属env文件约定。
```

Author: mudssky

docs/plans/2026-03-18-001-feat-add-bash-aliyun-oss-upload-script-plan.md

@@ -441,7 +441,7 @@ origin: docs/brainstorms/2026-03-18-aliyun-oss-upload-script-brainstorm.md
 ### Quality Gates
 
 - [ ] 至少完成一次离线签名校验
-- [ ] 至少完成一次真实 OSS 上传 smoke test
+- [x] 至少完成一次真实 OSS 上传 smoke test
 - [x] 更新 [docs/跨平台单文件脚本最佳实践.md](/home/administrator/projects/env/powershellScripts/docs/跨平台单文件脚本最佳实践.md)
 - [x] 若新增 `scripts/bash/README.md`，其示例命令与最终脚本参数保持一致
 

docs/跨平台单文件脚本最佳实践.md

@@ -149,21 +149,21 @@
 - 需要更强的结构化日志、重试、容错
 - 需要更复杂的元数据、标签、鉴权流程
 
-### .env / .env.local 约定
+### 脚本专属 env 文件约定
 
-这个脚本支持在当前工作目录自动读取：
+这个脚本不是读取通用 `.env`，而是读取**脚本专属文件名**：
 
-1. `.env`
-2. `.env.local`
+1. `aliyun-oss-put.env`
+2. `aliyun-oss-put.env.local`
 
 优先级为：
 
 1. 当前 shell 环境变量
-2. `.env.local`
-3. `.env`
+2. `aliyun-oss-put.env.local`
+3. `aliyun-oss-put.env`
 
 这样做的目的很简单：
 
-- `.env` 适合放通用默认值
-- `.env.local` 适合放本机或临时凭据
+- `aliyun-oss-put.env` 适合放这个脚本的共享默认值
+- `aliyun-oss-put.env.local` 适合放本机或临时凭据
 - 已经 `export` 到 shell 的值优先级最高，避免被文件悄悄覆盖

scripts/bash/aliyun-oss-put.sh

@@ -248,8 +248,10 @@ load_dotenv_files() {
     INITIAL_ENV_VARS="$(env | LC_ALL=C cut -d= -f1)"
     load_env_file_if_present "$script_dir/aliyun-oss-put.env"
     load_env_file_if_present "$script_dir/aliyun-oss-put.env.local"
-    load_env_file_if_present "$work_dir/aliyun-oss-put.env"
-    load_env_file_if_present "$work_dir/aliyun-oss-put.env.local"
+    if [ "$work_dir" != "$script_dir" ]; then
+        load_env_file_if_present "$work_dir/aliyun-oss-put.env"
+        load_env_file_if_present "$work_dir/aliyun-oss-put.env.local"
+    fi
 }
 
 # 解析 CLI 参数，命令行显式传值始终高于环境变量默认值。
@@ -462,30 +464,18 @@ prepare_request_values() {
 build_canonical_headers() {
     local canonical_headers=""
 
-    append_canonical_header() {
-        local header_name="$1"
-        local header_value="$2"
-
-        if [ -n "$canonical_headers" ]; then
-            canonical_headers="${canonical_headers}"$'\n'
-        fi
-
-        canonical_headers="${canonical_headers}${header_name}:${header_value}"
-    }
-
-    append_canonical_header "content-md5" "$FILE_MD5_BASE64"
-    append_canonical_header "content-type" "$CONTENT_TYPE"
-    append_canonical_header "content-length" "$FILE_SIZE"
+    canonical_headers="${canonical_headers}content-length:${FILE_SIZE}"$'\n'
+    canonical_headers="${canonical_headers}content-md5:${FILE_MD5_BASE64}"$'\n'
+    canonical_headers="${canonical_headers}content-type:${CONTENT_TYPE}"$'\n'
+    canonical_headers="${canonical_headers}x-oss-content-sha256:${CONTENT_SHA256}"$'\n'
+    canonical_headers="${canonical_headers}x-oss-date:${ISO_8601_DATE}"$'\n'
 
     if [ "$OVERWRITE_MODE" != "true" ]; then
-        append_canonical_header "x-oss-forbid-overwrite" "true"
+        canonical_headers="${canonical_headers}x-oss-forbid-overwrite:true"$'\n'
     fi
 
-    append_canonical_header "x-oss-content-sha256" "$CONTENT_SHA256"
-    append_canonical_header "x-oss-date" "$ISO_8601_DATE"
-
     if [ -n "${ALIYUN_SECURITY_TOKEN:-}" ]; then
-        append_canonical_header "x-oss-security-token" "${ALIYUN_SECURITY_TOKEN}"
+        canonical_headers="${canonical_headers}x-oss-security-token:${ALIYUN_SECURITY_TOKEN}"$'\n'
     fi
 
     printf '%s' "$canonical_headers"