前言¶
DeepSeek Harness 的 Web GUI 默認沒有賬號密碼保護。如果需要在多人協作或公開環境下使用 Web 界面，需要自行實現登錄鑑權。WebGate 是一個爲 DeepSeek Harness Web GUI 加一道賬號密碼門的插件，通過路由級登錄門禁保護 Web 界面，確保只有授權用戶才能訪問。
核心功能¶
WebGate 提供以下能力：
* 路由級登錄門禁：每次打開 Web 都需要先登錄，無令牌或過期會自動跳轉到登錄頁。
* 12小時會話令牌：登錄後令牌有效期 12 小時，過期自動登出。
* 後臺任務零打擾：門禁只作用於瀏覽器視圖層，Host 端的後臺任務、會話、子代理照常運行。
* DeepSeek 官網風登錄頁：提供與 DeepSeek 官網風格一致的登錄界面。
* 設置頁圖形化管理：在 DSH 設置的「WebGate 用戶」頁裏增刪用戶、改密碼、分配工作區。
* 內置管理員不可撼動：內置 admin 賬號爲永久管理員，不可刪除。
* 用戶管理命令：提供 /useradd、/passwd 等命令行工具管理用戶。
* 持久化：用戶數據保存在 $DSH_HOME/.credentials.yaml 中，隨 Harness 自身憑據文件一起管理。
* 三語支持：支持中文、English、Русский，跟隨 DSH 語言設置。
* 賬號角色與工作區授權：支持 admin/member 角色，成員僅能看到被授權的工作區。
* 零依賴：純 JavaScript 實現，無外部依賴。
安裝與啓用¶
通過 npm 安裝插件（推薦）：
dsh plugin --profile web add @yyyq0325/dsh-webgate
安裝命令會依據插件的配置自動掛載，重啓 dsh 後生效。
首次激活與基本用法¶
插件安裝並重啓後，首次訪問 Web 界面會自動創建初始管理員賬號。
- 默認賬號：用戶名
admin，密碼admin1234。 - 修改密碼：
/passwd admin 你的新密碼
- 添加用戶：
/useradd <用戶名> <密碼> <管理員密碼>
設置頁管理¶
除了命令行，WebGate 提供了圖形化界面管理用戶。
- 打開左下角 設置。
- 進入 WebGate 用戶 頁面。
- 在此頁面可以：
- 添加用戶：填寫用戶名、密碼，選擇角色（默認成員），保存。
- 管理工作區：勾選成員可見的工作區（或選擇全部）。
- 改密碼 / 刪除用戶：行內操作。
- 注意：內置
admin管理員賬號沒有刪除按鈕，且至少保留一個管理員賬號。
注意事項¶
- 密碼存儲：密碼以哈希形式存儲在
$DSH_HOME/.credentials.yaml的webgate/users段中。 - 動態插件模式：如果使用動態插件模式（不落盤安裝），只包含 Host 半邊，設置頁不可用。只能通過命令行管理。
- 工作區過濾強度：工作區過濾在瀏覽器端執行，定位是”防誤觸”而非對抗有意繞過，服務端仍需自行處理鑑權。
- 角色限制：成員登錄後只能看到被授權的工作區，且會隱藏部分界面操作（如設置入口、創建工作區等）。
總結¶
WebGate 爲 DeepSeek Harness Web GUI 提供了基礎的賬號密碼保護與用戶管理能力，支持命令行與圖形化管理，適合需要在多用戶環境下使用 Harness Web 界面的場景。
