FAQ

常见问题

TriForge 会替代 VS Code 内置 Git 吗？

不会。TriForge 是独立扩展，直接调用系统 Git，并提供自己的视图和远程平台流程。内置 SCM、终端 Git 和其他扩展仍可同时存在，但它们的认证入口和状态刷新并不完全共享。

暂存、提交、推送有什么区别？

暂存：选择下一次提交内容
提交：在本地历史创建快照
推送：把本地提交发送到远程

提交成功不代表 GitHub/GitLab/Gitea 已经收到更新。

能一次只暂存一个文件吗？

可以。点击未暂存文件右侧 +。已暂存文件右侧 − 只取消该文件暂存。0.5.0 不提供逐行/逐块暂存。

“回退”是不是只回退已经提交的文件？

按钮主要面向提交节点。Revert 反向撤销一个提交；Reset 移动整个当前分支，不是让你从一个提交里只挑某个文件。单文件未暂存内容使用“放弃未暂存更改”，风险和语义不同。

Revert、Mixed、Soft、Hard 选哪个？

• 已经 Push/协作：Revert；
• 想重新拆分提交，内容留在工作区：Mixed；
• 想重新提交，内容保持暂存：Soft；
• 明确永久丢弃：Hard。

不确定就选 Revert。详见 回退、撤销与冲突恢复。

为什么一个本地分支不能同时跟踪三个远程？

Git 的 upstream 是单值配置，用于决定普通 Pull 默认来源。但 TriForge 同步 Push 的目标是独立多选，所以“一个 upstream + 多个 Push 目标”可以同时成立。

Graph 上三个平台的位置是实时的吗？

不是。它来自本地远程跟踪引用，也就是最后一次 Fetch 后的状态。先 Fetch 再看图。

为什么平台已连接，VS Code/GitLab 仍让我登录？

很可能操作来自 VS Code 内置 Git、Git Credential Manager、终端或其他扩展。TriForge 只给自己发起且 URL 安全匹配的 HTTPS Git 命令提供 Token。

Token 保存在哪里？

VS Code SecretStorage。它不会写到 settings.json、remote URL 或项目文件，也不会通过 Settings Sync 跨机器同步。

能把 Token 加密后放进 VS Code 配置以便同步吗？

技术上可以制造密文，但必须解决解密密钥同步问题，通常只是把风险换个形式。项目不计划默认这么做；每台设备重新输入一次 Token 更符合 SecretStorage 的安全边界。

换电脑后连接会自动回来吗？

0.5.0 不会。连接元数据尚未加入 Settings Sync，Token 也按官方设计不能跨机器同步。新电脑要重新添加连接。

删除连接会删除远程仓库吗？

不会。它只删除连接元数据和本地 SecretStorage Token。Git remote、提交和平台仓库都保留。

同步推送会覆盖远程吗？

使用普通 Push，不自动 Force Push。若远端有本地没有的历史，通常会以 non-fast-forward 失败，让用户先处理分叉。

三个平台只要有一个没有仓库，会发生什么？

每个勾选连接独立检查。缺失的连接会创建仓库，已有的连接复用原仓库，然后分别 Push。不会因为某个平台已有就跳过其他平台的检查。

能选择公开或私有仓库吗？

可以。每次同步推送都要求选择缺失仓库的可见性；已有仓库的可见性不会被改变。默认值由 triforge.defaultVisibility 控制。

能创建到 GitHub Organization 或 GitLab Group 吗？

0.5.0 的界面没有 namespace 选择，自动创建目标是 Token 当前用户的个人 namespace。组织/群组需后续版本支持或先在平台手工创建，再让 TriForge 复用。

能搜索所有三个远程吗？

搜索的是所有已连接的托管平台 API，不是 .git/config 里的 remote。可以连接少于或多于三个实例；TriForge 最多并发查询三个连接，并合并结果。

支持 SSH remote 吗？

Git 可以保留和使用 SSH remote，但 TriForge 的 PAT 不会发送给 SSH/SCP URL。SSH 认证由 SSH Agent、Keychain 或系统配置处理。自动建库返回的同步路径以经过验证的 HTTPS clone URL 为主。

支持 Git LFS 和子模块吗？

不做自动完整处理。为避免 Token 被 Hook/过滤器/子模块读取，认证 Push/Clone 不递归子模块，LFS 需使用项目认可的独立认证流程。

支持 Tag 和所有分支镜像吗？

0.5.0 同步推送只处理当前分支，不自动推送 Tag 和其他分支。它不是 git push --mirror 的图形包装。

支持 Rebase 和 Cherry-pick 吗？

Git 状态恢复能识别进行中的 Rebase/Cherry-pick，但 0.5.0 没有直接启动它们的按钮。可用受信终端或其他工具开始，TriForge 会在冲突时显示继续/取消状态。

支持 macOS 吗？

通用 VSIX 没有原生二进制，静态上兼容 Intel 和 Apple Silicon；要求 Git 2.31+。0.5.0 尚未完成正式 macOS CI 认证，首次使用请按 macOS 使用说明 做测试。

为什么 Pull 不自动合并？

TriForge 默认 --ff-only，避免在用户不知情时生成 Merge commit 或改写历史。分叉后先看图，再明确选择合并策略。

把同一个分支推到多个平台等于备份吗？

不是完整备份。它不包含其他分支、Tag、LFS、Issue、Wiki、Release、成员权限、Secrets、CI 设置等。重要项目应有独立备份方案。