常见问题
提示 git 命令失败?
确认系统已安装 Git 并加入 PATH;私有仓库需提前配置好凭据(HTTPS 凭据管理器或 SSH 免密)。
软件同步期间会禁用 git 交互式凭据输入(GIT_TERMINAL_PROMPT=0),避免无人值守时卡住,因此凭据必须在同步前配置好。
LFS 文件没有备份?
安装 git-lfs 后重新同步。LFS 对象在推送前会预上传到每个目标(git lfs push --all),若目标行出现「LFS 对象预上传失败」警告,通常是目标侧 LFS 认证问题(SSH 目标走 HTTPS LFS 端点),请配置凭据助手或改用 HTTPS 地址。
详见同步原理。
仓库显示「未配置」?
该仓库缺少 origin 源地址,或没有任何备份目标远端。补齐后即可参与同步:
- 未配置仓库不参与同步(「开始同步」自动跳过、MCP
sync_repo直接拒绝),避免必然的「失败」记录 - 在基地址内给仓库添加远端(
git remote add <名字> <地址>),软件会自动识别为备份目标
如何让某个仓库不再同步?
把仓库目录移出基地址即可——仓库列表完全跟随基地址内的目录,目录移走后即从列表中移除、不再参与同步,也不会被下一次同步重新拉回;仓库本身与内容不受影响,放回去即可恢复。软件不提供删除入口:仓库配置只读(v1.0.0-beta.6 起),源与备份目标由 .git/config 派生,管理远端请用 git 命令。
「保持登录 30 天」是什么原理?
勾选后会话令牌写入数据库,软件重启后自动恢复登录态;不勾选则关闭软件即失效。