前言¶
在 DeepSeek Harness（DSH）里同时跑多个会话时，「有没有哪条会话卡在我这边」往往要靠切窗口看侧边栏、等桌面通知，或把侧边栏一直开着——每一种都会打断你正在做的事，而且通知通常也说不清到底是哪条会话被阻塞。
dsh-agents-notch（Agents Notch）是社区维护者 iArxic 发布的 DSH 插件：在屏幕顶部放一条约 220×30 像素的常驻顶栏，每个 Harness 会话对应一个小格，悬停展开看谁在跑、谁在等你、谁失败、谁已完成你还没看。它回答的核心问题只有一个：此刻哪条会话需要我？
插件可通过 SkillHub 目录页 发现；目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系。源码与说明见 GitHub：iArxic/dsh-agents-notch。
这是什么¶
dsh-agents-notch 是面向 DeepSeek Harness 的插件：主机侧用 JavaScript 汇总会话状态，Windows 上再拉起一个 WPF 顶置小窗（不抢焦点、全屏应用下可隐藏），把「working / needs you / failed / host offline」四种状态用颜色环和符号一眼区分。
- working：默认态，无环。
- needs you：琥珀色环与
?。 - failed：红色环。
- host offline：Harness 不再响应，不代表一切正常。
单会话时顶栏更像装饰；多会话时才有「不用切回 Harness 窗口也能看到谁在等你」的价值。README 在 Limits 里写明了这一点。
当前包版本为 0.1.4（package.json），许可证 MIT。插件以当前 dsh 进程权限运行；安装前建议自行查看源码与许可证。
环境与依赖¶
下面几项来自 README 与 package.json，安装前请对照本机环境。
| 项 | 要求 |
|---|---|
| 操作系统 | Windows 10/11 x64；package.json 声明 "os": ["win32"]，无 macOS / Linux 构建 |
| DeepSeek Harness | 在 0.2.1-rc.2 上构建与验证；主机侧依赖 session/event（{ global: true }）、ctx.webServer、ctx.agents、sessionQuery 等，旧版本可能缺字段 |
| Node | ≥ 22（插件主机） |
| 窗口运行时 | 发布包为自包含可执行文件，无需单独安装 .NET 运行时 |
| 可选插件 | session-finished：用于正确「退休」已完成会话行（见 README What earns a row） |
核心功能¶
顶栏与会话板¶
每个 DSH 会话对应顶栏上的一个 bot；鼠标悬停展开面板，集中展示各会话状态，避免为「有没有人在等我」反复 alt-tab。
顶栏设计为 always-on-top、不获取焦点；可在全屏应用下隐藏（可通过配置关闭该行为）。
主机侧状态与上下文条¶
主机按配置间隔重建状态文件（默认 pollMs: 340）。若你在配置里提供路由的上下文窗口 token 数（contextBudget），界面可显示用量与进度条；默认为 null 时只显示 token 数、无百分比与琥珀色预警——README 强调不会凭空猜测上下文上限。
设置面板¶
Harness 内 Settings → Agents Notch 提供尺寸、锚点、显示行数、透明度、动效、文案开关等；修改会在下一 tick 被窗口读取，无需重启。浏览器侧写入 $DSH_HOME/state/agents-notch/settings.json；与 profile 里 cordis.patch.yml 中对 agents-notch 行的 config 叠加，优先级为：内置默认 → patch 配置 → 设置面板文件。
安装与启用¶
与其他 DSH 插件一样，一条命令安装（请将 <profile> 换成你的 profile 名，也可通过应用内插件管理器完成）：
dsh plugin --profile <profile> add dsh-agents-notch
插件本体约 30 KB JavaScript；约 65 MB 的窗口可执行文件不打进 npm 包。首次需要窗口且本地没有匹配版本时，主机会按 package.json 中的 repository 与版本号从 GitHub Release 拉取对应 AgentsNotch.exe，校验发布页旁的 .sha256，写入 $DSH_HOME\state\agents-notch\window\<version>\。
成功时：Harness 启动后数秒内，屏幕顶部应出现顶栏；$DSH_HOME\state\agents-notch\state.json 会列出会话。若未出现，同一目录下的 host-report.jsonl 最新一行会说明查找路径、是否尝试下载以及修复建议。
离线或需手动安装时，可使用包内脚本（路径中的 <profile>、版本 URL 请按你环境替换）：
pwsh -File "<profile>\node_modules\dsh-agents-notch\tools\install-window.ps1" `
-Url https://github.com/<owner>/dsh-agents-notch/releases/download/v0.1.1/AgentsNotch.exe
在插件行配置中，autoDownload: false 可关闭自动拉取；downloadUrl 可指向镜像。
配置示例¶
在 profile 的 patch 层（$DSH_HOME/profiles/<profile>/cordis.patch.yml）用与内置相同的 id 覆盖 agents-notch 行：
- id: agents-notch
config:
contextBudget: 1000000 # 你的路由上下文窗口，单位 token
anchor: top-right
scale: 1.25
常用字段（完整表见 README Configure）：
| 键 | 默认 | 含义 |
|---|---|---|
spawnWindow |
true |
false 时只跑主机、不启窗口（便于测试） |
maxRows |
6 |
面板最多显示会话数（3–10） |
anchor |
top-center |
top-center · top-left · top-right |
hideFullscreen |
true |
全屏应用下隐藏顶栏 |
showDone |
true |
false 时已完成会话不出现在面板与计数中 |
stateDir |
$DSH_HOME/state/agents-notch |
状态、日志与窗口相关文件目录 |
设置面板中的 Reset 会清掉 settings.json 第三层，再由 patch 与默认值决定行为。
典型用法与排障¶
- 在 Windows 上为指定 profile 执行安装命令，启动 Harness。
- 确认顶栏出现且
state.json有会话条目；多开几个会话，故意让一条进入「需要你确认」类状态，观察琥珀环与?。 - 需要上下文用量条时，在 patch 或设置里填写真实的
contextBudget，并按路由 compaction 习惯调整contextHotAt（默认0.5）。 - 若依赖「已完成」会话自动从列表消失，可一并安装
session-finished；否则依赖finishedFallbackMs（默认 900000 ms）等回退逻辑。
主机日志中可能出现窗口拉取与启动事件，例如：
{"event":"window-fetch","url":"https://github.com/<owner>/dsh-agents-notch/releases/download/v0.1.1/AgentsNotch.exe"}
{"event":"window-fetched","bytes":68276826,"verified":true}
{"event":"window-started","pid":6704,"source":"installed"}
适用场景与注意¶
适合：在 Windows 上长期并行多条 DSH 智能体会话，希望在做其他窗口工作时仍能看见「哪条会话 blocked 在我身上」的开发者。
不适合：macOS / Linux 用户（当前无对应构建）；只跑单会话且不在意顶栏提示的场景（价值有限）。
安全与权限：插件与 Harness 同进程权限运行；自动下载会访问 GitHub Release，企业网络需自行评估防火墙与镜像配置（downloadUrl / 手动 install-window.ps1）。
版本与字段：README 写明挂载前不会做完整能力探测；Harness 版本过旧可能导致字段缺失、行为异常，请以 README 列出的验证版本为参考升级主机。
结尾¶
dsh-agents-notch 把「多会话里谁需要我」压缩成屏幕顶端一条不占焦点的状态带，用主机汇总 + Windows 顶窗的方式补上侧边栏在后台工作时看不到的信息缺口。若你在 SkillHub 或 GitHub 看到更新，以仓库 README 与 Release 为准。
- 目录页：https://www.skillhub.cn/plugins/iArxic/dsh-agents-notch
- GitHub：https://github.com/iArxic/dsh-agents-notch
