Talorys：部署在 Cloudflare 的个人 AI 智能体

你的个人 AI 智能体。你自己的云端。

Talorys 是一款免费、开源的个人 AI 助手，完全运行在你自己的 Cloudflare 账户内。它能与你聊天，记住重要的信息，管理任务、笔记和项目，并按计划执行提醒和例行程序——无需任何由 Talorys 开发者运营的服务器、数据库或账户。

一个人。一个 Cloudflare 账户。一条命令。一个个人 AI 智能体。

npx create-talorys@latest

1. Talorys 是什么

• 私人助理——支持流式响应、Markdown 格式以及工具活动指示器的聊天功能。
• 记忆——持久化的个人事实和偏好设置，你可以查看、编辑和删除它们。每次对话时，只有最相关的记忆会被发送给模型。
• 任务、笔记和项目——在 UI 中支持完整的增删改查（CRUD）操作，也支持通过聊天指令操作（例如：“添加一个明天审查我项目的任务”）。
• 自动化——一次性及定期提醒、每日任务摘要以及可选的 AI 例行程序，均投递至应用内的通知中心。它们在 Durable Object 闹钟上运行，因此无需保持在线状态。
• 专为单用户设计——无需注册，无需账户，无需团队。安装程序会设置所有者密码。
• 无 AI 也能工作——如果 Workers AI 不可用或你的免费额度已用完，任务、笔记、记忆和提醒仍会继续正常工作。

截图

1. 工作原理

浏览器 ──HTTPS──▶ Cloudflare Pages (React 应用 + /api Pages 函数)
                         │ 服务绑定（无公共 URL）
                         ▼
                   私有 Worker (Hono 路由器)
                         │ 获取名为 "personal-agent" 的智能体
                         ▼
                   TalorysAgent — Cloudflare Agents SDK Durable Object
                     ├─ SQLite：会话、记忆、任务、笔记、项目、
                     │          自动化、会话记录、设置、使用情况
                     ├─ Workers AI：@cf/zai-org/glm-4.7-flash（流式传输 + 工具调用）
                     └─ 闹钟：提醒和定期计划

