nexum-code 0.6.14 → 0.6.16
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.
- package/README.md +84 -322
- package/dist/{aiflowy-bot-sync-BMV5Lg3y.mjs → aiflowy-bot-sync-C0WrAYbG.mjs} +2 -2
- package/dist/{aiflowy-bot-sync-CY50Z6GW.mjs → aiflowy-bot-sync-DhoRtQfn.mjs} +1 -1
- package/dist/{app-LAoILm5g.mjs → app-0T4efY5b.mjs} +38489 -6252
- package/dist/esm-RYfZ46Tf.mjs +3593 -0
- package/dist/index.min-D4utBuC7.mjs +2990 -0
- package/dist/main.mjs +1 -1
- package/dist/pdf-F2kQiIQy.mjs +26642 -0
- package/dist/pdf.worker-ByxNbF6P.mjs +82061 -0
- package/dist/{src-BMbLXrAA.mjs → src-kwvD0ssv.mjs} +12 -12
- package/package.json +26 -22
- package/scripts/postinstall.mjs +115 -13
- package/dist/esm-CmfJNv9s.mjs +0 -8590
package/README.md
CHANGED
|
@@ -1,322 +1,84 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
<tr>
|
|
86
|
-
<td width="50%">
|
|
87
|
-
<h3>中文体验优先</h3>
|
|
88
|
-
<p>从配置、审批、提示到常用命令都围绕中文用户设计。不是把英文工具翻译一遍,而是从使用习惯上降低门槛。</p>
|
|
89
|
-
</td>
|
|
90
|
-
<td width="50%">
|
|
91
|
-
<h3>终端、服务端、远程入口统一</h3>
|
|
92
|
-
<p>同一套 Agent Core 可以跑在 TUI、后端服务和远程聊天入口后面。你可以先自己用,再把它产品化给团队使用。</p>
|
|
93
|
-
</td>
|
|
94
|
-
</tr>
|
|
95
|
-
</table>
|
|
96
|
-
|
|
97
|
-
---
|
|
98
|
-
|
|
99
|
-
## 快速开始
|
|
100
|
-
|
|
101
|
-
### 环境要求
|
|
102
|
-
|
|
103
|
-
- Node.js >= 22.0.0
|
|
104
|
-
- Git
|
|
105
|
-
- 一个可用的模型服务,例如 DeepSeek、OpenAI、Anthropic、通义千问、硅基流动或任何 OpenAI-compatible API
|
|
106
|
-
|
|
107
|
-
### npm 安装
|
|
108
|
-
|
|
109
|
-
```bash
|
|
110
|
-
npm install -g nexum-code
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
安装完成后,启动 Nexum:
|
|
114
|
-
|
|
115
|
-
```bash
|
|
116
|
-
nexum
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
### macOS / Linux 一键安装
|
|
120
|
-
|
|
121
|
-
```bash
|
|
122
|
-
curl -fsSL https://raw.githubusercontent.com/Hsssliu/nexum-code/main/install.sh | bash
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
### Windows PowerShell 一键安装
|
|
126
|
-
|
|
127
|
-
```powershell
|
|
128
|
-
irm https://raw.githubusercontent.com/Hsssliu/nexum-code/main/install.ps1 | iex
|
|
129
|
-
```
|
|
130
|
-
|
|
131
|
-
首次启动时,如果还没有配置模型,Nexum Code 会进入交互式配置向导。你也可以随时输入:
|
|
132
|
-
|
|
133
|
-
```text
|
|
134
|
-
/config
|
|
135
|
-
```
|
|
136
|
-
|
|
137
|
-
配置完成后,用下面的命令切换模型:
|
|
138
|
-
|
|
139
|
-
```text
|
|
140
|
-
/model
|
|
141
|
-
```
|
|
142
|
-
|
|
143
|
-
---
|
|
144
|
-
|
|
145
|
-
## 你可以怎么用
|
|
146
|
-
|
|
147
|
-
```text
|
|
148
|
-
帮我理解这个项目的架构,并指出最重要的入口文件
|
|
149
|
-
```
|
|
150
|
-
|
|
151
|
-
```text
|
|
152
|
-
修复 pnpm test 里的失败用例,改完后再跑一遍验证
|
|
153
|
-
```
|
|
154
|
-
|
|
155
|
-
```text
|
|
156
|
-
/goal 在不破坏现有 API 的前提下,把这套工具调用逻辑整理清楚,并补上必要测试
|
|
157
|
-
```
|
|
158
|
-
|
|
159
|
-
```text
|
|
160
|
-
/memory 记住:这个项目优先使用 pnpm,不要引入不必要的新依赖
|
|
161
|
-
```
|
|
162
|
-
|
|
163
|
-
```text
|
|
164
|
-
/wolfpack 帮我并行检查 README、安装脚本、CLI 参数和服务端 API 是否一致
|
|
165
|
-
```
|
|
166
|
-
|
|
167
|
-
---
|
|
168
|
-
|
|
169
|
-
## 能力地图
|
|
170
|
-
|
|
171
|
-
| 能力 | Nexum Code 做什么 |
|
|
172
|
-
|---|---|
|
|
173
|
-
| 对话式执行 | 用自然语言描述任务,自动读文件、改代码、跑命令 |
|
|
174
|
-
| 审批面板 | 修改文件和执行命令前展示审批,降低误操作风险 |
|
|
175
|
-
| 权限策略 | 支持默认模式、计划模式、自动模式、YOLO 模式等 |
|
|
176
|
-
| Goal 循环 | 目标驱动的多轮执行,支持预算和完成度裁决 |
|
|
177
|
-
| 多 Agent | 子 Agent 并行处理探索、编码、验证、写作等任务 |
|
|
178
|
-
| 记忆系统 | 跨会话沉淀偏好、项目经验、问题记录和工作约定 |
|
|
179
|
-
| MCP 扩展 | 连接外部工具、数据库、浏览器、内部 API 等能力 |
|
|
180
|
-
| Skill 系统 | 把常用流程封装成可复用技能 |
|
|
181
|
-
| 后端 API | 通过服务端接口创建会话、发送提示、控制 Agent 和读取状态 |
|
|
182
|
-
| Node SDK | 在自己的 Node 后端里集成 Nexum Agent 能力 |
|
|
183
|
-
| Web 智能体 | 可作为网页端 Agent 工作台、企业自动化系统或内部 Copilot 底座 |
|
|
184
|
-
| 后台任务 | 支持长任务、后台命令和任务输出读取 |
|
|
185
|
-
| 会话恢复 | 中断后继续,支持历史记录、分叉、导出和撤销 |
|
|
186
|
-
| 远程聊天 | 通过 cc-connect 接入微信、飞书、钉钉、Slack 等平台 |
|
|
187
|
-
|
|
188
|
-
---
|
|
189
|
-
|
|
190
|
-
## 系统架构
|
|
191
|
-
|
|
192
|
-
这个仓库是一个 TypeScript monorepo,核心模块大致如下:
|
|
193
|
-
|
|
194
|
-
```text
|
|
195
|
-
aiflowy-agent/
|
|
196
|
-
apps/
|
|
197
|
-
nexum-code/ # 终端入口与 TUI
|
|
198
|
-
nexum-agent-server/ # Agent 服务入口
|
|
199
|
-
packages/
|
|
200
|
-
agent-core/ # Agent 循环、工具、权限、会话、MCP、LSP
|
|
201
|
-
node-sdk/ # Node SDK 与 RPC 客户端
|
|
202
|
-
nexum-server/ # HTTP API 与会话控制
|
|
203
|
-
memory/ # 长期记忆、检索、整理
|
|
204
|
-
ltod/ # 模型与工具调用抽象
|
|
205
|
-
jian/ # 本地运行时能力封装
|
|
206
|
-
config/ # 共享配置与身份信息
|
|
207
|
-
```
|
|
208
|
-
|
|
209
|
-
关键设计思路:
|
|
210
|
-
|
|
211
|
-
- `agent-core` 负责 Agent 的大脑,包括工具注册、权限评估、执行循环、子 Agent 和会话状态。
|
|
212
|
-
- `nexum-code` 负责终端用户体验,包括命令、审批面板、消息渲染和交互状态。
|
|
213
|
-
- `nexum-server` 和 `node-sdk` 让 Nexum 不只存在于终端,也能被后端服务、Web 应用、桌面端或其他客户端驱动。
|
|
214
|
-
- `memory` 独立成包,避免记忆能力被某一次会话绑定,方便跨项目和跨场景复用。
|
|
215
|
-
|
|
216
|
-
---
|
|
217
|
-
|
|
218
|
-
## Web 端智能体底座
|
|
219
|
-
|
|
220
|
-
Nexum Code 不是只能在终端里跑。它的核心能力已经拆成可复用的服务端和 SDK 层,适合接入自己的产品后端。
|
|
221
|
-
|
|
222
|
-
你可以用它构建:
|
|
223
|
-
|
|
224
|
-
- Web 端 AI 编程助手
|
|
225
|
-
- 企业内部 Agent 工作台
|
|
226
|
-
- 自动化任务执行平台
|
|
227
|
-
- 多 Agent 协作系统
|
|
228
|
-
- 带记忆、权限和会话恢复的私有 Copilot
|
|
229
|
-
|
|
230
|
-
后端可以围绕这些能力组织业务:
|
|
231
|
-
|
|
232
|
-
| 能力 | 适合做成什么产品功能 |
|
|
233
|
-
|---|---|
|
|
234
|
-
| Session API | 创建会话、恢复会话、分叉会话、导出会话 |
|
|
235
|
-
| Agent API | 发送任务、取消任务、切换模型、调整思考和权限模式 |
|
|
236
|
-
| Subagent Host | 在 Web 端展示多个子 Agent 的并行执行状态 |
|
|
237
|
-
| Permission System | 做企业级审批、敏感操作拦截和审计记录 |
|
|
238
|
-
| Memory Store | 做用户偏好、项目知识库和跨会话上下文 |
|
|
239
|
-
| MCP / Skill | 给 Web 产品接入数据库、浏览器、内部系统和自定义流程 |
|
|
240
|
-
|
|
241
|
-
这意味着 Nexum Code 可以从“一个本地工具”升级成“你的 Agent 产品底座”:前端负责交互,后端负责业务权限和数据,Nexum 负责智能体执行、工具调度、记忆和多 Agent 编排。
|
|
242
|
-
|
|
243
|
-
---
|
|
244
|
-
|
|
245
|
-
## 常用命令
|
|
246
|
-
|
|
247
|
-
| 命令 | 说明 |
|
|
248
|
-
|---|---|
|
|
249
|
-
| `/config` | 配置模型服务 |
|
|
250
|
-
| `/model` | 切换或管理模型 |
|
|
251
|
-
| `/memory` | 打开记忆管理 |
|
|
252
|
-
| `/dream` | 整理重复或过期记忆 |
|
|
253
|
-
| `/goal` | 开启目标循环 |
|
|
254
|
-
| `/wolfpack` | 开启多 Agent 协作 |
|
|
255
|
-
| `/cc-connect` | 配置聊天平台远程控制 |
|
|
256
|
-
| `/mode` | 查看或切换权限模式 |
|
|
257
|
-
|
|
258
|
-
开发仓库时常用:
|
|
259
|
-
|
|
260
|
-
```bash
|
|
261
|
-
pnpm install
|
|
262
|
-
pnpm run dev:cli
|
|
263
|
-
pnpm run typecheck
|
|
264
|
-
pnpm run lint
|
|
265
|
-
pnpm run test
|
|
266
|
-
pnpm run build
|
|
267
|
-
```
|
|
268
|
-
|
|
269
|
-
---
|
|
270
|
-
|
|
271
|
-
## 远程控制
|
|
272
|
-
|
|
273
|
-
Nexum Code 可以通过 `cc-connect` 接入聊天平台。配置后,即使终端不在眼前,也能在聊天窗口里创建会话、发送任务、上传文件和切换模式。
|
|
274
|
-
|
|
275
|
-
```bash
|
|
276
|
-
npm install -g cc-connect
|
|
277
|
-
```
|
|
278
|
-
|
|
279
|
-
在 Nexum Code 中启动配置:
|
|
280
|
-
|
|
281
|
-
```text
|
|
282
|
-
/cc-connect
|
|
283
|
-
```
|
|
284
|
-
|
|
285
|
-
常用远程指令:
|
|
286
|
-
|
|
287
|
-
| 指令 | 用途 |
|
|
288
|
-
|---|---|
|
|
289
|
-
| `/new` | 创建新会话 |
|
|
290
|
-
| `/bind setup` | 开启文件传送,支持图片、PDF 等 |
|
|
291
|
-
| `/mode` | 查看可用模式 |
|
|
292
|
-
| `/mode yolo` | 自动批准所有工具调用 |
|
|
293
|
-
| `/mode default` | 每次工具调用前询问 |
|
|
294
|
-
|
|
295
|
-
---
|
|
296
|
-
|
|
297
|
-
## 为什么做 Nexum Code
|
|
298
|
-
|
|
299
|
-
我想要的不是一个只会补全代码的工具,而是一个能长期陪我处理真实工作流的本地 Agent:
|
|
300
|
-
|
|
301
|
-
- 它要能记住项目里的约定,而不是每次从零开始。
|
|
302
|
-
- 它要能拆任务、分工、验证,而不是只会单线程聊天。
|
|
303
|
-
- 它要能接入我已有的工具和聊天入口,而不是把我锁在一个界面里。
|
|
304
|
-
- 它要尊重本地机器的安全边界,而不是为了方便牺牲控制权。
|
|
305
|
-
|
|
306
|
-
所以 Nexum Code 选择了 TypeScript monorepo、本地优先、权限策略、长期记忆、多 Agent 和可扩展工具系统这条路线。它不是功能堆叠,而是把高频 Agent 工作流收敛成一个稳定的底座。
|
|
307
|
-
|
|
308
|
-
---
|
|
309
|
-
|
|
310
|
-
## 项目链接
|
|
311
|
-
|
|
312
|
-
- 官网:https://nexum.chat
|
|
313
|
-
- npm:https://www.npmjs.com/package/nexum-code
|
|
314
|
-
- 许可证:[MIT](LICENSE)
|
|
315
|
-
|
|
316
|
-
---
|
|
317
|
-
|
|
318
|
-
<p align="center">
|
|
319
|
-
<strong>Nexum Code</strong>
|
|
320
|
-
<br />
|
|
321
|
-
Local first. Agent native. Built for real workflows.
|
|
322
|
-
</p>
|
|
1
|
+
# Nexum Code CLI
|
|
2
|
+
|
|
3
|
+
`nexum-code` 是 Nexum 的终端客户端,提供命令行入口和 TUI 交互界面。它面向本地开发、自动化任务执行、AIFlowy/Web 智能体接入前的本地调试,以及需要终端原生体验的 Agent 工作流。
|
|
4
|
+
|
|
5
|
+
## 安装与启动
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g nexum-code
|
|
9
|
+
nexum
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
运行要求:
|
|
13
|
+
|
|
14
|
+
- Node.js >= 22.19.0
|
|
15
|
+
- pnpm 仅在本仓库开发时需要
|
|
16
|
+
- 扫描件 OCR 依赖 Tesseract OCR
|
|
17
|
+
|
|
18
|
+
Windows 可手动安装 OCR:
|
|
19
|
+
|
|
20
|
+
```powershell
|
|
21
|
+
winget install UB-Mannheim.TesseractOCR
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
常用 OCR 环境变量:
|
|
25
|
+
|
|
26
|
+
```powershell
|
|
27
|
+
$env:NEXUM_TESSERACT_PATH="C:\Program Files\Tesseract-OCR\tesseract.exe"
|
|
28
|
+
$env:NEXUM_OCR_LANGUAGE="chi_sim+eng"
|
|
29
|
+
$env:NEXUM_TESSDATA_DIR="$env:LOCALAPPDATA\Nexum\tessdata"
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## 常用命令
|
|
33
|
+
|
|
34
|
+
```text
|
|
35
|
+
/config 配置模型服务
|
|
36
|
+
/model 切换模型
|
|
37
|
+
/mode 切换权限模式
|
|
38
|
+
/goal 开启目标驱动执行
|
|
39
|
+
/memory 管理长期记忆
|
|
40
|
+
/doc 解析 PDF、Word、Excel、CSV、图片与扫描 PDF
|
|
41
|
+
/cc-connect 配置远程聊天入口
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## 文档解析
|
|
45
|
+
|
|
46
|
+
解析单个文件:
|
|
47
|
+
|
|
48
|
+
```text
|
|
49
|
+
/doc "E:\资料\灾毁报告.pdf" --format markdown
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
递归解析文件夹:
|
|
53
|
+
|
|
54
|
+
```text
|
|
55
|
+
/doc "E:\资料\公路灾毁文档" --format markdown
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
只解析当前文件夹,不进入子目录:
|
|
59
|
+
|
|
60
|
+
```text
|
|
61
|
+
/doc "E:\资料\公路灾毁文档" --format markdown --no-recursive
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
支持导出格式:
|
|
65
|
+
|
|
66
|
+
```text
|
|
67
|
+
json | markdown | excel | csv | review-json | review-markdown
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## 本地开发
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
pnpm install
|
|
74
|
+
pnpm --filter nexum-code run dev:cli-only
|
|
75
|
+
pnpm --filter nexum-code run build
|
|
76
|
+
pnpm --filter nexum-code run test
|
|
77
|
+
pnpm --filter nexum-code run typecheck
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
`nexum-code` 只负责客户端体验与命令入口。文档解析、会话执行、服务端适配等核心逻辑应通过 `packages/*` 中的稳定 API 调用,不应直接塞入 TUI 层。
|
|
81
|
+
|
|
82
|
+
## 许可证
|
|
83
|
+
|
|
84
|
+
MIT
|
|
@@ -134,8 +134,8 @@ function normalizeBotList(payload) {
|
|
|
134
134
|
return payload.map((item) => {
|
|
135
135
|
if (typeof item !== "object" || item === null) return null;
|
|
136
136
|
const record = item;
|
|
137
|
-
const id =
|
|
138
|
-
const title =
|
|
137
|
+
const id = optionalString(record["id"]) ?? "";
|
|
138
|
+
const title = optionalString(record["title"]) ?? "";
|
|
139
139
|
if (id.length === 0 || title.length === 0) return null;
|
|
140
140
|
return {
|
|
141
141
|
id,
|
|
@@ -3,5 +3,5 @@ import { fileURLToPath as __cjsShimFileURLToPath } from 'node:url';
|
|
|
3
3
|
import { dirname as __cjsShimDirname } from 'node:path';
|
|
4
4
|
const __filename = __cjsShimFileURLToPath(import.meta.url);
|
|
5
5
|
const __dirname = __cjsShimDirname(__filename);
|
|
6
|
-
import { l as updateAiflowyBot } from "./aiflowy-bot-sync-
|
|
6
|
+
import { l as updateAiflowyBot } from "./aiflowy-bot-sync-C0WrAYbG.mjs";
|
|
7
7
|
export { updateAiflowyBot };
|