← 返回目录
N

Nauro

社区
为你的智能体提供代码注释遗漏的上下文
GitHub 源仓库 ↗
★ 10 Stars 分类 · 开发工具 热门 源版本 ad549d7c0d69
58FMRS · C

Nauro是一种基于本地的MCP服务器,为AI编码代理提供共享的项目记忆,强调人工批准和记录决策理由。其安装配置通过uvx/PyPI分发,适合长期项目的开发工作流。虽然服务器本身不托管,但由项目原始维护方维持稳定。

可靠性
10/20
安全与权限
12/20
维护活跃度
12/20
文档质量
12/20
安装易用性
12/20
查看 FMRS 评分方法 →

Nauro将当前状态、未决问题以及经人工确认的项目决策记录在同一个存储中,随时可供你连接的每个智能体使用。该记录整合了项目范围、状态、未决问题和决策背后的理由。Nauro在开始工作前会提供相关片段,随后将已获批准的项目判断及进度报告带入后续会话和相连的工具中。

工具能力

check-decision
向项目记录提交新的决策以进行核对和批准。

安装接入

使用命令 uv tool install nauro 安装Nauro。需先安装uv(macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh;Windows见文档)。若使用Python 3.10+,也可以运行 pipx install nauro。安装后,进入你的仓库并运行 nauro adopt --with-skills --with-subagents,重启智能体,然后在Claude Code中调用 /nauro-adopt,或在Codex中调用 $nauro-adopt

选型与风险

适合谁

  • 需要项目上下文在会议、工具和交接中持续存在多个会话的长期项目
  • 与Claude Code、Codex或Cursor等人工智能编码代理配合使用,减少重复提问和上下文丢失的情况
  • 优先考虑数据本地性并重视记录中人工认证决策的团队

不适合谁

  • 小型仓库:如果一份可靠的AGENTS.md或CLAUDE.md足以保持代理方向,Nauro可能显得过度设计
  • 对每次变更采用严格门禁的CI/CD管道——Nauro的检索是建议性的,从不阻止变更
  • 用户希望全自动决策记录而不需要人工审批的工具

所需权限

  • 本地记录为纯Markdown,由你拥有;本地使用无需账户,无遥测数据
  • Nauro可以读取项目文件(README、代码)来判断决策的合理性,但未经你明确批准不会写入
  • 如果需要,可安装skill文件和工作流agent(如nauro-ship-task)
  • 通过`nauro sync`显式覆盖(例如AGENTS.md)——这是唯一受控的覆盖路径

风险与副作用

  • 未经维护的AGENTS.md可能被覆盖——Nauro在采用期间会进行保护,`nauro sync`是唯一的刻意覆盖方式,并且受`# Manual`段落的保护
  • 作为MCP服务器,会通过stdio暴露,因此任何使用该MCP的客户端都可以访问本地记录内容
  • Nauro不对代理实施强制审核;它是咨询工具,最终决定权在代理手中

常见排障

  1. 运行 `nauro status` 验证MCP以及已安装的skills和workflow agents是否就位
  2. 运行 `nauro doctor` 检查项目存储的健康状况
  3. 如果skills未加载,请确保使用 `--with-skills --with-subagents` 标志进行配置,并重启你的代理
  4. 如需强制同步,请检查`nauro sync`是否在未修改配置文件的情况下不可用

使用场景

在较长生命周期的项目中,维护跨会话、工具、仓库或机器的共享项目记忆
在开始新会话或与其他智能体协同时,快速了解项目的当前状态和决策理由
记录并围绕关键架构决策建立共识,例如使用十进制数存储金额

支持客户端

Claude Desktop部分支持