• 浏览器仅与你的 *.pages.dev 站点通信。/api/* 请求会运行一个 Pages 函数，通过服务绑定将其转发给智能体 Worker。
• 该智能体 Worker 部署时设置了 workers_dev: false 和 preview_urls: false：它没有公共 URL。
• 认证和授权发生在 Worker 中，而非前端。
• 聊天响应以 Server-Sent Events 形式端到端流式传输。

更多详情：docs/architecture.md。

1. 使用的 Cloudflare 服务

Talorys 不配置 R2、D1、KV、Vectorize、AI Search、Workflows 或任何付费服务。

1. 部署

1. 检查 Node.js 版本（20.18+）并使用其捆绑的 Wrangler CLI（检测到全局安装的 wranger/cf 但不需要）。
2. 验证你的 Cloudflare 登录状态，或在浏览器中打开 Cloudflare 的授权页面。
3. 让你选择一个账户（如果你有多个）和一个智能体名称。
4. 询问所有者密码（隐藏输入，强度检查）。它在本地使用 PBKDF2-SHA256 进行哈希处理，并仅作为 Cloudflare 密钥存储。
5. 生成 256 位会话密钥和唯一的资源名称（talorys- -agent, talorys- -web）。
6. 部署私有 Worker（创建其 SQLite Durable Object），存储密钥，创建并部署带有服务绑定的 Pages 项目。
7. 验证实时部署（前端、认证端点、未授权拒绝、存储健康状况），而不运行任何 AI 推理。
8. 打印 Cloudflare 报告的真实 https://….pages.dev URL。

它会写入一个包含 talorys.json（安装 ID、账户 ID、资源名称、URL——不含密钥）和可部署工件的 talorys/ 目录。请保留该目录以便后续更新。

中断了？在相同位置再次运行相同的命令即可。它会协调已存在的内容：不会创建重复的资源，如果密码已配置则不会重新提示输入密码，且永远不会删除任何数据。

非交互式安装：TALORYS_OWNER_PASSWORD=... npx create-talorys@latest --yes --account-id（如果你未登录，需设置 CLOUDFLARE_API_TOKEN）。

权限

浏览器登录使用 Wrangler 的标准 OAuth 流程——无需全局 API 密钥。如果你改用 API 令牌，它需要以下权限：

• Account › Workers Scripts › Edit
• Account › Cloudflare Pages › Edit
• Account › Workers AI › Read
• Account › Account Settings › Read
• User › User Details › Read（可选；显示你的电子邮件地址）

详见 docs/deployment.md。

1. 访问

打开安装程序打印的 URL，输入你的所有者密码，开始聊天。从任意数量的设备登录——它们都是同一个所有者。在“设置 → 安全”中管理会话。

忘记密码？从你的 talorys/ 目录执行：

npx create-talorys@latest reset-password

这将替换密码密钥并注销所有设备。

1. 数据存储位置

所有数据均存储在你 Cloudflare 账户中的单个基于 SQLite 的 Durable Object（personal-agent）中。Talorys 没有任何遥测、分析、跟踪或广告代码，也不向开发者发送任何数据。

Cloudflare 处理你的数据以提供服务——包括在你的聊天消息和每个提示中包含的相关记忆上运行 Workers AI 推理。请查阅 Cloudflare 的隐私政策和 Workers AI 条款。

安全模型和威胁缓解措施：docs/security.md。

1. 免费与付费内容

Talorys 旨在适配 Cloudflare Workers 免费计划，且绝不会自行启用付费功能。但它并非“无限免费”，请注意：

• 免费计划具有账户级别的配额（请求数、Durable Object 使用量、每日 Workers AI Neuron 分配额度）。配额由 Cloudflare 设定，且可能发生变化。
• 当 AI 分配额度用尽时，聊天界面会显示明确提示，并在每日重置后恢复。其他一切功能照常运行，且你的数据不受影响。
• 如果你的账户属于付费计划，超出包含额度的用量将根据你的计划由 Cloudflare 计费。

内置护栏（可在“设置 → AI”中调整）：最大输出 token 数、最大上下文 token 数（较旧的历史记录会被摘要）、每次请求的最大工具调用和推理步骤数、每日最大 AI 请求数，以及每日最大计划 AI 运行次数。简单的提醒和任务摘要从不使用 AI。“使用情况”面板显示本地估算值，并提供指向 Cloudflare 仪表板的链接以查看确切的 Neuron 用量。

1. 本地开发

要求：Node.js 20.18+。

git clone https://github.com/rociiu/talorys.git
cd talorys
npm install
npm run dev

npm run dev 在一个终端中启动代理 Worker（wrangler dev，端口 8787）、带有服务绑定的 Pages Function 代理（wrangler pages dev，端口 8788）以及 Vite UI（http://localhost:5173）。它会创建 apps/agent/.dev.vars 文件，其中包含本地密码（talorys-dev-password，可通过 TALORYS_DEV_PASSWORD 覆盖），并使用确定性模拟 AI 提供商，因此无需登录 Cloudflare。状态持久化存储在 .wrangler/state 中。

其他脚本：npm run build、npm test、npm run test:e2e、npm run test:pack、npm run typecheck、npm run lint。详见 docs/development.md。

1. 备份数据

“设置 → 隐私 → 下载备份”将生成包含对话、记忆、任务、笔记、项目、设置和自动化规则（绝不含会话或凭据）的 talorys-backup.json 文件。导入时会验证文件并以单一事务合并；重复导入同一备份无害。

1. 更新

npx create-talorys@latest update

这将把最新的 Worker 和前端重新部署到相同的资源上。Durable Object 命名空间永远不会被重新创建（迁移是追加式的），所有者密码和会话会被保留，模式迁移会在首次请求时自动且事务性地运行。此外还提供 status 和 doctor 功能。

1. 故障排除

npx create-talorys@latest doctor 会自动检查所有内容。更多信息请参阅 docs/troubleshooting.md。

仓库结构

apps/agent              私有 Worker：Hono API、TalorysAgent、工具、SQLite 存储库
apps/web                React + Vite 应用，Pages 函数 (functions/api/[[path]].ts)
packages/shared         Zod 模式、类型、重复/DST 逻辑、密码哈希
packages/create-talorys 一键式安装程序（npm 包）
tests/e2e               Playwright UI 测试
tests/smoke             可选的真实账户部署测试
docs/                   架构、部署、开发、安全、故障排除

许可证