n3rv

为 opencode AI 智能体提供隐形工程基础设施:记忆、技能与子智能体调度,一条命令即可初始化工作区。

Star 数
★ 11
最近更新
1 个月前
License
Apache-2.0
主语言
Python

30 秒速览

运行形态
命令行工具MCP 服务器代码库 / SDK
可在哪里用
通用 · 跨平台OpenAI API
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Python(pip)ChromaDBSQLiteDashScope API 密钥或 OpenAI API 密钥或本地 Ollama/vLLMShell / 命令行网络访问本地文件系统MCP Server
典型场景
opencode 用户想为新项目一次性生成 AGENTS.md、技能目录与 git hooks 等完整工作区脚手架
不适合
  • 不使用 opencode、只想获得开箱即用托管智能体的团队
  • 没有 DashScope/OpenAI 密钥且无法部署本地模型的用户
官网
n3rv.daza.ar ↗ 来自 GitHub 仓库设置
维护状态
近半年有提交最近提交 2026-10-13最新版本 v0.1.2(2026-10-13)

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

n3rv 是由 Juan Manuel Daza 维护的运行时库与配置生成器,面向 opencode 智能体工作区。它通过 n3rv init 生成 AGENTS.md、opencode.json、技能/命令/插件目录以及 .n3rv/ 记忆与 hub 配置。运行时能力包括 provider 抽象(Qwen/DashScope、OpenAI、本地 Ollama/vLLM)、基于 HTTP 的 A2A hub 跨进程任务委派,以及 MAGI 双存储记忆(ChromaDB 向量检索 + SQLite 关系存储)。它还内置两个 MCP stdio 服务器:n3rv-memory 和 n3rv-hub,供 MCP 客户端调用。该项目采用 Apache-2.0 许可证,定位为配套仓库 reverberage/hub 中卫星协议规范的参考实现。

安装后,n3rv init 使用 Jinja2 模板在你的项目中生成 AGENTS.md、opencode.json、.opencode/(技能、智能体、命令、插件)、.n3rv/(记忆、hub 配置)和 .githooks/。运行时,ModelProvider Protocol 与 get_provider() 工厂按 N3RV_PROVIDER 环境变量解析 LLM 后端(qwen/openai/local),无需在卫星代码中硬编码模型 ID 或 API 密钥。A2A hub 通过 n3rv hub start 在 127.0.0.1:19820 上按 skill_id 路由跨进程智能体任务,并将结果持久化到 JSON 文件。MAGI 记忆把 SDD 产物、会话摘要和智能体裁决写入 ChromaDB(语义检索)与 SQLite(关系),可通过 n3rv memory list|search|prune|stats 管理。MCP 服务器 n3rv-memory 与 n3rv-hub 以 stdio 方式暴露记忆操作与任务委派。n3rv daemon 管理后台守护进程,n3rv org 管理多项目工作区与 GitHub 分支保护。

  1. opencode 用户想为新项目一次性生成 AGENTS.md、技能目录与 git hooks 等完整工作区脚手架
  2. 团队需要跨多个 opencode 进程委派任务,并通过 A2A hub 按 skill_id 路由
  3. 开发者希望智能体拥有长期语义记忆,用 ChromaDB 检索过去的会话摘要与裁决
  4. 使用 DashScope 上 Qwen 模型的用户想让卫星在运行时解析 provider,而不硬编码模型 ID 或密钥
  5. MCP 客户端用户想通过 stdio 服务器直接调用记忆检索或任务委派能力
  6. 维护多个仓库的组织想共享技能并自动配置 GitHub 分支保护

安装与配置要点

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

安装 / 启动命令
  • pip install git+https://github.com/juanmanueldaza/n3rv.git
  • pip install -e ".[dev]"
环境变量
DASHSCOPE_API_KEY N3RV_DEFAULT_MODEL

如何安装或部署这个 Agent?

使用 pip 直接从 GitHub 安装,然后在项目目录中初始化:

bash

pip install git+https://github.com/juanmanueldaza/n3rv.git

如需运行测试,请安装开发依赖:

bash

pip install -e ".[dev]"

pytest

如何使用这个 Agent?

在项目目录中初始化工作区(可指定技术栈):

bash

cd your-project
n3rv init [--stack python|node|go|generic] [--force]

设置所需的环境变量(默认 provider 为 qwen):

bash
export DASHSCOPE_API_KEY=...

export N3RV_PROVIDER=qwen
export N3RV_DEFAULT_MODEL=qwen3-coder-plus

启动 A2A hub、管理守护进程与记忆:

bash

n3rv hub start
n3rv daemon install|start|stop|status|enable|logs
n3rv memory list|search|prune|stats
n3rv org init|list|add|remove|protect

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

