Skip to content

dsh-jingle-notch

Verified

dsh-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 的动态鲸鱼角色鲸铃 Jingle

JingleNotch

让 AI Agent 的待办决策出现在 Mac 刘海
鲸铃 Jingle · macOS 刘海伴侣

English · GitHub · npm

npm version MIT license macOS notch overlay

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,在浏览器中查看状态、完成审批和问答。
  • 本地运行:动画随包提供;插件无需额外模型请求,也不添加遥测服务。活动历史只保存数字统计,隐私与通知设置见配置说明。
  • 声音与系统通知:审批、提问和任务完成时播放提示音,可分别开关并设置自定义声音。
  • 鲸铃状态动画:待机、思考、执行、提醒、完成和错误状态使用随包提供的离线动画,支持减少动态效果。

运行效果

JingleNotch 多会话概览

JingleNotch 计划审核、结构化问答和工具审批

截图来自合成测试会话。鲸铃 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 素材由项目作者提供,来源和校验值记录在素材说明。