NeuroLink

用统一的 TypeScript 接口连接多家模型、决策模型、语音、RAG、记忆与 MCP 工具。

Star 数
★ 167
最近更新
1 天前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
代码库 / SDK命令行工具开发框架
可在哪里用
通用 · 跨平台OpenAI API · Claude API
费用
免费,无需付费服务
上手难度
中 · 需要几步配置
开始前需要
@juspay/neurolink所选提供商的凭据Shell / 命令行网络访问本地文件系统
典型场景
维护 TypeScript 产品的团队,希望在 OpenAI、Anthropic、Vertex AI、Bedrock 或本地运行时之间切换,而不重写应用层调用。
不适合
  • 需要现成图形界面的团队
  • 需要模型解释决策理由的流程
  • 希望直接执行不可逆自动决策的团队
官网
neurolink.ink ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-20最新版本 v13.13.5(2026-11-19)

这个 Agent 能做什么,适合哪些场景?

NeuroLink 是一个 MIT 许可的 TypeScript SDK 与 CLI,用统一管道连接 OpenAI、Anthropic、Google、AWS、Azure、Mistral、聚合服务及本地模型运行时。核心接口提供 generate、stream 和 decide 三类推理:前两者生成文本,后者返回带概率或置信度的布尔、选项或评分判断。它还包含 MCP 客户端能力、工具执行、多提供商故障转移、RAG、会话记忆、文件处理、嵌入以及 TTS、STT 和实时语音接口。应用通过 NeuroLink 类发起请求,并消费文本、异步数据流、结构化决策、音频或其他模态结果;CLI 则提供终端入口。它既能调用托管 API,也能连接 Ollama、LM Studio 和 llama.cpp 等本地运行时,但具体模型、凭据和外围存储仍由采用者配置和运营。

应用创建 NeuroLink 实例后,将文本、音频、图像或文件输入交给选定的提供商。generate() 返回完成后的内容,stream() 暴露可异步迭代的数据流,decide() 和故障开放的 tryDecide() 则把一个 state 与命名问题映射成类型化的 boolean、choice 或 score 结果。RAG 配置可对文件执行分块、嵌入、混合检索与重排,并使用内存、Chroma、PgVector 或 Pinecone 向量存储;记忆层支持 S3、Redis 或 SQLite。MCP 层支持 stdio、HTTP、SSE 和 WebSocket 传输,并提供多服务器管理、工具路由、缓存和批处理。语音路径可在 generate() 或 stream() 中配置 TTS/STT,也可通过 RealtimeProcessor.connect() 建立 OpenAI Realtime 或 Gemini Live 会话。ResearchWorker 还能在指定仓库路径内提出代码修改、运行实验命令并从输出中提取指标。

  1. 维护 TypeScript 产品的团队,希望在 OpenAI、Anthropic、Vertex AI、Bedrock 或本地运行时之间切换,而不重写应用层调用。
  2. 客服平台需要用 choice 分派工单、用 score 排序优先级,并把低置信度结果交给人工复核。
  3. 知识库应用需要把文件自动分块、嵌入、检索和重排,再将相关上下文送入 generate() 或 stream()。
  4. 语音产品需要组合多家 TTS/STT 提供商,或接入 OpenAI Realtime、Gemini Live 的双向实时音频。
  5. 使用 MCP 工具服务器的工程团队,需要在同一 SDK 中管理多服务器、传输协议、工具选择、缓存和批处理。
  6. 机器学习研发人员希望让 ResearchWorker 修改指定文件、执行训练命令并按指标评估实验。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

环境变量
TYPESAFE_API_KEY AI_GATEWAY_API_KEY LAYA_API_KEY LAYA_BASE_URL

如何安装或部署这个 Agent?

已提供的材料标明 npm 包名为 @juspay/neurolink,但未展示可核验的安装命令,也没有明确写出最低 Node.js 或包管理器版本。因此无法仅依据这些材料给出完整、可复制的安装命令。安装后还需为所选后端配置相应凭据;例如 TypeSafe Jev 使用 TYPESAFE_API_KEY,也可通过带 AI_GATEWAY_API_KEY 的 Vercel AI Gateway 访问。Laya 自托管路径需要同时提供 LAYA_API_KEY 与 LAYA_BASE_URL;本地或其他提供商则按所选运行时配置。

如何使用这个 Agent?

下面是材料中给出的最小流式调用。代码创建统一管道、发送文本,并逐块输出内容:

