ReadTheDocs开启PR构建后仅用户指南触发 其余文档未构建怎么办

• 检查GitHub仓库Webhook配置
  同一个GitHub仓库绑定多个RTD项目时，RTD仅会为首个绑定的项目自动配置Webhook，后两个项目无法默认接收PR事件通知。进入GitHub仓库「设置→Webhooks」页面，确认是否存在psyclone-dev、psyclone-ref对应的RTD Webhook，校验Payload URL与对应RTD项目的Webhook地址一致，且触发事件已勾选Pull requests、Pushes两类必要选项。
• 校验RTD项目版本过滤规则
  进入两个未触发项目的RTD后台「版本」设置页，确认PR的目标分支已被纳入可构建的活跃版本范围，且未设置匹配PR源分支/目标分支的排除规则。
• 核对RTD配置文件路径
  若仓库内存在.readthedocs.yaml配置文件，确认两个未触发项目是否在「高级设置」中指定了专属的配置文件路径（如开发者指南对应docs/developer/.readthedocs.yaml），避免默认读取的根目录配置仅适配用户指南项目，导致其他项目无有效构建规则无法触发任务。
• 确认RTD项目权限配置
  检查绑定RTD项目的GitHub账号是否拥有目标仓库的管理员权限，且RTD官方OAuth应用已获得仓库的读取、Webhook配置权限，权限不足会导致RTD无法接收PR事件推送。
• 检查PR目标分支匹配规则
  确认测试PR的目标分支与两个未触发项目设置的默认构建分支匹配，若PR目标分支未被纳入项目的构建分支白名单，RTD会直接忽略对应构建请求。

内容的提问来源于stack exchange，提问作者Andrew Porter