diff --git a/docs/changelog/3.2.md b/docs/changelog/3.2.md
index b2b9d903..ea1a94bd 100644
--- a/docs/changelog/3.2.md
+++ b/docs/changelog/3.2.md
@@ -9,6 +9,12 @@
   - 支持多设备凭证（iCloud Keychain 等）备份检测
   - 支持克隆攻击防护（sign_count 验证）
   - 认证策略模式，统一密码登录和 Passkey 登录接口
+- 新增首次运行设置向导
+  - 7 步引导式配置：账户、下载器、RSS 源、媒体路径、通知
+  - 下载器连接测试、RSS 源验证
+  - 可选步骤可跳过，稍后在设置页配置
+  - 哨兵文件机制（`config/.setup_complete`）防止重复触发
+  - 无需认证的设置 API（仅首次运行时可用，完成后返回 403）
 - 新增日历视图，集成 Bangumi.tv 放送时间表
 - 新增下载器 API 和管理接口
 - 全面异步化改造
@@ -18,7 +24,7 @@
   - RSS 引擎、下载器、检查器、解析器全面转为异步
   - 网络请求从 `requests` 迁移至 `httpx`（AsyncClient）
 - 后端迁移至 `uv` 包管理器（pyproject.toml + uv.lock）
-- 服务器启动使用后台任务，避免阻塞
+- 服务器启动使用后台任务，避免阻塞（fixes #891, #929）
 
 ### Changes
 
@@ -35,12 +41,12 @@
 - 修复 `aaguid` 类型错误（py_webauthn 2.7.0 中为 `str`，不再是 `bytes`）
 - 修复 `credential_backup_eligible` 字段不存在的问题（改用 `credential_device_type`）
 - 修复 `verify_authentication_response` 传入无效参数 `credential_id` 导致 TypeError
-- 修复程序启动阻塞服务器的问题
+- 修复程序启动阻塞服务器的问题（fixes #891, #929, #886, #917, #946）
 - 修复搜索接口导出与组件不匹配的问题
-- 修复 poster 端点路径检查错误拦截所有请求
+- 修复 poster 端点路径检查错误拦截所有请求（fixes #933, #934）
 - 修复 OpenAI 解析器安全问题
 - 修复数据库测试使用异步会话与同步代码不匹配
-- 修复 3.1.x 升级 3.2 时配置字段冲突导致设置丢失的问题
+- 修复 3.1.x 升级 3.2 时配置字段冲突导致设置丢失的问题（fixes #956）
   - `program.sleep_time` / `program.times` 自动迁移为 `rss_time` / `rename_time`
   - 移除已废弃的 `rss_parser` 字段（`type`、`custom_url`、`token`、`enable_tmdb`）
   - 修复 `ENV_TO_ATTR` 环境变量映射指向不存在的模型字段
@@ -58,6 +64,11 @@
   - 支持亮色/暗色主题切换
   - 完善的无障碍访问支持（ARIA、键盘导航、焦点管理）
   - 响应式布局适配移动端
+- 新增首次运行设置向导页面
+  - 多步骤向导组件（进度条 + 步骤导航）
+  - 路由守卫自动检测并重定向至设置页
+  - 下载器/RSS/通知连接测试反馈
+  - 中英文国际化支持
 - 新增 Passkey 管理面板（设置页）
   - WebAuthn 浏览器支持检测
   - 设备名称自动识别
@@ -66,8 +77,8 @@
 - 新增日历视图页面
 - 新增下载器管理页面
 - 新增 Bangumi 卡片悬停覆盖层（显示标题和标签）
-- 新增 `resolvePosterUrl` 工具函数，统一处理外部 URL 和本地路径
-- 重新设计 LLM 设置面板
+- 新增 `resolvePosterUrl` 工具函数，统一处理外部 URL 和本地路径（fixes #934）
+- 重新设计 LLM 设置面板（fixes #938）
 - 重新设计设置、下载器、播放器、日志页面样式
 - 全新移动端优先响应式设计
   - 三层断点系统：手机 (<640px)、平板 (640-1023px)、桌面 (≥1024px)