博客
Tactic Remote 1.14 设计详解:能力协商、非交互 Git 执行与部分失败恢复
为什么连接 1.13 旧电脑端时自动保持只读、SSH 凭据怎样在不卡死的前提下保留自定义配置,以及为什么“提交并推送”不能按单一原子成功/失败处理。

在电脑终端里敲 git commit 与 git push 之所以顺手,是因为 Git 随时能暂停下来向你提问:输入 SSH 密钥口令、确认陌生服务器指纹、弹出默认编辑器,或者直接在屏幕上打印前半段成功、后半段失败的日志。
但把这些写操作搬到 iPhone、iPad 或网页端后,交互边界完全变了——手机点完按钮,后台进程不能在标准输入上干等人工键盘输入。Tactic Remote 1.14 围绕“不破坏旧电脑端兼容、不在服务端卡死、不在部分失败后误导用户重复提交”三条原则设计了完整的 git_write_v1 工作流。
本文对应 Tactic Remote 1.14 发布公告,偏重协议与安全取舍;具体上手步骤与故障对照请见 移动端 Git 工作流实操指南。
1. 不提高 protocolVersion,如何让新旧电脑端平滑共存?
客户端和电脑配套端很少同步升级:手机 App 通过 App Store 更新,而 Mac 客户端、Windows 预览版、Linux 服务器 CLI 可能隔几天甚至几周才升级。1.14 延续了 protocolVersion = 2,仅通过电脑端在连接握手时声明附加能力字符串 git_write_v1 来开启写操作。
当电脑端在运行环境中检测到可用的 git 可执行文件时,才会在能力列表里加入 git_write_v1。iOS 1.14 与网页版 1.14 收到握手信息后按能力门控切换界面:
- 检测到
git_write_v1:展示分支切换/新建、拉取、推送、提交说明框、暂存/取消暂存按钮,并读取git_review返回的upstream、ahead/behind、head_commit、operation_state与author_configured状态。 - 未检测到
git_write_v1(例如连接 1.13.x 电脑端):审阅面板自动退回干净的只读模式,不显示失效按钮,也不弹窗打断当前对话。

2026 年 11 月 15 日模拟器联测截图:iOS 1.14.0 (51) 连接 1.13.1 Mac 宿主机上的 demo-repo,审阅保持只读且零报错。
2. 非交互执行、保留用户 SSH 配置与仓库级互斥锁
移动端的 WebSocket RPC 调用无法接管电脑端的隐藏 stdin 提示。因此电脑端 Git 服务在派生 git 子进程时都会注入非交互护栏:GIT_TERMINAL_PROMPT=0、禁用 GCM_INTERACTIVE 弹窗、GIT_EDITOR=true 与 LC_MESSAGES=C,确保不会卡在隐藏交互提示或非英文解析分支上。
涉及网络的 push / pull 以及可能触发 LFS/hook 的 commit / checkout 对 SSH 的处理更加克制。因为 Git 解析 SSH 的优先级固定为 GIT_SSH_COMMAND > core.sshCommand > GIT_SSH > ssh,如果服务端粗暴覆写 GIT_SSH_COMMAND,就会悄悄架空用户在仓库里配好的专用私钥或 ProxyCommand。1.14 先读取 GIT_SSH_COMMAND、GIT_SSH 与 git config --get core.sshCommand,仅当三者均未配置时才补充:
这一选择的边界也很坦诚:accept-new 能在第一次非交互推送到新远端主机时自动记录公钥而不卡死,同时仍会拒绝已知主机公钥发生篡改的情况;如果你要求首次连接前必须人工核对指纹,可以在电脑上预先写入 known_hosts 或配置 core.sshCommand。
所有写入 RPC(git_stage、git_unstage、git_discard、git_commit、git_push、git_pull、git_branch)还会按仓库根目录在进程内通过互斥锁串行排队,受工作区基础路径边界与敏感目录鉴权约束。如果外部终端或 Agent 进程恰好占用着 .git/index.lock,不仅变更列表会报错,Diff 详情页顶部也会弹出可关闭的错误提示条,避免点完无任何响应的困惑。

