Nexus 是一个面向 ChatGPT、DeepSeek 等网页 AI 助手和现代 AI 编程助手的本地 AI 控制平面。它通过带 Bearer Token 的 Streamable HTTP MCP 隧道,把远程 LLM 连接到本地工作站,让 AI 代理在受限制的沙箱边界内检查、编辑、构建、调试和编排本地工程流程,同时避免直接暴露完整文件系统。项目由 TypeScript 编写,采用 AGPL-3.0 许可证,目前在 GitHub 上获得 482 个 Star 和 87 个 Fork。
项目定位与解决的核心问题
网页版 AI 助手通常无法直接访问本地文件、终端、Git 和桌面工具。Nexus 的做法是在本地运行一个控制中心,并由它对外提供 MCP 服务端点。AI 客户端通过该端点调用本地能力,用户则可以在控制中心中授权项目目录、设置访问模式并管理令牌。
README 强调,Nexus 不会把完整文件系统暴露给远程模型,也不会将专有代码传输给不受信任的云端中间商。它提供桌面控制中心,用于实时观测系统遥测、活动工作区、已注册工具以及 CPU/内存指标。
主要功能特点
332 个规范化 MCP 工具
所有工具都在 @localbridge/protocol 中正式定义,带有输入 schema、风险评级和自动化证据追踪。README 称其覆盖 24 个能力维度,包括文件系统、Git 操作、命令执行、持久后台任务、LSP 代码智能、托管工作树、浏览器自动化、Windows Computer Use、视觉分析、文档工程、本地记忆/规则/知识、Agent 编排和系统发现等。
ACID 兼容的 Action Ledger WAL
关键工具执行会在产生副作用之前写入预写日志(.wal)。该机制支持崩溃恢复和状态重放,可在主机重启或 runner 崩溃后恢复待处理操作,并通过幂等保护避免网络重连期间的重复执行。
Windows Computer Use 与视觉能力
Nexus 结合 WinRT 原生 OCR 和 UI Accessibility 树来定位屏幕元素,而不是依赖脆弱的像素坐标。它支持多显示器控制、窗口切换、鼠标跟踪、拖放和按键分发,并提供截图捕获、图像比较和差异检查,用于自动化 UI 测试。相关操作保留了人工接管控制。
持久执行与进程隔离
在 Windows 上,Nexus 使用 Job Objects 对派生命令实施进程层级隔离、CPU 配额和内存上限。终端守护进程基于 node-pty,提供有状态的伪终端会话、ANSI 日志流和退出码跟踪。命令风险引擎基于 AST 对命令分类为 SAFE、CAUTION、DANGEROUS,默认阻止破坏性系统调用。
本地智能存储
项目提供 SQLite 支持的本地智能存储,支持精确匹配与语义检索的混合方式,用于持久化项目记忆、团队规则、知识文档和自定义提示模板。它还包含上下文压缩器,用于多轮代理任务中的 token 缩减,以及支持动态提案、自动验证和热重载的技能引擎。
多层级路径沙箱与企业安全
Nexus 通过 fs.realpathSync.native 将文件访问限制在授权项目根目录内,防范目录遍历和前缀混淆攻击,并阻止指向项目边界之外的符号链接和 Windows NTFS 目录联接。MCP 客户端令牌(lb_...)与 Runner 守护进程令牌(lbr_...)使用 256 位熵生成,仅以 SHA-256 哈希形式存储,并通过 crypto.timingSafeEqual 缓解时序侧信道攻击。敏感文件如 .env*、*.pem、*.key、id_rsa、.git 和云凭据会被自动屏蔽。
使用方式
Nexus 提供桌面安装包,也支持从源码构建。安装包覆盖 Windows x64、macOS Universal、macOS Apple Silicon、Linux Debian/Ubuntu 和 Linux AppImage,另外还提供 Tampermonkey 浏览器用户脚本 nexus-web-agent.user.js。安装后,Nexus 会在系统托盘启动,并自带 Node.js 运行时、语言服务器和后台 runner 守护进程。
从源码构建需要 Node.js >= 24、pnpm >= 10 和 Rust stable。
连接 AI 客户端的基本流程如下:
- 在桌面控制中心的 Workspace -> Projects 中点击 Authorize Project,选择本地目录。
- 设置访问模式(
read-only或read-write)和执行模式(disabled、safe-only或project-code),两者均可动态切换,无需重启。 - 在 Settings -> Tokens 中生成 MCP 客户端令牌(
lb_...)。 - 在 AI 客户端中配置 Streamable HTTP 端点,并添加
Authorization: Bearer lb_your_token_here请求头。
对于 Cursor、Windsurf 或其他 MCP 客户端,传输方式选择 Streamable HTTP,URL 填写 http://127.0.0.1:18080/mcp,并设置相应的 Authorization 请求头。ChatGPT / 自定义 GPT Actions 也使用相同的 Streamable HTTP 端点和 Bearer Token。
适用人群与场景
Nexus 主要面向需要让网页 AI 助手参与本地工程工作的开发者,例如希望 AI 代理读取和修改本地项目文件、执行 Git 操作、运行终端命令、进行代码智能分析,或通过浏览器和 Windows 桌面自动化完成操作的用户。README 还展示了与 Blender 4.x/5.x 的程序化 3D 建模、几何节点编排和 PBR 着色器合成,以及 Unity 编辑器内 AI Copilot 的集成场景。
注意事项
默认情况下,Nexus 强制执行严格的路径沙箱(read-only)和 AST 命令风险过滤(safe-only)。如果用户主动启用 read-write、project-code、Computer Use UI 自动化或不受限/完全控制模式,则需要对连接 AI 模型执行的所有命令和修改的文件承担全部责任。README 建议备份关键工作或使用 Git 版本控制。
许可证为 GNU AGPL-3.0。README 说明该许可证允许个人和商业使用、修改与再分发,但分发受覆盖作品或通过网络提供修改版本时,可能触发相应的源码和声明要求。软件许可证不自动授予商标权,也不允许暗示官方背书。
项目主页
https://github.com/ysunyang4/Nexus
项目地址:Nexus
相关推荐
Ponytail:让 AI 编程代理学会“少写代码”的 Claude Code 技能
格知 AI · Gezhi Sheets:用一句话操作本地表格的开源 AI 助手,支持 GLM、Kimi、豆包、DeepSeek、Qwen
白板上的 AI 老师怎么教?开源项目 whiteboard-ai-tutor 用 288 次生成对比六款大模型
antialgorithm:让 Claude Code 在创意任务里先说出最普通的选择,再主动偏离它
MR Office 开源编辑器集:浏览器里跑文档、表格、演示、PDF、手写与代码编辑
NeonClipping:粘贴链接,约两分钟生成带字幕的竖屏切片
Blender AI 助手 mcp-for-blender-pro:把对话、场景操作与 MCP 服务装进 3D 工作区
Timon:把多个 AI 编码代理放进同一台工作站的编排器
最近更新
Nexus:让 ChatGPT 等网页 AI 助手安全连接本地文件与终端的 MCP 控制平面
Nexus 是一个通过 MCP 安全隧道把 ChatGPT、DeepSeek 等网页 AI 助手连接到本地文件、终端、Git 和桌面工具的本地控制平面,提供 332 个规范化工具、路径沙箱、命令风险过滤和令牌隔离等能力。
Ponytail:让 AI 编程代理学会“少写代码”的 Claude Code 技能
Ponytail 是一个让 AI 编程代理先读懂现有代码、再尽量少写新代码的开源技能,支持 Claude Code、Codex 等宿主,并提供代码审查、仓库审计和本地成本看板。
格知 AI · Gezhi Sheets:用一句话操作本地表格的开源 AI 助手,支持 GLM、Kimi、豆包、DeepSeek、Qwen
格知 AI · Gezhi Sheets 是一个运行在本机的 AI 表格工作台,支持 GLM、Kimi、豆包、DeepSeek、Qwen 五家模型。你选中数据、用中文说出需求,AI 生成可预览的结果,确认后再写入,并支持一次撤销。项目采用 MIT 许可证,在 GitHub 已获得 537 个 Star。
白板上的 AI 老师怎么教?开源项目 whiteboard-ai-tutor 用 288 次生成对比六款大模型
whiteboard-ai-tutor 是一个开源白板 AI 教学参考实现与多模型基准测试:模型输出 JSON 绘制指令,浏览器将其播放为手写动画,学生可中途打断。项目用同一提示词对比 Claude、Gemini、DeepSeek 六款模型,完成 288 次课程生成和 64 块盲审白板,并公开了排行榜、方法与局限。
antialgorithm:让 Claude Code 在创意任务里先说出最普通的选择,再主动偏离它
antialgorithm 是一个面向 Claude Code 等 Agent 的创意技能:它让模型先说出最普通的第一选择,再依据项目上下文主动偏离,并附带种子、动作记录、SVG 手工化与可读性检查脚本。
MR Office 开源编辑器集:浏览器里跑文档、表格、演示、PDF、手写与代码编辑
MR Office 开源了文档、表格、演示、PDF、手写和代码六款浏览器编辑器的源码,支持自有格式与部分通用格式,可自行构建和嵌入;读写 Microsoft Office 文件等完整能力则属于免费桌面应用。
NeonClipping:粘贴链接,约两分钟生成带字幕的竖屏切片
NeonClipping 是一个本地运行的视频切片工具,粘贴 YouTube/Twitch/Kick 链接或导入 MP4,即可生成带标题、钩子和字幕的 9:16 竖屏短片。项目用 Python 编写,支持快速与深度两种找亮点模式、11 种布局、多种字幕样式、直播切片和创作者自动切片,所有处理均在本机完成。
Blender AI 助手 mcp-for-blender-pro:把对话、场景操作与 MCP 服务装进 3D 工作区
mcp-for-blender-pro 是一个面向 Blender 的 AI 助手插件与内置 MCP 服务器,支持多模型接入、场景工具、可视化聊天和团队代理工作流,当前发布包面向 Windows x64 与 Blender 4.2+。
Timon:把多个 AI 编码代理放进同一台工作站的编排器
Timon 是一个本地运行的 AI 代理编排工作站,可把编码、审查、合并等任务分派给多个代理,并让它们在你已有的 CLI 订阅上工作。本文介绍其默认团队、功能、安装环境与适用场景。
Linger:跑在个人电脑上的开源本地 AI 助手,125B 模型装进 12GB 显卡
Linger 是一个运行在个人电脑上的开源本地 AI 助手,通过模型与运行框架协同设计,让 125B 模型在 12GB 显卡上运行。它提供本地模型自动选择、Wiki 记忆、主动式 Another Me、桌面与浏览器操作、Agent 团队和任务委派等功能,支持桌面应用和 Docker Compose 两种安装方式。



