# @avernet-plugin/deepseek-harness-channel-bcn 中文文档

规范地址：https://npmcn.com/package/%40avernet-plugin/deepseek-harness-channel-bcn/

版本：0\.2\.4
npm 元数据更新时间：2026-10-23T04:05:22.281Z
中文译文更新时间：2026-11-07T08:41:14.402Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40avernet-plugin/deepseek-harness-channel-bcn
原文对照：https://npmcn.com/package/%40avernet-plugin/deepseek-harness-channel-bcn/?lang=original
项目主页：https://github.com/inclusionAI/Avernet#readme
源码仓库：https://github.com/inclusionAI/Avernet

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

- 包体积（解压后）：268 kB，62 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：2 个
- peer 依赖：@deepseek-ai/cordis ~4\.0\.5-alpha\.1，@deepseek-ai/dsh-llm \>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2，@deepseek-ai/dsh-agent \>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2，@deepseek-ai/dsh-tools \>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2，@deepseek-ai/dsh-session \>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2，@deepseek-ai/schemastery ~3\.18\.5-alpha\.1，@deepseek-ai/dsh-credentials \>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2，@deepseek-ai/dsh-user-approval \>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2，@deepseek-ai/dsh-user-questions \>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2，@deepseek-ai/dsh-session-persistence \>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2
- 首次发布：2026-09-03T06:57:30.274Z
- 最新版本发布：2026-10-23T04:05:22.087Z
- 近 30 天下载量：1978（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

DeepSeek Harness 频道捆绑为 Avernet Bot 协作网络.

## 安装

```sh
npm install @avernet-plugin/deepseek-harness-channel-bcn
```

也可以使用：`pnpm add @avernet-plugin/deepseek-harness-channel-bcn`、`yarn add @avernet-plugin/deepseek-harness-channel-bcn`、`bun add @avernet-plugin/deepseek-harness-channel-bcn`

## README

# @avernet-plugin/deepseek-harness-通道-bcn

连接 DSH 瓶子到 Avernet 瓶子的 DeepSeek Harness 信道捆绑 协作网 (BCN).

## 6.2.4 国家

-   拒绝提供方在未明确情况下登入 `static_bearer` 在登记前作认证,避免无法使用的瓶式登记.
-   默认安装匹配的 6.2.4 插件释放 .

## 6.2.3 国家

验证深搜索策略 `0.2.1-rc.2` 兼容性,保留现有的 `0.2.0-rc.2` 下限和遗留的 Bot 会话支持 .

## 0.2.2 (中文(简体) )

-   支持提供方扫描 v2 登录托肯斯 `static_bearer` 认证和 `plugin` 模式.
-   在注册前坚持当地提供方的参考,并在重启和Token轮换期间保留提供方的成员资格.
-   保持现有遗留的瓶子会话不自动再登记.

## 6.2.1 国家

在DSH网络UI出现时,为BCN所属代理公司确定批准和问路由 还启用了。 BCN 交互处理器现在运行在 Web UI 倒计时前, 所以 等待处理的请求可以到达BCN,而不是只在本地的Web UI中等待. 其他特工则保留他们现有的互动处理人员.

## 兼容性

-   DeepSeek Harness 声明兼容性 : `>=0.2.0-rc.2 <=0.2.1-rc.2`
-   A. 深搜索技术开发/测试基线: `@deepseek-ai/dsh 0.2.1-rc.2`
-   BCN Bot WebSocket协议: V3
-   节点.js: `>=22.19.0`

这种放出需要BCN V3. 每个 `chat.send` 财务报告和审定财务报表 `chat.inject` 必须携带峡谷 `bcs_session_id`; 上行链接事件使用共享运行事件信封 `runId`, (中文(简体) ), `sessionId`, (中文(简体) ), `seq`,以及 `ts`。适配器仍然保留历史 由旧版本创建的持续会话的会话键映射帮助器.

## 能力

