一句话介绍

Nexum Code 是一个本地优先的 AI Agent 系统。你可以用中文或英文直接下达目标，它会读取项目、编辑文件、运行命令、调用工具、拆分任务、记录记忆，并在需要时通过审批面板保护你的机器。它也可以通过后端服务和 Node SDK 接入 Web 产品，构建网页端智能体、工作台、自动化平台或企业内部 Agent 系统。

它适合这些场景：

• 写代码、改项目、跑测试、整理仓库
• 查资料、读文档、写报告、做研究
• 让多个子 Agent 并行处理复杂任务
• 把常用工作流沉淀成 Skill
• 接到自己的后端，做 Web 端智能体系统
• 通过微信、飞书、钉钉等聊天入口远程控制本地 Agent
• 解析 PDF、Word、Excel、图片等文档并提取结构化信息
• 连接数据库、浏览器、内部 API 等外部工具（MCP）

核心优势

快速开始

环境要求

• Node.js >= 22.0.0
• Git
• 一个可用的模型服务，例如 DeepSeek、OpenAI、Anthropic、通义千问、硅基流动或任何 OpenAI-compatible API

npm 安装

npm install -g nexum-code

安装完成后，启动 Nexum：

nexum

macOS / Linux 一键安装

curl -fsSL https://raw.githubusercontent.com/Hsssliu/nexum-code/main/install.sh | bash

Windows PowerShell 一键安装

irm https://raw.githubusercontent.com/Hsssliu/nexum-code/main/install.ps1 | iex

首次启动时，如果还没有配置模型，Nexum Code 会进入交互式配置向导。你也可以随时输入：

/config

配置完成后，用下面的命令切换模型：

/model

你可以怎么用

帮我理解这个项目的架构，并指出最重要的入口文件

修复 pnpm test 里的失败用例，改完后再跑一遍验证

/goal 在不破坏现有 API 的前提下，把这套工具调用逻辑整理清楚，并补上必要测试

/memory 记住：这个项目优先使用 pnpm，不要引入不必要的新依赖

/wolfpack 帮我并行检查 README、安装脚本、CLI 参数和服务端 API 是否一致

/document 解析这份 PDF 合同，提取关键条款和金额信息

/mcp 连接本地数据库，帮我查询最近一周的订单数据

能力地图

| 能力 | Nexum Code 做什么 | |---|---| | 对话式执行 | 用自然语言描述任务，自动读文件、改代码、跑命令 | | 审批面板 | 修改文件和执行命令前展示审批，降低误操作风险 | | 权限策略 | 支持默认模式、计划模式、自动模式、YOLO 模式等 | | Goal 循环 | 目标驱动的多轮执行，支持预算和完成度裁决 | | 多 Agent | 子 Agent 并行处理探索、编码、验证、写作等任务 | | 记忆系统 | 跨会话沉淀偏好、项目经验、问题记录和工作约定 | | MCP 扩展 | 连接外部工具、数据库、浏览器、内部 API 等能力 | | Skill 系统 | 把常用流程封装成可复用技能 | | 插件系统 | 安装、扫描、注册插件，支持 GitHub 解析和源码加载 | | 文档智能 | 解析 PDF、Word、Excel、CSV、图片，OCR 识别，结构化提取 | | 知识库 | 管理知识条目，支持检索和复用 | | LSP 支持 | 语言服务器协议客户端，代码编辑操作注册 | | 后台任务 | 支持长任务、后台命令、Cron 定时任务和任务输出读取 | | 会话管理 | 创建、恢复、分叉、导出（ZIP/Manifest）、历史记录和撤销 | | 上下文压缩 | 全量/微压缩策略，自动管理长会话上下文 | | 用量追踪 | Token 用量和成本统计 | | 记录回放 | 执行记录持久化、迁移和回放 | | 后端 API | 通过服务端接口创建会话、发送提示、控制 Agent 和读取状态 | | Node SDK | 在自己的 Node 后端里集成 Nexum Agent 能力 | | Web 智能体 | 可作为网页端 Agent 工作台、企业自动化系统或内部 Copilot 底座 | | 远程聊天 | 通过 cc-connect 接入微信、飞书、钉钉、Slack 等平台 | | 自动更新 | 多源更新（npm/GitHub/CDN）、版本选择、守护进程检查 |

系统架构

这个仓库是一个 TypeScript monorepo，核心模块大致如下：

aiflowy-agent/
  apps/
    nexum-code/          # 终端入口与 TUI
    nexum-agent-server/  # Agent 服务入口（HTTP + SSE）
  packages/
    agent-core/          # Agent 循环、工具、权限、会话、MCP、LSP、Goal、记忆、RPC
    node-sdk/            # Node SDK 与 RPC 客户端
    nexum-server/        # HTTP API 与会话控制
    memory/              # 长期记忆、检索、整合、向量嵌入
    ltod/                # 模型与工具调用抽象
    jian/                # 本地运行时能力封装
    config/              # 共享配置与身份信息
    document-intelligence/  # 文档解析、OCR、提取、流水线
    knowledge/           # 知识库管理
    migration-legacy/    # 旧版数据迁移

关键设计思路：

• agent-core 负责 Agent 的大脑，包括工具注册、权限评估、执行循环、子 Agent、会话状态、MCP 连接、LSP 客户端、Goal 管理和记忆接口。
• nexum-code 负责终端用户体验，包括命令、审批面板、消息渲染、交互状态、自动更新和远程连接守护。
• nexum-server 和 node-sdk 让 Nexum 不只存在于终端，也能被后端服务、Web 应用、桌面端或其他客户端驱动。
• memory 独立成包，支持 SQLite、FTS5、向量检索和记忆整合，避免记忆能力被某一次会话绑定。
• document-intelligence 提供完整的文档处理流水线：类型检测、多格式解析、OCR、规则/大模型提取、验证和评估。
• knowledge 管理知识条目，支持跨项目复用。

