前言¶
在 Orca 1.4.220 版本中，DSH（DeepSeek Harness）能够完成请求，但 Orca 仍可能在等待 tui-idle 状态。这是因为 DSH 的 Claude 兼容钩子报告的是 HTTP 事件，而 Orca 的就绪检查期望的是终端状态。这种差异会导致状态不同步。
dsh-orca-terminal-status 是一个非官方的独立插件，它直接监听 DSH 的生命周期事件，将真实的 DSH TUI 状态（就绪、工作中、完成）写入 Orca 现有的终端通路，使 Orca 能正确识别 DSH worker 的完成状态。
核心功能¶
该插件专注于解决状态同步问题，核心能力包括：
- 监听并写入状态：监听 DSH TUI 的实际状态，并将就绪、工作和完成状态写入 Orca 的 PTY（终端通路）。
- 准确的完成判定：不将 HTTP
Stop翻译为完成状态，而是等待 TUI 的实际子运行时激活、单个根代理空闲且收件箱为空时才报告完成。 - 过滤干扰项：忽略子代理、模糊的多根代理、非 TTY SDK 输出以及没有 Orca 面板环境的终端。
安装与使用¶
安装前需确保环境满足要求：Node.js 版本需为 ^22.19.0 || >=24，且已配置好现有的 DSH TUI 配置文件。
- 安装插件
使用 DSH 的包管理 CLI 安装发布的 Tgz 包。请将dsh-tui替换为你实际使用的 profile 名称。
dsh plugin --profile dsh-tui add https://github.com/Alex-wangyang/dsh-orca-terminal-status/releases/download/v0.1.0/dsh-orca-terminal-status-0.1.0.tgz
-
验证与运行
安装完成后重启 DSH，在 Orca 中启动。确认插件行已正确组合，且原生tui-idle就绪检查通过。随后运行一个无害任务，验证任务在真正完成时 Orca 能正确识别。若需移除插件：
dsh plugin --profile dsh-tui remove dsh-orca-terminal-status
适用场景与注意事项¶
该插件依赖 DSH TUI 的内部实现（如 internal/status、fiber 状态、dsh-tui-runtime），因此仅保证在特定版本组合下的兼容性。
- 环境依赖：需要匹配的前端/服务所有权。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 兼容性：已验证的版本组合包括 Orca 1.4.220、DSH 0.2.0-rc.2、TUI 0.13.0。未验证与 Windows、Linux、SSH 或多根前端路由的兼容性。
- 安装限制：安装后会影响该 profile 下的所有会话。请勿与手动插入的副本组合，也不要与已经内置此功能的 Orca 版本组合安装。
总结¶
dsh-orca-terminal-status 通过监听 DSH 的真实 TUI 生命周期，填补了 Orca 在新版本中对终端状态检查的期望与 DSH HTTP 事件机制之间的鸿沟。对于需要在 Orca 1.4.220+ 环境下使用 DSH 的开发者，这是一个必要的同步工具。
- GitHub 仓库: alex-wangyang/dsh-orca-terminal-status
