前言¶
DeepSeek Harness（DSH）里需要人工拍板的请求，会以会话内的黄色审批卡片呈现。你一旦切到别的应用——例如全屏浏览器里查资料——界面里那张卡不在眼前，很容易漏掉等待中的审批。社区插件 dsh-notify-card（维护者 PlasmaPerfuma）针对 Windows 桌面场景：在你不在 DSH 前台时弹出独立小窗；切回 DSH 后浮窗收起，仍由 DSH 原生黄卡接管。下面介绍它的定位、行为、安装与使用注意。
这是什么¶
dsh-notify-card 是 DSH 的客户端类插件：在 Windows 上用 WPF 经 PowerShell 拉起独立审批浮窗。项目为 dsh-notify-zeta（zeta987，MIT）的独立分支并做了较大改造；当前版本 1.0.3，许可证 MIT。
一句话：Standalone approval window for DeepSeek Harness — 离开 DSH 时弹出，回到 DSH 时交还原生卡片，外观主题跟随 DSH 设定。
它解决什么问题¶
DSH 审批只在会话界面出现。全屏或切到其他软件时，你不知道 Harness 正在等你点允许或拒绝。dsh-notify-card 在你离开 DSH 时接管展示与操作；你回到 DSH 时主动让位，避免和原生黄卡重复打扰。
核心行为¶
| 场景 | 表现 |
|---|---|
| 你在别的软件里，DSH 需要审批 | 弹出独立浮窗，含允许 / 拒绝 |
| 你把 DSH 切回前台 | 浮窗自动消失，黄色卡片接管 |
| 你一直看着 DSH | 不弹浮窗，直接出黄色卡片 |
| 任务完成 | 照常弹提示（长内容收进独立框，按钮始终可见） |
| 记忆反思等后台任务 | 静默，不打扰 |
外观要点（来自 README）：无系统标题栏，圆角卡片与阴影、始终置顶，任务栏不增加多余图标；主题读 DSH 的 cordis.patch.yml 中 preference，读不到再退回 Windows 应用主题；界面为全简体中文；允许为黑底白字、拒绝为白底描边的大圆角按钮。可能变长的正文放在带描边的独立小框内（7px 细滑块），按钮无需滚动即可点击。
相对上游 dsh-notify-zeta 的主要改动包括：前台/后台与原生卡片的交接逻辑、主题跟随 DSH 而非仅跟随 Windows、外观重做，以及修复会导致所有卡片渲染失败的 XAML 命名空间问题。
环境要求¶
- Windows（浮窗使用 WPF）
- DSH
>= 0.1.5-rc.1 - Node
>= 22.19.0
安装与启用¶
在 PowerShell 中执行官方安装命令：
dsh plugin --profile desktop add dsh-notify-card
从本地目录安装时：
dsh plugin --profile desktop add link:C:\path\to\dsh-notify-card
安装后重启 DSH 再验证审批流程。
设置说明¶
配置文件位于 profile 目录下的 notify-card.settings.json。主题不必在此单独配置，会跟随 DSH 设置界面里选的外观。
当前版本没有设置界面：上游曾带设置页，但在桌面壳（dsh-app://）下用相对路径请求宿主 HTTP 路由会显示「连接中断」；本版在 package.json 中未挂载 dsh.client，相关代码保留在 lib/client.js，待改用官方客户端接口后再启用。
典型用法¶
无需额外 API 调用：安装并重启 DSH 后，按平时使用 Harness 的方式触发需要审批的操作即可。
- 保持 DSH 在后台或切到其他窗口，等待出现独立浮窗，点击允许或拒绝。
- 切回 DSH 前台，确认浮窗消失且会话内黄卡可继续操作。
- 若你始终停留在 DSH 界面，应只看到原生黄卡，不应再弹独立窗。
任务完成类通知、后台记忆反思等行为见上表，与审批浮窗分工不同。
适用场景与注意¶
适合：在 Windows 上使用 DSH 桌面 profile，且经常在全屏浏览器或其他应用里工作、又不想漏审批的开发者。
注意：
- 仅支持 Windows；Linux / macOS 不在 README 支持范围内。
- 插件随当前 DSH 进程权限运行；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证。
- DSH 生态是「一切皆插件」思路；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系，本文安装命令以 README 为准，请勿自行拼接未在文档出现的
github:owner/repo安装形式。
结尾¶
dsh-notify-card 把「人不在 DSH 窗口前」和「人在 DSH 里」两种状态分开处理：离开时有置顶浮窗，回来仍走原生黄卡，主题与 DSH 一致。若你在 Windows 桌面 Harness 上常被全屏应用挡住审批，可先按上文命令安装并重启验证。
- 目录页：https://www.skillhub.cn/plugins/PlasmaPerfuma/dsh-notify-card
- GitHub：https://github.com/PlasmaPerfuma/dsh-notify-card
