NE-CLI

NE-CLI 是一个运行在终端里的智能工作台，面向项目阅读、文件处理、命令执行、会话追踪、NE 文献 RAG 和 NE/Qingti MCP 文献工作流。

它以 necli 作为产品命令，在会话中通过自然语言、@ 文件引用、/ 命令和 ! shell 命令协同完成任务。

安装

NE-CLI 需要 Node.js 22.19.0 或更高版本。

npm install -g @noteexpress/cli

安装后确认命令可用：

necli --version

升级到最新版本：

npm install -g @noteexpress/cli

核心能力

| 能力 | 说明 | | --- | --- | | 会话式工作 | 在终端中持续对话，自动保留上下文和会话历史 | | 项目理解 | 阅读项目文件、解释模块职责、追踪实现链路 | | 文件处理 | 按自然语言读取、搜索、修改或创建项目文件 | | 命令执行 | 使用 !command 运行命令，并把输出交给模型继续分析 | | 上下文引用 | 使用 @<文件路径> 或 @<图片路径> 引入文件和截图 | | NE 文献 RAG | 导入本地 PDF/Markdown/文本，进行语义检索和问答 | | NE/Qingti MCP | 检索文献、按文件夹查询、读取 PDF 内容、保存题录 | | 模型与扩展 | 支持模型切换、技能、提示模板、主题和项目级扩展 |

开始会话

在项目目录中启动：

necli

进入会话后直接输入任务：

阅读这个仓库，说明主要模块和启动方式

引用文件作为上下文：

@README.md 总结这个项目面向谁、解决什么问题
@package.json @README.md 一起检查项目说明和包配置是否一致

执行命令并继续分析：

!npm run check

NE 文献 RAG

/ne-login
/rag-import D:\papers
/docs
总结本地文献中关于 RAG 评估指标的共识和分歧

支持导入 .pdf、.md、.txt。导入后可以直接提问，也可以用 @ 精确限定某篇已索引文档。

NE/Qingti MCP

/mcp tools
/mcp qingti search retrieval augmented generation
/mcp qingti pdf <article-id>

/mcp 默认使用 Qingti，也支持 ne、noteexpress、qt、qingti、qingtibase 等别名。

常用会话命令

| 命令 | 说明 | | --- | --- | | /ne-login | 登录 NE | | /login | 配置模型认证 | | /model | 切换模型 | | /resume | 选择历史会话 | | /session | 查看当前会话信息 | | /tree | 浏览会话分支 | | /docs | 查看本地 RAG 文档 | | /rag-import <path> | 导入本地文献到 RAG 索引 | | /mcp ... | 调用 NE/Qingti MCP | | /export <file> | 导出会话 | | /hotkeys | 查看快捷键 | | /reload | 重新加载配置、扩展、技能、提示模板和主题 | | /quit | 退出 |

更多说明

• NE-CLI 用户指南

License

MIT