From 43cc42cecbba6f8d843a85c5b954476d16ffdc20 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 15 Jul 2026 14:38:57 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=AD=A3=E8=8D=89=E5=8E=9F?=
 =?UTF-8?q?=E6=8C=87=E5=8D=97=E8=A7=86=E9=A2=91=E7=B4=A0=E6=9D=90=E6=9F=A5?=
 =?UTF-8?q?=E8=AF=A2=E8=8C=83=E5=9B=B4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...ssland_guide_video_current_folder_scope.md | 59 +++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 changelogs/2026-07/15_fix_grassland_guide_video_current_folder_scope.md

diff --git a/changelogs/2026-07/15_fix_grassland_guide_video_current_folder_scope.md b/changelogs/2026-07/15_fix_grassland_guide_video_current_folder_scope.md
new file mode 100644
index 0000000..2d83288
--- /dev/null
+++ b/changelogs/2026-07/15_fix_grassland_guide_video_current_folder_scope.md
@@ -0,0 +1,59 @@
+# 草原指南管理：视频素材仅查询当前文件夹
+
+> **管理端 PR**: [wx/hl-ui#9](https://git.1814.love:8443/wx/hl-ui/pulls/9)
+> **日期**: 2026-07-15
+> **影响范围**: 管理后台草原指南新增/编辑页的视频素材选择弹窗
+> **当前状态**: 已合入 `v2.1` 并部署测试环境
+
+---
+
+## 一、业务口径更正
+
+视频素材选择器继续保留“草原指南”文件夹下拉，但素材列表改为严格按当前所选文件夹查询，不再自动包含子文件夹素材。
+
+本记录更正 `15_fix_grassland_guide_video_folder_selector_visibility.md` 中关于递归查询的描述；文件夹树显示规则保持不变。
+
+---
+
+## 二、最终查询规则
+
+- 选择“草原指南”根目录：只显示直接归属根目录的视频，不显示任意子文件夹视频。
+- 选择具体子文件夹：只显示直接归属该文件夹的视频，不显示更深层子文件夹视频。
+- 关键词搜索、分页和视频类型过滤均在当前文件夹范围内执行。
+- 文件夹下拉仍锁定在“草原指南”分类树内，不能切换到其他业务分类。
+
+对应请求规则：
+
+```http
+# 选择“草原指南”根目录
+GET /admin/material/list?categoryCode=grassland_guide&fileType=video
+
+# 选择具体子文件夹
+GET /admin/material/list?categoryCode=grassland_guide&subCategoryId={文件夹ID}&fileType=video
+```
+
+上述请求均不提交 `includeDescendants=true`。
+
+---
+
+## 三、接口与配置影响
+
+- 不新增或修改 API 字段。
+- 后端 `includeDescendants` 可选能力保持不变，其他调用方仍可按需显式启用。
+- 不修改数据库、字典、菜单或 Nacos 配置。
+- 不影响封面图选择器、素材上传、小程序接口或草原指南保存逻辑。
+
+---
+
+## 四、验证记录
+
+- [x] 根目录请求不包含 `subCategoryId` 和 `includeDescendants`。
+- [x] 子文件夹请求包含对应 `subCategoryId`，不包含 `includeDescendants`。
+- [x] 文件夹下拉、根节点和子节点继续显示。
+- [x] 共享组件显式开启 `includeDescendants=true` 时仍正常传参。
+- [x] Vitest：1 个测试文件、4 项测试通过。
+- [x] 相关 ESLint 通过。
+- [x] Vite 生产构建通过。
+- [x] 独立代码复核无阻断项。
+- [x] 测试环境部署任务 `418ff501` 成功。
+- [x] 测试环境静态包 `VideoEditDrawer-qeoVDIga.js` 已确认保留文件夹下拉且不再传递 `include-descendants`。
-- 
2.43.0