前言¶
DeepSeek Harness（DSH）的插件機制把 Web 端擴展拆成獨立插件，開發者可以在同一個工作界面裏接入已有工具。做智能體或平臺集成時，如果已經使用寶塔面板管理服務器，常見需求是把面板頁面和 Harness 對話放在同一處，並保持相近的視覺風格。
dsh-bt-panel-theme 是一個 DeepSeek Harness Web 插件，提供寶塔風格的淺色/暗色主題，並將寶塔面板原生頁面內嵌到 Harness。下面介紹它的功能、安裝、配置和使用方式。
這是什麼¶
dsh-bt-panel-theme 的倉庫路徑是 aaPanel/btpanel-dsh，許可證爲 MIT。它主要做兩件事：
- 將 Harness Web 界面切換爲寶塔綠色淺色主題或寶塔暗色主題；
- 通過 API 配置驗證和自動登錄，把寶塔面板頁面嵌入 Harness。
啓用後，首頁“預覽版”顯示爲“寶塔版”，左側菜單會出現“寶塔面板”入口。
核心功能¶
- 提供寶塔綠色淺色主題與寶塔暗色主題；
- 首頁“預覽版”顯示爲“寶塔版”；
- 左側菜單增加“寶塔面板”入口；
- 支持 API 配置驗證和自動登錄；
- 內嵌頁面狀態保持；
- 新窗口打開寶塔原地址並繼承登錄態；
- 複用 Harness 當前端口，不新增監聽端口。
環境要求¶
安裝前需要滿足：
- Node.js 20+；
- 使用 DeepSeek Harness Web profile；
- 寶塔面板已啓用 API；
- Harness 服務器 IP 已加入寶塔 API 白名單。
安裝與啓用¶
先克隆倉庫到本地：
git clone https://github.com/aaPanel/btpanel-dsh.git
在包含 btpanel-dsh 目錄的當前路徑下添加 Web 插件：
dsh plugin --profile web add ./btpanel-dsh
啓動 Web 服務：
dsh web
啓動後刷新瀏覽器頁面。
配置¶
打開插件配置入口：
設置 → 插件 → 插件配置 → 寶塔面板
這裏需要填寫寶塔面板地址和 API 密鑰。保存時會驗證面板地址、API 密鑰和 API 白名單。
已保存的 API 密鑰不會回顯；輸入框留空會保留原密鑰。
典型用法¶
- 保存寶塔面板配置；
- 點擊左側“寶塔面板”進入內嵌頁面；
- 點擊會話或“新會話”返回對話頁面。
內嵌頁面狀態保持，再次進入時可保留當前頁面狀態。
適用場景與注意¶
這個插件適合已經在 DeepSeek Harness Web 中使用對話，同時需要頻繁查看寶塔面板的開發者。它把面板入口、主題和登錄態整合到同一個 Web 工作流裏，減少窗口切換。
使用上需要注意：
- 插件不會修改寶塔面板源碼或配置；
- API 密鑰只在 Harness Host 中使用，不會寫入 iframe 地址；
- 內嵌代理使用 Harness 現有 WebServer，不會額外佔用端口。
由於插件以當前 dsh 進程權限運行，安裝前應檢查源碼、依賴與 MIT 許可證。DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，引用時不要將其描述爲官方應用商店。
鏈接¶
GitHub：https://github.com/aaPanel/btpanel-dsh
社區目錄：https://www.skillhub.cn/plugins/aaPanel/btpanel-dsh（目錄線索，以實際收錄狀態爲準）
