TianzeLuo/dsh-away-notify ↗★ 2

dsh-away-notify

DSH plugin: Codex-like desktop notifications that fire only when you are away. Native Windows Toast for both native-Windows and WSL dsh, with session deep-link on click.

Package
dsh-away-notify
Compatibility
Unverified
Version
0.1.0
License
MIT
Last updated
Nov 1, 2026

Other repositories with this package name

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:TianzeLuo/dsh-away-notify

配置

在 profile 的 cordis.patch.yml 里按 id 覆盖(该文件被热监视,但新增 bundle 后首次仍需重启):

- id: dsh-away-notify
  config:
    # 五类触发
    onTurnComplete: true
    onTurnError: true
    onTurnAborted: true
    onTurnMaxTokens: true
    onApproval: true
    onQuestion: true
    onGoalComplete: true
    # 行为
    suppressGoalRounds: true   # /goal 中间轮次静默
    rootsOnly: true            # 子代理 + 内部 worker 会话不打扰
    # 内部 worker 的标题前缀——只是**后备**:super-agent 会在创建 worker 时主动登记
    # (awayNotify.markInternal)。这里覆盖「away-notify 未装/旧版」与「升级前已存在」的会话。
    # 配成 [] 只关掉标题这条路,不影响登记。见 docs/implementation-notes.md
    internalSessionTitlePrefixes:
      - 'Super-agent worker ·'
    # 插件面板(如 super-agent 的 Router 面板)以此 source retain 会话时,
    # 该会话算「你正在看」——面板里显示的那条不该再弹通知。
    # 浏览器半部还会从界面自动学习面板来源(并用于点击落点),这里只是后备清单
    panelSessionSources:
      - 'superAgentUi'
    cooldownMs: 10000          # 同会话同类型最小间隔
    presenceTtlMs: 45000       # 在场状态有效期
    previewMaxChars: 140       # 正文摘要截断长度
    sound: true                # 系统提示音
    openOnClick: true          # Toast 可点击回跳
    persistent: true           # 通知一直停留,直到点它或切回 dsh
    dismissOnReturn: true      # 切到某会话时撤回它自己的通知(按会话比对,不误伤别的会话)
    includeToken: true         # URL 带鉴权 token(取舍见 docs/security.md)
    useProtocolHandler: true   # 注册 dshnotify: 协议,点击优先聚焦已有窗口
    titleTag: true             # 给标题加 [dsh:
],多实例时精确聚焦对应窗口
    spoolDir: ''               # 点击请求与焦点助手的工作目录;留空 = /.focus-spool
    focusWindowMarker: 'DeepSeek Harness'  # 用窗口标题里的这个串识别 dsh 窗口
    focusTtlMs: 90000          # 「待跳转会话」有效期
    titlePrefix: 'DSH'
    appName: 'DeepSeek Harness'
    appId: 'DeepSeek Harness'  # Windows 通知来源名
    webUrl: ''                 # 留空则自动探测
    debug: false               # 写文件日志
    notifyOnLoad: false        # 加载时发自检通知

appName 目前没有接线(声明了但无处读取),改它不会有效果;要区分通知来源请改 appId。 includeToken 的取舍(token 会进本机通知历史)见安全说明。