dsh-notify 0.1.1 → 0.1.2

package/README.md

@@ -1,126 +1,40 @@
-# dsh-plugin-notify
+# dsh-notify
 
-> ⚠️ **AI 生成项目声明**
->
-> 本项目（代码、脚本、文档）**由 AI 辅助生成**，仅用于学习和参考。
-> 使用前请自行阅读、审查并充分测试代码，按需修改后再部署到你的环境。
+> ⚠️ **AI 生成项目**：代码与文档由 AI 辅助生成，仅供学习参考，使用前请自行审查。
 
-dsh Web GUI 的 Windows 通知插件：当 agent **不再运行**时（任务完成 / 被停止 / 出错 / 停下来等你选择 / 会话被关闭），弹一条 Windows 原生 Toast 提醒你回来看结果。适合发起绘画、生成等长任务后离开电脑的场景。
-
-- **纯 host 端插件**：零运行时依赖、零构建步骤，普通 ESM；
-- **通知常驻**：`scenario="reminder"`，直到你手动关闭；
-- **位置标注**：通知正文显示 `工作区「…」 · 会话「…」`，一眼看出是哪个工作区的哪个会话；
-- **系统托盘**：任务栏右下角常驻 dsh 鲸鱼图标，双击/右键「打开 dsh」、右键「关闭进程」终止 dsh 后台，dsh 退出后图标自动消失。
-
-## 目录
-
-- [触发条件](#触发条件)
-- [安装](#安装)
-- [配置](#配置config均有默认值)
-- [测试](#测试)
-- [排障](#排障)
-- [相关文档](#相关文档)
-
-## 触发条件
-
-| 场景 | 信号 | 通知 |
-|---|---|---|
-| 任务正常完成 | `agent/status` running→idle + `turn/end: completed` | 「dsh · 任务完成」 |
-| 你点了停止 / 被中止 | `turn/end: aborted` | 「dsh · 任务已停止」 |
-| 执行出错 | `turn/end: error` | 「dsh · 任务出错」 |
-| 达到输出上限 | `turn/end: max-tokens` | 「dsh · 达到输出上限」 |
-| agent 停下来让你选择 | 未配对的 `ask_user_question` 工具调用 | 「dsh · 在等你选择」 |
-| 运行中的会话被关闭 | `agent/disposed` | 「dsh · 会话已关闭」 |
-
-> **位置标注说明**：每条通知正文带一行 `工作区「…」 · 会话「…」`。
-> 工作区取 `workspaceRegistry` 中该会话的归属标题（兜底用会话 cwd 的目录名），
-> 会话取 sidebar 显示的会话标题（无标题时兜底用会话 id 短号，如 `#a1b2c3d4`）。
-> 两个服务都不可用时该行自动省略，不影响通知。
+dsh 的 Windows 通知插件：agent 不再运行时（完成 / 停止 / 出错 / 等你选择 / 会话关闭）弹原生 Toast 提醒，正文标注「工作区 · 会话」，托盘常驻鲸鱼图标。
 
 ## 安装
 
-本插件是标准的 DSH **bundle**（`package.json` 声明 `dsh.bundle.patch`，包内自带
-`cordis.patch.yml`），安装后会自动加入 profile 的 bundle 层，无需手动写补丁。
-
-### 方式一：npm（推荐）
-
 ```powershell
 dsh plugin --profile web add dsh-notify
 ```
 
-### 方式二：GitHub 直接安装（无需 npm）
-
-```powershell
-dsh plugin --profile web add github:Pasumao/dsh-plugin-notify
-```
-
-> git 源插件若带构建脚本，pnpm 会要求先在 `profiles\web\pnpm-workspace.yaml` 的
-> `allowBuilds` 里放行对应包名；本项目零构建（无 prepare 脚本），一般无需配置。
+GitHub 安装：`dsh plugin --profile web add github:Pasumao/dsh-plugin-notify`
 
-### 方式三：本地路径（开发 / 私有测试）
+装完重启 `dsh web`，任务栏出现鲸鱼图标即生效。
 
-```powershell
-dsh plugin --profile web add C:/Users/18303/Desktop/dsh-plugin-notify
-```
-
-### 方式四：手动 link（可选，等同旧版流程）
-
-1. 在 `C:\Users\18303\.dsh\profiles\web\package.json` 的 dependencies 加：
+## 触发时机
 
-   ```jsonc
-   "dependencies": {
-     // ...已有依赖...
-     "dsh-notify": "link:C:/Users/18303/Desktop/dsh-plugin-notify"
-   }
-   ```
+任务完成、被中止、执行出错、达到输出上限、停下来等你选择、运行中的会话被关闭。
 
-2. profile 目录执行安装：
+## 配置
 
-   ```powershell
-   cd C:\Users\18303\.dsh\profiles\web
-   pnpm install
-   ```
-
-安装完成后 **重启 `dsh web`**：任务栏右下角出现 dsh 鲸鱼小图标即加载成功。
-如需调整通知行为，在 profile 的 `cordis.patch.yml` 按 id 覆盖 `config` 即可
-（例如 `- id: dsh-plugin-notify` + `config: { cooldownMs: 5000 }`）。
-
-## 配置（`config`，均有默认值）
+在 profile 的 `cordis.patch.yml` 按 id `dsh-plugin-notify` 覆盖 config。常用项：
 
 | key | 默认 | 说明 |
 |---|---|---|
-| `enabled` | `true` | 总开关 |
-| `tray` | `true` | 系统托盘图标开关（`false` 关闭） |
-| `rootsOnly` | `true` | 仅根会话通知；子代理不刷屏 |
-| `notifyFinished` / `notifyAborted` / `notifyError` / `notifyWaiting` / `notifyDisposed` | 全 `true` | 分类型开关 |
-| `cooldownMs` | `10000` | 同一会话、同一类型两次通知最小间隔（毫秒） |
-| `titlePrefix` | `'dsh'` | 通知标题前缀（形如 `dsh · 任务完成`） |
-| `iconPath` | 内置 `assets/dsh.png` | 通知 logo PNG 路径；设为空串 `''` 则不显示自定义图标 |
-| `webUrl` | `http://127.0.0.1:3080` | dsh 页面地址（点击通知/托盘「打开 dsh」跳转的地址） |
-| `aumid` | PowerShell 5.1 的 AUMID | Toast 归属的 AppUserModelID（一般无需改） |
-| `summaryMaxChars` | `40` | 任务摘要截断长度 |
-| `powershellPath` | 自动 | 覆盖 PowerShell 5.1 路径 |
+| `cooldownMs` | `10000` | 同会话同类型两次通知的最小间隔（毫秒） |
+| `rootsOnly` | `true` | 仅根会话通知，子代理不刷屏 |
+| `tray` | `true` | 托盘图标开关 |
+| `titlePrefix` | `'dsh'` | 通知标题前缀 |
 
 ## 测试
 
-通知管道单测（英文 Toast）：
-
 ```powershell
-powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/smoke-notice.ps1
-```
-
-插件逻辑端到端自测（无需 dsh、无需重启，弹「等待选择 / 任务完成 / 任务已停止」三条中文 Toast）：
-
-```powershell
-node scripts/test-harness.mjs
+node scripts/test-harness.mjs   # 弹三条真实 Toast 自测
 ```
 
 ## 排障
 
-- **Toast 不出现**：确认 Windows「通知与操作」里允许 PowerShell 显示通知；首次加载 WinRT 模块稍慢属正常。
-- **图标不显示**：确认 `assets/dsh.png`（通知）与 `assets/dsh.ico`（托盘）随插件目录一起存在。
-- **中文乱码**：经环境变量（UTF-16）与 `-EncodedCommand`（UTF-16LE base64）传参，不应乱码。
-
-## 相关文档
-
-- `设计文稿.md`：设计思路、对 dsh 源码的调研结论、实现细节与边界情况。
+Toast 不出现：检查 Windows「通知与操作」是否允许 PowerShell 显示通知。

package/lib/index.js

@@ -7,8 +7,9 @@
  *
  * 通知正文除了任务摘要，还会标注「工作区 · 会话」位置行：工作区标题取自
  * `ctx.workspaceRegistry`（按会话归属匹配，兜底用会话 cwd 的目录名），会话
- * 显示名取自 `ctx.sessionTitle`（sidebar 标题，兜底用会话 id 短号）。两个服务
- * 都不可用时自动省略，不影响通知本身。
+ * 显示名优先官方 `ctx.sessionTitle` 服务、再直接折会话日志的 `session/title`
+ * 事件（与 UI sidebar 一致），兜底用会话 id 短号。服务都不可用时自动省略，
+ * 不影响通知本身。
  *
  * 触发信号（均为主机端 Cordis 事件）：
  *   - `agent/status`（idle ⇄ running）：running→idle 即「不再运行」。
@@ -185,14 +186,32 @@ function resolveWorkspaceLabel(ctx, session) {
   return truncate(pathBasename(session?.header?.cwd), 40)
 }
 
-/** 解析会话显示名：优先 sidebar 标题（sessionTitle），兜底用会话 id 短号。 */
+/**
+ * 解析会话显示名：优先 sidebar 标题，兜底用会话 id 短号。
+ * 标题先走官方 `sessionTitle` 服务（存在时），再直接从会话日志折
+ * `session/title` 事件（与 `foldSessionTitle` 同款）——插件 ctx 上服务不可见时
+ * 也能取到标题，与 UI 显示一致。
+ */
 function resolveSessionLabel(ctx, session) {
   try {
     const snapshot = ctx.sessionTitle?.get?.(session)
     const title = snapshot?.title
     if (typeof title === 'string' && title.trim()) return truncate(title.trim(), 40)
   } catch {
-    // sessionTitle 服务不可用 / 会话已关闭时忽略，走 id 兜底。
+    // sessionTitle 服务不可用 / 会话已关闭时忽略，继续走日志折叠。
+  }
+  try {
+    const events = session?.events
+    if (Array.isArray(events)) {
+      for (let index = events.length - 1; index >= 0; index--) {
+        const event = events[index]
+        if (event?.type === 'session/title' && typeof event.data?.title === 'string' && event.data.title.trim()) {
+          return truncate(event.data.title.trim(), 40)
+        }
+      }
+    }
+  } catch {
+    // 会话已分离等异常时忽略，走 id 兜底。
   }
   return typeof session?.id === 'string' && session.id ? `#${session.id.slice(0, 8)}` : ''
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-notify",
   "description": "DeepSeek Harness (dsh) Windows notification plugin: a native toast when the agent stops running (finished / aborted / error / waiting for your choice / session closed), plus a system-tray icon. Pure host-side, zero dependencies, zero build.",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "main": "lib/index.js",
   "exports": {

package/scripts/inspect-session.mjs

@@ -0,0 +1,30 @@
+import { zstdDecompressSync } from 'node:zlib'
+import { readFileSync } from 'node:fs'
+
+const file = process.argv[2]
+const buf = readFileSync(file)
+const MAGIC = Buffer.from([0x28, 0xb5, 0x2f, 0xfd])
+const frames = []
+let i = 0
+while (i < buf.length) {
+  const idx = buf.indexOf(MAGIC, i)
+  if (idx < 0) break
+  let next = buf.indexOf(MAGIC, idx + 4)
+  if (next < 0) next = buf.length
+  frames.push(zstdDecompressSync(buf.subarray(idx, next)))
+  i = next
+}
+const text = Buffer.concat(frames).toString('utf8')
+const lines = text.split('\n').filter(Boolean)
+console.log('total events:', lines.length)
+const titles = lines.filter((l) => l.includes('session/title'))
+console.log('session/title events:', titles.length)
+for (const t of titles.slice(-3)) console.log('TITLE:', t.slice(0, 500))
+console.log('--- user/message + turn/end (last 12) ---')
+let shown = 0
+for (const l of lines) {
+  if (l.includes('user/message') || l.includes('turn/end')) {
+    console.log(l.slice(0, 300))
+    if (++shown >= 12) break
+  }
+}

package/scripts/test-harness.mjs

@@ -30,10 +30,7 @@ const ctx = {
       },
     ],
   },
-  /** mock sessionTitle：返回 sidebar 标题。 */
-  sessionTitle: {
-    get: (s) => (s?.id === 'test-session' ? { title: '画一只赛博朋克猫' } : undefined),
-  },
+  // 故意不提供 sessionTitle 服务：验证「直接折会话日志 session/title」路径。
   on(name, cb) {
     if (!handlers.has(name)) handlers.set(name, [])
     handlers.get(name).push(cb)
@@ -59,6 +56,8 @@ const emit = (name, ...args) => {
 const session = {
   id: 'test-session',
   header: { cwd: 'C:\\Users\\18303\\Desktop\\dsh-plugin-notify' }, // 无 delegationDepth = 根会话
+  // 会话日志（与真实 dsh Session.events 同形）：含 session/title 事件。
+  events: [{ type: 'session/title', data: { title: '画一只赛博朋克猫' } }],
 }
 const agent = { id: 'test-session', status: 'running', session }
 

package//350/256/276/350/256/241/346/226/207/347/250/277.md

@@ -72,7 +72,7 @@ agent 循环 ──agent/status──▶ 状态机(每会话) ──running→id
 
 `TOAST_SCRIPT` 用 `ToastNotificationManager` 发 `<toast scenario="reminder" activationType="protocol" launch="<webUrl>">`（整条常驻且点击打开 dsh 页面），`<image placement="appLogoOverride" src="file:///…dsh.png">` 显示鲸鱼 logo。脚本经 `-EncodedCommand` 传入、数据经 `env` 传入；进程失败只 `ctx.logger.warn`，不影响 dsh。
 
-正文由三个 `<text>` 组成：标题、任务摘要/等待文案、位置行（`工作区「…」 · 会话「…」`，经 `DSH_NOTICE_LOCATION` 环境变量传入，为空则省略该元素）。位置行在 `notify()` 时现取：`resolveWorkspaceLabel` 先按 `workspaceRegistry.list()` 的 `sessionIds` 匹配归属标题、兜底 cwd 目录名；`resolveSessionLabel` 取 `sessionTitle.get(session).title`、兜底会话 id 短号；两者均含长度截断，服务缺失时自动降级（无服务 → 无位置行）。
+正文由三个 `<text>` 组成：标题、任务摘要/等待文案、位置行（`工作区「…」 · 会话「…」`，经 `DSH_NOTICE_LOCATION` 环境变量传入，为空则省略该元素）。位置行在 `notify()` 时现取：`resolveWorkspaceLabel` 先按 `workspaceRegistry.list()` 的 `sessionIds` 匹配归属标题、兜底 cwd 目录名；`resolveSessionLabel` 优先 `sessionTitle.get(session).title`，再直接折会话日志 `session/title` 事件（与 `foldSessionTitle` 同款，插件 ctx 上服务不可见时仍能取到标题）、兜底会话 id 短号；两者均含长度截断，服务缺失时自动降级（无服务 → 无位置行）。
 
 ### 5.2 系统托盘图标