返回列表

博客

Tactic Remote 1.14 设计详解:能力协商、非交互 Git 执行与部分失败恢复

为什么连接 1.13 旧电脑端时自动保持只读、SSH 凭据怎样在不卡死的前提下保留自定义配置,以及为什么“提交并推送”不能按单一原子成功/失败处理。

发布于 标签: 发布新闻 / 1.14 / Git / architecture / Portal
Tactic Remote 1.14 安全与恢复机制示意:能力协商边界 git_write_v1、仓库级互斥非交互队列,以及提交成功但推送失败时的分离恢复。

在电脑终端里敲 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 电脑端):审阅面板自动退回干净的只读模式,不显示失效按钮,也不弹窗打断当前对话。
iOS 1.14 连接 1.13.1 旧电脑端时审阅面板保持只读,只显示变更文件与 diff,无暂存或推送按钮。

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,仅当三者均未配置时才补充:

ssh -o BatchMode=yes -o StrictHostKeyChecking=accept-new

这一选择的边界也很坦诚: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 详情页顶部也会弹出可关闭的错误提示条,避免点完无任何响应的困惑。

Diff 详情页在遇到 .git/index.lock 时顶部弹出可关闭的错误提示条:Git 无法完成所请求的操作。

同日模拟器联测截图:在 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,表明本地已有待推送提交
  • 自动清空提交说明草稿,接下来只需排查网络或远端后直接点单独的“推送”即可。
提交成功但推送失败后的审阅面板:提示已提交 a4b5e9f 与具体原因,顶部显示 ↑1,提交框草稿已清空。

同日模拟器联测截图:在未配置 Git remote 的测试仓库点击“提交并推送”,本地提交保留且草稿清空。

5. 把模糊报错翻译为明确的工作区护栏

为了让 Git 错误在手机屏幕上也能直接看懂且防止误删,1.14 梳理并细化了五类高频保护状态:

  • 无 upstream 分支点 Pull:不再笼统报错“没有配置 Git 远端”,而是提示“请先推送一次以设置上游分支,然后再拉取”。
  • 脏工作区切换分支 / Pull 阻断:当未提交修改会被切换目标覆盖时,明确提示先提交、贮藏(stash)或放弃修改,而不再误报成“合并冲突”。
  • 游离 HEAD 禁推保护:处于 detached HEAD 时直接禁用推送,引导先创建或切回正式分支。
  • 未跟踪文件永久删除确认:不同于 git checkout 恢复已跟踪文件,丢弃未跟踪文件或文件夹会从电脑磁盘彻底删除,因此操作菜单与弹窗均明确写明“删除未跟踪的文件 / 文件夹,此操作无法撤销”。
存在冲突的本地修改时切换分支被拦截,提示先提交、贮藏 (stash) 或放弃这些修改。

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

丢弃未跟踪文件 notes/todo.md 时弹出的红色永久删除确认弹窗。

同日模拟器联测截图:长按未跟踪文件选择“删除”后,弹窗明确告知文件将从电脑上删除且无法撤销。

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。

立即体验 Tactic Remote

用手机远程控制编程 Agent

连接 Mac、Windows 或 Linux 电脑上的 Claude Code、Codex 等 Agent,在 iPhone 或 iPad 上查看进展并发送下一条要求。