前言¶
在 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
