diff --git a/docs/build.md b/docs/build.md
index 713309c34..6babc7477 100644
--- a/docs/build.md
+++ b/docs/build.md
@@ -199,9 +199,9 @@ ctest --test-dir build --output-on-failure -C Release
 
 ---
 
-## macOS (Non-Official Support)
+## macOS
 
-Note: macOS support is **non-official**. We only run CI automation on macOS and do not perform manual testing.
+macOS is a fully supported platform. See [`build-macos.md`](build-macos.md) for a dedicated, step-by-step guide.
 
 Install dependencies:
 
diff --git a/docs/zh/build.md b/docs/zh/build.md
index dc051efbe..be58e55ec 100644
--- a/docs/zh/build.md
+++ b/docs/zh/build.md
@@ -133,7 +133,7 @@ ctest --test-dir build --output-on-failure -C Release
 sudo dnf install -y \
   cmake ninja-build pkgconf-pkg-config \
   qt6-qtbase-devel qt6-qtbase-private-devel qt6-qttools-devel \
-  ffmpeg-devel \
+  ffmpeg-free-devel \
   OpenImageIO-devel \
   OpenColorIO-devel \
   openexr-devel \
@@ -143,7 +143,8 @@ sudo dnf install -y \
   vulkan-headers \
   vulkan-loader-devel \
   libxkbcommon-devel \
-  gcc-c++
+  gcc-c++ \
+  bzip2-devel
 ```
 
 配置并构建：
@@ -198,9 +199,9 @@ ctest --test-dir build --output-on-failure -C Release
 
 ---
 
-## macOS（非官方支持）
+## macOS
 
-说明：macOS **非官方支持**，目前只做 CI 自动化测试，不做人工测试。
+macOS 是正式支持的平台。更详细的逐步指南请参见 [`build-macos-zh.md`](build-macos-zh.md)。
 
 安装依赖：