Settings and Limits

设置与限制

在 VS Code 设置中搜索 TriForge Git 或 triforge。设置既可写入用户级 settings.json，也可按工作区配置；不要在设置中放 Token。

可用设置

triforge.defaultVisibility

同步推送时，缺失仓库创建可见性的默认选中项。

值	含义
private	默认私有；0.5.0 默认值
public	默认公开

每次推送仍会显示选择框，设置不会在用户无确认时直接创建公开仓库；已有仓库的可见性不会被修改。

{
  "triforge.defaultVisibility": "private"
}

triforge.graph.maxCommits

完整 Git Graph 一次加载的最大提交数。

• 默认：300；
• 最小：20；
• 最大：2000。

{
  "triforge.graph.maxCommits": 500
}

值越大，复杂历史的解析、布局和 Webview 渲染耗时越高。看不到更旧提交时先确认是否达到此上限，而不是认定历史丢失。

侧栏紧凑图固定显示最近 40 条跨分支提交，不由此设置扩大；点击完整 Graph 查看更多。回退选择会至少使用 40 条并参考完整 Graph 上限，最大不超过 2000。

triforge.search.maxRepositoriesPerConnection

聚合搜索中每个连接最多收集的仓库数。

• 默认：100；
• 最小：10；
• 最大：100。

{
  "triforge.search.maxRepositoriesPerConnection": 100
}

它是每个连接的上限。例如三个连接各返回 100 条时，合并选择框最多约 300 条，去重或失败会减少数量。平台 API 自身还可能限流、截断或按不同规则排序。

triforge.confirmBeforeForceDeleteBranch

普通删除发现分支尚未完全合并后，是否再次确认强制删除。

• 默认：true；
• 建议保持开启。

{
  "triforge.confirmBeforeForceDeleteBranch": true
}

设为 false 只减少 TriForge 二次弹窗；首次删除确认和 Git 检查仍存在，但未合并提交的风险没有消失。

0.5.0 没有的设置

没有 triforge.git.path

扩展通过 PATH 启动 git。带 Token 操作会在注入凭据前运行受限的 git --version 探测，无法检测或低于 2.31 时安全停止；但界面没有用于选择另一个 Git 可执行文件的配置项。

macOS 从 Dock 启动的 PATH、Remote SSH/Container 的 PATH 与本机终端可能不同，详见 macOS 使用说明。

没有 Token 设置项

Token 只能通过“添加/修改连接”写入 SecretStorage。下列配置均不存在，也不应自行添加：

triforge.githubToken
triforge.gitlabToken
triforge.giteaToken

没有关闭 TLS 校验的设置

0.5.0 不提供 allowInsecureTLS 或自定义 CA 文件选项。HTTP 实例需要显式模态确认，但 HTTPS 证书错误不应通过关闭校验处理。

没有自动 Force Push

同步推送没有“自动覆盖远程”设置，也不会因为 non-fast-forward 自动改成 --force。

没有自动同步 Token/连接的设置

0.5.0 不通过 Settings Sync 同步平台连接元数据；SecretStorage Token 也不会跨设备同步。

固定运行限制

这些不是用户可调整的设置：

项目	0.5.0 行为
侧栏图	最近 40 条提交
Git 远程操作	常见 Fetch/Pull/Merge/Push/Clone 使用 10 分钟超时
Git 默认输出上限	64 MiB
Git 版本探测	5 秒、16 KiB 输出上限
API 默认响应上限	16 MiB
聚合搜索并发	最多 3 个连接同时搜索
每连接分页	最多 50 页，并同时受每连接结果上限限制
同步推送	一次只推当前分支
自动创建 namespace	当前认证用户个人空间
Pull 策略	Fast-forward only

超时不代表服务端一定没有完成请求。例如网络断开时，远端可能已经创建仓库或接收部分 Push。重试前先检查平台网页、远程分支和 git remote -v。

平台与 Git 限制

TriForge 设置不能覆盖：

• 平台 API 限流；
• Token scope 与到期；
• 组织/群组审批；
• 分支保护与提交签名策略；
• 仓库大小限制；
• Git LFS 配额；
• 反向代理超时；
• 服务端仓库命名规则；
• Git 的 non-fast-forward 检查。

出现这些问题时，应调整平台或团队流程，而不是把 Graph 上限、搜索上限等本地设置当成认证开关。

推荐个人配置

保守配置：

{
  "triforge.defaultVisibility": "private",
  "triforge.graph.maxCommits": 300,
  "triforge.search.maxRepositoriesPerConnection": 100,
  "triforge.confirmBeforeForceDeleteBranch": true
}

大型仓库可只提高 Graph 上限，例如 800；若 UI 变慢，再调低。

工作区设置的隐私提醒

写入 .vscode/settings.json 的工作区设置可能被提交到 Git。当前四个 TriForge 设置不含凭据，一般可以共享，但它们仍表达团队偏好。Token、内部实例 URL和用户名不属于这些设置，不应手工塞入工作区配置。