参考与 FAQ / 内核 API
内核 API
灵犀指的 AI 能力由本地 Rust 内核提供。默认绑定回环地址，也可配置 LAN 访问；端口动态确定，请读取实际连接信息。下文为 Bash 示例，请先将 LINGXIZHI_API_BASE 设为含协议的实际内核地址，并按端点要求携带访问令牌。不要分享令牌或向公网暴露内核。
健康检查查看版本
curl "${LINGXIZHI_API_BASE:?请设置实际内核地址}/health"
健康与元信息
| Method | Path | 说明 |
|---|---|---|
| GET | /health | 健康检查（/api/health 等价） |
| GET | /api/version | 内核版本号 |
| GET | /api/models | 当前可用模型列表 |
| GET | /api/capabilities | 内核能力声明 |
对话与 Agent
| Method | Path | 说明 |
|---|---|---|
| POST | /api/chat | 单次对话 |
| POST | /api/chat/stream | 流式对话（SSE） |
| POST | /api/vision | 多模态对话（图片输入） |
| POST | /api/agent/chat | Agent 对话（SSE） |
| POST | /api/agent/inline-edit | 内联编辑（SSE，:kbdCtrl + K） |
| POST | /api/agent/confirm | 危险操作确认回执 |
| POST | /api/react/stream | ReAct 引擎流式执行 |
| POST | /api/effort/set · GET /api/effort/get | 设置 / 查询思考强度 |
RUSH 深度任务
| Method | Path | 说明 |
|---|---|---|
| POST | /api/rush/start | 启动 RUSH 任务（SSE 推送阶段事件） |
| POST | /api/rush/pause | 暂停任务 |
| POST | /api/rush/resume | 恢复任务 |
| POST | /api/rush/stop | 终止任务 |
| POST | /api/rush/ask-user/respond | 响应计划审批或任务询问 |
补全与语言服务
| Method | Path | 说明 |
|---|---|---|
| POST | /api/fim/complete | FIM 智能补全（Fill-In-the-Middle） |
| POST | /api/lsp/completions | LSP 补全 |
| POST | /api/lsp/diagnostics | 诊断信息 |
| POST | /api/lsp/definition | 定义跳转 |
| POST | /api/lsp/hover | 悬浮提示 |
| GET | /api/lsp/health | 语言服务健康状态 |
代码图谱与任务
| Method | Path | 说明 |
|---|---|---|
| POST | /api/index | 建立 / 更新项目索引 |
| POST | /api/index/status | 索引进度查询 |
| POST | /api/search | 语义代码搜索 |
| POST | /api/index/symbols/build | 触发符号索引后台全量重建（立即返回 task_id，幂等） |
| GET | /api/index/symbols/status | 符号索引计数（symbols / references / relations）与构建状态 |
| GET | /api/index/symbols/callers | 查询符号的调用方（谁调用了它） |
| GET | /api/index/symbols/callees | 查询符号的被调用方（它调用了谁） |
| GET | /api/index/symbols/implementations | 查询索引中记录的接口 / trait 实现 |
| GET | /api/index/symbols/dependencies | 查询模块的下游依赖 |
| POST | /api/task/create · /api/task/list · /api/task/status | 后台任务创建 / 列表 / 状态更新 |
| POST | /api/memory/store · /api/memory/search | 持久化记忆写入 / 检索 |
| GET | /api/mcp/list-servers · GET /api/mcp/list-tools | MCP 服务 / 工具列表 |
| POST | /api/mcp/call-tool · POST /api/mcp/reload | 工具调用 / 重载 MCP 配置 |
| POST | /api/dap/start · /api/dap/stop | 启动 / 停止调试会话 |
| GET | /api/dap/status · /api/dap/breakpoints | 调试状态 / 断点查询 |
| POST | /api/dap/step · /api/dap/stack · /api/dap/scopes · /api/dap/variables · /api/dap/evaluate | 调试控制与变量查询 |
| 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 事件通道 |
DAP 调试使用 /api/dap/*；/api/debug/* 属于 AI 调试模式，不是 DAP 端点的别名。调试运行时及适配器需自行安装。
符号图谱查询结果仅覆盖已索引的关系。查询端点均以查询串携带 project_root（关系查询另需 symbol）；返回 relations 数组的每行含源/目标符号、关系类型（calls / implements / depends_on 等）与源文件行号。详见语义代码图谱。
本地代理 /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 门禁保护。
!
访问控制：默认回环绑定可减少网络暴露。启用 LAN 时检查绑定地址、认证、允许来源及防火墙规则，勿转发到公网。结束内核会中断相关功能，恢复时检查进程与连接状态。
✦
排障第一步：AI 功能无响应时，用实际连接地址调用 /health，再检查内核进程、端口、访问凭据与日志。重启不能保证解决依赖或配置错误。更多问题见常见问题。
下一步
本文对你有帮助吗？