前言¶

DSH WebUI 默認會恢復最後一次會話。當你需要把某個具體對話或某個工程的最新對話通過鏈接打開時，手動查找會話會比較麻煩。dsh-deeplink 是一個 DSH WebUI 插件，通過 URL 查詢參數直接打開指定項目對話，並讓當前會話地址可以跟隨會話變化。

這是什麼¶

dsh-deeplink 的一句話定位是：用 ?session=<會話id> 或 ?workspace=<工程id> 直接打開指定項目對話。

倉庫位於 https://github.com/qyw233/dsh-deeplink，許可證爲 MIT，Copyright (c) 2026 DSH Community Contributors。它通過 dsh plugin 安裝到 DSH profile 中，瀏覽器端處理 URL 參數和會話切換，node 端註冊模型提示。README 稱該插件無 cordis import、無 peerDependencies。

核心功能¶

• 從 URL 讀取 ?session=<session-id>，直接打開對應會話。
• 從 URL 讀取 ?workspace=<workspace-id>，打開該工程的最新/空白會話。
• 當同時提供 session 和 workspace 時，session 優先。
• 目標會話/工程不存在，或處於 archived / hidden 狀態時，靜默回退到默認行爲，即恢復最後一次會話。
• 當前會話變化後，通過 history.replaceState 將地址欄改寫爲 ?session=<current-session-id>，不污染瀏覽器歷史，不觸發頁面重載。
• 提供兩個獨立設置開關：
• dsh-deeplink.jump：深鏈跳轉，默認開啓。
• dsh-deeplink.follow：地址欄跟隨，默認開啓。
  兩個開關都持久化在 localStorage。
• node half 註冊全局模型提示段落，讓模型在回覆中引用其他會話或工程時，可以附加深鏈；提示要求模型只輸出真實存在的會話/工程 id，不編造 id。

安裝與啓用¶

1、使用官方 profile 安裝：

dsh plugin --profile web add github:qyw233/dsh-deeplink

2、安裝後重啓 Web UI，並刷新瀏覽器頁面。

3、插件會出現在 __DSH_BOOT__ boot graph 中。

4、進入設置中的插件配置，可按需切換兩個開關：

• 跳轉到指定對話：對應 dsh-deeplink.jump。該開關在頁面加載時讀取一次，所以建議先開啓，再打開深鏈。
• 地址欄跟隨：對應 dsh-deeplink.follow。該開關在每次同步時讀取，可即時切換。

典型用法¶

打開指定會話時，在 WebUI URL 後追加 ?session=<session-id>：

http://127.0.0.1:3080/?session=session-304ae36e-1e66-453a-a946-2b0a9a2b173d

打開指定工程的最新/空白會話時，追加 ?workspace=<workspace-id>：

http://127.0.0.1:3080/?workspace=fc8b75ae-107c-4b6c-978c-276270b03b8b

會話 id 和工程 id 可以這樣查找：

• 會話 id：~/.dsh/sessions/--<project>--/<session-id>/ 下的目錄名，或 ~/.dsh/storages/workspace.json 中 tables.workspaces[].sessionIds。
• 工程 id：~/.dsh/storages/workspace.json 中 tables.workspaces 的 key，即 UUID。

適用場景與注意¶

適合需要把 DSH WebUI 會話鏈接化、收藏、分享，或希望模型在回答中引用其他會話/工程時直接給出深鏈的 DSH 用戶。

使用前注意：

• 插件包含輕量 node half，會以當前 dsh 進程權限運行。安裝前建議檢查源碼、許可證（MIT）和倉庫內容。
• browser half 依賴運行時提供的 sessions / workspaces services 及其 list snapshots；node half 依賴 systemPrompt / webServer services，資料稱由 dsh-base 與 web compositions 提供。
• 插件提示要求模型只輸出真實存在的會話/工程 id，不編造 id。
• browser half 的變更由 HMR（stat-poll，約 0.5s）拾取，刷新頁面可見；node half 的變更需要重啓 dsh web。
• 該插件無構建步驟，lib/ 已提交或可直接編寫。

鏈接¶

• GitHub：https://github.com/qyw233/dsh-deeplink
• 社區目錄頁 URL 未出現在已覈實資料中，本文不附鏈接。