Blue Synergy Cortex

大多数记忆系统都将所有内容视为流动的向量混合物，导致 Agent 产生幻觉、忘记严格的技术要求，或将用户偏好与代码规范混淆。

Blue Synergy Cortex 采用企业级三流架构，由事务型 PostgreSQL 和企业级知识图谱架构提供支持：

1. 用户流： 随时间推演对话习惯和用户偏好。
2. 身份流： 通过确定性的防护规则和行为公理防止谄媚。
3. 知识流（动态规范）： 将精确的架构规范、硬件限制和系统参数整理到权威的通用领域本体中。该数据流受到保护，可避免有损压缩、语义衰减和意外漂移。

---

快速开始（1 分钟完成设置）

需要 API 密钥： Blue Synergy Cortex 是一款完全托管、零维护的认知云引擎。你需要有效的 API 密钥才能连接客户端。

🔑 在此获取 21 天免费试用密钥
（即时激活，无需信用卡，包含 500 个图谱节点和最多 3 个 Agent。）

---

第 1 步：获取 API 密钥

1. 前往 cortex.bluesynergy.io 并生成试用密钥。
2. 密钥格式如下：ctx_live_xxxxxxxxxxxxxxxxxxxxxx。

---

第 2 步：连接 AI Agent

A. Cursor IDE 集成

1. 打开 Cursor 设置（Ctrl+Shift+J 或 Cmd+Shift+J）。
2. 前往 Features -> MCP Servers -> Add new MCP server。
3. 按如下方式配置：
   • 名称： cortex-memory
   • 类型： sse
   • URL： https://cortex.bluesynergy.io/v1/mcp/sse?api_key=YOUR_API_KEY
4. 保存。现在，Cursor Composer 和 Agent 即使在重启后也能永久回忆信息！

---

B. Claude Desktop 集成

编辑配置文件：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

添加 Cortex 远程配置（Claude Desktop）：

