dsh-update-plugin 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -6,15 +6,48 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-09-16
+
+Published to npm as `dsh-update-plugin@0.3.0`. This is the first release that
+actually ships the automatic-check and browser-notification work listed under
+`0.2.0` below — `0.2.0` itself was never published.
+
+### Added
+
+- Automatic update checks: on startup, hourly, daily or off, persisted in the
+  plugin config and restarted when the setting is saved.
+- Browser notification when a real update is available: sent once per target
+  version, with a notification-permission row and an enable button in the
+  settings page.
+- The **Send test reminder / 测试更新提醒** button now requests notification
+  permission and uses its own test copy, so it can be told apart from real
+  notifications.
+
+### Fixed
+
+- Screenshot references in `README.md` and `README.zh-CN.md`: three links pointed
+  at files that do not exist. They now use the current captures, and the
+  duplicate `plugin-zh.png` (byte-identical to `plugin-cn.png`) is gone.
+
+## [0.2.0] - 2026-09-13
+
+Not published to npm; its changes shipped in `0.3.0`.
+
 ### Added
 
-- **Send test reminder / 测试更新提醒** button in the settings page: opens the
-  sidebar tab, sends a browser notification (permission required) and shows the
-  update badge for 10 seconds, so the reminder can be verified without a real
-  release.
+- Automatic update checks: on startup, hourly, daily or off, persisted in the
+  plugin config and restarted when the setting is saved.
+- Browser notification when a real update is available: sent once per target
+  version, with a notification-permission row and an enable button in the
+  settings page.
+- The **Send test reminder / 测试更新提醒** button now requests notification
+  permission and uses its own test copy, so it can be told apart from real
+  notifications.
 
 ## [0.1.0] - 2026-09-12
 
+Published to npm as `dsh-update-plugin@0.1.0`.
+
 ### Added
 
 - **Settings → General** row titled **Check for Updates... / 检查更新**, registered

package/README.md

@@ -2,6 +2,9 @@
 
 English | [中文](README.zh-CN.md)
 
