# @qoder-ai/qmind-cli

[English (default)](CHANGELOG.md) | 简体中文

以下已发布版本属于 Global CLI / 共享实现，不代表 CN 曾发布过这些版本。CN 将在后续共同发行版加入同一历史。

## 4.1.0

### Minor Changes

- 17bb94f: 为 `qmind-cn` 及对应 Global CLI 增加带摘要的知识库发现、单页 URL 导入、定时任务 CRUD 与暂停/恢复、有界 Source 正文读取、目录过滤和批量删除。新 workflow 复用 Agent Core 校验及确定/未知写入结果。既有知识库输出保留 overview 和数量；删除支持 JSON/NDJSON 回执，预读失败时停止。

  使用 `retrieve --unified` 或 `--targets` 进行统一单库/多库检索并按库过滤 Source；既有检索入口也支持 `--score-threshold`。使用 `source mkdir --derive-path` 和 `source mv --to/--to-root` 推导路径并校验目标。原检索、全文读取与低层 Source patch 行为继续保留。未确认的直接写入返回 `outcome_unknown` 和 `retryable:false`；再次操作前先查询当前状态。

## 4.0.0

### Major Changes

- c0df079: 要求 Node.js 22.19.0 及以上版本。使用较旧运行时的用户须先升级 Node.js，再安装此版本。

  将 undici 升级至 8.12.2、commander 升级至 15.0.0、entities 升级至 8.1.0、eventsource-parser 升级至 4.1.2、open 升级至 11.0.4、p-limit 升级至 7.3.3、picomatch 升级至 4.0.7、zod 升级至 4.6.7。保留既有 HTTP/1.1 传输行为与代理策略。

  显式指定 Global npm README 默认为英文、CN npm README 默认为中文，并在中英文文档中统一使用 Qoder CN 产品名称。

## 3.5.0

### Minor Changes

- 708977c: 从 `qmind-cn` 彻底移除 Cards：检索 JSON 不再包含 `cards`，NDJSON 仅输出 chunks，table/agent 不再渲染卡片。编译进度不再展示卡片计数。消费方需改用 chunks 和 citations，不提供恢复 Cards 的兼容开关。单知识库检索保留原端点，多知识库输出保留知识库身份与服务端排序。

## 3.4.0

### Minor Changes

- 85ebf9c: `qmind retrieve` 和 `qmind-cn retrieve` 支持通过逗号分隔或重复传入 `--nb` 显式选择最多 5 个不同知识库。多库通过一次统一检索请求共享结果预算，由服务端排序；输出保留知识库身份和服务端顺序，请求失败时不回退到逐库调用。单库检索及输出保持不变，`--sources` 仍仅支持单库。

## 3.3.0

### Minor Changes

- c024d97: 新增 `notebook list --shared` 及分页参数，并在 CLI 输出中保留服务端返回的知识库权限信息。

## 3.2.1

### Patch Changes

- cb40928: 打包 SDK 的流消息 Source ID 引用兼容修复，使 qmind 和 qmind-cn 能正常完成带引用的 RAG 回复，避免 STREAM_ERROR。

## 3.2.0

### Minor Changes

- 7fd1634: 移除顶层 `compile`、`lint` 命令及 `source import-site --compile-after-refresh` 选项，并让 `task create` 拒绝 `compilation` 与 `lint` 场景。`task list` 和 `task get` 仍可查询历史运行；SDK、UI、后端自动编译及内部能力不受影响。

### Changes without version bumps

- 为 Native `qmind` 和 `qmind-cn` 安装器展示精简的 Preparing、带实时传输进度的 Downloading 和 Installed 三个阶段。

## 3.1.1

### Patch Changes

- a92c490: 为 installer 管理的 Native CLI release 增加 `update` 与 `update --check`，固定使用 Global/CN channel，校验 release 和 installer checksum，拒绝降级，复用事务式替换，并在 Windows 上于当前进程退出后调度更新。npm 管理的安装仍返回对应的 npm 升级命令。

### Changes without version bumps

- 新增由仓库维护的 Native CLI 安装脚本制品生成、candidate 编排、Bun 编译、可恢复安装事务、严格离线 handoff 校验与 macOS、Windows、Linux finalization 能力；现有通过 npm 安装的 `qmind` 或 `qmind-cn` 运行时行为不变。

## 3.1.0

### Minor Changes

- bd500e8: 按照 Cards 下线策略，移除 `cards` 命令组及其顶层 `list` / `search` 别名，并一并删除专用的卡片列表渲染路径；`retrieve` 保留自身的卡片渲染，仍可用于查询知识库上下文。

### Changes without version bumps

- 让 CLI 发布校验能够识别等价的 SSH 与 HTTPS 仓库目标，并使 settlement 回归测试在 depth-one CI checkout 中保持确定性。本次只修改发布工具，不改变包字节或版本。

## 3.0.0

### Major Changes

- 28508e5: 将 QMind CLI 作为共享版本的 Global/CN 共同发行版发布：Qoder Global 继续使用 `@qoder-ai/qmind-cli` / `qmind`，Qoder CN 新增 `@qodercn-ai/qmind-cli` / `qmind-cn`。每个发行版都具有构建时固定的产品身份与正式目标、按产品/目标隔离的文件凭证、中英文 package 文档与 changelog，以及一个在 Changeset 进入 `main` 后自动发布的双发行物不可变候选。CLI 不再读取旧根目录状态或 OS Keyring 项；Global 用户升级后需要重新登录，CN 包正式发布后需单独安装。

