n3rv

这个 Agent 能做什么，适合哪些场景？

n3rv 是由 Juan Manuel Daza 维护的运行时库与配置生成器，面向 opencode 智能体工作区。它通过 `n3rv init` 生成 AGENTS.md、opencode.、技能/命令/插件目录以及 `.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.、.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 分支保护

如何安装或部署这个 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 有哪些优点和局限？

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

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

FollowAgents 如何评估这个 Agent？

常见问题