前言¶
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 倉庫。
