前言¶
在 dsh web 中使用 DeepSeek Harness 時,開發過程裏可能需要查看當前會話工作目錄中的文件、回到某一條用戶消息或助手回覆,以及確認當前目錄的 git 變更。dsh-side-panel 是 DeepSeek Harness web UI 的右側開發面板,提供 Files、History、VCS 三個標籤,把這幾類信息集中放在聊天界面旁邊。
這是什麼¶
dsh-side-panel 是由 XYZ1024-alt 維護的 DeepSeek Harness 插件,許可證爲 MIT,package.json 版本爲 1.0.0。
它以 DeepSeek Harness bundle 分發。bundle patch 會同時註冊 Node 端和瀏覽器端,因此不需要手動複製文件或 patch rows。倉庫提交的是 ready-to-run JavaScript,安裝過程不會運行構建腳本,也不需要 pnpm build authorization。
核心功能¶
Files¶
Files 標籤用於瀏覽當前會話工作目錄。點擊文本或代碼文件後,會在彈窗中預覽;不支持的格式會顯示提示。
History¶
History 標籤用於列出當前會話的用戶消息和助手回覆。點擊某個條目後,聊天窗口會滾動到對應位置。
VCS¶
VCS 標籤用於顯示當前目錄的 git status,以 M / A / D / U / R 徽章呈現。點擊變更文件可以查看差異。
使用 VCS 標籤要求 git 在 PATH 上。
安裝與啓用¶
安裝前需要滿足以下條件:
- 有帶
webprofile 的 DeepSeek Harness 部署,即dsh web。 - 如需使用
VCS標籤,git在PATH上。
下面從 GitHub 安裝到 web profile:
dsh plugin --profile web add github:XYZ1024-alt/dsh-side-panel
如果需要可復現安裝,可以固定一個 commit:
dsh plugin --profile web add github:XYZ1024-alt/dsh-side-panel#<commit-sha>
安裝後重啓 dsh web,並刷新頁面。面板會出現在右側邊緣。
如果包已發佈到 npm,也可以使用 npm 安裝方式:
dsh plugin --profile web add dsh-side-panel
如果從本地 checkout 安裝,需要先從該倉庫的父目錄執行:
dsh plugin --profile web add ./dsh-side-panel
安裝後可以檢查合成後的 profile:
dsh --profile web --dump-config
輸出應包含 # == dsh-side-panel bundle layer 和 dsh-side-panel plugin row。
如需移除插件:
dsh plugin --profile web remove dsh-side-panel
典型用法¶
1、打開 dsh web 頁面,從右側邊緣打開面板。
2、切換 Files、History、VCS 三個標籤。
3、在 Files 中點擊一個文本或代碼文件,打開預覽彈窗;用 × 按鈕或點擊彈窗外空白處關閉。
4、在 History 中點擊一條用戶消息或助手回覆,聊天窗口會滾動到對應位置。
5、在 VCS 中查看 M / A / D / U / R 徽章,點擊變更文件查看差異。
適用場景與注意¶
dsh-side-panel 適合在本地或迴環網絡中使用 dsh web,並希望在聊天界面旁邊直接查看文件、會話歷史和 git 狀態的人。
需要注意:
/dev-panel/*routes 會讀取文件系統並運行git,但這些路由沒有自身認證或沙箱。- 面板 intended for local/loopback use;
dsh web默認綁定127.0.0.1。 - 不要將
dsh web暴露到不可信網絡。 - 由於插件會讀取文件系統並運行
git,可以把它視作在當前dsh進程權限下執行;安裝前應檢查源碼,並確認MIT許可證符合你的使用場景。