Nexus:让网页版 AI 接手本地代码,先划清边界
- 2026-11-23 05:46:34
每日开源 · 2026-11-20
Nexus 是一个本地 MCP 服务,把网页版 AI 助手接到本机的文件、终端与 Git 上
网页版 AI 有个绕不过去的短板:它很会写代码,但看不见你电脑里的那个仓库。
Nexus 想补的就是这一段——用一个本地控制台,把 ChatGPT、DeepSeek、Cursor 这类 AI 客户端接到你的文件、终端、Git 和桌面工具上。431 星,2026 年 11 月 13 日建库,6 天走到 v1.3.2。
问题也很直接:你等于把本机的命令行交给了一个远端模型。所以这篇不谈它能干什么,只谈这条线上哪几道闸是真的。
它怎么把手伸到本地
结构是三层。
最上面是 Tauri 2 写的桌面控制台,负责授权、看状态、管工具。中间是一个 Fastify 服务,同时提供 MCP 与 REST 接口,默认监听 18080 端口,持久化用 SQLite 的 WAL 模式。最下面是 Runner 守护进程,通过 WebSocket 和上面走 JSON-RPC,真正执行命令、改文件、跑终端、开浏览器的是它。
接入方式是标准的:在控制台里授权一个项目目录,生成一个 lb_ 开头的 MCP 客户端令牌,然后把这段写进客户端配置。
{
"mcpServers": {
"nexus": {
"url": "http://127.0.0.1:18080/mcp",
"headers": {
"Authorization": "Bearer lb_your_token_here",
"MCP-Protocol-Version": "2024-11-05"
}
}
}
}
工具数量是 332 个,覆盖 24 个能力维度:文件系统、Git、命令执行、持久后台任务、LSP 代码智能、托管 worktree、浏览器自动化、Windows 电脑操作、视觉分析、文档处理、本地记忆与规则、Agent 编排、系统发现。
332 这个数字要两面看。 它是能力清单,也是攻击面清单——每一个能读文件的工具,都是模型可以调用的读取入口。
闸一:两个档位,先选窄的
授权项目时要定两个东西,这两个决定了风险的下限。
访问模式:只读,或读写。执行模式:禁用、只跑安全命令、或允许跑项目代码。
README 说这两个可以随时切换,不用重启。默认值是只读加只跑安全命令——这句话很关键,因为大多数人出问题不是因为默认值,是因为嫌麻烦把两个开关都推到最宽。
闸二:路径是真封死的
沙箱不是靠字符串前缀匹配,是用 fs.realpathSync.native 做物理规范化之后再判断是否在授权根目录内。这样 ../ 目录穿越和前缀混淆(把 /proj-evil 当成 /proj 的子目录)都过不去。
还有一条更少见的:它挡符号链接和 Windows NTFS 目录联接(junction)跳出项目边界。这两样是绕过路径检查最常用的手法——建一个链接指向项目外,字符串检查看起来还在里面,实际已经出去了。
闸三:命令按语法分类,不按字符串
如果只做关键词黑名单,rm -rf / 换个写法就绕过了。Nexus 的做法是解析命令的语法树,把命令分成三档:安全、谨慎、危险。危险档默认拦的是 rm -rf /、format、reg delete 这类。
同时用 Windows Job Objects 给子进程套硬约束:进程层级隔离、CPU 配额、内存上限。终端用 node-pty 起有状态的伪终端,带 ANSI 日志和退出码。
这套东西解决的是「模型手滑」,不是「模型被骗」。这两件事得分开:前者是概率,后者是安全。
闸四:凭证与敏感文件
两个令牌是分开的:MCP 客户端用 lb_,Runner 守护进程用 lbr_。都是 256 位熵,只存 SHA-256 哈希,比对用 crypto.timingSafeEqual 防时序侧信道。
敏感文件有屏蔽名单:.env*、*.pem、*.key、id_rsa、.git,以及云厂商凭证。
这几条加起来说明一件事:作者把「凭证不进模型上下文」当成了硬要求,不是可选项。
闸五:先记账,再动手
这是我觉得最值得抄的设计。
每个关键工具的执行,在产生副作用之前先写进一条预写日志(.wal)。主机重启或 Runner 崩了,下次启动能恢复未完成的操作、回到一致状态。请求带幂等 ID,网络抖动重连时不会把同一个操作执行两遍。
说白了:它假设自己会崩。 一个能替你 git commit、能删文件、能跑脚本的东西,本来就该这么设计。
边界之外,还有三件事得自己判断
第一,项目只有 6 天。 190 多个测试套件、1200 多个测试是作者自述的规模,不是第三方审计结论。6 天的代码在安全上只能算「设计到位」,不能算「验证到位」。
第二,Unrestricted / Full-Control Mode 是免责条款,不是功能。 README 里明确写:一旦你显式打开读写、项目代码执行、电脑操作 UI 自动化或完全控制模式,所有被执行的命令和修改的文件由你负责,建议先备份或用 Git 版本控制。这句话翻译过来就是:闸门是你自己拉开的。
第三,AGPL-3.0 有网络服务条款。 自己改了自己用没问题;一旦把改过的版本作为网络服务提供给别人用,就要按 AGPL 提供对应源码。商用前先读第 4 到 6 节和第 13 节,别只看「允许商用」四个字。
还有功能上的偏科
Windows 的电脑操作是原生实现,靠 WinRT 的 OCR 加 UI 自动化树定位控件,不靠像素坐标——这块是它做得最实的地方。相应地,其他平台在这条功能上就弱。
Blender 4.x/5.x 的程序化建模、Unity 编辑器内的 AI 副驾,是它的两个特色集成,也都是重活:装得上、配得对,才有意义。
适合谁
手上有一个正经项目、想让网页版模型帮着改代码但不愿意把整个仓库传到云端的人,这是目前少见的、把沙箱和记账写进架构里的方案。
不适合两类:一是只想在聊天框里问代码问题,那用不着把终端交出去;二是没有 Git、没有备份习惯的人——这套东西的正确用法是「随时能回滚」,你没这个前提,闸再多也救不了误操作。
判断:它的价值不在 332 个工具,在那五道闸和一条账。 默认值够窄,愿意一直用窄的,它可以进你的日常工作流;为了省事一路放宽,它就是把本地机器的钥匙递了出去。
项目地址:https://github.com/ysunyang4/Nexus 开源协议:AGPL-3.0 数据截至 2026-11-20:431 stars / 76 forks / TypeScript / v1.3.2
创作来源声明
本文由 AI 生成:选题、初稿、排版与封面均出自自动化流程。文中的项目信息、star 数、协议与版本取自 GitHub API 和项目官方仓库、官方文档,数据截至文末标注日期;官方口径的性能与效果描述已在正文中单独标注来源。文中不含作者实测数据,也未进行实际部署验证。
如有事实错误或版本过期,欢迎留言指出,我会核实后更正。