用途:引导 KAIROS 的首次安装(bootstrap、环境搭建)与维护更新(Docker 或 npm CLI 刷新、版本升级),以技能包内置的 references 文档为运行时权威来源。
主要能力:按顺序读取内置安装索引、前置条件、简单栈与 CLI 文档;审计 Docker、Docker Compose v2、Node.js 24+、kairos CLI 或 npx、可写 .env、Ollama(仅选该后端时)等前置条件;在用户批准后安装缺失组件;默认推荐简单 Docker Compose 栈,仅在用户明确要求时使用含 Redis、Postgres、Keycloak 的高级全栈;指导嵌入后端(OpenAI、Ollama、TEI)选择与 .env 生成;启动并验证服务;按需引导 CLI 认证;通过 npx skills add debian777/kairos-mcp 同步仓库技能。
使用方式:CLI 全局安装用 npm install -g @debian777/kairos-mcp,随后 kairos --help;拒绝全局安装时用 npx @debian777/kairos-mcp --help。Compose v2 用 docker compose version 验证。启动前确认端口空闲,默认 app 3000、Qdrant 6333/6344、metrics 9090,然后 docker compose -p kairos-mcp up -d,并用 curl -sS "http://localhost:${PORT:-3000}/health" 验证;失败时查看 docker compose -p kairos-mcp logs app-prod。认证可用 kairos login、kairos login --no-browser、kairos token --validate,或设置 KAIROS_API_URL。
适用场景:首次部署、环境更新、CLI 与仓库技能维护。
限制:不得在未获用户确认时选择嵌入后端或模型、安装软件、覆盖 .env、拉取模型或启动容器;不得编造密钥或要求用户在对话中粘贴真实密钥;不得把 Keycloak 或身份提供方配置当作标准安装流程;不得用聊天模型做嵌入;TEI 路径仅在用户已有可达服务时使用,本技能不负责部署 TEI;Docker、Node.js、Ollama 安装须走官方厂商页面,不自行编造命令。