# @cnkang/qdrant-memory-launcher 中文文档

规范地址：https://npmcn.com/package/%40cnkang/qdrant-memory-launcher/

版本：0\.1\.0-rc\.9
npm 元数据更新时间：2026-11-14T02:23:39.836Z
中文译文更新时间：2026-11-14T02:26:14.048Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cnkang/qdrant-memory-launcher
原文对照：https://npmcn.com/package/%40cnkang/qdrant-memory-launcher/?lang=original
项目主页：https://github.com/cnkang/qdrant-memory-mcp#readme
源码仓库：https://github.com/cnkang/qdrant-memory-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：162 kB，12 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-10-16T05:33:02.708Z
- 最新版本发布：2026-11-14T02:22:26.922Z
- 近 30 天下载量：3074（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

MCP 客户端的私人 Python 和 CPU 内存运行时间

## 安装

```sh
npm install @cnkang/qdrant-memory-launcher
```

也可以使用：`pnpm add @cnkang/qdrant-memory-launcher`、`yarn add @cnkang/qdrant-memory-launcher`、`bun add @cnkang/qdrant-memory-launcher`

## README

# 管理 Qdrant 内存发射器

发射装置安装了私人Python环境,runtime 0.6.2和a 经核实的多语言CPU嵌入模型。 工作泥巴和深网利用 单独嵌入式内存配置。 现有赫尔姆斯设施保留其 配置和数据.

这是一个释放候选人。 采购网安装和桌面接收 对每个操作系统分别进行跟踪.

## 安装和准备

对于已经提供"节点"(Node.js 20)或"更新"的客户端:

```sh
npm install --global @cnkang/qdrant-memory-launcher@0.1.0-rc.9
qdrant-memory-launcher prepare dsh
qdrant-memory-launcher mcp dsh
```

准备需要网络访问,可能需要几分钟。 下载 私人的Python属地和大约252 MB的模型文物. 无系统 需要Python,uv/uvx,Ollama或Qdrant服务器. 本地预设不需要 API 密钥. 在启用 MCP 连接之前, DSH 必须完成准备 . 它的临时MCP探测器从未运行安装.

WorkBuddy管理的连接器宣布了20号节点,并要求WorkBuddy 5.0.0或较新. 它运行 `mcp workbuddy --auto-setup`安装此连接 授权下载和创建其私人简介.

## 第一次连接和恢复

这四个工具在准备时出现。 连接指标是指 MCP运输工具可供使用。 这并不意味着记忆后端已经准备好. 在准备过程中,工具呼叫报告没有操作. 等会儿 请代理保存一个事实。 写字从不排队.

普通网络中断后, 请检查连接和可用的磁盘 空间,然后断开并重新连接 WorkBuddy 重试。 DSH 用户应运行 `qdrant-memory-launcher prepare dsh` 再次连接之前。 一个失败的设置 不重置内存数据。 准备不会无限期重试下载 .

如果保存、更新或删除在发送后中断,则搜索 影响内存,并在重复前检查其ID. 永不连接 自动重写.

一个繁忙的外观错误意味着另一个进程拥有该配置. 关上那个 连接正常。 永远不要去除数据锁以强制第二写器.

## 储存和升级

默认根是 `qdrant-memory-managed` 下级:

| 系统 | 数据目录 |
| --- | --- |
| 马科斯 | `~/Library/Application Support` |
| 窗口 | `%LOCALAPPDATA%` |
| 链接 | `$XDG_DATA_HOME` 或者说 `~/.local/share` |

方案环境 `programs/<runtime-revision>/<dependency-lock-prefix>/<platform-arch>/env/`· ; 校正是运行时源承诺, 锁定前缀是第一个 12 属性摘要中的字符。 CLI 可执行文件为 `bin/qdrant-memory` 在 macOS 和 Linux 上或 `Scripts/qdrant-memory.exe` 在视窗上。 模特儿住在这里 `models/`,并在 `profiles/workbuddy/local/` 或者说 `profiles/dsh/local/`。 。 。 . 可选 `QDRANT_MEMORY_MANAGED_ROOT` 必须是一个绝对的道路. 程序版本和依赖性锁选择单独的安装目录. 现有配置在升级时保留其模型缓存设置 .

