MIT 许可的 DSH 插件:在 Windows 10/11 屏幕顶端挂一个始终置顶的刘海,显示哪些 DeepSeek Harness 会话在工作、哪些在等你、哪些已完成或失败,并用 Open 直接切到那个会话。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-15
许可证
MIT
01它能帮你完成什么?
在别的窗口里干活时,一眼看出哪个 DeepSeek Harness 会话正在等你
屏幕顶端一个始终置顶的标签:会话需要你、失败或完成时短暂展开成带原因的提示,Open 按钮直接把应用切到那个会话
同时开好几个 DSH 会话、每次都要 alt-tab 逐个读侧边栏才知道有没有事在等自己的人
在一个可折叠的面板里看清每个会话的状态、上下文用量和当前步骤,而不是来回切窗口
面板顶部是最近变化的那个会话(标题、项目、存活时长、上下文用量、正在运行的工具或完整的问题),其余会话在下方列表里滚动查看
把 harness 最小化或丢在托盘里、想在不把应用调到前台的情况下掌握全局的人
不用盯着应用,也知道会话什么时候完成或失败
只针对新事件的几秒钟提示(需要你、失败、完成),以及宿主不再回应时变灰并标注最后心跳时间的标签
让长时间的 agent 回合自己跑、只想在真的有变化时被打断的开发者
02如何接入 DeepSeek Harness?
前置条件
- Windows 10/11 x64 —— 窗口是 WPF 加 Win32 实现,没有 macOS 或 Linux 构建
- DeepSeek Harness —— 插件是在 0.2.1-rc.2 上构建并验证的
- 插件需要 Node 22 及以上(无需 .NET 运行时:发行版窗口程序是自包含的)
- 可选:`session-finished` 插件,已完成的行靠它收掉
安装步骤
- 01
执行 `dsh plugin --profile web add dsh-agents-notch`;如果 harness 跑在其他 profile 下,把 `web` 换成那个 profile 的名字
$ dsh plugin --profile web add dsh-agents-notch
- 02
让首次运行把窗口拉下来:它从本仓库的 GitHub Release 下载一个 65 MB 文件,并与已公布的 SHA-256 校验
验证接入成功
- 没看到刘海时,看 `$DSH_HOME\state\agents-notch\host-report.jsonl` 的最后一行:它写着宿主去哪里找窗口、下载是否成功,以及修复用的命令
回滚
- 用 `dsh plugin --profile web remove dsh-agents-notch` 卸载插件
- 用 `Remove-Item -Recurse "$env:DSH_HOME\state\agents-notch"` 删掉状态文件、日志、窗口程序和解包缓存
03DSH 适配与能力边界
用 `dsh plugin` CLI 安装的原生 DSH 插件:宿主侧读取 DSH 会话事件,应用内一侧驱动一个独立的置顶 WPF 窗口
始终置顶的会话刘海
插件宿主侧上报的 DSH 会话:工作中、需要你、完成、失败→顶部标签上每个会话一个小机器人 —— 工作中是缓慢转动的蓝色弧线,需要你是琥珀色,完成是绿色,失败是红色
从不抢焦点;指针只是经过时标签变淡,点击直接穿透到下面的窗口全屏应用下自动隐藏可展开的面板
指针在标签上停留 1.6 秒,或把指针推到屏幕顶边→大机器人上是最近变化的会话(标题、项目、存活时长、上下文用量、正在运行的工具或完整的问题),下方是其余会话的滚动列表
单击一行把该会话放到大机器人上;双击一行或按 Open ↗ 把 DeepSeek Harness 切到它带 Open 按钮的提示
新的需要你、失败或完成事件→标签短暂展开的提示,显示原因(或最后运行的工具与会话标题)和 Open 按钮
只播报新事件;等了一小时的问题留在面板里,不会弹到面前独立设置页与 YAML 配置行
设置 → Agents Notch,或 `$DSH_HOME/profiles/web/cordis.patch.yml` 里 id 相同的一行→大小、位置、显示器、行数、不透明度、动效、悬停方式、提示类型和 `contextBudget`,改完下一个 tick 生效,不用重启
设置页写进 `$DSH_HOME/state/agents-notch/settings.json` 的值,优先于 profile 里那一行的 `config:`首次运行自下载窗口并校验哈希
`autoDownload` 为 `true` 时的第一次运行→状态目录里一个自包含的 WPF 窗口程序,与已公布的 SHA-256 校验
从本仓库的 GitHub Release 下载一个 65 MB 文件,所以首次运行需要联网`autoDownload: false` 可以关掉下载,`downloadUrl` 指向镜像或自己构建的窗口
04适合谁?何时不该用?
适合
- 同时开好几个 DSH 会话、每次都要 alt-tab 逐个读侧边栏才知道有没有事在等自己的人
- 把 harness 最小化或丢在托盘里、想在不把应用调到前台的情况下掌握全局的人
- 让长时间的 agent 回合自己跑、只想在真的有变化时被打断的开发者
不适合
- 仅支持 Windows:窗口用 WPF 和 Win32 实现(置顶、不抢焦点、全屏检测),package.json 声明 "os": ["win32"],README 明确写了没有 macOS 或 Linux 构建,也没有残缺版。
- manifest 里没有声明 DSH 版本,装错了也不会被拦住:插件在 0.2.1-rc.2 上构建和验证,宿主侧读取 session/event、ctx.webServer、ctx.agents 和 sessionQuery,挂载前不做任何检查。
- 下载的窗口程序没有签名,首次运行时 Windows SmartScreen 会警告;它来自本仓库的 GitHub Release 并按已公布的 SHA-256 校验,也可以用 `autoDownload: false` 加 `tools/install-window.ps1` 手动装一个窗口。
05兼容性、维护与安全提示
- 仅支持 Windows:窗口用 WPF 和 Win32 实现(置顶、不抢焦点、全屏检测),package.json 声明 "os": ["win32"],README 明确写了没有 macOS 或 Linux 构建,也没有残缺版。
- manifest 里没有声明 DSH 版本,装错了也不会被拦住:插件在 0.2.1-rc.2 上构建和验证,宿主侧读取 session/event、ctx.webServer、ctx.agents 和 sessionQuery,挂载前不做任何检查。
- 下载的窗口程序没有签名,首次运行时 Windows SmartScreen 会警告;它来自本仓库的 GitHub Release 并按已公布的 SHA-256 校验,也可以用 `autoDownload: false` 加 `tools/install-window.ps1` 手动装一个窗口。
MIT · latest release v0.2.1 (2026-11-10)
06常见问题
在 DSH 里怎么安装 Agents Notch?
执行 `dsh plugin --profile web add dsh-agents-notch`;如果 harness 跑在其他 profile 下,把 `web` 换成那个 profile 的名字。插件本体约 30 KB,首次运行时会从本仓库的 GitHub Release 下载窗口程序(一个 65 MB 文件),并与已公布的 SHA-256 校验。
macOS 或 Linux 能用吗?
不能。窗口是 WPF 加 Win32 实现(置顶、不抢焦点、全屏检测),`package.json` 声明 `"os": ["win32"]`。README 写得很直白:没有 macOS 或 Linux 构建,也没有残缺版。
对 DeepSeek Harness 版本有要求吗?
manifest 里没有声明 DSH 版本,所以装错了也不会被拦住。插件在 0.2.1-rc.2 上构建并验证:宿主侧读取 session/event、ctx.webServer、ctx.agents 和 sessionQuery,应用内一侧用 uiWorkspace,旧一点的版本可能缺其中一个。挂载前不做任何检查,所以缺字段时是日志里说明哪里失败,而不是让宿主停掉。
为什么看不到上下文百分比?
上下文窗口属于模型路由,会话流里不带这个信息,所以 `contextBudget` 默认是 `null`:只显示 token 数,没有百分比、没有进度条也不会变成琥珀色。把它设成你这条路由的真实窗口(这个构建的 DeepSeek V4 路由是 `1000000`),百分比和进度条才会出现。
插件的状态文件放在哪?Open 需要应用在运行吗?
状态文件、日志和窗口程序都在 `$DSH_HOME/state/agents-notch` 下;README 描述的联网步骤只有首次运行从本仓库的 GitHub Release 下载窗口并按已公布的 SHA-256 校验,可以用 `autoDownload: false` 关掉。刘海从不抢焦点、全屏应用下自动隐藏;Open 走的是插件的应用内一侧,所以 DeepSeek Harness 必须正在运行 —— 刘海能把窗口从任务栏或托盘叫回来,但不能启动应用。
07相关的 DSH 工作流
ds-harness-remote
作者 liguobao
基于 DeepSeek Harness 插件机制构建的远程访问方案,通过低延迟、端到端加密的 P2P 网络,支持使用 PC、移动端 和 Web 随时访问本地设备上的DSH 、CodeX、Cursor、Claude Code等工作区。 (Built on DeepSeek Harness plugins, this low-latency, end-to-end encrypted P2P solution lets PC, mobile, and web clients access local DSH, Codex, Cursor, and Claude Code workspaces.)
dsh-windows-mcp
作者 hellohub1212
DeepSeek Harness Windows 桌面自动化插件,将 CursorTouch/Windows-MCP 接入内置 MCP 客户端桥接。提供默认关闭的 Computer Use 开关和应用内依赖安装器。
dsh-desktop
作者 anywhere-labs
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。
dsh-go
作者 ccch1mneyyy
dsh-go — DeepSeek Harness 装进口袋:手机本机运行,也能遥控你的电脑。
08数据与来源
**An always-on-top notch for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) that answers one quest…
dsh plugin --profile web add dsh-agents-notch
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-15。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
