@jiankarlin/continuum

@jiankarlin/continuum 是 Continuum 的统一用户入口。

它负责四类用户命令：

• continuum start
• continuum stop
• continuum status
• continuum ui
• continuum claude install
• continuum codex
• continuum mna

这层只做交付、安装和启动编排，不承担三大服务的业务实现。

平台支持

当前 continuum start 仅支持 Windows 平台，依赖 winget 和 PowerShell 进行 Docker 安装和进程管理。

其他平台用户请：

• 手动运行各服务（storage、retrieval-runtime、visualization）
• 或使用 Docker Compose 自行编排

命令说明

• continuum start 会拉起 Continuum 自己管理的单一 Docker 容器
• 容器内部统一运行 PostgreSQL + pgvector、storage、storage worker、retrieval-runtime、visualization
• 数据库使用 Continuum 自己的容器和默认端口 54329，不会直接占用用户已有 PostgreSQL 实例
• 向量检索直接连接用户提供的第三方 OpenAI-compatible embeddings API
• 默认绑定到 127.0.0.1（仅本机访问），可通过 --bind-host 0.0.0.0 允许局域网访问
• continuum stop 停止并移除 managed 容器，清理状态文件
• continuum start 会在 stack 就绪后再启动 memory-native-agent
• continuum mna 用来单独安装、启动、停止、查看日志和读取 token
• continuum ui 会优先连接已经通过 continuum start 启动好的页面；如果本地没有运行中的页面，才回退到包内自带的可视化产物

第三方向量配置

continuum start 启动前，需要先提供下面两个必填项：

• EMBEDDING_BASE_URL
• EMBEDDING_MODEL

如果服务端需要鉴权，再补：

• EMBEDDING_API_KEY

示例：

$env:EMBEDDING_BASE_URL="https://api.openai.com/v1"
$env:EMBEDDING_MODEL="text-embedding-3-small"
$env:EMBEDDING_API_KEY="your-key"
continuum start

也可以通过参数直接传入：

continuum start --embedding-base-url https://api.openai.com/v1 --embedding-model text-embedding-3-small

安全说明

默认情况下，所有服务端口绑定到 127.0.0.1，仅本机可访问。如果需要局域网内其他设备访问（如手机测试），可以使用：

continuum start --bind-host 0.0.0.0

注意：使用 0.0.0.0 会将服务暴露到局域网，请确保在可信网络环境下使用。

continuum mna

可直接单独操作 memory-native-agent：

continuum mna install
continuum mna start
continuum mna stop
continuum mna logs
continuum mna token

默认地址是 http://127.0.0.1:4193，默认数据目录是 ~/.mna。