前言¶
在 DeepSeek Harness (DSH) 的工作流中，側邊聊天常用於處理上下文或輔助思考。將側邊聊天的結論或信息傳回主會話，通常需要手動複製粘貼，存在操作斷層。dsh-side-notify 是 dsh-sidechat 的配套插件，它通過懸浮組件和全局命令，直接將消息推送到主會話，由主 Agent 作爲下一條用戶消息處理。
插件定位¶
這是由用戶 xiaozhiaixue 維護的 DSH 插件。它的核心價值在於消除“側邊聊 -> 複製 -> 主會話粘貼”的中間步驟，通過 agent.followup 接口實現消息的直接流轉。
核心能力¶
插件提供以下具體功能：
- 懸浮按鈕：當側邊聊天處於激活狀態時，在主界面右下角出現“Notify main agent”膠囊按鈕，位於側邊欄左側。
- 直接推送：在膠囊中輸入內容併發送，消息通過
agent.followup被髮送爲主會話的下一條普通用戶消息。 - 全局斜槓命令：在支持執行主機命令的 UI 界面中，註冊了
/notify <text>和/to-main <text>兩個全局命令。 - 狀態提示：膠囊圓點在主 Agent 忙碌時會變爲橙色；推送後顯示等待通知。
- 語言跟隨：界面語言與 DSH 的語言設置保持一致（支持 zh/en）。
與 bring-back 的區別¶
插件文檔提供了兩種交互方式的對比，選擇取決於具體需求：
| 特性 | dsh-sidechat bring-back | dsh-side-notify push |
|---|---|---|
| 消息落地位置 | 主會話的編輯器草稿（需手動發送）或摺疊的上下文行 | 直接作爲主會話的下一條用戶消息 |
| 是否啓動主 Agent 回合 | 否（需手動發送 / 等待下一回合） | 是（排隊啓動一個回合） |
| 適用場景 | 粘貼長文本或結論，稍後手動處理 | 命令主 Agent 立即處理當前任務 |
安裝與啓用¶
安裝插件需要使用官方提供的安裝命令。安裝後必須重啓 dsh web 服務並進行硬刷新。
# 安裝插件
dsh plugin --profile web add github:realpkuasule/dsh-side-notify
執行安裝命令後，需執行以下步驟使其生效：
1. 停止並重新啓動 dsh web 服務。
2. 在瀏覽器中硬刷新頁面（Mac 使用 Cmd+Shift+R，Windows/Linux 使用 Ctrl+Shift+R）。
插件打包了預構建的 JavaScript，因此通過 GitHub 安裝時無需額外的構建批准步驟。
典型用法¶
使用該插件通常有兩種方式：
-
使用懸浮按鈕：
- 在主會話中開啓或進入側邊聊天。
- 點擊右下角的懸浮膠囊。
- 輸入消息併發送，主會話將直接收到該消息。
-
使用斜槓命令：
- 在任何執行主機命令的 UI 界面中，直接輸入
/notify <文本>或/to-main <文本>。
- 在任何執行主機命令的 UI 界面中，直接輸入
注意事項¶
- 環境要求：插件依賴 Node.js 環境，要求
Node >= 20。 - 權限與信任：插件的“信任圍欄”是
heartmove/dsh-side-chat的純 JavaScript 移植版本（MIT 許可）。 - 推送機制：
push操作會啓動主 Agent 的一個回合（排隊等待），這與dsh-sidechat內置的bring-back行爲不同。 - 源碼信任：雖然插件通過 GitHub 安裝無需構建，但在安裝前應檢查源碼與許可證。
結語¶
dsh-side-notify 通過增加懸浮交互和全局命令，簡化了 DSH 側邊聊天與主會話之間的數據流轉。對於需要頻繁將側邊思考結果轉化爲主會話指令的開發者，這是一個減少手動操作的工具。
插件目錄：https://www.skillhub.cn/plugins/xiaozhiaixue/dsh-side-notify
GitHub 倉庫：https://github.com/xiaozhiaixue/dsh-side-notify
