n3rv
为 opencode AI 智能体提供隐形工程基础设施:记忆、技能与子智能体调度,一条命令即可初始化工作区。
- Star 数
- ★ 11
- 最近更新
- 1 个月前
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 49/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- opencode 用户想为新项目一次性生成 AGENTS.md、技能目录与 git hooks 等完整工作区脚手架
- 不适合
- 不使用 opencode、只想获得开箱即用托管智能体的团队
- 没有 DashScope/OpenAI 密钥且无法部署本地模型的用户
- 官网
- n3rv.daza.ar ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-10-13最新版本 v0.1.2(2026-10-13)
- 源码审查
- 49/100 · 缺口较多
这个 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 分支保护。
- opencode 用户想为新项目一次性生成 AGENTS.md、技能目录与 git hooks 等完整工作区脚手架
- 团队需要跨多个 opencode 进程委派任务,并通过 A2A hub 按 skill_id 路由
- 开发者希望智能体拥有长期语义记忆,用 ChromaDB 检索过去的会话摘要与裁决
- 使用 DashScope 上 Qwen 模型的用户想让卫星在运行时解析 provider,而不硬编码模型 ID 或密钥
- MCP 客户端用户想通过 stdio 服务器直接调用记忆检索或任务委派能力
- 维护多个仓库的组织想共享技能并自动配置 GitHub 分支保护
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
pip install git+https://github.com/juanmanueldaza/n3rv.gitpip install -e ".[dev]"
- 环境变量
DASHSCOPE_API_KEYN3RV_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?
查看各维度的扣分理由
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,不据此推断其他维度。
README、CLI 与静态测试样例显示了多个子系统、错误恢复状态和部分工具约定,提供一定内部佐证,故自洽性给 1;依赖只有最低版本且关键 ChromaDB 说明仍指向未修复版本,依赖可用性给 1。CLI 中 converge 实际只打印引导信息,和 README 所述重跑 verify 并生成任务的能力不符;错误信息策略证据有限,因此失败消息给 1。
README 面向 opencode 工程工作流,覆盖 Python、Node、Go、generic、多卫星及 SDD 场景,适用对象和情境明确,给 2。代码图谱注明 Python AST 覆盖、MCP 工具和安全 memory profile 有边界说明,能力边界给 2;但 18 项技能和多类工具的触发条件在样本中未提供,触发精确度给 1。Python 3.11+、opencode 配置、systemd 用户服务和本地 hub 地址说明了环境适配,给 2。
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;身份未验证不构成扣分。
多个 MCP 工具、持久化记忆、任务路由、代码图谱和执行缓存面向工程代理提供结构化输出和集成入口,输出可用性与边际价值给 2。另一方面,运行 daemon、向项目写入配置、依赖本机数据库/观察器及多服务部署带来维护成本;样本未量化收益或给出简化成本的依据,成本效益给 1。
README 的工具数、CLI、环境变量和目录结构有 pyproject、CLI 及测试样例的部分对应,主要主张可追踪,给 2;不同来源对功能的佐证不完整且有 converge 描述不一致,交叉佐证给 2。文档主张、代码入口和测试样例可区分,但部分安全声明(例如 ChromaDB 不可利用的判断)是仓库注释中的主张,未在此静态材料中独立验证,事实与推断区分给 2。
- 不要把仓库对 ChromaDB CVE 在本地 PersistentClient 用法下不可利用的说明视为独立安全验证;依赖仍允许文档所述未修复版本。
- README 声称 converge 会重跑验证并生成补救任务,但所示 CLI 实现只打印提示;使用前应核实该工作流。
- 默认 memory profile 为 full,包含删除和清理能力;daemon 可配置为登录启动,启用前应检查项目数据和服务设置。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
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 查看 ↗ -
发布说明摘录
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 查看 ↗
常见问题
运行 n3rv 需要付费吗?
必须使用 opencode 吗?
默认 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)吗?
n3rv 官网是什么?
n3rv 开源吗?
n3rv 安全吗?
n3rv 还在维护吗?
n3rv 是谁开发的?
谢谢反馈,我们会据此改进页面。