Skip to content

安装穷理 ​

选择一种 CLI 安装方式,再运行 qiongli install 接入 Host。当前稳定版为 2.6.1。

直接下载 ​

独立程序自带研究 Skills、模板和 Lite/Full MCP,无需另装 Python、Node.js 或 Rust。

平台下载
macOS Apple Silicon(ARM64,macOS 11+)tar.gz
Windows x64zip
Linux x64(glibc 2.35+)tar.gz
Linux ARM64(glibc 2.35+)tar.gz

从 Release 的 Assets 选择平台包。Source code 是源码。Intel macOS、Windows ARM64、32 位系统和 musl Linux 不在二进制包支持范围内。Windows 已内置 C 运行库。

核对文件并运行 ​

下载同一版本的 SHA256SUMS,核对对应文件的 SHA-256。macOS 用 shasum -a 256 <文件名>,Linux 用 sha256sum <文件名>,PowerShell 用 Get-FileHash <文件名> -Algorithm SHA256。

核对一致后解压到新目录,在该目录运行:

sh
./qiongli --version
./qiongli install

PowerShell 使用 .\qiongli.exe --version 和 .\qiongli.exe install。需要在任意目录使用时,把解压目录加入用户 PATH,然后新开终端。

包管理器 ​

任选一种。npm 和 PyPI 自带原生程序,Cargo 从源码编译。安装后均提供 qiongli 和 ql。

渠道前提安装命令
npmNode.js 18+npm install --global [email protected]
PyPIPython 3.9+;在虚拟环境中运行python -m pip install --upgrade "qiongli==2.6.1"
CargoRust 1.97+ 与本机链接器cargo install qiongli --version 2.6.1 --locked

这些命令固定到同一稳定版。pip 指定版本还可避免在平台不匹配时意外安装 1.x。预发布 npm 使用 qiongli@next,版本和稳定版可能不同。

接入 Host ​

sh
qiongli --version
qiongli install
qiongli mcp check

选择 Plugin 和 Host,审阅文件计划与注册操作,分别确认。Plugin 已包含 Skills、程序和 Full MCP。

新开 Host 会话,请它列出穷理工具并调用 qiongli_config_status。mcp check 只检查本地协议。接着按快速开始提出研究请求。

运行 qiongli doctor、qiongli install inventory 或 qiongli provider status, 可查看还需检查什么。终端摘要区分本地安装、文献服务配置和未经验证的会话能力。 重定向时使用 --text 保留易读输出;--json 保留结构化诊断。

Full MCP 提供项目保存,仍需预览和你的批准;Lite 不提供项目保存。 Provider 状态检查不联网,已配置也不代表连接正常。如需测试,可主动运行 qiongli provider test <provider> --confirm-network-request 发起一次在线请求。 缺少凭据存储支持的平台不能保存 API 密钥,但仍可配置公开设置。

指定 Host、语言、Hook 或 DeepSeek profile,见 Plugin 配置。已安装用户见升级指南。

Qiongli 文档站