Cursor Blinking Local Connector

这是运行在用户 Apple Silicon Mac 上的独立安装包。用户只需用浏览器访问 notes.vectania.com，不需要下载 Cursor Blinking 项目。

Local Connector 包含三部分：

• 出站连接器：使用一次性配对码连接 notes.vectania.com，不开放公网端口；
• Provider 适配器：把本机 FFmpeg、已登录的 Codex CLI、Ollama、MFLUX、MLX-Audio TTS 和已注册的 LTX 运行时转换成网站支持的固定能力；
• 运行管理器：启动已安装的适配器、发现已经运行的兼容服务，并在服务退出后重试。

npm 包不包含模型权重。MFLUX 和 TTS 权重用 preload 下载到用户应用数据目录；LTX 通过本机绝对路径注册。local-services/ 是服务端目录，不会进入此安装包，也不会被这里的代码导入。

安装

当前使用 npm 安装：

npm install --global @cursorblinking/local-connector

仓库开发时可以先打包再从生成的 tarball 安装：

npm pack ./local-connector
npm install --global ./cursorblinking-local-connector-0.2.0.tgz

配对和常驻

在 notes.vectania.com 的“设置 → AI 与外接服务”中生成配对码，然后运行：

cursorblinking pair --code ABCD-EFGH-JKLM
cursorblinking start

pair 默认连接 https://notes.vectania.com。当前 npm 安装方式的 start 是前台进程，需要在使用本机 AI 服务期间保持运行。后续 Homebrew 版本会补充登录后自动运行能力。

连接器即使暂时没有发现 Provider 也会保持在线，并在后续扫描到服务后更新能力，不需要重新配对。

使用本机 Codex

先安装 Codex CLI 并完成登录，然后运行 cursorblinking start。连接器会直接启动受限的 codex app-server 子进程并上报 text.generate 能力；不会启动 local-services/codex-bridge，不会监听额外 HTTP 端口。

Codex 通道使用临时空目录、只读沙箱和 approvalPolicy: never，并禁用 Shell、浏览器、应用、插件、多 Agent 等宿主能力。只有最终文本与 Token 用量会经出站连接回传。

使用本机 Ollama

先安装并启动 Ollama，再确保至少已经下载一个支持 completion 的模型。运行 cursorblinking start 后，连接器会读取 127.0.0.1:11434/api/tags 并把模型以 ollama/<模型名> 上报；只支持 embedding 的模型不会出现在网站中。

ollama pull qwen3:8b
cursorblinking start

然后在“设置 → AI 与外接服务”的“大模型服务”中选择“本机连接器”、当前设备和对应的 ollama/... 模型。生成请求只会从 Local Connector 发往本机 loopback Ollama API；Ollama 端口不需要也不应暴露到公网。Local Connector 不负责安装、启动或下载 Ollama 模型。

安装本机能力

FFmpeg 视频素材处理不需要额外适配服务。只要 ffmpeg、ffprobe 和 libx264 可在命令行中使用，连接器就会自动上报封面、缩略图、胶片条、代理视频和波形图能力：

brew install ffmpeg
cursorblinking doctor

网站处理视频素材时，会优先使用当前账号已配对且在线的本机 Connector。源视频通过任务租约下载并按 SHA-256 缓存，派生产物逐项回传并由服务端复核；本机不可用或处理失败时自动回退服务端。媒体任务使用独立轮询通道，不会阻塞其他本机 AI 能力。

MFLUX 图片生成：

cursorblinking setup mflux
cursorblinking preload mflux

MLX-Audio 语音合成：

cursorblinking setup tts
cursorblinking preload tts

LTX 视频生成使用已经准备好的 Python 与模型目录：

cursorblinking register ltx \
  --python /absolute/path/to/python \
  --models-root /absolute/path/to/models
cursorblinking doctor --deep

再次运行 cursorblinking start 时，管理器会自动启动已经安装或注册的能力。无需用户另外按 Cursor Blinking 的固定 HTTP 接口启动 MFLUX、TTS 或 LTX。

扫描范围

连接器只探测预定义的 loopback 地址，不扫描任意端口，也不读取其他进程的命令行。MFLUX、TTS、LTX 当前分别使用 127.0.0.1:8016、:8000、:8018。可以在每次启动时通过对应环境变量覆盖端口；端口不会固化到默认配对配置，修改后无需重新配对。

LOCAL_IMAGE_PORT=18016 \
LOCAL_TTS_PORT=18000 \
LOCAL_VIDEO_PORT=18018 \
cursorblinking start

只有在 pair 中显式传入 --image-url、--tts-url 或 --video-url 时，地址才会随设备配置保存。旧版配对若保存的是默认地址，也会自动采用当前启动环境中的自定义端口。

Ollama 使用 127.0.0.1:11434；可以通过 OLLAMA_PORT 覆盖端口。连接器只上报 /api/tags 中包含 completion 能力的模型，并将网站文本生成任务转交给 /api/chat。

cursorblinking status
cursorblinking doctor

设备令牌和 Provider 令牌只保存在权限受限的用户应用数据文件中。Provider 仅监听 loopback；不要把这些端口映射到公网。