前言¶

DeepSeek Harness（DSH）支持通過插件擴展 Web 端能力。webkong/dsh-plugin-sidebar 是一個 DSH Web 插件，用來補上左右側欄：左側按工作區瀏覽會話，右側在會話內瀏覽文件、查看 Git 狀態並處理提交。

如果你的 DSH 環境需要在 Web 端管理會話、查看文件、檢查 Git 變更，可以安裝這個插件，按當前 dsh 版本選擇配套插件版本。

這是什麼¶

webkong/dsh-plugin-sidebar 是爲 DeepSeek Harness 而生的左右側欄插件。

維護者爲 webkong，許可證爲 MIT。插件安裝後，DSH Web 界面會增加：

• 左側欄：按工作區瀏覽會話，支持狀態點、分組、搜索、一鍵操作。
• 右側欄：文件瀏覽器、Git 面板、提交歷史、分支切換。
• 主區域文件預覽：基於 CodeMirror 6，支持語法高亮、編輯和保存寫回磁盤。

核心功能¶

左側欄：工作區與會話瀏覽¶

左側欄按工作區瀏覽會話，適合把多個工作區下的會話集中放在一個側欄裏查看。

已覈實的能力包括：

• 按工作區分組瀏覽會話。
• 會話狀態點：用於顯示會話狀態。
• 頂部搜索：本地標題、cwd、工作區匹配，併合並遠端內容搜索。
• 會話卡片操作：重命名、複製 fork、歸檔、移動到文件夾。
• 一鍵操作：減少在會話列表與具體操作之間來回切換的成本。

右側欄：文件瀏覽與 Git 面板¶

右側欄面向會話內工作目錄，提供文件瀏覽和 Git 操作。

文件瀏覽器支持：

• 懶加載目錄樹。
• 按文件名搜索。
• 按文件內容搜索。
• 目錄 Git 狀態聚合徽標。

Git 面板支持：

• 已暫存 / 更改狀態。
• 着色 diff。
• 提交框。
• 分支切換。
• 批量操作：暫存全部、取消暫存全部、放棄全部更改。
• 提交歷史：時間線、提交信息、作者 / 日期、該提交改動文件列表。

文件預覽¶

文件預覽 tab 使用 CodeMirror 6 渲染文本文件，支持：

• 語法高亮。
• 編輯。
• 保存寫回磁盤。

對二進制文件和大文件，插件會給出提示。

語言與主題¶

插件提供全中文界面 + English，並跟隨 DSH 語言偏好自動切換。

插件也會跟隨 DSH 主題進行淺色 / 深色自動適配。

安裝與啓用¶

安裝前建議先確認 dsh 版本，再選擇插件版本：

dsh ≥ 0.1.2：建議插件 0.3.2
dsh 0.1.1-rc.x：可用插件 0.3.0–0.3.2

從 GitHub 安裝指定版本：

dsh plugin --profile web add github:webkong/dsh-plugin-sidebar#v0.3.2

如果需要安裝最新主分支：

dsh plugin --profile web add github:webkong/dsh-plugin-sidebar#main

如果從本地路徑安裝，適合開發調試：

dsh plugin --profile web add /path/to/dsh-plugin-sidebar

注意 pnpm 的 GitHub 版本鎖定語法使用 #tag，因此安裝命令中使用 #v0.3.2，避免使用舊寫法 @0.3.2。

安裝完成後，重啓 dsh web。

啓用後的效果是：

1、左側欄接管 sidebar.workspaces。
2、右側欄接管 details 列。
3、會話頭部出現右欄開關。

後續修改時的生效方式：

• Host 改動：需要重啓 dsh web。
• Client 改動（lib/client.js）：刷新頁面即可。

典型用法¶

下面是一個常見的安裝與啓用流程。

1、確認當前 dsh 版本。

2、按版本兼容選擇插件版本：

dsh plugin --profile web add github:webkong/dsh-plugin-sidebar#v0.3.2

3、重啓 dsh web：

# 按你的 DSH 啓動方式重啓 dsh web

4、打開 DSH Web 界面，左側欄會顯示工作區和會話。

5、在頂部搜索會話，搜索範圍包括本地標題、cwd、工作區，併合並遠端內容搜索。

6、在會話卡片上執行重命名、複製 fork、歸檔、移動到文件夾。

7、在會話頭部打開右欄開關。

8、右側查看文件樹、Git 狀態、diff、提交歷史和分支。

9、點擊文本文件進入文件預覽，使用 CodeMirror 6 查看、編輯並保存寫回磁盤。

適用場景與注意¶

適合以下場景：

• 需要在 DSH Web 端按工作區瀏覽會話。
• 需要在會話內查看文件目錄、搜索文件和預覽文本文件。
• 需要查看 Git 已暫存 / 更改狀態、diff、提交歷史和分支。
• 希望界面跟隨 DSH 語言偏好和主題。

安裝前需要注意：

• 插件以當前 dsh 進程權限運行，會執行文件、Git、會話相關操作，安裝前應檢查源碼與許可證。
• API 路由 /dsp-sidebar/api 僅限本機 loopback，且爲 POST 請求。
• fs.read 讀文本時 512KB 截斷，二進制返回 kind:'binary'。
• 文件預覽對二進制 / 大文件給出提示。
• dsh ≥ 0.1.2 上舊版 client 因等待已移除的 dsh-client-runtime 而無法加載，因此建議按版本兼容表選擇插件版本。

結尾¶

webkong/dsh-plugin-sidebar 把 DSH Web 端的會話瀏覽、文件預覽和 Git 操作集中到左右側欄中，適合需要把 DSH 作爲 Web 端智能體工作臺使用的開發者。

GitHub：https://github.com/webkong/dsh-plugin-sidebar