nexum-code 0.7.20 → 0.12.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +414 -118
  3. package/dist/{app-STmkYeC7.mjs → app-COTk2IwE.mjs} +20347 -50542
  4. package/dist/assets/fsevents-9Sj9I9VP.node +0 -0
  5. package/dist/base64-js-DzVmk6Nb.mjs +95 -0
  6. package/dist/{rolldown-runtime-CDCXy-ZS.mjs → chunk-D90kvbyJ.mjs} +4 -10
  7. package/dist/{dist-Dh_F9syl.mjs → dist-AcjRoBBn.mjs} +1 -1
  8. package/dist/{from-D_EZ04z8.mjs → from-BMeHuTTE.mjs} +1 -1
  9. package/dist/main.mjs +1 -1
  10. package/dist/markit-DG5XsAGz.mjs +56336 -0
  11. package/dist/{multipart-parser-uEw3PR6T.mjs → multipart-parser-_uHCprmc.mjs} +2 -2
  12. package/dist/public/assets/github-dark-DHJKELXO.js +2 -0
  13. package/dist/public/assets/github-dark-DHJKELXO.js.map +1 -0
  14. package/dist/public/assets/github-light-DAi9KRSo.js +2 -0
  15. package/dist/public/assets/github-light-DAi9KRSo.js.map +1 -0
  16. package/dist/public/assets/index-Dk4bewva.js +90 -0
  17. package/dist/public/assets/index-Dk4bewva.js.map +1 -0
  18. package/dist/public/assets/index-nfSMt8uX.css +1 -0
  19. package/dist/public/assets/wasm-CG6Dc4jp.js +2 -0
  20. package/dist/public/assets/wasm-CG6Dc4jp.js.map +1 -0
  21. package/dist/public/icon.ico +0 -0
  22. package/dist/public/index.html +15 -0
  23. package/dist/{dist-BaQOFk-J.mjs → src-BH9W5k24.mjs} +114 -16
  24. package/dist/{dist-BRIvo0y7.mjs → src-DCp4eCi5.mjs} +1 -1
  25. package/dist/{src-BAMmHkmC.mjs → src-DlpH2wBe.mjs} +19 -19
  26. package/dist/{aiflowy-bot-sync-DhoRtQfn.mjs → text-input-dialog-B5imDNC1.mjs} +2 -2
  27. package/dist/text-input-dialog-B_4fy5St.mjs +2345 -0
  28. package/icon.ico +0 -0
  29. package/package.json +22 -26
  30. package/dist/aiflowy-bot-sync-C0WrAYbG.mjs +0 -219
  31. package/scripts/postinstall/migrate.mjs +0 -351
  32. package/scripts/postinstall/reach.mjs +0 -457
  33. package/scripts/postinstall/shortcut.mjs +0 -74
  34. package/scripts/postinstall/ui.mjs +0 -458
  35. package/scripts/postinstall.mjs +0 -278
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 lwl
3
+ Copyright (c) 2026 尖叫Tod
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -1,118 +1,414 @@
1
- # nexum-code
2
-
3
- `nexum-code` 是个人 Agent 助手的终端客户端,提供 `nexum` 命令和终端交互界面。它适合本地开发、自动化任务执行、文档解析、项目系统接入前的本地调试,以及需要终端原生体验的 Agent 工作流。
4
-
5
- ## 目录
6
-
7
- - [安装与启动](#安装与启动)
8
- - [运行要求](#运行要求)
9
- - [常用命令](#常用命令)
10
- - [文档解析](#文档解析)
11
- - [本地开发](#本地开发)
12
- - [职责边界](#职责边界)
13
- - [许可证](#许可证)
14
-
15
- ## 安装与启动
16
-
17
- 全局安装已发布包:
18
-
19
- ```bash
20
- npm install -g nexum-code
21
- nexum
22
- ```
23
-
24
- 在本仓库内开发运行:
25
-
26
- ```bash
27
- pnpm install
28
- pnpm --filter nexum-code run dev:cli-only
29
- ```
30
-
31
- ## 运行要求
32
-
33
- - Node.js >= 22.19.0
34
- - pnpm 仅在本仓库开发时需要
35
- - 扫描件 OCR 依赖 Tesseract OCR
36
-
37
- Windows 可手动安装 OCR:
38
-
39
- ```powershell
40
- winget install UB-Mannheim.TesseractOCR
41
- ```
42
-
43
- 常用 OCR 环境变量:
44
-
45
- ```powershell
46
- $env:NEXUM_TESSERACT_PATH="C:\Program Files\Tesseract-OCR\tesseract.exe"
47
- $env:NEXUM_OCR_LANGUAGE="chi_sim+eng"
48
- $env:NEXUM_TESSDATA_DIR="$env:LOCALAPPDATA\Nexum\tessdata"
49
- ```
50
-
51
- ## 常用命令
52
-
53
- ```text
54
- /config 配置模型服务
55
- /model 切换模型
56
- /mode 切换权限模式
57
- /goal 开启目标驱动执行
58
- /memory 管理长期记忆
59
- /doc 解析 PDF、Word、Excel、CSV、图片与扫描 PDF
60
- /agent 查看或管理项目系统中的智能体配置
61
- /skill 管理已安装 Skill 与可安装 Skill 包
62
- /mcp 管理 MCP 服务
63
- /update 手动更新客户端
64
- ```
65
-
66
- ## 文档解析
67
-
68
- 解析单个文件:
69
-
70
- ```text
71
- /doc "E:\资料\个人报告.pdf" --format markdown
72
- ```
73
-
74
- 递归解析文件夹:
75
-
76
- ```text
77
- /doc "E:\资料\知识库文档" --format markdown
78
- ```
79
-
80
- 只解析当前文件夹,不进入子目录:
81
-
82
- ```text
83
- /doc "E:\资料\知识库文档" --format markdown --no-recursive
84
- ```
85
-
86
- 支持导出格式:
87
-
88
- ```text
89
- json | markdown | excel | csv | review-json | review-markdown
90
- ```
91
-
92
- ## 本地开发
93
-
94
- ```bash
95
- pnpm install
96
- pnpm --filter nexum-code run dev:cli-only
97
- pnpm --filter nexum-code run build
98
- pnpm --filter nexum-code run test
99
- pnpm --filter nexum-code run typecheck
100
- ```
101
-
102
- ## 职责边界
103
-
104
- `nexum-code` 只负责客户端体验与命令入口。会话执行、文档解析、服务端适配、模型调用等核心逻辑应通过 `packages/*` 中的稳定 API 调用,不应直接塞入终端界面层。
105
-
106
- 终端客户端调用链:
107
-
108
- ```text
109
- src/main.ts
110
- -> src/cli/commands.ts
111
- -> src/cli/run-shell.ts
112
- -> @nexum-cli/nexum-code-sdk
113
- -> src/tui/nexum-tui.ts
114
- ```
115
-
116
- ## 许可证
117
-
118
- MIT
1
+ <p align="center">
2
+ <img width="108" height="108" alt="Nexum Code" src="https://github.com/user-attachments/assets/26b707fa-1fd7-4dda-8484-e8c6b0bd7523" />
3
+ </p>
4
+
5
+ <h1 align="center">Nexum Code</h1>
6
+
7
+ <p align="center">
8
+ <strong>一个真正为中文工作流设计的本地 AI Agent 工作台</strong>
9
+ </p>
10
+
11
+ <p align="center">
12
+ 不只是会写代码的终端助手。Nexum Code 把目标循环、长期记忆、多 Agent 协同、MCP 扩展、文档智能、后端 API 和远程聊天控制放进同一个本地运行的系统里,让 AI 可以稳定地替你执行复杂任务,也可以作为 Web 端智能体系统的底座。
13
+ </p>
14
+
15
+ <p align="center">
16
+ <a href="https://www.npmjs.com/package/nexum-code"><img src="https://img.shields.io/npm/v/nexum-code?style=for-the-badge&logo=npm&logoColor=white&color=111827" alt="npm version"></a>
17
+ <a href="https://www.npmjs.com/package/nexum-code"><img src="https://img.shields.io/npm/dm/nexum-code?style=for-the-badge&logo=npm&logoColor=white&color=2563eb" alt="npm downloads"></a>
18
+ <a href="https://github.com/Hsssliu/nexum-code/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Hsssliu/nexum-code?style=for-the-badge&color=0f766e" alt="license"></a>
19
+ <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-%3E%3D22-16a34a?style=for-the-badge&logo=node.js&logoColor=white" alt="node version"></a>
20
+ </p>
21
+
22
+ <p align="center">
23
+ <a href="">官网</a>
24
+ ·
25
+ <a href="#快速开始">快速开始</a>
26
+ ·
27
+ <a href="#核心优势">核心优势</a>
28
+ ·
29
+ <a href="#能力地图">能力地图</a>
30
+ ·
31
+ <a href="#系统架构">系统架构</a>
32
+ ·
33
+ <a href="#web-端智能体底座">Web 智能体</a>
34
+ ·
35
+ <a href="#远程控制">远程控制</a>
36
+ ·
37
+ <a href="#部署指南">部署</a>
38
+ </p>
39
+
40
+ ---
41
+
42
+ ## 一句话介绍
43
+
44
+ Nexum Code 是一个本地优先的 AI Agent 系统。你可以用中文或英文直接下达目标,它会读取项目、编辑文件、运行命令、调用工具、拆分任务、记录记忆,并在需要时通过审批面板保护你的机器。它也可以通过后端服务和 Node SDK 接入 Web 产品,构建网页端智能体、工作台、自动化平台或企业内部 Agent 系统。
45
+
46
+ 它适合这些场景:
47
+
48
+ - 写代码、改项目、跑测试、整理仓库
49
+ - 查资料、读文档、写报告、做研究
50
+ - 让多个子 Agent 并行处理复杂任务
51
+ - 把常用工作流沉淀成 Skill
52
+ - 接到自己的后端,做 Web 端智能体系统
53
+ - 通过微信、飞书、钉钉等聊天入口远程控制本地 Agent
54
+ - 解析 PDF、Word、Excel、图片等文档并提取结构化信息
55
+ - 连接数据库、浏览器、内部 API 等外部工具(MCP)
56
+
57
+ ---
58
+
59
+ ## 核心优势
60
+
61
+ <table>
62
+ <tr>
63
+ <td width="50%">
64
+ <h3>目标驱动,不是空转循环</h3>
65
+ <p>Nexum Code 内置 Goal 系统。你给出目标后,它会围绕目标持续推进,并由独立裁判判断是否完成,支持轮次、Token 和时间预算。</p>
66
+ </td>
67
+ <td width="50%">
68
+ <h3>多 Agent 并行协作</h3>
69
+ <p>Wolfpack 模式可以把复杂任务拆给多个子 Agent 并行执行。探索、编码、规划、验证、写作和办公自动化可以分工处理,适合多文件、多步骤的大任务。</p>
70
+ </td>
71
+ </tr>
72
+ <tr>
73
+ <td width="50%">
74
+ <h3>长期记忆,不靠聊天记录硬撑</h3>
75
+ <p>记忆系统支持 SQLite、FTS5 全文检索、Tag 归类和向量检索。它能跨会话保留偏好、约定、项目经验和反复出现的痛点。</p>
76
+ </td>
77
+ <td width="50%">
78
+ <h3>本地运行,权限可控</h3>
79
+ <p>文件写入、命令执行、敏感路径访问都会经过权限策略。默认安全,必要时可切换模式,让效率和控制感都在线。</p>
80
+ </td>
81
+ </tr>
82
+ <tr>
83
+ <td width="50%">
84
+ <h3>MCP / Skill / 插件扩展</h3>
85
+ <p>你可以连接数据库、浏览器、API、代码工具,也可以把自己的流程封装成 Skill。Nexum Code 更像一个可扩展的本地 Agent 底座。</p>
86
+ </td>
87
+ <td width="50%">
88
+ <h3>可接后端和 Web 端</h3>
89
+ <p>内置服务端 API 和 Node SDK,可以把会话、子 Agent、提示、取消、模型切换、权限控制等能力接入自己的 Web 应用。</p>
90
+ </td>
91
+ </tr>
92
+ <tr>
93
+ <td width="50%">
94
+ <h3>中文体验优先</h3>
95
+ <p>从配置、审批、提示到常用命令都围绕中文用户设计。不是把英文工具翻译一遍,而是从使用习惯上降低门槛。</p>
96
+ </td>
97
+ <td width="50%">
98
+ <h3>终端、服务端、远程入口统一</h3>
99
+ <p>同一套 Agent Core 可以跑在 TUI、后端服务和远程聊天入口后面。你可以先自己用,再把它产品化给团队使用。</p>
100
+ </td>
101
+ </tr>
102
+ <tr>
103
+ <td width="50%">
104
+ <h3>🐍 RLM Mode</h3>
105
+ <p><strong>A persistent Python workspace for long-running tasks</strong> — state survives across calls, kernels self-heal from crashes, and <code>rlm()</code> spawns unlimited recursive subagents (parent → child → grandchild…). Opt-in via <code>/rlm</code>, zero impact when off.</p>
106
+ </td>
107
+ <td width="50%">
108
+ <h3>🧩 /rlm-max-depth</h3>
109
+ <p><strong>Configurable recursion cap</strong> — unlimited by default; set a positive integer to bound the recursion chain, <code>0</code> for unlimited again.</p>
110
+ </td>
111
+ </tr>
112
+ </table>
113
+
114
+ ---
115
+
116
+ ## 快速开始
117
+
118
+ ### 环境要求
119
+
120
+ - Node.js >= 22.0.0
121
+ - Git
122
+ - 一个可用的模型服务,例如 DeepSeek、OpenAI、Anthropic、通义千问、硅基流动或任何 OpenAI-compatible API
123
+
124
+ ### npm 安装
125
+
126
+ ```bash
127
+ npm install -g nexum-code
128
+ ```
129
+
130
+ 安装完成后,启动 Nexum:
131
+
132
+ ```bash
133
+ nexum
134
+ ```
135
+
136
+ ### macOS / Linux 一键安装
137
+
138
+ ```bash
139
+ curl -fsSL https://raw.githubusercontent.com/Hsssliu/nexum-code/main/install.sh | bash
140
+ ```
141
+
142
+ ### Windows PowerShell 一键安装
143
+
144
+ ```powershell
145
+ irm https://raw.githubusercontent.com/Hsssliu/nexum-code/main/install.ps1 | iex
146
+ ```
147
+
148
+ 首次启动时,如果还没有配置模型,Nexum Code 会进入交互式配置向导。你也可以随时输入:
149
+
150
+ ```text
151
+ /config
152
+ ```
153
+
154
+ 配置完成后,用下面的命令切换模型:
155
+
156
+ ```text
157
+ /model
158
+ ```
159
+
160
+ ---
161
+
162
+ ## 你可以怎么用
163
+
164
+ ```text
165
+ 帮我理解这个项目的架构,并指出最重要的入口文件
166
+ ```
167
+
168
+ ```text
169
+ 修复 pnpm test 里的失败用例,改完后再跑一遍验证
170
+ ```
171
+
172
+ ```text
173
+ /goal 在不破坏现有 API 的前提下,把这套工具调用逻辑整理清楚,并补上必要测试
174
+ ```
175
+
176
+ ```text
177
+ /memory 记住:这个项目优先使用 pnpm,不要引入不必要的新依赖
178
+ ```
179
+
180
+ ```text
181
+ /wolfpack 帮我并行检查 README、安装脚本、CLI 参数和服务端 API 是否一致
182
+ ```
183
+
184
+ ```text
185
+ /document 解析这份 PDF 合同,提取关键条款和金额信息
186
+ ```
187
+
188
+ ```text
189
+ /mcp 连接本地数据库,帮我查询最近一周的订单数据
190
+ ```
191
+
192
+ ---
193
+
194
+ ## 能力地图
195
+
196
+ | 能力 | Nexum Code 做什么 |
197
+ |---|---|
198
+ | 对话式执行 | 用自然语言描述任务,自动读文件、改代码、跑命令 |
199
+ | 审批面板 | 修改文件和执行命令前展示审批,降低误操作风险 |
200
+ | 权限策略 | 支持默认模式、计划模式、自动模式、YOLO 模式等 |
201
+ | Goal 循环 | 目标驱动的多轮执行,支持预算和完成度裁决 |
202
+ | 多 Agent | 子 Agent 并行处理探索、编码、验证、写作等任务 |
203
+ | 记忆系统 | 跨会话沉淀偏好、项目经验、问题记录和工作约定 |
204
+ | MCP 扩展 | 连接外部工具、数据库、浏览器、内部 API 等能力 |
205
+ | Skill 系统 | 把常用流程封装成可复用技能 |
206
+ | 插件系统 | 安装、扫描、注册插件,支持 GitHub 解析和源码加载 |
207
+ | 文档智能 | 解析 PDF、Word、Excel、CSV、图片,OCR 识别,结构化提取 |
208
+ | 知识库 | 管理知识条目,支持检索和复用 |
209
+ | LSP 支持 | 语言服务器协议客户端,代码编辑操作注册 |
210
+ | 后台任务 | 支持长任务、后台命令、Cron 定时任务和任务输出读取 |
211
+ | 会话管理 | 创建、恢复、分叉、导出(ZIP/Manifest)、历史记录和撤销 |
212
+ | 上下文压缩 | 全量/微压缩策略,自动管理长会话上下文 |
213
+ | 用量追踪 | Token 用量和成本统计 |
214
+ | 记录回放 | 执行记录持久化、迁移和回放 |
215
+ | 后端 API | 通过服务端接口创建会话、发送提示、控制 Agent 和读取状态 |
216
+ | Node SDK | 在自己的 Node 后端里集成 Nexum Agent 能力 |
217
+ | Web 智能体 | 可作为网页端 Agent 工作台、企业自动化系统或内部 Copilot 底座 |
218
+ | 远程聊天 | 通过 cc-connect 接入微信、飞书、钉钉、Slack 等平台 |
219
+ | 自动更新 | 多源更新(npm/GitHub/CDN)、版本选择、守护进程检查 |
220
+
221
+ ---
222
+
223
+ ## 系统架构
224
+
225
+ 这个仓库是一个 TypeScript monorepo,核心模块大致如下:
226
+
227
+ ```text
228
+ aiflowy-agent/
229
+ apps/
230
+ nexum-code/ # 终端入口与 TUI
231
+ nexum-agent-server/ # Agent 服务入口(HTTP + SSE)
232
+ packages/
233
+ agent-core/ # Agent 循环、工具、权限、会话、MCP、LSP、Goal、记忆、RPC
234
+ node-sdk/ # Node SDK 与 RPC 客户端
235
+ nexum-server/ # HTTP API 与会话控制
236
+ memory/ # 长期记忆、检索、整合、向量嵌入
237
+ ltod/ # 模型与工具调用抽象
238
+ jian/ # 本地运行时能力封装
239
+ config/ # 共享配置与身份信息
240
+ document-intelligence/ # 文档解析、OCR、提取、流水线
241
+ knowledge/ # 知识库管理
242
+ migration-legacy/ # 旧版数据迁移
243
+ ```
244
+
245
+ 关键设计思路:
246
+
247
+ - `agent-core` 负责 Agent 的大脑,包括工具注册、权限评估、执行循环、子 Agent、会话状态、MCP 连接、LSP 客户端、Goal 管理和记忆接口。
248
+ - `nexum-code` 负责终端用户体验,包括命令、审批面板、消息渲染、交互状态、自动更新和远程连接守护。
249
+ - `nexum-server` 和 `node-sdk` 让 Nexum 不只存在于终端,也能被后端服务、Web 应用、桌面端或其他客户端驱动。
250
+ - `memory` 独立成包,支持 SQLite、FTS5、向量检索和记忆整合,避免记忆能力被某一次会话绑定。
251
+ - `document-intelligence` 提供完整的文档处理流水线:类型检测、多格式解析、OCR、规则/大模型提取、验证和评估。
252
+ - `knowledge` 管理知识条目,支持跨项目复用。
253
+
254
+ ---
255
+
256
+ ## Web 端智能体底座
257
+
258
+ Nexum Code 不是只能在终端里跑。它的核心能力已经拆成可复用的服务端和 SDK 层,适合接入自己的产品后端。
259
+
260
+ 你可以用它构建:
261
+
262
+ - Web 端 AI 编程助手
263
+ - 企业内部 Agent 工作台
264
+ - 自动化任务执行平台
265
+ - 多 Agent 协作系统
266
+ - 带记忆、权限和会话恢复的私有 Copilot
267
+ - 文档智能处理平台(PDF/Word/Excel 解析、OCR、信息提取)
268
+ - 持久 Python RLM 工作环境,支持递归子 Agent 与可配置深度
269
+ - 办公/文档自动化 Worker,支持格式转换、批处理和文件整理
270
+
271
+ 后端可以围绕这些能力组织业务:
272
+
273
+ | 能力 | 适合做成什么产品功能 |
274
+ |---|---|
275
+ | Session API | 创建会话、恢复会话、分叉会话、导出会话 |
276
+ | Agent API | 发送任务、取消任务、切换模型、调整思考和权限模式 |
277
+ | Subagent Host | 在 Web 端展示多个子 Agent 的并行执行状态 |
278
+ | Permission System | 做企业级审批、敏感操作拦截和审计记录 |
279
+ | Memory Store | 做用户偏好、项目知识库和跨会话上下文 |
280
+ | MCP / Skill | 给 Web 产品接入数据库、浏览器、内部系统和自定义流程 |
281
+ | Document Intelligence | 文档上传、解析、OCR、结构化提取和批量处理 |
282
+ | Knowledge Base | 企业知识条目管理和检索 |
283
+
284
+ 这意味着 Nexum Code 可以从"一个本地工具"升级成"你的 Agent 产品底座":前端负责交互,后端负责业务权限和数据,Nexum 负责智能体执行、工具调度、记忆、多 Agent 编排和文档处理。
285
+
286
+ ---
287
+
288
+ ## 常用命令
289
+
290
+ | 命令 | 说明 |
291
+ |---|---|
292
+ | `/config` | 配置模型服务 |
293
+ | `/model` | 切换或管理模型 |
294
+ | `/memory` | 打开记忆管理 |
295
+ | `/dream` | 整理重复或过期记忆 |
296
+ | `/goal` | 开启目标循环 |
297
+ | `/wolfpack` | 开启多 Agent 协作 |
298
+ | `/cc-connect` | 配置聊天平台远程控制 |
299
+ | `/mode` | 查看或切换权限模式 |
300
+ | `/document` | 文档解析与提取 |
301
+ | `/knowledge` | 知识库管理 |
302
+ | `/mcp` | MCP 连接与工具管理 |
303
+ | `/skill` | Skill 技能管理 |
304
+ | `/plugin` | 插件管理 |
305
+ | `/export` | 导出会话 |
306
+ | `/compact` | 压缩会话上下文 |
307
+ | `/update` | 检查并更新 Nexum Code |
308
+ | `/agent` | Agent 相关操作 |
309
+ | `/session` | 会话管理 |
310
+ | `/experimental-flags` | 实验性功能开关 |
311
+
312
+ 开发仓库时常用:
313
+
314
+ ```bash
315
+ pnpm install
316
+ pnpm run dev:cli
317
+ pnpm run typecheck
318
+ pnpm run lint
319
+ pnpm run test
320
+ pnpm run build
321
+ ```
322
+
323
+ ---
324
+
325
+ ## 远程控制
326
+
327
+ Nexum Code 可以通过 `cc-connect` 接入聊天平台。配置后,即使终端不在眼前,也能在聊天窗口里创建会话、发送任务、上传文件和切换模式。
328
+
329
+ ```bash
330
+ npm install -g cc-connect
331
+ ```
332
+
333
+ 在 Nexum Code 中启动配置:
334
+
335
+ ```text
336
+ /cc-connect
337
+ ```
338
+
339
+ 常用远程指令:
340
+
341
+ | 指令 | 用途 |
342
+ |---|---|
343
+ | `/new` | 创建新会话 |
344
+ | `/bind setup` | 开启文件传送,支持图片、PDF 等 |
345
+ | `/mode` | 查看可用模式 |
346
+ | `/mode yolo` | 自动批准所有工具调用 |
347
+ | `/mode default` | 每次工具调用前询问 |
348
+
349
+ ---
350
+
351
+ ## 部署指南
352
+
353
+ ### Docker 部署(服务端)
354
+
355
+ `apps/nexum-agent-server` 是一个独立的 HTTP + SSE 服务端,支持容器化部署:
356
+
357
+ ```bash
358
+ # 复制环境变量配置
359
+ cp .env.example .env
360
+ # 编辑 .env 设置 NEXUM_PORT 和 TOOL_GATEWAY_URL
361
+
362
+ # 启动服务
363
+ docker-compose up -d
364
+ ```
365
+
366
+ docker-compose.yml 已配置健康检查、持久化卷和自动重启。
367
+
368
+ ### 环境变量
369
+
370
+ | 变量 | 说明 | 默认值 |
371
+ |---|---|---|
372
+ | `NEXUM_PORT` | 服务端监听端口 | `3000` |
373
+ | `NEXUM_HOST` | 监听地址 | `0.0.0.0` |
374
+ | `NEXUM_HOME` | 持久化数据目录 | `/data/nexum` |
375
+ | `TOOL_GATEWAY_URL` | AIFlowy 工具执行回调地址 | 空 |
376
+ | `NEXUM_API_KEY` | API 密钥 | 空 |
377
+ | `NEXUM_MODEL` | 默认模型 | 空 |
378
+ | `NEXUM_BASE_URL` | 服务端点 | 空 |
379
+ | `NEXUM_MAX_TURNS` | 最大轮次 | 空 |
380
+ | `NEXUM_TEMPERATURE` | 温度参数 | 空 |
381
+ | `NEXUM_WORKSPACE` | 工作空间 | 空 |
382
+ | `NEXUM_LOG_LEVEL` | 日志级别 | 空 |
383
+ | `NEXUM_DISABLE_ANALYTICS` | 禁用分析 | 空 |
384
+ | `NEXUM_CACHE_DIR` | 缓存目录 | 空 |
385
+ | `NEXUM_CONFIG_DIR` | 配置目录 | 空 |
386
+
387
+ ---
388
+
389
+ ## 为什么做 Nexum Code
390
+
391
+ 我想要的不是一个只会补全代码的工具,而是一个能长期陪我处理真实工作流的本地 Agent:
392
+
393
+ - 它要能记住项目里的约定,而不是每次从零开始。
394
+ - 它要能拆任务、分工、验证,而不是只会单线程聊天。
395
+ - 它要能接入我已有的工具和聊天入口,而不是把我锁在一个界面里。
396
+ - 它要能处理文档、提取信息,而不是只能读代码。
397
+ - 它要尊重本地机器的安全边界,而不是为了方便牺牲控制权。
398
+
399
+ 所以 Nexum Code 选择了 TypeScript monorepo、本地优先、权限策略、长期记忆、多 Agent、MCP 扩展、文档智能和可扩展工具系统这条路线。它不是功能堆叠,而是把高频 Agent 工作流收敛成一个稳定的底座。
400
+
401
+ ---
402
+
403
+ ## 项目链接
404
+
405
+ - npm:https://www.npmjs.com/package/nexum-code
406
+ - 许可证:[MIT](LICENSE)
407
+
408
+ ---
409
+
410
+ <p align="center">
411
+ <strong>Nexum Code</strong>
412
+ <br />
413
+ Local first. Agent native. Built for real workflows.
414
+ </p>