git 指南

qqqide 内置 git 工具（工作区标签页）——日常提交、分支、历史、贮藏，不用装任何第三方客户端。git 引擎随绿色包自带，开箱即用。

一、打开

顶部工具条点击 git → 打开 git 标签页。

• 打开时自动扫描 AI 视口里的全部项目：每个项目一个「仓库胶囊」，显示 分支名@项目名 + 红色徽章（未提交更改数）；点击胶囊切换当前仓库；
• 不是 git 项目的胶囊显示 ×——切到它，可一键「初始化仓库」；
• 项目还没加进 AI 视口？先在视口里添加项目，git 里就会自动出现。

二、日常提交（三步）

1. 暂存：在「工作区 / 未追踪」列表里对每个文件点 ↑（或用顶部「全部暂存」）；
2. 写信息：顶部输入提交信息（可选勾 amend / sign-off）；
3. 提交：点「提交」。

三个文件区与行内按钮：

顶部「取消暂存」= 一键把暂存区全部移回工作区。

三、看差异

• 点击任意文件行 → 打开 Diff 窗口：独立窗口、Monaco 左右并排对比；
• 「仅差异」按钮：一键折叠大段未改动的区域，只看变化；
• 窗口支持拖拽 / 最大化（标题栏双击也可）；Diff 窗口为只读，不会误改文件。

四、提交历史

• 下半部分是分支图（Canvas 绘制：分支曲线、圆点、作者、日期），每 15 秒自动刷新；
• 点一行 → 展开提交详情：文件数、+增 / -删 统计、文件列表；点文件看该文件的 diff，「查看完整 diff」看整个提交；
• Ctrl+点击提交行 = cherry-pick（拣选到当前分支）；Alt+点击 = revert（创建反向提交，有确认）；
• 「全部分支」勾选框：切换只看当前分支 / 显示全部分支线。

五、分支 / 贮藏 / 冲突

• 分支（顶部「分支」按钮）：输入名字 + 「新建」创建分支；列表里对每个分支可「切换 / 合并 / 删除」（当前分支有绿点标记；main / master 不可删）；
• 贮藏（顶部「贮藏」按钮）：「+ 贮藏当前」一键收纳工作区改动；每条贮藏可「应用 / 弹出 / 丢弃」；
• 合并冲突：出现冲突时自动浮现「⚠ 合并冲突」区——每个文件可一键「用本地 / 用远端」解决（自动暂存）。

六、拉取 / 推送 / 克隆

• 拉取（快进式 pull）/ 推送 / 获取（fetch --all --prune）：长时间操作有进度提示，失败给出具体原因（红字）；
• 克隆：点「克隆」→ 填仓库 URL（可选目录名）→ 「开始克隆」（带实时进度）；克隆完成自动切到新仓库；
• 初始化仓库：对未版本化的项目一键 git init，随后自动加载状态与历史。

七、小知识

• 状态每 15 秒自动刷新，也可手动点「刷新」；
• 「日志」按钮 = 展开并滚动到提交历史；
• 「放弃更改」是用 git 恢复文件到未修改状态，不可撤销——有确认步骤，请慎重。