前言¶
DSH 的插件生態可以把控制檯界面和常用操作做成可插拔模塊。對日常使用 DeepSeek Harness Web GUI 的人來說，常見問題是：餘額狀態不夠直觀、文檔路徑需要手動貼入輸入框、插件開關缺少二次確認。
Sidor_UI 是 AKI2253 維護的 DeepSeek Harness Web GUI 主題皮膚倉庫。它提供 SIDOR 星野主題、餘額提示、文檔路徑附加、插件管理按鈕，以及附屬插件擴展位。
這是什麼¶
Sidor_UI 的定位是：DeepSeek Harness Web GUI 的 SIDOR 星野主題皮膚，以獨立倉庫分發。
它主要解決幾件事：
- 給 Web GUI 增加星野主題與開屏動畫。
- 把餘額徽章、低餘額警告放進界面。
- 在輸入框附近提供「文檔」路徑附加，供 agent 工具讀取。
- 在設置頁插件列表中注入關閉、啓用、卸載按鈕。
- 爲附屬插件提供設置頁和側邊欄擴展位。
本倉庫整體以 MIT 發佈。SIDOR 品牌標識歸本項目所有。署名與使用邊界見各皮膚 NOTICE / LICENSE。
核心功能¶
主題與狀態提示¶
Sidor_UI 包含以下界面能力：
- 開屏粒子動畫（1/50 紅色太陽風暴彩蛋）
- 常駐星野
- 餘額徽章
- 設置頁流光特效
- 低餘額四重紅色警告
這些能力主要服務於 Web GUI 的狀態展示，讓餘額和皮膚效果更直觀。
文檔路徑附加¶
Sidor_UI 提供輸入框文檔路徑附加能力。
使用方式是：
- 點擊「文檔」按鈕。
- 選擇或輸入文件、文件夾路徑。
- 將路徑貼入輸入框。
- 由 agent 工具直接讀取。
靜態插件形態下，文件落盤到工作區不是主要方式，因此路徑選擇是主要方式。動態插件形態額外保留上傳到工作區 .sidor-uploads/ 的能力，文件落盤後可貼相對路徑。
插件管理按鈕¶
在官方「設置 → 插件」列表中，Sidor_UI 會爲插件卡片注入「關閉 / 啓用 / 卸載」按鈕。
流程是：
- 進入設置頁的插件列表。
- 點擊插件卡片上的「關閉 / 啓用 / 卸載」按鈕。
- 彈出二次確認菜單。
- 確認後由當前會話 agent 執行。
確認後的操作可能包括修改 cordis.patch.yml 或刪除包。需要權限時，DSH 會彈出授權。完成後重啓 DSH 生效。
動態插件能力¶
Sidor_UI 的全功能形態使用動態插件。
關鍵標識和文件如下：
pluginId：sidf-4- Client 代碼：
src/sidor-fx-client.js - Host 代碼：
src/sidor-fx-host.js
動態插件支持 host curl 查詢和文件落盤，並額外保留上傳到工作區 .sidor-uploads/ 的能力。
需要注意：動態插件進程重啓後，需要在 Cordis 面板重新運行。
附屬插件擴展位¶
Sidor_UI 按可擴展平臺設計。
它提供以下擴展能力：
- 官方插槽的
list型插槽支持多插件共存。 - 附屬插件可接入設置頁
settings.section。 - 附屬插件可接入側邊欄
sidebar.footer.action。 - 附屬插件可複用餘額數據。
目前資料中給出的附屬插件是 Sidor_box，包名爲 sidor-box，用於設置頁「工具箱」分區，當前狀態是選頁先行，功能待填入。
安裝與啓用¶
懶人版¶
把 DSH 打開後，可以直接讓助手執行安裝。
將下面內容發送給 DSH 助手：
安裝一下這個皮膚包：https://github.com/AKI2253/Sidor_UI
說明：DSH 助手會 git clone / 讀取該倉庫並自動完成安裝。倉庫自帶 sidor-install 技能，會自動詢問確認、交代許可後再安裝。
本地版（PowerShell，無需 GitHub）¶
如果你已經在本地拿到倉庫，可以用 PowerShell 腳本安裝或卸載。
先切到倉庫目錄：
cd <Sidor_UI 倉庫路徑>
安裝：
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1
卸載：
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1 -Remove
命令版（需 pnpm）¶
命令版需要提前具備 pnpm。
先切到 Harness 目錄：
cd <harness 目錄>
再添加插件：
dsh plugin --profile web add <Sidor_UI 倉庫路徑>
全功能版（動態插件）¶
全功能版對應動態插件形態。
關鍵項是：
pluginId: sidf-4
Client: src/sidor-fx-client.js
Host: src/sidor-fx-host.js
它支持 host curl 查詢和文件落盤，並額外保留上傳到工作區 .sidor-uploads/ 的能力。
進程重啓後，需要在 Cordis 面板重新運行。
典型用法¶
使用「文檔」按鈕¶
「文檔」按鈕用於把文件或文件夾路徑加入輸入框。
使用步驟：
- 點擊「文檔」按鈕。
- 選擇文件或文件夾，或直接輸入路徑。
- 將路徑貼入輸入框。
- 由 agent 工具直接讀取。
靜態插件形態下，路徑選擇是主要方式。動態插件形態額外保留上傳到工作區 .sidor-uploads/ 的方式，文件落盤後可貼相對路徑。
管理插件¶
進入 DSH 設置頁的插件列表後，可以在插件卡片上執行：
- 關閉
- 啓用
- 卸載
點擊後會彈出二次確認。確認後，操作指令會發送給當前會話 agent 執行，例如修改 cordis.patch.yml 或刪除包。需要權限時，DSH 會彈出授權。完成後重啓 DSH 生效。
接入附屬插件¶
附屬插件可以基於 Sidor_UI 的擴展位接入。
已給出的示例是：
- 插件：
Sidor_box - 包名：
sidor-box - 位置：設置頁「工具箱」分區
- 當前狀態：選頁先行，功能待填入
附屬插件可接入 settings.section、sidebar.footer.action，並複用餘額數據。
適用場景與注意¶
適合以下使用方式：
- 想讓 DeepSeek Harness Web GUI 使用 SIDOR 星野主題。
- 想在界面上看到餘額徽章和低餘額警告。
- 想讓 agent 讀取輸入框中附加的文檔路徑。
- 想在設置頁插件列表中直接關閉、啓用或卸載插件。
- 想爲後續附屬插件保留設置頁和側邊欄擴展位。
使用前注意：
- 命令版需要
pnpm。 - 靜態插件形態無法把文件落盤到工作區，文檔路徑附加主要通過路徑選擇完成。
- 動態插件進程重啓後，需要在 Cordis 面板重新運行。
- 該皮膚會隨當前 DSH 進程權限運行；需要權限時，DSH 會彈出授權。
- 安裝前應檢查倉庫源碼與許可證。
- 完成後通常需要重啓 DSH 生效。
結尾¶
Sidor_UI 的價值在於把主題、餘額提示、文檔路徑、插件管理和附屬插件位放在同一個 Web GUI 皮膚倉庫裏，適合作爲 DSH 控制檯的可擴展皮膚使用。
GitHub 倉庫：
https://github.com/AKI2253/Sidor_UI
插件線索中的目錄頁：
https://www.skillhub.cn/plugins/AKI2253/Sidor_UI
