前言¶
DeepSeek Harness (DSH) 是一个智能体开发平台。当部署 Web GUI 时，通常需要接入登录保护机制以区分不同用户或控制访问权限。该插件为 DSH 的 Cordis 插件生态提供了一套零依赖、纯配置的认证方案，支持通过用户名密码、OAuth 2.0 以及多种加密货币钱包进行身份验证。
插件概况¶
- 名称：dsh-auth-plugin
- 维护者：v1xingyue
- 类别：admin-security
- 许可证：MIT
- 核心价值：零依赖核心（纯 Node.js 实现），支持密码、通用 OAuth 2.0（内置 GitHub/Google/Discord 模板）及 Solana/EVM 钱包登录，纯配置接入。
核心功能¶
该插件提供了以下能力：
- 用户名 + 密码登录：支持使用 scrypt 哈希存储用户凭证。
- 通用 OAuth 2.0 登录：支持任意授权码提供者（如 GitHub、Google、Discord），通过配置即可接入。
- Solana 钱包登录：基于 ed25519 签名验证，支持 Phantom 等钱包。
- EVM 钱包登录：支持基于 EIP-191 personal_sign 的以太坊系钱包（如 MetaMask）。
- 统一会话管理：使用 HMAC-SHA256 令牌与 HttpOnly Cookie 管理会话，支持登出时吊销。
- 零依赖核心：不依赖第三方 pnpm/npm 包，直接使用 Node.js 原生模块。
- bundle 化安装：支持通过
dsh plugin命令一键安装。
安装与配置¶
插件可以通过 dsh plugin 命令直接安装到指定的 Web profile 中。
dsh plugin --profile web add dsh-auth-plugin
安装后，需要在 ~/.dsh/profiles/web/cordis.patch.yml 中插入配置。最简配置示例如下：
- insert:
- id: auth
name: "./dsh-auth-plugin.js"
config:
users:
admin: admin123
重启 dsh web 服务以使配置生效。
使用注意事项¶
- EVM 钱包依赖：EVM 钱包登录功能需要安装
@noble/curves和@noble/hashes库（可选安装，若缺失则该功能自动禁用）。 - Solana 白名单：配置 Solana 钱包登录时，
allowlist字段为必填项，用于限制允许登录的钱包公钥。 - 核心机制：插件作为唯一的 fallback 座位持有者工作，拦截未认证请求。支持 ed25519 签名验证和 EIP-191 标准。
总结¶
该插件为 DSH 提供了从传统账号体系到 Web3 钱包体系的统一登录入口，且保持了核心代码的轻量化。对于需要快速为 DeepSeek Harness Web 界面增加安全访问控制的场景，这是一个直接的解决方案。详细信息可参考 SkillHub 插件目录 或 GitHub 仓库。
