6-debug-6/dsh-thinking-notifier

dsh-thinking-notifier

一个 DeepSeek Harness (DSH) 插件：在屏幕右下角显示一个置顶桌面悬浮窗，实时显示 AI 思考状态；当 AI 请求权限或完成思考时，弹出提醒并播放系统提示音。即使你切到其它网页、桌面或桌面应用，也能看到统一风格的弹窗。

English version: README.md

功能

| 状态 | 悬浮窗 | 声音 |
| --- | --- | --- |
| AI 正在思考 | DeepSeek 蓝呼吸点 + AI 正在思考… + 计时；5 秒后自动收起为右侧 25 像素边缘状态条，悬停或点击可展开 | 无 |
| AI 请求权限 | 琥珀色呼吸点 + AI 请求权限 + 会话/工具名 | 系统 Exclamation |
| AI 完成思考 | 绿色点 + AI 已完成思考，12 秒后自动隐藏 | 系统 Asterisk |
| 空闲 | 自动隐藏 | 无 |

- DeepSeek 风格深色卡片（#1E2235 / #4D6BFE）。
- 无边框置顶窗口，右下角显示，覆盖所有应用。
- 思考中显示 5 秒后自动收起为右侧 25 像素边缘状态条，既保持可见又不遮挡桌面按键。
- 鼠标悬停或点击边缘状态条可手动展开；新的思考、权限请求或完成状态会自动展开。
- 点击右上角 X 可提前关闭当前弹窗；后续新的思考、权限请求或完成状态会重新显示。
- 多个会话自动汇总显示。
- 弹窗进程在 DSH 运行期间常驻；状态服务不可达约 15 秒后自动退出。
- 不需要浏览器扩展，弹窗是原生桌面窗口。

工作原理

DSH 进程
└─ lib/index.js（主机插件）
├─ 监听 session/event：turn/start、turn/end、approval/asked、approval/decided、session/title
├─ 启动时从 ctx.sessions.list() 重建已有会话状态
├─ 在 http://127.0.0.1:7389/status 提供本地状态 JSON
└─ 拉起桌面弹窗进程
├─ Windows: desktop-popup.ps1（PowerShell + WPF）
└─ macOS/Linux: desktop-popup.py（Python 3 + tkinter）

桌面弹窗
├─ 每 1 秒轮询 /status
├─ 渲染 DeepSeek 风格卡片（running/pending/done/idle）
├─ pending/done 状态切换时播放系统提示音
├─ 思考中自动收起为右侧 25 像素边缘状态条，新状态自动展开
└─ 空闲时隐藏，进程保持运行

安装

本地安装

cd dsh-thinking-notifier
dsh plugin --profile web add .

重启 DSH Web 以加载主机插件
dsh web

发布到 npm 后安装

dsh plugin --profile web add dsh-thinking-notifier
dsh web

卸载

dsh plugin --profile web remove dsh-thinking-notifier

配置

| 环境变量 | 默认值 | 说明 |
| --- | --- | --- |
| DSH_THINKING_NOTIFIER_PORT | 7389 | 本地状态服务端口，被占用时自动顺延 10 个端口 |

环境要求

- DeepSeek Harness Web UI（dsh web）
- Node.js ^22.19.0 || >=24.0.0
- Windows：Win10/11 自带 PowerShell 5.1+
- macOS/Linux：Python 3 + tkinter

项目结构

dsh-thinking-notifier/
├── lib/
│   └── index.js          # 主机插件：状态服务 + 弹窗拉起
├── desktop-popup.ps1     # Windows 原生弹窗（PowerShell + WPF）
├── desktop-popup.py      # macOS/Linux 原生弹窗（Python 3 + tkinter）
├── cordis.patch.yml      # DSH bundle patch，用于持久挂载
├── package.json          # npm 包 + dsh.bundle 声明
├── README.md             # 英文说明
├── README.zh.md          # 中文说明
├── CHANGELOG.md
├── CONTRIBUTING.md
└── LICENSE

排错

调试日志位置：

- ~/.dsh/tn-plugin.log — 主机插件生命周期与启动器状态。
- ~/.dsh/tn-launcher.log — 启动器创建的弹窗进程 PID。
- ~/.dsh/tn-popup-debug.log — 弹窗脚本生命周期与轮询错误。

重启 dsh web 后如果看不到弹窗，请先查看以上日志。

License

MIT