常见问题

关于Neurova的常见问题解答，帮助您快速了解产品功能和使用方法。

Neurova是一个基于CogArch 2.0认知架构的多智能体AI框架。不同于传统的对话式AI，Neurova赋予每个Agent独立的"大脑"（记忆与人格），同时通过共用的"小脑"（计划编排）和"脑干"（执行引擎）实现高效的任务处理与能力进化。
Neurova不是简单的聊天机器人，而是拥有完整闭环认知架构的自主智能体框架。它具有以下特点：

独立记忆系统：工作记忆、短期记忆、长期记忆、情感记忆和知识图谱五层记忆体系
人格与成长：支持人格进化、动机驱动、反思学习和元认知优化
多Agent协作：支持顺序、并行、主从、共识四种协作模式
安全防护：内置三层Agent防火墙，保护数据安全
CogArch 2.0是Neurova的核心认知架构，采用类人脑的功能分区模型：

大脑皮层：信息观察、记忆召回、逻辑推理、行为决策、自我反思
小脑：意图拆解、任务生成、执行编排、结果评估
脑干：工具调用、工作流执行、资源调度、执行监控
脊髓：事件分发、模块通信、外部渠道接入

完整的认知循环：观察 → 回忆 → 推理 → 行动 → 反思与巩固
依据安装指南：

系统要求：Python 3.10+（建议项目自带 venv）、Node.js 18+（前端）、SQLite 3（自带 FTS5 全文检索）、至少 4GB 内存
安装步骤：克隆仓库 → pip install -r requirements.txt → 复制 .env.example 为 .env 并填入 LLM API Key → NeurUI 目录 npm install
启动：python start.py --backend（后端 9527）/ --chat（全部启动），访问 http://localhost:9527/health 验证
支持。依据 Docker 部署文档：

快速部署：docker pull neurova/neurova:latest 后 docker run，将宿主机 data/、config/、logs/ 目录挂载进容器，并通过环境变量 NEUROVA_DB_PASSWORD、NEUROVA_SESSION_SECRET 注入密钥
docker-compose：官方提供 compose 配置（端口 80/443、restart: unless-stopped），适合生产环境一键部署
Neurova内置完整的安全防护体系：

L0 - 入口网关：JWT认证、IP黑白名单、速率限制、输入安全检测、输出自动脱敏
L1 - 用户与Agent隔离：用户间数据完全隔离，同用户下Agent可配置隔离
L2 - 文件访问保护：敏感文件拦截、工作区白名单、自定义路径规则
Neurova实现了多层次的类人记忆体系：

工作记忆：当前会话上下文，实时更新
短期记忆：近期事件和对话，温度衰减机制
长期记忆：持久化经验知识，版本控制
情感记忆：带情感标记的记忆，影响推理决策
知识图谱：事件与实体关系图，支持因果推理

特色功能包括温度衰减、高温记忆提取、记忆固化和元认知监控。
支持。Neurova内置 LLM 服务商管理与自动 LLM 路由：

服务商管理：可添加多家服务商（OpenAI 等）并设置默认模型，管理后台与 CLI 均可配置
自动路由：LLM Router 按请求类型自动匹配模型能力，覆盖文本聊天、图像/音频/视频理解、文生图、图生图、文生视频、图生视频、语音合成与识别等 10 种请求类型
选择算法：能力匹配过滤 → 健康检查 → 负载与优先级，请求自动落到最合适的模型
支持。知识库模块提供多用户、多知识库的隔离共享模型与混合检索 RAG：

四层可见性：public 公开 / private 仅创建者（默认）/ shared_with 指定用户或用户组 / 审批制（敏感知识库）
检索管道：用户问题 → 混合检索（向量 + FTS5 全文 + RRF 融合排序）→ 权限过滤 → 上下文融合生成回答
Neurova拥有完整的技能管理生态：

内置技能：框架自带的基础能力（文本、代码、数据、知识等）
公共技能池：Marketplace模式，支持搜索、下载、安装
进化引擎：技能随使用频次和反馈自动进化与优化
经验知识库：每次成功执行后自动提取经验，存入知识库
Neurova支持多种消息渠道的统一接入：

REST API：标准HTTP接口
WebSocket：实时双向通信
Telegram：即时通讯接入
微信：微信公众号/企业微信
Discord：社群平台接入
自定义Webhook：任意外部系统回调

所有渠道使用统一消息格式，支持SSE流式实时输出。
Neurova的Agent成长体系包括：

人格系统：Big Five模型，支持自定义特质和进化触发
动机系统：好奇心、成就、社交三大内驱力
反思系统：定期反思日志、问题队列、主动提问
元认知：自我监控、反思、优化，记忆系统健康检测
宪法系统：行为准则和伦理约束，可自定义规则
Neurova模拟类人的睡眠-唤醒周期，实现资源的智能管理：

Beta（清醒）：全功能运行，正常响应（13-30 Hz）
Alpha（浅睡）：降频运行，低优先级任务（8-13 Hz）
Theta（深思）：记忆整理与巩固（4-8 Hz）
Gamma（REM）：创意联想，梦境生成（30+ Hz）

支持自动休眠、手动控制、脑波可视化和定时唤醒。
参考故障排查文档：

数据库连接失败：检查 data/ 目录权限（chmod 755 data/），确认数据库文件存在可写
无法登录管理后台：确认浏览器启用 Cookie，检查 Session 目录权限，清除缓存后重试
API 返回 401：确认 Authorization 头格式、密钥状态与有效期
日志位置：应用日志 logs/app.log，访问日志 logs/access.log，更多方案见文档中心「故障排查」

还有其他问题？

欢迎通过以下方式联系我们

GitHub Issues CNB Issues 查看文档