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