ysunyang4/Nexus

项目介绍

Nexus 是一套桌面端本地 AI 控制中枢。它把 ChatGPT、DeepSeek、Cursor、Windsurf 等远端或网页端 AI 客户端，通过带 Bearer 令牌认证的 Streamable HTTP MCP 隧道，连接到开发者本机；控制中心内的 Fastify MCP 服务收到请求后，经 JSON-RPC 转发给本地 Runner 守护进程，由后者实际执行文件、Git、命令、浏览器和 Windows 桌面操作。

Runner 提供覆盖 24 个能力维度的 332 项 MCP 工具，包括文件系统、Git、命令执行、后台作业、TypeScript/Python LSP 代码智能、浏览器自动化、Windows Computer Use、本地记忆与提示词库。所有有副作用的操作先写入基于 SQLite 的 Action Ledger 预写日志，用于崩溃恢复和幂等重放；命令经 AST 分析分为 SAFE、CAUTION、DANGEROUS 三级，默认拦截 rm -rf /、format、reg delete 等破坏性命令。

访问范围按授权项目根目录限定，通过真实路径规范化阻断 ../ 遍历和软链接、NTFS Junction 逃逸，并默认屏蔽 .env*、*.pem、*.key、id_rsa 等敏感文件。

快速使用

从源码构建需要 Node.js >= 24、pnpm >= 10 和 stable Rust：

git clone https://github.com/ysunyang4/Nexus.git
cd Nexus
pnpm install
pnpm run build
pnpm --filter @localbridge/desktop dev

也可以在 v1.3.1 发布页 查看实际列出的安装包，按平台下载后先校验已有的校验和或签名再运行。中文 README 列出了 Windows、macOS、Linux 和油猴脚本的文件名，但英文段同时提醒：未出现在发布页上的平台资产不应假定存在。

启动桌面端后：

1. 进入「工作区 -> 项目管理」，授权一个目录，并选择只读或读写访问模式，以及 disabled、safe-only 或 project-code 执行模式。
2. 进入「设置 -> 访问令牌」，生成 MCP 客户端令牌（lb_...）。
3. 在 AI 客户端中填入 http://127.0.0.1:18080/mcp，并添加请求头 Authorization: Bearer lb_your_token_here。标准 MCP 配置示例：

{
  "mcpServers": {
    "nexus": {
      "url": "http://127.0.0.1:18080/mcp",
      "headers": {
        "Authorization": "Bearer lb_your_token_here",
        "MCP-Protocol-Version": "2024-11-05"
      }
    }
  }
}

使用约束

• 源码构建依赖 Node.js >= 24、pnpm >= 10 和 Rust stable；桌面端基于 Tauri 2。
• Windows Computer Use 依赖 WinRT OCR 与 UI Automation，属于 Windows 原生能力，不适用于 macOS 和 Linux。
• 默认是只读访问和 safe-only 执行。启用读写、project-code、桌面接管或无限制模式后，AI 所执行的命令和修改的文件由用户自行负责，应做好备份或使用 Git 版本控制。
• 采用 AGPL-3.0-only 许可证，分发修改版或将其作为网络服务提供时涉及源码提供和声明义务，署名与品牌规则与许可证相互独立。
• 沙箱与安全行为的完整说明见项目的 SECURITY.md；README 是作者描述，不等同于独立验证。

HotRepo 点评

Nexus 在 2026-11-15 出现在 HotRepo 的 TypeScript 新项目榜上，在约一小时的统计窗口内新增 13 Star，累计 119 Star、23 Fork。这只是一条单日快照，说明发布当天已有初步关注，还谈不上持续增长趋势。对一个如此年轻的仓库来说，其架构描述相当具体：独立的 332 工具协议包、基于 WAL 的操作账本、双令牌隔离和成文的安全模型，都指向一个真实的多包代码库。对读者而言更需要核实的是发布来源：主要入口是预编译安装包，而现有材料无法说明这些二进制与仓库源码的构建对应关系。