+[![npm](https://img.shields.io/npm/v/dsh-update-plugin.svg)](https://www.npmjs.com/package/dsh-update-plugin)
+[![Topic: dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-0f766e)](https://github.com/topics/dsh-plugin)
+
 A DSH Web plugin that adds **Check for Updates...** (「检查更新」in Chinese) to
 **Settings → General**, right next to Permission, Language, Appearance and Font
 Size.
@@ -15,14 +18,16 @@ The update logic is built into the plugin. It does **not** require Homebrew or a
 separately installed `dsh-update-all` script.
 
 ![Check for Updates... in Settings → General](assets/screenshots/general-en.webp)
+![Update reminder in the right sidebar](assets/screenshots/sidebar-en.png)
+![Check for Updates... page in Settings](assets/screenshots/plugin-en.png)
 
 ## Install
 
 ```bash
-# from npm (once published)
+# from npm
 dsh plugin --profile web add dsh-update-plugin
 
-# from a local checkout / this repository
+# from a local checkout (development)
 dsh plugin --profile web add /path/to/dsh-update-all/plugin
 ```
 
@@ -55,6 +60,10 @@ Then restart DSH Web, open **Settings → General**, and look for the
   sends a browser notification (permission required), and shows the update badge
   for 10 seconds so you can verify the reminder without a real release.
 - The row shows the current and newest versions plus the number of profiles.
+- **Automatic update checks** can run on startup, hourly or daily, or be turned
+  off; pick the interval in the settings page.
+- When a real update is available and browser notifications are allowed, the
+  plugin sends a notification once per new version.
 - **Check for updates** refreshes the status (it also refreshes after
   reconnecting).
 - **Update now** updates the CLI and then every profile with dependencies.

package/README.zh-CN.md

@@ -2,6 +2,9 @@
 
 [English](README.md) | 中文
 
+[![npm](https://img.shields.io/npm/v/dsh-update-plugin.svg)](https://www.npmjs.com/package/dsh-update-plugin)
+[![Topic: dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-0f766e)](https://github.com/topics/dsh-plugin)
+
 一个 DSH Web 插件，在 **设置 → 通用设置** 里加入一行「检查更新」，和权限、语言、
 外观、字号大小同级。
 
@@ -14,14 +17,16 @@
 `dsh-update-all` 脚本**。
 
 ![设置 → 通用设置里的「检查更新」](assets/screenshots/general-zh.webp)
+![右侧栏更新提醒](assets/screenshots/sidebar-cn.png)
+![设置 → 检查更新完整页面](assets/screenshots/plugin-cn.png)
 
 ## 安装
 
 ```bash
-# 从 npm 安装（发布之后）
+# 从 npm 安装
 dsh plugin --profile web add dsh-update-plugin
 
-# 从本仓库 / 本地目录安装
+# 本地开发 / 从本仓库安装
 dsh plugin --profile web add /path/to/dsh-update-all/plugin
 ```
 
@@ -49,6 +54,8 @@ dsh plugin --profile web add /path/to/dsh-update-all/plugin --config.minimum-rel
 - 状态卡片里有 **测试更新提醒** 按钮：会打开侧边栏 tab、发送浏览器通知
   （需要授权），并显示 10 秒的更新角标，方便验证提醒效果，不用等真实新版本。
 - 行内显示当前版本、最新版本和 profile 数量。
+- **自动检查**支持启动时 / 每小时 / 每天，也可以关闭；在设置页选择即可。
+- 发现真实新版本且浏览器通知已授权时，每个新版本只通知一次。
 - **检查更新**：刷新状态。
 - **立即更新**：先更新 CLI，再更新每个有依赖的 profile；更新前会自动把
   `package.json` / `pnpm-lock.yaml` 备份到 `~/.dsh/update-backups/`。

package/lib/client.js

@@ -112,8 +112,23 @@ window.__ModuleLoader__.load({
       testStop: "停止测试",
       testReminder: "测试提醒：发现可用更新（仅测试，不会真的更新）",
       testReminderMeta: "仅用于验证角标和提醒效果",
-      notificationTitle: "DSH 有可用更新",
-      notificationBody: "测试提醒：仅用于验证浏览器通知和角标（不会真的更新）",
+      testNotificationTitle: "DSH 有可用更新",
+      testNotificationBody: "测试提醒：仅用于验证浏览器通知和角标（不会真的更新）",
+      updateNotificationTitle: "DSH 有可用更新",
+      updateNotificationBody: "最新版本 {version}。打开 设置 → 通用设置 查看。",
+      notifications: "浏览器通知",
+      notificationHint: "有新版本时发送浏览器通知",
+      notificationGranted: "已允许",
+      notificationDefault: "未授权",
+      notificationDenied: "已拒绝",
+      notificationUnsupported: "当前环境不支持",
+      enableNotifications: "启用通知",
+      checkInterval: "自动检查",
+      checkIntervalHint: "启动时 / 每小时 / 每天，或关闭",
+      intervalStartup: "启动时",
+      intervalHourly: "每小时",
+      intervalDaily: "每天",
+      intervalOff: "关闭",
     };
 
     var EN = {
@@ -171,8 +186,23 @@ window.__ModuleLoader__.load({
       testStop: "Stop test",
       testReminder: "Test reminder: update available (test only, nothing is updated)",
       testReminderMeta: "Only used to verify the badge and reminder UI",
-      notificationTitle: "DSH update available",
-      notificationBody: "Test reminder: only verifying the browser notification and badge (nothing is updated)",
+      testNotificationTitle: "DSH update available",
+      testNotificationBody: "Test reminder: only verifying the browser notification and badge (nothing is updated)",
+      updateNotificationTitle: "DSH update available",
+      updateNotificationBody: "Version {version} is available. Open Settings → General to review.",
+      notifications: "Browser notifications",
+      notificationHint: "Notify me when a new version is available",
+      notificationGranted: "Allowed",
+      notificationDefault: "Not allowed yet",
+      notificationDenied: "Denied",
+      notificationUnsupported: "Not supported in this environment",
+      enableNotifications: "Enable notifications",
+      checkInterval: "Automatic check",
+      checkIntervalHint: "On startup / hourly / daily, or off",
+      intervalStartup: "On startup",
+      intervalHourly: "Hourly",
+      intervalDaily: "Daily",
+      intervalOff: "Off",
     };
 
     function injectStyle() {
@@ -233,24 +263,59 @@ window.__ModuleLoader__.load({
       }).then(parseJson);
     }
 
-    function sendBrowserNotification(t) {
-      try {
-        if (typeof Notification === "undefined") return;
-        var show = function () {
-          try {
-            new Notification(t("notificationTitle"), { body: t("notificationBody") });
-          } catch (error) {}
-        };
-        if (Notification.permission === "granted") {
-          show();
-        } else if (Notification.permission !== "denied") {
-          Notification.requestPermission()
-            .then(function (permission) {
-              if (permission === "granted") show();
-            })
-            .catch(function () {});
-        }
-      } catch (error) {}
+    function notificationsSupported() {
+      return typeof Notification !== "undefined";
+    }
+
+    function notificationPermission() {
+      if (notificationsSupported()) return Notification.permission;
+      return "unsupported";
+    }
+
+    function requestNotificationPermission() {
+      if (notificationsSupported()) {
+        return Notification.requestPermission().catch(function () {
+          return notificationPermission();
+        });
+      }
+      return Promise.resolve("unsupported");
+    }
+
+    function sendBrowserNotification(title, body) {
+      if (notificationsSupported()) {
+        try {
+          if (Notification.permission === "granted") {
+            var notice = new Notification(title, { body: body, tag: "dsh-update-plugin" });
+            notice.onclick = function () {
+              try {
+                window.focus();
+              } catch (error) {}
+            };
+            return true;
+          }
+        } catch (error) {}
+      }
+      return false;
+    }
+
+    function useNotificationPermission() {
+      var pair = React.useState(notificationPermission());
+      var permission = pair[0];
+      var setPermission = pair[1];
+      var request = React.useCallback(function () {
+        return requestNotificationPermission().then(function (next) {
+          setPermission(next);
+          return next;
+        });
+      }, [setPermission]);
+      return { permission: permission, request: request };
+    }
+
+    function notificationStatusText(t, permission) {
+      if (permission === "granted") return t("notificationGranted");
+      if (permission === "denied") return t("notificationDenied");
+      if (permission === "unsupported") return t("notificationUnsupported");
+      return t("notificationDefault");
     }
 
     function manualCommands(profileName) {
@@ -343,6 +408,69 @@ window.__ModuleLoader__.load({
       return Object.assign({}, data || {}, { updateAvailable: true, testReminder: true });
     }
 
+    var NOTIFIED_KEY = "dsh-update-plugin:notified-version";
+    var autoCheckTimer = null;
+
+    function readNotifiedVersion() {
+      if (typeof window === "undefined" || typeof window.localStorage === "undefined") return null;
+      try {
+        return window.localStorage.getItem(NOTIFIED_KEY);
+      } catch (error) {
+        return null;
+      }
+    }
+
+    function writeNotifiedVersion(version) {
+      if (typeof window === "undefined" || typeof window.localStorage === "undefined") return;
+      try {
+        window.localStorage.setItem(NOTIFIED_KEY, version);
+      } catch (error) {}
+    }
+
+    function stopAutoCheck() {
+      if (autoCheckTimer) {
+        clearInterval(autoCheckTimer);
+        autoCheckTimer = null;
+      }
+    }
+
+    function autoCheckDelay(config) {
+      if (config && config.checkInterval === "hourly") return 60 * 60 * 1000;
+      if (config && config.checkInterval === "daily") return 24 * 60 * 60 * 1000;
+      return 0;
+    }
+
+    function checkUpdatesAndNotify(t) {
+      if (testReminder.active) return;
+      getStatus(true)
+        .then(function (data) {
+          if (data && data.updateAvailable && data.targetVersion) {
+            if (testReminder.active) return;
+            var last = readNotifiedVersion();
+            if (last === data.targetVersion) return;
+            var sent = sendBrowserNotification(
+              t("updateNotificationTitle"),
+              t("updateNotificationBody", { version: data.targetVersion }),
+            );
+            if (sent) writeNotifiedVersion(data.targetVersion);
+          }
+        })
+        .catch(function () {});
+    }
+
+    function startAutoCheck(config, t) {
+      stopAutoCheck();
+      var current = config || {};
+      if (current.checkInterval === "off") return;
+      checkUpdatesAndNotify(t);
+      var delay = autoCheckDelay(current);
+      if (delay > 0) {
+        autoCheckTimer = setInterval(function () {
+          checkUpdatesAndNotify(t);
+        }, delay);
+      }
+    }
+
     function useUpdater(t) {
       var pair = React.useState({ loading: true, data: null, error: null });
       var state = pair[0];
@@ -578,7 +706,8 @@ window.__ModuleLoader__.load({
       var test = useTestReminder();
       var configState = useConfig(t);
       var backupsState = useBackups(t);
-      var draftPair = React.useState({ channel: "auto", minAge: 0 });
+      var notification = useNotificationPermission();
+      var draftPair = React.useState({ channel: "auto", minAge: 0, checkInterval: "startup" });
       var draft = draftPair[0];
       var setDraft = draftPair[1];
 
@@ -588,6 +717,7 @@ window.__ModuleLoader__.load({
             setDraft({
               channel: configState.state.config.channel || "auto",
               minAge: Number.isInteger(configState.state.config.minAge) ? configState.state.config.minAge : 0,
+              checkInterval: configState.state.config.checkInterval || "startup",
             });
           }
         },
@@ -612,6 +742,9 @@ window.__ModuleLoader__.load({
         configState.save({
           channel: draft.channel,
           minAge: Number(draft.minAge) || 0,
+          checkInterval: draft.checkInterval || "startup",
+        }).then(function (next) {
+          if (next) startAutoCheck(next, t);
         });
       }
 
@@ -681,7 +814,11 @@ window.__ModuleLoader__.load({
                           return;
                         }
                         if (typeof props.openSidebar === "function") props.openSidebar();
-                        sendBrowserNotification(t);
+                        requestNotificationPermission().then(function (permission) {
+                          if (permission === "granted") {
+                            sendBrowserNotification(t("testNotificationTitle"), t("testNotificationBody"));
+                          }
+                        });
                         setTestReminder(true, 10000);
                       },
                     },
@@ -727,7 +864,7 @@ window.__ModuleLoader__.load({
                     className: "dsu-select",
                     value: draft.channel,
                     onChange: function (event) {
-                      setDraft({ channel: event.target.value, minAge: draft.minAge });
+                      setDraft({ channel: event.target.value, minAge: draft.minAge, checkInterval: draft.checkInterval });
                     },
                   },
                   [
@@ -756,13 +893,67 @@ window.__ModuleLoader__.load({
                     step: 60,
                     value: draft.minAge,
                     onChange: function (event) {
-                      setDraft({ channel: draft.channel, minAge: Math.max(0, Number(event.target.value) || 0) });
+                      setDraft({ channel: draft.channel, minAge: Math.max(0, Number(event.target.value) || 0), checkInterval: draft.checkInterval });
                     },
                   }),
                   h("span", { className: "dsu-desc", key: "unit" }, t("minAgeUnit")),
                 ]),
               ],
             ),
+            h(
+              "div",
+              { className: "dsu-field", key: "check-interval" },
+              [
+                h("div", { className: "dsu-field-label", key: "label" }, [
+                  h("div", { className: "dsu-title", key: "t" }, t("checkInterval")),
+                  h("div", { className: "dsu-desc", key: "d" }, t("checkIntervalHint")),
+                ]),
+                h(
+                  "select",
+                  {
+                    key: "select",
+                    className: "dsu-select",
+                    value: draft.checkInterval,
+                    onChange: function (event) {
+                      setDraft({ channel: draft.channel, minAge: draft.minAge, checkInterval: event.target.value });
+                    },
+                  },
+                  [
+                    h("option", { key: "startup", value: "startup" }, t("intervalStartup")),
+                    h("option", { key: "hourly", value: "hourly" }, t("intervalHourly")),
+                    h("option", { key: "daily", value: "daily" }, t("intervalDaily")),
+                    h("option", { key: "off", value: "off" }, t("intervalOff")),
+                  ],
+                ),
+              ],
+            ),
+            h(
+              "div",
+              { className: "dsu-field", key: "notifications" },
+              [
+                h("div", { className: "dsu-field-label", key: "label" }, [
+                  h("div", { className: "dsu-title", key: "t" }, t("notifications")),
+                  h("div", { className: "dsu-desc", key: "d" }, t("notificationHint")),
+                ]),
+                h("div", { className: "dsu-control", key: "control" }, [
+                  h("span", { className: "dsu-desc", key: "status" }, notificationStatusText(t, notification.permission)),
+                  notification.permission === "granted" || notification.permission === "unsupported"
+                    ? null
+                    : h(
+                        "button",
+                        {
+                          key: "enable",
+                          type: "button",
+                          className: "dsu-btn",
+                          onClick: function () {
+                            notification.request();
+                          },
+                        },
+                        t("enableNotifications"),
+                      ),
+                ]),
+              ],
+            ),
             h(
               "div",
               { className: "dsu-control", key: "actions" },
@@ -963,6 +1154,33 @@ window.__ModuleLoader__.load({
         "dsh-update-plugin: dictionaries",
       );
 
+      var autoCheckDisposed = false;
+      ctx.effect(
+        function () {
+          var translate = function (key, params) {
+            return ctx.locale.bind(NS)(key, params);
+          };
+          getConfig()
+            .then(function (config) {
+              if (autoCheckDisposed) return;
+              if (config && config.checkInterval) {
+                startAutoCheck(config, translate);
+              } else {
+                startAutoCheck({ checkInterval: "startup" }, translate);
+              }
+            })
+            .catch(function () {
+              if (autoCheckDisposed) return;
+              startAutoCheck({ checkInterval: "startup" }, translate);
+            });
+          return function () {
+            autoCheckDisposed = true;
+            stopAutoCheck();
+          };
+        },
+        "dsh-update-plugin: automatic update check",
+      );
+
       var sidebarRight = null;
       ctx.inject(["sidebarRightTabs", "sidebarRight"], function (sideCtx) {
         sidebarRight = sideCtx.sidebarRight;

package/lib/update-core.js

@@ -20,8 +20,9 @@ export const CLI_TIMEOUT_MS = 10 * 60 * 1000;
 export const PROFILE_TIMEOUT_MS = 5 * 60 * 1000;
 
 export const CONFIG_FILENAME = "dsh-update-plugin.json";
-export const DEFAULT_CONFIG = { channel: "auto", minAge: 0 };
+export const DEFAULT_CONFIG = { channel: "auto", minAge: 0, checkInterval: "startup" };
 const CHANNELS = new Set(["auto", "stable", "next", "alpha"]);
+const CHECK_INTERVALS = new Set(["startup", "hourly", "daily", "off"]);
 
 export function normalizeConfig(raw) {
   const source = raw && typeof raw === "object" ? raw : {};
@@ -29,6 +30,11 @@ export function normalizeConfig(raw) {
   if (!CHANNELS.has(config.channel)) config.channel = DEFAULT_CONFIG.channel;
   const minAge = Number(config.minAge);
   config.minAge = Number.isInteger(minAge) && minAge >= 0 ? minAge : DEFAULT_CONFIG.minAge;
+  if (CHECK_INTERVALS.has(config.checkInterval)) {
+    // keep
+  } else {
+    config.checkInterval = DEFAULT_CONFIG.checkInterval;
+  }
   return config;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-update-plugin",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "DSH Web plugin: check and update DeepSeek Harness CLI and all profile plugins from Settings → General.",
   "license": "MIT",
   "repository": {