前言¶

DeepSeek Harness（DSH）的核心設計理念是插件化。對於個人託管在本地或局域網的 Web 實例，單純依靠默認配置難以防範未授權訪問。dsh-totp 插件在 DSH Web 服務前增加 TOTP 層，爲個人實例提供基於時間的一次性密碼訪問控制。它不依賴 Google 或 Microsoft 賬號登錄，也不需要額外搭建登錄服務。

核心能力¶

插件主要提供以下能力：
1. 爲 DSH Web 實例提供 TOTP 訪問驗證，支持 Google Authenticator、Microsoft Authenticator 等標準應用。
2. 在 DSH 的「設置 → 訪問驗證」中掃碼綁定，提供綁定、保護開關、恢復碼和鎖定功能。
3. 一鍵鎖定所有已授權頁面和設備。
4. 支持局域網或遠程訪問。
5. 不依賴 Google/Microsoft 賬號登錄，不需要額外搭建登錄服務。
6. 插件直接分發 JavaScript，無需構建。
7. 支持 DSH 的 Fetch、XHR、/ API、WebSocket 和受限資源請求。

安裝與啓用¶

通過已發佈的 npm 包安裝插件：

dsh plugin --profile web add dsh-totp

插件按 profile 安裝。上述命令添加到 web；如果使用其他 Web profile，請將 web 替換成相應名稱。

安裝後啓動 DSH 讓插件配置生效：

dsh --profile web --no-open