返回列表

部落格

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 隨時可以停下來等待使用者回應密碼或編輯器提示;但將寫入流程帶到 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 用戶端不會顯示寫入按鈕,保持安靜乾淨的唯讀差異檢視。

iOS 1.14 連接 1.13.1 舊電腦端時審閱面板保持唯讀,只顯示變更檔案與 diff,無暫存或推送按鈕。

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 詳情頁頂部會即時顯示可關閉的錯誤橫幅。

Diff 詳情頁在遇到 .git/index.lock 時頂部彈出可關閉的錯誤提示條。

模擬器驗證截圖:遇到 .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。

提交成功但推送失敗後的審閱面板:提示已提交 6f227e5 與具體原因,草稿已清空。
模擬器驗證截圖:未設定遠端時本機提交仍被完整保留並清空草稿。

5. 工作區與永久刪除防護

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

存在衝突的本機修改時切換分支被攔截並提示先提交、貯藏或放棄修改。
模擬器驗證截圖:阻擋會覆蓋未提交改動的分支切換操作。
丟棄未追蹤檔案 notes/todo.md 時彈出的永久刪除確認視窗。
模擬器驗證截圖:明確寫出將從電腦磁碟移除且無法復原。

6. 預設開啟私有 Portal 與適用邊界

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

立即體驗 Tactic Remote

用手機遠端操作程式開發 Agent

連線到 Mac、Windows 或 Linux 電腦上的 Claude Code、Codex 等 Agent,在 iPhone 或 iPad 上查看進度並傳送下一個請求。