前言¶
在使用 DeepSeek Harness Web 進行開發或調試時，如果需要維持長期運行的終端會話，直接切換原生窗口會打斷上下文，且在瀏覽器中運行終端通常涉及 PTY 或原生節點模塊，部署複雜。dsh-tmux-cc 提供了一個持久化的控制模式駕駛艙，允許在不中斷 tmux 進程的情況下管理會話。
插件介紹¶
dsh-tmux-cc 是 DeepSeek Harness Web 的一個客戶端插件。由 adrianleb 維護。它通過 xterm.js 渲染原生 tmux 窗格，並保持停靠欄在切換聊天時可見，提供了會話管理、客戶端分離和移動端適配等能力。
核心能力¶
- 跨聊天持久化：停靠欄屬於 DSH Web shell，而非特定對話。
- 原生 tmux 窗格：窗格佈局、窗口標籤、聚焦、縮放、分割和調整大小與 tmux 保持同步。
- 非破壞性調整大小：鏡像模式下使用
ignore-size，接管模式下提供清晰的 1:1 網格。 - 安全輸入傳輸：輸入通過十六進制編碼的
send-keys -H逐字節轉發，包括 Enter、粘貼和 Unicode 字符。 - 會話與客戶端管理：支持創建、重命名或附加會話，查看並安全分離原生客戶端（不停止進程）。
- 忠實移動駕駛艙：在移動端（寬度 < 768px），停靠欄變爲全屏抽屜，保留真實的 tmux 窗格網格和原生窗格縮放，支持觸摸平移。
- 雙語 UI：界面語言跟隨 DSH 的區域設置。
- 無原生依賴：控制通道使用標準的 stdin/stdout 管道。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add github:adrianleb/dsh-tmux-cc
安裝完成後，重啓現有的 dsh web 進程，並刷新 Web GUI。界面右下角會出現一個 tmux 按鈕，通過設置中的 tmux 選項也可以打開停靠欄。
基本用法¶
- 打開 tmux 停靠欄。
- 從下拉菜單中選擇一個活動的 tmux 會話。
- 點擊窗格以聚焦它並正常輸入。
- 在窗格聚焦狀態下，使用鍵盤快捷鍵（見下文）。
- 拖拽窗格標題到另一個窗格上以交換位置（桌面或移動端）。拖拽窗格之間的分隔線以調整大小。
注意事項與依賴¶
- 系統要求：需要在 DSH 所在的主機上安裝 tmux（支持 3.4 和 3.7b）。需要在同一主機上安裝 Node.js 22 或更高版本。
- 權限與模式：插件以當前 DSH 進程的權限運行。它不運行瀏覽器內終端，不依賴 PTY 或原生 Node.js 插件，僅作爲 tmux 的另一個視圖。
- 會話限制：插件拒絕殺死會話中的最後一個窗格。
- 構建依賴：如需從源碼構建，需要本地安裝 pnpm（建議使用 Corepack）。
總結¶
dsh-tmux-cc 解決了在瀏覽器環境中管理長期 tmux 會話的痛點，通過原生同步和持久化停靠欄，爲開發者提供了一個穩定、安全的控制台。
