排查问题

找不到仓库

检查 GitHub 账号已关联、GitHub App 已为仓库所有者安装，并授予该仓库访问权限。组织安装可能需要所有者批准权限。修正后返回 Repositories 重新连接。

看不到 Git 变更

扫描仓库并等待索引完成。Prosefly 使用明确扫描，不通过 GitHub webhook 自动同步。确认扫描的是预期目标分支。

Space 已归档

断开仓库会归档其 Space。重新连接后，由 Owner 或 Admin 启用需要的 Space。启用时会检查活跃内容空间 容量。

文档无法可视化打开

打开 Source 检查完整文件。无效 frontmatter 或不支持的 MDX 可能影响可视化视图。编辑器不会执行任意仓库组件。修正源码后确认保存状态。

发布被阻止

检查审阅中的冲突或校验错误。确认 GitHub App 写入权限、Space 发布模式、目标分支保护、组织角色与使用权益。基础版本改变时，请比较当前 Git 内容和草稿。

发布后网站没有更新

从发布记录打开 GitHub 结果。如果是 PR，确认已经合并。检查网站构建状态及部署分支。发布到 Git 不会直接执行部署。

上传失败或分析为空

检查文件校验及 账单 中的剩余额度，确认上传状态后重试。音视频分析需要实时集成配置；没有报告不能证明文件没有被播放。

通过已有支持渠道反馈问题时，请提供操作、可见错误和相关仓库或文件路径，不要附带凭证或无意分享的私有内容。