前言¶
DeepSeek Harness 采用了模块化设计，强调通过插件扩展功能。对于需要在第三方通讯平台（如 Narra Messenger）上部署智能体的开发者，手动对接 Gateway 协议通常涉及繁琐的认证管理和会话映射。本插件提供了现成的连接层，将 Harness 的 Agent Preset 直接映射到 Narra 的房间中。
定位¶
dsh-narra-channel 是 NetMind-AI 维护的第三方 DeepSeek Harness 通道插件，用于将 Harness 的智能体预设连接到 Narra Messenger。它不修改 DeepSeek Harness 或 Narra 前后端，专注于处理 Narra Gateway 的协议握手、凭证存储及消息流转发。
核心功能¶
- 连接预设与身份映射: 在 Harness 设置中选中一个 Agent Preset，插件会自动提取其中的联系人名称和简介，并在 Narra 中绑定。
- 凭证安全存储: 绑定所需的 Gateway URL 和 Bearer Token 不会明文记录在配置文件或日志中，而是存储在 Harness Credentials 里。
- 独立 Worker 模型: 每个绑定会创建一个独立的 Channel Worker。消息在该 Worker 内部串行处理，但不同绑定之间可以并发工作。
- 会话与去重: 插件将 Narra 的房间映射为 Harness 可恢复的确定性 Session，避免重复执行已完成的对话。
- 语音指令支持: 识别
voice_instructions，用于触发简短、快速的语音友好型回复。 - 流式传输: 文本回复通过 Narra Gateway 以流式方式传输。
安装与启用¶
插件依赖 Node.js ^22.19.0 || >=24.0.0 和 pnpm 11.7.0，目标版本为 Harness 0.1.0-rc.8。
- 构建并安装插件包：
git clone https://github.com/NetMind-AI/dsh-narra-channel.git
cd dsh-narra-channel
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
pnpm pack
dsh plugin --profile web add ./narra-dsh-narra-channel-0.1.5.tgz
- 配置与绑定：
重启web配置文件，打开 Harness 设置 → Narra。- 选择一个 Agent Preset。
- 粘贴 Narra 提供的完整绑定指令或其 setup-guide URL。
- 检查插件生成的 Narra 身份信息（名称和简介），如需修改请手动调整。
- 点击 Bind and start listening，等待状态变为
connected。
适用场景与注意¶
- 并发限制: 单个绑定同一时间仅能处理一条消息。如果该 Agent 的多个房间有长耗时任务，后续消息会排队。
- 附件处理: 附件目前仅保留源元数据，插件版本
0.1.5不会下载或返回文件内容。 - 运行环境: 第三方 Harness 插件运行在 Harness 进程内部，权限与 DSH 进程一致。请确保信任插件源码及许可证（MIT）。
- 版本依赖: 插件当前针对 Harness
0.1.0-rc.8开发。如果 Harness 更新，可能需要重新安装插件或等待适配。
结语¶
该插件通过封装 Gateway 协议细节，简化了 Narra Messenger 的接入流程。开发者可以专注于 Agent Preset 的逻辑编写，无需关心底层的认证与会话管理。源码与文档可在下方链接获取。
