前言¶
在开发或使用 DeepSeek Harness（DSH）时，一个常见问题是：当智能体在后台处理任务、生成内容或调用工具时，你无法直观地知道它的当前状态。你只能打开 DSH 窗口查看，打断工作流。DSH Notch Pet 就是为了解决这个问题：它把一个小型机器人塞进 MacBook 的硬件 notch，在不占用额外窗口的前提下，实时显示当前会话、正在执行的步骤、任务进度和 token 使用情况。
这是什么¶
DSH Notch Pet 是一个 DSH 客户端插件，由维护者 hyzmm 开发。它是一个 native companion，运行在 macOS 上，通过私有 Unix socket 与 DSH host 通信，在屏幕顶部显示当前会话的标题和实时步骤行。当鼠标悬停时，面板展开，显示更多细节：已用时间、任务/目标进度、活动 agent 数量、模型信息、token 使用量以及快捷访问 DSH 的入口。
核心功能¶
1. 实时步骤显示¶
面板在 collapsed 状态下显示两行：会话标题和实时步骤行。这一行不是最终的助手回答，而是与 DSH 聊天窗口中 assistant 消息下方的 live step 一致的内容：
- 模型思考时显示
Thinking · <最新推理> - 调用工具时显示
Editing file · native/Sources/PetView.swift或Running command · Build the native app - 右侧显示当前回合的已用时间
2. 进度条¶
进度条根据任务类型和状态变化：
- 有
todo_write列表时，显示Tasks 3/7 - 没有任务但有目标轮次时，显示
Goal 2/6 rounds - 既无任务也无目标时，显示一个不确定的闪烁条
- 当智能体空闲时，不确定条消失，确定条冻结或隐藏
3. 展开面板详情¶
鼠标悬停时，面板展开为紧凑的状态卡片，包含：
- 最多两行标题
- 实时步骤行
- 已用时间
- 任务/目标进度（如
Tasks 3/7） - 活动 agent 数量
- 模型名称
- token 使用量（如
21.9K tok · 94% hit） - 快捷按钮：固定面板、打开 DSH、打开设置
4. 固定与隐藏¶
- 点击机器人图标可以固定或取消固定面板
- 固定的面板忽略鼠标移出，即使关闭了 “Only while working” 开关也会保持显示
- 右键面板可以打开 DSH、固定/取消固定、打开设置或退出
5. Token 使用量¶
展开面板底部的 footer 显示当前会话的累计 token 使用量，来源与 DSH 自身的 Usage pill 一致：
- 显示累计 billed input（包含未缓存、缓存读取、缓存写入）加上 output
hit表示 prompt-side input 中缓存读取的占比- 悬停可以查看详细分解
6. 配色方案¶
提供六种预设配色：冰川（默认青色）、极光、鸢尾、樱花、橘子、薄荷，以及自定义 hue/saturation/brightness 选择器。状态颜色保持一致：等待为琥珀色、错误为红色、完成回合为薄荷色。
7. 智能显示策略¶
- 有运行中的根会话时聚焦根会话，否则聚焦最近活动的子 agent
- 活动子 agent 计入活动 agent 总数
- 标题来自 DSH 的会话标题（自动生成或用户重命名），没有标题时使用工作区文件夹名
安装与启用¶
通过 DSH 界面安装¶
- 打开 DSH 中的 Plugins 面板
- 点击 Add plugin
- 在对话框中输入插件名
dsh-notch-pet - 确认。DSH 会自动获取 bundle 并安装
通过终端安装¶
dsh plugin --profile web add github:hyzmm/dsh-notch-pet
web 是 DSH Desktop 的 profile；请保持你实际运行的 profile 名称。安装后，面板会在几秒钟内出现在显示顶部。如果未出现，请确保插件在 Plugins 中已启用，然后禁用再启用插件，或重启 DSH。
典型用法¶
安装完成后，面板会自动出现在屏幕顶部（有 notch 的 Mac 上在 notch 旁，其他 Mac 上在主显示器顶部中央）。当 DSH 正在处理任务时：
- collapsed 状态下，你会看到会话标题和实时步骤行
- 鼠标移入面板，展开查看更多细节
- 点击机器人图标固定面板，防止它随鼠标移出而收起
- 右键面板可以快速访问 DSH 或设置
当没有任务运行时，面板会完全隐藏（除非已固定）。在菜单栏中会出现一个爪印图标，点击可以打开设置、打开 DSH、切换 “Only while working” 开关或退出。
适用场景与注意¶
适用场景¶
- 在 macOS 上使用 DSH Desktop 或在 macOS GUI 会话中运行 DSH host 的开发者
- 需要实时监控智能体任务进度和 token 使用情况的工作流
- 希望减少切换窗口、保持工作流连续性的用户
注意事项¶
- 仅支持 macOS 14 或更新版本
- 插件需要 DSH host 运行在 macOS GUI 会话中（不能是 headless 模式）
- 插件以当前 DSH 进程的权限运行，安装前应检查源码和许可证
- 面板只在第一个有 notch 的显示器上显示，不会跟随 DSH 窗口切换显示器
- 本地通信，无网络调用，无遥测，无需账号
短结尾¶
DSH Notch Pet 通过在 macOS notch 显示实时智能体进度，为 DSH 用户提供了在不打开窗口的情况下了解当前任务状态的能力。它通过私有 Unix socket 与 host 通信，显示会话标题、实时步骤、进度条和 token 使用量，支持固定面板和多种配色方案。适合需要在 macOS 上持续监控 DSH 任务进度的开发者。
- 插件目录：https://www.skillhub.cn/plugins/hyzmm/dsh-notch-pet
- GitHub：https://github.com/hyzmm/dsh-notch-pet
