前言¶
在 Orca 1.4.220 版本中，DSH（DeepSeek Harness）能夠完成請求，但 Orca 仍可能在等待 tui-idle 狀態。這是因爲 DSH 的 Claude 兼容鉤子報告的是 HTTP 事件，而 Orca 的就緒檢查期望的是終端狀態。這種差異會導致狀態不同步。
dsh-orca-terminal-status 是一個非官方的獨立插件，它直接監聽 DSH 的生命週期事件，將真實的 DSH TUI 狀態（就緒、工作中、完成）寫入 Orca 現有的終端通路，使 Orca 能正確識別 DSH worker 的完成狀態。
核心功能¶
該插件專注於解決狀態同步問題，核心能力包括：
- 監聽並寫入狀態：監聽 DSH TUI 的實際狀態，並將就緒、工作和完成狀態寫入 Orca 的 PTY（終端通路）。
- 準確的完成判定：不將 HTTP
Stop翻譯爲完成狀態，而是等待 TUI 的實際子運行時激活、單個根代理空閒且收件箱爲空時才報告完成。 - 過濾干擾項：忽略子代理、模糊的多根代理、非 TTY SDK 輸出以及沒有 Orca 面板環境的終端。
安裝與使用¶
安裝前需確保環境滿足要求：Node.js 版本需爲 ^22.19.0 || >=24，且已配置好現有的 DSH TUI 配置文件。
- 安裝插件
使用 DSH 的包管理 CLI 安裝發佈的 Tgz 包。請將dsh-tui替換爲你實際使用的 profile 名稱。
dsh plugin --profile dsh-tui add https://github.com/Alex-wangyang/dsh-orca-terminal-status/releases/download/v0.1.0/dsh-orca-terminal-status-0.1.0.tgz
-
驗證與運行
安裝完成後重啓 DSH，在 Orca 中啓動。確認插件行已正確組合，且原生tui-idle就緒檢查通過。隨後運行一個無害任務，驗證任務在真正完成時 Orca 能正確識別。若需移除插件：
dsh plugin --profile dsh-tui remove dsh-orca-terminal-status
適用場景與注意事項¶
該插件依賴 DSH TUI 的內部實現（如 internal/status、fiber 狀態、dsh-tui-runtime），因此僅保證在特定版本組合下的兼容性。
- 環境依賴：需要匹配的前端/服務所有權。插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
- 兼容性：已驗證的版本組合包括 Orca 1.4.220、DSH 0.2.0-rc.2、TUI 0.13.0。未驗證與 Windows、Linux、SSH 或多根前端路由的兼容性。
- 安裝限制：安裝後會影響該 profile 下的所有會話。請勿與手動插入的副本組合，也不要與已經內置此功能的 Orca 版本組合安裝。
總結¶
dsh-orca-terminal-status 通過監聽 DSH 的真實 TUI 生命週期，填補了 Orca 在新版本中對終端狀態檢查的期望與 DSH HTTP 事件機制之間的鴻溝。對於需要在 Orca 1.4.220+ 環境下使用 DSH 的開發者，這是一個必要的同步工具。
- GitHub 倉庫: alex-wangyang/dsh-orca-terminal-status