Web 端智能体底座

Nexum Code 不是只能在终端里跑。它的核心能力已经拆成可复用的服务端和 SDK 层，适合接入自己的产品后端。

你可以用它构建：

• Web 端 AI 编程助手
• 企业内部 Agent 工作台
• 自动化任务执行平台
• 多 Agent 协作系统
• 带记忆、权限和会话恢复的私有 Copilot
• 文档智能处理平台（PDF/Word/Excel 解析、OCR、信息提取）
• 持久 Python RLM 工作环境，支持递归子 Agent 与可配置深度
• 办公/文档自动化 Worker，支持格式转换、批处理和文件整理

后端可以围绕这些能力组织业务：

| 能力 | 适合做成什么产品功能 | |---|---| | Session API | 创建会话、恢复会话、分叉会话、导出会话 | | Agent API | 发送任务、取消任务、切换模型、调整思考和权限模式 | | Subagent Host | 在 Web 端展示多个子 Agent 的并行执行状态 | | Permission System | 做企业级审批、敏感操作拦截和审计记录 | | Memory Store | 做用户偏好、项目知识库和跨会话上下文 | | MCP / Skill | 给 Web 产品接入数据库、浏览器、内部系统和自定义流程 | | Document Intelligence | 文档上传、解析、OCR、结构化提取和批量处理 | | Knowledge Base | 企业知识条目管理和检索 |

这意味着 Nexum Code 可以从"一个本地工具"升级成"你的 Agent 产品底座"：前端负责交互，后端负责业务权限和数据，Nexum 负责智能体执行、工具调度、记忆、多 Agent 编排和文档处理。

常用命令

| 命令 | 说明 | |---|---| | /config | 配置模型服务 | | /model | 切换或管理模型 | | /memory | 打开记忆管理 | | /dream | 整理重复或过期记忆 | | /goal | 开启目标循环 | | /wolfpack | 开启多 Agent 协作 | | /cc-connect | 配置聊天平台远程控制 | | /mode | 查看或切换权限模式 | | /document | 文档解析与提取 | | /knowledge | 知识库管理 | | /mcp | MCP 连接与工具管理 | | /skill | Skill 技能管理 | | /plugin | 插件管理 | | /export | 导出会话 | | /compact | 压缩会话上下文 | | /update | 检查并更新 Nexum Code | | /agent | Agent 相关操作 | | /session | 会话管理 | | /experimental-flags | 实验性功能开关 |

开发仓库时常用：

pnpm install
pnpm run dev:cli
pnpm run typecheck
pnpm run lint
pnpm run test
pnpm run build

远程控制

Nexum Code 可以通过 cc-connect 接入聊天平台。配置后，即使终端不在眼前，也能在聊天窗口里创建会话、发送任务、上传文件和切换模式。

npm install -g cc-connect

在 Nexum Code 中启动配置：

/cc-connect

常用远程指令：

| 指令 | 用途 | |---|---| | /new | 创建新会话 | | /bind setup | 开启文件传送，支持图片、PDF 等 | | /mode | 查看可用模式 | | /mode yolo | 自动批准所有工具调用 | | /mode default | 每次工具调用前询问 |

部署指南

Docker 部署（服务端）

apps/nexum-agent-server 是一个独立的 HTTP + SSE 服务端，支持容器化部署：

# 复制环境变量配置
cp .env.example .env
# 编辑 .env 设置 NEXUM_PORT 和 TOOL_GATEWAY_URL

# 启动服务
docker-compose up -d

docker-compose.yml 已配置健康检查、持久化卷和自动重启。

环境变量

| 变量 | 说明 | 默认值 | |---|---|---| | NEXUM_PORT | 服务端监听端口 | 3000 | | NEXUM_HOST | 监听地址 | 0.0.0.0 | | NEXUM_HOME | 持久化数据目录 | /data/nexum | | TOOL_GATEWAY_URL | AIFlowy 工具执行回调地址 | 空 | | NEXUM_API_KEY | API 密钥 | 空 | | NEXUM_MODEL | 默认模型 | 空 | | NEXUM_BASE_URL | 服务端点 | 空 | | NEXUM_MAX_TURNS | 最大轮次 | 空 | | NEXUM_TEMPERATURE | 温度参数 | 空 | | NEXUM_WORKSPACE | 工作空间 | 空 | | NEXUM_LOG_LEVEL | 日志级别 | 空 | | NEXUM_DISABLE_ANALYTICS | 禁用分析 | 空 | | NEXUM_CACHE_DIR | 缓存目录 | 空 | | NEXUM_CONFIG_DIR | 配置目录 | 空 |

为什么做 Nexum Code

我想要的不是一个只会补全代码的工具，而是一个能长期陪我处理真实工作流的本地 Agent：

• 它要能记住项目里的约定，而不是每次从零开始。
• 它要能拆任务、分工、验证，而不是只会单线程聊天。
• 它要能接入我已有的工具和聊天入口，而不是把我锁在一个界面里。
• 它要能处理文档、提取信息，而不是只能读代码。
• 它要尊重本地机器的安全边界，而不是为了方便牺牲控制权。

所以 Nexum Code 选择了 TypeScript monorepo、本地优先、权限策略、长期记忆、多 Agent、MCP 扩展、文档智能和可扩展工具系统这条路线。它不是功能堆叠，而是把高频 Agent 工作流收敛成一个稳定的底座。

项目链接

• npm：https://www.npmjs.com/package/nexum-code
• 许可证：MIT