dsh-macos-notifier

DSH PLUGIN会话与消息

仓库 veritaswiki/dsh-macos-notifier · npm dsh-macos-notifier

会话与消息 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

DSH 插件:会话结束一轮时发出以会话名为标题的 macOS 通知,点击即可回到该会话,并附带应用内提示。

一句话选型结论

按资料字段整理

dsh-macos-notifier 是会话与消息类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类会话与消息 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-11 创建于 2026-11-10
README 8.5 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:veritaswiki/dsh-macos-notifier
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1,Node.js 要求 >=20;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求>=20来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-macos-notifier可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-macos-notifier:为 DeepSeek Harness 会话结束加上 macOS 通知

  • 会话结束发系统通知
  • 点击通知回到会话
  • 同一会话通知去重节流
  • 应用内提示兜底
  • 会话头部小铃铛测试

适用场景

通知

上游标签

cordisdeepseek-harnessdshdsh-pluginmacosnotification

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-12): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在会话与消息场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-macos-notifier当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
dsh-desktop L3 · 安装规范通过 低风险 3.0 万 未标注 无
openpets L4 · 沙盒安装通过 低风险 1,274 未标注 有
deeptide L4 · 沙盒安装通过 低风险 1,104 0.1.1-rc.2 有
jingyun-dsh L3 · 安装规范通过 低风险 1,004 未标注 有
study-mate 未做沙盒验证 未标注 856 未标注 无

仓库档案

会话与消息
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方veritaswiki仓库 dsh-macos-notifier · 默认分支 main
分类会话与消息desktop
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-10 · 2026-11-11最后推送 2026-11-11
本站收录2026-11-11首次进入本站目录的时间

README 全文

8.5 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-macos-notifier — 会话结束时的 macOS 通知

> 会话干完这一轮时给你一条标题为会话名的 macOS 通知,点一下回到那个会话。通知由 DSH 自己的渲染层发出:不起子进程、不调用 osascript、不写状态文件。

它做什么

  • 会话从「运行中」变成「已停止」时发一条 macOS 系统通知——onStatus() 只放行 prev === true && isRunning === false 这一条边沿,运行中途的状态抖动不弹。
  • 通知标题是会话名:取 sessions 快照里的 byId[id].title,读不到时回退 label,再读不到用 DSH。
  • 点通知回到那个会话:uiWorkspace.openSession(sessionId)。
  • 同一会话的通知互相替换,不堆成一列:tag 固定为 dsh-session-;同一会话 2 秒内不重复发(THROTTLE_MS = 2000)。
  • 系统通知之外必定再发一张应用内提示(同一个事件两路都发):前台 9 秒、后台 60 秒后自动消失,同屏最多 3 张。
  • 会话头部工具区有一个小铃铛:点一下发一条测试通知,用来确认通道通不通。
  • 子代理会话、带父会话的会话、空白会话不发通知(isNotifiable() 过滤)。

它怎么做

全部逻辑在 client.js,跑在 DSH 的渲染层里;index.js 是一个空的 no-op 插件。

环节 实现(client.js)
触发 ctx.get('remote').$on('api-session/status', (sessionId, isRunning) => …),交给 onStatus() 判断边沿
兜底轮询 remote.$on 不可用时退化为 setInterval(…, 800),比对快照里的 running 字段
会话过滤 isNotifiable() 跳过 origin === 'subagent'、带 parentSessionId、blank === true 的会话
标题 ctx.get('sessions') 快照的 byId[sessionId].title → 回退 label → 回退 'DSH'
系统通知 new Notification(title, { body, tag: 'dsh-session-' + sessionId, silent: false })
节流 THROTTLE_MS = 2000,按 sessionId 记时,窗口内直接返回 false
点击(主路径) n.onclick → ctx.get('uiWorkspace').openSession(sessionId)
点击(兜底) 发通知时把 sessionId 写进 localStorage['dsh.macos-notifier.pending'](PENDING_TTL_MS = 90000),window 的 focus 事件里 takePending() 补跳一次
应用内提示 命令式 DOM:document.body 上挂 [data-mn-layer] 容器,不经过 React 插槽,同屏最多 3 张
小铃铛 slots.inject('conversation.session.header.utilities', …),id: 'macos-notifier-action',order: 90
样式宿主 slots.inject('shell.overlay', …) 只注册一段 `,id: 'macos-notifier-style',order: 200`,随插件卸载移除
宿主侧 index.js 的 apply() 是空函数,只提供一行可启停的 Loader entry

因为通知和跳转在同一个渲染层里,点击时手里直接握着 sessionId:

  • 不起子进程:index.js 无 import,client.js 只用宿主提供的 require('react') 和浏览器的 Notification / DOM API;
  • 不调用 osascript,也就不会把通知归属到别的 App;
  • 不写状态文件,也不需要自定义 URL 协议。

安装

本插件是 DSH(Cordis)bundle,三种装法。

方式 A:让 Agent 用 plugin_manager 安装

在 DSH 里对 Agent 说「装 dsh-macos-notifier」,它会调 plugin_manager:

  • action: "install_bundle",target 填安装 spec:
  • 已 clone 到本地:file:/abs/path/to/dsh-macos-notifier
  • 或仓库:github:veritaswiki/dsh-macos-notifier
  • 装完 action: "set_bundle" 启用。

