前言¶
在 DSH web 會話中,回答內容可能與思考塊和工具調用內容混在一起。dsh-session-state 是一個 DSH 界面插件:默認摺疊 Think 思考塊和工具調用內容,讓回答內容直接展示;並在會話輸入框上方增加會話活動狀態條,即時展示 Think / Edit / Bash / Read 的累計次數,可展開與收起。
這是什麼¶
一句話:面向 DeepSeek Harness web 的界面插件,用來摺疊會話中的思考與工具內容,並在輸入框上方提供可展開的會話活動狀態條。
倉庫地址:https://github.com/Hanice404/dsh-Session-State。許可證:MIT。
目標平臺是 DeepSeek Harness web(dsh --profile web),版本要求 0.1.0-rc.7 及以後。
核心功能¶
摺疊思考過程¶
默認開啓。隱藏會話中的 Think 思考塊,讓回答內容直接展示。在設置中關閉後恢復原生摺疊樣式。
摺疊工具內容¶
默認開啓。隱藏會話中的工具調用內容(Bash / Edit / Write / Read / Search / Code),與思考塊一樣摺疊,只保留回答內容。
會話活動狀態條¶
在輸入框上方顯示 Think / Edit / Bash / Read 四類活動的累計次數。工具條與展開面板都左右兩側對齊輸入框。
展開查看內容¶
點擊狀態條展開後,每個類別都是一個可摺疊的分區,列出該類別每次活動的實際內容,整個面板可滾動。
運行指示¶
運行中的類別帶呼吸燈。prefers-reduced-motion 下自動關閉動畫。
持久化¶
collapseThinking、collapseTools、statusBar 三個開關都保存在 ~/.dsh/settings.yaml 的 dsh-session-state 一節。
安裝與啓用¶
先確認運行在 dsh --profile web 環境,且 DSH 版本爲 0.1.0-rc.7 及以後。
從 GitHub 安裝¶
README 將這條命令標註爲發佈後:
dsh plugin --profile web add https://github.com/Hanice404/dsh-Session-State/archive/refs/heads/main.tar.gz
從本地目錄安裝¶
開發調試時可以使用本地目錄:
dsh plugin --profile web add file:/path/to/dsh-Session-State
也可以直接在 profile 目錄用 pnpm 安裝:
cd ~/.dsh/profiles/web && pnpm add "file:/path/to/dsh-Session-State"
避免使用 link:¶
不要用 link: 安裝本插件。本 profile 使用 nodeLinker: hoisted,link: 會生成指向插件源碼目錄的軟鏈接,Node 會按軟鏈接的真實路徑解析插件內部的 @deepseek-ai/* 導入,導致:
Cannot find package '@deepseek-ai/dsh-settings'
重啓 dsh web¶
安裝後重啓 dsh web,使瀏覽器端加載新插件 bundle。先 Ctrl+C 停止當前 dsh web,再運行:
dsh web
典型用法¶
直接編輯設置¶
目前 collapseThinking、collapseTools、statusBar 無獨立設置頁,可直接編輯 ~/.dsh/settings.yaml 的 dsh-session-state 一節:
dsh-session-state:
collapseThinking: true
collapseTools: true
statusBar: true
字段含義:
collapseThinking:默認true,摺疊思考過程,直接輸出回答內容collapseTools:默認true,摺疊工具調用內容(Bash / Edit / Write / Read / Search / Code),直接輸出回答內容statusBar:默認true,顯示會話活動狀態條
DSH 0.1.0-rc.7 及以上版本會自動把設置暴露給瀏覽器,無需額外步驟。
在界面中查看¶
狀態條顯示 Think / Edit / Bash / Read 的累計次數。點擊狀態條展開後,每個類別都是一個可摺疊的分區,可以查看該類別每次活動的實際內容。運行中的類別帶呼吸燈;prefers-reduced-motion 下自動關閉動畫。
適用場景與注意¶
適合:
- 希望 DSH web 會話中優先看到回答內容,減少 Think 塊和工具調用內容的干擾
- 需要在輸入框上方查看 Think / Edit / Bash / Read 的累計次數
- 需要展開狀態條查看每次活動的實際內容
注意:
- 插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證。
- 目標平臺是 DeepSeek Harness web(
dsh --profile web),版本要求0.1.0-rc.7及以後。 - 目前三個開關無獨立設置頁,可直接編輯
~/.dsh/settings.yaml。 - 依賴聲明見
package.jsonpeerDependencies: @deepseek-ai/cordis ^4.0.1@deepseek-ai/dsh-client-ui-settings ^0.1.0-rc.6@deepseek-ai/dsh-client-ui-slots ^0.1.0-rc.6@deepseek-ai/dsh-settings ^0.1.0-rc.6@deepseek-ai/schemastery ^3.18.1react ^18.0.0
結尾¶
dsh-session-state 的價值在於把思考過程、工具調用和會話活動分成兩層:回答內容直接展示,活動狀態在輸入框上方彙總,需要細節時再展開。
GitHub 倉庫:https://github.com/Hanice404/dsh-Session-State。許可證:MIT。