前言¶
在 DeepSeek Harness(DSH)網頁端做智能體開發時,經常需要在一側查看項目文件、引用文件內容、切換界面風格,同時關注當前工作區的 Git 變更和賬戶餘額。如果只是逐項手動處理,容易打斷開發節奏。
dsh-oh-my-theme 是一個爲 DSH 網頁端定製的第三方插件,把主題皮膚、文件瀏覽、@ 引用文件、Git 只讀視圖和 DeepSeek 即時餘額展示放在同一個插件裏。下面介紹它的定位、功能、安裝命令和常見用法。
這是什麼¶
dsh-oh-my-theme 是 DSH 插件,包名爲 dsh-oh-my-theme,由 zhxqc 維護,許可證爲 MIT。
它解決的問題可以概括爲:
- 爲 DSH 網頁端提供主題皮膚和全局文字顯示設置。
- 在輸入框中通過
@引用當前項目文件。 - 在右側提供文件面板,支持文件樹、文件預覽和分欄佈局。
- 提供只讀 Git 視圖,查看更改、提交時間線與 Diff。
- 展示 DeepSeek 即時餘額詳情。
GitHub 倉庫地址:
https://github.com/zhxqc/dsh-oh-my-theme
核心功能¶
主題皮膚與文字顯示¶
插件內置 aurora、coffee、matrix 三套皮膚,並支持默認跟隨內置外觀。切換皮膚時支持懸停即時預覽。
全局文字顯示可以分別調整對話流、文件樹、文件預覽的字號和字體。偏好保存在當前瀏覽器 localStorage,不會影響會話數據。
@ 引用文件¶
在輸入框中輸入 @ 後,可以搜索當前項目文件,並插入 @路徑 引用。這樣可以把具體文件路徑直接帶入輸入框,避免讓 AI 在大範圍項目中盲目搜索。
點擊輸入框中的引用文本,可以打開右側文件預覽。
右側文件面板¶
插件提供 Codex 風格的項目文件樹、文件預覽與分欄佈局。可以連續打開多個文件,形成多文件預覽標籤,並在標籤之間切換或關閉。
快速打開文件支持兩種方式:
- 在文件面板中進行搜索。
- 按
Ctrl/Cmd + P。
文件預覽會讀取文本內容。對未知 UTF-8 文本會回退爲純文本展示,並受 512KB 上限限制;二進制文件拒絕讀取。
Git 只讀視圖¶
Git 功能只讀,用於查看當前工作區的更改、提交時間線和 Diff。
宿主端只開放固定的只讀命令:
git status
git diff
git log
git show
路徑限制在當前會話工作區。對 commit hash 做格式校驗,命令有超時和輸出上限。
DeepSeek 即時餘額¶
插件可以查看 DeepSeek 即時餘額詳情,包括 CNY/USD 餘額。
餘額相關展示不進入客戶端或日誌,默認不輪詢,避免後臺頻繁請求。
安裝與啓用¶
本插件按 DSH 插件方式安裝到 web profile。
安裝命令:
dsh plugin --profile web add dsh-oh-my-theme
安裝後啓動 DSH 網頁端:
dsh web
環境信息中給出了 Node 要求:
Node: ^22.19.0 || >=24.0.0
packageManager: pnpm@11.7.0
該插件無構建步驟,宿主半與瀏覽器半都是手寫文件、原樣下發。
典型用法¶
調整主題和文字¶
打開:
設置 → 通用設置 → Oh My Theme
在這裏切換配色,並調整對話流、文件樹、文件預覽的字號和字體。修改後保存在當前瀏覽器。
使用 @ 引用文件¶
在輸入框中輸入:
@
然後繼續輸入文件名或路徑片段,搜索當前項目文件。選中文件後,會插入類似:
@路徑
點擊輸入框中的引用文本,打開右側文件預覽。
打開右側文件面板¶
點擊 Session log 左側的右欄按鈕,打開文件面板。
可以在面板中切換:
僅項目文件 / 分欄 / 僅文件預覽
也可以按:
Ctrl/Cmd + P
快速打開文件。
查看 Git 更改和提交¶
打開右側工作臺後,切換到 Git。
再選擇:
更改
或:
提交
查看當前工作區的 Git 狀態、提交時間線和 Diff。
查看 DeepSeek 即時餘額¶
在餘額入口查看 CNY/USD 餘額詳情。該功能默認不輪詢,按需刷新。
適用場景與注意¶
適合這些場景:
- 在 DSH 網頁端中希望統一調整主題和文字顯示。
- 需要在輸入框中快速引用當前項目文件。
- 需要右側文件樹、文件預覽和分欄佈局。
- 需要只讀查看當前工作區的 Git 更改、提交和 Diff。
- 需要查看 DeepSeek 即時餘額詳情。
使用前注意:
- 插件以當前
dsh進程權限運行,安裝前應檢查源碼與許可證。 - 該插件許可證爲 MIT。
- 皮膚、字號、字體等偏好保存在當前瀏覽器
localStorage,不影響會話數據。 - Git 功能只讀,只開放固定
git status/diff/log/show命令,路徑限制在當前會話工作區。 - 餘額展示不進入客戶端或日誌,默認不輪詢。
- 文本預覽有
512KB上限,二進制文件拒絕讀取。
卸載命令:
dsh plugin --profile web remove dsh-oh-my-theme
小結¶
dsh-oh-my-theme 把 DSH 網頁端常用的主題設置、文件瀏覽、@ 引用、Git 只讀視圖和餘額展示整合到一個插件中,適合作爲 DSH 社區插件生態中開發工作臺的一部分。
GitHub 倉庫:
https://github.com/zhxqc/dsh-oh-my-theme
如需在 DSH 社區目錄中查找,可以搜索包名:
dsh-oh-my-theme