灵犀指IDE
中 / EN免费开始
文档中心
参考与 FAQ / 内核 API

内核 API

灵犀指的 AI 能力由本地 Rust 内核提供。内核默认监听 127.0.0.1:3721——仅绑定本机回环地址，不对外暴露；端口被占用时自动递增尝试（最多 10 个）并写回配置。内核启动时会输出实际端口与访问令牌（token），IDE 凭令牌调用以下 HTTP 端点。

健康检查查看版本
curl http://127.0.0.1:3721/health

健康与元信息

MethodPath说明
GET/health健康检查（/api/health 等价）
GET/api/version内核版本号
GET/api/models当前可用模型列表
GET/api/capabilities内核能力声明

对话与 Agent

MethodPath说明
POST/api/chat单次对话
POST/api/chat/stream流式对话（SSE）
POST/api/vision多模态对话（图片输入）
POST/api/agent/chatAgent 对话（SSE）
POST/api/agent/inline-edit内联编辑（SSE，:kbdCtrl + K）
POST/api/agent/confirm危险操作确认回执
POST/api/react/streamReAct 引擎流式执行
POST/api/effort/set · GET /api/effort/get设置 / 查询思考强度

RUSH 深度任务

MethodPath说明
POST/api/rush/start启动 RUSH 任务（SSE 推送阶段事件）
POST/api/rush/pause暂停任务
POST/api/rush/resume恢复任务
POST/api/rush/stop终止任务

补全与语言服务

MethodPath说明
POST/api/fim/completeFIM 智能补全（Fill-In-the-Middle）
POST/api/lsp/completionsLSP 补全
POST/api/lsp/diagnostics诊断信息
POST/api/lsp/definition定义跳转
POST/api/lsp/hover悬浮提示
GET/api/lsp/health语言服务健康状态

代码图谱与任务

MethodPath说明
POST/api/index建立 / 更新项目索引
POST/api/index/status索引进度查询
POST/api/search语义代码搜索
POST/api/task/create · /api/task/list · /api/task/status后台任务创建 / 列表 / 状态更新
POST/api/memory/store · /api/memory/search持久化记忆写入 / 检索
GET/api/mcp/list-servers · POST /api/mcp/call-toolMCP 服务列表 / 工具调用
POST/api/fs/read · /api/fs/write · /api/fs/exec · /api/fs/search文件读写 / 命令执行 / 内容搜索
POST/api/terminal/stream · /api/terminal/cancel终端输出流 / 取消命令
GET/ws · /ws/{session_id}WebSocket 事件通道

本地代理 /local/*

IDE 登录态相关的云端接口由内核统一代理转发，其中 /local/auth/*（登录、注册、发送验证码、重置密码）与 /local/plans、/local/llm-models、/local/llm-vendors 为公开端点；/local/subscription、/local/usage、/local/keys、/local/user-llm-config、/local/rush/* 等受 License 门禁保护。

!

仅供本机调用：内核只监听 127.0.0.1，请勿通过防火墙或端口转发将其暴露到局域网；也不要手动结束内核进程——AI 对话、补全与配额查询都会随之中断，重启 IDE 即可恢复。

✦

排障第一步：AI 功能无响应时，先 curl http://127.0.0.1:3721/health 确认内核是否就绪；连接失败通常重启 IDE 即可解决。更多问题见常见问题。

下一步

← 上一篇配置项