前言¶
DSH 的插件機制允許把能力掛到會話渲染與 Agent 調用鏈路裏。對於 Agent 會話,一個具體的問題是:回答結束後,下一句問什麼還需要手動輸入。dsh-suggest 做的事情比較窄:在 Agent 每輪迴答完成後,在答案下方生成 3 個可點擊、可編輯的推薦後續問題。
它由 shaoeric 維護,採用 MIT 許可證,提供正式插件與動態插件兩種形態。下面按功能、安裝、用法和注意事項介紹。
這是什麼¶
dsh-suggest 是一個 DeepSeek Harness(DSH)插件。它在 Agent 每輪迴答完成後,在答案下方生成 3 個可點擊、可編輯的推薦後續問題。
點擊推薦項可以直接提交給 Agent,自動開啓新一輪迴答;懸停推薦項也可以先編輯再發送。插件提供正式插件與動態插件兩種形態,功能面向同一類使用場景。
核心功能¶
下面是已覈實的幾項能力。
-
自動生成後續問題
Agent 回答完成後,基於最近 3 條用戶消息生成 3 個推薦後續問題。 -
點擊直接提交
點擊推薦項後,內容會直接提交給 Agent,並開啓新一輪迴答。 -
先編輯再發送
懸停推薦項時,可以先進入編輯狀態,修改內容後再發送。 -
模型調用策略
優先使用同 provider 的 flash 模型,並關閉思考;失敗時回退到會話原模型。 -
生成狀態與失敗處理
按會話 + 輪次緩存。生成中顯示骨架佔位;失敗時顯示具體原因,並可一鍵重試。 -
只保留最新一輪
推薦項只在最新一輪迴答下方顯示。發起新一輪對話後,舊推薦項自動隱藏。 -
主題適配
使用--dsw-alias-*主題變量,自動適配明暗模式。
安裝與啓用¶
正式插件¶
正式插件是持久化安裝,適合需要跨重啓保留的場景。資料給出的安裝命令以本地倉庫路徑爲準。
先克隆倉庫並進入倉庫目錄:
git clone https://github.com/shaoeric/dsh-suggest
cd dsh-suggest
然後安裝到 web profile:
dsh plugin --profile web add file:$(pwd)
這裏的 file: 後面接的是本地倉庫路徑。Windows 下需要改爲倉庫絕對路徑,例如:
dsh plugin --profile web add file:C:/path/to/dsh-suggest
安裝後需要重啓 dsh web 並刷新瀏覽器:
1、停止正在運行的 dsh web;
2、重新運行 dsh web;
3、刷新瀏覽器頁面。
更新正式插件¶
file: 依賴會緩存安裝時的快照,直接重跑 add 不會刷新內容。更新時先刪除,再重新添加:
dsh plugin --profile web remove dsh-suggest
dsh plugin --profile web add file:/絕對路徑/dsh-suggest
完成後重啓 dsh web。
卸載正式插件¶
執行刪除命令:
dsh plugin --profile web remove dsh-suggest
然後重啓 dsh web。
動態插件¶
動態插件是進程內臨時定義,適合臨時驗證或調試。DSH 進程重啓後會丟失,需要重新 define 和 run。
在 DSH Web GUI 的「創造模式」會話中:
1、用 cordis_define 創建插件,將 host.js 內容填入 host 代碼,將 client.js 內容填入 client 代碼;
2、用 cordis_run 激活插件;
3、在 GUI 中批准插件。
首次批准時,單勾授權當前版本,雙勾授權後續更新。
典型用法¶
完成安裝並刷新頁面後,可以按下面方式使用。
- 向 Agent 發起一輪提問。
- Agent 回答完成後,在最新一輪迴答下方會出現 3 個推薦後續問題。
- 如果某條推薦合適,直接點擊,它會提交給 Agent 並開啓新一輪迴答。
- 如果某條推薦需要調整,懸停後先編輯,再發送。
- 發起新一輪對話後,上一輪的推薦項會自動隱藏。
- 如果推薦生成失敗,會顯示具體原因,可按提示重試。
依賴與實現邊界¶
Host 側依賴 llm 與 sessions,正式版另需 typert。客戶端依賴 conversation.chat.turnTail 插槽。
正式插件安裝後是持久化狀態,重啓 dsh web 後仍然可用。動態插件則只存在於當前 DSH 進程內,進程重啓後需要重新定義並激活。
適用場景與注意¶
dsh-suggest 適合需要快速追問、希望減少手動輸入的場景,尤其是 DSH Web 會話中連續進行任務拆解、調試或方案討論的情況。
使用前注意幾點:
-
動態插件不跨重啓
如果希望長期保留,使用正式插件。 -
正式插件更新要先刪除再添加
file:依賴會緩存安裝時的快照,直接重跑add不會刷新內容。 -
資料未提供遠程包安裝命令
已給出的安裝方式是本地倉庫file:路徑,不要自行拼接遠程安裝命令。 -
安裝前檢查源碼與許可證
插件會在 DSH 進程中執行,等同於當前dsh進程權限。安裝前應檢查host.js、client.js、lib/等相關源碼,並確認 MIT 許可證符合項目要求。
結尾¶
dsh-suggest 把 Agent 回答後的追問輸入收斂爲“選擇或輕編輯”:回答結束後給出 3 個可點擊、可編輯的後續問題,點擊即提交,編輯後再發送也可以。它提供正式插件與動態插件兩種形態,適合在 DSH Web 會話中連續追問。
GitHub 倉庫:
https://github.com/shaoeric/dsh-suggest
資料中另有目錄頁線索:
https://www.skillhub.cn/plugins/shaoeric/dsh-suggest
但該目錄頁 URL 在已抓取資料中未直接確認,建議以 GitHub 倉庫爲準。