2026 DeepSeek Harness node-pty 升級：遠端 Mac 重測清單

node-pty 是 Node.js 對偽終端的繫結，負責讓 Bash 等程式以為自己正在真正的終端中執行，並提供資料讀取、輸入、尺寸調整與結束控制等能力。上游範例也直接展示了 write、resize 與資料事件的基本用法。這代表底層依賴更新，最先影響的是終端資料流與程序控制邊界，而不是模型本身的推理速度。可參考node-pty 的 API 與平台說明。(github.com)

你要把「改善」拆成以下幾個可觀察結果：

• 輸入字元是否即時回顯。
• 多段輸出是否持續到達，而不是只在命令結束後一次出現。
• 命令結束時，介面是否取得正確狀態。
• 按下取消後，PTY 本身及其子程序是否真的停止。
• 重新連線後，看到的是最新輸出、舊畫面，還是完全沒有工作階段。

只看到一次 echo 成功，不足以證明遠端 Mac 已經適合執行長時間 Bash 任務。因為卡頓可能來自三條不同鏈路：PTY 資料傳送、遠端 Mac 的 CPU／磁碟工作，或模型正在等待下一個動作。若你把三者混成「終端變快或變慢」，回退判斷會失準。

先不要在正式工作區直接改依賴。建立一個與目前環境相同的隔離工作區，保留以下資料：

• DeepSeek Harness 原版本與 v0.1.0-rc.7。
• node-pty 實際解析出的版本。
• macOS 版本、CPU 架構、Node.js 版本及套件鎖定檔。
• Bash 啟動參數、工作目錄與必要環境變數。
• 每個命令的開始時間、第一段輸出時間、最後一段輸出時間。
• 取消後的程序狀態，以及重連前後的畫面和日誌。

這裡的重點不是製作漂亮的效能報告，而是確保原版本與 rc.7 執行的是同一件事。若你需要先確認遠端 Mac 的交付條件，再建立測試工作區，可參考 CALMVPS 的遠端 Mac 方案說明，但版本決策仍應以同一組終端任務的實際結果為準。

否則你可能同時改了工作目錄、依賴、Node.js 或命令內容，最後無法判斷差異是否真的來自 node-pty。

第一輪不要從大型建置開始。先用需要明確輸入和明確結束的 Bash 任務，例如讀取一行輸入、連續輸出幾段文字，再回傳退出狀態。

你應記錄四個節點：

1. 輸入送出的時間。
2. 螢幕出現回顯的時間。
3. 中間輸出是否按順序持續出現。
4. 命令結束後，介面是否取得正確狀態。

Bash 的退出狀態不是裝飾資料。一般而言，0 表示成功；命令找不到時可回傳 127，檔案存在但不可執行時可回傳 126；若由訊號終止，Bash 會使用 128 加訊號編號的形式表示。這些規則可參考Bash 官方退出狀態說明。(gnu.org)

因此，介面顯示「完成」並不等於命令成功。你要把畫面訊息、退出狀態與遠端 Mac 的實際程序結果放在一起看。若輸出正常但狀態遺失，問題仍可能在程序事件傳遞，而不只是畫面延遲。

長輸出任務最容易誤判。你看到螢幕暫停，至少有三種可能：

• 遠端命令仍在產生輸出，但資料尚未順利傳到介面。
• 命令本身正在進行編譯、測試或磁碟操作，暫時沒有新輸出。
• DeepSeek Harness 正在等待模型結果，PTY 沒有新的資料可顯示。

所以不要只記錄「花了多久」。更有用的是記錄卡頓發生在哪個階段：第一段輸出前、連續輸出中、建置完成前，還是取消之後。

執行建置或測試時，勾選以下項目：

• [ ] 輸出在中途仍會推進，而非只在最後一次出現。
• [ ] 輸出暫停時，終端仍可接受查詢或取消操作。
• [ ] 取消後，主程序和子程序都能在遠端 Mac 上確認狀態。
• [ ] 重新開啟工作階段後，不把舊輸出誤認成新輸出。
• [ ] 同一任務在原版本與 rc.7 都有保存日誌。

取消行為尤其要小心。node-pty 提供 kill 控制，但「成功送出訊號」不等於「程序已經終止」；Node.js 官方文件也明確區分這兩件事。(nodejs.org) 因此，你需要在取消後再次查詢程序，而不是只看按鈕變成已取消。

如果你的工作流只執行非互動式 Bash，就不必為了測試而羅列所有終端特性。選擇實際會用到的交互程式即可，例如需要輸入確認、讀取控制字元，或依賴終端尺寸的工具。

這一輪至少觀察：

• 啟動後是否取得提示符。
• 輸入方向鍵、退格或取消控制是否有正確反應。
• 調整瀏覽器視窗後，程式排版是否仍可用。
• 正常退出後，PTY 和子程序是否一起收束。
• 非正常退出時，是否留下仍在執行的程序。

node-pty 上游 API 包含尺寸調整與 kill 方法，但 API 存在不等於 DeepSeek Harness 的上層流程已正確串接。(github.com) 失敗時請保留最小重現環境：一個工作目錄、一個命令、一份日誌，以及當時的版本鎖定。不要把整個專案和大量插件一起提交，否則很難定位是交互能力、工作區環境還是模型流程造成問題。

遠端 Mac 的瀏覽器斷線，不代表 PTY 一定停止；反過來，畫面還在，也不代表背景工作仍然存活。這是遠端終端最常見的錯誤判斷。

重連測試可以照以下步驟執行：