在更新或使用维护命令前断开客户端. 取消对 npm 软件包的设置可以删除发射装置。 它不删除配置文件 或模特儿。 在回滚前备份配置文件并保留同样的嵌入 输油管。 不复制正在运行的嵌入式商店或自动移出 .

在意外的操作系统关闭或强制杀伤装置之后,提供 锁可能需要操作员的协助。 确认安装者及其孩子 程序在检查程序前已停止 `.provision.lock`。不要删除配置文件或运行时数据锁.

## 软件包完整性

启动器没有第三方 JavaScript 依赖性或下载 模特们 它在行刑前验证了靴子和公开运行时轮字节. 所有Python依赖物被用散列来固定并被安装为轮子. 没有 依赖源代码被编译. 运行时间验证模型修改和文物.

枕头保持13.0. 官方快讯 0.9.1 支持 Pillow 13 并且是 安装在由散列固定的上游轮子上。 准备不再下载 或执行相容性构建器. `uv pip check` 和 CPU 模型接受 仍须如此。 保留了现有的剖面图和模型缓存.

运行时间0.6.2 允许每个模型文件15分钟,所有网络30分钟 明确准备时的下载。 发射器允许40分钟 配置/模型设置,同时拖带和 依赖子进程保持各自的10分钟界限. 冷/ 公开npm CI任务允许90分钟安装和实际接受CPU. 规模和 散列检查仍然是强制性的;等待更长的时间从来不是准备就绪的部分缓存. 公共npm接收允许60分钟准备就绪. MCP 初始化并 工具发现保留其60秒握手预算,同时进行准备 在背景中.

FastEmbed 0.9.1与前作0.9.0有不同的管道特性 相容性构建. 新设施使用符合版本要求的模型缓存 目录。 现有配置文件保留其原始缓存路径而不是 默地升级或重新贴上标签. 旧的 CPU 配置文件可以拒绝设置 与新的运行时间。 保持其上个发射装置的可用性. 授权 升级,通过旧的运行时导出,选择一个新的被管理的 root/ profile 和 收藏,在切换客户端之前用再嵌入和验证导入. 保留旧店并缓存回滚. 永远不要编辑已准备好的标记, 存储 指纹或所有权记录以强制兼容.

`runtime.json`, (中文(简体) ), `requirements.lock` 财务报告和审定财务报表 `bootstrap.mjs` 记录准确性 版本和完整性检查。 见 [第三方通知](https://npmcn.com/package/%40cnkang/qdrant-memory-launcher/THIRD_PARTY_NOTICES.md)。 。 。 . 安装子进程接收一个没有服务密钥的受限环境. MCP stdout只携带协议消息.

## 常见问题

### @cnkang/qdrant-memory-launcher 是什么？

MCP 客户端的私人 Python 和 CPU 内存运行时间

### 如何安装 @cnkang/qdrant-memory-launcher？

在项目目录运行 npm install @cnkang/qdrant-memory-launcher，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 qdrant-memory-launcher，可以用 npx qdrant-memory-launcher 直接运行。

### @cnkang/qdrant-memory-launcher 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cnkang\_\_qdrant-memory-launcher 是否存在。

### @cnkang/qdrant-memory-launcher 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cnkang/qdrant-memory-launcher 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cnkang/qdrant-memory-launcher 可以商用吗？

@cnkang/qdrant-memory-launcher 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cnkang/qdrant-memory-launcher 的下载量有多少？

根据 npm 官方下载统计，@cnkang/qdrant-memory-launcher 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,074 次，日均约 102 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cnkang/qdrant-memory-launcher 还在维护吗？

最新版本 0\.1\.0-rc\.9 发布于 2026/11/14（今天）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/10/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。