From 831919846144917cf07a811d9439667d9f35df68 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Fri, 17 Jul 2026 12:00:01 +0800
Subject: [PATCH] =?UTF-8?q?docs(grassland):=20=E8=AE=B0=E5=BD=95=E6=8E=92?=
 =?UTF-8?q?=E5=BA=8F=E4=B8=8EMP4=E4=BF=AE=E5=A4=8D=E6=AD=A3=E5=BC=8F?=
 =?UTF-8?q?=E5=8F=91=E5=B8=83?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...7_fix_grassland_guide_mp4_timeline_prod.md | 34 +++++++++++++++++++
 ...se_grassland_guide_sort_weight_asc_prod.md | 25 ++++++++++++++
 2 files changed, 59 insertions(+)
 create mode 100644 changelogs/2026-07/17_fix_grassland_guide_mp4_timeline_prod.md
 create mode 100644 changelogs/2026-07/17_release_grassland_guide_sort_weight_asc_prod.md

diff --git a/changelogs/2026-07/17_fix_grassland_guide_mp4_timeline_prod.md b/changelogs/2026-07/17_fix_grassland_guide_mp4_timeline_prod.md
new file mode 100644
index 0000000..fe3aeb6
--- /dev/null
+++ b/changelogs/2026-07/17_fix_grassland_guide_mp4_timeline_prod.md
@@ -0,0 +1,34 @@
+# 草原指南 MP4 重封装时间轴修复正式发布
+
+> 日期：2026-07-17
+>
+> 后端 Issue：[HL #5021](https://git.1814.love:8443/wx/HL/issues/5021)
+>
+> 后端 PR：[HL #5026](https://git.1814.love:8443/wx/HL/pulls/5026)
+>
+> 正式分支：`main`
+>
+> 影响服务：`hl-user-service`
+
+## 问题与修复
+
+旧版 MP4 无损重封装虽然保持了 Sample 数据，但 `mvhd/tkhd/elst` 使用了不一致的时间单位，浏览器可能把完整视频识别成数秒并提前触发 `ended`。
+
+后端现已统一 presentation timeline 的 movie timescale，并在替换 OSS 对象前校验 `mvhd/tkhd/elst/mdhd/stts` 一致性。视频仍保持原分辨率、帧率、编码和码率，不经过 Java 服务代理播放流量。
+
+接口路径、请求体及响应字段均保持不变，前端无需适配新字段。
+
+## 验证结果
+
+- MP4 核心测试：30/30 通过
+- `FileServiceTest` 与 `OssServiceTest`：141/141 通过
+- Maven package：`BUILD SUCCESS`
+- 测试环境真实媒体 1x/2x 播放已验收不卡顿
+- 正式部署任务：`#283`
+- 发布提交/镜像：`009d5ffe`
+- `hl-user-service`：`2/2 Ready`
+- 正式列表、详情、推荐、播放接口：HTTP/业务码均为 200
+- 正式真实 MP4：`Content-Length: 592945035`、`Accept-Ranges: bytes`
+- `Range: bytes=0-1023`：返回 206，`Content-Range: bytes 0-1023/592945035`
+
+本次未修改或部署 `hl-ui`，无数据库结构及 Nacos 配置变更。
diff --git a/changelogs/2026-07/17_release_grassland_guide_sort_weight_asc_prod.md b/changelogs/2026-07/17_release_grassland_guide_sort_weight_asc_prod.md
new file mode 100644
index 0000000..f46a46b
--- /dev/null
+++ b/changelogs/2026-07/17_release_grassland_guide_sort_weight_asc_prod.md
@@ -0,0 +1,25 @@
+# 草原指南排序权重正序规则正式发布
+
+> 日期：2026-07-17
+>
+> 后端 PR：[HL #5026](https://git.1814.love:8443/wx/HL/pulls/5026)
+>
+> 正式分支：`main`
+>
+> 影响服务：`hl-resource-service`
+
+## 变更说明
+
+草原指南列表排序权重统一按正序处理：数值越小越靠前，`0` 位于 `1` 之前。
+
+本次不新增或删除接口，不修改请求参数与响应字段。前端继续使用原有列表接口，不需要自行反转结果。
+
+## 正式验证
+
+- 正式部署任务：`#282`
+- 发布提交/镜像：`009d5ffe`
+- `hl-resource-service`：`2/2 Ready`
+- 匿名正式列表接口：HTTP 200、业务码 200
+- 正式数据首屏排序权重：`0,1,2,3,4,5,6,7,8,9`
+
+本次未修改或部署 `hl-ui`，无数据库结构及 Nacos 配置变更。