@telosmaylx/dsh-session-notify 0.1.4 → 0.1.5

package/README.md

@@ -292,10 +292,14 @@ Session completed (took 3m25s, used 1,240 in / 3,560 out).
 | --- | --- |
 | 预设 | 下拉选择内置或自定义预设；「新增」把当前配置另存为自定义预设；当前预设可「删除」 |
 | 语言 | 5 种语言单选，切换即时重渲染整个面板 |
+| 推送方式 | 三选一：双通道（系统通知 + 页内提示，默认）/ 仅系统通知 / 仅页内提示 |
 | 推送标题 | `{title}` 引用会话标题，留空则直接用会话标题 |
 | 模板 × 5 | 每条结束原因（完成、出错、中止、阻塞、输出上限）独立一个 Chip 编辑器：文字 + 内联信息胶囊，光标处插入、点击移除、实时预览 |
 | 跳过子代理会话 | 复选框（保存时一并写入设置文档） |
-| 保存 | 写入宿主设置文档（`language` / `templates` / `titleTemplate`）；保存后显示「点击刷新」链接 |
+| 保存 | 写入宿主设置文档（`language` / `templates` / `titleTemplate` / `pushMode`）；保存后显示「点击刷新」链接 |
+
+> [!NOTE]
+> 「推送方式」的取舍：`dual`（默认）同时弹 Windows 系统通知与页内 toast，toast 是保底通道，防止系统通知被平台静默（专注助手、通知横幅关闭）。但 QQ 浏览器等 Chromium 壳浏览器会把 `Notification` 渲染成页内横幅而非 Windows 通知中心——此时 `dual` 会造成页内两个提示。这类浏览器请选「仅页内提示」（不再调用 `Notification`，页内只有一个小 toast）；Firefox 另需在地址栏手动授权通知，且窗口聚焦时通知显示为页内横幅、失焦才进系统通知中心。
 
 > [!NOTE]
 > 面板中「跳过子代理会话」保存的是设置文档里的布尔值；宿主 `cordis.patch.yml` 的 `config.skipSubagents` 是其启动默认值，两者任一为真即跳过。
@@ -507,6 +511,7 @@ node scripts/verify-notice.mjs <session.jsonl.zstd>
 
 | 版本 | 日期 | 变更 |
 | --- | --- | --- |
+| **0.1.5** | 2026-08-29 | 新增「推送方式」设置（双通道 / 仅系统通知 / 仅页内提示）：解决 QQ 浏览器等 Chromium 壳把 `Notification` 渲染成页内横幅导致的双提示；`pushMode` 加入设置 schema 与设置面板 |
 | **0.1.4** | 2026-08-28 | 补充完整卸载支持：`dispose` 生命周期收尾（host 置卸载标志抑制待追加微任务；client 清理正文轮询定时器、`__dsch_notify_debug` 钩子、toast 容器）；卸载文档与 FAQ 同步 |
 | **0.1.3** | 2026-08-28 | 声明官方 `dsh.bundle` manifest（`dsh plugin add` 一条命令自动挂载）；settings 重试定时器改为 `ctx.effect()` 包装（Cordis effect 纪律）；安装文档重排 |
 | 0.1.2 | 2026-08-27 | 包更名至 `@telosmaylx` scope（npm 用户名作用域） |

package/lib/client.js

