dsh-pharos

LIMITATIONS

Known limitations

- 双半方案：DSH 页面需保持打开（最小化/切后台可以；退出应用收不到）；host 半需挂载在同一 DSH（webServer 同源）。浏览器半在 host 不在线时自动回落 v0.3 行为（仅 needs-you / done）。 - Electron 页面通知需允许 DeepSeek Harness 的系统通知权限（macOS：系统设置 → 通知）。 - 首次页面加载后的第一声需要页面上有过一次用户交互（浏览器自动播放策略）。 - 出错/被中断/达到上限依赖 reason.kind 在 `turn/end` 上的出现（0.2.0-rc.2 已见 interrupted/forked；更全的 kind 集合随运行时演进，未知 kind 静默降级由 `agent/error` 等兜底）。 - 当轮统计（缓存命中率/TPS）依赖 host 半的官方投影 `ctx.sessionProjections`（`tokenUsage`/`sessionStats`）；投影不可用或插件中途启用（无 turn/start 基线）时静默降级为「仅耗时+tokens」，不报错。 - 点击通知通过 `uiWorkspace.openSession` 切换已有会话；归档、已删除或尚未就绪的会话不保证跳转。Windows 窗口恢复依赖 DSH 注册的 `dsh://open` 协议及同机 host；关闭自动聚焦后只切后台会话，不恢复窗口。 - 宿主原生 osascript 通知（`hostNotify`）未实现，该配置项仅保留兼容。Windows 窗口恢复新增 `node:child_process`，只启动系统 `explorer.exe` 打开固定 `dsh://open`，不执行 shell、不接受请求提供的命令或 URL。历史投稿清单的「无 child_process」描述已不适用于 v0.6.4（Windows 窗口恢复引入），插件市场收录条目已按实际代码复核。跨设备通知仍请用 Webhook。 - **工作流提醒（v0.6）默认关闭**，需在设置页开启 `workflowEvents`；开启需**重启 DSH** 生效（订阅在启动时建立），关闭则即时生效。`workflowLog`（高频旁白）可**独立**开启，只进调试队列不弹通知。 → 完整效果、触发条件与排查步骤见 **[docs/sop-workflow-events.md](docs/sop-workflow-events.md)**（SOP）。 要实机验证？现成的工作流 prompt 见 **[docs/sop-verify-workflow-prompt.md](docs/sop-verify-workflow-prompt.md)**。 ⚠️ **普通对话不会产生工作流事件** —— 仅当模型执行多 agent 工作流任务、脚本调用 `phase()`/`agent()` 时才有提醒。 - 工作流**帧本身**的 `agentType` 恒为 `root`，因此「跳过子代理事件」**对工作流提醒无效**—— 这是刻意取舍：若标 `subagent`，默认的 `skipSubagents=true` 会把整组提醒全部吞掉。 但**子代理会话自己**的「任务已完成」通知会被该开关正确过滤 —— host 判出子代理后下发 sessionId： workflow 子 agent 走 `agent-start` 帧的 `childId`；**普通 subagent 委派**走 `agents` 元信息帧的 `subagentSessionIds`（**v0.6.1 起支持**，此前这类委派识别不了）。 - 工作流「进入阶段」的去重键取阶段标题；若同一工作流在 3 秒内两次进入**同名**阶段，第二次不会重复提醒。