前言¶
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 / 幻方无官方从属关系。更多细节请查看项目主页。
