前言¶
DeepSeek Harness (DSH) 是一個面向智能體開發的命令行工具。當你需要將 Web UI 面板暴露給團隊或部署到公網時，通常需要一個前置的登錄層。dsh-ui-auth 插件通過攔截 DSH 的 HTTP 和 WebSocket 通道，將未登錄用戶引導至登錄頁，從而在 DSH 路由分發前建立一道安全門禁。
插件定位¶
這是一個 DSH Web UI 認證網關插件。由 0QwQ0 維護。它提供登錄頁、用戶管理、TOTP/通行密鑰、管理員模型配置以及數據隔離功能。
核心功能¶
- 全接口攔截：覆蓋 HTTP 與 WebSocket，未登錄時阻斷訪問，API 返回 401，頁面重定向至登錄頁。
- 登錄與註冊：中文界面，註冊需要管理員生成的邀請碼。
- 用戶管理：支持改密、TOTP 綁定、通行密鑰管理。
- 權限隔離：普通用戶只能看到自己的會話和工作區，管理員不受限。
- 安全防護：密碼採用 PBKDF2 加密，支持登錄失敗鎖定機制。
安裝與啓用¶
使用標準的 DSH profile bundle 安裝方式：
dsh plugin --profile web add dsh-ui-auth
安裝後需重啓 DSH 面板，網關與設置面板纔會生效。
首次登錄¶
插件首次啓用時會自動創建管理員賬號 admin。隨機密碼會輸出到控制台日誌（以 [dsh-ui-auth] 開頭）以及面板工作目錄下的 dsh-ui-auth-bootstrap.txt。使用該賬號登錄後，請在「設置」→「用戶管理」中立即修改密碼。
使用說明¶
- 註冊：新用戶註冊需要管理員在「用戶管理」中生成的邀請碼。
- 通行密鑰：WebAuthn 通行密鑰功能需要 HTTPS 或 localhost 環境。
- 環境變量：可通過設置
DSH_AUTH_MAX_FAILS來調整單 IP 連續登錄失敗後的鎖定閾值。
兼容性與注意事項¶
- 兼容性：支持 DSH 0.1.1-rc.2 或 0.1.2-rc.1 ~ 0.1.5-rc.1。
- 安全策略：密碼需 ≥8 位且包含兩種字符類型；私鑰不保存在服務器。
- 限制：不能刪除或降級最後一個管理員；私鑰永不離開用戶設備。
背景與生態¶
DSH 理念是「一切皆插件」。該插件是社區維護的項目，與 DeepSeek / 幻方無官方從屬關係。更多細節請查看項目主頁。