同日模拟器联测截图:在 demo-repo 放入测试用 .git/index.lock 后于详情页点击“暂存”,界面即时弹出可关闭提示条。
3. 展示列表设 5,000 条上限,写前校验仍读取完整索引
开发者偶尔会在未配置忽略规则的情况下打开包含 node_modules 或构建产物的仓库。如果 git_review 把几万条未跟踪文件全量塞进一次 WebSocket JSON 载荷,移动端渲染列表会明显卡顿甚至超时。
1.14 对 git_review 列表设定了 5,000 条上限(超过后先对超过 200 个文件的未跟踪目录做目录折叠,仍超出则截断前 5,000 条并返回附加字段 too_many_changes)。与此同时,写入前状态校验依然读取完整 Git status/index(最高 16 MiB),避免基于截断摘要做出错误判断;单文件 Diff 读取则按 head / staged / unstaged 三个作用域隔离,默认限制 120 KiB 以保流畅。
4. 为什么“提交并推送”必须拆成两个状态返回?
界面上虽然把“提交并推送”做成一个快捷按钮,但在 Git 语义里它由两个持久性完全不同的步骤组成:git commit 会真实改写本地 HEAD 与对象库,而 git push 依赖远端网络、上游权限或远端分支是否分叉。
若 commit 已经成功生成哈希 a4b5e9f,随后 push 因未配置远端或网络错误而失败,此时如果界面只笼统提示“操作失败”且保留原输入框草稿,用户在手机上极易再点一次“提交并推送”,造成意外的空提交或报错混乱。因此 1.14 在 iOS 与网页端统一采用部分失败恢复状态:
- 明确提示“已提交
a4b5e9f,但推送失败:……” - 更新顶部领先计数为
↑1,表明本地已有待推送提交 - 自动清空提交说明草稿,接下来只需排查网络或远端后直接点单独的“推送”即可。

同日模拟器联测截图:在未配置 Git remote 的测试仓库点击“提交并推送”,本地提交保留且草稿清空。
5. 把模糊报错翻译为明确的工作区护栏
为了让 Git 错误在手机屏幕上也能直接看懂且防止误删,1.14 梳理并细化了五类高频保护状态:
- 无 upstream 分支点 Pull:不再笼统报错“没有配置 Git 远端”,而是提示“请先推送一次以设置上游分支,然后再拉取”。
- 脏工作区切换分支 / Pull 阻断:当未提交修改会被切换目标覆盖时,明确提示先提交、贮藏(stash)或放弃修改,而不再误报成“合并冲突”。
- 游离 HEAD 禁推保护:处于 detached
HEAD时直接禁用推送,引导先创建或切回正式分支。 - 未跟踪文件永久删除确认:不同于
git checkout恢复已跟踪文件,丢弃未跟踪文件或文件夹会从电脑磁盘彻底删除,因此操作菜单与弹窗均明确写明“删除未跟踪的文件 / 文件夹,此操作无法撤销”。

同日模拟器联测截图:本地存在冲突修改时尝试切分支,界面精准提示阻断原因与解决建议。

同日模拟器联测截图:长按未跟踪文件选择“删除”后,弹窗明确告知文件将从电脑上删除且无法撤销。
6. Tactic Relay 默认开启 Portal 与适用边界
1.14.0 起,所有通过 Tactic Relay 连接的电脑端默认启用 Portal 本地网站发现与私有预览(含从旧版升级的 Mac 端)。私有预览仅限已登录账号所有者本人访问,无需将预览流量送入内容审核链路;而创建对外分享链接依然是独立确认动作,仅在支持地区开放,并要求指定链接有效期与显式同意自动化内容审核。
同时仍需明确边界:复杂的交互式 rebase、交互式逐行解决三路合并冲突等任务,依然更适合交给对话里的 Agent 或内置原生终端(Native Terminal)处理,而非高频点击的移动端 Review 工具栏。以上功能已完成跨平台实测,包括本机 Mac 1.14.0 (34)、iPhone 15 真机 TestFlight、iOS 1.14.0 (51) 双端模拟器、Web App 1.14 Chromium E2E、Windows 1.14 Server、Docker LinuxServer 与四架构 CLI。