import { NeuroLink } from "@juspay/neurolink";

const pipe = new NeuroLink();

const result = await pipe.stream({ input: { text: "Hello" } });
for await (const chunk of result.stream) {
  if ("content" in chunk) {
    process.stdout.write(chunk.content);
  }
}

需要类型化判断时,可使用故障开放的 tryDecide();未配置决策提供商时它返回 null:

import { NeuroLink } from "@juspay/neurolink";

const pipe = new NeuroLink();

const decision = await pipe.tryDecide({
  state: { ticket: "Refund request, $42, first occurrence" },
  questions: {
    autoApprove: {
      type: "boolean",
      instructions: "Approve without human review.",
    },
  },
});

console.log(decision?.answers.autoApprove.probability);

CLI 还公开了 decide 包装命令,但材料没有提供 CLI 的安装方式或完整启动配置:

neurolink decide [state]

这个 Agent 有哪些优点和局限?

优点
  • 把文本生成、流式生成和校准决策建模为三种明确的推理类型,并由提供商声明支持的 inferenceKinds。
  • 覆盖多家云模型、LiteLLM、OpenRouter,以及 Ollama、LM Studio、llama.cpp 三种本地运行时,降低单一提供商绑定。
  • MCP 原生支持 stdio、HTTP、SSE、WebSocket 四种传输,并包含工具路由、缓存、批处理和多服务器管理。
  • RAG、记忆、文件处理、嵌入、语音与多提供商回退都位于同一套 SDK 接口中。
  • 模型路由、上下文压缩和工具选择等优化采用故障开放设计;未配置决策密钥时不会强制启用。
局限
  • decide 在材料中仍标记为 next,采用者需要评估预发布接口和行为变化风险。
  • 文档称决策模型约有 68% 准确率,且不返回理由,因此不适合无人复核的不可逆操作。
  • 高级能力依赖额外服务或基础设施,例如 Redis、S3、SQLite、向量数据库、MCP 服务器和各提供商凭据。
  • 不同决策提供商的上下文限制差异显著:Laya 默认检查点约 768 tokens,而 TypeSafe 约 33,000 tokens。
  • 所给材料未包含可验证的安装命令、最低运行时版本或完整首次配置流程。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
NeuroLink 当前 56 · 缺口较多 代码库 / SDK免费 ★ 167 1 天前 TypeScript OpenAI API · Claude API
FlowCraft 75 · 表现良好 命令行工具免费 + 模型费 ★ 410 1 天前 Go OpenAI API · Claude API
AgentScope 2.0 61 · 存在缺口 代码库 / SDK免费 + 模型费 ★ 36k 1 天前 Python OpenAI API · Claude API
Qwen Code 73 · 存在缺口 命令行工具免费 + 模型费 ★ 31k 今天 TypeScript OpenAI API · Claude API

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
56/ 100 五分制 2.8 / 5
本评测基于 2026年11月8日 的源码;此后该项目发布了 15 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 14/29
可靠稳定 6/14
适用触发 12/18
规范维护 12/18
有效结果 7/13
证据核验 5/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

附件安全文档说明本地路径、URL、重定向、网络地址和大小限制,并披露未配置 allowedRoots 时可读取进程可访问的任意文件;CLI 对项目 MCP 配置采用信任门控,支持交互确认或显式信任。环境变量、远程服务、MCP 和自动研究命令会产生外部影响,文档对影响和恢复路径仅有部分说明;依赖安全材料有限,发布者身份未验证,不能据此加分。

可靠稳定6 / 14 · 2.1/5

源文件和文档指出了结构化输出截断、提供商重试与故障转移等行为,也列出具体错误处理路径;但 README 的概述和多份指南中的配置、版本说法不能在本摘录内完整核对,且依赖可用性没有逐项证据,因此扣分。

适用触发12 / 18 · 3.3/5

README、安装指南和多 Agent 配置覆盖 CLI、SDK、框架集成、不同提供商、工具和部署场景;附件策略、工具选择和能力声明提供边界。样本对目标读者及不适用场景仍不够集中,部分能力描述主要是声明,因此未给满分。

规范维护12 / 18 · 3.3/5

文档有清晰目录链接、安装步骤、示例、FAQ/故障排查入口和已知限制;LICENSE 明确为 MIT。README 的版本表和安全政策给出更新信息,但样本对维护责任、支持渠道及更新承诺的说明有限,且个别文档示例需谨慎对照实际配置。

有效结果7 / 13 · 2.7/5