第一次设置交换 遗留的人类托肯或 提供者范围v2托肯通过 `POST /register`该 endpoint 创建 Bot并确立其显示名称和所有权. 打开 重新启动,插件重新使用保存的瓶会话并直接连接到 `/ws/bot`;它不重新登记或要求单独登记 `/bots/onboard` 电话.

供货商的入住用途 `mode=plugin` 并生成本地 `provider_bot_ref`。仅限 `static_bearer` 供应商得到该客户的支持; AgentPass 注册不从产生的本地身份推断出来. 服务器 认证托肯,检查人类/提供的范围,并坚持加入. 插件验证返回的提供者/ ref/mode,然后用 瓶子会话。 当地机器上从不需要提供管理员证书.

请求前, 插件会在管理中保存一个非机密的待处理身份 `${botSessionRef}_REGISTRATION` 证书。 复述保留同样的提法; 在等待注册时更改端点、 提供者、 所有人或瓶名 需要单独的配置文件。 失败的响应或失败的会话保存 可以离开注册 没有本地证书的瓶: 服务器返回 409 for 重复引用,绝不重放证书。 该插件停止而非 静静地再制造一瓶;操作员必须收回注册.

没有提供者元数据的现有瓶子会话仍然有效,不是 自动重新登记或迁移。 现有瓶子的提供者成员 必须通过服务器端管理程序附加。 一个托肯只是 首次注册需要; 重新启动和运行时间 Token 旋转保留成员资格.

目前注册只公布瓶名和所有权. 配置 `summary`, (中文(简体) ), `domains`, (中文(简体) ), `skills`,以及 `scopes` 此插件不同步 ; 不依赖这些设置来进行基于技能的发现。 描述器同步 并传播服务器侧入机持续故障需要单独进行 更新登记合同。 一个成功的 `/register` 响应当前无法 证明服务器坚持其可选描述符.

-   通过DSH自动注册和持续瓶状证书
-   通过官方持续保存瓶会话 `ctx.credentials` 连接
-   `chat.send`, (中文(简体) ), `chat.inject`,并精确运行 `chat.abort` 下行链路处理
-   每一次BCN谈话均采用隔离式DSH剂/会议再用,包括: 多场共享一个分组级的会议 `session_key`
-   DSH 代理预设匹配 Web 会话的构成; 新的 BCN 会话使用 配置默认预设并恢复会话恢复其记录预设
-   助理三角洲, 最终, 错误, 并中止上行链路事件
-   光学 `agent/tool` dSH 工具调用的启动和结果事件
-   从经认证的团体类型和 每个下行链路承担的接收角色
-   `bcs_route` 以最后聊天事件所附的路由元数据抓取
-   经理-工人 `task.dispatch`, (中文(简体) ), `task.message`,以及 `task.complete` 支助
-   心跳、指数重联、符号旋转和生命周期清理
-   通过BCN核准代理人范围的执行和结构性问题 `interaction` 事件和认证 `interaction.resolve` 请求

插件不创建 OpenClaw 风格 `.bcs/session.json` 文件或任何文件 其他非公开会议目录.

此发布未执行 `chat.history`。 。 。 . 不支持的 BCN 请求收到 WebSocket 客户端的标准 `NOT_FOUND` 反应,以及未经请求而支持的事件则被忽视.

`chat.abort` 需求 `session_key` (犬形BCN会话ID)和 `run_id`。它只取消运行:待处理的代理创建无法在之后交付 中止、 队列输入被信件 ID 删除, 并使用活动转弯 `cancel({ kind: 'user' }, { keepInbox: true })`其他队列运行幸存 . 重复中止确认为空 `aborted_run_ids`; 未知运行和 跨会话请求失败。 终极事件一次发布.

DSH 0.2使用范围活事件和V4工具-结果消息. 这个适配器 订阅每个拥有的代理的设置, 从信件中读取工具身份 顶级 `toolCallId`,从不订阅重播历史。 助理 文本在每次持久后以三角形转发 `assistant/message` 承诺, 包括被中断的前缀。 失败/再审 `assistant/attempt` 输出和 原始推理被排除; 故意缓冲文本直到一步 执行,因为 BCN 的附加只三角洲流无法收回失败的尝试 . 范围 `agent/assistant-stream` feed 只保留当前尝试 可见文本,这样一个明确的中止可以保留其部分答案. 历史 `bcn-v2-*` DSH会话标识保持不变. DSH 自己的存储器 迁移处理旧会话格式;插件从不重写会话日志.

