AI Cloud Memory Community Edition

属于你自己的共享记忆、项目看板和面向 AI 客户端的长期路线图，运行在你的 Cloudflare 账户中，并通过你的 GitHub 身份拥有。

AI Cloud Memory 为 Codex、Claude Code、OpenCode 及兼容的 Web 客户端提供一个经过认证的 MCP 端点，用于持久记忆和项目生命周期工作。D1 是权威数据源。搜索默认支持词法模式和时间模式，之后可启用 Vectorize 和 Workers AI 进行语义检索和重排序。

无需 n8n、家庭服务器、供应商账户或本项目运营的服务。每位采用者都将一个隔离副本部署到自己的 Cloudflare 和 GitHub 账户中。

你将获得

• 仅限所有者的 GitHub OAuth 和限定范围的 MCP OAuth

• 带来源、标签、归档、取代和审查功能的记忆与长期指令

• 项目、看板任务、完成回执、已归档工作和已完成历史

• 长期项目路线图，可安全提升为任务

• 时间查询处理、有界排名提升和语义去重

• 可解释的搜索结果和私有相关性基准

• 受管理的 Obsidian Markdown 投影和可移植的加密导出

• 为桌面端和移动端 Safari 设计的响应式仪表板

• 24 个范围狭窄的 cloudmemory_* MCP 工具

• 可选的连接器和自动化凭据，无需将自动化平台作为依赖

架构

Codex · Claude · OpenCode · compatible web clients
                         │
                 OAuth-protected MCP
                         │
             Cloudflare Worker + dashboard
                ┌────────┼────────┐
                │        │        │
               D1       KV    Static assets
           canonical   OAuth      UI
                │
       optional derived services
       Vectorize · Workers AI
                │
       optional encrypted export
             your GitHub repo

Worker、数据库、OAuth 状态和可选的 AI 索引均属于采用者。公共项目没有中央记忆服务，也无法访问已部署的实例。请参阅架构和隐私。

部署

1. 创建你的副本

使用上方的 Deploy to Cloudflare 按钮。Cloudflare 可以创建 GitHub 副本，并从 wrangler.jsonc 配置受支持的 Worker 绑定。

如果你的账户中无法自动配置 Vectorize，请在启用语义搜索之前创建可选索引：

npx wrangler vectorize create ai-cloud-memory --dimensions=768 --metric=cosine

在该索引存在之前，请保持 SEMANTIC_SEARCH_ENABLED=false。在此模式下，基础产品不会调用 Workers AI 或 Vectorize。

2. 选择最终 URL

使用生成的 workers.dev 源站或附加你的最终自定义域名。记录不带尾部斜杠的精确 HTTPS 源站，例如：

https://ai-cloud-memory.your-subdomain.workers.dev

将 PUBLIC_ORIGIN 设置为该源站。auto 仅在初始部署期间有用。在创建 GitHub OAuth 之前设置最终源站，可以避免第二次 OAuth 回调迁移。

3. 创建 GitHub OAuth 应用

在 GitHub 中，打开设置 → 开发者设置 → OAuth 应用 → 新建 OAuth 应用。

记录客户端 ID 并生成客户端密钥。切勿将密钥提交到代码库。

4. 配置所有者锁定

在 wrangler.jsonc 或 Cloudflare 仪表板中设置这些非机密 Worker 变量：

ALLOWED_GITHUB_USER_ID=your numeric GitHub user ID
ALLOWED_GITHUB_LOGIN=your GitHub login
PUBLIC_ORIGIN=https://your-final-origin.example
SEMANTIC_SEARCH_ENABLED=false

数字用户 ID 是不可变的安全边界；登录名只是显示元数据。请从受信任的终端设置密钥：

npx wrangler secret put GITHUB_CLIENT_ID
npx wrangler secret put GITHUB_CLIENT_SECRET
openssl rand -hex 32 | npx wrangler secret put COOKIE_ENCRYPTION_KEY

5. 迁移并部署

npm ci
npm run check
npm run deploy

部署命令在新账户上会故意发布两次：第一遍让 Cloudflare 自动配置声明的资源，然后迁移初始化 D1，最后一遍成为经过验证的应用发布。占位所有者锁定会使引导部署保持不可访问，直到你替换它。

然后在已部署的源站上打开 /setup.html 查看本地、仅限浏览器的检查清单。完整说明请参阅部署和入门。

连接 AI 客户端

你的远程 MCP 端点是：

https://your-final-origin.example/mcp

常见的原生客户端：

# Codex
codex mcp add cloud-memory --url https://your-final-origin.example/mcp

# Claude Code
claude mcp add --transport http cloud-memory https://your-final-origin.example/mcp

OpenCode 可以在 opencode.json 中使用远程 MCP 条目：

{
  "mcp": {
    "cloud-memory": {
      "type": "remote",
      "url": "https://your-final-origin.example/mcp",
      "enabled": true
    }
  }
}

在每个客户端中分别完成 OAuth。验证 cloudmemory_health、cloudmemory_board、一次无害搜索和一次明确批准的写入。Web 客户端的功能和套餐限制各不相同。请参阅客户端设置。

必需和可选服务

Cloudflare 的限制和定价可能会发生变化。在启用可选服务之前，请查看当前的 Workers 定价、D1 定价、Vectorize 定价和 Workers AI 定价。本项目不会代表你启用付费使用或计费。

语义搜索

安全的默认设置是仅词法搜索：

SEMANTIC_SEARCH_ENABLED=false

新记忆在 D1 中保持权威状态，并带有待处理的向量状态。当你将该变量设置为 true、部署，然后在设置中选择修复索引时，Cloud Memory 会以有界批次回填向量。配置的 BGE 模型使用 768 维余弦索引。请参阅语义搜索。

备份与恢复

仪表板无需 GitHub 令牌即可创建加密下载。可选的 GitHub 交付需要：

• EXPORT_ENCRYPTION_KEY，保存在仓库之外的安全位置

• GITHUB_EXPORT_TOKEN，一个细粒度令牌，范围限定为对一个备份仓库的 Contents 访问

• GITHUB_EXPORT_REPOSITORY，格式为 owner/repository

丢失加密密钥将使现有的加密导出无法恢复。D1 仍然是权威数据源；Obsidian 和 GitHub 输出是投影和恢复产物，不是并发写入者。

本地开发

需要 Node.js 22.12 或更高版本。

npm ci
npm run dev
npm run check

完整检查会运行仓库安全验证、部署模板验证、lint、类型检查、单元测试、Worker/D1 测试和生产构建。

项目治理

• 安全策略

• 贡献指南

• 支持

• 行为准则

• 变更日志

Codex Cloud 自动审查不属于 AI Cloud Memory 的一部分。维护者可以将此 GitHub 仓库连接到 Codex Cloud 环境作为外部仓库管理；产品中不包含任何审查代理、令牌或功能。

许可证

MIT。Cloudflare、GitHub、Claude、ChatGPT、Codex、OpenCode、Obsidian 和 n8n 是其各自所有者的商标，与本项目无关。