优点
  • 一条 n3rv init 即可生成完整 opencode 工作区(AGENTS.md、技能、插件、git hooks),省去手工搭建
  • provider 抽象支持 Qwen、OpenAI 与本地 Ollama/vLLM,卫星运行时解析后端,避免供应商锁定
  • A2A hub 提供基于 HTTP 的跨进程智能体任务委派,按 skill_id 路由并持久化结果
  • MAGI 双存储记忆结合 ChromaDB 语义检索与 SQLite 关系数据,覆盖会话摘要与裁决持久化
  • 内置 MCP stdio 服务器(n3rv-memory、n3rv-hub),可被任意 MCP 客户端复用
局限
  • 核心面向 opencode 生态,不使用 opencode 的团队需要自行评估其生成配置的适配成本
  • 默认依赖 DashScope/Qwen(含特定默认 base URL),切换 provider 需理解环境变量体系
  • MAGI 记忆需要维护 ChromaDB 与 SQLite 双存储,带来额外的运行时与数据管理负担
  • 除 README 外缺乏独立的部署文档或发布版本说明,评估深度集成需自行阅读代码
  • 上游项目(juanmanueldaza/n3rv)为 GPL-2.0,而本仓库为 Apache-2.0,许可证差异需要法务确认

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

README 将其与姊妹仓库 reverberage/hub 明确分工:hub 提供卫星协议、规范与脚手架脚本(契约),n3rv 提供运行时引擎(provider、A2A hub、记忆、守护进程、CLI、init)。两者均为 Apache-2.0。

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

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
n3rv 当前 49 · 缺口较多 命令行工具免费 + 模型费 ★ 11 1 个月前 Python OpenAI API
FastAgent 60 · 存在缺口 命令行工具免费 + 模型费 ★ 4k 今天 Python Codex · OpenAI API · Claude API
lcc 本地上下文编译器 77 · 表现良好 命令行工具免费 ★ 20 2 天前 Python Claude Code
Compartment 73 · 存在缺口 命令行工具免费 ★ 473 3 天前 Python Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
49/ 100 五分制 2.5 / 5
信任安全 12/29
可靠稳定 5/14
适用触发 10/18
规范维护 10/18
有效结果 7/13
证据核验 5/8
查看各维度的扣分理由
信任安全12 / 29 · 2.1/5

README 清楚列出本地持久化记忆、SQLite/ChromaDB、hub 状态、环境变量和本机 127.0.0.1 服务,数据流可见,故给 2;memory 默认 full 且包含 delete/prune,daemon 可设为登录启动,init 的 --force 可覆盖文件,但材料没有显示这些操作前的确认、安全权限细节或统一恢复机制,最小权限、确认、外部影响和回滚仅给 1。虽有 API key 环境变量说明,未见密钥保护及删除保留策略,敏感数据处理给 1。依赖版本有下限但无上限;ChromaDB 注释记录已知 CVE 及本地模式理由,却依赖未修复版本并以未来升级为条件,故依赖安全仅给 1。README 和 pyproject 有维护者署名,但发布者身份按要求仍视为未知;来源归属给 2,不据此推断其他维度。

可靠稳定5 / 14 · 1.8/5

README、CLI 与静态测试样例显示了多个子系统、错误恢复状态和部分工具约定,提供一定内部佐证,故自洽性给 1;依赖只有最低版本且关键 ChromaDB 说明仍指向未修复版本,依赖可用性给 1。CLI 中 converge 实际只打印引导信息,和 README 所述重跑 verify 并生成任务的能力不符;错误信息策略证据有限,因此失败消息给 1。

适用触发10 / 18 · 2.8/5

README 面向 opencode 工程工作流,覆盖 Python、Node、Go、generic、多卫星及 SDD 场景,适用对象和情境明确,给 2。代码图谱注明 Python AST 覆盖、MCP 工具和安全 memory profile 有边界说明,能力边界给 2;但 18 项技能和多类工具的触发条件在样本中未提供,触发精确度给 1。Python 3.11+、opencode 配置、systemd 用户服务和本地 hub 地址说明了环境适配,给 2。

规范维护10 / 18 · 2.8/5

README 按子系统、安装、CLI、MCP、配置和文档组织,并链接部署及工具说明,信息架构给 2;快速安装和脚手架步骤较具体,安装说明给 2。名称体系较丰富但部分描述与实现不吻合(如 converge),故命名稳定性给 1。CLI 示例、配置示例、部署文档索引和安全政策提供了可用参考,示例与 FAQ 给 2;限制只零散提及 Python AST、systemd、实验性后台子代理和依赖 CVE,未形成完整限制清单,给 1。LICENSE 与项目元数据明确 Apache-2.0,给 3。版本为 0.1.2 且链接 releases,但样本无变更记录,版本/变更说明给 1。README 和 SECURITY.md 给出维护者及漏洞报告渠道和时间目标,维护责任给 2;身份未验证不构成扣分。

