@agents-anywhere/dsh-bridge-next

中文文档
2.1.0发布于 2026/10/27MITTypeScriptES Module近 30 天下载 8840

探员 DeepSeek Harness 的任何地方登入、连接器管理和事件驱动的会话运行时间

中文使用文档
文档目录6 节
  1. 可以做什么
  2. 在 DSH Desktop 中启用
  3. 从 npm 安装到独立 DSH
  4. 确认 DSH 已接入
  5. 使用条件与数据范围
  6. 开发与进一步阅读

Agents Anywhere for DSH

在 DeepSeek Harness(DSH)中连接 Agents Anywhere,从手机、平板或 Web 查看 DSH 会话、继续对话、回复提问和审批请求。Agent 仍在安装 DSH 的工作设备上运行;远程使用时,这台设备需要保持开机、联网,并让 DSH 与 Connector 正常运行。

插件随开源客户端 DSH Desktop 提供,也可从 npm 安装到兼容的独立 DSH 环境。DeepSeek 官方的 DeepSeek Harness Desktop 没有内置本插件。两种安装方式选其一;使用内置本插件的 DSH Desktop 时无需重复安装 npm 包。

可以做什么

  • 在其他设备上查看 DSH 会话与运行进度,发送消息或继续已有会话。
  • 根据 DSH 和当前会话的能力选择模型、权限与 Agent 模式,发送文字、图片或普通文件,回复输入请求与单次操作审批。
  • 使用 Agents Anywhere Cloud 或自己的服务实例;在插件中查看连接状态、管理本机 Connector 和桥接日志。
  • 在“运行日志 → 启动前诊断”展开当前插件或 Bridge 启动失败的错误码与调用栈位置;Connector 未启动或本地日志文件无法读取时,已捕获的启动故障仍可查看,无需开启 DSH Desktop 开发者日志。成功重试后清除当前故障;更早的错误可通过宿主日志排查。
  • 如果 Agents Anywhere Desktop 正在运行,转到该应用完成连接;否则可以直接在插件中登录并连接本机设备。Agents Anywhere Desktop 和 DSH Desktop 是两个不同的应用。

在 DSH Desktop 中启用

本节适用于内置本插件的 DSH Desktop。该应用已集成此插件,不需要另行下载或执行 npm 安装命令。在 DSH Desktop 的“插件”页面找到“远程控制”并启用,然后从左侧边栏“设置”上方打开“远程控制”。部分 Desktop 版本的开关位于“桌面设置”的“手机连接”区域;请以当前应用显示的入口为准。

DSH Desktop 中的 Agents Anywhere 连接面板,显示账号和 Connector 运行状态

首次使用时选择 Agents Anywhere Cloud,或输入自己部署的服务端地址,然后在浏览器中完成登录和授权。按照页面引导添加 Agent,并按需连接手机。若插件检测到 Agents Anywhere Desktop 正在运行,会引导你到该应用继续设置,避免两个应用同时管理同一台工作设备的连接。

插件随 DSH Desktop 一同打包和更新;请通过 Desktop 的发布渠道升级,不要对内置插件叠加独立 npm 安装。

从 npm 安装到独立 DSH

如果使用独立安装的 DSH,可以通过官方插件命令从 npm 安装。先确认目标 Profile 的名称,以及当前 npm 包声明的 DSH 依赖是否与你的环境相容。下面以 desktop Profile 为例:

dsh plugin --profile desktop add @agents-anywhere/dsh-bridge-next

安装完成后重启对应的 DSH 实例,从左侧边栏打开“远程控制”,按提示登录并连接。若你的 Profile 不是 desktop,请替换命令中的 Profile 名称。

