# 排查问题

处理常见连接、编辑与发布问题。

## 找不到仓库

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

## 看不到 Git 变更

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

## Space 已归档

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

## 文档无法可视化打开

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

## 发布被阻止

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

## 发布后网站没有更新

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

## 上传失败或分析为空

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

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