dsh-message-box · 消息盒子

给 DeepSeek Harness（DSH）Web 界面的消息盒子：把对话执行完成和等待你审批收进一个可拖动的浮动收件箱。

功能

• 完成通知：后台对话跑完、你还没打开时，收件箱出现一条「对话已完成」。
• 审批通知：任意对话出现审批请求（工具请求越权执行）时，出现「等待审批」，并给出中文的三段说明：
  • 操作：按工具类型归类（执行终端命令 / 修改文件 / 安装插件…）；
  • 内容：从审批原因里提取的命令、路径等具体内容；
  • 说明：这条操作为什么需要你确认。
• 一键跳转：点击条目直接打开对应对话，并让左侧工作区自动滚动到该对话所在位置；
• 返回上一个对话：从消息盒子跳走后，面板顶部会出现「返回上一个对话」，可以回到跳转前所在的对话；
• 原地审批：在收件箱里点「允许一次」或「拒绝」，决定立刻返回给等待中的工具，任务继续执行，不用先打开对话。
• 可拖动 + 右下角锚定：按住铃铛或面板标题栏拖动；位置按距离窗口右侧、下侧的偏移保存，缩放窗口时不会跑位，默认在右下角。
• 点外面自动收起：点面板外的任意位置（对话区、侧栏、空白处）面板自动关闭，Esc 和 × 同样可用。
• 角标显示待处理数量；面板跟随主题令牌，适配亮色、深色和第三方皮肤。

安装

桌面版

1. 侧栏「插件」→「添加插件」；
2. 填入包名 dsh-message-box 并安装、启用；
3. 刷新一次窗口（Ctrl+R）。

CLI Web 版

dsh plugin --profile web add 'dsh-message-box'

装完重启一次 DSH。

使用

• 右下角的圆形铃铛就是消息盒子；有未处理消息时右上角显示数字。
• 点铃铛展开列表：审批条目有「允许一次 / 拒绝 / 打开对话」，完成条目有「打开对话」。
• 点面板外任意位置、按 Esc 或点 × 都可以收起。
• 拖动后位置自动记住（相对右下角）；想恢复默认位置，把它拖回右下角，或清除浏览器 localStorage 里的 dsh-message-box:position:v1。

Windows 桌面小组件（自动启动）

在 Windows 桌面版上，插件还会在窗口外显示一个独立的小鲸鱼组件：

• 安装/启用插件后自动解压到 %USERPROFILE%\.dsh\message-box-widget\ 并启动，无需手动操作；
• 平时只在 DSH 最小化或关闭到托盘时出现（44px 圆形按钮，右下角）；
• 单击展开消息面板，双击唤起 DSH，可拖动，点面板外自动收起；
• 有新消息且 DSH 不在前台时弹出小通知条；
• DSH 退出或插件停用时自动关闭，不会留下后台进程。

想临时关闭这个桌面组件：新建空文件 %USERPROFILE%\.dsh\message-box-widget.disabled，然后重启 DSH；删掉该文件即可恢复。

兼容性

• 适用 DSH >=0.2.0-rc.2 <0.3.0-0，开发与测试版本为 0.2.1-rc.3（桌面版、Windows）。
• 插件通过 DSH 客户端的会话快照和待处理交互对象工作（useSessions、useSessionStatus、pendingInteraction.answer）。这些是客户端内部协议，DSH 升级后可能变化；如果升级后消息盒子失效，请先确认插件版本是否已跟进，或暂时停用。

已知限制

• 完成通知只覆盖后台对话：DSH 的「已完成未查看」只在会话不是当前主视图时置位；正开着的对话跑完不会额外弹通知。
• 消息不持久化：刷新页面后按 DSH 当前的未读状态重新计算，不保留历史已读记录。
• 位置按浏览器保存：拖动位置存在 localStorage，换浏览器或清缓存会回到默认右下角。
• 审批是「允许一次 / 拒绝」的瞬时决定，不支持在这里设置长期权限策略。

卸载

• 侧栏「插件」里停用或卸载 dsh-message-box；
• 插件被停用时会移除注入的样式和浮层，Windows 桌面小组件也会自动关闭，界面恢复原样。

许可

代码采用 MIT，见 LICENSE。