阅读导览
仓库是 XHGit 的代码和协作边界。拥有者管理成员及功能开关,普通读取者浏览授权内容,写入者按规则提交修改。站点管理员还可能设置仓库创建数量、迁移来源、可见性和功能限制,页面实际可选项以当前策略为准。
创建名称清晰的仓库
- 打开创建仓库,选择个人或自己有权限的组织作为拥有者。
- 填写仓库名、描述和可见性,名称建议使用英文字母、数字与适当分隔符,例如
sample-app。 - 选择是否初始化 README、忽略文件和许可证,核对后创建。
- 进入仓库确认拥有者、路径和私有标识,再邀请协作者。
仓库名是地址的一部分,显示描述可以写中文。名称校验失败时应修改名称,不能把仅由符号组成的替代结果当成原名。私有仓库也应避免上传密码与个人敏感资料。
阅读代码与维护 README
在仓库代码页切换分支或标签,打开文件查看内容、历史或差异。通过“添加文件”使用在线编辑或上传,提交时填写说明,并按权限选择直接提交或创建分支。默认分支影响首页展示和合并请求目标,不会自动删除其他分支。
侧栏的贡献者展示与提交身份关联;点击贡献者可进一步查看统计。个人头像取账号当前资料,未匹配用户或没有个人头像时按站点默认策略显示。作者邮箱需与对应账号的验证邮箱匹配,相关设置见账号。
从其他平台迁移
- 打开迁移仓库,选择页面提供的来源平台。
- 填写来源地址、目标拥有者和名称;私有来源按页面要求使用有权限的凭据。
- 根据来源支持情况选择迁移议题、合并请求、标签等项目,再提交任务。
- 等待完成后检查分支、标签、最近提交和需要保留的协作记录。
来源服务可能限流,迁移失败要查看错误后重试,不能通过反复提交制造更多任务。一次导入不代表持续同步,外部平台后来的 Issue 和 PR 不会因此自动持续同步。页面未提供批量选择时,按仓库分别迁移。
分清普通仓库和镜像
拉取镜像以来源为准,按配置同步远程提交;推送镜像把本仓库内容发送到指定远程。管理员可在仓库设置中配置可用的镜像功能及周期。开始前核对同步方向和凭据权限,防止把错误的远程当作主仓库。
拉取镜像通常不接受普通代码修改;当前实现不会为镜像开放可用的合并请求流程。勾选合并请求开关也不能突破镜像、空仓库或归档状态的限制。若要在 XHGit 维护修改,应由拥有者按实际页面操作转为普通维护模式,并确认后续同步策略。
配置协作者与功能入口
- 由仓库管理员进入仓库“设置”。
- 在“协作者”中添加账号,授予完成任务需要的读取、写入或管理权限。
- 在基本设置中启用需要的议题、Wiki、项目、发布与 Actions 等单元;外部议题或外部 Wiki 需填写各自有效地址。
- 用成员账号核对可见入口和操作范围,避免用拥有者视角误判权限。
外部议题地址与外部 Wiki 地址是两个独立字段。启用外部系统后,入口会按设置跳到站外,不会同时变成本地议题或 Wiki 数据。
保护分支和版本标签
在“设置 → 分支”定义保护规则,按团队需要限制直接推送、强制推送、要求审查或状态检查。在“设置 → Git 标签”配置版本标签保护,限制不符合规则的创建、删除或修改行为。
保护规则要覆盖实际分支或标签名;创建规则后,用普通写入成员的操作结果验证。规则也可能阻止网页编辑和自动化推送,给构建或发布凭据授权时应同时检查账号、令牌和保护要求。更多审查操作见合并请求。
分享徽章与谨慎执行管理操作
仓库的徽章页面为 /拥有者/仓库/badges,可以复制点赞、派生、关注、议题、合并请求、发布版本、许可证和贡献者等可用徽章的 Markdown。工作流状态徽章从 Actions 页面生成。只有相应功能对访问者可读时,外部页面才能正确加载徽章;徽章不会公开原本无权访问的私有内容。
归档用于停止日常修改,转移会改变拥有者,删除会影响仓库及关联数据。操作前核对完整仓库名和页面说明,准备适合项目的备份,再执行确认。遇到无法编辑时先检查状态和权限,不要用重新导入覆盖已有仓库。