dsh-notify-tray 0.1.1 → 0.1.2

package/README.md

@@ -2,11 +2,11 @@
 
 **English** | [简体中文](README.zh-CN.md)
 
-A notification + status-bar plugin for DeepSeek Harness (DSH). Works on macOS, Windows and Linux.
+A notification + status-bar plugin for DeepSeek Harness (DSH). Works on macOS, Windows and Linux. It is one npm package that adapts to the OS it is installed on: macOS / Linux get notifications plus the status-bar whale; Windows has no status bar, so it gets notifications only, and its settings page shows no status-bar options.
 
 - **System notifications** — when a task finishes, fails, needs approval, needs you to pick an option, or waits for your input, you get a native notification written in the voice of a little whale (e.g. *"🐳 All done! 'Write the weekly report' is finished — come check it out"*). Clicking a notification jumps straight to the session.
-- **Status-bar whale** — a small whale lives in your status bar and tells you what's going on through its posture. The drop-down menu lists running tasks, items waiting for you, today's usage and recently finished tasks; click any entry to open that session.
-- **Settings page** — every option can be changed directly on the DSH **Plugins** page, including the API price of the model you're currently using and the plan you subscribe to (Kimi / GLM / OpenCode / MiMo / Gemini / Grok / Claude / GPT / MiniMax / DeepSeek or custom). Balance and remaining quota are fetched automatically where the provider exposes an API; anything else can be filled in by hand.
+- **Status-bar whale** (macOS / Linux) — a small whale lives in your status bar and tells you what's going on through its posture. The drop-down menu lists running tasks, items waiting for you, today's usage and recently finished tasks; click any entry to open that session.
+- **Settings page** — every option can be changed directly on the DSH **Plugins** page (only the options your OS can use are shown), including the API price of the model you're currently using and the plan you subscribe to (Kimi / GLM / OpenCode / MiMo / Gemini / Grok / Claude / GPT / MiniMax / DeepSeek or custom). Balance and remaining quota are fetched automatically where the provider exposes an API; anything else can be filled in by hand.
 
 ![The four whale states](assets/preview.svg)
 
@@ -17,7 +17,11 @@ A notification + status-bar plugin for DeepSeek Harness (DSH). Works on macOS, W
 | A `!` bubble | Something is waiting for you (approval / choice / input) |
 | A `×` bubble | A task just failed (shown for 10 minutes by default) |
 
