dsh-plugin-session-notifier 0.1.0 → 0.1.2

package/README.en.md

@@ -46,10 +46,10 @@ The panel says so as well.
 **1. By package name (recommended).** Ask the agent to call:
 
 ```
-plugin_manager({ action: "install_bundle", target: "dsh-plugin-session-notifier@0.1.0" })
+plugin_manager({ action: "install_bundle", target: "dsh-plugin-session-notifier" })
 ```
 
-You can also type `dsh-plugin-session-notifier` into **Plugins → Add plugin** yourself. Pick the
+Omitting the version installs the latest one. You can also type `dsh-plugin-session-notifier` into **Plugins → Add plugin** yourself. Pick the
 China mainland registry mirror if you are there, it is much faster.
 
 **2. Local development:** `plugin_manager({ action: "install_bundle", target: "/absolute/path/dsh-plugin-session-notifier" })`.

package/README.md

@@ -1,4 +1,4 @@
-# 会话结束提醒 · Session Notifier
+# 会话提醒 · Session Notifier
 
 [English](README.en.md) | 中文
 
@@ -43,10 +43,10 @@ DeepSeek Harness 插件。会话跑完、出错，或者停下来等你回答（
 **一、按包名安装（推荐）**。让智能体调用：
 
 ```
-plugin_manager({ action: "install_bundle", target: "dsh-plugin-session-notifier@0.1.0" })
+plugin_manager({ action: "install_bundle", target: "dsh-plugin-session-notifier" })
 ```
 
-也可以自己在「插件 → 添加插件」里输入 `dsh-plugin-session-notifier`。
+不写版本号会装最新版。也可以自己在「插件 → 添加插件」里输入 `dsh-plugin-session-notifier`。
 安装源可选「中国大陆镜像源」，国内会快很多。
 
 **二、本地开发**：`plugin_manager({ action: "install_bundle", target: "/绝对路径/dsh-plugin-session-notifier" })`。

package/client.js

