From b651f41f6798a2167bb7bf8ba8e252421afc3f14 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 13 Jul 2026 09:20:44 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=98=8E=E7=A1=AE=E8=8D=89=E5=8E=9F?=
 =?UTF-8?q?=E6=8C=87=E5=8D=97OSS=E7=82=B9=E6=92=AD=E4=B8=8E=E9=BB=98?=
 =?UTF-8?q?=E8=AE=A4=E5=9F=9F=E5=90=8D=E6=96=B9=E6=A1=88?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../12_feat_grassland_guide_admin_mp_oss.md   | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/changelogs/2026-07/12_feat_grassland_guide_admin_mp_oss.md b/changelogs/2026-07/12_feat_grassland_guide_admin_mp_oss.md
index 48abe9a..bd02755 100644
--- a/changelogs/2026-07/12_feat_grassland_guide_admin_mp_oss.md
+++ b/changelogs/2026-07/12_feat_grassland_guide_admin_mp_oss.md
@@ -16,8 +16,9 @@
 
 - 后台新增一级菜单“草原指南管理”。
 - 素材库新增系统内置顶级分类“草原指南”，固定编码 `grassland_guide`。
-- 草原指南视频只接受 OSS 原始 `.mp4`，一个视频只返回一个 `videoUrl`。
-- 不转码、不生成多档清晰度、不接入 VOD 播放 SDK、不请求播放凭证。
+- 草原指南视频只接受 OSS 原始 `.mp4`，一个视频只返回一个 `videoUrl` 点播地址。
+- `videoUrl` 不是直播流，也不是 HLS/M3U8、FLV 或 VOD 播放地址；它是 OSS 原始 MP4 的 HTTPS 地址，通过 HTTP Range 分段读取。
+- 不转码、不生成多档清晰度、不接入 VOD/直播播放 SDK、不请求播放凭证、不切换 OSS 自定义域名。
 - 视频和封面都只能由后台管理员上传；小程序用户没有上传接口和上传权限。
 - 视频可以单独上传一张图片作为封面；未指定时由 OSS 自动截取视频首帧。
 - 小程序列表支持分页，详情直接把 `videoUrl` 交给原生 `<video>` 组件播放。
@@ -295,7 +296,7 @@ OSS 自动封面格式：
 <video src="{{detail.videoUrl}}" controls></video>
 ```
 
-OSS MP4 支持 Range 请求，原生 `<video>` 能从 MP4 元数据读取并显示当前播放时间、总时长和进度条。卡片时长使用接口的 `durationSeconds` 格式化即可，不做清晰度切换。
+这是 OSS 原始 MP4 点播/渐进式播放，不是直播流。前端不要接入直播播放器、`live-player`、FLV/HLS SDK，也不要把 `videoUrl` 转成 M3U8。OSS MP4 支持 Range 请求，原生 `<video>` 能从 MP4 元数据读取并显示当前播放时间、总时长和进度条。卡片时长使用接口的 `durationSeconds` 格式化即可，不做清晰度切换。
 
 ## 7. 测试环境验收结果
 
@@ -334,14 +335,14 @@ OSS MP4 支持 Range 请求，原生 `<video>` 能从 MP4 元数据读取并显
 - 真实 4K 原片为 `412360919` 字节（约 393 MiB），通过 `STS_MULTIPART` 上传；OSS `HEAD` 返回 `200`、`Content-Type: video/mp4`、`Content-Length: 412360919`。
 - 对 4K 原片请求 `Range: bytes=0-1` 返回 `206`、`Content-Range: bytes 0-1/412360919`，证明 OSS 支持原生 `<video>` 所需的分段读取，流量不经过业务服务器。
 - 4K 内容使用独立上传的 JPEG 封面，详情返回 `coverSource=CUSTOM`；推荐分页返回 3 条上架内容且排除了当前视频。
-- 当前测试桶默认域名同时返回 `Content-Disposition: attachment` 和 `x-oss-force-download: true`。HTTP Range 能正常工作，但小程序仍须做真机播放验收；若原生 `<video>` 因该响应头拒绝播放，优先给同一 OSS Bucket 绑定自定义域名直出，不需要先接 CDN。
+- 当前测试桶默认域名同时返回 `Content-Disposition: attachment` 和 `x-oss-force-download: true`。HTTP Range 能正常工作，但小程序仍须做真机播放验收。2026-07-13 最终决定保持默认 OSS 域名，不切换自定义域名；前端不得自行改写域名，若原生 `<video>` 真机播放失败，保留错误码与设备信息后反馈后端处理。
 
 ## 8. 2026-07-14 正式环境 Nacos 部署清单
 
-草原指南一期暂不使用 CDN、VOD、HLS 或转码，正式环境仅同步 OSS 原片上传上限。部署 `hl-user-service` 前执行：
+草原指南一期不使用 CDN、自定义 OSS 域名、VOD、直播流、HLS 或转码。2026-07-13 已只读确认正式 Nacos 的视频上限和分片阈值均已是目标值，正式部署时只复核，不重复覆盖配置。部署 `hl-user-service` 前执行：
 
 1. 在正式 Nacos 读取并备份完整 `hl-user-service-prod.yml`，确认生产实例实际加载的 namespace、group 和 dataId。
-2. 只做最小配置修改：
+2. 复核以下配置；当前值一致时不要发布 Nacos 变更：
 
 ```yaml
 file:
@@ -351,8 +352,9 @@ file:
 ```
 
 3. 不复制仓库内测试配置中的其他值，不覆盖正式环境已有的 OSS、数据库、Redis 或鉴权配置。
-4. 串行滚动部署 `hl-user-service`，确认两实例均注册健康且配置已生效。
-5. 用正式 OSS 做一轮大于 10 MiB 的 MP4 分片上传、确认、`HEAD` 和 `Range 206` 验收；不得在日志或交付文档中记录 STS、AccessKey、Token 等凭证。
+4. 保持正式 `oss.domain` 为当前默认 Bucket 域名，不切换 `oss.aly.1814.love` 或其他自定义域名。
+5. 串行滚动部署 `hl-user-service`，确认两实例均注册健康且配置已生效。
+6. 用正式 OSS 做一轮大于 10 MiB 的 MP4 分片上传、确认、`HEAD` 和 `Range 206` 验收；不得在日志或交付文档中记录 STS、AccessKey、Token 等凭证。
 
 ## 9. 前端改造检查单
 
@@ -366,6 +368,7 @@ file:
 - [ ] 删除管理员手工选择相关推荐的控件，不提交 `relatedVideoIds`。
 - [ ] 小程序列表接入分页参数和分页结果。
 - [ ] 小程序详情直接使用 `videoUrl` 播放。
+- [ ] 将 `videoUrl` 作为 OSS 原始 MP4 点播地址处理，不接 `live-player`、直播 SDK、FLV/HLS/M3U8 转换或自定义域名替换逻辑。
 - [ ] 相关推荐通过独立分页接口滑动加载，并按 `videoId` 去重追加。
 - [ ] 删除 VOD SDK、`play-auth` 调用和清晰度切换 UI。
 - [ ] 所有雪花 ID 均按字符串处理。