安装命令不锁定插件版本,会获取 npm 当前的默认发布版本。插件包与 DSH 的兼容范围请以所安装版本的 peerDependencies 为准;较新的 DSH 不代表旧插件包自动兼容。当前仓库源码声明支持 DSH 0.2.0-rc.1 及之后的 0.2.x 版本(peer 范围 >=0.2.0-rc.1 <0.3.0-0),开发与测试基线为 0.2.1-rc.2;范围内的其他版本(包括 0.2.0-rc.x)只做 peer 声明,不在自动化检查中验证。DSH 在安装和启动插件时都会按这个范围检查,不满足时拒绝安装或跳过加载;DSH Desktop 使用与自身版本配套的内置构建,不能简单等同于 npm 上的包。需要固定可复现的部署时,再在包名后添加经过验证的版本号。

确认 DSH 已接入

完成连接后,在 Agents Anywhere 的设备页面可以看到设备在线,以及 DSH 运行时的状态。下图展示了 DSH 正在运行的设备;如果状态未出现或显示断开,先检查工作设备上的 DSH 和 Connector。

Agents Anywhere 设备页面显示设备在线,DSH Agent Runtime 正在运行

插件提示“连接服务器超时”时,表示请求 Agents Anywhere 服务端超过 20 秒仍未完成,不代表 Connector 进程崩溃;检查所选后端地址和本机网络后,在插件中重新启动 Connector。Connector 启动后立即停止时,在插件“运行日志 → 启动前诊断”中查看原因。

使用条件与数据范围

  • 远程连接需要 Agents Anywhere 账号和可访问的服务端。自托管时输入后端地址;手机扫码时,手机也需要能够访问该服务。
  • 会话、时间线和附件等数据会按所用功能经过或保存在 Agents Anywhere Server;自托管时由你部署的服务处理。模型账号与费用遵循所用模型服务的规则。
  • 账号与设备凭据保存在本机插件数据目录,不放入页面跳转 URL。设备凭据失效或设备被删除时,插件会提示重新连接或创建,不会静默注册新设备。
  • 如果 DSH 原生历史读取失败,对应会话的历史可能无法同步;其他会话仍可工作。在“桥接日志”中查看原因,修复原生历史后重试。插件不会自行修改 DSH 会话文件。

开发与进一步阅读

本仓库源码和 npm 已发布包可能处于不同版本。源码构建、链接安装、headless 检查、配置和实现细节见技术说明。

开发计划 · Onboarding 方案 · 验证记录 · Agents Anywhere 使用文档

版本与发布记录

@agents-anywhere/dsh-bridge-next 共发布 4 个版本,首次发布于 2026/09/20;过去 12 个月发布了 4 个版本。

版本发布日期距今
2.1.0latest2026/10/2711 天前
2.0.22026/09/301 个月前
2.0.12026/09/281 个月前
2.0.02026/09/201 个月前

关于 @agents-anywhere/dsh-bridge-next 的常见问题

@agents-anywhere/dsh-bridge-next 是什么?

探员 DeepSeek Harness 的任何地方登入、连接器管理和事件驱动的会话运行时间

如何安装 @agents-anywhere/dsh-bridge-next?

在项目目录运行 npm install @agents-anywhere/dsh-bridge-next,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.3.1)、@deepseek-ai/cordis(~4.0.4)、@deepseek-ai/schemastery(~3.18.4)、@deepseek-ai/dsh-typert-protocol(>=0.2.0-rc.1 <0.3.0-0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@agents-anywhere/dsh-bridge-next 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@agents-anywhere/dsh-bridge-next 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@agents-anywhere/dsh-bridge-next 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^22.19.0 || >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@agents-anywhere/dsh-bridge-next 可以商用吗?

@agents-anywhere/dsh-bridge-next 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@agents-anywhere/dsh-bridge-next 的下载量有多少?

根据 npm 官方下载统计,@agents-anywhere/dsh-bridge-next 在 2026/10/05 – 2026/11/03 这 30 天内被下载 8,840 次,日均约 295 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agents-anywhere/dsh-bridge-next 还在维护吗?

最新版本 2.1.0 发布于 2026/10/27(11 天前);至今共发布 4 个版本,其中过去 12 个月发布了 4 个;首次发布于 2026/09/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。