前言¶
DeepSeek Harness Web 是一個智能體開發環境。在開發過程中，開發者通常需要頻繁查看賬戶餘額以控制成本，並管理工作區內的文件。現有的 Web 界面在文件導航和餘額展示上存在操作層級較多的問題。dsh-custom-ui 插件通過擴展 Web 界面，直接在編輯器中提供這些功能，減少跳轉開銷。
插件概述¶
dsh-custom-ui 是一個爲 DeepSeek Harness Web 提供自定義 UI 的插件，由用戶 nailing10086-zx 維護。它主要解決 Web 端缺少文件樹導航和餘額實時監控的問題，通過服務端解析 API 密鑰，確保安全性。
核心功能¶
-
餘額監控
在編輯器的 composer 統計行顯示 DeepSeek 賬戶餘額。API 密鑰僅通過憑證接口（credentialRef，來自@deepseek-ai/dsh-credentials）在服務端解析，不會傳輸到瀏覽器客戶端。 -
文件樹側邊欄
在界面右側提供工作區文件樹，支持摺疊和展開操作。側邊欄可通過浮動按鈕進行顯隱切換，方便快速導航。 -
工作區文件打開
支持通過系統默認應用打開工作區內的文件或文件夾。該功能基於工作區根目錄實現，並通過路徑遍歷檢查進行防護。
安裝與啓用¶
- 安裝插件
通過 DSH CLI 安裝：
dsh plugin --profile web add dsh-custom-ui
-
重啓服務
安裝完成後，必須重啓dsh web才能生效。 -
本地開發鏈接（可選）
若從本地代碼檢出安裝，需在 package.json 中配置"dsh-custom-ui": "link:<path>"或使用pnpm link進行鏈接，然後重新構建。
典型用法¶
插件提供了以下 Host 路由接口：
* GET /api/custom-ui/balance：獲取 DeepSeek 賬戶餘額（需配置憑證）。
* GET /api/custom-ui/fs/list：列出目錄內容（基於工作區根目錄）。
* GET /api/custom-ui/fs/open：打開文件或文件夾。
適用場景與注意事項¶
- 運行環境：需要運行 DeepSeek Harness Web (
dsh web)。 - 憑證配置：餘額監控功能需要配置
DEEPSEEK_API_KEY到 Harness 憑證中；文件樹功能不需要該配置。 - 安全檢查：文件路由基於工作區根目錄，通過
resolve()和前綴檢查防止路徑遍歷。如果未從官方倉庫克隆，建議在安裝前檢查lib/index.js和lib/client.js源碼。 - 許可證：MIT 許可證。
