v1.6.0
Release Category
v1.6.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.6.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.6.0.zip |
| All Desktop/Web subject ZIPs | qiongli-downloads-v1.6.0.md |
| Claude Desktop literature MCPB | qiongli-literature-provider-0.1.4.mcpb |
| Zotero Desktop companion XPI | qiongli-zotero-companion-0.2.2.xpi |
| Machine-readable download index | qiongli-downloads-v1.6.0.json |
Changelog
[1.6.0] - 2026-06-24
Added
- 新增 project-local guidance stack:除
.qiongli/local_guidance.md外,项目可以通过.qiongli/guidance.d/*.md维护多个本地约束或扩展片段;运行时会按稳定顺序合成 guidance,并保留 source order metadata。 qiongli guidanceCLI 新增add、list、lint子命令,用于创建本地 guidance fragment、列出实际生效来源、检查削弱 canonical contract / evidence gate / quality gate 的高风险表述。- Task-run trace、routing note、MCP preview 和 proposal 输出新增 guidance source metadata、fragment count、source order、conflict notes 与 proposal target/conflict check,让本地 guidance 的影响路径可审计。
Changed
- Skill-only Qiongli workflow 现在会在项目存在
.qiongli/local_guidance.md或.qiongli/guidance.d/*.md时读取本地 guidance,但本地规则仍只能作为 advisory layer,不能覆盖 canonical workflow contract、必需产物、证据门、质量门或安全边界。 - Guidance proposal 默认定位为 project-local;
qiongli guidance apply只写入.qiongli/local_guidance.md,提升到 user-global preferences 或 canonical source 需要显式后续命令或常规 repository PR。 - README、文档首页和安装/发布文档更新为更完整的入口说明,覆盖 skill/plugin/CLI/MCP/Zotero 路由、稳定版下载方式和本地运行边界。