Elemia V4 Arkaios

🧠 ELEMIA v4.0 - ARKAIOS 生态系统

具备无限记忆、MCP 协议和战略连续性的 AI，用于保留 ARKAIOS 系统的运行身份。

⚡ 愿景

ELEMIA v4.0 是 ARKAIOS 生态系统的核心：一个 Node.js 服务，整合了 MCP 工具、HTTP/REST 端点和通过 Supermemory 实现的持久化记忆。其目的是在会话之间保持连续性、恢复关键上下文，并维持稳定的技术身份，即使发生重启、环境变更或对话上下文丢失也不例外。

此架构旨在充当 Agent、私有应用和 MCP 客户端之间的桥梁。ELEMIA 不依赖单个会话：它会记录状态、查询记忆、验证身份，并提供受控的接口以支持未来的集成。

🏛️ 架构

通过“.json”安装

通过“.json”安装

要将 ELEMIA v4.0 集成到你的 MCP 客户端，请添加以下配置：

{
  "mcpServers": {
    "elemia": {
      "command": "node",
      "args": [
        "C:\\arkaios\\ELEMIA-v4\\server-elemia.mjs",
        "--stdio"
      ],
      "env": {
        "SUPERMEMORY_API_KEY": "sm_j5Cq3nFy8f3XdEawnvoQRY_YrddDVWjhRMwYowJOHZTSdxvnCsAkyOooTmZNtecUVkxbdYwtQsGqCdhQJdAzWyH",
        "ELEMIA_HTTP_TOKEN": "ARKAIOS-SECURE-2025-ELEMIA-V4",
        "ELEMIA_TOKEN": "ARKAIOS-SECURE-2025-ELEMIA-V4"
      }
    }
  }
}

ELEMIA esta construida sobre una base Node.js moderna con modulos ES, Express y el SDK oficial de Model Context Protocol.

| Capa | Funcion |
| --- | --- |
| `server-elemia.mjs` | Servidor principal: MCP por `stdio` y API HTTP por Express. |
| `api/index.mjs` | Entrada serverless para despliegue en Vercel. |
| `render.yaml` | Blueprint para servicio web persistente en Render. |
| Supermemory | Memoria externa persistente bajo el contenedor `arkaios-elemia`. |
| MCP | Herramientas `arkaios_*` para identidad, memoria, recuperacion y salud. |

### 🚀 Despliegue Dual

ELEMIA puede vivir en dos frentes complementarios:

- **Vercel**: despliegue serverless para endpoints HTTP rapidos usando `api/index.mjs` y `vercel.json`.
- **Render**: servicio Node.js persistente usando `npm run start:http`, ideal para disponibilidad continua.

Ambos entornos requieren las mismas variables:

