@buoy-gg/sync-经纪人
主办"苏克特". Buoy桌面和MCP使用的IO消息路由器. 它引导设备能力,观看快照,以及设备客户端和仪表板客户端之间的远程动作. 大多数用户应该运行桌面或MCP,而不是直接托管这个软件包.
安装
npm install @buoy-gg/sync-broker
这是一个节点主机包。 使用导出 createBroker, (中文(简体) ), socketHandle,以及执行自定义主机时的协议类型.
主办经纪人
主办方必须独立验证其Buoy账户并通过 canUseDesktop。默认拒绝访问。 此集成草图预计您的主机已经存在 account 对象; hasAccess() 必须反映目前经核实的承认,而不仅仅是钥匙的存在:
import { createBroker, DEFAULT_BROKER_PORT } from "@buoy-gg/sync-broker";
const broker = createBroker({
port: DEFAULT_BROKER_PORT,
canUseDesktop: () => account.hasAccess(),
onListening: (port) => console.log(`Broker listening on ${port}`),
onError: (error) => console.error(error),
});
// Call when your account lifecycle changes admission:
broker.refreshAccess();
// Call during host shutdown:
await broker.close();
保持账户重新验证和过期处理活动,为主机终生服务. 访问更改时刷新路由 。 设备及客户端的录入与主机回调分离. 听取的 HTTP 端点不能证明一个设备已被允许 .
尝试连接到已有的经纪人, 然后再启动另一个 。 如果启动报告 EADDRIUSE, 请连接已经使用该端口的经纪人或解决冲突 。 默认端口是 42831。 。 。 .
已存在的 HTTP 服务器
对于一个现有的Socket。 IO 服务器, 使用 socketHandle({ io, canUseDesktop }) 并保留其退还的 refreshAccess 函数。 您的主机拥有 HTTP 服务器 Socket. IO选项,账户生命周期,和关闭。 不将路由附加到同一服务器上两次 .
信件流
设备宣布能力. Dashboard watch 请求控制适配器订阅;经纪人合并这些请求. 设备快照流到观看客户端,而命名动作及其结果则向相反方向行走. 经纪人日志有助于诊断录入、连接和协议问题。 离线设备历史在记忆中,可以被遗忘或老化.
网络和核查
独立服务器在不设回放主机限制的情况下监听. 默认 CORS 允许任何来源; CORS 不是客户端认证 。 使用可信任的开发网络并审查访问控制,然后曝光超出它的自定义主机. 账户的录用并不为每一个远程动作规定具体应用授权.
用已核实的主机和设备账户进行测试:连接,监视已知工具,确认其快照. 后撤销主机接收,并核实访问关闭. 恢复有效访问后重新连接,并检查该表状态恢复 。 见 桌面指南 财务报告和审定财务报表 MCP 指南 用于支持的最终用户主机.