Important
MimirQ 的首个稳定开源版本：提供业务无关、可审计、可回归的知识库能力层，并正式支持本机源码与 Docker Compose 两种部署路径。
发布提交： 3281051aa7c8
核心能力
- 多租户数据访问采用 fail-closed 边界，文档、Dataset、KG、评测和分析链路统一执行作用域校验。
- 多知识库检索按 embedding runtime 与 embedding space 自动分片，避免不同向量空间混检。
- 上传、入库、检索和聊天链路具备分布式锁、幂等回读、并发限流与背压能力，适用于多实例部署。
- 支持本地或 OpenAI 兼容的 LLM、Embedding 与 Reranker，能力层不依赖特定政务或行业规则。
- 证据 capsule、must-recall 与 provenance 门禁采用真实回归证据，证据缺失或不一致时 fail-closed。
集成与部署
- 支持 Dify External Knowledge API 与 HTTP 工作流两种接入方式。
- README 提供 Docker-first 与 host-source-first 两套快速开始流程。
- Windows GNU Make 下的
make init直接调用 Python 初始化脚本，不再把 POSIX 注释交给cmd.exe执行。 - Docker 镜像保持非 root、只读源码与生产依赖分层；CI 覆盖镜像构建和运行时冒烟。
- 发布门禁可离线运行，不依赖外部模型凭证或 self-hosted runner 的残留状态。
发布验证
- 后端全量回归：
1631 passed, 10 skipped。 make verify：Python lint、策略校验、API 契约/覆盖率/类型漂移、文档链接、前端 lint/typecheck 与 compileall 全部通过。- Windows 兼容模拟与干净临时目录初始化通过，
.env、web/.env.local及随机密钥均正确生成。 - 严格检索证据门禁：must-recall
2/2、provenance2/2，通过率均为1.0。 - 800 题真实链路与 Dify 路径的结果、口径和时延记录见基准文档。
升级说明
- 新部署从
.env.example复制配置，并在生产环境替换所有默认密钥、密码和认证参数。 - 更换 Embedding 模型后必须重建对应知识库索引，不能复用旧 embedding space。
- 并发重复上传去重仍由
UPLOAD_DEDUP_ENABLED显式控制，请按业务幂等需求开启。 - 领域路由和业务规则应放在集成或插件层，不应写入 MimirQ 通用检索核心。
已知非阻塞项
- Starlette 与 LangChain Milvus 旧适配器仍有上游弃用警告，不影响当前受支持路径。
- 真实 Kubernetes 集群安装和外部模型服务 SLA 属于部署环境验证，不作为本次核心发布阻塞项。