前言¶
在 DeepSeek Harness（DSH）里跑智能体时，进程常会停在工具审批、计划确认或结构化提问上。若你正专注在编辑器或终端里，切回 Harness 主界面才能点「允许 / 拒绝」，上下文容易被打断。JingleNotch（npm 包名 dsh-jingle-notch）把这类待决策事项推到 macOS 刘海区域，并提供浏览器面板，让你在不必离开当前工作区的情况下完成响应。下面介绍它是什么、能做什么，以及如何按官方步骤安装启用。
这是什么¶
JingleNotch 是面向 DeepSeek Harness 的 AI Agent Approval Notifier：鲸铃 Jingle 作为 macOS notch companion，在 Harness 因工具审批、计划审阅或结构化问题暂停时，把请求带到刘海 UI，并支持从浏览器仪表盘操作。
- 维护者：5ysy（GitHub：
5ysy/dsh-jingle-notch） - 分类：客户端（社区目录 SkillHub 插件页）
- 许可证：MIT（见仓库 LICENSE）
- 当前包版本（package.json）：
0.1.0 - 运行方式：与 DeepSeek Harness Desktop 和 Web 配合；同一套请求控件也可在专注的浏览器仪表盘中使用
插件以当前 DSH 进程权限运行；安装前请自行查看源码与许可证，确认符合你的环境与合规要求。
核心功能¶
以下能力均来自项目 README，未在资料中出现的细节不作延伸。
审批与决策
- 工具审批：可快速审阅工具调用，并选择 Allow once、Deny 或 Always in this session。
- 完整计划审阅：在智能体继续前阅读完整计划及精确的审批选项。
- 结构化提问：在同一表单中回答单选、多选与自由文本；轮询期间草稿可保留。
会话与文件活动
- 多会话感知：在紧凑的刘海视图中跟踪活跃会话、当前工具、工作区与并行调用。
- 可操作的文件活动：查看有界的前后预览，以及增删行数统计。
界面与本地运行
- 原生 macOS 刘海 UI：悬停概览、展开详情、滚动浏览会话，新请求仍可进入面板。
- 浏览器仪表盘：在 Harness 服务地址访问
/jingle，在浏览器中处理审批与提问。 - 本地运行：内置美术资源，不额外发起模型请求、不增加遥测服务；回顾历史仅存储数值聚合（隐私与通知开关见 configuration）。
- 铃声与系统通知：审批、提问与回合完成可告警，各项可单独开关并支持自定义音频。
- Jingle 角色状态：内置动画对应 idle、thinking、working、attention、finished、error 等状态，含 reduced-motion 海报。
兼容性¶
插件声明与下列 Harness 发行版兼容（README 兼容表）：
| Host | 已验证发行版 | 覆盖范围 |
|---|---|---|
| Official macOS Desktop | 0.2.1-rc.5 |
捆绑 CLI 安装、打包 Host、原生 overlay |
| Released Web | 0.2.1-rc.5 |
Web profile、仪表盘、原生 overlay |
| Source Web | 0.2.2-alpha.2 |
源码构建 Host、仪表盘、原生 overlay |
原生 overlay 需要 macOS、图形会话以及 Electron 可执行文件。Desktop 侧会安装独立 Electron runtime 以便 Desktop Host 启动 overlay；Web / 源码 Host 可配置 Electron 或使用文档中的 npm 回退方案，详见 installation.md。
安装与启用¶
前提：已安装 DeepSeek Harness。Desktop 与 Web 使用 独立的 profile，你用到哪种 Host，就在对应 profile 里安装一次。
macOS Desktop¶
先打开 DeepSeek Harness 完成初始化，再 完全退出 应用，然后在终端执行：
'/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' \
plugin --profile desktop add dsh-jingle-notch
重新打开应用并启用插件后，notch companion 会随 Desktop Host 自动启动。
Web¶
dsh plugin --profile web add dsh-jingle-notch
dsh web
若 Web 服务已在运行，安装后需重启。Host 启动且插件启用时 overlay 会自动起来；在 Harness 服务地址访问 /jingle 可打开浏览器面板。
典型用法¶
查看插件状态
Harness 内可用 slash 命令（README）：
/jingle Show JingleNotch status
配置项
profile 补丁行名为 jingle-notch。完整配置、存储路径与隐私控制见 docs/configuration.md。
npm 包
也可从 npm：dsh-jingle-notch 安装；Quick start 以 dsh plugin ... add dsh-jingle-notch 为准。
适用场景与注意¶
适合谁
- 在 macOS 上使用 DSH Desktop 或 Web，且希望工具审批、计划确认、结构化问答 常驻可见 的开发者。
- 需要 一眼看多会话、当前工具与并行调用，并在刘海或
/jingle面板里统一处理的场景。
务必注意
- 原生刘海 overlay 仅 macOS + 图形会话；非 macOS 或纯无头环境应依赖 Web 仪表盘
/jingle，并按要求配置 Electron（见 installation 文档）。 - 插件与 Harness 同进程权限运行；添加 npm 插件前请审查仓库源码与 MIT 许可证及 THIRD_PARTY_NOTICES.md。
- 社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；插件由社区维护者发布，非官方应用商店条目。
结尾¶
JingleNotch 把 DSH 暂停时的决策点从「切回主界面」变成刘海或浏览器上的即时操作，并附带多会话与文件活动概览，适合长时间在 macOS 上驱动智能体的用法。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库；问题与贡献见仓库 Issues 与 development.md。
