前言¶

在 DeepSeek Harness (DSH) 的插件生态中，开发者常遇到”问完就切走、后台等结果”的场景。dsh-pharos（法罗斯灯塔）旨在解决这一问题，作为桌面守望提醒插件，它提供多路状态通知与系统交互能力，确保不会遗漏关键的任务完成、错误或需要人工介入的信号。

功能概览¶

该插件由 Leo Chen (Leo-Cjw) 维护，遵循 MIT 许可证。核心能力包括：

• 多路提醒：支持操作（审批/确认）、完成、错误、中断、上限、后台任务及工作流进展等多种事件类型。
• 系统交互：提供系统原生通知、分音型提示音及标题标记（如 🔔 需要你），点击通知可直接跳转至对应会话（v0.6.3 起由宿主 uiWorkspace.openSession 实现）。
• Webhook 推送：支持向企微、飞书、钉钉及通用渠道推送消息，并包含当轮统计（Token/缓存/TPS）。
• 自动化控制：内置免打扰时段、子代理过滤、SSE 桥接与远程触发功能。

安装与配置¶

通过 DSH 插件目录安装：

# 通过目录链接安装（需 DSH 环境支持）
https://www.skillhub.cn/plugins/Leo-Cjw/dsh-pharos

或通过 GitHub 仓库安装：

https://github.com/Leo-Cjw/dsh-pharos

配置入口位于 DSH 的 设置 → 消息通知。设置修改后约 0.8 秒自动保存。

使用说明¶

调整提醒时机¶

默认情况下，”回复完成”仅在页面隐藏或后台时提醒。在设置页可调整至三档：关闭 / 仅页面隐藏时提醒 / 始终提醒。对于”需要你操作”的请求，默认全时提醒，但在当前会话页面在前台时会静默只保留标题标记。

配置 Webhook¶

在设置页的 Webhook 渠道管理中，可配置企微、飞书、钉钉（支持加签）及通用透传。消息格式支持简洁、详细或自定义三档，自定义档允许使用 {title}{note}{kind}{summary} 等变量进行排版。

脚本调用¶

插件暴露了全局对象 window.__dshPharos，可通过 JS 脚本控制：

window.__dshPharos.setConfig({
  enabled: true,               // 主开关
  sound: true,                 // 提示音
  doneHiddenOnly: true,        // 完成提醒时机
  quietHours: { enabled: false, start: "23:00", end: "08:00" }, // 免打扰
  workflowEvents: false,       // 工作流提醒
  webhooks: []                 // Webhook 配置
})

注意事项¶

• Windows 平台限制：Windows 原生通知 tag 长度受系统限制（约 64 字符），v0.6.4 版本修复了该问题。此外，Windows 原生通知依赖 DSH host 在线运行。
• 去重机制：为防止重复通知，插件采用 SSE 帧级 2s 窗口去重、双源 done 去重以及同会话节流（默认 6s）。
• 浏览器兼容：浏览器通知功能零依赖，但点击跳转功能（v0.6.3）需宿主提供 uiWorkspace.openSession 接口。
• 权限要求：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。