nnrp-js：面向实时 AI 应用的神经网络运行时协议 JavaScript SDK

核心信息

• 项目名称: nnrp-js
• 开发者: NagareWorks
• 定位: Neural Network Runtime Protocol (NNRP) 的JavaScript/TypeScript SDK
• 关键特性: Deno优先构建策略，兼容Node.js，支持浏览器、边缘计算和后端服务的统一接入
• 技术栈: TypeScript、Rust、WebAssembly
• 来源: GitHub仓库 nnrp-js
• 发布时间: 2026-06-02

nnrp-js旨在为异构环境中的实时AI应用提供统一的协议接入能力，是连接JavaScript生态与NNRP协议的重要工具。

随着AI从研究走向应用，开发者面临异构环境（浏览器、边缘节点、后端等）中高效接入AI能力的挑战。传统部署方式针对特定框架优化，需维护多套代码，兼容性问题突出。

Neural Network Runtime Protocol（NNRP）作为轻量级实时AI应用层协议，提供跨环境的统一通信抽象。nnrp-js则是该协议的JS/TS实现，让Web开发者无缝接入NNRP生态。

nnrp-js采用多包工作区架构，分为三个核心包：

1. @nnrp/core: 运行时无关的基础层，提供TypeScript类型定义、协议常量等核心契约。
2. @nnrp/native: 面向Node.js的原生包，加载Rust实现的FFI制品，获取高性能处理能力。
3. @nnrp/wasm: 面向浏览器/边缘的包，加载Rust编译的WASM制品，支持客户端直接通信。

运行时目标与传输层

构建模式	目标包	运行时	传输层
core	@nnrp/core	运行时无关	无（纯契约）
backend-native	@nnrp/native	Node.js 20.11+	TCP、QUIC 原生提供
browser-wasm	@nnrp/wasm	现代浏览器/边缘	WebSocket、WebTransport

分层设计允许开发者根据环境选择最优实现，传输层采用可插槽机制切换底层方案。

Deno优先构建

nnrp-js以Deno为主要工具链（格式化、linting、测试、构建），输出兼容Node.js的ESM格式。优势包括：

• 简化配置（内置TypeScript、标准库）
• 严格默认配置提升代码安全性
• 便于利用Deno新特性

项目明确不支持Bun运行时，优先保证核心场景稳定性。

Rust与WASM整合

协议关键逻辑由Rust实现（nnrp-rs），通过两种方式暴露给JS：

• FFI绑定: Node.js环境通过@nnrp/native加载原生库，获得高性能。
• WASM编译: 浏览器环境通过@nnrp/wasm加载WASM模块，突破Web能力边界。

统一API接口确保跨环境体验一致。

项目提供多个示例展示不同场景的使用：

• native-client.ts: Node.js/Deno原生客户端（CLI工具、代理调用）
• native-server-adapter.ts: 原生服务端适配器（构建NNRP服务端点）
• browser-client.ts: 浏览器/边缘WASM客户端
• opencode-agent-client.ts: 编码代理集成（AI辅助编程潜力）

开发者可通过deno task examples:check验证示例类型正确性。

潜在应用场景：

• 跨端AI应用（浏览器、移动端、后端共享协议）
• 边缘计算（CDN节点降低AI调用延迟）
• 实时协作AI工具
• AI编码助手通信基础设施

当前状态

nnrp-js处于Preview3阶段，发布策略包括：

• 三个包版本同步
• 包清单标记private: true避免意外发布
• 原生库/WASM制品暂不捆绑，需显式传入

未来展望

随着NNRP协议成熟和nnrp-js正式发布，有望成为JS生态与实时AI能力的桥梁，推动AI应用在Web平台的普及。