### Changes without version bumps

- 构建时固定 CLI 产品，config、文件凭证与同步映射按产品/目标隔离在 `QMIND_HOME/cli/` 下。调试使用 `--env` 或成对 `--sash`/`--dashboard`，Token 使用 `QMIND_DEBUG_TOKEN`。旧地址仅同值警告、冲突则在请求前停止；不读取旧根文件与 `.qmind-env`，请在新分区重新登录。共同 major 发行版从同一份版本化源码交付 CN 包。
- 只使用文件 credential vault，不安装、加载、读取、写入或删除 OS Keyring 项。device/refresh token 仍为明文文件，保留现有权限、原子写、文件锁与 compare-and-swap 保护，不导入旧认证状态。
- 移除过时的 CLI 内部 Node Host 转发及 updater 层，强化 Agent 发布证据，并使 package、安全和验收文档与当前结构一致。

- 从同一 Changeset 与版本共同结算 CLI 中英文 changelog，校验历史及引用一致，并将两份文档纳入结算和本地制品检查。仍不触发发布。
- 增加显式冻结 CLI 候选 tag 阶段，严格校验 annotated tag 身份和 tarball 摘要，逐次保留不可覆盖的尝试记录，并通过远端读回支持重试。生产 CI 与 npm 发布流程保持不变。
- 增加冻结 CLI 候选的内部按发行物发布模块：精确版本对账、以 release 标签发布原始 tarball、匿名验证，以及不会降级新版的 latest 恢复。生产发布入口仍不接通。
- 从同一版本与依赖快照分别编译 Global/CN CLI tarball，验证普通并装及固定产品认证。正式候选接入与发布留至共同 major 发行版。
- 增加显式双 CLI 候选准备与冻结制品只读验证入口，将两种发行物绑定到同一已结算源码和双语版本；现有发布流水线仍不接受新的候选格式。
- 准备固定的 CLI 产品路由、显式调试目标、旧地址诊断与分区文件状态。保持共享 Host 默认行为不变，版本升级与发布留至 Global/CN 共同 major 发行版。
- 从 main 结算归档 schema 8 双 CLI 候选，并增加显式生产 promotion pipeline，串联候选绑定认证、tag、Global/CN 隔离 publisher、恢复、汇总与通知门禁。本改动不执行发布。
- 增加冻结 Global/CN CLI 候选的显式匿名精确版本验证，覆盖下载字节、隔离 npm 安装、安装后命令与不可覆盖的验证回执。生产发布及 latest 推进保持不变。
- 增加无 token 的内部双发行汇总：验证 Global/CN publisher 证据并匿名复核当前 latest，不修改 registry 或 Git 状态。生产发布装配仍未接通。

## 2.0.0

### Major Changes

- a317ae9: 收紧 QMind Client 领域合同：移除无效的 `userId` client option，以及 Node Host / CLI 的 `userId`、`--user`、`QMIND_USER_ID` 配置面；兼容真实空列表、零分页与 RepoWiki snake_case wire shape，补齐 Card facet、ChatMessage 等已知字段，并让 capability 只声明当前公开 interface 可调用的领域能力。SDK 同时公开严格领域 decoder，供尚未进入 Client interface 的宿主 route 复用同一合同；官方 Fetch Transport 新增 stream connect/idle timeout，且将 Zod 改为由宿主提供的兼容 peer，避免 SDK 安装出第二套 schema 类型世界。

## 1.1.3

### Patch Changes

- d2dcbb6: 新增 QMind Agent Contract v1 Core、按 Query 创建的 Qoder Agent SDK adapter、共享 Node Host、canonical Qoder Plugin runtime 和确定性的 Plugin artifact 流程。CLI 改用提取出的 Node Host，命令面不变。

### Changes without version bumps

- 在支持的 Node.js runtime 上，加载 CLI application 前启用 module compile cache，同时保持 Node 20 兼容性。

## 1.1.2

### Patch Changes

- c3a3a0f: 从 CLI package README 中移除冗余的 module boundary 说明。

## 1.1.1

### Patch Changes

- 711c3b9: 面向 package 使用者重写各包 README，将公共 QMind CLI 明确为 bin-only，移除原 workspace module exports。

## 1.1.0

### Minor Changes

- 858c2f4: QMind CLI 以 `@qoder-ai/qmind-cli` 发布到 npm。使用 `npm install --global @qoder-ai/qmind-cli` 安装后，通过 `qmind` 登录、管理知识库和来源、检索知识、运行 RAG/编译流程和安全同步目录。支持适合自动化的 JSON/NDJSON 输出、稳定退出码以及 npm 管理的升级，适用于 macOS、Linux、Windows 和 Node.js 20.18.1 及以上版本。

## 1.0.0

### Initial release

- 引入面向 QMind 知识工作流的 `qmind` 命令。
- 新增浏览器登录与安全的本地凭证管理，支持自动化环境及 Token 配置。
- 新增 notebook 创建/列表/读取/删除、card 列表/搜索、检索、RAG、编译、校验、source 创建/列表/读取/上传/下载/移动/内容/删除、网站导入、图片预签名与目录上传流程。
- 新增人类可读的表格、JSON、agent、NDJSON 输出，以及结构化错误和适合脚本的退出码。