DeepSeek Harness 的 Web GUI 默認側邊欄包含了全局面板(如 Pull requests、Scheduled、Plugins)以及新建會話按鈕。對於習慣 Codex 風格界面或追求極簡的開發者來說,這些元素可能會顯得冗餘。
dsh-plugin-codex-ui 是一個 Web GUI 側邊欄皮膚插件。它將默認的瀏覽區域替換爲 Projects 和 Recents 兩個可摺疊區域,並將新建會話的操作簡化爲無需選擇項目即可啓動的“新對話”行。同時,該插件隱藏了全局面板行,並調整了側邊欄的內邊距。
核心功能¶
- 品牌名稱替換:將側邊欄頂部的品牌名稱替換爲“DeepSeek Harness”。
- 側邊欄重構:用 Projects(項目)和 Recents(最近)瀏覽器替代原有的瀏覽區域。
- 隱藏全局面板:隱藏 Pull requests、Scheduled、Plugins 等全局面板行。
- 新建會話優化:隱藏默認的新建會話按鈕,替換爲“新對話”行。點擊該行可直接創建會話,系統會自動分配工作目錄,無需預先選擇項目。
- 佈局微調:將側邊欄內邊距(
--dsh-sidebar-inline-padding)從 12px 調整爲 10px。 - 交互優化:項目行點擊可摺疊/展開該項目的聊天記錄;最近會話支持懸停查看存檔操作。
安裝與啓用¶
該插件依賴 DeepSeek Harness 的 web profile,並且環境需要安裝 Node.js 20 或更高版本,同時 pnpm 需要在 PATH 中可用。
- 執行以下命令安裝插件:
dsh plugin --profile web add github:ice-ai-lab/dsh-plugin-codex-ui
- 安裝完成後,必須重啓
dsh web進程以加載客戶端組件。僅刷新頁面無法生效。
典型用法¶
無項目啓動會話¶
安裝並重啓後,側邊欄會出現“新對話”行。點擊該行會創建一個會話,系統會自動分配一個全新的工作目錄,並將其註冊爲 Workspace。該會話屬於“無項目”會話,會自動歸類到 Recents 區域。
管理項目¶
側邊欄底部的“項目”區域列出了已註冊的工作目錄。點擊項目行可以摺疊或展開該項目的聊天列表。在項目行上點擊“+”按鈕可以在該項目內新建聊天。
管理最近會話¶
“最近”區域僅顯示屬於無項目會話的聊天記錄。將鼠標懸停在最近會話行上,點擊右側出現的垃圾桶圖標即可存檔該會話。
注意事項¶
- 環境依賴:安裝前請確保 Node.js 版本 >= 20,且系統中已配置
pnpm。 - 存檔不可逆:最近會話的存檔操作是不可逆的,存檔後聊天記錄將從列表中消失,但日誌文件仍保留在磁盤上。
- 目錄位置:無項目會話和最近會話的工作目錄位於
$DSH_HOME/codex-workspaces/(默認~/.dsh/codex-workspaces/)。
總結¶
dsh-plugin-codex-ui 適合希望將 DeepSeek Harness Web 界面調整爲 Codex 風格,並簡化項目管理流程的用戶。它通過移除默認的全局面板行和簡化新建會話流程,提供了一個更聚焦於聊天記錄和項目管理的側邊欄視圖。