workers-personal-agent

项目简介 workers-personal-agent 是一款完全运行在 Cloudflare 免费套餐上的个人 AI 智能体，利用 Cloudflare Workers、Durable Objects、R2 存储和 Workers AI 构建。核心特性包括：每个对话独立一个 Durable Object 实现状态隔离、长期记忆以 Markdown 格式存入 R2、语义检索基于 Durable Object 内置 SQLite 向量索引、深度研究模式通过派生子 Durable Object 并行执行。该项目实测了 Cloudflare 免费套餐的各项限制，并将测量结果完整记录在文档中，供需要自部署的用户参考。

核心功能 持久对话状态：每个对话对应一个 Durable Object，对话历史、上下文和中间状态完全持久化，对话中断后可完整恢复。 长期记忆系统：记忆以 Markdown 文件形式存入 R2 对象存储，支持按时间线和主题组织，Agent 可主动检索和更新记忆。 语义检索：基于嵌入向量（Embedding）在 SQLite 中建立索引，支持语义相似度搜索，快速从记忆库中召回相关内容。 深度研究模式：派生子 Durable Object 并行执行多路搜索任务，结果汇总后整理输出，适合需要广泛信息收集的研究场景。 模型灵活性：支持 Workers AI（Cloudflare 自有模型）和任意 OpenAI 兼容 API Key，可绑定的模型不受单一供应商限制。 开源透明：代码完全开源，部署过程有文档记录，用户可自行检查是否存在后门或数据外传。

技术架构 整体技术栈为 Cloudflare Workers + Durable Objects + R2 + Workers AI（或 OpenAI 兼容 API）+ zod + Vue 3 + Vite + Tailwind + shadcn-vue + vitest。部署方式支持通过 Cloudflare 界面一键克隆仓库，自动创建 R2 存储桶和 Durable Objects 绑定，用户只需填入必要的环境变量（API Key 等）即可完成部署。项目文档（ARCHITECTURE.md）详细记录了 Access 认证和 WebSocket 的实测数据，包括 Protect 模式下的行为差异，可供需要深度定制者参考。

适用人群 需要低成本部署私有 AI 助手的个人开发者；已有 Cloudflare 账号、希望利用免费额度运行 AI 智能体的用户；对 AI 智能体记忆和检索能力有需求、需要长上下文管理的用户。

开源协议 MIT

官网链接 https://github.com/DomWane/workers-personal-agent