dsh-web-url-view：DSH 桌面与 Web 界面的固定访问地址

前言¶

DeepSeek Harness (DSH) Desktop 和 dsh web GUI 在每次启动时都会随机选择 Web 端口和启动令牌，导致访问地址不断变化。这导致无法将地址添加到书签，也无法直接从局域网内的其他设备（如手机）访问。

dsh-web-url-view 插件通过在进程内部运行一个固定端口转发器，提供一个稳定的入口地址。该地址在 DSH Desktop 和 Web GUI 的设置菜单中显示，解决了端口随机变化和跨设备访问的问题。

插件概况¶

• 名称: dsh-web-url-view
• 维护者: 1032740078
• 分类: 客户端
• 许可证: MIT

核心功能¶

1. 设置菜单集成: 在 DSH Desktop 的设置左侧菜单以及任何运行相同配置文件的 dsh web GUI 中，添加“查看 URL”页面。
2. 双地址显示: 显示两个 Web GUI 地址。
   • 固定地址: 在重启后保持不变，适合 bookmark。
   • 当前地址: 一次性地址，随每次重启变化。
3. 局域网访问: 固定地址可被局域网内其他设备直接访问。
4. 内置鉴权: 转发器自行执行与当前会话的认证握手，无需在浏览器中处理令牌。
5. 协议支持: 同时转发普通 HTTP 和 WebSocket 升级请求。

安装与启用¶

插件通过命令行安装，也可以在插件市场中搜索安装。

1. 通过命令行安装（推荐）：

    dsh plugin --profile web add github:1032740078/dsh-web-url-view

2. 通过插件市场：
   重启后进入 Settings → Plugin Market，搜索 web-url-view 并点击安装。

使用方法¶

安装完成后，打开 Settings → View URL。你将看到两行地址：

将固定地址复制到手机或其他局域网设备，即可直接打开 Web GUI。

配置与安全¶

默认配置¶

插件默认绑定到 0.0.0.0:47524。

安全注意事项¶

• 风险: 默认绑定 0.0.0.0 意味着局域网内任何设备都可以直接打开 Web GUI，无需额外密码。
• 建议: 仅在受信任的局域网中使用。在公共或共享网络中，请修改配置以限制访问。
• 禁用: 若需禁用固定地址，可在配置中设置 fixedPort: 0。

修改配置¶

要修改端口、绑定接口或禁用固定地址，需覆盖桌面配置文件中的 cordis.patch.yml：

- id: web-url-view
  name: dsh-web-url-view
  config:
    # 固定入口监听端口，0 表示禁用。默认 47524。
    fixedPort: 47524
    # 绑定接口。默认 0.0.0.0（所有接口，局域网可访问）；127.0.0.1 仅限本机。
    fixedHost: 0.0.0.0

地址自动检测¶

LAN 地址是自动检测的，优先选择默认路由接口的 IPv4，并跳过回环、链路本地 (169.254.*) 和常见虚拟接口（docker/veth/vmnet/utun 等）。若无可用的 IPv4，则回退到 127.0.0.1。

工作原理¶

该插件在插件宿主进程中运行一个名为 FixedEntryServer 的固定端口反向代理：
* 它绑定一个固定端口（如 47524）并将机器的 LAN IP 作为入口点。
* 在收到请求时，它使用进程内的启动令牌执行与浏览器相同的 ?token= 握手，并内部持有浏览器会话 Cookie，令牌和 Cookie 不会离开进程或到达浏览器。
* 它支持 HTTP 和 WebSocket（/api/remote.mux）转发，并处理 Host/Origin 头的重写和 Set-Cookie 头的吸收，防止浏览器 Cookie 污染。

故障排查¶

日志条目前缀为 [dsh-web-url-view]。

• macOS 日志: ~/Library/Logs/DSH Desktop/harness.log
• Windows 日志: %APPDATA%\DSH Desktop\Logs\harness.log

生态链接¶

• GitHub: https://github.com/1032740078/dsh-web-url-view
• 社区目录: https://www.skillhub.cn/plugins/1032740078/dsh-web-url-view