前言¶
DeepSeek Harness(DSH)默认在 Web Profile 中使用 BrowserAuth 进行身份验证。每次服务启动时,都需要从生成的 URL 中提取随机 Token,并将其手动复制到浏览器中才能访问。这增加了开发调试或日常使用的步骤。dsh-skip-browser-auth 插件旨在解决这一痛点,通过自动化机制跳过 BrowserAuth,使 Web 访问更加直接。
插件介绍¶
这是 iasiv5 维护的一个 DSH 客户端插件。它针对 Web Profile 进行了适配,核心功能是自动跳过 BrowserAuth 流程。安装并启用后,用户只需打开 Web 地址即可直接使用,无需手动复制 Token。
核心功能¶
该插件具备以下特性:
- 自动跳过 BrowserAuth:接管认证逻辑,减少手动操作。
- 精确 profile 门控:仅对特定环境生效。
- 严格成对匹配:要求 runtime 与 connection 版本必须匹配。
- 分代适配:针对不同版本的 DSH 机制进行适配。
- 非侵入式:不修改 DSH 本体与任何底层机制。
- Web Profile 专用:仅支持 Web Profile,不支持 Desktop。
安装与启用¶
安装该插件需要指定 Web Profile。执行以下命令即可安装:
dsh plugin --profile web add @iasiv5/dsh-skip-browser-auth
如果是通过 dsh-m 插件市场安装,可以在市场界面搜索并直接操作。安装完成后,需要重启 DSH Web 服务。
使用说明¶
安装并重启服务后,直接访问 Web 地址即可使用,无需复制 Token。
- 确认 DSH 版本兼容性(runtime 与 connection 必须组成已知版本对)。
- 安装插件。
- 重启 DSH Web。
- 轮询 Web 地址直到恢复 200 状态码。
注意事项¶
使用该插件存在安全与兼容性上的限制,请务必注意:
- 信任网络限制:跳过认证后,Web 对本机或可信网络内的访问不再有身份层。请勿将 DSH 端口暴露给不可信网络。
- Desktop 宿主休眠:Desktop 宿主一律自动休眠,这是设计行为。
- 版本匹配:runtime 与 connection 必须组成已知版本对,混合版本会导致插件休眠。
- 机制修改:该插件不修改 DSH 本体与任何机制,卸载后可完全恢复官方行为。
结语¶
该插件通过简单的配置实现了 Web Profile 访问的自动化,适合需要频繁使用 DSH Web 的场景。相关源码与详细文档可在 GitHub 查看。