-On macOS the whale is a menu-bar icon that follows the menu-bar colour, with a short label next to it such as `Pending 1` / `Running 2`. On Windows / Linux the state is colour-coded instead (🔵 idle / running, 🟠 waiting for you, 🔴 just failed). The Windows desktop app already ships its own tray icon, so the plugin doesn't add a second one there — it only provides notifications.
+| OS | Notifications | Status-bar whale | Status-bar options on the settings page |
+|---|---|---|---|
+| macOS | Notification Center | Menu-bar icon following the menu-bar colour, with a label such as `Pending 1` / `Running 2` | All (show/hide, label style, today's spend in the label, failure hold time) |
+| Linux (UOS / Deepin / Kylin / KDE …) | freedesktop notifications | System-tray icon, colour-coded (🔵 idle / running, 🟠 waiting for you, 🔴 just failed) | Show/hide, failure hold time |
+| Windows | Toast notifications | None (Windows has no status bar) | None |
 
 ## Installation
 
@@ -34,7 +38,7 @@ dsh plugin --profile desktop add dsh-notify-tray
 # Or the web / CLI profile
 dsh plugin --profile web add dsh-notify-tray
 # Pin a specific version
-dsh plugin --profile desktop add dsh-notify-tray@0.1.0
+dsh plugin --profile desktop add dsh-notify-tray@0.1.2
 ```
 
 **Option 3 — from the Git repository** (latest unreleased code)
@@ -43,7 +47,11 @@ Paste `https://github.com/ROYLeXJ/dsh-notify-tray.git` into **Plugins → Add pl
 
 This route **requires Git**; without it you'll see `ERR_PNPM_GIT_RESOLVE_FAILED … 'git' is not recognized as an internal or external command`. On Windows install Git from <https://git-scm.com/download/win> (the defaults are fine) and restart DSH; on macOS run `git --version` once in Terminal and follow the prompt to install the command-line tools.
 
-Restart DSH after installing. To update: `dsh plugin --profile desktop update dsh-notify-tray`. To uninstall: `dsh plugin --profile desktop remove dsh-notify-tray`.
+Restart DSH after installing. The version on the plugin page is the one installed; the latest is listed on [npm](https://www.npmjs.com/package/dsh-notify-tray).
+
+> **Got an older version?** When the official npm registry is unreachable, DSH falls back to the npmmirror registry, which syncs a little later, so a just-published release may not be there yet. Update again in a few minutes, or pin the version: `dsh plugin --profile desktop add dsh-notify-tray@0.1.2`.
+
+To update: `dsh plugin --profile desktop update dsh-notify-tray`. To uninstall: `dsh plugin --profile desktop remove dsh-notify-tray`.
 
 ## Configuration
 
@@ -69,10 +77,11 @@ Every option can be changed under DSH **Plugins → Whale Notify Station → Con
 | `notifyCompleted` / `notifyFailed` / `notifyApproval` / `notifyChoice` / `notifyInput` | all on | Toggle each of the five notification kinds |
 | `channel` | `auto` | `auto`: the DSH window shows the notification when one is open, otherwise the OS does |
 | `suppressWhenFocused` | `true` | Don't notify while you're looking at that session (switch to another app and you will be) |
-| `tray` | `true` | Show the status-bar icon (takes effect after a restart) |
+| `sound` | `true` | Play a sound with system notifications (macOS chime, Windows toast sound, Linux where the desktop supports it) |
+| `tray` | `true` | Show the status-bar icon (macOS / Linux, takes effect after a restart; ignored on Windows) |
 | `titleStyle` | `text` | What to show next to the whale in the macOS menu bar: `text` (Pending 1 / Running 2), `count` (numbers only), `icon` (whale only) |
 | `showSpendInTitle` | `false` | Append today's spend to the macOS menu-bar label |
-| `errorHoldMinutes` | `10` | How many minutes the icon stays red after a task fails |
+| `errorHoldMinutes` | `10` | How many minutes the icon stays red / shows the `×` after a task fails (macOS / Linux) |
 
 ### Spend & pricing
 
@@ -119,13 +128,13 @@ Built-in plan presets (prices are the list prices at the time of writing and may
 | GPT | ChatGPT Go / Plus / Pro 5x / Pro 20x / Business, API pay-as-you-go | No endpoint for regular keys |
 | MiniMax | M Plan Go / Explore / Build (CN ¥49 / 119 / 469, intl. $22 / 55 / 132), legacy Coding Plan | 5-hour window remaining `GET /v1/coding_plan/remains` |
 
-Anything that can't be fetched can be typed in by hand; empty fields are simply hidden. The status-bar menu gains a **Plan · name · price · remaining** row whose submenu shows balance, remaining quota, reset time, the raw details returned by the endpoint, a **Refresh quota** action and links to the usage / pricing pages.
+Anything that can't be fetched can be typed in by hand; empty fields are simply hidden. On macOS / Linux the status-bar menu gains a **Plan · name · price · remaining** row whose submenu shows balance, remaining quota, reset time, the raw details returned by the endpoint, a **Refresh quota** action and links to the usage / pricing pages.
 
 ## Notes
 
 - **When notifications fire** — a task that runs to completion counts as *completed*; an error, hitting the token limit or being blocked counts as *failed*; stopping a task yourself doesn't notify. For `ask_user_question`, questions with options and plan approvals count as *needs a choice*, questions without options as *needs input*; tool approvals count as *needs approval*. Only top-level sessions are tracked — sub-agents don't get their own notifications.
 - **How spend is computed** — when signed in with a DeepSeek account, today's spend is accumulated from drops in the account balance (top-ups don't count as negative spend; subject to the platform's billing delay). In parallel, it's estimated from each `provider/model` route's tokens × unit price (price sources described under `priceSource` above); the **Today's usage** submenu breaks it down per model. The ledger lives in `~/.dsh/storages/dsh-notify-tray/ledger.json` and keeps 31 days.
-- **Clicking the tray icon / a notification / "Open DeepSeek Harness" in the menu** — brings up the desktop app when there is one, otherwise (`dsh web`) opens the web UI in the browser. Browser notifications require granting notification permission first.
+- **Clicking a notification / the status-bar icon / "Open DeepSeek Harness" in the menu** — brings up the desktop app when there is one, otherwise (`dsh web`) opens the web UI in the browser. Browser notifications require granting notification permission first.
 
 ## Development
 

package/README.zh-CN.md

@@ -2,11 +2,11 @@
 
 [English](README.md) | **简体中文**
 
-DeepSeek Harness（DSH）的通知 + 状态栏插件，支持 macOS、Windows、Linux。
+DeepSeek Harness（DSH）的通知 + 状态栏插件，支持 macOS、Windows、Linux。同一个 npm 包，装上后按系统自动区分：macOS / Linux 有通知 + 状态栏小鲸鱼；Windows 没有状态栏，只有通知，设置页里也不会出现状态栏相关的选项。
 
 - **系统通知**：任务完成、任务失败、需要批准、需要你选择、需要你输入时弹系统通知，文案是小鲸鱼的口吻（比如「🐳 搞定啦～『写周报』做完了！快来验收」）。点击通知会跳到对应会话。
-- **状态栏小鲸鱼**：状态栏常驻一只小鲸鱼，用姿态告诉你现在的状态；下拉菜单里是正在运行的任务、等你处理的事项、今日用量和最近结束的任务，点一下就能跳到对应会话。
-- **插件设置页**：所有选项都能在 DSH「插件」页里直接改，包括当前模型的 API 价格和你买的套餐（Kimi / GLM / OpenCode / MiMo / Gemini / Grok / Claude / GPT / MiniMax / DeepSeek 或自定义），能从接口拿到的余额 / 剩余额度自动拿，拿不到的手填。
+- **状态栏小鲸鱼**（macOS / Linux）：状态栏常驻一只小鲸鱼，用姿态告诉你现在的状态；下拉菜单里是正在运行的任务、等你处理的事项、今日用量和最近结束的任务，点一下就能跳到对应会话。
+- **插件设置页**：所有选项都能在 DSH「插件」页里直接改（只显示当前系统用得上的选项），包括当前模型的 API 价格和你买的套餐（Kimi / GLM / OpenCode / MiMo / Gemini / Grok / Claude / GPT / MiniMax / DeepSeek 或自定义），能从接口拿到的余额 / 剩余额度自动拿，拿不到的手填。
 
 ![四种状态](assets/preview.svg)
 
@@ -17,7 +17,11 @@ DeepSeek Harness（DSH）的通知 + 状态栏插件，支持 macOS、Windows、
 | 鼻子前冒出 `!` | 有事等你处理（批准 / 选择 / 输入） |
 | 鼻子前冒出 `×` | 刚有任务失败（默认保持 10 分钟） |
 
-macOS 上鲸鱼是菜单栏图标，颜色自动跟随菜单栏，旁边显示 `待处理 1` / `运行中 2` 这样的文字；Windows / Linux 上用颜色区分状态（🔵 空闲/运行中、🟠 等你处理、🔴 刚失败）。Windows 桌面版自带托盘图标，插件不再额外加一个，只提供通知。
+| 系统 | 通知 | 状态栏小鲸鱼 | 设置页里的状态栏选项 |
+|---|---|---|---|
+| macOS | 系统通知中心 | 菜单栏图标，颜色跟随菜单栏，旁边显示 `待处理 1` / `运行中 2` | 全部（显示开关、旁边显示什么、带上今日花费、失败保持时间） |
+| Linux（UOS / Deepin / 麒麟 / KDE 等） | freedesktop 通知 | 系统托盘图标，用颜色区分状态（🔵 空闲/运行中、🟠 等你处理、🔴 刚失败） | 显示开关、失败保持时间 |
+| Windows | 系统通知（右下角弹窗） | 无（Windows 没有状态栏） | 无 |
 
 ## 安装
 
@@ -34,7 +38,7 @@ dsh plugin --profile desktop add dsh-notify-tray
 # 或者 Web / 命令行 profile
 dsh plugin --profile web add dsh-notify-tray
 # 指定版本
-dsh plugin --profile desktop add dsh-notify-tray@0.1.0
+dsh plugin --profile desktop add dsh-notify-tray@0.1.2
 ```
 
 **方式三：从 Git 仓库装**（想用还没发版的最新代码时）
@@ -43,7 +47,11 @@ dsh plugin --profile desktop add dsh-notify-tray@0.1.0
 
 这条路**需要本机装有 Git**，没有 Git 会报 `ERR_PNPM_GIT_RESOLVE_FAILED … 'git' 不是内部或外部命令`。Windows 先到 <https://git-scm.com/download/win> 下载安装（一路默认即可），装完重启 DSH；macOS 在终端里运行一次 `git --version`，按提示安装命令行工具即可。
 
-装好后重启 DSH。更新：`dsh plugin --profile desktop update dsh-notify-tray`。卸载：`dsh plugin --profile desktop remove dsh-notify-tray`。
+装好后重启 DSH。插件页上显示的版本号就是装上的版本，最新版见 [npm](https://www.npmjs.com/package/dsh-notify-tray)。
+
+> **装到的不是最新版？** 官方 npm 源连不上时，DSH 会退到 npmmirror（淘宝镜像）去装，镜像比官方源晚一点同步，刚发的新版可能还没到。等几分钟再更新，或指定版本 `dsh plugin --profile desktop add dsh-notify-tray@0.1.2`。
+
+更新：`dsh plugin --profile desktop update dsh-notify-tray`。卸载：`dsh plugin --profile desktop remove dsh-notify-tray`。
 
 ## 设置
 
@@ -69,10 +77,11 @@ dsh plugin --profile desktop add dsh-notify-tray@0.1.0
 | `notifyCompleted` / `notifyFailed` / `notifyApproval` / `notifyChoice` / `notifyInput` | 全部开启 | 分别控制五类通知 |
 | `channel` | `auto` | `auto`：有 DSH 窗口时由窗口弹，没有窗口时由系统弹 |
 | `suppressWhenFocused` | `true` | 你正在看这个会话时不弹通知（切到别的应用去就有了） |
-| `tray` | `true` | 是否显示状态栏图标（修改后重启生效） |
+| `sound` | `true` | 系统通知带提示音（macOS「叮」一声、Windows 通知音、Linux 视桌面环境而定） |
+| `tray` | `true` | 是否显示状态栏图标（macOS / Linux，修改后重启生效；Windows 忽略） |
 | `titleStyle` | `text` | macOS 菜单栏鲸鱼旁边显示什么：`text`（待处理 1 / 运行中 2）、`count`（只有数字）、`icon`（只有鲸鱼） |
 | `showSpendInTitle` | `false` | macOS 菜单栏文字里附带今日花费 |
-| `errorHoldMinutes` | `10` | 任务失败后图标保持红色的分钟数 |
+| `errorHoldMinutes` | `10` | 任务失败后图标保持红色 / 挂「×」的分钟数（macOS / Linux） |
 
 ### 花费与价格
 
@@ -119,13 +128,13 @@ dsh plugin --profile desktop add dsh-notify-tray@0.1.0
 | GPT | ChatGPT Go / Plus / Pro 5x / Pro 20x / Business、API 按量 | 普通 Key 无接口 |
 | MiniMax | M Plan Go / Explore / Build（国内 ¥49 / 119 / 469，国际 $22 / 55 / 132）、旧版 Coding Plan | 5 小时窗口剩余 `GET /v1/coding_plan/remains` |
 
-拿不到的信息就手填；留空也可以，留空的项不显示。状态栏菜单里会多一行「套餐 · 名称 · 价格 · 剩余」，子菜单里有余额、剩余额度、重置时间、接口返回的明细、「刷新额度」和用量页 / 价格页链接。
+拿不到的信息就手填；留空也可以，留空的项不显示。macOS / Linux 的状态栏菜单里会多一行「套餐 · 名称 · 价格 · 剩余」，子菜单里有余额、剩余额度、重置时间、接口返回的明细、「刷新额度」和用量页 / 价格页链接。
 
 ## 说明
 
 - **通知的触发时机**：任务跑完算「完成」；出错、超出 Token 上限、被拦截算「失败」；你自己点停止不弹通知。调用 `ask_user_question` 时，带选项的问题和计划审批算「需要选择」，不带选项的算「需要输入」；工具审批算「需要批准」。只跟踪顶层会话，子 agent 不单独弹通知。
 - **花费怎么算**：用 DeepSeek 账户登录时，按账户余额的下降累计当天花费（充值不算负花费，会受平台扣费延迟影响）；同时按当天各「provider/model」的 Token 乘以单价估算（单价来源见上面的 `priceSource`），「今日用量」子菜单里按模型分行显示。账本存在 `~/.dsh/storages/dsh-notify-tray/ledger.json`，保留 31 天。
-- **点击托盘图标 / 通知 / 菜单里的「打开 DeepSeek Harness」**：有桌面版时唤起桌面版，没有时（`dsh web`）在浏览器里打开 Web 界面。浏览器里的通知需要先允许通知权限。
+- **点击通知 / 状态栏图标 / 菜单里的「打开 DeepSeek Harness」**：有桌面版时唤起桌面版，没有时（`dsh web`）在浏览器里打开 Web 界面。浏览器里的通知需要先允许通知权限。
 
 ## 已知限制
 

package/lib/client.js

@@ -66,8 +66,44 @@ window.__ModuleLoader__.load({
       /** How often the page re-reads the host's live state (current model, plan quota). */
       const LIVE_MS = 5000
 
+      // ---- which OS this is --------------------------------------------------------
+      // The host reports `process.platform` in its state (authoritative: with
+      // `dsh web` the browser may run elsewhere); until that arrives the
+      // browser's own platform is the guess. Each OS only gets what it has:
+      // Windows has no status bar, so no status-bar section at all; only the
+      // macOS menu bar shows text beside the whale.
+      function normalizePlatform(p) {
+        if (p === 'darwin' || p === 'win32') return p
+        if (p === 'linux' || p === 'freebsd' || p === 'openbsd') return 'linux'
+        return undefined
+      }
+      function guessPlatform() {
+        try {
+          const nav = window.navigator || {}
+          const text = String((nav.userAgentData && nav.userAgentData.platform) || nav.platform || nav.userAgent || '')
+          // Mac first: "Darwin" contains "win".
+          if (/mac|iphone|ipad|darwin/iu.test(text)) return 'darwin'
+          if (/win/iu.test(text)) return 'win32'
+          if (/linux|x11|bsd|cros/iu.test(text)) return 'linux'
+        } catch (e) {}
+        return undefined
+      }
+      /** What each OS shows; an unknown OS shows everything. */
+      const FEATURES = {
+        darwin: { tray: true, menuBarTitle: true },
+        linux: { tray: true, menuBarTitle: false },
+        win32: { tray: false, menuBarTitle: false },
+      }
+      const ALL_FEATURES = { tray: true, menuBarTitle: true }
+      /** A translator that prefers `<key>_<platform>` when this page defines one. */
+      function platformT(t, platform) {
+        if (!platform) return t
+        return key => (zh[`${key}_${platform}`] !== undefined ? t(`${key}_${platform}`) : t(key))
+      }
+
       const zh = {
         summary: '小鲸鱼什么时候来找你、状态栏里显示什么、今天的花费怎么算、你在用哪家的套餐，都在这里调。',
+        summary_win32: '小鲸鱼什么时候来找你、今天的花费怎么算、你在用哪家的套餐，都在这里调。Windows 没有状态栏，小鲸鱼只用通知来找你。',
         sectionNotify: '什么时候来找你',
         sectionNotifyHint: '五种事情，每种都可以单独关掉。',
         notifyCompleted: '任务做完了',
@@ -91,10 +127,14 @@ window.__ModuleLoader__.load({
         suppressWhenFocused: '我正盯着这个会话时就别弹了',
         suppressWhenFocusedHint: '关掉后，哪怕你正看着它跑完也会弹一条。',
         sound: '带提示音',
-        soundHint: 'macOS 系统通道的「叮」一声。',
+        soundHint: '系统通知响一声。',
+        soundHint_darwin: 'macOS 系统通知的「叮」一声。',
+        soundHint_win32: 'Windows 系统通知（右下角弹窗）的提示音。',
+        soundHint_linux: '系统通知的提示音（要桌面环境支持）。',
         sectionTray: '状态栏里的小鲸鱼',
         tray: '显示状态栏小鲸鱼',
         trayHint: '改了要重启 DSH 才生效。',
+        trayHint_linux: '显示在系统托盘里（UOS / Deepin / 麒麟 / KDE 自带；GNOME 要装 AppIndicator 扩展）。改了要重启 DSH 才生效。',
         titleStyle: '鲸鱼旁边显示什么',
         titleText: '文字',
         titleCount: '只有数字',
@@ -104,6 +144,8 @@ window.__ModuleLoader__.load({
         showSpendInTitleHint: '例如「运行中 1 · ¥1.82」。',
         errorHoldMinutes: '失败后「×」保持几分钟',
         errorHoldMinutesHint: '0 表示任务一失败就只记在菜单里，鲸鱼脸上不挂「×」。',
+        errorHoldMinutes_linux: '失败后鲸鱼保持红色几分钟',
+        errorHoldMinutesHint_linux: '0 表示任务一失败就只记在菜单里，鲸鱼不变红。',
         sectionSpend: '今天花了多少钱',
         spendSource: '花费怎么算',
         spendAuto: '自动',
@@ -175,6 +217,7 @@ window.__ModuleLoader__.load({
         planQuotaUrlHint: '留空用预设地址。',
         planAutoQuota: '自动刷新',
         planAutoQuotaHint: '按下面的间隔定时查询，菜单里也能手动刷新。',
+        planAutoQuotaHint_win32: '按下面的间隔定时查询，也可以点下面的「立即刷新」。',
         quotaPollMinutes: '几分钟刷新一次',
         quotaPollMinutesHint: '',
         refreshNow: '立即刷新',
@@ -202,6 +245,7 @@ window.__ModuleLoader__.load({
       }
       const en = {
         summary: 'When the whale comes to find you, what the status bar shows, how today\'s spend is counted, and which plan you are on.',
+        summary_win32: 'When the whale comes to find you, how today\'s spend is counted, and which plan you are on. Windows has no status bar, so the whale reaches you through notifications only.',
         sectionNotify: 'When to notify you',
         sectionNotifyHint: 'Five kinds of events, each can be switched off.',
         notifyCompleted: 'A task finished',
@@ -225,10 +269,14 @@ window.__ModuleLoader__.load({
         suppressWhenFocused: 'Stay quiet while I am looking at that session',
         suppressWhenFocusedHint: 'Off: notify even when you watch it finish.',
         sound: 'Play a sound',
-        soundHint: 'The macOS system channel\'s chime.',
+        soundHint: 'System notifications make a sound.',
+        soundHint_darwin: 'The macOS notification chime.',
+        soundHint_win32: 'The Windows notification (toast) sound.',
+        soundHint_linux: 'The notification sound, where the desktop supports one.',
         sectionTray: 'The whale in the status bar',
         tray: 'Show the status-bar whale',
         trayHint: 'Takes effect after restarting DSH.',
+        trayHint_linux: 'Shown in the system tray (built into UOS / Deepin / Kylin / KDE; GNOME needs the AppIndicator extension). Takes effect after restarting DSH.',
         titleStyle: 'Text beside the whale',
         titleText: 'Words',
         titleCount: 'Count only',
@@ -238,6 +286,8 @@ window.__ModuleLoader__.load({
         showSpendInTitleHint: 'e.g. "运行中 1 · ¥1.82".',
         errorHoldMinutes: 'Minutes the "×" stays after a failure',
         errorHoldMinutesHint: '0: failures are only listed in the menu.',
+        errorHoldMinutes_linux: 'Minutes the whale stays red after a failure',
+        errorHoldMinutesHint_linux: '0: failures are only listed in the menu; the whale never turns red.',
         sectionSpend: 'Today\'s spend',
         spendSource: 'How spend is counted',
         spendAuto: 'Auto',
@@ -309,6 +359,7 @@ window.__ModuleLoader__.load({
         planQuotaUrlHint: 'Blank: preset URL.',
         planAutoQuota: 'Refresh automatically',
         planAutoQuotaHint: 'Polled at the interval below; the tray menu can refresh by hand too.',
+        planAutoQuotaHint_win32: 'Polled at the interval below; "Refresh now" below fetches by hand.',
         quotaPollMinutes: 'Refresh interval (minutes)',
         quotaPollMinutesHint: '',
         refreshNow: 'Refresh now',
@@ -398,7 +449,8 @@ window.__ModuleLoader__.load({
         return fetchJson(ROUTE + '?after=-2').then(body => { if (body) { live.state = body; publishLive() } }).catch(() => {})
       }
       // Test seam: lets a test drive the loaders without React effects.
-      exports.__settingsLive = { live, loadCatalog, loadState }
+      const currentPlatform = () => normalizePlatform(live.state && live.state.platform) || guessPlatform()
+      exports.__settingsLive = { live, loadCatalog, loadState, currentPlatform }
       function useLive() {
         const [, bump] = React.useState(0)
         React.useEffect(() => {
@@ -649,14 +701,16 @@ window.__ModuleLoader__.load({
       }
 
       function Page(props) {
-        if (props.view === 'summary') return props.t('summary')
+        if (props.view === 'summary') return platformT(props.t, currentPlatform())('summary')
         return h(FullPage, props)
       }
 
       function FullPage(props) {
-        const { t } = props
         const state = props.useNotifyTray(snapshot => snapshot)
         const liveData = useLive()
+        const platform = currentPlatform()
+        const features = (platform && FEATURES[platform]) || ALL_FEATURES
+        const t = platformT(props.t, platform)
         const disabled = !state.writable
         const common = { t, disabled, edit: props.edit, resetField: props.resetField }
         const f = state.fields
@@ -673,11 +727,11 @@ window.__ModuleLoader__.load({
           h(ChoiceRow, { name: 'channel', field: f.channel, hint: 'channelHint', ...common, options: [['auto', 'channelAuto'], ['client', 'channelClient'], ['system', 'channelSystem'], ['both', 'channelBoth'], ['off', 'channelOff']] }),
           toggle('suppressWhenFocused'),
           toggle('sound')),
-        h(Section, { title: t('sectionTray') },
+        features.tray ? h(Section, { title: t('sectionTray') },
           toggle('tray'),
-          h(ChoiceRow, { name: 'titleStyle', field: f.titleStyle, hint: 'titleStyleHint', ...common, options: [['text', 'titleText'], ['count', 'titleCount'], ['icon', 'titleIcon']] }),
-          toggle('showSpendInTitle'),
-          h('div', { style: { marginTop: 12 } }, h(NumberField, { name: 'errorHoldMinutes', field: f.errorHoldMinutes, ...common }))),
+          features.menuBarTitle ? h(ChoiceRow, { name: 'titleStyle', field: f.titleStyle, hint: 'titleStyleHint', ...common, options: [['text', 'titleText'], ['count', 'titleCount'], ['icon', 'titleIcon']] }) : null,
+          features.menuBarTitle ? toggle('showSpendInTitle') : null,
+          h('div', { style: { marginTop: 12 } }, h(NumberField, { name: 'errorHoldMinutes', field: f.errorHoldMinutes, ...common }))) : null,
         h(Section, { title: t('sectionSpend') },
           h(ChoiceRow, { name: 'spendSource', field: f.spendSource, hint: 'spendSourceHint', ...common, options: [['auto', 'spendAuto'], ['balance', 'spendBalance'], ['estimate', 'spendEstimate']] }),
           h(ChoiceRow, { name: 'currency', field: f.currency, ...common, options: [['CNY', 'CNY'], ['USD', 'USD']] }),

package/lib/index.js

@@ -9,7 +9,8 @@
  * - Knows the user's plan (Kimi / GLM / OpenCode / MiMo / Gemini / Grok /
  *   Claude / GPT / MiniMax / DeepSeek or custom), its price list, and
  *   polls the provider's quota endpoint when it has one and an API key.
- * - Drives a status-bar icon on macOS / Windows / Linux.
+ * - Drives a status-bar icon on macOS (menu bar) and Linux (StatusNotifierItem).
+ *   Windows has no status bar of the kind: there the plugin only notifies.
  * - Serves `GET notify-tray/state` (+ `/catalog`, `POST /refresh`) to the
  *   browser half, which shows native notifications from the DSH window and
  *   renders the settings page; when no window is polling, the host falls
@@ -24,7 +25,7 @@ import { buildView, DONE_HOLD_MS, TITLES } from './format.js'
 import { Ledger } from './ledger.js'
 import { describeRoute, loadPiCatalog, makeResolver } from './pricing.js'
 import { fetchQuota } from './quota.js'
-import { desktopHosted, openUrl, showApp, systemNotify } from './system.js'
+import { openUrl, showApp, systemNotify } from './system.js'
 import { startTray } from './tray/index.js'
 import { Tracker } from './tracker.js'
 import { speak } from './voice.js'
@@ -40,6 +41,8 @@ const REFRESH_PATH = '/notify-tray/refresh'
 const DSH_VERSION = '0.2.1-rc.2'
 /** A window that polled within this window counts as "listening". */
 const CLIENT_FRESH_MS = 8000
+/** Platforms with a status bar the whale can live in. */
+export const TRAY_PLATFORMS = new Set(['darwin', 'linux', 'freebsd'])
 const EVENT_SWITCH = {
   completed: 'notifyCompleted',
   failed: 'notifyFailed',
@@ -67,11 +70,11 @@ export const Config = z.object({
     z.const('client').description('只由 DSH 窗口弹'),
     z.const('system').description('只由系统弹（适合 dsh web / 命令行）'),
     z.const('both').description('两边都弹'),
-    z.const('off').description('不弹通知（只用状态栏）'),
+    z.const('off').description('不弹通知（macOS / Linux 上只看状态栏）'),
   ]).default('auto').description('通知通道').volatile(),
   suppressWhenFocused: z.boolean().default(true).description('正在看这个会话时不弹').volatile(),
-  sound: z.boolean().default(true).description('通知带提示音（macOS）').volatile(),
-  tray: z.boolean().default(true).description('显示状态栏图标（修改后重启 DSH 生效；Windows 桌面版自带托盘图标，不再另加）').volatile(),
+  sound: z.boolean().default(true).description('系统通知带提示音').volatile(),
+  tray: z.boolean().default(true).description('显示状态栏图标（macOS / Linux，修改后重启 DSH 生效；Windows 没有状态栏，忽略此项）').volatile(),
   titleStyle: z.union([
     z.const('text').description('文字：待处理 1 / 运行中 2'),
     z.const('count').description('只显示数字'),
@@ -217,10 +220,9 @@ export function apply(ctx, config) {
     }
   }
 
-  // The Windows desktop app already keeps a tray icon of its own; a second one
-  // next to it is not on. There, notifications are toasts and the icon is
-  // skipped; `dsh web` on Windows (no app icon) still gets the whale.
-  const trayWanted = cfg.tray && !(process.platform === 'win32' && desktopHosted())
+  // Windows has no status bar to live in (and the desktop app keeps a tray
+  // icon of its own): there the plugin is notifications only.
+  const trayWanted = cfg.tray && TRAY_PLATFORMS.has(process.platform)
   ctx.effect(() => {
     let disposed = false
     let started
@@ -259,9 +261,6 @@ export function apply(ctx, config) {
       title: said.title,
       body: said.body,
       sound: cfg.sound,
-      seq: event.seq,
-      action: `open:${event.sessionId}`,
-      tray,
       webOrigin,
       onClick: () => onAction(`open:${event.sessionId}`),
     }).then(ok => debug('system notify', ok)).catch(error => logger.warn('系统通知失败', error))
@@ -430,6 +429,8 @@ export function apply(ctx, config) {
         const enabled = Object.fromEntries(Object.entries(EVENT_SWITCH).map(([type, key]) => [type, Boolean(cfg[key])]))
         const body = {
           boot,
+          // The settings page shows only what this OS has (no status-bar section on Windows).
+          platform: process.platform,
           seq: tracker.seq,
           // A first poll (after = -1) only learns the cursor; history is never replayed.
           // Each event carries its wording, so the window shows exactly what the host would.

package/lib/system.js

@@ -77,7 +77,7 @@ function windowsToast(xml) {
 
 /**
  * Show one native notification.
- * @param {{title: string, body: string, sound?: boolean, onClick?: () => void, tray?: any, action?: string, seq?: number, webOrigin?: () => string | undefined}} n
+ * @param {{title: string, body: string, sound?: boolean, onClick?: () => void, webOrigin?: () => string | undefined}} n
  */
 export async function systemNotify(n) {
   if (process.platform === 'darwin') {
@@ -85,20 +85,16 @@ export async function systemNotify(n) {
     return run('/usr/bin/osascript', ['-e', `display notification ${as(n.body)} with title ${as(n.title)}${sound}`])
   }
   if (process.platform === 'win32') {
-    // With our own tray icon up (dsh web), its balloon is a toast that can open the exact session.
-    if (n.tray?.toast && n.tray.alive) {
-      await n.tray.toast({ seq: n.seq ?? Date.now(), title: n.title, body: n.body, action: n.action })
-      return true
-    }
-    // Otherwise (the desktop app, which has its own tray icon) a plain toast:
-    // clicking it launches dsh://open, which the app answers by focusing its window.
+    // A plain toast (Windows gets no status-bar whale): in the desktop app,
+    // clicking it launches dsh://open, which the app answers by focusing its
+    // window; under `dsh web` it opens the web GUI.
     const launch = desktopHosted() ? 'dsh://open' : safeOrigin(n.webOrigin)
     return windowsToast(toastXml({ title: n.title, body: n.body, launch, sound: n.sound !== false }))
   }
   // Linux / BSD: D-Bus first (clickable), notify-send as a fallback.
   try {
     const { linuxNotify } = await import('./tray/linux.js')
-    await linuxNotify({ title: n.title, body: n.body, onClick: n.onClick })
+    await linuxNotify({ title: n.title, body: n.body, sound: n.sound !== false, onClick: n.onClick })
     return true
   } catch {
     return run('notify-send', ['-a', 'DeepSeek Harness', n.title, n.body])

package/lib/tray/index.js

@@ -2,17 +2,15 @@
  * Tray front door: starts the right per-platform helper and feeds it views.
  *
  * - macOS:   `osascript -l JavaScript assets/tray-darwin.js` (NSStatusItem)
- * - Windows: `powershell -File assets/tray-win32.ps1` (WinForms NotifyIcon) —
- *            only for `dsh web`; the desktop app has a tray icon of its own
- *            and lib/index.js never asks for a second one there.
  * - Linux:   in-process StatusNotifierItem over D-Bus (lib/tray/linux.js)
+ * - Windows: none. Windows has no status bar of this kind (and the desktop
+ *            app keeps a tray icon of its own); lib/index.js never asks.
  *
- * The two child-process helpers read the whale geometry from icon.json once,
- * then an atomically rewritten view.json for state, and report menu clicks as
- * JSON lines on stdout. They also watch the host pid, so a crashed host never
- * leaves an orphan icon behind. `{"quit": true}` in the view asks a helper to
- * take its icon down and exit on its own (on Windows a killed process leaves
- * a ghost icon in the notification area until the mouse passes over it).
+ * The macOS helper reads the whale geometry from icon.json once, then an
+ * atomically rewritten view.json for state, and reports menu clicks as JSON
+ * lines on stdout. It also watches the host pid, so a crashed host never
+ * leaves an orphan icon behind. `{"quit": true}` in the view asks it to take
+ * its icon down and exit on its own.
  */
 import { spawn } from 'node:child_process'
 import { mkdir, rename, writeFile } from 'node:fs/promises'
@@ -31,21 +29,14 @@ function helperCommand(viewFile) {
   if (process.platform === 'darwin') {
     return ['/usr/bin/osascript', ['-l', 'JavaScript', join(ASSETS, 'tray-darwin.js'), viewFile, pid]]
   }
-  if (process.platform === 'win32') {
-    const root = process.env.SystemRoot ?? 'C:\\Windows'
-    const ps = join(root, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe')
-    return [ps, ['-NoProfile', '-NonInteractive', '-STA', '-ExecutionPolicy', 'Bypass', '-WindowStyle', 'Hidden',
-      '-File', join(ASSETS, 'tray-win32.ps1'), viewFile, pid]]
-  }
   return undefined
 }
 
 const sleep = ms => new Promise(resolve => setTimeout(resolve, ms))
 
 /**
- * Replace `file` with `tmp`. On Windows the helper reads view.json without
- * FILE_SHARE_DELETE, so a rename that lands during its read fails with
- * EPERM/EBUSY; the read takes well under a millisecond, so just try again.
+ * Replace `file` with `tmp`, retrying the transient EPERM/EBUSY a rename can
+ * hit while the helper has the file open for its (sub-millisecond) read.
  */
 async function replaceFile(tmp, file) {
   for (let attempt = 0; ; attempt += 1) {
@@ -70,7 +61,7 @@ export async function startTray({ stateDir, icon, onAction, logger }) {
   if (process.platform === 'linux' || process.platform === 'freebsd') {
     const { startLinuxTray } = await import('./linux.js')
     const tray = await startLinuxTray({ onAction, logger })
-    return { ...tray, kind: 'sni', toast: undefined, get alive() { return true } }
+    return { ...tray, kind: 'sni', get alive() { return true } }
   }
 
   const viewFile = join(stateDir, 'view.json')
@@ -133,12 +124,8 @@ export async function startTray({ stateDir, icon, onAction, logger }) {
   return {
     kind: process.platform,
     update(view) {
-      return write({ ...view, toast: lastView?.toast })
+      return write(view)
     },
-    /** Windows only: show a balloon/toast through the tray icon. */
-    toast: process.platform === 'win32'
-      ? (toast) => (child ? write({ ...lastView, toast }) : undefined)
-      : undefined,
     get alive() { return child !== undefined },
     async stop() {
       stopped = true

package/lib/tray/linux.js

@@ -306,7 +306,7 @@ export async function startLinuxTray({ onAction, logger }) {
 const notifyActions = new Map()
 
 /** Show one freedesktop notification; `onClick` runs when its default action is invoked. */
-export async function linuxNotify({ title, body, onClick }) {
+export async function linuxNotify({ title, body, sound = true, onClick }) {
   const link = await connect()
   const { dbus, bus } = link
   if (!link.notifications) {
@@ -321,6 +321,9 @@ export async function linuxNotify({ title, body, onClick }) {
   }
   const iface = link.notifications
   const hints = { urgency: new dbus.Variant('y', 1), 'desktop-entry': new dbus.Variant('s', 'deepseek-harness') }
+  // freedesktop sound-naming spec; servers that play sounds honour these hints.
+  if (sound) hints['sound-name'] = new dbus.Variant('s', 'message-new-instant')
+  else hints['suppress-sound'] = new dbus.Variant('b', true)
   const id = await iface.Notify('DeepSeek Harness', 0, 'dialog-information', title, body, ['default', '打开'], hints, -1)
   if (onClick) notifyActions.set(id, onClick)
   return id

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Whale Notify Station",
-    "description": "(Click to open the detailed settings) A plump blue whale girl lives in your status bar: when a task finishes, needs a choice, or waits for your words, she blows bubbles and pops a notification — and keeps today's spend in mind for you."
+    "description": "(Click to open the detailed settings) A plump blue whale girl: when a task finishes, needs a choice, or waits for your words, she blows bubbles and pops a notification — and keeps today's spend in mind for you. On macOS / Linux she also lives in your status bar; Windows has no status bar, so there she only notifies."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "小鲸鱼通知站",
-    "description": "（点击可进行详细设置）一只蓝色的大肥鲸鱼娘常驻你的状态栏：任务做完、要你选一个、等你写几个字的时候，她会冒着泡泡弹通知来找你～ 顺便帮你记着今天花了多少钱。"
+    "description": "（点击可进行详细设置）一只蓝色的大肥鲸鱼娘：任务做完、要你选一个、等你写几个字的时候，她会冒着泡泡弹通知来找你～ 顺便帮你记着今天花了多少钱。macOS / Linux 上她还会常驻状态栏；Windows 没有状态栏，只弹通知。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-notify-tray",
-  "version": "0.1.1",
-  "description": "DeepSeek Harness 通知 + 状态栏插件：任务完成、需要输入、需要选择时弹系统通知；在 macOS / Windows / Linux（含 UOS、Deepin、麒麟）状态栏常驻小图标，显示任务进度与花费。",
+  "version": "0.1.2",
+  "description": "DeepSeek Harness 通知 + 状态栏插件：任务完成、需要输入、需要选择时弹系统通知（macOS / Windows / Linux）；macOS 与 Linux（含 UOS、Deepin、麒麟）状态栏常驻小图标，显示任务进度与花费。Windows 没有状态栏，只弹通知。",
   "keywords": [
     "deepseek",
     "deepseek-harness",

package/assets/tray-win32.ps1

@@ -1,276 +0,0 @@
-# Windows notification-area helper for dsh-notify-tray.
-# Runs on the stock Windows PowerShell 5.1 (WinForms NotifyIcon); no binary to ship.
-#
-# Usage: powershell -NoProfile -STA -ExecutionPolicy Bypass -File tray-win32.ps1 <view.json> <host pid>
-# The host rewrites view.json atomically; this script polls it. Menu clicks and
-# balloon clicks are written to stdout as one JSON line each: {"action":"<id>"}.
-param(
-  [Parameter(Mandatory = $true)][string]$ViewPath,
-  [int]$HostPid = 0
-)
-
-$ErrorActionPreference = 'Stop'
-Add-Type -AssemblyName System.Windows.Forms
-Add-Type -AssemblyName System.Drawing
-Add-Type -Namespace 'DshTray' -Name 'Win32' -MemberDefinition @'
-[DllImport("user32.dll")] public static extern bool DestroyIcon(IntPtr handle);
-[DllImport("user32.dll")] public static extern bool SetProcessDPIAware();
-'@
-# Declare (system) DPI awareness before the first window handle exists, so
-# SmallIconSize reports the real, scaled tray icon size and the whale is drawn
-# at that size instead of being stretched blurry on 125-200 % displays.
-try { [void][DshTray.Win32]::SetProcessDPIAware() } catch {}
-[System.Windows.Forms.Application]::EnableVisualStyles()
-
-$utf8 = New-Object System.Text.UTF8Encoding($false)
-[Console]::OutputEncoding = $utf8
-$stdout = [Console]::Out
-
-function Send-Action([string]$Id) {
-  $line = (@{ action = $Id } | ConvertTo-Json -Compress)
-  $stdout.WriteLine($line)
-  $stdout.Flush()
-}
-
-# The icon is the whale from lib/whale.js, shipped as bezier paths in icon.json
-# next to view.json (one frame list per state, plus fps / loop) and drawn here
-# with GDI+ in the state colour.
-$script:iconSpec = $null
-$script:iconCache = @{}
-
-function Read-IconSpec {
-  $path = Join-Path (Split-Path -Parent $ViewPath) 'icon.json'
-  if (-not (Test-Path -LiteralPath $path)) { return $null }
-  try { return ([System.IO.File]::ReadAllText($path, $utf8) | ConvertFrom-Json) } catch { return $null }
-}
-
-function New-WhalePath($Paths, $Spec, [int]$W, [int]$H) {
-  $path = New-Object System.Drawing.Drawing2D.GraphicsPath
-  $path.FillMode = [System.Drawing.Drawing2D.FillMode]::Winding
-  $b = $Spec.bounds
-  if ($null -eq $b) { $b = @{ x = 0; y = 0; w = $Spec.box; h = $Spec.box } }
-  $s = [Math]::Min($W / [double]$b.w, $H / [double]$b.h)
-  $ox = ($W - $b.w * $s) / 2
-  $oy = ($H - $b.h * $s) / 2
-  foreach ($sub in $Paths) {
-    $cur = $null
-    $path.StartFigure()
-    foreach ($cmd in $sub) {
-      switch ($cmd[0]) {
-        'M' { $cur = New-Object System.Drawing.PointF(($ox + ($cmd[1] - $b.x) * $s), ($oy + ($cmd[2] - $b.y) * $s)) }
-        'L' {
-          $to = New-Object System.Drawing.PointF(($ox + ($cmd[1] - $b.x) * $s), ($oy + ($cmd[2] - $b.y) * $s))
-          $path.AddLine($cur, $to); $cur = $to
-        }
-        'C' {
-          $c1 = New-Object System.Drawing.PointF(($ox + ($cmd[1] - $b.x) * $s), ($oy + ($cmd[2] - $b.y) * $s))
-          $c2 = New-Object System.Drawing.PointF(($ox + ($cmd[3] - $b.x) * $s), ($oy + ($cmd[4] - $b.y) * $s))
-          $to = New-Object System.Drawing.PointF(($ox + ($cmd[5] - $b.x) * $s), ($oy + ($cmd[6] - $b.y) * $s))
-          $path.AddBezier($cur, $c1, $c2, $to); $cur = $to
-        }
-        'Z' { $path.CloseFigure() }
-      }
-    }
-  }
-  return $path
-}
-
-function New-StateIcon([string]$State, [int]$Frame) {
-  $size = [System.Windows.Forms.SystemInformation]::SmallIconSize.Width
-  if ($size -lt 16) { $size = 16 }
-  $spec = $script:iconSpec
-  $bmp = New-Object System.Drawing.Bitmap($size, $size)
-  $g = [System.Drawing.Graphics]::FromImage($bmp)
-  $g.SmoothingMode = [System.Drawing.Drawing2D.SmoothingMode]::AntiAlias
-  $g.Clear([System.Drawing.Color]::Transparent)
-  $rgb = $null
-  if ($spec -and $spec.rgb.$State) { $rgb = $spec.rgb.$State }
-  if ($null -eq $rgb) { $rgb = @(59, 83, 170) }
-  $brush = New-Object System.Drawing.SolidBrush([System.Drawing.Color]::FromArgb(255, [int]$rgb[0], [int]$rgb[1], [int]$rgb[2]))
-  if ($spec -and $spec.frames.$State) {
-    $frames = $spec.frames.$State
-    $paths = $frames[$Frame % $frames.Count]
-    $path = New-WhalePath $paths $spec $size $size
-    $g.FillPath($brush, $path)
-    $path.Dispose()
-  } else {
-    # No geometry yet (first view): a plain disc keeps the icon visible.
-    $g.FillEllipse($brush, 1, 1, $size - 3, $size - 3)
-  }
-  $brush.Dispose()
-  $g.Dispose()
-  $handle = $bmp.GetHicon()
-  $icon = [System.Drawing.Icon]::FromHandle($handle).Clone()
-  [void][DshTray.Win32]::DestroyIcon($handle)
-  $bmp.Dispose()
-  return $icon
-}
-
-function Get-StateIcon([string]$State, [int]$Frame) {
-  $key = "$State`:$Frame"
-  if (-not $script:iconCache.ContainsKey($key)) { $script:iconCache[$key] = New-StateIcon $State $Frame }
-  return $script:iconCache[$key]
-}
-
-$script:iconSpec = Read-IconSpec
-$notify = New-Object System.Windows.Forms.NotifyIcon
-$notify.Text = 'DeepSeek Harness'
-$notify.Icon = Get-StateIcon 'idle' 0
-$notify.Visible = $true
-$menu = New-Object System.Windows.Forms.ContextMenuStrip
-$notify.ContextMenuStrip = $menu
-$script:balloonAction = $null
-
-$notify.add_MouseClick({
-  param($sender, $e)
-  if ($e.Button -eq [System.Windows.Forms.MouseButtons]::Left) { Send-Action 'show-app' }
-})
-$notify.add_BalloonTipClicked({
-  if ($script:balloonAction) { Send-Action $script:balloonAction }
-})
-
-$menuClick = {
-  param($sender, $e)
-  $id = [string]$sender.Tag
-  if ($id -eq '') { return }
-  Send-Action $id
-  if ($id -eq 'hide-tray') { $notify.Visible = $false; [System.Windows.Forms.Application]::Exit() }
-}
-
-function Add-MenuRows($items, $rows) {
-  foreach ($row in $rows) {
-    if ($row.separator) {
-      [void]$items.Add((New-Object System.Windows.Forms.ToolStripSeparator))
-      continue
-    }
-    $mi = New-Object System.Windows.Forms.ToolStripMenuItem(([string]$row.label).Replace('&', '&&'))
-    if ($row.children -and $row.children.Count -gt 0) {
-      Add-MenuRows $mi.DropDownItems $row.children
-    } else {
-      $mi.Tag = $row.id
-      if ($row.enabled -eq $false) { $mi.Enabled = $false }
-      $mi.add_Click($menuClick)
-    }
-    [void]$items.Add($mi)
-  }
-}
-
-$script:pendingMenu = $null
-function Set-Menu($rows) {
-  # Rebuilding the strip while it is open would yank it out from under the
-  # pointer (views refresh every few seconds while a task runs): defer instead.
-  if ($menu.Visible) { $script:pendingMenu = @{ rows = $rows }; return }
-  $script:pendingMenu = $null
-  $menu.Items.Clear()
-  Add-MenuRows $menu.Items $rows
-}
-$menu.add_Closed({
-  if ($script:pendingMenu) { Set-Menu $script:pendingMenu.rows }
-})
-
-$script:lastStamp = ''
-$script:lastToast = [long]0
-$script:state = ''
-$script:frame = 0
-$script:frameCount = 1
-$script:fps = 1
-$script:loop = $false
-$script:clock = 0.0
-
-function Update-FromView {
-  if (-not (Test-Path -LiteralPath $ViewPath)) { return }
-  $info = Get-Item -LiteralPath $ViewPath
-  $stamp = "$($info.LastWriteTimeUtc.Ticks):$($info.Length)"
-  if ($stamp -eq $script:lastStamp) { return }
-  $script:lastStamp = $stamp
-  try {
-    $view = [System.IO.File]::ReadAllText($ViewPath, $utf8) | ConvertFrom-Json
-  } catch { return }
-
-  if ($view.quit) {
-    # The host is shutting the icon down: leave cleanly instead of being killed
-    # (a terminated process leaves a ghost icon until the mouse passes over it).
-    $notify.Visible = $false
-    [System.Windows.Forms.Application]::Exit()
-    return
-  }
-  if ($view.icon) { $script:iconSpec = $view.icon; $script:iconCache = @{} }
-  if ($null -eq $script:iconSpec) {
-    $script:iconSpec = Read-IconSpec
-    # Anything drawn before the geometry arrived was a placeholder disc.
-    if ($script:iconSpec) { $script:iconCache = @{}; $script:state = '' }
-  }
-  $state = [string]$view.state
-  if ($state -ne $script:state) {
-    # A new state restarts its animation; the same state keeps playing.
-    $script:state = $state
-    $script:frame = 0
-    $script:clock = 0.0
-    $script:frameCount = 1
-    $script:fps = 1
-    $script:loop = $false
-    if ($script:iconSpec -and $script:iconSpec.frames.$state) {
-      $script:frameCount = @($script:iconSpec.frames.$state).Count
-      $anim = $script:iconSpec.anim.$state
-      if ($anim) { $script:fps = [double]$anim.fps; $script:loop = [bool]$anim.loop }
-    }
-    $notify.Icon = Get-StateIcon $state 0
-  }
-  # .NET Framework caps NotifyIcon.Text at 63 characters: keep whole lines,
-  # dropping from the bottom, rather than cutting a line in half.
-  $tip = ''
-  foreach ($line in ([string]$view.tooltip) -split "\n") {
-    $next = if ($tip -eq '') { $line } else { "$tip`n$line" }
-    if ($next.Length -gt 63) { if ($tip -eq '') { $tip = $line.Substring(0, 62) + [char]0x2026 }; break }
-    $tip = $next
-  }
-  $notify.Text = $tip
-  Set-Menu $view.menu
-
-  # Host-side notifications on Windows ride the tray icon's balloon, which
-  # Windows 10/11 renders as a native toast.
-  if ($view.toast -and [long]$view.toast.seq -gt $script:lastToast) {
-    $script:lastToast = [long]$view.toast.seq
-    $script:balloonAction = [string]$view.toast.action
-    $notify.ShowBalloonTip(8000, [string]$view.toast.title, [string]$view.toast.body, [System.Windows.Forms.ToolTipIcon]::Info)
-  }
-}
-
-function Test-HostAlive {
-  if ($HostPid -le 0) { return $true }
-  return $null -ne (Get-Process -Id $HostPid -ErrorAction SilentlyContinue)
-}
-
-$script:ticks = 0
-$timer = New-Object System.Windows.Forms.Timer
-$timer.Interval = 100
-$timer.add_Tick({
-  try {
-    $script:ticks += 1
-    if (($script:ticks % 10) -eq 0 -and -not (Test-HostAlive)) {
-      $notify.Visible = $false
-      [System.Windows.Forms.Application]::Exit()
-      return
-    }
-    Update-FromView
-    # Advance the state's animation at its own fps; one-shot states hold their last frame.
-    if ($script:frameCount -gt 1 -and ($script:loop -or $script:frame -lt $script:frameCount - 1)) {
-      $script:clock += $timer.Interval / 1000.0
-      $step = 1.0 / [Math]::Max(1.0, $script:fps)
-      if ($script:clock -ge $step) {
-        $script:clock -= $step
-        if ($script:loop) { $script:frame = ($script:frame + 1) % $script:frameCount } else { $script:frame += 1 }
-        $notify.Icon = Get-StateIcon $script:state $script:frame
-      }
-    }
-  } catch {
-    [Console]::Error.WriteLine($_.Exception.Message)
-  }
-})
-$timer.Start()
-Update-FromView
-
-$context = New-Object System.Windows.Forms.ApplicationContext
-[System.Windows.Forms.Application]::Run($context)
-$notify.Visible = $false
-$notify.Dispose()