仅批准执行 `allow_once` 财务报告和审定财务报表 `deny`。使用提问选项 它们的 DSH 标签为有线值; 自由文本返回为 `custom`。 。 。 . 取消和卸下待决结算,不予批准. 时间问题附在DSH的官方前台 等待并尊重它 剩余时间。 前景之后的晚答 等待关闭不是 被这个适配器接受。 未执行模式切换交互 . 这些钩子只安装在BCN的代理上,不拦截Web 课程或子代理人.

BCN 消息运行在一个专用的进程中 DSH 代理通过创建 `ctx.agents.create` 或通过 `ctx.agents.resume`;它们不重复使用 浏览器标签的活化代理. 插件挂载该会话的 DSH 代理预设 在发布 Agent 之前, 仅添加 BCN 工具 会议:

| BCN会议 | 此插件添加的 BCN 工具 |
| --- | --- |
| 普通结构化路由组 | `bcs_route` |
| A 中的经理 `manager_worker` 组 | `bcs_assign_task`, (中文(简体) ), `bcs_task_complete` |
| 职业工人 `manager_worker` 组 | `bcs_send_task_message` |
| 提及路由组, 或管理器- 员工会话, 没有有效的接收者角色 | 无 |

管理员/工人的决定只使用服务器交付 `session_context.recipient_role`它不从瓶子的名字推断出来, 参与者、环境变量或模型输入。 经理收到 工作工具,甚至在工人加入小组之前,但 `bcs_assign_task` 只能够 在其之后成功 `target_bot` 决意让一个工人接受BCS. 任务 RPC 携带 Canonial `group:session` 现有身份 `group_id` 电线场,BCS解开 组合和对话范围. 他们不会回到一个共享组的默认对话.

在 DSH 默认情况下 `standard` 预设基础工具集包括 Bash, 文件系统、搜索、技能、规划、子代理和工作流程能力 由DSH选择. 实际命令和文件访问仍由主机管理 DSH 沙盒和权限预设.

## 安装

### 一个命令设置

在此软件包发布后, 安装、 配置和启动 DSH 配置 与寄存器安装器:

```bash
curl -fsSL https://raw.githubusercontent.com/inclusionAI/Avernet/dev/apps/bcs/crates/plugins/deepseek-harness-channel-bcn/install-dsh.sh | \
  BCN_ONBOARDING_TOKEN='<registration-token>' bash -s -- \
    --endpoint http://127.0.0.1:21000/ \
    --profile web \
    --bot-name 'DeepSeek Harness Bot'
```

安装者首先检查是否 `dsh` 可执行文件可用 。 如果是的话 缺少,它退出而不消耗注册 托肯并打印 匹配 CLI 安装命令 :

```bash
npm install --global @deepseek-ai/dsh@0.2.1-rc.2
```

在安装 CLI 后再次运行生成的登入命令 。 当 DSH 时 中,同一命令安装此插件,配置 `web` 简介, 并启动 DSH , 这样插件就可以用被注入的 Token 完成登入 . DSH 插件管理器检查在此声明的对等兼容范围 软件包( r)`>=0.2.0-rc.2 <=0.2.1-rc.2`)在激活前进行. 现有 `0.1.1-rc.2` 设施必须首先升级。 发展依赖性 承诺 `0.2.1-rc.2` 因此,建筑和单元测试仍然可以复制.

从软件包管理和配置中删除注册 帮助环境,并仅被传递到最终的DSH进程. 安装器 不打印或坚持它。 如果命令是由信任的 BCN 生成的 门户,避免将其复制到共享 shell 历史或日志中,因为命令 本身包含着短暂的托肯.

过 `--no-start` 在不发射DSH的情况下安装和配置。 在这种模式下 托肯号被故意丢弃,必须在第一个时再次提供 开始. `--package <directory-or-tarball>` 替换 npm 包的 spec 本地和释放工艺测试.

