前言¶
單用戶 DeepSeek Harness 若直接暴露在瀏覽器或公網,常見缺口是:缺少統一的鎖屏與登錄邊界、重啓或關機只能 SSH 進服務器操作、驗證方式分散在環境變量或反向代理層。下面介紹社區插件 dsh-lifecycle(維護者 floatDreamWithSong,分類 admin-security),在 DSH Web 內提供 Windows 風格鎖屏、密碼 / OTP / Passkey 認證,以及側邊欄電源與「登錄與安全」集中配置。
這是什麼¶
dsh-lifecycle 面向單用戶 DeepSeek Harness,解決鎖屏、登錄驗證和服務電源管理三類問題。插件通過 Cordis patch 注入 Web 客戶端,並依賴獨立電源控制服務完成鎖定、重啓、關機及檢測到新版時的更新並重啓。當前 npm 版本爲 0.1.6,許可證 MIT,源碼倉庫:https://github.com/floatDreamWithSong/dsh-lifecycle。社區目錄頁:https://www.skillhub.cn/plugins/floatDreamWithSong/dsh-lifecycle(獨立站點,與 DeepSeek / 幻方無官方從屬關係)。
核心功能¶
鎖屏與首次引導¶
- Windows 風格鎖屏與首次設置引導,支持自定義壁紙(PNG、JPEG、WebP,單張最多 5 MB,最多 12 張,可恢復內置壁紙)。
- 點擊鎖屏或按 Enter 進入登錄;「鎖定」僅退出當前瀏覽器會話。
認證方式¶
- 支持密碼、OTP、Passkey,可配置單步或兩步驗證;兩步驗證須先驗證密碼,再驗證 OTP / Passkey。
- 已完成的登錄可在服務重啓後保留(默認有效期 30 天);鎖定、改密、變更驗證策略或綁定/移除因素會撤銷相應登錄。
- DSH 內「登錄與安全」頁面分區管理密碼、驗證方式、壁紙和登錄會話。
電源與更新¶
- 側邊欄「電源」菜單:鎖定、重啓、關機,以及檢測到新版時的更新並重啓。
- 「關機」停止 Harness 服務,不會關閉操作系統;之後需在服務器上重新啓動服務。
- 電源操作需安裝倉庫提供的獨立控制服務:Linux 使用 systemd,macOS 使用 launchd,Windows 使用當前用戶任務計劃程序(Windows 爲實驗實現,暫未實機驗證)。
安裝與啓用¶
環境要求:Node.js ≥ 22.18、DSH Web,以及 package.json 中聲明的 dsh ≥ 0.2.0-rc.1。請使用運行 Harness 的賬戶,以及相同的 HOME / DSH_HOME 安裝。
dsh plugin --profile web add dsh-lifecycle
安裝後按倉庫 docs/DEPLOYMENT.md 安裝對應平臺的電源控制服務,再重啓 Harness。公網部署還需配置 HTTPS。源碼構建支持重啓和停止;自動更新適用於 npm 管理的 Harness 安裝。
插件以當前 dsh 進程權限運行,安裝前應閱讀源碼與 MIT 許可證,確認電源腳本與認證邏輯符合你的安全策略。
典型用法¶
- 首次訪問時,從 Harness 服務日誌取得初始密碼,完成改密和驗證方式設置。
- 登錄後,從側邊欄或「電源 → 登錄與安全」進入設置;在「鎖屏壁紙」上傳、選擇或刪除背景。
- 服務停止後,在服務器上啓動 Harness(服務名按實際部署替換):
sudo journalctl -u deepseek-harness.service -n 100 --no-pager
sudo systemctl start deepseek-harness.service
忘記密碼時的恢復、詳細配置與卸載見部署說明;數據目錄可定期備份,備份文件不要上傳到 Git。倉庫提供 dsh-lifecycle-reset 入口(見 package.json 的 bin 字段),具體步驟以 DEPLOYMENT 文檔爲準。
適用場景與注意¶
適合誰: 自託管單用戶 DSH Web、希望在前端統一鎖屏與多因素登錄、並需要從 UI 執行重啓 / 關機 / 更新重啓的部署者。
公網與安全:
- 公網部署使用 HTTPS;網關放在反向代理之後,內部 Harness 端口僅監聽迴環地址;會話 Cookie 啓用 Secure。
- Passkey 需要穩定的 HTTPS 域名,公網 IP 不支持;可先用密碼或 OTP,之後在 Passkey 標籤頁保存域名後綁定。
- 忘記密碼時第二因素不能跳過第一步;保留服務器管理入口和 OTP 備份代碼。
- 當前壁紙對未登錄訪客可見,圖庫管理需要登錄;不要用含隱私信息的圖片作鎖屏背景。
- 中國內地服務器使用域名前,需完成所需的備案及接入手續。
結尾¶
dsh-lifecycle 把鎖屏、持久化登錄與 Harness 生命週期控制收進同一套 Web 體驗,與「一切皆插件」的 DSH 擴展方式一致。進一步細節與截圖見 GitHub README 與 screenshots.json。
- 目錄頁:https://www.skillhub.cn/plugins/floatDreamWithSong/dsh-lifecycle
- GitHub:https://github.com/floatDreamWithSong/dsh-lifecycle