前言¶
在 DeepSeek Harness（DSH）NEXT 上，模型連接、網絡權限和對話歸檔分散在宿主自帶界面裏；若還想換壁紙、磨砂面板、桌寵或啓動動畫，往往要另找方案或改零散配置。Beelli X UI（倉庫 beellix-dev/beellix-dsh-ui，npm 包名 @beellix-ai/dsh-web-gui）通過原生 Bundle 替換設置頁與側欄入口，把上述能力收進同一套可搜索的設置結構，並在本插件命名空間裏保管皮膚、寵物與動效相關配置。
這是什麼¶
Beelli X UI 面向 Windows 上的 DSH NEXT，由維護者 Beellix-dev 發佈，當前資料記載版本 0.1.1，許可證 MIT。它不負責替代宿主的模型請求與計費邏輯，而是通過公開服務接口讀寫 DSH 原有的模型、網絡、權限等設置；外觀類能力（主題、皮膚、字體、吉祥物、啓動效果）使用插件自有配置，媒體文件落在所屬 DSH 環境的 DSHWebGui/ui/media 路徑下。
社區目錄將其歸類爲「趣味換裝」；GitHub 公開星標數爲 1（以目錄頁與倉庫頁面爲準）。
設置界面怎麼組織¶
安裝並啓用後，左欄選分類，頂部標籤在同一大類下切換子頁。窗口較窄時可用下拉選擇分類。「查找設置」支持按分類、子頁或設置項名稱定位。
| 左欄入口 | 右側內容 |
|---|---|
| 常規 | 常規、對話與輸入、快捷鍵、通知 |
| 外觀 | 主題、皮膚、字體、吉祥物、效果 |
| 模型 | 已添加連接、廠商預設或自定義連接；其他插件提供的模型配置會出現在「插件模型」標籤 |
| 網絡、權限、數據 | 進入對應 DSH 設置 |
| 維護 | 診斷與維護、運行環境、關於與更新 |
| 插件配置 | 已加載插件配置及插件提供的設置入口 |
| 已歸檔的聊天 | 按原工作區查看歸檔，支持搜索、恢復和刪除 |
同一頁還可切換、添加插件市場目錄；已安裝的官方與第三方插件分開展示，側欄控件可按需顯隱和排序。
核心功能¶
皮膚¶
路徑：設置 → 外觀 → 皮膚。可預覽內置插畫，或將圖片、MP4 導入「我的皮膚」。在壁紙設置中勾選覆蓋左側欄、聊天區、右側工作臺中的哪些區域；在「主題」中調整配色、磨砂與透明度，並將搭配保存爲皮膚方案。皮膚採用共享背景與獨立面板，支持靜態圖、MP4 與 CSS 磨砂；資料記載三款內置插畫原生尺寸爲 1672×941。本插件不提供 Wallpaper Engine Scene/Web 渲染引擎。
桌寵（吉祥物）¶
路徑：設置 → 外觀 → 吉祥物。上傳動態 WebP（100 MB 以內）或 GIF（20 MB 以內）即可添加寵物，該動圖爲默認動作。可保留多隻、選擇一隻顯示，併爲每隻添加額外動作。右鍵桌寵可選動作，播放一輪非默認動作後會回到默認循環。
啓動效果¶
路徑：設置 → 外觀 → 效果。可啓用內置啓動動畫，或上傳 MP4、GIF。時長可選 1、2、3 或 5 秒；設置內可預覽，啓用後於下次啓動播放，播放過程中可跳過。
模型連接¶
路徑：設置 → 模型。可選用 DeepSeek、OpenAI、Anthropic 等廠商預設，或填寫自定義服務地址與接口協議。配置後可從服務拉取型號並勾選，亦可手動填寫模型 ID。模型目錄來自實際服務接口；連接是否可用取決於廠商地址、憑據與模型權限，請求與費用由所選廠商處理。
歸檔聊天¶
在「已歸檔的聊天」中按原工作區分組瀏覽與搜索；取消歸檔會恢復到原工作區。確認刪除會清理本地聊天記錄（日誌、歸檔標記、工作區關聯及對應緩存），支持單條與批量刪除。資料記載該刪除流程已在 Windows DSH NEXT 默認 desktop Profile 與標準本地會話存儲上驗證；工作區目錄內的項目文件刪除後仍保留。其他組件持有寫入鎖時，對應對話會保留並提示原因。
安裝與啓用¶
本插件以 DSH 進程權限運行，安裝前建議閱讀倉庫源碼與 MIT 許可證。官方 README 給出兩種方式，勿使用未在文檔中出現的 dsh plugin add github:... 拼接命令。
預構建包：從 GitHub Release v0.1.1 下載 beellix-dsh-ui-0.1.1.tgz，在 DSH 的「插件 → 添加插件」中導入。
npm：在 DSH「添加插件」中輸入：
@beellix-ai/dsh-web-gui
若鏡像源找不到包，在安裝源中改用 npm 官方註冊表 https://registry.npmjs.org/，或改用上述預構建包。
宿主提示重啓時，先保存當前工作再正常重啓。資料建議同一時間只啓用一個接管設置頁或側欄的界面插件，以免入口衝突。
兼容與邊界¶
實機驗收基線爲 Next 2.0.21-next、Harness / frontend 0.2.1-rc.4、Windows。package.json 聲明 engines.dsh 爲 >=0.2.1-rc.4 <0.3.0，該範圍不表示每個中間版本或其他操作系統均完成驗收。
配置使用獨立命名空間 dsh-web-gui；停用或卸載後宿主恢復原生入口，用戶媒體與設置保留，DSH 會話、工作區文件與模型憑據仍由宿主管理。需要清除導入媒體時，請在卸載前從素材庫移除。加載異常時，可從宿主恢復頁面停用本包後重啓。
環境模塊最多顯示三個已註冊項；資料記載當前內置真實環境模塊僅爲工作區，環境貢獻接口只轉交呈現與新會話操作，不提供環境後端或數據隔離。
典型操作路徑¶
下面按 README 中的演示路徑歸納，便於在已安裝插件後復現。
- 換膚：設置 → 外觀 → 皮膚 → 選內置或導入素材 → 外觀 → 主題 調磨砂與配色 → 保存方案。
- 加桌寵：設置 → 外觀 → 吉祥物 → 上傳 WebP/GIF → 選擇顯示中的一隻 → 右鍵桌寵切換動作。
- 啓動動畫：設置 → 外觀 → 效果 → 選時長並預覽 → 啓用 → 下次啓動生效。
- 接模型：設置 → 模型 → 選預設或自定義 endpoint → 拉取或手填模型 ID。
- 管歸檔：設置 → 已歸檔的聊天 → 按工作區搜索 → 恢復或批量刪除（刪除不可從插件側恢復會話數據）。
適用場景與注意¶
適合在 Windows 上長期使用 DSH NEXT、希望設置集中檢索，並需要壁紙、磨砂、桌寵、啓動動效與模型頁同一入口的用戶。不適合依賴 Wallpaper Engine 場景渲染、或非 Windows 且未自行驗收 engines.dsh 範圍的環境。
插件安裝與卸載由 DSH 管理；不會對 Beellix 企業目錄做自動遷移。壁紙文字採樣不能保證任意複雜圖像上所有文字均清晰可讀。