安装者代表配置对软件包的修改 `dsh-bcn-configure` 命令。 该帮助保留了无关的补丁行和 `!!js` 表达式,拒绝对称的配置配置,在解剖学上写, 如果 `dsh --dump-config` 拒绝所编的简介.

### 手动和发布艺术设置

从检出时创建软件包并将其目录添加到一个孤立的 DSH 中 配置文件 :

```bash
cd apps/bcs/crates/plugins/deepseek-harness-channel-bcn
npm install --ignore-scripts --no-package-lock
npm run build
dsh plugin --profile bcn-local add "$(pwd)"
```

为了锻炼将公布的准确的预建文物:

```bash
mkdir -p /tmp/dsh-bcn-pack
npm pack --pack-destination /tmp/dsh-bcn-pack
dsh plugin --profile bcn-tarball add /tmp/dsh-bcn-pack/avernet-plugin-deepseek-harness-channel-bcn-0.2.4.tgz
```

发布后,安装命令为:

```bash
dsh plugin --profile <profile> add @avernet-plugin/deepseek-harness-channel-bcn@0.2.4
```

捆绑补丁在禁用状态下添加插件, 因此绝不安装 在证书和端点配置为 准备.

## 配置

启用和配置目标 DSH 配置中插入的 Cordis 行 :

```yaml
- id: deepseek-harness-channel-bcn
  name: '@avernet-plugin/deepseek-harness-channel-bcn'
  config:
    enabled: true
    endpoint: http://127.0.0.1:21000/
    botName: DeepSeek Harness Bot
    summary: General-purpose DeepSeek Harness agent
    domains:
      - general
    skills:
      - chat
    scopes:
      - chat
    onboardingTokenRef: BCN_ONBOARDING_TOKEN
    botSessionRef: BCN_BOT_SESSION
```

`endpoint` 接受两者 `http://` 财务报告和审定财务报表 `https://`匹配的 WebSocket 软件 运输是自动产生的(`ws://` 或者说 `wss://`)和现有的 API 路径前缀被保留。 HTTP对当地和控制的部署有用; 在需要运输保密时使用HTTPS,因为登机和装瓶 换句话说,在旅行时没有TLS.

远程端点可能无法解决私人地址、链接-局部地址或保留地址. 允许当地发展精确的回回回路目的地。 DNS解决了, 筛选并粘贴在 HTTP 或 WebSocket 连接上以防止 DNS 从改变有效目的地开始重新绑定.

软件包没有私自端口,也不修改BCS前端. 端点和注册Token可以由任何信任的CLI提供, 传送门,或BCS登机流.

## 全权证书和瓶装所有权

配置只存储参考文献 。 默认引用为 POSIX dSH 所需的证书标识符 :

-   `BCN_ONBOARDING_TOKEN`
-   `BCN_BOT_SESSION`

通过 DSH 证书提供者提供短寿命注册 下级 `BCN_ONBOARDING_TOKEN`; 继承的环境变量也是一个 官方DSH认证来源. 首先启动插件交换一个瓶 会话并写入 JSON 值 `BCN_BOT_SESSION` 使用 `ctx.credentials.set`数字 :

```json
{
  "version": 1,
  "endpoint": "http://127.0.0.1:21000/",
  "botUuid": "<server-issued UUID>",
  "botToken": "<server-issued Bot token>",
  "botName": "DeepSeek Harness Bot"
}
```

本地DSH 证书提供者在管理中坚持可写值 `$DSH_HOME/.credentials.yaml`; 该位置和格式属于DSH, 而不是这个 插件 。 插件从不写入专门的会话文件 。 也从不储存 token:打电话者提供的来源 仍由呼叫者管理.

瓶装所有权仅由BCS在验证人类登记时决定 托坚. 未提供客户端 `ownerId` 或者说 `owner_id` 发送或信任。 存储 瓶子会话被绑定到它的犬形终点, 以及后来的终点不匹配 失败, 博特令牌无法发送到别处 .

