# @agents-anywhere/dsh-bridge-next 中文文档

规范地址：https://npmcn.com/package/%40agents-anywhere/dsh-bridge-next/

版本：2\.1\.0
npm 元数据更新时间：2026-10-27T08:45:33.643Z
中文译文更新时间：2026-11-05T23:52:30.088Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agents-anywhere/dsh-bridge-next
原文对照：https://npmcn.com/package/%40agents-anywhere/dsh-bridge-next/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.2 MB，238 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：^22\.19\.0 \|\| \>=24
- 运行依赖：5 个
- 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
- 首次发布：2026-09-19T16:39:44.657Z
- 最新版本发布：2026-10-26T22:07:14.559Z
- 近 30 天下载量：8840（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

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

## 安装

```sh
npm install @agents-anywhere/dsh-bridge-next
```

也可以使用：`pnpm add @agents-anywhere/dsh-bridge-next`、`yarn add @agents-anywhere/dsh-bridge-next`、`bun add @agents-anywhere/dsh-bridge-next`

## README

# Agents Anywhere for DSH

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

插件随开源客户端 [DSH Desktop](https://github.com/anywhere-labs/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](https://github.com/anywhere-labs/dsh-desktop)。该应用已集成此插件，**不需要另行下载或执行 npm 安装命令**。在 DSH Desktop 的“插件”页面找到“远程控制”并启用，然后从左侧边栏“设置”上方打开“远程控制”。部分 Desktop 版本的开关位于“桌面设置”的“手机连接”区域；请以当前应用显示的入口为准。

![DSH Desktop 中的 Agents Anywhere 连接面板，显示账号和 Connector 运行状态](https://npmcn.com/package/%40agents-anywhere/dsh-bridge-next/docs/images/remote-control-desktop.webp)

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

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

## 从 npm 安装到独立 DSH

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

```bash
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 正在运行](https://npmcn.com/package/%40agents-anywhere/dsh-bridge-next/docs/images/dsh-runtime-connected.webp)

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

## 使用条件与数据范围

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

## 开发与进一步阅读

本仓库源码和 npm 已发布包可能处于不同版本。源码构建、链接安装、headless 检查、配置和实现细节见[技术说明](https://github.com/anywhere-labs/Agents-Anywhere/blob/main/dsh-bridge-next/TECHNICAL.md)。

[开发计划](https://github.com/anywhere-labs/Agents-Anywhere/blob/main/dsh-bridge-next/DEVELOPMENT_PLAN.md) · [Onboarding 方案](https://github.com/anywhere-labs/Agents-Anywhere/blob/main/dsh-bridge-next/ONBOARDING_PLAN.md) · [验证记录](https://github.com/anywhere-labs/Agents-Anywhere/blob/main/dsh-bridge-next/VERIFICATION.md) · [Agents Anywhere 使用文档](https://github.com/anywhere-labs/Agents-Anywhere/blob/main/docs/README.md)

## 常见问题

### @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 和提交记录判断。