生成、流式处理、结构化决策、MCP、语音、RAG 和多提供商接口展示了实际集成价值,示例也能帮助调用者开始使用。成本收益主张(如延迟与单次成本)在样本中属于项目陈述,缺少可核验的测量细节;广泛能力也带来配置和运行负担。

证据核验5 / 8 · 3.1/5

安全策略和 CLI 源码对 MCP 信任流程相互印证,附件文档给出具体配置与行为,README 也链接到专题文档。若干性能、覆盖范围和产品能力数字仍是 README 的主张,当前样本不足以独立验证;审查严格限于所给材料,未作运行或独立测试。

风险与缓解建议
  • 若路径输入来自不可信调用方,应配置 attachments.allowedRoots;默认行为允许进程读取任何可访问文件。
  • AutoResearch 示例会修改代码、提交变更、运行命令并可能回滚;应先限制可改路径、检查命令和指标设置,并确认仓库状态及恢复方式。
  • 样本未提供依赖清单、漏洞审计结果或完整实现,不能据此判断依赖风险或验证所有安全主张。
证据充分度:低 评估于 2026年11月8日 审查版本 1e68e5feda40 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/neurolink.svg?lang=zh)](https://followagents.com/zh/agents/neurolink)
<a href="https://followagents.com/zh/agents/neurolink"><img src="https://followagents.com/badge/neurolink.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v13.13.5
    发布说明摘录
    [13.13.5](https://github.com/juspay/neurolink/compare/v13.13.4...v13.13.5) (2026-11-19) Bug Fixes * (hitl): add opt-in confirmDirectToolCalls for direct executeTool built-in calls ([5080ef7](https://github.com/juspay/neurolink/commit/5080ef74f67994c85bb774599aed314220880bf6))
    在 GitHub 查看 ↗
  2. v13.13.4
    发布说明摘录
    [13.13.4](https://github.com/juspay/neurolink/compare/v13.13.3...v13.13.4) (2026-11-19) Bug Fixes * (tool-routing): enforce toolRouting.timeoutMs on the decide call ([832867b](https://github.com/juspay/neurolink/commit/832867ba92f11aee1bed721d6d8f0a366c20ded1))
    在 GitHub 查看 ↗
  3. v13.13.3
    发布说明摘录
    [13.13.3](https://github.com/juspay/neurolink/compare/v13.13.2...v13.13.3) (2026-11-19) Bug Fixes * (telemetry): redact decide error bodies before they reach spans ([ad71204](https://github.com/juspay/neurolink/commit/ad71204072a15eb6b2304836443477785b14fecb))
    在 GitHub 查看 ↗

常见问题

必须使用付费云模型吗?
不是。项目采用 MIT 许可,并明确支持 Ollama、LM Studio、llama.cpp 等本地运行时,以及可自行托管的 Laya 决策模型。使用托管提供商时,仍需自行承担相应 API 费用。
提供商或决策服务不可用时会怎样?
tryDecide() 在未配置决策提供商时返回 null。材料还说明内部路由、压缩和工具选择等优化会故障开放,并支持 providerFallback 回调及 modelChain;后两者针对 ModelAccessDeniedError 执行替代重试。
能否把 decide 用作最终审批器?
不宜直接这样使用。项目明确把它定位于可批处理、可设阈值且可逆的判断,并建议对不确定结果进行人工复核;它不提供解释,材料给出的准确率约为 68%。
RAG 数据必须发送到某个固定平台吗?
没有固定平台要求。材料列出内存、Chroma、PgVector 和 Pinecone 四种向量存储,同时可在多种云端或本地模型提供商之间选择;实际数据边界取决于采用者的配置。
是否可以按请求切换凭据和模型?
可以。所有提供商均支持按请求或按实例传入凭据,优先级为请求级高于实例级、实例级高于环境变量;提供商和模型也可随请求选择。
NeuroLink 官网是什么?
NeuroLink 的 GitHub 仓库填写的官网是 https://neurolink.ink。这个链接由仓库作者设置;源码在 GitHub(juspay/neurolink)。
NeuroLink 开源吗?
开源。源码在 GitHub(juspay/neurolink),许可证是 MIT。
NeuroLink 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 NeuroLink 的“信任与安全”打了 14/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
NeuroLink 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-20,在最近 30 天内。最新版本是 v13.13.5(2026-11-19)。
NeuroLink 是谁开发的?
NeuroLink 由 GitHub 账号 juspay 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念