@fozikio/皮质引擎
](https://www.npmjs.com/package/@fozikio/cortex-engine) ](https://www.npmjs.com/package/@fozikio/cortex-engine) ](https://github.com/Fozikio/cortex-engine/stargazers) 
AI代理的持久内存。开源，LLM无关，适用于任何MCP客户端。
星迹
它的作用
大多数AI代理在会话结束时会忘记一切。 cortex-engine 修复了这个问题——它为代理提供了一个持久的内存层，可以在会话、模型和运行时中生存。
- 语义记忆 --将观察结果、信念、问题和假设作为相互关联的节点进行存储和检索
- 信念追踪 --当新的证据与代理人的立场相矛盾时，代理人的立场会更新
- 两阶段梦想巩固 --NREM压缩（聚类、细化、创建）+REM整合（连接、评分、抽象）——以生物睡眠阶段为模型
- 目标导向认知 —
goal_set创建所需的未来状态，产生前向预测误差，将整合和探索偏向于重要的方面 - 基于神经科学的检索 --GNN邻域聚合、查询条件传播激活、多锚千脑投票、认知觅食
- 信息几何 --考虑嵌入空间曲率、模式一致性评分的局部自适应聚类阈值
- 绘制健康指标图 --Fiedler值（代数连通性）衡量知识整合；PE饱和度检测可防止身份模型僵化
- 间隔重复（FSRS） --具有固结状态依赖衰减曲线的区间感知调度
- 嵌入 --可插拔提供者（内置、OpenAI、Vertex AI、Ollama）——默认情况下不需要外部服务
- 法学硕士不可知论 -可插拔LLM提供商：Ollama（免费/本地）、Gemini、Kimi（Moonshot AI）、DeepSeek、Hugging Face、OpenRouter、OpenAI或任何与OpenAI兼容的API
- 长期背景下的梦想巩固 --set
strategy: long-context在单个大型LLM过程中运行边缘发现和抽象，而不是N²成对调用；顺序方法忽略的曲面传递模式和跨域连接 - 代理人派遣 —
agent_invoke让您的代理使用任何配置的LLM生成廉价的、感知皮层的子任务。知识在不同的课程中复合。 - MCP服务器 --57种认知工具(
query,observe,believe,wander,dream,goal_set,agent_invoke,thread_create,journal_write,evolve等等）通过模型上下文协议
结果：个性和专业知识来自积累的经验，而不是系统提示。一个对分布式系统有200个观察结果的代理不需要被告知“你关心分布式系统”。它只知道。
适用于Claude Code、Cursor、Windsurf或任何兼容MCP的客户端。在本地（SQLite）或云端（Firestore+cloud Run）运行。
安全
该引擎包括对部署环境的深度防御保护：
- 定时安全认证 --REST服务器身份验证使用
crypto.timingSafeEqual防止定时侧信道攻击 - 插件沙盒 --插件加载器根据受信任的目录验证导入路径，阻止来自不受信任位置的加载
- REST工具块列表 --破坏性工具(
forget,dream,evolve,resolve,thread_resolve)被阻止访问通用REST端点；它们仍然可以通过MCP直接访问代理 - SQLite注入预防 --命名空间名称已验证（仅限字母数字），LIMIT子句已参数化
- 防止秘密泄露 -当API键出现在配置文件中而不是环境变量中时，配置加载器发出警告
建筑
| 模块 | 角色 |
|---|---|
core | 基础类型、配置和共享实用程序 |
engines | 认知处理：记忆巩固、FSRS、图遍历 |
stores | 持久层——SQLite（本地）和Firestore（云） |
tools | 所有57个认知工具实现（每个工具一个文件） |
mcp | MCP服务器、工具注册表和插件加载器 |
cognitive | 高阶认知操作（做梦、漫游、验证） |
triggers | 计划触发和事件驱动触发 |
bridges | 用于外部服务和API的适配器 |
providers | 嵌入和LLM提供者实现 |
bin | 入口点： serve.js （HTTP+MCP）， cli.js （管理员CLI） |
public | 内置网络仪表板（自动提供 --rest) |
快速开始
npm install @fozikio/cortex-engine
npx fozikio init my-agent
cd my-agent
npx fozikio serve # starts MCP server你的代理人现在有57个认知工具。生成的 .mcp.json 是版本固定和平台感知的（Windows cmd /c 包装自动处理）。
看 快速开始 完整的5分钟设置的wiki页面。
多Agent
npx fozikio agent add researcher --description "Research agent"
npx fozikio agent add trader --description "Trading signals"
npx fozikio agent generate-mcp # writes .mcp.json with scoped servers每个代理通过命名空间获得隔离内存。看 建筑 维基页面了解详情。
代理优先设置
最快的路径：在空目录中打开一个AI代理，然后说 *“设置一个皮质工作区。”* 代理人跑 npx fozikio init，读取生成的文件，并立即开始工作。看 安装 完整指南的wiki页面。
仪表盘
cortex引擎附带了一个内置的web仪表板。启动REST服务器并在浏览器中打开URL：
npx fozikio serve --rest --port 3000
# open http://localhost:3000仪表板显示代理的统计数据、线程、操作日志、内存、概念和观察结果，无需单独安装。它从相同的来源自动检测其API。
如果启用了身份验证(CORTEX_API_TOKEN)，仪表板加载时不使用auth，但API调用需要令牌。通过本地存储进行设置：
localStorage.setItem("cortex-settings", JSON.stringify({ token: "your-token" }));来源： fozikio仪表板
命令行界面
npx fozikio serve # start MCP server
npx fozikio health # memory health report
npx fozikio vitals # behavioral vitals and prediction error
npx fozikio wander # walk through the memory graph
npx fozikio wander --from "auth" # seeded walk from a topic
npx fozikio maintain fix # scan and repair data issues
npx fozikio report # weekly quality report发展
npm run dev # tsc --watch
npm test # vitest run
npm run test:watch环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
CORTEX_API_TOKEN | 可选 | 由 cortex-telemetry 钩子将检索反馈发送到皮层API。不需要运行MCP服务器。 |
MOONSHOT_API_KEY | 可选 | 需要时 llm: kimi 已设置。从以下位置获取一个 platform.moonshot.cn. |
OPENAI_API_KEY | 可选 | 需要时 llm: openai 设置，或者在使用任何不带显式API密钥的OpenAI兼容提供程序时。 |
根据您启用的提供程序（Firestore、Vertex AI等），需要其他变量。看 docs/ 用于特定于提供商的配置。
规则、技能和代理人
fozikio init 从中自动安装安全规则、技能和代理定义 fozikio.json 清单到目标工作区。
安全规则（反射）
皮质发动机配备 反射 规则——基于YAML的可移植护栏，适用于任何代理运行时，而不仅仅是Claude Code。
| 规则 | 事件 | 它的作用 |
|---|---|---|
cognitive-grounding | prompt_submit | 用手势示意特工打电话 query() 在评估、设计、审查或创作工作之前 |
observe-first | file_write / file_edit | 如果写入内存目录而不调用，则发出警告 observe() 或 query() 首先 |
note-about-doing | prompt_submit | 建议用以下方式捕捉新的思路 thread_create() |
规则活在 reflex-rules/ 作为标准的Reflex YAML。它们是可移植的——与Claude Code、Cursor、Codex或任何带有Reflex适配器的运行时一起使用。看 @fozikio/反射 用于完整的规则格式和层执行。
Claude Code用户 还可以获得特定于平台的钩子（in hooks/)用于遥测、会话生命周期和项目板门控。这些是运行时适配器，而不是规则——它们处理声明性规则格式没有涵盖的副作用。
要自定义，请执行以下操作： 直接编辑YAML规则文件，或设置 allow_disable: true 并通过Reflex配置禁用它们。
技能
技能是代理可以通过以下方式使用的可调用工作流 /skill-name.
| 技能 | 何时使用 | 它提供了什么 |
|---|---|---|
cortex-memory | 查询、记录和审查工作 | 全内存工作流——查询/观察模式、信念跟踪、基于内存的代码审查、会话模式 |
代理
| 代理 | 描述 |
|---|---|
cortex-researcher | 在外部来源之前查询大脑皮层的深度研究代理，将新发现带回记忆 |
自动安装的工作原理
fozikio init读取fozikio.json从包根- 将钩子、技能和Reflex规则复制到目标工作区
- 丢失的源文件会被跳过并发出警告——init永远不会因为丢失资产而失败
内置功能（v1.0.0+）
从v1.0.0开始，所有57个认知工具都内置在cortex引擎核心中，不需要单独安装插件。以前它们是分开的 @fozikio/tools-* 包装；它们已经被发动机吸收了。
| 能力 | 工具 |
|---|---|
| 记忆 | observe, query, recall, wander, forget, retrieve |
| 信仰与推理 | believe, belief, contradict, speculate, validate, predict |
| 线程 | thread_create, thread_update, thread_resolve, threads_list |
| 日志记录 | journal_write, journal_read |
| 身份 | evolve, evolution_list |
| 社交 | social_read, social_update, social_draft, social_score |
| 图 | neighbors, suggest_links, suggest_tags, link, graph_report |
| 维护 | dream, digest, reflect, find_duplicates, retrieval_audit, consolidation_status |
| 生命体征 | vitals_get, vitals_set, sleep_pressure |
| 推理 | surface, ruminate, notice, intention, resolve |
| 内容 | content_create, content_list, content_update |
| 运维 | ops_append, ops_query, ops_update |
| 目标 | goal_set |
| 代理 | agent_invoke |
| 统计 | stats |
插件系统仍然可用于自定义扩展——请参阅 插件文档.
文档
社区
- r/物理学 --项目子版块
- --问题、反馈、展示你所构建的内容
- “我为我的认知系统构建了44个MCP工具” --r/mcp深度潜水（84票赞成，27条评论）
- “给了我的经纪人一个潜意识” --r/clawdbot演练（22票赞成，34条评论）
相关项目
- @fozikio/反射 --代理人的便携式安全护栏。规则是数据，而不是代码。
- 叹息 --代理控制表面。信号和手势，而不是对话。
- fozikio.com --文件和指南
许可证
麻省理工学院——见 许可证