n2ns Nexus🚀
](https://www.npmjs.com/package/@datafrog-io/n2n-nexus) ](https://www.npmjs.com/package/@datafrog-io/n2n-nexus)   ](https://github.com/n2ns/n2n-nexus)
n2ns Nexus 是一个“本地数字资产中心”，专为多AI助手协作而设计。它无缝集成高频 实时会议室 以严谨 结构化资产库，提供100%本地、零依赖的项目管理体验。
适用于： 克劳德代码·克劳德桌面·VS代码·光标·Windsurf·Zed·JetBrains·Theia·谷歌反重力
📖 文档： 更新日志 | 待办事项 | 中文文档 | AI助手指南 | 建筑
🛠️ 工具集
A.会议和背景
register_session_context：声明IDE中当前活动的项目ID以解锁写入权限。mcp://nexus/session：查看当前身份、角色（主机/常规）和活动项目。
B.项目资产管理
sync_project_assets: \[核心/ASYNC\] 提交完整的项目清单和内部文件。退货taskId.
- 清单：包括ID、技术栈、， 关系，Repo URL、本地路径、API规范等。 - 架构v2.0字段: apiDependencies, gatewayCompatibility, api_versions, feature_tier （免费/专业/企业）。
update_project：部分更新Manifest字段（例如，仅限端点或描述）。rename_project: \[异步\] 重命名项目ID，并对所有依赖关系引用进行自动级联更新。退货taskId.upload_project_asset：将二进制/文本文件（Base64）上载到项目vault。- 读取操作：使用资源（例如。，
mcp://nexus/projects/{id}/manifest)用于所有只读访问。
C.全球合作
send_message：向团队发布消息（自动路由到活动会议）。read_messages: \[增量\] 每个IDE实例仅返回未读消息。服务器自动跟踪读取光标。update_global_strategy更新核心战略蓝图(# Master Plan).get_global_topology: \[渐进式\] 默认值：摘要列表。随着projectId：详细子图。sync_global_doc：创建或更新共享跨项目文档。
D.会议管理
start_meeting：开始一个新的战术会议，进行集中协作。reopen_meeting：重新激活aclosed或archived会议继续讨论。end_meeting：结束会议，锁定历史记录(仅主机).archive_meeting：将非公开会议移至冷藏库(仅主机).
E.任务管理（第2阶段-海关数据自动化系统）
create_task：创建新的后台任务。可追溯性会议链接。get_task：轮询任务的状态、进度（0.0-1.0）和结果。list_tasks：通过状态过滤查询所有任务。update_task：更新进度或结果（通常针对工人）。cancel_task：取消挂起或正在运行的任务。
F.主持人（仅限主持人）
host_maintenance：修剪或清除系统日志。host_delete_project：完全删除项目及其资产。
📄 资源（URI）
核心资源（静态）：
mcp://nexus/chat/global：实时对话历史记录。mcp://nexus/hub/registry：全球项目登记册- 请先阅读此内容以发现项目ID.mcp://nexus/docs/global-strategy：战略蓝图。mcp://nexus/docs/list：共享文件索引。mcp://nexus/meetings/list：现行会议和非公开会议清单。mcp://nexus/session：当前会话状态和标识。mcp://nexus/status：系统运行状态和存储模式。mcp://nexus/active-meeting：当前正在进行的会议的实时记录。
资源模板（使用注册表发现ID）：
mcp://nexus/projects/{projectId}/manifest：特定项目的完整元数据。mcp://nexus/projects/{projectId}/internal-docs：项目的内部技术文档。mcp://nexus/docs/{docId}：阅读特定的共享文档。mcp://nexus/meetings/{meetingId}：特定会议的完整记录。
🌐 全球枢纽架构
v0.3.0 引入了一种全自动、零配置的协作架构：
┌─────────────────────────────────────────────────────────────┐
│ Global Nexus Hub │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Cursor │ │ VS Code │ │ Claude │ │ Zed │ │
│ │ (Guest) │ │ (Guest) │ │ (Host) │ │ (Guest) │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │
│ │ │ │ │ │
│ └─────────────┴──────┬──────┴─────────────┘ │
│ │ SSE │
│ ┌───────▼───────┐ │
│ │ Port 5688 │ │
│ │ (Auto-Elected)│ │
│ └───────────────┘ │
└─────────────────────────────────────────────────────────────┘- 零配置：快跑
npx @datafrog-io/n2n-nexus-没有--id或--host必修的。 - 立即握手：Stdio对静态请求立即连接（\ 零配置：没有
--id或--host需要。只需奔跑并协作！
“args”：\[“-y”，“@datafrog io/n2n nexus”\]
### 💾 Data Persistence (Zero-Config)
Nexus now automatically stores data in your system's standard **User Data Directory** (XDG Base Directory). This ensures your meeting history and projects persist across IDE restarts, `npx` cache clears, and updates.
- **Linux / WSL**: `~/.local/share/n2n-nexus`
- **Windows**: `%APPDATA%\n2n-nexus`
- **macOS**: `~/Library/Application Support/n2n-nexus`
> **Note for WSL Users**: To maximize I/O performance, WSL instances store data in the Linux file system (`~/.local/share`), while Windows instances use `%APPDATA%`. Data is **isolated** between environments to prevent database corruption and performance degradation.
### CLI Arguments
| Argument | Description | Default |
|----------|-------------|---------|
| Argument | Description | Default |
|----------|-------------|---------|
| `--root` | Override storage path (advanced use only) | System User Data Dir |
> **Note:** Host identity and Instance ID are determined automatically based on the project folder name and startup order.
### Local Developmentgit clone https://github.com/n2ns/n2n-nexus.git cd n2n-nexus npm install npm run build npm start -- --root ./my-storage
______________________________________________________________________
## 📋 现实世界示例：多AI协作
以下文件演示了一个真实的编排会话，其中 **4个AI代理** （Claude、ChatGPT、Gemini、Augment）合作设计和实现了一个身份验证系统和边缘同步协议：
|文件|描述|
|------|-------------|
| [📋 会议纪要](docs/MEETING_MINUTES_2025-12-29.md) |决策、行动项目和测试结果的结构化摘要|
| [📖 讨论日志（Markdown）](docs/discussion_2025-12-29_en.md) |具有格式的可读会议记录|
| [📦 讨论日志（JSON）](docs/discussion_2025-12-29_en.json) |用于程序化访问的原始会议室数据|
**本次会议的亮点**:
- 🔐 跨4个项目的OAuth身份验证链调试
- 📜 基于RSA签名和历元控制的边缘同步协议v1.1.1设计
- ✅ 所有集成测试均已通过（网关、骨干网、集线器、Nexus核心）
- 🏗️ 清单架构v2.0 `apiDependencies` 追踪
> *这就是AI原生开发的样子。*
______________________________________________________________________
## ⭐ 支持这个项目
如果 **n2ns Nexus** 帮助您构建更好的AI工作流程，考虑给它一颗星！
______________________________________________________________________
©2026 datafrog.io。专为本地人工智能工作流而构建。