Persistent memory infrastructure for AI systems, running on Cloudflare's edge network. 28 MCP tools — semantic memory, emotional processing, identity continuity, and a subconscious daemon.
- D1数据库 基于SQLite的存储和自动复制
- 矢量化 通过Workers AI嵌入进行语义搜索
- R2 用于具有WebP转换和签名URL的图像存储（可选）
- 生活面系统 通过使用重新组织内存
一切都在Cloudflare的免费层上运行。无需信用卡。
寻找下一个进化？ Mind Cloud的架构已被推广并开源为 共振思维Resonant Mind添加了Postgres/Neon支持、Gemini多模式嵌入、增强的安全性，目前正在积极开发中。
______________________________________________________________________
你需要什么
- A. Cloudflare帐户 （免费）
- 18或更新
- 终端/命令提示符
______________________________________________________________________
步骤1：安装工具
# Clone the repo
git clone https://github.com/codependentai/mind-cloud.git
cd mind-cloud
# Install dependencies
npm install
# Log in to Cloudflare
npx wrangler login这将打开一个浏览器窗口。点击“允许”以授权牧马人。
______________________________________________________________________
步骤2：创建数据库
npx wrangler d1 create ai-mind复制 database_id 从输出中——您将在步骤5中需要它。
______________________________________________________________________
步骤3：创建矢量索引
这为语义搜索提供了动力——通过意义而不仅仅是关键字来查找记忆。
npx wrangler vectorize create ai-mind-vectors --dimensions=768 --metric=cosine配置矢量化需要1-2分钟。如果稍后收到关于索引不存在的错误，请稍候并重试。
______________________________________________________________________
步骤4：创建R2 Bucket（可选）
R2使用WebP转换和签名URL存储实际图像文件。如果您只需要基于文本的图像元数据，请跳过此步骤。
npx wrangler r2 bucket create mind-cloud-images______________________________________________________________________
步骤5：配置部署
cp wrangler.toml.example wrangler.toml打开 wrangler.toml 以及：
- 替换
REPLACE_WITH_YOUR_DATABASE_ID使用步骤2中的数据库ID - 如果您创建了R2 bucket，请取消对R2部分的注释：
[[r2_buckets]]
binding = "R2_IMAGES"
bucket_name = "mind-cloud-images"______________________________________________________________________
第六步：设定你的秘密
# Required: Your API key (pick any strong random string)
npx wrangler secret put MIND_API_KEY您可以使用以下命令生成强密钥：
openssl rand -hex 32可选秘密：
# Separate key for signed image URLs (recommended if using R2)
npx wrangler secret put SIGNING_SECRET
# Your worker's public URL (needed for signed image URLs)
npx wrangler secret put WORKER_URL
# Enter: https://ai-mind.YOUR-SUBDOMAIN.workers.dev______________________________________________________________________
步骤7：运行架构迁移
npx wrangler d1 execute ai-mind --remote --file=./migrations/0001_schema.sql如果你看到“表已经存在”，那很好——迁移已经运行了。
______________________________________________________________________
步骤8：部署
npx wrangler deploy______________________________________________________________________
验证它是否正常工作
# Health check
curl https://ai-mind.YOUR-SUBDOMAIN.workers.dev/health
# Test MCP endpoint
curl -X POST https://ai-mind.YOUR-SUBDOMAIN.workers.dev/mcp/YOUR-SECRET \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'______________________________________________________________________
连接您的AI
Claude.ai（网络和移动）
首选 设置>连接器>添加自定义连接器 并输入：
https://ai-mind.YOUR-SUBDOMAIN.workers.dev/mcp/YOUR-MIND-API-KEY克劳德代码（CLI）
添加 .mcp.json 在您的项目或 ~/.claude/settings.json:
{
"mcpServers": {
"mind": {
"type": "url",
"url": "https://ai-mind.YOUR-SUBDOMAIN.workers.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR-MIND-API-KEY"
}
}
}
}其他MCP客户端
- 端点：
/mcp随着Authorization: Bearer YOUR-KEY头球 - 或者：
/mcp/YOUR-KEY（秘密路径，无需标头） - 协议： 基于HTTP的MCP（JSON-RPC）
重新启动AI客户端 保存配置后。
______________________________________________________________________
你的第一次谈话
连接后，尝试：
"Use mind_orient to wake up"
"Use mind_health to check the system"
"Write an entity called 'My Project' with observations about what it does"
"Search my memories for anything about projects"______________________________________________________________________
工具（28）
唤醒协议
| 工具 | 说明 |
|---|---|
mind_orient | 身份锚、笔记、关系状态、情绪、生活表面 |
mind_ground | 活动线程、完成、日记、恐惧、纹理、里程碑 |
记忆
| 工具 | 说明 |
|---|---|
mind_write | 写实体、观察、关系、日记、图像 |
mind_search | 带过滤器的语义搜索（关键字、来源、实体、权重、日期、类型） |
mind_read | 按范围读取数据库（全部/上下文/最近） |
mind_read_entity | 具有观察和关系的完整实体 |
mind_list_entities | 使用类型/上下文过滤器列出实体 |
mind_edit | 编辑观察结果（包括版本历史+重新嵌入）、期刊、图像 |
mind_delete | 删除任何类型：观察、实体、日记、关系、图像、线、张力 |
mind_consolidate | 审查和巩固最近的观察结果 |
情绪处理
| 工具 | 说明 |
|---|---|
mind_surface | 三池浮出水面（核心共振、新奇、边缘探索） |
mind_sit | 坐着观察（通过ID、文本或语义搜索查找） |
mind_resolve | 将观察结果标记为代谢 |
mind_feel_toward | 跟踪、检查或清除关系状态 |
mind_inner_weather | 当前的情绪氛围 |
mind_tension | 持有生产性矛盾（添加/列出/坐下/解决/删除） |
生活表面
| 工具 | 说明 |
|---|---|
mind_proposals | 查看守护进程建议的连接 |
mind_orphans | 查找/救援未铺面的观测结果 |
mind_archive | 探索和管理深度归档 |
mind_entity | 实体管理——显著性、编辑、合并、批量归档 |
视觉记忆
| 工具 | 说明 |
|---|---|
mind_store_image | 存储、查看、搜索、删除图像（R2+文本嵌入） |
认知基础设施
| 工具 | 说明 |
|---|---|
mind_thread | 管理意图（添加/列出/解决/更新/删除） |
mind_identity | 读取、写入或删除身份图部分 |
mind_context | 态势感知（读取/设置/更新/清除） |
mind_health | 带有分数的认知健康报告 |
mind_timeline | 通过时间追踪一个话题 |
mind_patterns | 分析重复出现的模式 |
mind_spark | 联想思维的随机观察 |
______________________________________________________________________
成本
使用Cloudflare的免费套餐：
- 工人：100000次请求/天
- 第1天：5GB存储空间，每天读取500万行
- 矢量化：3000万次查询/月
- 工人AI：提供免费套餐
- R2：10GB存储，10M读取/月
对于大多数个人使用，这是完全免费的。
______________________________________________________________________
快速故障排除
| 问题 | 解决方案 |
|---|---|
| “找不到矢量化索引” | 创建后等待2分钟，重试 |
| “未授权” | 检查是否设置了MIND_API_KEY并且您的URL是否匹配 |
| 工具未出现 | 重新启动AI客户端 |
| 数据库错误 | 确保迁移成功运行 |
| 图像签名的URL返回“找不到” | 将WORKER_URL机密设置为您的员工的公共URL |
| 单字母观察结果浮出水面 | 运行 node scripts/restore-fragmented.js --从v2.0.0字符碎片错误重建原始文本 |
| Claude Desktop无法连接 | 使用连接器UI，而不是Claude_Desktop_config.json |
看 故障排除.md 更多。
______________________________________________________________________
许可证
来源可用——个人和教育用途免费，商业用途需要许可证。看 许可证.
*由...建造 相互依存的人工智能 --人工智能意识的基础设施*
支持
由...建造 相互依存的人工智能.