前言¶

使用 DeepSeek Harness（DSH）做开发时，AI 的思考、权限请求和完成状态主要出现在 Web UI 中。切到其它应用时，容易错过状态变化。

dsh-thinking-notifier 是一个 DSH 插件。它在屏幕右下角显示一个小型常驻顶部桌面弹窗，实时镜像 AI 思考状态，并在请求权限或完成思考时提醒。

这是什么¶

• 由 6-debug-6 维护的 DSH 插件。
• 许可证：MIT。
• 不需要浏览器扩展，弹窗是原生桌面窗口。
• Windows 使用 PowerShell + WPF；macOS/Linux 使用 Python 3 + tkinter。
• 插件会在 DSH 运行期间加载，并启动本地桌面弹窗进程。

核心功能¶

下面介绍它覆盖的四种状态：

1、AI 思考中

• 显示 DeepSeek 蓝色脉冲点、AI 正在思考… 和已耗时。
• 5 秒后自动收起为右侧 25 px 窄边标签。
• 可悬停或点击标签展开。

2、AI 请求权限

• 显示琥珀色脉冲点、AI 请求权限 和会话/工具名。
• 播放 system Exclamation 声音。

3、AI 完成思考

• 显示绿点、AI 已完成思考。
• 12 秒后自动隐藏。
• 播放 system Asterisk 声音。

4、空闲

• 隐藏弹窗。

另外，它还有以下行为：

• 使用 DeepSeek 风格深色调卡片：#1E2235 / #4D6BFE。
• 无边框、常驻顶部，位于右下角，可在任意应用上方显示。
• 自动汇总多个会话。
• DSH 运行期间弹窗进程保持存活；状态端点不可达约 15 秒后退出。

工作方式¶

插件在本地提供状态端点：

http://127.0.0.1:7389/status

桌面弹窗每秒轮询 /status，根据状态渲染卡片、收起为窄边标签，并在权限请求或完成思考时播放系统声音。

本地状态服务端口默认是 7389。若端口忙碌，资料说明会尝试后续 10 个端口。

安装与启用¶

资料中给出两种安装路径：本地 checkout 和 npm。npm 命令在 README 中标注为 once published，发布状态未确认。若从本地源码安装，先做本地安装，再启动 Web UI：

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

如果后续以 npm 包形式提供，资料中给出的命令是：

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

卸载：

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

经过上面的步骤，DSH Web UI 启动后会加载插件，弹窗进程由插件启动。

典型用法¶

安装并启用后，可以先检查状态端点是否可用：

http://127.0.0.1:7389/status

如果需要调整本地状态服务端口，可以设置环境变量：

DSH_THINKING_NOTIFIER_PORT

默认值为 7389。

调试日志写入以下路径：

• ~/.dsh/tn-plugin.log
• ~/.dsh/tn-launcher.log
• ~/.dsh/tn-popup-debug.log

如果重启 dsh web 后弹窗没有出现，先查这些日志。

适用场景与注意¶

适合在运行 DSH 时，需要离开当前窗口但仍然关注 AI 状态的人。它解决的是“状态只在 Web UI 中可见”的问题。

使用前需要注意：

• 需要 DeepSeek Harness Web UI（dsh web）。
• 需要 Node.js ^22.19.0 || >=24.0.0。
• Windows 需要 Windows 10/11 与 PowerShell 5.1+。
• macOS/Linux 需要 Python 3 与 tkinter。
• 插件会在当前 DSH 进程的权限环境中运行，并启动本地弹窗进程；安装前应检查源码与许可证。
• 资料中 npm 安装命令标注 once published，发布状态未确认。
• package.json 中 repository、bugs、homepage 使用 YOUR_GITHUB_USERNAME 占位符，与提供的 GitHub 地址不一致；本文链接以资料中给出的地址为准。

链接¶

• 目录页：https://www.skillhub.cn/plugins/6-debug-6/dsh-thinking-notifier
• GitHub：https://github.com/6-debug-6/dsh-thinking-notifier

dsh-thinking-notifier 的作用是，把 DSH 的思考、权限请求和完成状态放到桌面右下角，便于在其它应用上方查看。