Skip to main content

版本控制

Qixin Automation Platform 内置 Git 版本管理。每个 app 工作区可作为独立的 Git 仓库。

打开 Git 面板

编辑器左侧 Activity Bar → Git 图标。图标右上角的数字表示未提交变更数量。再次点击可收起面板。

截图占位:Git 面板界面

面板布局

Git 面板分为上下两部分:

  • 上方:同步操作区。Pull/Push 按钮、分支选择器、远程选择器、提交信息输入框和提交按钮。
  • 下方:文件列表。显示变更文件,右侧数字表示增减行数。

提交信息输入默认单行。文件列表与上方独立滚动。

常见操作

查看变更(Status)

打开 Git 面板,文件列表显示所有有变更的文件:

  • 修改(modified)
  • 新增(added)
  • 删除(deleted)

查看差异(Diff)

点击文件行,弹窗显示该文件的变更内容(diff)。增减行数汇总显示在文件行右侧。

未跟踪的新文件会显示完整内容(new-file diff)。

暂存与提交(Stage / Commit)

  1. 勾选要提交的文件。
  2. 输入提交信息。
  3. 点击 Commit。

分支(Branch)

分支选择器在面板上方,点击展开菜单:

  • 查看本地和远程分支
  • 搜索分支
  • 切换分支
  • 创建新分支(弹窗输入名称)

远程(Remote)

远程选择器在分支选择器下方:

  • 切换已有远程
  • 添加新远程(弹窗输入名称和地址)

同步(Fetch / Pull / Push)

面板上方同步按钮执行对应操作。

AI 生成提交信息

Git 面板可以基于当前 staged 文件自动生成提交信息(中文)。点击生成按钮,AI 读取变更内容后返回建议,人工确认后使用。

凭据

网络操作(Pull/Push/Clone)默认使用系统凭据管理器(Git Credential Manager、SSH agent 或系统 keychain)。

HTTPS token 仅用于认证失败后的重试,不会写入 remote URL 或 app 配置。

现场建议流程

  1. 修改前确认当前分支正确。
  2. 完成配置后保存并测试运行。
  3. 打开 Git 面板查看 diff,排除不需要提交的文件。
  4. Stage 本次变更文件。
  5. 填写清晰的提交信息(可使用 AI 生成)。
  6. Commit。
  7. Push 到远程仓库。

注意事项

  • Git 操作限制在当前 app 工作区内,不能访问 .git 目录外的文件。
  • 新建 app、ZIP 导入和 Git 导入时,.gitignore 自动包含 compiled/(构建产物不提交)。
  • 导出 ZIP 不包含 .git 历史。
  • compiled/ 下的文件是本机生成,不需要也不应该提交到 Git。