前言¶

DSH 的理念是「一切皆插件」，本地會話裏常用的身份、提示詞、恢復、重啓、日誌按鈕和會話間消息，過去常被拆成多個本地插件分別維護。對使用 DeepSeek Harness 的開發者來說，這類能力單獨裝、單獨配置、單獨排查，成本並不低。

dsh-session-toolkit 是一個面向 DeepSeek Harness 的整合插件工具包，把六個本地插件能力合併成一個可安裝的工具包。它當前版本爲 0.1.4，適配 DeepSeek Harness dsh-v0.1.2-alpha.1，許可證爲 MIT。社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文按社區插件介紹。

這是什麼¶

dsh-session-toolkit 是 DeepSeek Harness 的整合插件工具包，合併會話身份、全局提示詞、會話自動恢復、Web 重啓、會話日誌按鈕重定位和會話間消息等本地插件能力。倉庫地址在 Han-Yao94 的 GitHub 賬號下；已覈實資料中的 author 字段爲 dsh-session-toolkit maintainers，因此本文只確認倉庫來源，不額外推斷個人維護關係。

它解決的問題很具體：把多個會話側本地插件合併成同一個安裝包，減少重複維護，並把會話身份、提示詞、引用文件、自動恢復、Web 重啓、日誌按鈕位置和會話間消息放進同一套插件能力裏。

核心功能¶

會話身份¶

會話身份提供身份對話框和狀態按鈕。對話框中可用啓用開關，並支持保存/重置、編輯默認、繼承默認。

全局提示詞¶

全局提示詞在設置頁提供 Global / Per workspace 選項卡，並注入對應系統提示詞段。

工作區提示詞¶

工作區提示詞按活動會話 cwd 前綴匹配。多個匹配項同時命中時，選擇最長路徑。

引用文件¶

引用文件在每次組裝時重新讀取。讀取失敗時跳過該文件內容，並在 UI 中報告原因。

會話自動恢復¶

打開某個會話的自動恢復開關後，GUI 重啓後自動恢復該會話。會話自動恢復的併發上限爲 3，並隔離單項失敗。

Web 重啓¶

在 General settings 中點擊 Restart service，觸發 POST /api/restart 並顯示進度。Web Restart 不觸發 UAC 提示，重啓腳本的提權分支不會被執行。

會話日誌按鈕重定位¶

插件包含會話日誌按鈕重定位能力，用於調整會話日誌按鈕的呈現位置。

會話間消息¶

會話間消息提供 send_to_session / list_sessions 工具和複製會話 ID 按鈕。

安裝與啓用¶

插件以 dsh.bundle.patch 官方 bundle 形式發佈。已覈實資料中給出的安裝命令入口是：

dsh plugin add

這條命令來自已覈實資料。資料中未給出完整安裝參數，本文不憑倉庫名拼接安裝參數。實際安裝時，請以倉庫 README 或 DSH 社區目錄中給出的完整說明爲準。

典型用法¶

下面按能力拆分，步驟都來自已覈實能力說明。

配置會話身份¶

1、在會話身份相關入口打開身份對話框。
2、使用啓用開關打開或關閉會話身份。
3、通過保存/重置、編輯默認、繼承默認調整身份內容。
4、通過狀態按鈕查看當前狀態。

配置全局與工作區提示詞¶

1、進入設置頁中的全局提示詞相關入口。
2、在 Global / Per workspace 選項卡中分別配置全局提示詞和工作區提示詞。
3、會話組裝時，按已覈實說明注入對應系統提示詞段。

使用工作區提示詞匹配¶

1、配置工作區提示詞。
2、活動會話按 cwd 前綴匹配工作區目錄。
3、多個工作區同時匹配時，選擇最長路徑作爲命中項。

使用引用文件¶

1、在提示詞能力中引用文件。
2、每次組裝時重新讀取文件。
3、如果讀取失敗，跳過該文件內容，並在 UI 中查看失敗原因。

啓用會話自動恢復¶

1、選擇需要恢復的會話。
2、打開該會話的自動恢復開關。
3、GUI 重啓後，該會話按已覈實說明自動恢復。
4、自動恢復過程受併發上限 3 限制，並隔離單項失敗。

執行 Web 重啓¶

1、進入 General settings。
2、點擊 Restart service。
3、插件觸發 POST /api/restart，並顯示進度。
4、該過程不觸發 UAC 提示，重啓腳本的提權分支不會被執行。

使用會話間消息¶

1、通過複製會話 ID 按鈕獲取目標會話 ID。
2、使用 send_to_session 工具向目標會話發送消息。
3、使用 list_sessions 工具查看可尋址會話。

適用場景與注意¶

這個工具包適合正在使用 DeepSeek Harness，並希望在本地會話中統一管理身份、提示詞、引用文件、恢復、重啓和會話間消息的開發者。

使用前需要注意：

• 當前版本爲 0.1.4，適配 DeepSeek Harness dsh-v0.1.2-alpha.1。
• 許可證爲 MIT。
• 插件以 dsh.bundle.patch 官方 bundle 形式發佈。
• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• Web Restart 不觸發 UAC 提示，重啓腳本的提權分支不會被執行。
• 引用文件讀取失敗會被跳過，不注入該文件內容。
• 會話自動恢復併發上限爲 3，並隔離單項失敗。
• 客戶端若無法訪問 schemastery，會優雅降級，但主機端仍做 schema 驗證。
• 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不要把插件包描述爲官方應用商店內容。

目錄與倉庫¶

• 社區目錄：已覈實資料未給出目錄頁 URL，本文不寫入未覈實地址。
• GitHub 倉庫：https://github.com/Han-Yao94/dsh-session-toolkit.git

經過上面的步驟，你可以先把 dsh-session-toolkit 當作一個本地整合包來評估：它不改變 DSH 的插件化方向，而是把多個會話側能力放到同一個工具包裏，便於統一安裝、統一查看和統一排查。