方式 B:手动挂到 profile

  1. 把仓库放在任意目录(下面记作 /abs/path/to/dsh-macos-notifier)。
  2. 编辑 profile 的 package.json(~/.dsh/profiles//package.json):
    - dependencies 里加 "dsh-macos-notifier": "link:/abs/path/to/dsh-macos-notifier"
    - dsh.profile.bundles 数组里加 "dsh-macos-notifier"
  3. 在 profile 目录安装依赖(DSH 下次启动时也会自行安装),然后重启 DSH。

方式 C:从源码

  1. git clone https://github.com/veritaswiki/dsh-macos-notifier.git 到任意目录。
  2. 同方式 B,只把依赖写成 "dsh-macos-notifier": "file:/abs/path/to/dsh-macos-notifier"。
  3. 重启 DSH。

依赖说明

client.js 只 require('react')(宿主提供),index.js 没有任何 import。因此本包没有需要单独安装的依赖,也不需要任何 @deepseek-ai/* 包;仓库不带 node_modules。

装完先开系统通知

系统设置 → 通知 → DeepSeek Harness → 打开「允许通知」,样式选「横幅」或「提醒」。没开之前系统横幅不会出现,此时只有应用内提示可见。

配置

本插件没有设置页:index.js 的 apply() 是空函数,没有 Config schema,所以没有任何能在 UI 里改的配置项。可调的东西只有下面这些代码常量与系统权限:

键 位置 类型 默认值 说明
THROTTLE_MS client.js number 2000 同一会话两条系统通知的最小间隔(毫秒)
PENDING_TTL_MS client.js number 90000 待跳转 sessionId 在 localStorage 里的有效期(毫秒)
PENDING_KEY client.js string 'dsh.macos-notifier.pending' 待跳转目标的 localStorage 键名
提示卡存活时间 client.js number 9000(前台)/ 60000(后台) 应用内提示自动消失的毫秒数
同屏提示卡上限 client.js number 3 超过就移除最早的一张
dsh.client.immediately package.json boolean true client 模块随宿主立即加载
dsh.bundle.patch package.json string ./cordis.patch.yml bundle 补丁入口
系统通知权限 系统设置 → 通知 → DeepSeek Harness 枚举 未授权 未授权时 systemNotify() 直接返回 false,不发横幅

已知限制

  • 仅 macOS 有意义:用的是渲染层的 Web Notification。在普通浏览器里打开同一个 Web GUI 时,通知由浏览器自己发、权限另算,插件不接管。
  • 系统通知未授权时没有横幅:systemNotify() 在 Notification.permission !== 'granted' 时直接返回 false,此时只剩应用内提示。
  • 首次授权要用户动手:权限只在点击小铃铛的手势里请求(页面加载时自动请求会被系统拒绝)。denied / default 时点铃铛打开的是系统通知设置,不是权限对话框。
  • 依赖宿主两个契约:事件名 api-session/status,以及 sessions 快照字段(byId[].title / label / running / origin / parentSessionId / blank)。宿主改事件名则退化为每 800 ms 轮询;改快照结构则不再触发。全程 try/catch,不抛错、不挡界面。
  • 补跳只有 90 秒窗口:点横幅若只把窗口拉到前台、没触发 onclick,靠 window 的 focus 事件补跳;超过 PENDING_TTL_MS 不再跳。
  • 不是通知中心:不保存历史、不分组、UI 里不可调;应用内提示固定盖在页面右下角(z-index: 2147483000)。
  • 节流写死:THROTTLE_MS = 2000 硬编码在 client.js,同一会话 2 秒内的第二次结束不会重复弹。

文件

文件 作用
package.json bundle 清单:dsh.bundle.patch + dsh.client(web,立即加载)
cordis.patch.yml 插入 macos-notifier Loader 行(insert.name 必须等于包名)
index.js Host 侧:空插件,只提供一行可启停的 Loader entry
client.js 客户端全部逻辑:状态边沿、系统通知、应用内提示、小铃铛
locale/zh.json、locale/en.json 插件管理页标题与描述
icon.svg 插件图标(DSH 内部用)
assets/icon-180.png 180×180 位图图标

开发

node --check index.js
node --check client.js
node scripts/sanitize-check.mjs

本仓库没有自动化测试(没有 test/ 目录,package.json 里也没有 test 脚本);CI 只跑语法检查与脱敏门禁两步。

scripts/sanitize-check.mjs 是脱敏门禁:本机绝对路径、私有包前缀、回环地址、私钥材料、内网地址段、内部主机名、token 前缀一律不许出现,命中即退出码 1。

License

MIT © 2026 veritaswiki

常见问题

9 问
答案由本站依据条目字段整理,不引用上游原文
dsh-macos-notifier 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:veritaswiki/dsh-macos-notifier` 即可。对应的 npm 包名是 `dsh-macos-notifier`。

dsh-macos-notifier 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-macos-notifier 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-macos-notifier 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-macos-notifier 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

dsh-macos-notifier 需要什么运行环境?

Node.js >=20。环境不满足时安装会失败,建议先确认本机版本。

dsh-macos-notifier 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-macos-notifier 有哪些功能?

会话结束发系统通知、点击通知回到会话、同一会话通知去重节流、应用内提示兜底、会话头部小铃铛测试。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

会话与消息
按星标排序,可作替代方案

dsh-desktop

dsh-desktop

为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。

L3 · 安装规范通过 3.0 万 星

openpets

openpets

L4 · 沙盒安装通过 1,274 星

deeptide

deeptide

L4 · 沙盒安装通过 1,104 星

jingyun-dsh

jingyun-dsh

井云 DSH 客户端插件,为 DeepSeek Harness 注入会员登录、订阅支付、算力管控与应用市场,让智能体和技能快速变成可交易商品

L3 · 安装规范通过 1,004 星

study-mate

study-mate

StudyMate 是 DSH 的「学习模式」预设与技能包,为数学、计算机科目定制学习路线、讲解课件与练习评估,跨科目共享记忆。

未标注验证等级 856 星

veritaswiki 的其它插件

3 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-12。