Orca 终端状态桥 Alex-wangyang/dsh-orca-terminal-status

DSH Orca 终端状态

一个非官方、独立的 DeepSeek Harness 插件，把真实的 DSH TUI 就绪与完成状态上报到 Orca 现有的终端状态通道。MIT 协议。不需要修改 Orca 应用。

为什么需要它

在 Orca 1.4.220 上，DSH 可能已经完成请求，而 Orca 还在等 tui-idle：DSH 的 Claude 兼容钩子上报的是 HTTP 事件，而那个就绪检查等的是终端状态。参见 Orca issue #25257 和上游 PR。

这个插件直接监听 DSH 生命周期事件，不会把 HTTP Stop 翻译成完成。Stop 仍可能排入后续工作。

- 只有 TUI 实际的子运行时完成激活、且唯一的根智能体空闲、收件箱为空之后，才上报启动就绪。
- 根智能体运行时上报 working，最终空闲时上报 done，通过有序的 OSC 9999 写入现有 PTY。
- 忽略子代理、有歧义的多个根、非 TTY 的 SDK 输出，以及没有 Orca 窗格环境的终端。要求前端/服务归属匹配。
- 保留 Orca 现有的 HTTP 钩子，让它们继续做原来的事。

测试过的版本

| 组件 | 版本 |
| 官方 Orca | 1.4.220 |
| 官方 DSH / dsh-agent | 0.2.0-rc.2 |
| 社区 @deepseek-harness-tui/dsh-tui | 0.13.0 |
| @deepseek-ai/cordis | 4.0.4 |
| @deepseek-ai/cordis-plugin-loader | 1.0.5 |
| 真实集成平台 | macOS，Apple Silicon |

除 DSH 的插件加载器之外，这个实现还依赖 TUI/Cordis 内部结构（internal/status、fiber 的 state/parent/store 以及 dsh-tui-runtime）。仅插件加载器兼容，并不能保证这些内部结构仍然兼容。manifest 声明了测试过的 peer 版本；可选 peer 避免自动安装另一份 DSH 或 TUI 副本。缺少 TUI 就不会提供就绪状态。升级后要重新验证；与其他版本、Windows、Linux、SSH 以及多根前端路由的兼容性尚未确认。

安装

使用 Node.js ^22.19.0 || >=24，并准备一个现有的 DSH TUI 配置档。只安装一次：不要把这个 bundle 和手动插入的插件副本、或已经发出相同 DSH PTY 状态的 Orca 版本混用。安装 bundle 会改变使用该配置档的每个会话；请安排在会话之间安装。

通过 DSH 官方包管理命令行（把 dsh-tui 换成你的配置档）：

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

或者，下载并解压该 release，然后让 DSH 原生的 plugin_manager 使用 action: install_bundle，并把 target 设为解压后的包目录绝对路径。这个包包含 dsh.bundle.patch，没有运行时依赖，没有构建步骤，也没有 install/prepare 脚本。npm registry 发布不是必须的。不要自己在 DSH 的配置档里运行 npm install。

替换包之后重启 DSH，并在 Orca 里启动它。确认组装出的插件行和原生 tui-idle 就绪状态，然后跑一个无害任务，确认它能完成。只保存了 bundle 选择，并不能证明运行时是健康的。

用同一个配置档移除 bundle：

dsh plugin --profile dsh-tui remove dsh-orca-terminal-status

这里移除的是 bundle 管理的插件，不是更早手工安装的 home 补丁。移除手工安装时，要保留 Orca 管理的钩子行。

验证

npm test
npm pack --dry-run

八个行为测试覆盖：前端激活延迟或失败、root 与 inbox 守卫、子事件、Stop 续接、有序即时唤醒、SDK 隔离、释放与前端归属。这些测试不需要模型凭据，也不需要安装 DSH。

同一份运行时源码也在实测过的真实技术栈上跑过：冷启动 worker 和同进程复用 worker 都成功通过准入，各自写入独立校验过的任务标记文件，并上报原生 worker 完成。Orca 的原生 tui-idle 检查在任务完成后通过，在最终源码的全新启动中也通过。官方 Orca 应用的字节未改动。这些只是有边界的集成测试结果，不保证后续版本同样成立。发布打包另在隔离配置档中用 DSH 原生安装器单独测试。

这是独立维护的非官方插件。它监听 DSH 的真实状态，把就绪、工作中和完成状态写入 Orca 已有的终端通路，使官方 Orca 也能正确识别 DSH worker。
它不会把 HTTP Stop 直接当作任务完成，也不需要修改 Orca 本体。

安装命令见上方；dsh-tui 应替换为实际使用的 profile。请勿重复安装手工副本和 bundle。已实测的版本组合见表格；插件加载机制保持兼容，并不代表 TUI 内部生命周期永远保持兼容，因此 DSH/TUI 升级后仍需验证。

License

MIT. Independently maintained; not affiliated with or endorsed by
DeepSeek AI, the DSH TUI maintainers, or Stably/Orca.