dsh-turn-ding 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arron Gao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,145 @@
-# Temporary Holding Version
+# dsh-turn-ding
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> 会话跑完时，在 Windows 任务栏的 DSH 图标上显示未读数字徽标，并播放一声提示音。
+
+[![npm version](https://img.shields.io/npm/v/dsh-turn-ding.svg)](https://www.npmjs.com/package/dsh-turn-ding)
+[![license](https://img.shields.io/npm/l/dsh-turn-ding.svg)](./LICENSE)
+[![platform](https://img.shields.io/badge/platform-Windows-0078D6.svg)](https://www.npmjs.com/package/dsh-turn-ding)
+
+DSH 没有内置「会话完成提醒」：任务栏图标不会累计未读数，也没有完成提示音。`dsh-turn-ding` 补上这个缺口——每个会话正常结束时徽标 +1 并响一声，回到窗口自动清零，效果类似 Codex 的完成提醒。
+
+## 功能
+
+- 任务栏图标右上角的红底白字数字徽标（超过 99 显示 `99+`）
+- 完成时播放系统提示音，音效可替换
+- 只在会话**正常完成**（`turn/end` + `completed`）时计数；中断、报错、耗尽 token、子会话都不计
+- DSH 是一窗多会话，因此即使窗口在前台也照常计数
+- 回到窗口（后台 → 前台）自动清零；一直停留时约 10 秒后自动淡出
+- Explorer 重启、窗口隐藏后徽标可自愈重绘
+
+## 环境要求
+
+| | |
+| --- | --- |
+| 系统 | Windows（`win32`，见 `os` 字段） |
+| DSH | `>=0.2.1-alpha.2 <0.4.0` |
+| 运行时 | Node >= 20、PowerShell 5.1+（Windows 自带，无需 `pwsh`） |
+
+## 安装
+
+### 从 npm 安装（推荐）
+
+DSH 侧栏「插件 → 安装第三方插件」输入包名：
+
+```
+dsh-turn-ding
+```
+
+或用命令行（`desktop` 换成你使用的 profile）：
+
+```bash
+dsh plugin --profile desktop add dsh-turn-ding
+```
+
+> 桌面版需**完全退出 DSH** 后安装或更新，装好重新打开。
+> 终端里找不到 `dsh` 时，先在桌面版菜单选「管理 dsh 命令」。
+
+### 从「发现」安装（DSH 0.2.2+ 实验功能）
+
+在「插件 → 实验性插件」启用**自定义插件索引**，再到「发现 → 添加索引源」填入本仓库 `index.json` 的公开地址：
+
+```
+https://raw.githubusercontent.com/arrongao/dsh-turn-ding/main/index.json
+```
+
+索引只是省掉手输包名这一步，装的仍是同一个 npm 包。
+
+### 离线 / 本地目录
+
+```bash
+dsh plugin --profile desktop add "D:/path/to/dsh-turn-ding"
+dsh plugin --profile desktop add "file:D:/path/to/dsh-turn-ding-0.1.1.tgz"
+```
+
+## 配置
+
+在对应 profile 的 `cordis.patch.yml`（Windows 默认 `%USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml`）里，给插件行加上 `config`：
+
+```yaml
+- id: turn-ding
+  name: 'dsh-turn-ding'
+  config:
+    sound: true
+    soundFile: 'C:\Windows\Media\Windows Notify System Generic.wav'
+    badge: true
+    ignoreSubagents: true
+```
+
+| 字段 | 默认 | 说明 |
+| --- | --- | --- |
+| `sound` | `true` | 是否播放提示音 |
+| `soundFile` | `C:\Windows\Media\Windows Notify System Generic.wav` | 任意本地 `.wav` 路径 |
+| `badge` | `true` | 是否显示数字徽标 |
+| `ignoreSubagents` | `true` | 是否忽略子会话的结束事件 |
+
+其它可选系统音效位于 `C:\Windows\Media\`，例如 `Windows Ding.wav`、`chimes.wav`。留空即使用上表默认值。
+
+## 工作原理
+
+- `lib/index.js` 监听 `session/event`，识别正常完成的 turn，通过 stdin 行协议驱动一个常驻辅助进程。
+- `lib/badge-server.ps1` 用 Win32 `ITaskbarList3.SetOverlayIcon` 绘制徽标，用 `System.Media.SoundPlayer` 播放音效，并轮询处理焦点变化与窗口句柄重绑定。
+
+DSH 的插件 host 是独立 Node 进程，拿不到 `BrowserWindow`，因此徽标由辅助进程按窗口句柄直接绘制到任务栏按钮上。
+
+## 开发
+
+```bash
+npm pack --dry-run              # 确认将要发布的文件
+node test/host-harness.mjs      # host 事件判定逻辑
+node test/e2e-badge.mjs         # 端到端徽标绘制
+node test/focus-regression.mjs  # "前台也计数"回归测试
+```
+
+仓库 `test/` 下另有辅助进程协议、自动清零、索引校验等脚本；截图为本地生成产物，不纳入版本控制。
+
+### 发布（维护者）
+
+```bash
+npm login --registry=https://registry.npmjs.org/
+npm version patch
+npm pack --dry-run
+npm publish --registry=https://registry.npmjs.org/ --access public
+```
+
+发布后同步 `index.json` 中的 `version` 与 `publishTimestamp`（Unix 秒），用 `@deepseek-ai/dsh-plugin-market-index` 的 `parseMarketIndex()` 校验通过，再更新托管地址。
+
+> 若 `~/.npmrc` 指向了镜像源，publish 需显式加 `--registry=https://registry.npmjs.org/`。开启两步验证的账号发布时需输入 OTP，或改用 Automation token 免去验证码。
+
+`os: ["win32"]` 会阻止在非 Windows 机器上安装。`engines.dsh` 仅作声明：安装器按 `peerDependencies` 做兼容校验，本包不设该字段。
+
+## 已知限制
+
+- 仅支持 Windows；macOS / Linux 需要另一套实现。
+- 安装或更换版本后需重启 DSH 才会加载。
+- 窗口隐藏到托盘时任务栏按钮不存在，徽标不可见；重新显示窗口后会自愈重绘。
+- 徽标是任务栏 **overlay 图标**，不是 Windows 通知中心里的 Toast 数字。
+
+## 项目结构
+
+```
+dsh-turn-ding/
+├── package.json          # dsh.bundle.patch 是"这是 DSH 插件"的标记
+├── cordis.patch.yml      # 插件注入声明
+├── index.json            # 「发现」用的格式 1 索引（托管到公开 URL 后使用）
+├── README.md
+├── LICENSE
+├── .gitignore
+├── lib/
+│   ├── index.js          # host 侧：事件监听与辅助进程生命周期
+│   └── badge-server.ps1  # Win32 侧：徽标绘制、提示音、轮询维护
+└── test/                 # 验证脚本（截图为本地生成，不入库）
+```
+
+## 许可证
+
+[MIT](./LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-turn-ding: one row, no surface of its own.
+- insert:
+    - id: turn-ding
+      name: 'dsh-turn-ding'

package/index.json

@@ -0,0 +1,53 @@
+{
+  "format": 1,
+  "title": {
+    "en": "DSH Completion Reminders",
+    "zh": "DSH 完成提醒插件索引"
+  },
+  "description": {
+    "en": "Community plugin index for dsh-turn-ding — taskbar badge and completion chime for DeepSeek Harness.",
+    "zh": "dsh-turn-ding 的社区插件索引——为 DeepSeek Harness 提供任务栏数字徽标与完成提示音。"
+  },
+  "metadata": {
+    "labels": {
+      "windows-only": {
+        "title": { "en": "Windows only", "zh": "仅限 Windows" }
+      }
+    }
+  },
+  "plugins": [
+    {
+      "name": "dsh-turn-ding",
+      "title": {
+        "en": "Turn Ding — completion badge & chime",
+        "zh": "完成提示 · 任务栏徽标与提示音"
+      },
+      "description": {
+        "en": "Shows an unread number badge on the Windows taskbar icon and plays a chime whenever a DeepSeek Harness session finishes.",
+        "zh": "每当一个 DeepSeek Harness 会话完成，就在 Windows 任务栏图标右上角显示未读数字徽标，并播放提示音。"
+      },
+      "author": "Arron Gao",
+      "homepage": "https://github.com/arrongao/dsh-turn-ding#readme",
+      "repository": {
+        "url": "https://github.com/arrongao/dsh-turn-ding"
+      },
+      "metadata": {
+        "keywords": ["badge", "notification", "taskbar", "windows", "completion"],
+        "labels": ["windows-only"]
+      },
+      "versions": [
+        {
+          "version": "0.1.1",
+          "publishTimestamp": 1794650620,
+          "source": {
+            "type": "npm",
+            "registry": "https://registry.npmjs.org/"
+          },
+          "engines": {
+            "dsh": ">=0.2.1-alpha.2 <0.4.0"
+          }
+        }
+      ]
+    }
+  ]
+}

package/lib/badge-server.ps1

@@ -0,0 +1,243 @@
+param(
+  [Parameter(Mandatory = $true)][int]$TargetPid,
+  [string]$Sound = 'C:\Windows\Media\Windows Notify System Generic.wav',
+  [int]$ClearOnFocus = 1,
+  [int]$SoundEnabled = 1,
+  [int]$BadgeEnabled = 1
+)
+
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+
+Add-Type -ReferencedAssemblies System.Drawing -TypeDefinition @'
+using System;
+using System.Drawing;
+using System.Drawing.Drawing2D;
+using System.Runtime.InteropServices;
+
+namespace DshBadge {
+  [ComImport, Guid("56FDF344-FD6D-11d0-958A-006097C9A090")]
+  public class TaskbarListCoclass { }
+
+  [ComImport, Guid("ea1afb91-9e28-4b86-90e9-9e9f8a5eefaf"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+  public interface ITaskbarList3 {
+    void HrInit();
+    void AddTab(IntPtr hwnd);
+    void DeleteTab(IntPtr hwnd);
+    void ActivateTab(IntPtr hwnd);
+    void SetActiveAlt(IntPtr hwnd);
+    void MarkFullscreenWindow(IntPtr hwnd, bool fFullscreen);
+    void SetProgressValue(IntPtr hwnd, ulong completed, ulong total);
+    void SetProgressState(IntPtr hwnd, int flags);
+    void RegisterTab(IntPtr hwndTab, IntPtr hwndMdi);
+    void UnregisterTab(IntPtr hwndTab);
+    void SetTabOrder(IntPtr hwndTab, IntPtr hwndInsertBefore);
+    void SetTabActive(IntPtr hwndTab, IntPtr hwndMdi, uint reserved);
+    void ThumbBarAddButtons(IntPtr hwnd, uint cButtons, IntPtr pButtons);
+    void ThumbBarUpdateButtons(IntPtr hwnd, uint cButtons, IntPtr pButtons);
+    void ThumbBarSetImageList(IntPtr hwnd, IntPtr himl);
+    void SetOverlayIcon(IntPtr hwnd, IntPtr hIcon, [MarshalAs(UnmanagedType.LPWStr)] string description);
+    void SetThumbnailTooltip(IntPtr hwnd, [MarshalAs(UnmanagedType.LPWStr)] string tip);
+  }
+
+  public static class Api {
+    static ITaskbarList3 list;
+
+    static ITaskbarList3 List() {
+      if (list == null) {
+        object coclass = new TaskbarListCoclass();
+        list = (ITaskbarList3)coclass;
+        list.HrInit();
+      }
+      return list;
+    }
+
+    public static void Apply(long hwndValue, int count, string tip) {
+      IntPtr hwnd = new IntPtr(hwndValue);
+      if (count <= 0) {
+        List().SetOverlayIcon(hwnd, IntPtr.Zero, "");
+        return;
+      }
+      IntPtr hicon = Render(count);
+      try { List().SetOverlayIcon(hwnd, hicon, tip == null ? "" : tip); }
+      finally { DestroyIcon(hicon); }
+    }
+
+    // 32x32 ARGB: red disc, white rim, bold white numeral -- the shape Windows
+    // itself uses for unread counts on a taskbar button.
+    public static IntPtr Render(int count) {
+      int s = 32;
+      Bitmap bmp = new Bitmap(s, s, System.Drawing.Imaging.PixelFormat.Format32bppArgb);
+      using (Graphics g = Graphics.FromImage(bmp)) {
+        g.SmoothingMode = SmoothingMode.AntiAlias;
+        g.TextRenderingHint = System.Drawing.Text.TextRenderingHint.AntiAliasGridFit;
+        g.Clear(Color.Transparent);
+        float pad = s * 0.04f;
+        using (SolidBrush fill = new SolidBrush(Color.FromArgb(255, 209, 52, 56)))
+        using (Pen edge = new Pen(Color.FromArgb(255, 255, 255, 255), s * 0.06f)) {
+          g.FillEllipse(fill, pad, pad, s - 2 * pad, s - 2 * pad);
+          g.DrawEllipse(edge, pad, pad, s - 2 * pad, s - 2 * pad);
+        }
+        string text = count > 99 ? "99+" : count.ToString();
+        float em = s * (text.Length > 2 ? 0.40f : text.Length > 1 ? 0.52f : 0.68f);
+        using (Font f = new Font("Segoe UI", em, FontStyle.Bold, GraphicsUnit.Pixel)) {
+          StringFormat sf = new StringFormat();
+          sf.Alignment = StringAlignment.Center;
+          sf.LineAlignment = StringAlignment.Center;
+          g.DrawString(text, f, Brushes.White, new RectangleF(0, s * 0.02f, s, s), sf);
+        }
+      }
+      return bmp.GetHicon();
+    }
+
+    [DllImport("user32.dll")]
+    public static extern bool DestroyIcon(IntPtr hIcon);
+    [DllImport("user32.dll")]
+    public static extern IntPtr GetForegroundWindow();
+    [DllImport("user32.dll")]
+    public static extern bool IsWindow(IntPtr hWnd);
+    [DllImport("user32.dll")]
+    public static extern bool IsIconic(IntPtr hWnd);
+    [DllImport("user32.dll")]
+    public static extern bool IsWindowVisible(IntPtr hWnd);
+  }
+}
+'@
+
+function Write-Line([string]$text) {
+  [Console]::Out.WriteLine($text)
+  [Console]::Out.Flush()
+}
+
+# The DSH window is owned by the Electron main process -- our parent process.
+# Fall back to any process carrying a DSH main window if that lookup fails.
+function Find-Window {
+  if ($TargetPid -gt 0) {
+    $p = Get-Process -Id $TargetPid -ErrorAction SilentlyContinue
+    if ($p -and $p.MainWindowHandle -ne [IntPtr]::Zero) { return $p.MainWindowHandle }
+  }
+  foreach ($n in @('DeepSeek Harness', 'DSH')) {
+    $c = Get-Process -Name $n -ErrorAction SilentlyContinue |
+      Where-Object { $_.MainWindowHandle -ne [IntPtr]::Zero } |
+      Sort-Object StartTime | Select-Object -First 1
+    if ($c) { return $c.MainWindowHandle }
+  }
+  return [IntPtr]::Zero
+}
+
+function Play-Ding {
+  if ($SoundEnabled -ne 1) { return }
+  if (-not (Test-Path -LiteralPath $Sound)) { return }
+  try {
+    $player = New-Object System.Media.SoundPlayer -ArgumentList $Sound
+    $player.Play()
+  } catch { }
+}
+
+function Show-Badge([int]$n) {
+  if ($BadgeEnabled -ne 1 -or $n -le 0) { return }
+  if ($target -eq [IntPtr]::Zero) { return }
+  $tip = if ($n -eq 1) { '1 个会话已完成' } else { "$n 个会话已完成" }
+  try { [DshBadge.Api]::Apply($target.ToInt64(), $n, $tip) } catch { }
+}
+
+$target = Find-Window
+$count = 0
+$ticks = 0
+$wasFocused = ($target -ne [IntPtr]::Zero) -and ([DshBadge.Api]::GetForegroundWindow() -eq $target)
+$focusedTicks = 0
+$reader = New-Object System.IO.StreamReader([Console]::OpenStandardInput(), (New-Object System.Text.UTF8Encoding($false)))
+Write-Line ("ready hwnd=" + $target.ToInt64() + " pid=" + $TargetPid)
+
+$task = $reader.ReadLineAsync()
+while ($true) {
+  $got = $task.AsyncWaitHandle.WaitOne(500)
+  if ($got) {
+    $line = $task.Result
+    if ($null -eq $line) { break }
+    $task = $reader.ReadLineAsync()
+    $line = $line.Trim()
+    if ($line.Length -eq 0) { continue }
+    $parts = $line.Split(' ', [StringSplitOptions]::RemoveEmptyEntries)
+    $cmd = $parts[0].ToLowerInvariant()
+    if ($cmd -eq 'quit') { break }
+
+    if ($target -eq [IntPtr]::Zero -or -not [DshBadge.Api]::IsWindow($target)) { $target = Find-Window }
+
+    switch ($cmd) {
+      'notify' {
+        # A turn finished. Always counted: DSH is one window shared by several
+        # chats, so "the window has focus" says nothing about whether the user is
+        # watching *this* chat. Clearing happens on regaining focus instead.
+        $count += 1
+        Show-Badge $count
+        Play-Ding
+        Write-Line ("notify count=" + $count)
+      }
+      'set' {
+        $n = 1
+        if ($parts.Length -gt 1) { [int]::TryParse($parts[1], [ref]$n) | Out-Null }
+        if ($n -le 0) { $n = 1 }
+        $count = $n
+        Show-Badge $count
+        Write-Line ("set " + $count)
+      }
+      'clear' {
+        $count = 0
+        if ($target -ne [IntPtr]::Zero) { try { [DshBadge.Api]::Apply($target.ToInt64(), 0, "") } catch { } }
+        Write-Line "clear"
+      }
+      'sound' {
+        Play-Ding
+        Write-Line "sound"
+      }
+      'ping' { Write-Line "pong" }
+      default { Write-Line ("unknown " + $cmd) }
+    }
+    continue
+  }
+
+  $ticks += 1
+  if ($target -eq [IntPtr]::Zero -or -not [DshBadge.Api]::IsWindow($target)) {
+    $old = $target
+    $target = Find-Window
+    if ($target -ne [IntPtr]::Zero) {
+      Write-Line ("rebind hwnd=" + $target.ToInt64())
+      Show-Badge $count
+    }
+    continue
+  }
+
+  if ($count -gt 0) {
+    # Clear on a background -> foreground transition (the usual "I came back"
+    # case), or let a badge shown while already focused fade after ~10s so it
+    # cannot stick to a window the user never left.
+    $focusedNow = ($ClearOnFocus -eq 1) -and ([DshBadge.Api]::GetForegroundWindow() -eq $target)
+    if ($focusedNow -and -not $wasFocused) {
+      $count = 0
+      $focusedTicks = 0
+      try { [DshBadge.Api]::Apply($target.ToInt64(), 0, "") } catch { }
+      Write-Line "autoclear"
+    } elseif ($focusedNow -and $focusedTicks -ge 20) {
+      $count = 0
+      $focusedTicks = 0
+      try { [DshBadge.Api]::Apply($target.ToInt64(), 0, "") } catch { }
+      Write-Line "autofade"
+    } else {
+      if ($focusedNow) { $focusedTicks += 1 } else { $focusedTicks = 0 }
+      if ($ticks % 12 -eq 0) {
+        # Heal after Explorer restarts or a hide/show cycle drops the overlay.
+        Show-Badge $count
+      }
+    }
+    $wasFocused = $focusedNow
+  } else {
+    $wasFocused = ($ClearOnFocus -eq 1) -and ([DshBadge.Api]::GetForegroundWindow() -eq $target)
+    $focusedTicks = 0
+  }
+}
+
+if ($count -gt 0 -and $target -ne [IntPtr]::Zero) {
+  try { [DshBadge.Api]::Apply($target.ToInt64(), 0, "") } catch { }
+}
+Write-Line "bye"

package/lib/index.js

@@ -0,0 +1,168 @@
+/**
+ * dsh-turn-ding — host half.
+ *
+ * Watches `session/event` for completed turns and drives a long-lived PowerShell
+ * helper that paints a numeric overlay badge on the DSH taskbar button through
+ * `ITaskbarList3.SetOverlayIcon`, optionally playing a sound.
+ *
+ * The overlay icon is the only channel Windows gives a non-Electron process for
+ * a dock badge: the desktop main process exposes no badge IPC to the renderer,
+ * and the host runs as a separate Node child process, so Win32 from the host is
+ * the right seam.
+ */
+import { spawn } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+
+export const name = 'dsh-turn-ding'
+
+const here = dirname(fileURLToPath(import.meta.url))
+
+const DEFAULTS = {
+  sound: true,
+  soundFile: 'C:\\Windows\\Media\\Windows Notify System Generic.wav',
+  badge: true,
+  ignoreSubagents: true,
+}
+
+const POWERSHELL = 'powershell.exe'
+
+class BadgeServer {
+  constructor(options, logger) {
+    this.options = options
+    this.logger = logger
+    this.child = null
+    this.count = 0
+    this.pending = []
+    this.ready = false
+    this.broken = false
+  }
+
+  /** Launch the helper; failures degrade to "no badge" rather than throwing. */
+  start() {
+    const script = join(here, 'badge-server.ps1')
+    if (!existsSync(script)) {
+      this.broken = true
+      this.logger.warn('dsh-turn-ding: badge-server.ps1 is missing, badge disabled')
+      return
+    }
+
+    let child
+    try {
+      child = spawn(
+        POWERSHELL,
+        ['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-File', script,
+          '-TargetPid', String(process.ppid || 0),
+          '-Sound', this.options.soundFile,
+          '-SoundEnabled', this.options.sound ? '1' : '0',
+          '-BadgeEnabled', this.options.badge ? '1' : '0'],
+        { stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true },
+      )
+    } catch (error) {
+      this.broken = true
+      this.logger.warn(`dsh-turn-ding: could not start the badge helper (${String(error)})`)
+      return
+    }
+
+    this.child = child
+    child.stdout.setEncoding('utf8')
+    child.stdout.on('data', (chunk) => {
+      for (const raw of String(chunk).split(/\r?\n/)) {
+        const line = raw.trim()
+        if (!line) continue
+        if (line.startsWith('ready')) {
+          this.ready = true
+          for (const command of this.pending.splice(0)) this.write(command)
+          continue
+        }
+        // The helper owns the authoritative counter: it reports the number it
+        // just painted, and tells us when it clears the badge itself.
+        const counted = /^notify count=(\d+)$/.exec(line)
+        if (counted) {
+          this.count = Number(counted[1])
+          continue
+        }
+        if (line === 'autoclear' || line === 'autofade') this.count = 0
+      }
+    })
+    child.stderr.setEncoding('utf8')
+    child.stderr.on('data', (chunk) => {
+      const text = String(chunk).trim()
+      if (text) this.logger.warn(`dsh-turn-ding: badge helper: ${text}`)
+    })
+    child.on('error', (error) => {
+      this.broken = true
+      this.logger.warn(`dsh-turn-ding: badge helper failed (${String(error)})`)
+    })
+    child.on('exit', (code) => {
+      this.child = null
+      this.ready = false
+      if (code !== 0 && code !== null) this.logger.warn(`dsh-turn-ding: badge helper exited with ${code}`)
+    })
+  }
+
+  write(command) {
+    if (!this.child || this.child.killed) return
+    if (!this.ready) {
+      this.pending.push(command)
+      return
+    }
+    try {
+      this.child.stdin.write(`${command}\n`)
+    } catch {
+      // Helper died mid-write; the next start() call recovers.
+    }
+  }
+
+  /**
+   * A turn finished. `notify` lets the helper decide whether the moment is
+   * badge-worthy: it only increments while the DSH window is in the background,
+   * so a turn that ends while the user is watching never leaves a stale number.
+   */
+  bump() {
+    if (this.broken) return
+    if (!this.child) this.start()
+    this.write('notify')
+  }
+
+  clear() {
+    this.count = 0
+    this.write('clear')
+  }
+
+  dispose() {
+    this.count = 0
+    if (!this.child) return
+    try {
+      this.child.stdin.write('quit\n')
+      this.child.stdin.end()
+    } catch { /* already gone */ }
+    const child = this.child
+    this.child = null
+    setTimeout(() => {
+      if (!child.killed) {
+        try { child.kill() } catch { /* already gone */ }
+      }
+    }, 1500).unref?.()
+  }
+}
+
+export function apply(ctx, config) {
+  const options = { ...DEFAULTS, ...(config && typeof config === 'object' ? config : {}) }
+  const logger = ctx.logger ?? console
+  const server = new BadgeServer(options, logger)
+
+  ctx.effect(() => {
+    server.start()
+    return () => server.dispose()
+  })
+
+  ctx.on('session/event', (session, event) => {
+    if (!event || event.type !== 'turn/end') return
+    const reason = event.data?.reason
+    if (!reason || reason.kind !== 'completed') return
+    if (options.ignoreSubagents && (session?.header?.origin === 'subagent' || (session?.header?.delegationDepth ?? 0) > 0)) return
+    server.bump()
+  })
+}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "dsh-turn-ding",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Windows taskbar unread badge and completion chime for DeepSeek Harness turns",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "index.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "badge",
+    "notification",
+    "windows",
+    "taskbar"
+  ],
+  "author": "Arron Gao <arron.gaoxc@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arrongao/dsh-turn-ding.git"
+  },
+  "homepage": "https://github.com/arrongao/dsh-turn-ding#readme",
+  "os": [
+    "win32"
+  ],
+  "engines": {
+    "node": ">=20",
+    "dsh": ">=0.2.1-alpha.2 <0.4.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "manifestVersion": 1
+  }
+}