部落格
Tactic Remote 1.14 設計詳解:能力協商、非互動 Git 執行與部分失敗恢復
為何連接 1.13 舊主機時自動保持唯讀、SSH 憑證如何在不卡住的情況下保留自訂設定,以及為何「提交並推送」拆為兩段狀態回報。

在電腦終端機操作 git commit 與 git push 時,Git 隨時可以停下來等待使用者回應密碼或編輯器提示;但將寫入流程帶到 iPhone、iPad 與網頁端後,背景進程絕不能卡在看不見的標準輸入上。Tactic Remote 1.14 透過能力門控與明確的錯誤狀態拆解,讓行動端 Git 操作既順手又安全。
本文配合 Tactic Remote 1.14 發佈公告 說明核心工程設計;操作步驟與故障排除請看 行動端 Git 工作流程操作指南。
1. 不提升 protocolVersion,透過 git_write_v1 平滑共存
手機與電腦端往往分開升級。1.14 維持 protocolVersion = 2,僅在主機偵測到可用的 git 後於握手階段宣告 git_write_v1。連線至 1.13.x 舊主機時,1.14 用戶端不會顯示寫入按鈕,保持安靜乾淨的唯讀差異檢視。

2026 年 11 月 16 日模擬器聯測截圖:iOS 1.14.0 (51) 連接 1.13.1 主機保持唯讀且無報錯。
2. 非互動執行、保留 SSH 設定與儲存庫互斥鎖
每個 Git 子進程皆注入 GIT_TERMINAL_PROMPT=0、停用互動式 GCM_INTERACTIVE、GIT_EDITOR=true 與 LC_MESSAGES=C。針對 SSH,程式優先尊重已設定的 GIT_SSH_COMMAND、GIT_SSH 與 core.sshCommand(保留專用私鑰或 ProxyCommand),僅在三者皆無時退回 ssh -o BatchMode=yes -o StrictHostKeyChecking=accept-new。
同一儲存庫的寫入請求會透過儲存庫層級互斥鎖依序排隊並受工作區基礎路徑與敏感目錄權限保護;若外部終端機佔用 .git/index.lock,Diff 詳情頁頂部會即時顯示可關閉的錯誤橫幅。

模擬器驗證截圖:遇到 .git/index.lock 鎖定衝突時於詳情頁即時呈現錯誤橫幅。
3. 清單 5,000 筆上限與寫前完整索引校驗
遇到含大量未忽略目錄(如 node_modules)的儲存庫時,git_review 超過 5,000 筆會先折疊大型未追蹤目錄並附上 too_many_changes 旗標避免行動端卡頓;但寫入前仍會讀取完整 index/status(最高 16 MiB),不以截斷後的摘要作寫入判斷依據。
4. 為何「提交並推送」必須拆分為兩段狀態
若 git commit 已成功生成 6f227e5,但 git push 遭拒,介面會清楚回報已建立的短雜湊與推送錯誤、顯示 ↑1 領先標記,並清空提交說明草稿,讓使用者稍後直接按下「推送」而不誤造重複 commit。

5. 工作區與永久刪除防護
針對未設定 upstream 的拉取、會覆蓋本機未提交修改的分支切換、游離 HEAD 推送以及未追蹤檔案從磁碟永久移除,1.14 皆拆分為對應提示與紅色確認視窗。


6. 預設開啟私有 Portal 與適用邊界
1.14.0 讓 Tactic Relay 主機預設啟用私有 Portal 探索與預覽,同時將公開分享連結維持為需要明確同意內容審核與效期的獨立操作。至於複雜的互動式 rebase 或手動三路衝突編輯,仍建議交由對話中的 Agent 或原生終端機執行。