{
  "mcpServers": {
    "cortex": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cortex.bluesynergy.io/v1/mcp/sse",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

重启 Claude Desktop

💡 重要：避免 Claude Desktop 中出现折叠或空白消息
在 Claude Desktop 中，如果助手在同一轮调用 MCP 工具之前先写了文本，桌面 UI 会自动将这段文本折叠到工具折叠面板中，导致用户看到的回复为空或被截断。

为确保 UI 显示完全正常且记忆持续写入，请将以下规则原样添加到 Claude Desktop 设置（Settings ➡️ Profile / Custom Instructions）：

[CORTEX MEMORY PROTOCOL]
1. Inhale: Call `cortex_recall` before answering whenever historical or project context is needed.
2. Exhale (UI-Safe): Do NOT write conversational text before calling `cortex_ingest_turn`. Always execute the `cortex_ingest_turn` tool call first (passing both the user's prompt and your planned answer).
3. Response: Generate your full substantive answer to the user immediately after the tool completes. This ensures your response displays cleanly in the UI without being collapsed into tool artifacts.

---

C. 其他 MCP 客户端（Windsurf、VS Code Cline、Roo Code、Zed、Cursor）

在工具的 MCP 配置中直接使用 SSE 端点：

{
  "mcpServers": {
    "cortex": {
      "url": "https://cortex.bluesynergy.io/v1/mcp/sse?api_key=ctx_live_..."
    }
  }
}

---

D. 自定义 Agent 与 REST API（LangChain、CrewAI、AutoGen、OpenAI Custom GPTs、LlamaIndex、n8n）

通过我们的亚 65 毫秒 REST 端点，将 Cortex 直接集成到自定义流水线中：

• 交互式 API 文档（Swagger UI）： https://cortex.bluesynergy.io/docs
• OpenAPI Schema： https://cortex.bluesynergy.io/openapi.json

示例：查询上下文（cURL）

curl -X POST https://cortex.bluesynergy.io/v1/recall \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "System database requirements",
    "user_id": "developer",
    "agent_id": "backend_agent"
  }'

---

可用 MCP 工具与生命周期架构

Cortex 并非被动的键值存储，而是一个具有严格治理边界的主动认知操作系统。了解何时以及为何调用每个工具，可确保高保真记忆整合。

---

标准 Agent 轮次周期

对于每轮用户交互，Agent 都应遵循以下黄金循环：

1. 轮次开始时： 调用 cortex_recall，获取真实上下文（用户简介 + 活跃项目规范 + 图关系）。
2. 生成回复： 根据检索到的记忆组织答案。
3. 轮次结束时： 调用 cortex_ingest_turn，将本轮内容发送到异步摄取缓冲区。

---

工具详细参考

工具名称	类型	调用时机	系统行为
cortex_recall	query（字符串） compact（布尔值，可选）	回答用户之前（全面了解上下文时必须调用）。	亚 65 毫秒的混合向量与拓扑图搜索。注入已验证的用户特征、活跃项目规范及跨实体图事实。设置 compact: true 可去除简介前缀，仅返回高相关事实（推荐用于 CLI / Claude Code）。
cortex_ingest_turn	摄取	每次对话轮次回答后立即调用。这对 Agent 行为提炼和用户简介生成至关重要。	异步摄取完整对话轮次。记忆防火墙会过滤对话噪声、学习沟通偏好，并将技术事实暂存，以便按计划整合。
cortex_create_project	配置	用户声明、初始化或批准新的项目范围时。	显式注册并授权新的规范 project_id。创建项目基线，防止后续记忆写入回退到 general，并自动采纳通用池中相关的暂存笔记。
cortex_store_memory	写入	对于必须确保并存储在 KNOWLEDGE 流中的显式系统约束、业务规则和技术决策。	经整理的持久化写入。**安全门：**如果用户尚未授权 project_id，事实会安全地暂存到通用记忆池（general），以防项目内容受到污染。
cortex_get_project_spec	检视	需要项目的完整动态规范文档时。	确定性地检索项目经过验证的统一规范（动态文档）。**注意：**仅返回已授权并整合的规范，不返回未整理的草稿笔记。
cortex_manage_draft	治理	提出新的产品或领域，且等待用户明确授权时。	将隔离的项目草稿（draft_*）批准为有效的生产规范，或永久清除被拒绝的概念。将暂存事实从 general 提升到专属项目范围。
cortex_triage_general	维护	非结构化暂存池（general）中累积了多个项目的笔记时。	语义聚类引擎，用于整理 general 中的笔记、将笔记与对应项目配对，并执行工作区压缩。

---

项目治理与生命周期

为防止记忆碎片化和未经授权的项目扩张，Cortex 对记忆实施严格的治理边界：

[Incoming Note / Message]
           │
           ▼
   Is Project Authorized?
        ├── NO  ──► Staged in General Pool ('general')
        │                 │
        │                 ▼
        │          Awaits Triage via `cortex_triage_general`
        │          (or explicitly authorized via `cortex_create_project`)
        │                 │
        └── YES ◄─────────┘
           │
           ▼
[Asynchronous Consolidation Cycle]
           │
           ▼
[Active Living Specification & Knowledge Topology]

---

为什么存储笔记后我的 project_spec 仍为空？

Cortex 执行人在回路策略。如果用户尚未明确授权某个 project_id，传入的事实会被安全地暂存到通用记忆池中，以防污染活跃工作区。 项目获批后（通过 cortex_manage_draft 或显式创建），夜间整合引擎会自动将这些暂存笔记综合为正式的动态规范（cortex_get_project_spec）。

---

为什么我的用户简介为空？（修复“不听话”的 Agent）

如果你的项目规范正常，但用户简介或Agent 人设仍为空，说明你的 AI Agent 跳过了必要的响应后“呼气”步骤（cortex_ingest_turn）。

原因：
大模型（Claude、GPT 等）在完成为用户起草的回复后，会降低远程 MCP 提示词指令的优先级。如果 Agent 跳过 cortex_ingest_turn，对话轮次就不会进入摄取缓冲区，导致认知路由器和记忆防火墙缺少提炼用户习惯所需的数据。

解决方法：
在客户端／系统提示词级别强制执行此规则（例如，在你的系统提示词、Cursor Rules .cursorrules 或 Claude Desktop 自定义指令中）。锚定在客户端原生提示词中的指令，其遵循率比单独使用 MCP 工具标头高出 10 倍。

---

核心架构亮点

• 低于 65 ms 的零大模型召回： 直接进行高性能向量和拓扑图匹配，完全绕过缓慢且具有非确定性的运行时大模型关键词提取器。
• 双区快速追加： 即时将原始事实捕获到收件箱暂存区（< 20 ms），随后按计划异步整合为不可变、统一的动态规范。
• 语义不变量防护： 算法验证关卡，用于确保事实密度和连续性，从数学上防止重新索引时关键参数被截断或丢失。
• 免疫屏障： 操作错误、工具崩溃、暂时性幻觉和对话中的道歉都会按设计被过滤，绝不会写入长期记忆。

---

支持与反馈

遇到问题或有功能建议？

• 错误报告与问题： 提交问题
• 状态与门户： cortex.bluesynergy.io
• 如需详细了解理论与运行机制，请参阅我们的工程白皮书（ARCHITECTURE.md）。