1. 啟動一個會持續輸出的 Bash 任務。
2. 在輸出進行中關閉瀏覽器分頁或暫停網路連線。
3. 等待一段足以讓任務狀態產生差異的時間。
4. 重新連線，記錄最後可見輸出與新收到的輸出。
5. 在遠端 Mac 上查詢 Bash、子程式及程序樹。
6. 嘗試輸入查詢或取消，確認控制權是否恢復。

Bash 的工作控制涉及程序群組與訊號。互動式和非互動式 shell 對 SIGINT、SIGHUP 及背景工作處理方式可能不同，不能以「網頁斷線」直接推導程序結果。可參考Bash 官方訊號說明及工作控制說明。(gnu.org)

如果你需要確認遠端工作是否能在斷線後恢復，可先閱讀 DeepSeek Harness 雲端 Mac 交付驗收 所對應的驗收思路，再把本次終端結果加入交付紀錄。進一步整理背景任務的停止、保存與重啟條件時，可採用獨立的工作階段驗收表，將終端結果轉成具體檢查項目。現階段不要把「能重連看到畫面」寫成「任務可恢復」。

多任務測試的第一個目標不是找出最多可以同時跑多少工作，而是確認少量代表性任務之間沒有互相影響。並行數量與資源變化必須來自你的實際環境，不能套用通用門檻。

每個任務使用不同工作目錄和清楚的輸出標記，然後檢查：

• [ ] 任務 A 的輸出沒有出現在任務 B。
• [ ] 取消任務 A 不會停止任務 B。
• [ ] 每個工作階段的當前目錄保持正確。
• [ ] 一個任務失敗時，其他任務仍能回報自己的結束狀態。
• [ ] 重新連線後，工作階段識別仍然一致。

如果只在單一任務下通過，而多任務時出現輸出串線、錯誤取消或工作區混用，就不應把 rc.7 當成可全面推廣版本。這類問題通常已超出單純 Bash 命令是否成功的範圍，必須連同工作階段管理與程序隔離一起追查。

node-pty 升級能解決 Bash 卡頓嗎？

不一定。node-pty 變更只代表終端依賴更新，實際卡頓仍可能來自長輸出、建置工作、模型等待或遠端連線。你應先比較輸出是否持續、輸入是否可用，以及取消後程序是否真的結束，再判斷問題是否改善。

DeepSeek Harness 遠端終端需要重新配置嗎？

不要先全面重設。保留原有 Bash、工作目錄與環境變數，在隔離工作區安裝 rc.7，對照同一組任務。只有在啟動失敗、權限錯誤或依賴解析異常時，才針對版本鎖定和工作階段設定修改。

升級 rc.7 後哪些命令任務要回歸？

優先回歸互動 Bash、長輸出建置、可取消的長時間任務，以及你實際依賴的交互程式。每類任務都要保存輸入、輸出、結束狀態與程序結果。一次短命令成功，不能代表長任務穩定。

遠端 Mac 終端斷線是否會影響任務？

可能影響，也可能不影響。斷線只表示介面或網路路徑中斷，不能直接推導 PTY 或子程序狀態。你必須在重連後檢查輸出、控制權及遠端程序，並把可恢復性和單純重新顯示畫面分開記錄。

完成前述測試後，把結果分成三類：

繼續試點：互動輸入輸出閉環正常，長輸出能持續推進，取消後程序確實結束，重連後狀態可確認，而且沒有任務互相干擾。

限制使用：一般 Bash 可用，但交互程式、長輸出或斷線恢復仍有不穩定。此時只讓 rc.7 處理可觀察、可重新執行的任務，不要承接不可中斷的長時間工作。

回退：出現程序殘留、輸出串線、工作區錯置、取消失效，或原版本能穩定重現而 rc.7 明顯退化。回退時要鎖定原版本、保存日誌，並把失敗任務縮減成最小重現案例。

候選版本仍可能出現相容性變化。即使 node-pty 上游已經有修正或 beta 發布，也不能只因底層依賴更新便調整採購、全面擴容或改變正式交付標準。上游 Release 頁面可用來核對目前的 beta 變更紀錄，但不能代替你在目標 macOS、Node.js 和工作流上的回歸測試。(github.com)

如果你目前使用的是本地 Mac，第一輪測試仍應在實際工作的環境完成；如果是遠端 Mac，則要把連線中斷、重連、工作階段保存和程序查詢納入同一份驗收表。長期穩定重負載、需要實體介面或要求固定硬體狀態的工作，仍應如實評估自購 Mac 或固定部署方案。遠端環境若只依賴瀏覽器畫面，會多出斷線後狀態不明、程序清理不完整及輸出保存不足等風險；若選擇租用 CALMVPS 的 Mac，則應把這些驗收項目寫入交付檢查，而不是只確認能否開啟終端。

你可以把第一輪結果收斂成這份清單：

• [ ] 已記錄原版本、rc.7、node-pty、macOS 與 Node.js 版本。
• [ ] 已完成互動 Bash 的輸入、回顯、連續輸出及結束狀態測試。
• [ ] 已完成長輸出或建置任務，並標記卡頓位置。
• [ ] 已驗證取消後 Bash 與子程序的實際狀態。
• [ ] 已完成斷線、重連與控制權恢復測試。
• [ ] 已測試一項真正需要的交互程式。
• [ ] 已完成少量多任務隔離測試。
• [ ] 已用同一任務形成繼續、限制或回退結論。

在這份清單完成前，DeepSeek Harness node-pty 升級只能視為值得驗證的候選變更，不是已經證明穩定的遠端 Mac 解決方案。