@@ -30,11 +30,13 @@ window.__ModuleLoader__.load({
     const RECENT_LIMIT = 12;
     /** Wait before reminding about the session the user is looking at. */
     const VIEWING_MERGE_MS = 1000;
+    /** Two reminders landing together share one tone instead of stacking two. */
+    const TONE_GAP_MS = 250;
 
     //#region copy
     const zh = {
       'panel.label': '会话提醒',
-      'panel.title': '会话结束提醒',
+      'panel.title': '会话提醒',
       'panel.desc':
         '会话跑完或停下来等你回答时，用桌面通知和提示音提醒你。切到别的窗口、全屏看视频或打游戏时也不会错过。',
       'group.master': '总开关',
@@ -104,8 +106,8 @@ window.__ModuleLoader__.load({
     };
 
     const en = {
-      'panel.label': 'Session alerts',
-      'panel.title': 'Session end notifier',
+      'panel.label': 'Session Notifier',
+      'panel.title': 'Session Notifier',
       'panel.desc':
         'A desktop notification and a short chime when a session finishes or stops to wait for you — so a task that ends while you are on another window is not missed.',
       'group.master': 'Master switch',
@@ -177,11 +179,11 @@ window.__ModuleLoader__.load({
 
     //#region settings
     /**
-     * Stored-document version. Version 1 shipped with `whenFocused: false` and a 5 s
-     * merge window; those two defaults changed, so a version-1 document is migrated
-     * instead of silently keeping the older values.
+     * Stored-document version, written with every save. Nothing reads it yet: the key
+     * was introduced with the current defaults, so no older document can exist. It is
+     * here so a future default change can migrate instead of guessing.
      */
-    const SETTINGS_VERSION = 2;
+    const SETTINGS_VERSION = 1;
 
     /** Merge-window choices, in milliseconds. */
     const COMBINE_CHOICES = [10000, 20000, 30000];
@@ -223,12 +225,6 @@ window.__ModuleLoader__.load({
         for (const key of Object.keys(DEFAULTS)) {
           if (typeof parsed[key] === typeof DEFAULTS[key]) next[key] = parsed[key];
         }
-        const version = typeof parsed.v === 'number' ? parsed.v : 1;
-        if (version < SETTINGS_VERSION) {
-          // The two defaults that changed; other stored choices stay as the user left them.
-          next.whenFocused = DEFAULTS.whenFocused;
-          next.combineMs = DEFAULTS.combineMs;
-        }
       } catch (_storageUnavailable) {
         // A blocked or corrupt store simply falls back to the defaults.
       }
@@ -287,8 +283,33 @@ window.__ModuleLoader__.load({
       /** Newest-first reminder log for the panel. */
       recent: [],
       recentListeners: new Set(),
+      /** Timers owned by one notification or tone, cleared with the plugin. */
+      timers: new Set(),
+      /** Wall-clock time of the last tone, so two reminders do not overlap. */
+      lastToneAt: 0,
     };
 
+    /**
+     * Run a callback later, keeping its timer id in the owned set.
+     * @param callback - work to run once.
+     * @param delay - delay in milliseconds.
+     * @returns the timer id.
+     */
+    function startTimer(callback, delay) {
+      const id = window.setTimeout(() => {
+        state.timers.delete(id);
+        callback();
+      }, delay);
+      state.timers.add(id);
+      return id;
+    }
+
+    /** Drop every timer this plugin started. */
+    function clearTimers() {
+      for (const id of state.timers) window.clearTimeout(id);
+      state.timers.clear();
+    }
+
     /** Faces assigned when they become available; every consumer tolerates absence. */
     const services = {
       sessions: null,
@@ -397,8 +418,13 @@ window.__ModuleLoader__.load({
      * Play the reminder tone for one kind of event.
      * @param kind - `done`, `awaiting`, `error`, or `test`.
      */
-    function chime(kind) {
+    function chime(kind, force) {
       if (!settings.sound) return;
+      const at = Date.now();
+      if (force !== true) {
+        if (at - state.lastToneAt < TONE_GAP_MS) return;
+        state.lastToneAt = at;
+      }
       const context = audioContext();
       if (context === null) return;
       if (context.state === 'suspended' && typeof context.resume === 'function') {
@@ -439,7 +465,7 @@ window.__ModuleLoader__.load({
         oscillator.start(start + offset);
         oscillator.stop(start + offset + duration + 0.03);
       }
-      window.setTimeout(() => {
+      startTimer(() => {
         try {
           master.disconnect();
         } catch (_disconnected) {
@@ -525,8 +551,8 @@ window.__ModuleLoader__.load({
           // Already gone.
         }
       };
-      window.setTimeout(() => settle('unconfirmed'), 2500);
-      window.setTimeout(() => {
+      startTimer(() => settle('unconfirmed'), 2500);
+      startTimer(() => {
         try {
           notification.close();
         } catch (_closed) {
@@ -657,7 +683,7 @@ window.__ModuleLoader__.load({
      */
     function runTestReminder() {
       primeAudio();
-      chime('test');
+      chime('test', true);
       publishProbe({ status: 'pending' });
       const delivery = notifyDesktop(
         'test',
@@ -1328,6 +1354,7 @@ window.__ModuleLoader__.load({
       ctx.effect(
         () => () => {
           cancelAll();
+          clearTimers();
         },
         'session-notifier: timers',
       );

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "Session End Notifier",
-    "description": "Raises a desktop notification and a short chime when a session finishes or waits for your answer, so you notice while you are away from the page."
+    "title": "Session Notifier",
+    "description": "A desktop notification and a short chime when a session finishes or stops to wait for you — so a task that ends while you are on another window is not missed."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "会话结束提醒",
-    "description": "会话跑完或停下来等你回答时，用桌面通知和提示音提醒你，切到别处也不会错过。"
+    "title": "会话提醒",
+    "description": "会话跑完或停下来等你回答时，用桌面通知和提示音提醒你。切到别的窗口、全屏看视频或打游戏时也不会错过。"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-session-notifier",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Desktop notification and a short chime when a DeepSeek Harness session finishes or stops to wait for your answer.",
   "type": "module",
   "exports": {