DeepSeek 原生 · 单一二进制 · MIT

The DeepSeek-Native
Agent Runtime

面向 Vibe Coding 的完整 Agent 运行时 —— 传输无关架构、缓存感知上下文折叠、 OS 级沙盒隔离、MCP 协议全实现。单一 Go 二进制,即装即用。

GitHub
nexuscode
nexuscode run "实现 main.go 的 HTTP 路由"
○ 分析代码结构... ○ 识别到 3 个未实现的路由 ○ 生成路由实现... ✓ 完成 — 新增 12 行,修改 2 个文件
nexuscode
NexusCode ready • 1M context Plan: Shift+Tab • YOLO: Ctrl+Y
帮我看看这个模块怎么优化

核心能力

围绕 Agent 工程四大矛盾设计的完整运行时 —— 稳定性、成本、安全、扩展性

缓存感知上下文折叠

系统 prompt 跨轮次字节级稳定,最大化 DeepSeek 自动前缀缓存命中率。snip / prune / compact 三级水位配合可配置阈值,大幅降低 Token 消耗,保障百万级窗口的长会话稳定性。

Prompt Cache 命中率 +80%

纵深防御安全体系

三层安全审查链路:纯函数权限策略 → 交互式审批门控(Ask/Auto/YOLO)→ OS 级沙盒隔离(Seatbelt / bubblewrap / AppContainer)。Guardian 子 Agent 实时评估风险,Evidence 系统要求每步提供执行证明。

OS 级隔离

MCP 协议完整实现

原生支持 Model Context Protocol(JSON-RPC 2.0)三种传输策略:stdio 子进程、Streamable HTTP、Legacy HTTP+SSE。插件工具运行时适配到统一 Tool 接口,Agent 无差别调度内置与外部工具。

协议原生

插件包 + Skills 编排

插件包从 GitHub 一键安装,打包 skills、hooks 与 MCP 配置。Skills 技能编排层让用户以 Markdown + frontmatter 编写可复用剧本,支持 inline/subagent 双执行模式与工具白名单隔离。

可扩展

三种协作模式

Plan 模式(只读调研 → 产出计划 → 执行)、Goal 模式(todo 驱动 + 执行证据 + Readiness Audit)、Token Economy 模式(按需加载能力避免浪费 Token)。各模式可配合 Ask/Auto/YOLO 审批。

Planner + Executor

单一 Go 二进制

Go 编译为单一原生二进制,零运行时依赖。支持 TUI(Bubble Tea)与 HTTP/SSE 服务两种前端共享同一后端核心。npm i -g nexuscode 自动适配平台架构,即装即用。

零依赖
1M
上下文窗口
25+
内置工具
3
OS 沙盒平台
3
传输协议

架构总览

传输无关的 Controller 驱动多前端,Agent 引擎编排工具循环,安全与基础设施兜底

NexusCode 采用传输无关的分层架构,核心层通过命令/事件流接口与前端解耦:

  • 前端层 — Terminal TUI(Bubble Tea)与 HTTP/SSE 服务,只做命令下发和事件渲染,不包含业务逻辑
  • Controller — 传输无关的会话驱动层,统一处理 Submit、Cancel、Approve、Rewind 等操作
  • 核心运行时 — Agent 工具循环(Harness Loop)、MCP 插件适配器、分层记忆系统(BM25 + Memory Compiler v5)
  • 基础设施 — Tool Registry(25+ 内置工具编译期自注册)、Permission Policy 权限策略、OS 级沙盒隔离(Seatbelt / bubblewrap / AppContainer)、Checkpoint 快照安全网

各层通过接口契约组合,运行时自注册,新增前端无需改动核心逻辑,每层职责独立可测。

快速上手

两种安装方式,从零到运行只需一条命令

npm 安装(推荐)

npm i -g nexuscode # 自动检测平台,拉取预编译二进制
nexuscode # 启动交互式会话

从源码构建

# 需 Go 1.25+ git clone https://github.com/ZoneYottaZenith/DeepSeek-NexusCode cd DeepSeek-NexusCode make build
# 输出到 bin/nexuscode ./bin/nexuscode

快速开始

1
nexuscode setup
交互式配置向导
2
export DEEPSEEK_API_KEY=sk-...
设置 API Key
3
nexuscode
启动交互式会话
4
nexuscode run "重构 main.go 的错误处理"
单次任务执行
5
echo "解释这段代码" | nexuscode run
管道模式