事件驱动 Agent 运行时yangbobo2021/Relay

Relay

插件指南：English | 中文

为官方 DeepSeek Harness 添加 Codex、Claude Code、插件管理和异步事件能力，
而无需维护 DSH 分支。

Relay 是一个面向长时间运行的 Agent 工作的开源集成与运行时工作区。其独立发布的
DSH 插件现已可用：只安装你需要的功能，保持官方 DSH 核心不变，并通过
DSH CLI 或普通 Chat 对话进行管理。无需检出 Relay。

插件管理器在官方 DSH 中安装 Codex 后端

在官方 DSH 上的一次真实 40 秒运行：搜索、查看提议的变更、
单独确认，最后完成 Codex 插件安装。观看
演示。

立即试用

已经在运行官方 DSH？停止 DSH Web，安装对话优先的
插件管理器，然后重启：

dsh plugin --profile web add relay-dsh-plugin-manager@latest
dsh web

然后在 Chat 中询问：

/plugins find a Codex conversation backend

搜索和检查是只读的。安装、更新、启用、
禁用、移除或重启会显示一个计划，并需要单独
确认。KeySync 的一键 DSH 设置已包含插件管理器。

选择你的路径：安装特定插件
· 阅读中文指南 ·
报告安装反馈

为什么给 Relay 点星？

- 保持官方 DSH 不打补丁，同时添加你的项目所需的 Agent 后端和异步
事件能力。
- 将 Codex 或 Claude Code 用作原生 DSH 对话模式，并结合
官方 DSH Files 和 Terminal 界面。
- 跟进下一层长时间运行的 Agent 工作：持久化 Wait 和 Monitor、
外部 Event，以及投递回正确的现有对话。

如果这个方向对你有用，请给 Relay 点星，
让更多 DSH 用户发现这条无需分支的插件路径。

Relay 的运行时方向超越了插件套件。一个普通的 DSH
对话可以注册 Wait 和持久化本地 Monitor；Relay 将传入的
Event 路由回正确的对话。一个 DSH Session 可以使用 DSH 的默认
Agent，或绑定一个 Codex Thread 作为其执行和模型上下文后端。

DSH 插件目录

这 10 个受维护的插件已在官方 DSH 0.1.5-rc.2 和
0.1.6-alpha.1 上验证。Workbench、Files 和 Terminal 仍处于停用状态，并被排除
在兼容性矩阵之外；当前配置文件使用相应的官方
DSH 界面。参见最新兼容性记录。

已发布的插件可以安装到官方 DSH 上，而无需检出此
仓库。Relay 将其各个仓库固定为子模块，用于分发、兼容性测试和跨插件验证。Monitor Core、Time、Process 和 Author 是独立的仓库和 npm 包，因此 Agent 可以发现已安装的 Bundle Types，并在需要时添加最小权限的自定义 Monitors。

请参阅完整的插件选择器与安装指南（中文），了解 npm 和 GitHub 的设置方法、依赖项、验证以及真实的 DSH UI 证据。

| 插件 | 仓库 | npm 包 | 用途 |
| --- | --- | --- | --- |
| Plugin Manager | relay-dsh-plugin-manager | relay-dsh-plugin-manager | 通过 Chat 发现和管理 DSH 插件；由 KeySync 的一键 DSH 安装包含。 |
| Codex | relay-dsh-plugin-codex | relay-dsh-plugin-codex | 将 Codex 添加为 DSH 对话后端。 |
| Claude Code | relay-dsh-plugin-claude | relay-dsh-plugin-claude | 将 Claude Code 添加为 DSH 对话后端。 |
| Workbench（已停用） | relay-dsh-plugin-workbench | relay-dsh-plugin-workbench | 历史 DSH 0.1.2 布局插件；不再进一步适配。请使用官方 DSH 布局/侧边栏界面。 |
| Files（已停用） | relay-dsh-plugin-files | relay-dsh-plugin-files | 历史 DSH 0.1.2 文件浏览器；不再进一步适配。请使用官方 DSH Files。 |
| Terminal（已停用） | relay-dsh-plugin-terminal | relay-dsh-plugin-terminal | 历史 DSH 0.1.2 终端；不再进一步适配。请使用官方 DSH 终端。 |
| Events | relay-dsh-plugin-events | relay-dsh-plugin-events（tarball） | 持久化的 Wait/Event/Delivery、入口和管理 UI。 |
| Semantic Router | relay-dsh-plugin-semantic-router | relay-dsh-plugin-semantic-router（tarball） | 通过现有 DSH 模型路由实现无工具语义路由。 |
| Monitor Core | relay-dsh-plugin-monitors | relay-dsh-plugin-monitors | 持久化的 Monitor 注册表、受限的自定义 Bundles、检查以及绑定触发器。 |
| 时间监控器 | relay-dsh-plugin-monitor-time | relay-dsh-plugin-monitor-time | 添加可发现的 time.deadline 以及绑定到 Session 的计时器工具。 |
| 进程监控器 | relay-dsh-plugin-monitor-process | relay-dsh-plugin-monitor-process | 为自定义 Bundle 添加不透明的、身份安全的进程状态能力。 |
| 监控器作者 | relay-dsh-plugin-monitor-author | relay-dsh-plugin-monitor-author | 添加原生 DSH Skill，用于发现插件类型或安全地编写回退 Bundle。 |

