dsh-suggest:DSH 會話裏的可點擊後續問題插件

前言

DSH 的插件機制允許把能力掛到會話渲染與 Agent 調用鏈路裏。對於 Agent 會話,一個具體的問題是:回答結束後,下一句問什麼還需要手動輸入。dsh-suggest 做的事情比較窄:在 Agent 每輪迴答完成後,在答案下方生成 3 個可點擊、可編輯的推薦後續問題。

它由 shaoeric 維護,採用 MIT 許可證,提供正式插件與動態插件兩種形態。下面按功能、安裝、用法和注意事項介紹。

這是什麼

dsh-suggest 是一個 DeepSeek Harness(DSH)插件。它在 Agent 每輪迴答完成後,在答案下方生成 3 個可點擊、可編輯的推薦後續問題。

點擊推薦項可以直接提交給 Agent,自動開啓新一輪迴答;懸停推薦項也可以先編輯再發送。插件提供正式插件與動態插件兩種形態,功能面向同一類使用場景。

核心功能

下面是已覈實的幾項能力。

  1. 自動生成後續問題
    Agent 回答完成後,基於最近 3 條用戶消息生成 3 個推薦後續問題。

  2. 點擊直接提交
    點擊推薦項後,內容會直接提交給 Agent,並開啓新一輪迴答。

  3. 先編輯再發送
    懸停推薦項時,可以先進入編輯狀態,修改內容後再發送。

  4. 模型調用策略
    優先使用同 provider 的 flash 模型,並關閉思考;失敗時回退到會話原模型。

  5. 生成狀態與失敗處理
    按會話 + 輪次緩存。生成中顯示骨架佔位;失敗時顯示具體原因,並可一鍵重試。

  6. 只保留最新一輪
    推薦項只在最新一輪迴答下方顯示。發起新一輪對話後,舊推薦項自動隱藏。

  7. 主題適配
    使用 --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 中批准插件。

首次批准時,單勾授權當前版本,雙勾授權後續更新。

典型用法

完成安裝並刷新頁面後,可以按下面方式使用。

  1. 向 Agent 發起一輪提問。
  2. Agent 回答完成後,在最新一輪迴答下方會出現 3 個推薦後續問題。
  3. 如果某條推薦合適,直接點擊,它會提交給 Agent 並開啓新一輪迴答。
  4. 如果某條推薦需要調整,懸停後先編輯,再發送。
  5. 發起新一輪對話後,上一輪的推薦項會自動隱藏。
  6. 如果推薦生成失敗,會顯示具體原因,可按提示重試。

依賴與實現邊界

Host 側依賴 llm 與 sessions,正式版另需 typert。客戶端依賴 conversation.chat.turnTail 插槽。

正式插件安裝後是持久化狀態,重啓 dsh web 後仍然可用。動態插件則只存在於當前 DSH 進程內,進程重啓後需要重新定義並激活。

適用場景與注意

dsh-suggest 適合需要快速追問、希望減少手動輸入的場景,尤其是 DSH Web 會話中連續進行任務拆解、調試或方案討論的情況。

使用前注意幾點:

  1. 動態插件不跨重啓
    如果希望長期保留,使用正式插件。

  2. 正式插件更新要先刪除再添加
    file: 依賴會緩存安裝時的快照,直接重跑 add 不會刷新內容。

  3. 資料未提供遠程包安裝命令
    已給出的安裝方式是本地倉庫 file: 路徑,不要自行拼接遠程安裝命令。

  4. 安裝前檢查源碼與許可證
    插件會在 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 倉庫爲準。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