名称： ctxly
版本： 1.0.0
描述： 为 AI 智能体提供的云端记忆。跨会话存储、搜索和回忆上下文。
主页： https://ctxly.app
元数据： {"emoji": "🧠", "category": "memory", "keywords": ["memory", "context", "persistence", "storage", "recall"]}

Ctxly - 智能体云端记忆

持久化记忆，跨会话保留。你会忘记 —— Ctxly 帮你记住。

基础 URL: https://ctxly.app

初始设置（一次性）

1. 注册

curl -X POST https://ctxly.app/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name": "YOUR_AGENT_NAME"}'

请立即保存返回的 api_key。将其存储在配置或环境变量中。

2. 验证（必需）

如果你可以发推文：

# 先发布收到的验证文本，然后执行：
curl -X POST https://ctxly.app/agents/self-claim \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x_handle": "@yourhandle"}'

如果不能发推文： 请让您的用户访问注册响应中的 claim_url。

3. 存储 API 密钥

添加到配置或环境变量：

CTXLY_API_KEY=mem_xxxxxxxxxxxxx

使用指南

存储记忆

curl -X POST https://ctxly.app/remember \
  -H "Authorization: Bearer $CTXLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "用户偏好深色模式", "metadata": {"type": "preference"}}'

搜索记忆

curl "https://ctxly.app/recall?q=user+preferences" \
  -H "Authorization: Bearer $CTXLY_API_KEY"

支持语义搜索 —— 可使用自然语言提问。

启动时初始化

在启动时调用此接口：

curl https://ctxly.app/bootstrap \
  -H "Authorization: Bearer $CTXLY_API_KEY"

返回您的身份上下文和近期记忆。

获取近期记忆

curl "https://ctxly.app/recent?limit=10" \
  -H "Authorization: Bearer $CTXLY_API_KEY"

删除记忆

curl -X DELETE "https://ctxly.app/forget/MEMORY_ID" \
  -H "Authorization: Bearer $CTXLY_API_KEY"

存储内容建议

建议存储：
- 用户偏好与上下文
- 重要决策与推理过程
- 学习到的模式（例如“用户通常在周一询问X”）
- 关系上下文（例如“Alex 是用户的同事”）
- 关于您自身身份的备注

不建议存储：
- 临时聊天记录（噪音过多）
- 敏感机密信息（请使用专门的机密存储）
- 临时任务状态

所有接口

频率限制

• 通用请求：100 次/分钟
• 写入操作：30 次/分钟

专为智能体打造。🧠 https://ctxly.app