返回目录

dsh-agents-notch

精选清单收录维护状态: 活跃

iarxic/dsh-agents-notch

面向 Windows 的 DeepSeek Harness 悬浮状态栏,展示各会话正在运行、等待处理或已完成的状态。

前往 GitHub
$ dsh plugin --profile web add dsh-agents-notch

19

星标

0

Fork

JavaScript

语言

MIT

许可证

2026-10-21

创建于

2026-11-10

最近推送

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` 插件,已完成的行靠它收掉

安装步骤

  1. 01

    执行 `dsh plugin --profile web add dsh-agents-notch`;如果 harness 跑在其他 profile 下,把 `web` 换成那个 profile 的名字

    $ dsh plugin --profile web add dsh-agents-notch

  2. 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 适配原生运行时

用 `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` 手动装一个窗口。
2026-10-212026-11-10v0.2.1

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 必须正在运行 —— 刘海能把窗口从任务栏或托盘叫回来,但不能启动应用。

08数据与来源

  • 作者声明github.com80b0f274ad54…

    **An always-on-top notch for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) that answers one quest…

  • 作者声明github.com80b0f274ad54…

    dsh plugin --profile web add dsh-agents-notch

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-15。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。