在 DSH 工作流中，保持对会话状态的可见性往往需要频繁切换上下文。DSH Notch 旨在将这种上下文切换最小化，通过屏幕边缘的原生窗口展示运行状态和待处理任务。
插件介绍¶
DSH Notch 是一个为 DeepSeek Harness 设计的 macOS 插件，由 aa2246740 维护，基于 MIT 许可证。它由两部分组成：负责同步会话状态的 Host 插件，以及负责显示和交互的原生 macOS 应用。通过这两部分的配合，用户可以在不进入 DSH 界面的情况下，通过屏幕边缘的 Notch 查看任务进度、回答问题或查看完成结果。
安装与启用¶
在安装前，请确保环境满足以下要求：macOS 14+、Apple Silicon 芯片，以及 DeepSeek Harness 0.2.0-rc.2 版本。
1. 安装插件包¶
在终端中执行以下命令安装 Host 插件和客户端同步助手：
dsh plugin --profile web add dsh-notch@0.3.4
dsh plugin --profile web add dsh-notch-focus@0.1.2
2. 启动原生程序¶
插件包安装完成后，需要下载并启动原生程序。原生程序版本为 0.3.3。
- 从 GitHub Releases 下载
dsh-notch-0.3.3-macos-arm64.tar.gz并解压。 - 进入解压目录并启动程序：
cd dsh-notch-0.3.3-macos-arm64
./dsh-notch --verify-idle-resources
./dsh-notch
3. 环境配置¶
原生程序与 Host 插件必须指向相同的 DSH_HOME 目录。原生程序依赖 OpenBotMotion 提供机器人资源，首次运行时请确保资源完整。
核心功能¶
插件在屏幕边缘提供状态指示和交互功能，帮助开发者高效管理 DSH 会话。
状态指示¶
Notch 窗口通过颜色和数字显示当前会话状态：
* 蓝色数字：表示正在运行的会话数量。
* 黄色感叹号：表示有待处理的问题或决定。
* 绿色数字：表示未读的完成结果。
* 红色数字：表示失败结果。
交互操作¶
- 直接回答：点击 Notch 上的问题选项可直接提交答案；点击问题标题可跳转回 DSH 查看完整上下文。
- 弹性收纳：拖动 Notch 后松手，它会弹性收纳到屏幕边缘；再次拖出即可恢复。
- 自动弹回：隐藏状态下，若出现新的完成、错误或待审批问题，它会自动弹回正常紧凑状态；同一提醒不会因轮询反复弹出。
- 空闲状态：当所有任务结果读完后，Notch 会显示待机机器人。
注意事项¶
- 计数规则：计数以用户的主对话为单位，嵌套的子代理归入主对话统计，不会各自增加蓝色数字或生成完成、失败灯。
- 日志记录：详细的交互日志记录在
~/.dsh/dsh-notch/presentation.l，可用于排查状态灯叠影或动画异常等问题。 - 资源要求：插件运行需要 Apple Silicon 芯片支持，且原生程序必须与 Host 插件共享
DSH_HOME。