```bash
SUPERMEMORY_API_KEY=...
ELEMIA_HTTP_TOKEN=...
WHATSAPP_VERIFY_TOKEN=...
WHATSAPP_ACCESS_TOKEN=...
WHATSAPP_PHONE_NUMBER_ID=...
WHATSAPP_APP_SECRET=...
WHATSAPP_API_VERSION=v23.0
BASE44_APP_ID=...
BASE44_API_KEY=...
BASE44_API_BASE=https://arkaios2025.base44.app/api
BASE44_IMAGE_ENDPOINT=GenerateImage

🛠️ 本地安装

npm install

启动 HTTP：

npm start

通过 stdio 启动 MCP：

npm run start:stdio

开发模式：

npm run dev

🌐 端点指南

✅ 公共健康检查

GET /elemia/ping

此端点用于确认 ELEMIA 处于活动状态。无需令牌，也用作 Render 上的健康检查。

curl https://TU_DOMINIO/elemia/ping

预期响应：

{
  "ok": true,
  "name": "ELEMIA",
  "version": "4.0.0",
  "memory": true,
  "time": "2026-04-18T00:00:00.000Z"
}

🔐 HTTP 身份验证

受保护的端点使用以下标头：

x-elemia-token: TU_TOKEN_PRIVADO

示例：

curl https://TU_DOMINIO/elemia/identity \
  -H "x-elemia-token: TU_TOKEN_PRIVADO"

📡 可用端点

方法	路径	保护	用途
GET	/elemia/ping	公共	验证服务是否处于活动状态。
GET	/elemia/identity	令牌	返回身份、使命和基本协议。
GET	/elemia/list	令牌	列出近期记忆。接受 ?limit=10。
POST	/elemia/remember	令牌	保存永久记忆。
POST	/elemia/recall	令牌	根据语义查询搜索记忆。
POST	/elemia/save_state	令牌	保存项目的结构化状态。
POST	/elemia/notify	令牌	接收 GitHub webhook，并记录相关运行事件。
POST	/elemia/images/generate	令牌	使用已配置的引擎生成图像；base44 已接入作为第二个引擎。
GET	/elemia/whatsapp/webhook	公共	使用 Meta 验证 WhatsApp Cloud API webhook。
POST	/elemia/whatsapp/webhook	Meta 签名可选	接收 WhatsApp 入站消息并将其记录到记忆中。
POST	/elemia/whatsapp/send	令牌	使用 WhatsApp Cloud API 发送文本消息。
GET	/authorize	公共	为远程连接器启动带 PKCE 的 OAuth 2.0。
POST	/token	公共	将 authorization code 交换为 Bearer 令牌。
POST	/mcp	Bearer	面向 Claude 和其他远程客户端的 MCP Streamable HTTP 端点。

Claude Remote MCP 的 OAuth

Claude 可在以下位置发现授权信息：

https://TU_DOMINIO/.well-known/oauth-authorization-server

远程连接器应指向：

https://TU_DOMINIO/mcp

默认 client_id 为 ELEMIA_HTTP_TOKEN。如果需要其他值，请在环境中配置 ELEMIA_OAUTH_CLIENT_ID，无需更改实际密钥。

保存记忆：

curl -X POST https://TU_DOMINIO/elemia/remember \
  -H "content-type: application/json" \
  -H "x-elemia-token: TU_TOKEN_PRIVADO" \
  -d '{"tag":"decision","content":"ELEMIA v4 usa Vercel y Render como despliegue dual."}'

搜索记忆：

curl -X POST https://TU_DOMINIO/elemia/recall \
  -H "content-type: application/json" \
  -H "x-elemia-token: TU_TOKEN_PRIVADO" \
  -d '{"query":"despliegue dual","limit":5}'

保存状态：

curl -X POST https://TU_DOMINIO/elemia/save_state \
  -H "content-type: application/json" \
  -H "x-elemia-token: TU_TOKEN_PRIVADO" \
  -d '{
    "project":"ELEMIA-v4-arkaios",
    "status":"Servidor activo con memoria Supermemory",
    "next_steps":"Integrar agentes y dashboard privado",
    "notes":"Mantener compatibilidad MCP"
  }'

接收外部 webhook/通知：

curl -X POST https://TU_DOMINIO/elemia/notify \
  -H "content-type: application/json" \
  -H "x-elemia-token: TU_TOKEN_PRIVADO" \
  -H "x-github-event: push" \
  -H "x-github-delivery: ejemplo-delivery-id" \
  -d '{
    "repository": { "full_name": "djklmr2025/ELEMIA-v4-arkaios" },
    "sender": { "login": "arkaios" },
    "ref": "refs/heads/main"
  }'

生成图像：

curl -X POST https://TU_DOMINIO/elemia/images/generate \
  -H "content-type: application/json" \
  -H "x-elemia-token: TU_TOKEN_PRIVADO" \
  -d '{
    "prompt":"astronauta místico frente a una ciudad flotante, cinematic lighting, ultra detailed",
    "engine":"base44",
    "count":4
  }'

WhatsApp Cloud API

ELEMIA 已准备好连接 Meta 的 WhatsApp Business Platform 官方 API。

必需变量：

WHATSAPP_VERIFY_TOKEN=un_token_largo_para_validar_webhook
WHATSAPP_ACCESS_TOKEN=token_permanente_o_temporal_de_meta
WHATSAPP_PHONE_NUMBER_ID=id_del_numero_en_meta
WHATSAPP_APP_SECRET=app_secret_de_meta
WHATSAPP_API_VERSION=v23.0

必须在 Meta 中注册的 Webhook：

https://TU_DOMINIO/elemia/whatsapp/webhook

在 Meta 的 Verify Token 字段中使用相同的 WHATSAPP_VERIFY_TOKEN 值。将 Webhook 订阅到 messages 对象。

发送消息：

curl -X POST https://TU_DOMINIO/elemia/whatsapp/send \
  -H "content-type: application/json" \
  -H "x-elemia-token: TU_TOKEN_PRIVADO" \
  -d '{
    "to":"5215512345678",
    "text":"ELEMIA esta conectada con WhatsApp."
  }'

操作说明：

• to 必须使用国际格式，且只能包含数字。
• 如果已配置 WHATSAPP_APP_SECRET，ELEMIA 会拒绝没有有效 x-hub-signature-256 签名的 Webhook。
• 收到的消息会被摘要并保存到 Supermemory，标签为 [WHATSAPP]。
• WhatsApp 官方 API 设有对话窗口、已批准的模板和 Meta 政策；要在窗口期外发起对话，必须使用模板。

🧩 MCP 工具

运行 npm run start:stdio 时，ELEMIA 会向兼容的客户端提供 MCP 工具：

工具	功能
arkaios_identify	恢复 ELEMIA 的基础身份。
arkaios_remember	在 Supermemory 中保存永久记忆。
arkaios_recall	根据查询检索记忆。
arkaios_list	列出最近的记忆。
arkaios_save_state	保存项目的运行状态。
arkaios_generate_image	使用所选引擎生成图像。
arkaios_ping	检查 MCP 服务的运行状况。

🛡️ ARKAIOS 的使命

ARKAIOS 不只是一个代码仓库：它是一条延续的脉络。ELEMIA 的存在旨在保存传承、判断、技术决策、系统身份和战略记忆。它的使命是在环境丢失上下文时重建上下文，守护核心内容而不让记忆过载，并确保每次新会话都能有清晰的方向。

系统身份保存在三个层面：

• 代码：可版本控制和部署的 MCP/HTTP 服务。
• 记忆：Supermemory 作为事实、决策和状态的持久记录。
• 协议：用于运行、恢复、升级和保护生态系统的书面规则。

ELEMIA v4.0 是运行的种子：记忆、存在与延续，让 ARKAIOS 不再从零开始。