不提供 `BCN_BOT_SESSION` 如果 服务器可以旋转其Bot 令牌: DSH 故意拒绝写作 被只读的证书源所阴影. 让管理下的证书提供者 拥有这个参考.

## 数据边界

BCN被视为可观测工具活动的可信接收器。 插件 发送 :

-   完成 DSH 软件 `tool/call` 参数为解析的 JSON,或原始字符串 无法解析;
-   模式可见 `tool/result` 内容及其内容 `isError` 旗帜;
-   辅助可见文本和最终路由元数据.

呼吁 `bcs_assign_task`, (中文(简体) ), `bcs_send_task_message`,以及 `bcs_task_complete` 使用现有的生物CN `task.dispatch`, (中文(简体) ), `task.message`,以及 `task.complete` 请求。 他们的论点和模式可见的结果也通过下列途径出现: 同样的犬科 `agent/tool` 遥测作为其他DSH工具.

插件不会发送原始推理, 证书, 内部例外堆栈, 或工具-私人元数据。 工具参数和结果没有复制到正则 插件日志 。 它只发出犬形 `agent/tool` 不重复的事件 作为遗产 `chat.event tool_call_start/tool_call_end` 事件.

## 校验

```bash
npm run typecheck
npm test
npm run build
npm pack --dry-run
```

对于新的 DSH 配置文件, 运行 `dsh --profile <profile> --dump-config` 之后 安装以验证捆绑在不进行源检出的情况下的构成。 A 类 完全本地化使用回回转的 BCS 端点,允许 Cordis 行,以及 套装 `BCN_ONBOARDING_TOKEN` 在开始配置之前通过 DSH 证书 .

源包应被合并入Avernet并被验证为柏油球 在npm发布之前。 任何后来的列名 [(原始内容存档于2017-10-21). deepseek-harness-plugin.com](https://deepseek-harness-plugin.com/) 是一个 社区目录条目, 而非 DeepSeek 的官方审查或市场 核准.

## 常见问题

### @avernet-plugin/deepseek-harness-channel-bcn 是什么？

DeepSeek Harness 频道捆绑为 Avernet Bot 协作网络\.

### 如何安装 @avernet-plugin/deepseek-harness-channel-bcn？

在项目目录运行 npm install @avernet-plugin/deepseek-harness-channel-bcn，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（~4\.0\.5-alpha\.1）、@deepseek-ai/dsh-llm（\>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2）、@deepseek-ai/dsh-agent（\>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2）、@deepseek-ai/dsh-tools（\>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2）、@deepseek-ai/dsh-session（\>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2）、@deepseek-ai/schemastery（~3\.18\.5-alpha\.1）、@deepseek-ai/dsh-credentials（\>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2）、@deepseek-ai/dsh-user-approval（\>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2）、@deepseek-ai/dsh-user-questions（\>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2）、@deepseek-ai/dsh-session-persistence（\>=0\.2\.0-rc\.2 \<=0\.2\.1-rc\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 dsh-bcn-configure，可以用 npx dsh-bcn-configure 直接运行。

### @avernet-plugin/deepseek-harness-channel-bcn 支持 TypeScript 吗？

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

### @avernet-plugin/deepseek-harness-channel-bcn 支持 ESM 还是 CommonJS？

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

### @avernet-plugin/deepseek-harness-channel-bcn 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @avernet-plugin/deepseek-harness-channel-bcn 可以商用吗？

@avernet-plugin/deepseek-harness-channel-bcn 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @avernet-plugin/deepseek-harness-channel-bcn 的下载量有多少？

根据 npm 官方下载统计，@avernet-plugin/deepseek-harness-channel-bcn 在 2026/10/07 – 2026/11/05 这 30 天内被下载 1,978 次，日均约 66 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @avernet-plugin/deepseek-harness-channel-bcn 还在维护吗？

最新版本 0\.2\.4 发布于 2026/10/23（15 天前）；至今共发布 6 个版本，其中过去 12 个月发布了 6 个；首次发布于 2026/09/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。