Overview
dsh-windows-notifier
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- **仅 Windows**:非 Windows 平台插件会安静地跳过,不会报错。 - **专注助手(Focus Assist)/「请勿打扰」会拦掉通知**:这是系统行为,插件无法绕过。 - **通知显示的应用名是「Windows PowerShell」**:因为用的是它现成的 AUMID,好处是零安装。想改成自己的名字,需要注册一个带 `AppUserModelID` 的开始菜单快捷方式,然后把 `appId` 指过去。 - **每条通知会短暂启动一个 `powershell.exe`**(约 0.3–1 秒)。对「一轮任务结束」这种频率完全够用;这也是它不需要任何依赖的代价。 - **必须在有 DSH 事件的前提下工作**:headless / sdk 这类最小 profile 如果不发这些事件,插件会挂载但不产生通知。headless 收尾时会话可能已经 detach,这种情况下插件仍按「完成」通知(`idle` 只会在状态变化时发布,所以它本身就意味着有东西跑完过)。 - **点击通知只能打开 GUI 首页**:DSH 的 Web GUI 把会话选择放在内存里,没有会话级路由,所以没有可深链的地址。`launchUrl` 里写 `{sessionId}` 会被替换,但目标页面目前不消费它。不想要这个跳转就把 `openOnClick` 关掉(patch 或界面里都行)。 - **横幅时长只有两档**:见上面配置项下的说明;`0` 是唯一能"无限等待"的值(`scenario="reminder"`)。 - **必须重启一次,界面上的配置页才会出现**(原因见「界面化配置」最后一条):浏览器半侧是在 DSH 启动时进入引导图的。 - **界面文案是它自己带的**:`src/client.js` 里注册了 `zh` / `en` 两本词典,跟界面语言走(侧栏那一项的名字也来自它)。schema 里的字段说明(`src/settings.js` 的 `LIVE_DESCRIPTIONS`)只有中文,但那一页是 Host 自动生成的表格 —— 本插件把它关掉了(`configure({ auto: false })`,DSH 自己的插件也这么写),所以实际显示的是这一页自己的文案。 - 通知不做「用户是否正在看这个会话」的判断 —— 前台会话结束同样会弹。
