v1.8.0
Release Category
v1.8.0 is the stable release for normal installs and upgrades. Use it for npm latest, PyPI stable, the qiongli marketplace entry, Claude Desktop/Web skill ZIPs, the literature MCPB, and the Zotero companion XPI.
| Category | Use it for | Notes |
|---|---|---|
| Stable packages | npm latest, PyPI stable, and normal CLI upgrades |
This is the default path for most users. |
| Client workflow assets | Codex, Claude Code, Claude Desktop/Web, Antigravity, and Hermes workflow installs | Marketplace installs are preferred where supported; Desktop/Web users should download a skill ZIP. |
| Local literature tools | Claude Desktop MCPB and bundled plugin MCP runtimes | Install the MCPB only when local provider/search tools are required. |
| Zotero companion | Local Zotero Desktop search/write workflows | Install the XPI only when you want Qiongli to talk to Zotero Desktop. |
| Maintainer artifacts | Codex/Claude plugin tarballs and plugin ZIPs | These are for release checks and direct upload tests, not the normal user path. |
| Prerelease channel | qiongli-next, npm next, and PyPI beta |
This channel remains for validation builds and does not need to be newer than the stable tag. |
Download Guide
Start here instead of scanning GitHub's flat asset list.
| Need | Link or command |
|---|---|
| Release page and all assets | Qiongli v1.8.0 |
| npm CLI | npm install -g qiongli@latest or npx qiongli@latest install --target all --project-dir "$PWD" |
| PyPI CLI | pipx install qiongli or pipx upgrade qiongli |
| Default Claude Desktop/Web skill ZIP | qiongli-claude-desktop-skill-core-v1.8.0.zip |
| All Desktop/Web subject ZIPs | qiongli-downloads-v1.8.0.md |
| Claude Desktop literature MCPB | qiongli-literature-provider-0.1.5.mcpb |
| Zotero Desktop companion XPI | qiongli-zotero-companion-0.2.2.xpi |
| Machine-readable download index | qiongli-downloads-v1.8.0.json |
Changelog
[1.8.0] - 2026-06-25
Added
- 新增本地 full plugin surface:
qiongli install --profile full --target all --surface plugin现在可以生成客户端原生 plugin,并让 Codex / Claude Code 的 plugin-owned MCP 启动完整 Python-backedqiongli mcp serve --transport stdio。 - Codex 本地 full plugin 会写入受管理的 personal marketplace entry、
.codex-plugin/plugin.json、plugin.mcp.json、workflow skill、commands 和.qiongli-managed.json;Claude Code 本地 full plugin 使用同一套 full MCP server。 --target all --surface plugin现在把 Codex / Claude Code 接到本地 full plugin,同时继续给 Antigravity / Hermes 写入受管理的 full MCP client config。qiongli remove --surface plugin/--parts plugin新增受管 marker 语义,只删除 CLI 创建的本地 full plugin root 和 CLI-managed Codex marketplace entry。
Changed
- 安装架构文档更新为 marketplace lite 与 CLI full plugin 的分层模型:marketplace plugin 继续作为 no CLI / no Python fallback,完整本地 Qiongli 由 CLI 生成的本地 plugin 包装 full MCP。
- README、中文 README、install guide、quickstart、CLI reference 和 cross-platform MCP 文档同步说明 Codex / Claude Code plugin-owned MCP、Antigravity / Hermes client config,以及本地 plugin 删除边界。
Fixed
- 修复 CLI-managed 本地 plugin 删除逻辑,避免误删 marketplace 安装的 lite plugin 或用户自建 plugin root。
- 修复 stale Codex marketplace entry 清理边界,只清理带
metadata.managedBy = "qiongli-cli"的本地 full plugin entry。