feat(ov,viewer): two-tier download with wechat guidance
P4a Task 4(T12 收口):ov 域公开照片下载端点 + viewer 下载 UI。
- interactions 增 downloads:GET /public/albums/{token}/photos/{photoId}
/download?variant=browse|original。两级开关(A18):browse 需
downloadEnabled;original 需叠加 originalDownloadEnabled(级联,browse 关
则两者均 403 DOWNLOAD_DISABLED)。水印相册 browse 现签 watermark pattern
key(browse-key 解析抽取 shared/ov-browse-key 与 public-ov 复用);原图
现签 originalObjectKey(SIGNED_URL_TTL)。来源 IP 固定窗限速
(DOWNLOAD_WINDOW_REQUESTS/DOWNLOAD_WINDOW_SECONDS,env 可调);零浏览
计数写入(排除规则)。STORAGE_PORT_OV 经新 StorageOvModule 与 public-ov
共享同一实例。
- 契约微调登记:PublicAlbum 增 readOnly 必返 downloadEnabled/
originalDownloadEnabled(cn+ov 同形返回;public e2e 精确键断言同步)。
- viewer:lightbox 下载入口随开关渲染(无/单按钮/分体菜单两选项)、过期
凭证静默重取一次、微信内置浏览器(MicroMessenger UA)出保存图片指引
浮层(复制深链 + 反馈)替代直接下载;i18n zh/en 词条。
- tests:api e2e +7(开关矩阵 + URL/字节级断言、水印键一致、隐藏 404、
限速 429、零计数行);viewer vitest +9(UA/矩阵/菜单/重取/失败/指引/
复制);viewer Playwright +3(入口矩阵、微信 UA 浮层、真实端点 200 +
签名 URL 模式)。
Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
+10
@@ -2006,6 +2006,16 @@ export interface components {
|
||||
* 端点维护,技术实施方案 §7.1)。
|
||||
*/
|
||||
readonly viewCount: number | null;
|
||||
/**
|
||||
* @description 浏览图下载开关(P4a Task 4 / A18):false 时观众端不出现下载入口,
|
||||
* download 端点 browse/original 均 403 DOWNLOAD_DISABLED。
|
||||
*/
|
||||
readonly downloadEnabled: boolean;
|
||||
/**
|
||||
* @description 原图下载开关(更高级:需与 downloadEnabled 同时开启才允许
|
||||
* variant=original;单独开启不生效——两级级联语义)。
|
||||
*/
|
||||
readonly originalDownloadEnabled: boolean;
|
||||
};
|
||||
/** @description 公开照片条目(仅 published 照片,处理完成即有宽高;URL 为短期签名,需在过期前刷新)。 */
|
||||
PublicPhoto: {
|
||||
|
||||
Reference in New Issue
Block a user