新增 OSS 上传与 Kingfisher 图片加载支持

suixinkan/Core/Core.md

@@ -8,6 +8,7 @@ Core 模块提供跨业务复用的基础能力，包括网络请求、缓存存
 - `Networking`：统一 API 请求、响应解析、错误处理和 token 注入。
 - `Storage`：统一登录 token、账号快照和 App 偏好的本地存储。
 - `Design`：统一颜色、字号、间距、控件尺寸和圆角。
+- `Upload`：统一阿里云 OSS 上传、图片压缩、上传策略和 Kingfisher 网络图片展示。
 
 ## Networking
 
@@ -49,7 +50,7 @@ Core 模块提供跨业务复用的基础能力，包括网络请求、缓存存
 - 正式 token 只放 Keychain。
 - 临时 token 只放内存。
 - 密码、验证码、OSS STS token、一次性扫码结果和错误提示不落盘。
-- 头像图片缓存交给 Kingfisher，Core 不保存图片 Data。
+- 头像、证件照等图片缓存交给 Kingfisher，Core 不保存图片 Data。
 
 `AccountSnapshot` 保存可重建的账号展示和业务上下文：
 - `AccountProfile`
@@ -63,3 +64,14 @@ Core 模块提供跨业务复用的基础能力，包括网络请求、缓存存
 `AppDesign` 管理跨页面颜色。`AppMetrics` 管理常用字号、间距、控件尺寸、行距和圆角。
 
 新增页面时优先使用 `AppMetrics` 和 `AppDesign`。只有明显属于单个页面的特殊尺寸，才保留在页面本地。
+
+## Upload
+
+`UploadAPI` 通过 `/api/app/config/get-sts-token` 获取阿里云 OSS 临时上传配置。`OSSUploadService` 负责校验文件、生成 objectKey、调用 `AlibabaCloudOSS` SDK 并返回最终文件 URL。
+
+上传模块只保存内存状态：
+- STS token 不写入 Keychain 或 UserDefaults。
+- 用户选择的本地图片 Data 不落盘。
+- 上传进度只用于当前页面展示。
+
+网络图片统一使用 `RemoteImage` / `RemoteAvatarImage`，内部由 Kingfisher 负责下载和缓存。业务页面不要再直接使用 `AsyncImage` 加载网络图片。