@@ -53,6 +53,7 @@ window.__ModuleLoader__.load({
         placeholder: '自定义文案：点「＋ 插入信息」，或直接输入文字',
         insertInfo: '＋ 插入信息', insertTitle: '在光标处插入信息', preview: '预览：',
         skipSubagents: '跳过子代理会话',
+        pushMode: '推送方式', pushDual: '系统通知 + 页内提示', pushSystem: '仅系统通知', pushToast: '仅页内提示',
         discard: '放弃', save: '保存', saving: '保存中…', saved: '已保存 ✓ · 刷新页面后生效', saveFailed: '保存失败：', refresh: '点击刷新',
         saveAs: '新增', update: '修改', remove: '删除', presetNamePlaceholder: '预设名称', confirm: '确定', cancel: '取消', customSaved: '自定义预设已保存', customUpdated: '自定义预设已更新', customDeleted: '自定义预设已删除', saveAsTitle: '将当前配置另存为自定义预设', updateTitle: '更新当前自定义预设', removeTitle: '删除当前自定义预设', fromPreset: '来自：', modifiedSuffix: ' · 已修改',
       presetNameRequired: '请输入预设名称',
@@ -70,6 +71,7 @@ window.__ModuleLoader__.load({
         placeholder: '自訂文案：點「＋ 插入資訊」，或直接輸入文字',
         insertInfo: '＋ 插入資訊', insertTitle: '在游標處插入資訊', preview: '預覽：',
         skipSubagents: '跳過子代理會話',
+        pushMode: '推送方式', pushDual: '系統通知 + 頁內提示', pushSystem: '僅系統通知', pushToast: '僅頁內提示',
         discard: '放棄', save: '儲存', saving: '儲存中…', saved: '已儲存 ✓ · 重新整理頁面後生效', saveFailed: '儲存失敗：', refresh: '點擊重新整理',
         saveAs: '新增', update: '修改', remove: '刪除', presetNamePlaceholder: '預設名稱', confirm: '確定', cancel: '取消', customSaved: '自訂預設已儲存', customUpdated: '自訂預設已更新', customDeleted: '自訂預設已刪除', saveAsTitle: '將當前設定另存為自訂預設', updateTitle: '更新目前自訂預設', removeTitle: '刪除目前自訂預設', fromPreset: '來自：', modifiedSuffix: ' · 已修改',
       presetNameRequired: '請輸入預設名稱',
@@ -87,6 +89,7 @@ window.__ModuleLoader__.load({
         placeholder: 'Custom text: use “＋ Insert info”, or type directly',
         insertInfo: '＋ Insert info', insertTitle: 'Insert info at cursor', preview: 'Preview: ',
         skipSubagents: 'Skip subagent sessions',
+        pushMode: 'Push channel', pushDual: 'System + in-page', pushSystem: 'System only', pushToast: 'In-page only',
         discard: 'Discard', save: 'Save', saving: 'Saving…', saved: 'Saved ✓ · refresh page to apply', saveFailed: 'Save failed: ', refresh: 'Refresh',
         saveAs: 'New', update: 'Edit', remove: 'Delete', presetNamePlaceholder: 'Preset name', confirm: 'OK', cancel: 'Cancel', customSaved: 'Custom preset saved', customUpdated: 'Custom preset updated', customDeleted: 'Custom preset deleted', saveAsTitle: 'Save current config as custom preset', updateTitle: 'Update current custom preset', removeTitle: 'Delete current custom preset', fromPreset: 'From: ', modifiedSuffix: ' · modified',
       presetNameRequired: 'Please enter a preset name',
@@ -104,6 +107,7 @@ window.__ModuleLoader__.load({
         placeholder: 'カスタム文面：「＋ 情報を挿入」または直接入力',
         insertInfo: '＋ 情報を挿入', insertTitle: 'カーソル位置に情報を挿入', preview: 'プレビュー：',
         skipSubagents: 'サブエージェントセッションをスキップ',
+        pushMode: '通知チャネル', pushDual: 'システム+ページ内', pushSystem: 'システムのみ', pushToast: 'ページ内のみ',
         discard: '破棄', save: '保存', saving: '保存中…', saved: '保存しました ✓ · ページを再読み込み', saveFailed: '保存失敗：', refresh: '再読み込み',
         saveAs: '新規', update: '編集', remove: '削除', presetNamePlaceholder: 'プリセット名', confirm: '決定', cancel: 'キャンセル', customSaved: 'カスタムプリセットを保存しました', customUpdated: 'カスタムプリセットを更新しました', customDeleted: 'カスタムプリセットを削除しました', saveAsTitle: '現在の設定をカスタムプリセットとして保存', updateTitle: '現在のカスタムプリセットを更新', removeTitle: '現在のカスタムプリセットを削除', fromPreset: '由来：', modifiedSuffix: ' · 変更あり',
       presetNameRequired: 'プリセット名を入力してください',
@@ -121,6 +125,7 @@ window.__ModuleLoader__.load({
         placeholder: '사용자 지정 문구: "＋ 정보 삽입" 또는 직접 입력',
         insertInfo: '＋ 정보 삽입', insertTitle: '커서 위치에 정보 삽입', preview: '미리보기: ',
         skipSubagents: '하위 에이전트 세션 건너뛰기',
+        pushMode: '알림 채널', pushDual: '시스템+페이지 내', pushSystem: '시스템만', pushToast: '페이지 내만',
         discard: '취소', save: '저장', saving: '저장 중…', saved: '저장됨 ✓ · 새로고침 후 적용', saveFailed: '저장 실패: ', refresh: '새로고침',
         saveAs: '추가', update: '수정', remove: '삭제', presetNamePlaceholder: '프리셋 이름', confirm: '확인', cancel: '취소', customSaved: '사용자 지정 프리셋 저장됨', customUpdated: '사용자 지정 프리셋 업데이트됨', customDeleted: '사용자 지정 프리셋 삭제됨', saveAsTitle: '현재 구성을 사용자 지정 프리셋으로 저장', updateTitle: '현재 사용자 지정 프리셋 업데이트', removeTitle: '현재 사용자 지정 프리셋 삭제', fromPreset: '출처: ', modifiedSuffix: ' · 수정됨',
       presetNameRequired: '프리셋 이름을 입력하세요',
@@ -183,7 +188,7 @@ window.__ModuleLoader__.load({
           var notice = readNoticeAny(id)
           if (notice || Date.now() - start > 6000) {
             retryTimer = null
-            notifyUser(pushTitle(name, notice ? '' : ' 已完成'), notice || (cwdLine ? cwdLine + ' · ' : '') + '详情见会话内系统消息')
+            notifyUser(pushTitle(name, notice ? '' : ' 已完成'), notice || (cwdLine ? cwdLine + ' · ' : '') + '详情见会话内系统消息', pushModeOf())
             return
           }
           retryTimer = setTimeout(attempt, 400)
@@ -191,6 +196,17 @@ window.__ModuleLoader__.load({
         attempt()
       }
 
+      /** 推送通道：读设置快照；未设置/异常回落 dual（保持原双通道行为）。 */
+      function pushModeOf() {
+        try {
+          if (notifyScope) {
+            var st = notifyScope.getSnapshot()
+            if (st && st.value && ['dual', 'system', 'toast'].indexOf(st.value.pushMode) >= 0) return st.value.pushMode
+          }
+        } catch (e) { /* 默认 */ }
+        return 'dual'
+      }
+
       /** 推送标题：用户模板（{title} = 会话标题）；无通知时附带完成标记。 */
       function pushTitle(name, suffix) {
         var tpl = '{title}'
@@ -327,12 +343,16 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * 推送：系统通知（每次独立 tag，避免同 tag 替换/分组折叠导致后续弹窗不可见）
-     * + 页内 toast **总是展示**（保底可见反馈，即使系统通知被平台静默/折叠）。
+     * 推送：按 pushMode 决定通道——
+     *  - dual（默认）：系统通知（每次独立 tag，避免同 tag 替换/分组折叠导致后续弹窗不可见）+ 页内 toast 保底；
+     *  - system：仅系统通知（QQ 浏览器等 Chromium 壳把 Notification 渲染成页内横幅时配合关闭 toast）；
+     *  - toast：仅页内 toast（Chromium 壳浏览器推不了 Windows 通知时用——不再调用 Notification API，
+     *    浏览器横幅/气泡不会出现，页内只有插件自己的小 toast）。
      */
-    function notifyUser(title, body) {
+    function notifyUser(title, body, pushMode) {
+      var mode = pushMode === 'system' || pushMode === 'toast' ? pushMode : 'dual'
       try {
-        if (typeof Notification !== 'undefined') {
+        if (mode !== 'toast' && typeof Notification !== 'undefined') {
           if (Notification.permission === 'granted') {
             // 每次完成事件的独立 tag：不与前一次互相替换，也不被折叠成一个分组条目
             var n = new Notification(title, { body: body, tag: PLUGIN_TAG + ':' + Date.now(), silent: false })
@@ -359,8 +379,7 @@ window.__ModuleLoader__.load({
           }
         }
       } catch (e) { /* 环境不支持 Notification → toast 兜底 */ }
-      // toast 永远展示：保底通道，保证每次完成都有可见弹窗
-      showToast(title, body)
+      if (mode !== 'system') showToast(title, body)
     }
 
     function log(message) {
@@ -564,7 +583,12 @@ window.__ModuleLoader__.load({
       }
       /** 扁平快照（用于 dirty 对比与模板打包）。 */
       function flatOf(cur) {
-        var out = { language: LANG_IDS.indexOf(cur.language) >= 0 ? cur.language : 'zh', titleTemplate: String(cur.titleTemplate ?? ''), includeDuration: !!cur.includeDuration, includeUsage: !!cur.includeUsage }
+        var out = {
+          language: LANG_IDS.indexOf(cur.language) >= 0 ? cur.language : 'zh',
+          titleTemplate: String(cur.titleTemplate ?? ''),
+          includeDuration: !!cur.includeDuration, includeUsage: !!cur.includeUsage,
+          pushMode: ['dual', 'system', 'toast'].indexOf(cur.pushMode) >= 0 ? cur.pushMode : 'dual',
+        }
         for (var i = 0; i < REASON_FIELDS.length; i++) out['tpl-' + REASON_FIELDS[i]] = templateOf(cur, REASON_FIELDS[i])
         return out
       }
@@ -934,6 +958,7 @@ window.__ModuleLoader__.load({
             scope.set('language', flat.language),
             scope.set('templates', templates),
             scope.set('titleTemplate', flat.titleTemplate),
+            scope.set('pushMode', flat.pushMode),
           ]
           Promise.all(tasks).then(function () {
             // 预设自动同步：
@@ -1041,6 +1066,14 @@ window.__ModuleLoader__.load({
             }, LANG_OPTIONS.map(function (o) {
               return darkOption({ value: o.id, key: o.id }, o.label)
             })), 'language'),
+            fieldRow(t.pushMode, h('select', {
+              value: ['dual', 'system', 'toast'].indexOf(cur.pushMode) >= 0 ? cur.pushMode : 'dual',
+              onChange: function (e) { setVal('pushMode', e.target.value) }, style: SELECT_STYLE,
+            }, [
+              darkOption({ value: 'dual', key: 'dual' }, t.pushDual),
+              darkOption({ value: 'system', key: 'system' }, t.pushSystem),
+              darkOption({ value: 'toast', key: 'toast' }, t.pushToast),
+            ]), 'pushMode'),
             h('div', { key: 'title-row', style: { display: 'flex', flexDirection: 'column', gap: '6px', padding: '12px 0', borderTop: DIVIDER } },
               h('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center' } },
                 h('div', { style: { fontSize: '13px', color: 'var(--dsw-alias-label-secondary, inherit)' } }, t.titleLabel),

package/lib/index.js

@@ -77,6 +77,8 @@ const DEFAULT_SETTINGS = {
   includeDuration: true,
   includeUsage: true,
   skipSubagents: true,
+  /** 推送通道：dual=系统通知+页内提示（默认）；system=仅系统通知；toast=仅页内提示。 */
+  pushMode: 'dual',
 }
 
 /** 从任意输入规整为设置形状（容忍缺失/多余字段）。 */
@@ -94,6 +96,7 @@ function sanitizeSettings(raw) {
     includeDuration: typeof src.includeDuration === 'boolean' ? src.includeDuration : true,
     includeUsage: typeof src.includeUsage === 'boolean' ? src.includeUsage : true,
     skipSubagents: typeof src.skipSubagents === 'boolean' ? src.skipSubagents : true,
+    pushMode: ['dual', 'system', 'toast'].includes(src.pushMode) ? src.pushMode : 'dual',
   }
 }
 
@@ -130,6 +133,7 @@ export function apply(ctx, config = {}) {
       includeDuration: Schema.boolean().default(true),
       includeUsage: Schema.boolean().default(true),
       skipSubagents: Schema.boolean().default(true),
+      pushMode: Schema.union(['dual', 'system', 'toast']).default('dual'),
     })
     let attempts = 0
     const tryRegister = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telosmaylx/dsh-session-notify",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "DSH session completion notifier: appends a plugin system message to the session log on turn/end and pushes browser notifications (Web Notification + toast), with a fully customizable official settings panel (presets, 5-language templates, cache-hit rate & tok/s from official projections).",
   "private": false,
   "type": "module",