Docs/gitpassword/快速开始
快速开始
用一个私有 Git 仓库创建你的第一个加密保险库，并完成一次同步与恢复演练。
本文带你跑通一个真实的 GUI 最小闭环：仓库设置 → 登录/注册 → 添加条目 → 保存/导出 → 处理冲突（如有）。
1. 准备一个私有 Git 仓库
建议为 GitPassword 单独准备一个私有仓库（GitHub / GitLab / 自建服务均可）。
你只需要准备好：
- 远程 URL（例如
https://.../.git或 SSH URL） - 一个本地目录，用来存放该仓库（即后续的「本地路径」）
2. 仓库设置（仓库设置）
启动 GitPassword 后，在「仓库设置」页填写：
- 远程 URL
- 本地路径
- SSH 用户名（可选）
- SSH 私钥（可选）
然后点击「继续」。
应用会开始克隆仓库（你可能会看到「正在克隆仓库」）。
3. 登录或注册（本地 vault 身份）
克隆完成后会进入 GitPassword 的本地 vault 身份流程：
- 输入框：用户名、密码
- 选项：记住凭据
- 按钮：登录、注册
这里的登录/注册用于本地 vault 用户与加密密钥，不表示你的明文 vault 会上传到 GitBraints 云服务。
提示：
- 登录按钮在用户名与密码都填写前不可用。
- 如果你勾选了「记住凭据」，后续可能会自动填充用户名，并在满足条件时尝试自动登录。
4. 添加你的第一条内容（添加菜单）
进入主界面后，你可以通过「添加」按钮打开菜单：
- 添加密码
- 添加笔记
- 添加文件
如果当前存在未解决的冲突，应用会提示「存在未解决的冲突，无法执行此操作。请先解决所有冲突。」此时需要先处理冲突（见本文最后一节）。
4.1 添加密码
选择「添加密码」后，会创建一条默认标题为「新建密码」的条目并进入详情页。
常用字段：
- 标题
- 用户名
- 密码（支持显示/隐藏、复制，并可「生成安全密码」）
- 网站
- 备注
- 文件夹
- 收藏
修改完成后，在详情页顶部点击「保存」。
4.2 添加笔记
选择「添加笔记」后进入详情页，填写：
- 标题
- 内容
然后点击顶部的「保存」。
4.3 添加文件
选择「添加文件」后会弹出文件选择窗口，选择要导入的文件。
导入后进入详情页：
- 可查看文件名、大小、类型
- 视文件类型与版本能力，可进入「文件预览」
- 可通过「导出文件」将文件导出到本地
- 保存后，文件会作为加密 vault 数据写入本地仓库，并可通过你配置的 Git remote 同步
同样在详情页顶部点击「保存」。
5. 同步与恢复（按 Git 仓库方式理解）
GitPassword 的数据位于你的仓库目录中。
- 如果你配置了远程 URL：应用会在需要时与远端交互（例如登录时会尝试获取远端分支）。
- 如果你只使用本地仓库：应用会提示同步功能已禁用。
你也可以使用你熟悉的 Git 工具对该仓库进行备份与迁移（例如在另一台机器克隆同一个仓库，再用 GitPassword 指向相同的「本地路径」目录并登录）。
6. 冲突处理（冲突）
当应用检测到合并冲突时：
- 左侧会出现「冲突」入口，并提示「检测到合并冲突」
- 你需要进入冲突列表，点击「解决冲突」，对比版本并选择要保留的内容
- 未解决冲突前，部分操作与同步会被阻止