GUI 认证链接 NingYuanLee/dsh-gui-auth-url

dsh-gui-auth-url

DeepSeek Harness 的第三方社区插件。不是 DeepSeek 官方产品。MIT 协议。

把运行中的 DeepSeek Harness Web GUI 的已认证 URL 暴露成智能体工具，浏览器自动化和脚本就能直接打开 GUI，不用再撞上 401 dsh web authentication required。

问题

dsh --profile web 每个进程随机生成一个启动 token，只打印一次：

dsh web: http://127.0.0.1:3080/?token=...

GET /?token=... 校验 token，设置一个绑定 host:port 的签名 cookie，然后重定向到 /。直接打开裸地址会返回：

401 dsh web authentication required; reopen the URL printed by dsh web.

桌面版在随机端口上启动自己的 Host 进程，从不打印这一行。所以外部浏览器或自动化工具打开 http://127.0.0.1:<port>/ 时，永远拿到 401。目前也没有 --no-browser-auth 开关。

工作原理

插件跑在 Host 进程里，调用官方公开 API connection.authenticatedUrl(baseUrl)——dsh web 打印 URL 用的也是这个调用——再把结果作为工具结果返回。

插件从不读取 $DSH_HOME/.credentials.yaml 里的 cookie 签名密钥，也不自己签发 cookie，所以拿到的 URL 是真正绑定当前进程的第一方会话。

Base URL 的解析顺序：优先 webApp.getAdvertisedUrl()（会遵循 --public-url 和挂载点），其次 webServer.getOrigin()，最后是协议加回环端口。每次调用都重新读取实时值，所以桌面版的随机端口和重启后的 token 都不需要缓存。

安装

dsh plugin --profile web add github:NingYuanLee/dsh-gui-auth-url

包内声明了 dsh.bundle.patch，所以 dsh plugin add 会自动把 bundle 写进配置档的 dsh.profile.bundles。重启 DeepSeek Harness，工具就出现了。

想用本地检出：

git clone https://github.com/NingYuanLee/dsh-gui-auth-url.git
dsh plugin --profile web add ./dsh-gui-auth-url

npm 还没发布，目前只有 GitHub 这一个渠道。

从旧名 dsh-gui-session（0.1.x）升级：包名、Cordis row id 和工具名都变了，需要重装一次：

dsh plugin --profile <name> remove dsh-gui-session
dsh plugin --profile <name> add github:NingYuanLee/dsh-gui-auth-url

用法

插件注册一个工具 gui_auth_url，不带参数。它返回：

{
"url": "http://127.0.0.1:3080/?token=...",
"origin": "http://127.0.0.1:3080",
"protocol": "http:",
"host": "127.0.0.1",
"port": "3080",
"secure": false
}

模型看到的是 url 文本；其余字段供程序化调用方使用。把 URL 交给 navigate_page、curl 或任意 HTTP 客户端，即可进入 GUI。

典型用法：调试 DeepSeek Harness 自身时，让智能体用 chrome-devtools-mcp 打开实时 GUI，真实验证布局、交互和 RPC，而不是对着代码猜。

安全

- 返回的 URL 里含有本进程的启动 token。它等同于已登录会话的凭证，只在 Host 进程存活期间有效。
- 不要写进日志、不要提交、不要粘贴到聊天里。需要时再调用一次工具重新生成；重启后旧 token 失效。
- 插件不读 .credentials.yaml，也不签发 cookie；它的权限边界与终端里的 dsh web 完全一致。
- 它与 Discussion #8678 无关（那个讨论讲的是在沙箱内读取签名密钥来伪造 cookie）：本插件从不碰那个密钥。

兼容性

| 项目 | 值 |
| dsh | >=0.2.1-rc.2 <0.3.0-0 |
| Node | >=22.19.0 |
| 验证环境 | dsh 0.2.1-rc.2，Windows x64，desktop 与 web 配置档 |
| Web 组合 | 需要 connection 服务；没有 Web GUI 的配置档会报出明确错误 |

显示元数据（locale/.json 加上导出的 ./icon）让 Plugins 页面和 Settings 显示正常的标题、描述和图标，而不是原始包 id。插件不需要构建步骤：直接发布纯 ESM JavaScript。

故障排查

安装后工具不出现。 检查配置档的 package.json，确认 dsh.profile.bundles 里列了 dsh-gui-auth-url。dsh plugin add 通常会写入，但安装失败时可能只留下依赖：

{
"dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-gui-auth-url"] } }
}

重启 DeepSeek Harness，然后用 dsh --profile <name> --dump-config 确认，找 gui-auth-url 那一行。

版本不匹配导致安装被拒。 DSH 在安装时检查 engines.dsh（或 dsh peer 范围）。如果宿主版本超出声明范围，先授予精确版本豁免，重新安装，等有兼容版本后再撤销：

dsh plugin --profile <profile> version-exemptions
dsh plugin --profile <profile> allow-version dsh-gui-auth-url@0.2.1 --dsh-version <runtime> --accept-risk
dsh plugin --profile <profile> revoke-version dsh-gui-auth-url@0.2.1
Windows 上出现 EPERM: rename ... node_modules\dsh-gui-auth-url_tmp_。 先停掉正在使用该配置档的 DSH 进程，删掉残留的 node_modules\dsh-gui-auth-url 目录，再重试。进程在运行时会锁住这个目录。

「This profile serves no Web GUI」。 只有当配置档挂载了 webApp 或 webServer，并且挂载了 connection 时，插件才会返回 URL。无头风格的配置档没有可打开的 GUI。

开发

node --test test/*.test.js # unit + manifest compliance tests
node --check src/index.js && node --check src/auth-url.js
npm run check:pack # verifies the published tarball contents

src/auth-url.js pure helpers: base URL resolution + Host session call (unit-tested)
src/index.js Cordis plugin entry: registers the gui_auth_url tool
locale/ display metadata (en, zh, es, pt, hi)
test/ node:test suites, including packaging invariants
scripts/ tarball check used by prepublishOnly and CI

插件只注册一个工具；ctx.tools.register 返回的 disposer 归 Cordis 所有，所以卸载或热重载插件时，这个工具会被干净地移除。

相关链接

- Discussion #5932 — 本地脚本访问 Web UI 时返回 401
- Discussion #5828 — 请求增加 --no-browser-auth，未采纳
- Discussion #9085 — Desktop 无法获取有效会话
- 官方连接契约
- DeepSeek Harness 社区插件注册表 — 发现更多插件