前言¶
在 DeepSeek Harness 中讓模型完成代碼修改後,常見下一步是執行構建、查看倉庫狀態、運行測試。如果每次都要切到外部終端,流程會被打斷。DSH 可以通過 bundle 插件擴展 Web 界面;dsh-web-terminal 就是由 helays 維護的一個插件,用於在 Web 界面中打開交互式終端。
這是什麼¶
dsh-web-terminal 是 DSH bundle 插件。它會在 DeepSeek Harness Web 界面的「對話 / 軌跡」頂部新增「終端」Tab,並內置 xterm.js + node-pty 交互式終端,用於編碼完成後即時執行指令和調試。
核心功能¶
- 在 Web 界面頂部新增 Terminal Tab,與 Chat、Trajectory 並列。
- 內置 xterm.js + node-pty 交互式 PTY 終端。
- Windows 使用 ConPTY,POSIX 使用交互式 shell。
- 終端進程常駐,可在同一 shell 中連續執行命令。
- 切換會話、返回或刷新頁面後,可自動重連並回放 scrollback。
- 終端完全獨立於模型/Agent,不寫入對話上下文。
- 自動檢測 PowerShell(Windows)和 bash(POSIX),並可通過下拉切換 bash/zsh/pwsh/powershell/cmd/python。
- 支持在同一 Tab 中打開多個終端,各終端擁有獨立進程。
- 可在輸入框使用
/terminal命令直接跳轉到終端。
安裝與啓用¶
該插件要求 DeepSeek Harness 0.1.0-rc.6(next channel)web profile。
安裝命令如下:
dsh plugin --profile web add dsh-web-terminal@github:helays/dsh-web-terminal#main -w
命令中的 -w 是必需的。當前 dsh profile template 是 pnpm workspace root,省略該參數會觸發 ERR_PNPM_ADDING_TO_ROOT。
安裝完成後,重啓 dsh web 並刷新瀏覽器:
dsh web
典型用法¶
1、打開任意會話。進入會話後,頂部會出現 Chat、Trajectory、Terminal 三個 Tab。
2、點擊 Terminal Tab,或在輸入框輸入 /terminal:
/terminal
3、在終端中執行命令,例如:
npm run build
git status
pytest
4、需要切換 shell 時,使用 Terminal Tab 右上角的 Terminal type 下拉菜單選擇類型。
5、切回 Chat 時,終端和會話仍保留;終端進程保持常駐,可繼續執行下一條命令。
適用場景與注意¶
適合在 DeepSeek Harness Web 中完成本地調試:模型改完代碼後,直接在旁邊的終端執行構建、狀態查看或測試。
默認在當前會話的 workspace 目錄打開終端;若該目錄不可用,則回退到 dsh web 啓動目錄。
該終端與內置 ctx.terminals 不同:dsh-web-terminal 通過 node-pty 啓動用戶自有 shell,不進入模型/Agent 的對話上下文。
插件會在本機 dsh 進程環境中運行。安裝第三方 DSH 插件前,建議先檢查源碼和許可證。本插件許可證爲 MIT。
結尾¶
dsh-web-terminal 將交互式終端放進 DeepSeek Harness Web 的對話旁邊,適合編碼完成後立即執行命令和調試。
相關鏈接:
- GitHub 倉庫:https://github.com/helays/dsh-web-terminal
- 插件目錄頁(來自插件線索,使用前可先覈實):https://www.skillhub.cn/plugins/helays/dsh-web-terminal