有效结果7 / 13 · 2.7/5

多个 MCP 工具、持久化记忆、任务路由、代码图谱和执行缓存面向工程代理提供结构化输出和集成入口,输出可用性与边际价值给 2。另一方面,运行 daemon、向项目写入配置、依赖本机数据库/观察器及多服务部署带来维护成本;样本未量化收益或给出简化成本的依据,成本效益给 1。

证据核验5 / 8 · 3.1/5

README 的工具数、CLI、环境变量和目录结构有 pyproject、CLI 及测试样例的部分对应,主要主张可追踪,给 2;不同来源对功能的佐证不完整且有 converge 描述不一致,交叉佐证给 2。文档主张、代码入口和测试样例可区分,但部分安全声明(例如 ChromaDB 不可利用的判断)是仓库注释中的主张,未在此静态材料中独立验证,事实与推断区分给 2。

风险与缓解建议
  • 不要把仓库对 ChromaDB CVE 在本地 PersistentClient 用法下不可利用的说明视为独立安全验证;依赖仍允许文档所述未修复版本。
  • README 声称 converge 会重跑验证并生成补救任务,但所示 CLI 实现只打印提示;使用前应核实该工作流。
  • 默认 memory profile 为 full,包含删除和清理能力;daemon 可配置为登录启动,启用前应检查项目数据和服务设置。
证据充分度:低 评估于 2026年11月8日 审查版本 64db2af31003
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

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

FARS

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

最近版本

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

  1. v0.1.2
    发布说明摘录
    Patch release fixing the MCP memory_delete tool. - memory_delete raised TypeError: MemoryService.memory_delete() got an unexpected keyword argument 'enforce_profile' on every call. The stray keyword is removed; the service already reads N3RV_MEMORY_PROFILE and gates hard_delete internally. - Added regression tests that invoke the *registered* tool through MCPServer.call_tool. This was the coverage gap: the existing service-level tests passed while the tool itself was 100% broken.
    在 GitHub 查看 ↗
  2. v0.1.1
    发布说明摘录
    What's Changed * build(deps-dev): update uv-build requirement from <0.9.0,>=0.8.11 to >=0.8.11,<0.12.0 by @dependabot[bot] in https://github.com/juanmanueldaza/n3rv/pull/37 * feat(code-graph): CodeGraph-inspired surgical explore with auto-sync by @juanmanueldaza in https://github.com/juanmanueldaza/n3rv/pull/50 * feat: add converge command to n3rv CLI by @juanmanueldaza in https://github.com/juanmanueldaza/n3rv/pull/54 * feat(harness): n3rv-scout/n3rv-sensor specialist subagents + universal exec MCP by @juanmanueldaza in https://github.com/juanmanueldaza/n3rv/pull/64 …
    在 GitHub 查看 ↗
  3. v0.1.0
    发布说明摘录
    Initial release
    在 GitHub 查看 ↗

常见问题

运行 n3rv 需要付费吗?
软件本身是免费开源的(Apache-2.0),但使用 Qwen/DashScope 或 OpenAI 等云端 provider 需要自备 API 密钥并按用量付费;也可配置本地 Ollama/vLLM 以避免云费用。
必须使用 opencode 吗?
生成的工作区(AGENTS.md、opencode.json、.opencode/)是为 opencode 设计的,MCP 服务器理论上可被其他 MCP 客户端消费,但核心场景是 opencode 智能体工作区。
默认 provider 和模型是什么?
默认 provider 为 qwen,默认模型 ID 为 qwen3-coder-plus,默认 base URL 指向 DashScope 国际兼容端点;可通过 N3RV_PROVIDER 和 N3RV_DEFAULT_MODEL 等环境变量覆盖。
A2A hub 如何工作?
通过 n3rv hub start 启动后监听 127.0.0.1:19820,按 skill_id 路由跨进程智能体任务,并将结果持久化到 JSON 文件。
n3rv 是一个卫星(satellite)吗?
不是。README 明确说明它是卫星插入的运行时框架(harness),而非卫星本身。
n3rv 官网是什么?
n3rv 的 GitHub 仓库填写的官网是 https://n3rv.daza.ar。这个链接由仓库作者设置;源码在 GitHub(juanmanueldaza/n3rv)。
n3rv 开源吗?
开源。源码在 GitHub(juanmanueldaza/n3rv),许可证是 Apache-2.0。
n3rv 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 n3rv 的“信任与安全”打了 12/29 分。评审检查的 8 项安全措施没有完全缺失的。
n3rv 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-10-13,在最近半年内,但不在最近 30 天内。最新版本是 v0.1.2(2026-10-13)。
n3rv 是谁开发的?
n3rv 由 GitHub 账号 juanmanueldaza 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

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

相关核心概念