安装穷理
选择一种 CLI 安装方式,再运行 qiongli install 接入 Host。当前稳定版为 2.6.1。
直接下载
独立程序自带研究 Skills、模板和 Lite/Full MCP,无需另装 Python、Node.js 或 Rust。
| 平台 | 下载 |
|---|---|
| macOS Apple Silicon(ARM64,macOS 11+) | tar.gz |
| Windows x64 | zip |
| 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。
核对一致后解压到新目录,在该目录运行:
./qiongli --version
./qiongli installPowerShell 使用 .\qiongli.exe --version 和 .\qiongli.exe install。需要在任意目录使用时,把解压目录加入用户 PATH,然后新开终端。
包管理器
任选一种。npm 和 PyPI 自带原生程序,Cargo 从源码编译。安装后均提供 qiongli 和 ql。
| 渠道 | 前提 | 安装命令 |
|---|---|---|
| npm | Node.js 18+ | npm install --global [email protected] |
| PyPI | Python 3.9+;在虚拟环境中运行 | python -m pip install --upgrade "qiongli==2.6.1" |
| Cargo | Rust 1.97+ 与本机链接器 | cargo install qiongli --version 2.6.1 --locked |
这些命令固定到同一稳定版。pip 指定版本还可避免在平台不匹配时意外安装 1.x。预发布 npm 使用 qiongli@next,版本和稳定版可能不同。
接入 Host
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 密钥,但仍可配置公开设置。