前言¶

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