刘海宠物 hyzmm/dsh-notch-pet

DSH Notch Pet

你的 DSH 智能体，住进 MacBook 刘海。
原生伴侣，展示当前会话、智能体正处在哪一步、这一轮走了多远——不用打开窗口。

DSH Notch Pet 把一个小机器人塞进硬件刘海。一眼就能看到会话标题，以及 DSH 在聊天里显示的实时步骤行。鼠标悬停，它展开成一张紧凑的状态卡：本轮已用时间、任务或目标进度、会话的 token 用量、活跃智能体数量、模型，还有一键回到 DSH。

快速跳转： 截图 · 亮点 ·安装 · 操作 · 设置 ·架构 · 故障排查 ·许可

长什么样

收起状态的刘海宠物

收起：标题和实时步骤贴在刘海两侧，下方一条细进度线。它从不给这条区域增加高度。

展开状态的刘海宠物

展开：最多两行标题、实时步骤、已用时间、Tasks 3/7、活跃智能体、会话的 token 用量与缓存命中、目标、模型，以及操作控件。

亮点

- 实时，不是装饰。 标题下那行文字对应 DSH 在助手消息下方显示的步骤：模型思考时是不断变化的推理预览，工具运行时是 Editing file · native/Sources/PetView.swift，右侧是本轮已用时间。它刻意避开已完成的助手回复。
- 有进度，但不编百分比。 DSH 有任务时用 todo_write 的完成度，没有任务时退回目标轮次。没有可计数的单位时，智能体干活期间进度条做不确定的微光流动，停下后冻结或消失。
- 会话的账单，不是猜的。 展开后的底栏读取与 DSH 自带 Usage 胶囊相同的、服务商上报的 tokenUsage 投影：累计计费输入加输出，旁边是缓存命中占比。没有估算器，也没有额外的模型调用。
- 该让路就让路。 打开 Only while working，没有任务运行时面板整体退场。菜单栏里由一枚爪印顶替，再一个开关连爪印也藏起来。固定显示会覆盖这一行为。
- **六种强调色，诚实的状 Iris、Sakura、Tangerine、Mint，外加自定义的色相/饱和度/亮度选择器。等待保持琥珀色，错误保持红色，完成的回合保持薄荷色。
- 为 macOS 而生。 一个非激活式 AppKit/SwiftUI 面板，没有 Dock 图标，不抢焦点，支持「减弱动态效果」，进度动画 60 fps。
- 天生本地。 宿主通过私有 Unix socket 与面板通信。无遥测，无网络请求，无账号。

环境要求

- macOS 14 Sonoma 或更新版本。
- DSH Desktop，或运行在 macOS 图形会话中的 DSH 宿主。
- Apple Silicon 或 Intel——内置辅助程序是通用二进制。
- 只有从源码重新构建辅助程序时，才需要 Xcode Command Line Tools。

不要求刘海屏 MacBook：在其他 Mac 上，面板浮在主显示器顶部中央，顶部两角为圆角。

安装

1. 在 DSH 中打开 Plugins，点击 Add plugin
2. 把插件名 dsh-notch-pet 粘贴到对话框中：
3. 确认。DSH 会拉取 bundle 并为你安装。

更喜欢用终端？同一个 bundle 也可以从公开仓库安装：

dsh plugin --profile web add github:hyzmm/dsh-notch-pet

web 是 DSH Desktop 的配置档；请保留你实际运行的配置档。

片刻之后，宠物会出现在显示器顶部。如果没有出现，请确认插件已在 Plugins 中启用，禁用它再重新启用，或重启 DSH。

安装包自带预构建的 ad-hoc 签名通用辅助程序，安装时不会编译任何东西。DSH 自己启动辅助程序；没有需要打开的应用。插件被禁用或 DSH 退出时，辅助程序随之停止。

操作

| 输入 | 结果 |
| 悬停面板 | 展开，指针在面板内时保持打开。 |
| 点击机器人 | 固定或取消固定面板。固定后的面板忽略悬停移出和 Only while working。 |
| 页脚齿轮 | 打开设置。 |
| 页脚 Pin / Open DSH | 固定面板，或聚焦 DSH（回退到 Web 源）。 |
| 右键点击面板 | 打开 DSH、固定或取消固定、打开设置，或退出。 |
| 菜单栏爪印 | 面板隐藏时出现：Settings、Open DSH、Only while working 开关，以及 Quit。 |
| 启动 | 探出约三秒，然后回到收起条。 |

宠物显示什么

哪个会话？

面板聚焦一个会话：有运行中的根会话时就用它，优先最近活跃的。如果只有子代理在运行，最近活跃的子代理占据焦点。运行中的子代理计入活跃智能体总数。

标题用 DSH 自己的会话标题，所以自动生成或用户改过的标题优先。第一句提示词是回退，再往后是工作区文件夹名。

实时行

窄行反映的是实时步骤，不是最终答案。模型思考时显示 Thinking · <latest reasoning>，由推理增量构建，裁剪成句对齐的预览，并持续变化。工具运行时则即 Editing file · native/Sources/PetView.swift、Running command · Build the native app 等。右侧的耗时是当前轮次的时长。

折叠条在硬件刘海下方有空间放两行紧凑文字，所以它显示会话标题加实时步骤。新信息占用刘海旁边的空白宽度，不增加高度。

进度

有 todo_write 列表时，进度条跟踪 Tasks 3/7。没有任务但有带轮次的目标时，它跟踪 Goal 2/6 rounds。两者都没有时，智能体忙碌期间它会变成不确定进度条。智能体空闲时，不确定进度条隐藏，任何确定进度条冻结，这样刘海不会一直闪。

Token 用量

展开后的页脚显示当前聚焦会话累计的、由服务商上报的 token —— 与 DSH 自己的 Usage 药丸背后是同一个 tokenUsage 投影 —— 格式为 21.9K tok · 94% hit。总量是计费输入（未缓存、缓存读取、缓存写入）加输出；hit 是提示词侧输入中缓存读取所占的比例，部分命中永远不会向上取整到 100%。悬停在读数上可查看精确明细。如果 dsh-token-meter 未挂载，宿主会退回到逐条折叠 assistant/message 的用量记录。

展开面板还会在页脚显示目标目的、最后的错误，或简短的状态提示。步骤文字本身不动；智能体工作时，加载弧和进度微光在动。

隐私

一切都留在你的 Mac 上。宿主把当前状态写入 ~/Library/Application Support/DSHNotchPet/ 下按进程区分的 Unix socket（0600），面板从中读取。插件不发起网络调用，不收集遥测，也不需要账号。

限制

- 仅支持 macOS；宿主部分在其他平台上是空操作。
- 一次只聚焦一个会话。子代理会计入活跃数，但面板不显示会话列表。
- 面板位于第一块带刘海的显示器上。它不会跟随 DSH 窗口移到另一块屏幕。
- 只有实时状态：没有历史，没有对话记录，也没有控制智能体的操作。宠物是查看器，不是控制器。

许可证

MIT © 2026 WengXiang。见 LICENSE。

Built with AppKit, SwiftUI, and a Unix socket.