dsh-jingle-notch
Verifieddsh-jingle-notch · v0.1.1 · MIT
JingleNotch — AI Agent Approval Notifier for DeepSeek Harness. 鲸铃 Jingle brings approvals, plan reviews and live session activity to the macOS notch.
Install
dsh plugin add dsh-jingle-notch Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
JingleNotch
让 AI Agent 的待办决策出现在 Mac 刘海
鲸铃 Jingle · macOS 刘海伴侣
AI Agent 工作时,JingleNotch 会把需要你决策的时刻带到 Mac 刘海:工具审批、计划审核和结构化问题都会由鲸铃 Jingle 提醒。你可以在浮窗中查看完整请求并直接回答,保持当前工作流连续进行。
JingleNotch 支持 DeepSeek Harness 桌面版和 Web 版,也提供相同能力的浏览器仪表盘。
快速开始
已安装 DeepSeek Harness 后,通过 npm 安装插件到对应的 profile。
macOS 桌面版
首次使用请先打开一次 DeepSeek Harness,再完全退出应用。运行:
'/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' \
plugin --profile desktop add dsh-jingle-notch
重新打开应用并保持插件启用,桌面 Host 启动时会自动打开鲸铃刘海浮窗。
Web 版
dsh plugin --profile web add dsh-jingle-notch
dsh web
启用插件后,Host 启动时会自动打开浮窗;也可在 Harness 的服务地址后访问 /jingle 使用浏览器面板。已经运行的 Web 服务需要重启。
桌面版和 Web 版分别安装到各自的 profile。原生浮窗需要 macOS 和图形桌面;插件会安装独立的 Electron runtime,让桌面 Host 可以启动浮窗,Web/源码 Host 可配置 Electron 路径或使用安装说明中的 npm 回退方案。详见安装说明。
插件功能
- 审批提醒:查看工具和原因,选择 Allow once、Deny 或 Always in this session。
- 完整计划审核:阅读完整计划和准确的审核选项,再决定 Agent 是否继续。
- 结构化问答:支持单选、多选和自由输入,一次提交整组问题;轮询期间保留草稿。
- 多会话总览:集中查看活跃会话、当前工具、工作区和并行调用,优先显示待处理请求。
- 文件活动预览:查看文件修改前后预览和增删行统计,快速了解 Agent 的改动。
- 原生 macOS 刘海界面:悬停查看概览,展开阅读详情,滚动浏览会话,新请求到达时自动聚焦。
- 浏览器仪表盘:访问
/jingle,在浏览器中查看状态、完成审批和问答。 - 本地运行:动画随包提供;插件无需额外模型请求,也不添加遥测服务。活动历史只保存数字统计,隐私与通知设置见配置说明。
- 声音与系统通知:审批、提问和任务完成时播放提示音,可分别开关并设置自定义声音。
- 鲸铃状态动画:待机、思考、执行、提醒、完成和错误状态使用随包提供的离线动画,支持减少动态效果。
运行效果


截图来自合成测试会话。鲸铃 Jingle 原始动画随插件打包,无需网络即可使用。
兼容版本
| 宿主 | 已验证版本 | 验证范围 |
|---|---|---|
| 官方 macOS 桌面版 | 0.2.1-rc.5 |
内置 CLI 安装、打包 Host、原生浮窗 |
| 正式发布 Web 版 | 0.2.1-rc.5 |
Web profile、仪表盘、原生浮窗 |
| 源码 Web 版 | 0.2.2-alpha.2 |
源码 Host、仪表盘、原生浮窗 |
插件清单声明兼容 0.2.1-rc.5 和 0.2.2-alpha.2。原生浮窗需要 macOS、图形桌面和 Electron。Electron 配置及其他安装方式见安装说明。
命令与配置
/jingle 查看鲸铃状态
profile 补丁中的配置 ID 是 jingle-notch。完整配置、存储位置和隐私开关见配置说明;测试、打包和 Desktop/Web 验证见开发与验证。
开发
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
npm pack --dry-run
反馈与贡献
欢迎通过 Issues 反馈问题或提出功能建议,也欢迎提交 Pull Request。报告问题时请附上 macOS、Harness 和插件版本、使用的 Desktop/Web profile,以及可复现步骤;日志和截图请先移除敏感信息。构建、测试和打包步骤见开发指南。
许可证与致谢
JingleNotch 使用 MIT 许可证。第三方版权和许可见 THIRD_PARTY_NOTICES.md。项目基于 DeepSeek Harness,README 展示和包元数据参考了 dsh-pet 与 dsh-market。鲸铃 Jingle 素材由项目作者提供,来源和校验值记录在素材说明。