ci(deploy): 仅允许 master 自动部署

docs/troubleshooting.md

@@ -10,6 +10,7 @@
 | 当前 API 前缀 | `/api/reading/*` |
 | 兼容 API 前缀 | `/api/v2/*`，仅用于旧客户端过渡 |
 | 项目 Python | 优先使用项目根目录 `.venv/bin/python` |
+| 自动部署分支 | 仅 `master`；推送或手动触发均不部署其他分支 |
 | 服务器服务 | `weread.service`，端口以服务中的 `PORT` 为准 |
 | 服务器目录 | `/opt/weread-board/WeReadBoard` |
 
@@ -62,6 +63,10 @@ curl --noproxy '*' -i 'http://127.0.0.1:8080/api/reading/dashboard?period=week'
 sudo journalctl -u weread.service -n 100 --no-pager
 ```
 
+### 检查部署分支
+
+自动部署只允许 `master`。如果 Actions 没有启动，先确认提交是否已经合并并推送到 `master`；仅推送 `dev` 不会部署。服务器部署日志中的拉取目标也必须是 `origin/master`，出现其他分支时应停止发布并检查工作流与 `deploy.sh`。
+
 ## 2026-09-14：接口调整后页面请求失败
 
 ### 现象