dsh-side-notify

dsh-sidechat 的配套插件：在侧聊场景下把一条消息直接推送给主 agent，主 agent 会把它当作主会话的下一条用户消息处理——不用复制粘贴，也不用在主对话里手动发送。

English docs: README.md.

功能

• 悬浮胶囊——当前对话存在活跃侧聊时，页面右下角（侧聊面板左侧）出现「通知主 agent」按钮。
• 输入即推送——输入内容后发送（或 Cmd/Ctrl+Enter），消息经 agent.followup 以普通用户消息投递进主会话；主 agent 空闲则立即处理，忙碌则当前轮结束后处理。
• 斜杠命令——全局注册 /notify <内容> 与 /to-main <内容>，供任何能在侧聊 agent 上执行宿主命令的界面使用。
• 状态提示——主 agent 忙碌时胶囊圆点变橙色；推送成功后提示消息是立即处理还是等待本轮结束。
• 中英文跟随 DSH 语言设置。

推送 与 dsh-sidechat 自带「带回」的区别

	dsh-sidechat 自带带回	dsh-side-notify 推送
落点	主对话草稿框（手动发送）或折叠上下文行（下一轮被动看到）	直接作为主会话的用户消息
是否触发主 agent	否（手动发送 / 等下一轮）	是（排队开启自己的一轮）
适用场景	把资料、结论"贴回去"	下命令：让主 agent 立刻处理某事

安装

# 两个插件一起装进 web profile（从 GitHub）：
dsh plugin --profile web add github:realpkuasule/dsh-sidechat
dsh plugin --profile web add github:realpkuasule/dsh-side-notify

# 或本地源码安装（软链接，改代码即生效）：
dsh plugin --profile web add ./dsh-side-notify

重启 dsh web 并硬刷新页面（Cmd/Ctrl+Shift+R）。dsh-side-notify 直接分发预构建的 JavaScript，GitHub 安装无需构建授权。

使用

1. 发起或打开一个侧聊（见 dsh-sidechat）。
2. 点击面板旁的「通知主 agent」胶囊，输入消息并发送。
3. 主对话会以普通用户消息的形式显示这条消息，主 agent 在下一轮直接处理。

实现原理

• Host（lib/index.js）——/side-notify/api/{state,push} JSON 路由（与 dsh-sidechat 相同的 loopback/可信主机围栏）+ 全局 /notify、/to-main 命令。两者都通过侧聊会话的 header.parentSession 找到实时主 agent，再用 agent.followup 投递消息。
• Client（lib/client.js）——window.__ModuleLoader__ 格式的纯 JS bundle，portal 挂载到 document.body；每 1.5 秒轮询 state 路由，并用 --dsh-subchat-width CSS 变量把自己定位在侧聊面板左侧。
• 无构建步骤：lib/ 即源码与产物。

许可证

MIT。信任围栏代码移植自 heartmove/dsh-side-chat（MIT）。