终端与版本管理
终端会话、初始化仓库、暂存提交、拉推与冲突。
终端与版本管理
开发系统把命令行和 Git 状态放在同一窗口里，方便对照 AI 改动。本机没有 Git 时，版本栏只能引导安装，不能代替 Git 本身。
打开终端
- 标题栏终端按钮、视图 → 切换终端，或快捷键
Ctrl+`（Mac：Cmd+`）。 - 确认提示符所在目录就是当前项目根（多根时看带「当前」徽章的那一组）。
- 运行构建、测试、启动等命令。
- 需要再开一路进程时，点 + 新建会话，不要把互不相干的日志混在一个窗口里。
会话名一般为「终端 1」「终端 2」。关错了重新开即可，不会删除项目文件。至少保留一个会话。橡皮按钮只清屏，不结束正在跑的进程。
面板还可：缩小/放大/重置缩放、全屏、浮动后再嵌回底部。
终端右键：复制选区、复制全部输出、粘贴、全选、清屏；添加到对话 / 添加全部输出到对话；在编辑器中打开选区；在浏览器中打开选区。
当前环境若提示「未暴露 PTY API，无法创建交互式终端」，说明这个窗口建不了交互式终端，请改用桌面应用主窗口。
让 AI 跑命令
- 右侧切到 Agent。
- 写清要执行的命令目的和目录，例如：
在项目根目录运行测试，不要安装新依赖。 - 先看权限和信任等级：重要操作需确认、文件修改需审核。「全智能」下高危命令也可能不再确认，第一次不要开这一档。
- 命令结果以终端输出为准；失败时把输出贴回 Ask，或终端右键添加到对话。
不要让 Agent 在未确认时执行删除、格式化磁盘、改系统全局配置一类操作。
版本栏：还不是 Git 仓库时
打开左侧 版本。可能看到：
- 未打开工作区：「打开工作区后可使用源代码管理与分支操作」
- 未检测到 Git：当前命令行环境无法执行 git。可 前往官网下载、使用国内镜像、重新检测
- 已检测到 Git，但工作区未初始化：可 初始化 Git 仓库、初始化并绑定远程、克隆远程仓库…、刷新状态
重要项目建议用 Git，并在大改前保证可以回退。本手册不代替 Git 教程，只说明左辅星里从哪看变更、何时该停下来人工确认。
已是仓库：看什么、点什么
顶栏常见：
- 当前分支（点开「切换分支」：搜索、本地分支、远程分支）
- 与远程的落后 / 领先箭头；已同步时显示已与远程跟踪分支同步
- 游离 HEAD、合并进行中、变基进行中会有标记
- 刷新、拉取、推送（分离 HEAD 时无法推送；无上游时是「发布分支到远程」）
- 更多 Git 操作（…）
更多里常见分组（以界面实际条目为准）：
- 拉取 / 推送 / 签出到… / 抓取
- 提交：提交、提交已暂存文件、全部提交、撤消上次提交、提交(修改)、中止变基、中止合并
- 更改：暂存所有更改、取消暂存所有更改、放弃全部更改
- 分支：创建、从某点创建、重命名、删除、发布、合并、变基
- 远程：添加 / 删除远程存储库
- 存储：储藏、含未跟踪的储藏、应用/弹出最新储藏等
文件列表分块：合并更改（冲突）、已暂存的更改、更改。无变更时：「没有未暂存的工作区更改」。区块上可 全部暂存 / 全部取消暂存。单击文件打开差异。
文件右键常见：打开更改、打开文件、暂存/取消暂存、复原更改、删除未跟踪文件、储藏此文件、复制路径或补丁、添加到 .gitignore、在资源管理器/文件管理器/终端中打开。冲突时可 采用当前更改 / 采用传入更改。
提交
底部提交栏：
- 先把要提交的文件放进 已暂存的更改。
- 填写提交说明（占位「填写提交说明…」）。不要只写「update」。
- 点 ✓ 提交，或
Ctrl+Enter（焦点在提交栏时）。 - 无暂存时会提示：请先在「暂存的更改」中加入文件。
提交前建议：
- 先在 审核 里处理完待审项（采纳或拒绝）。
- 再看 版本 里是否还有你没打算提交的文件。
- 涉及
.env、密钥、部署脚本时，即使差异很小也要逐行看。
提交时间线默认折叠。可按说明 / 作者 / 哈希筛选。右键可查看提交、复制哈希、检出此提交（分离 HEAD）、从此提交新建分支、Cherry-pick、Revert。空：「暂无提交记录」。
同步与危险操作
- 同步会先 pull 再 push；pull 失败则不会推送。界面会再确认一次。
- 强制推送、放弃全部更改、hard 重置会再确认，有的要确认两次。全部丢弃不可撤销。
- 撤消上次提交：更改通常保留在暂存区，仍要自己检查。
冲突横幅：「合并存在冲突，请解决后提交」或「变基存在冲突，请解决后继续」。先在列表的「合并更改」里处理，再提交。