DeepSeek Harness Web Client 默認界面功能有限,無法直接在瀏覽器中執行 Git 操作、運行終端或管理後臺任務。navid-kianfar/dsh-advanced-sidebar 通過一個可調整大小的側邊停靠欄和會話菜單,將這些能力補齊。它利用主機進程運行瀏覽器無法執行的操作,並提供了文件瀏覽、開發服務器預覽等實用功能。
會話菜單¶
在任意會話的頭部,點擊 ⋯ 按鈕。該菜單基於當前會話的工作目錄或工作區路徑進行操作。
- 面板操作:打開變更、終端、文件、預覽或後臺任務面板。再次點擊已打開的條目可關閉停靠欄。
- Open in:在新窗口中打開 Web Client,或通過配置的編輯器打開當前會話,以及通過系統文件管理器(如 Finder、Explorer)打開文件。
- 會話管理:歸檔會話(保留日誌)或刪除會話(需確認)。
- 下載日誌:該插件將原 harness 的「下載會話日誌」按鈕移至了獨立菜單中。
停靠欄¶
面板在應用框架的右側以列形式展開,左側爲可拖拽邊緣。拖拽可調整寬度,最小寬度爲 280px,最大爲 960px。當窗口寬度過窄導致對話區域小於 400px 時,停靠欄會變爲浮動層。
變更¶
該面板展示工作目錄的 Git 狀態,分爲已暫存、未暫存、未跟蹤和衝突組。操作包括:
* 暫存/取消暫存:針對單個文件或整組文件。
* 提交:記錄暫存內容,支持修改上一次提交。
* 生成消息:利用當前 Composer 的模型爲暫存區生成提交信息。
* 推送:推送到上游分支。
注意:當前面板沒有「丟棄更改」的功能,如需丟棄,請使用終端面板。
終端¶
支持在會話工作目錄中運行交互式 Shell,以選項卡形式管理。
* 保持運行:關閉停靠欄或切換面板時,Shell 進程不會終止。
* 控制:支持中斷進程(Ctrl+C)、清屏和重啓 Shell。
* 恢復:重新打開標籤頁會重現主機保留的輸出記錄。
* 限制:關閉標籤頁或歸檔/刪除會話會結束 Shell。
文件¶
提供一個文件瀏覽器,展示當前工作目錄。
* 預覽:支持文本預覽(限制字節數)和二進制文件大小顯示。
* 操作:支持用默認應用打開文件,或在文件管理器中顯示文件。
預覽¶
提供四種模式,每種模式均包含視口選擇器(Desktop, Tablet, Mobile, Custom)。
- Server:基於
.claude/launch.json(Claude Code 格式)或previews設置啓動開發服務器。支持啓動、停止、查看日誌。 - File:展示工作區文件,根據類型渲染(HTML/SVG/Markdown/圖片等)。文件變更時會自動重載。
- URL:加載任意 HTTP/HTTPS 地址。
localhost等地址通過主機代理加載,享有同源權限。 - Scratchpad:在本地存儲中保存的 HTML 代碼,可實時渲染。
後臺任務¶
管理會話的後臺作業列表。
使用示例¶
- 打開面板:在會話頭部點擊 ⋯,選擇「Terminal」或「Changes」以展開停靠欄。
- 配置預覽:在
.claude/launch.json中定義runtimeExecutable和port,然後在預覽面板的 Server 模式下啓動。 - 設備切換:在預覽面板中,使用視口選擇器切換查看設備尺寸。
注意事項¶
- 依賴缺失:如果主機上未安裝 Git 或未找到編輯器命令,對應的菜單項會被禁用。
- Shell 行爲:Shell 進程在 Dock 關閉時仍會運行,需手動關閉標籤頁或歸檔會話來終止。
- 日誌下載:該插件隱藏了原 harness 的日誌下載按鈕,將其集成至自己的菜單中。