各个插件的 README 都会链接回此处，并描述它们与 Relay 的边界。Relay 针对这些子模块的仓库工作流记录在
仓库工作流中。

构建 Relay

从文档索引开始。产品需求和运行时行为由 Relay 规范定义。

使用 scripts/sync-dsh.sh 将 DSH 克隆到被忽略的上游目录中。将 Relay 拥有的实验和兼容性说明保留在 dsh-lab/ 中，以便可以自由更新不可变的上游参考。

apps/                         面向用户的 Relay 应用程序
packages/                     保留；无根拥有的产品运行时
integrations/                 外部系统以及 agent/tool 桥接
docs/                         规范、架构和决策
experiments/                  短期原型
fixtures/                     已清理的测试夹具
scripts/                     开发者自动化
tests/                        跨包和集成测试
upstream/deepseek-harness/    DeepSeek Harness 的本地被忽略克隆
dsh-lab/                      Relay 拥有的 DSH 笔记、测试、补丁、适配器

本地垂直演示

无需付费模型调用即可运行三个插件和合成组合检查：

npm run test:event-plugins
npm run test:package:plugins
node scripts/verify-dsh-official-install.mjs --events-only

官方安装测试使用一次性配置文件和回放 LLM 适配器，以验证路由和计时器投递到现有的真实 DSH Session 中。它不会更改正在运行的 KeySync 配置文件。参见投递报告。

Relay Web

克隆 DSH 后，使用本地 Relay bundle 启动其 Web 对话 UI：

npm run start:web -- --host 127.0.0.1 --port 4317

打开 http://127.0.0.1:4317，选择一个工作区，然后开始普通对话。
在原生 New Session 屏幕上选择直接可见的 Codex 模式以运行
通过 Codex App Server 进行对话，而无需离开 DSH Web。Codex
Session 保留 DSH 的原生编辑器、模型/推理选择器、权限控制、
Chat/Trajectory 视图和消息渲染。对于普通 DSH 路径，请在发送第一条
消息前选择其他模式。

普通 DSH Agent 可以调用 relay_schedule_timer，并传入 after_seconds 和
一个延续提示；Relay 会持久化该定时器，并在其到期时恢复同一个 DSH Session。
由 Codex 支持的 Session 可以在其原生
对话视图中注册外部事件 Wait；该 Event 路径不会创建定时器或 Codex Automation。

本地集成通过正在运行的 DSH Web 主机投递真实的外部 Event：

curl -X POST http://127.0.0.1:4317/api/relay/events \
-H 'content-type: application/json' \
-d '{"type":"build.completed","source_event_id":"build-42","status":"passed"}'

非回环调用方必须发送 Authorization: Bearer ，并且主机必须设置
RELAY_INGRESS_TOKEN。响应包含持久化的 Relay Event 和 Delivery
状态；未匹配的 Event 会被接受，但不会启动 Session 轮次。

打开 Settings > Waiting events 以检查实时等待和 Monitor、打开
所属对话、取消其等待，或要求活跃的 Monitor 立即检查。

Codex in DSH Web specification 定义了此
集成及其所有权边界。