rociiu/talorys 来源：https://github.com/rociiu/talorys # Talorys 你的个人 AI 智能体。你自己的云。 Talorys 是一款免费、开源的个人 AI 助手，完全运行在你自己的 Cloudflare 账户中。它与你聊天，记住重要事项，管理任务、笔记和项目，并按计划执行提醒和例行流程——无需使用任何由 Talorys 开发者运营的服务器、数据库或账户。一个人。一个 Cloudflare 账户。一条命令。一个个人 AI 智能体。 bash npx create-talorys@latest — ## 1. Talorys 是什么 - 私人助手——支持流式回复、Markdown 和工具活动指示的聊天。 - 记忆——持久保存的个人信息和偏好，你可以查看、编辑和删除。每轮对话只会将最相关的记忆发送给模型。 - 任务、笔记和项目——可在界面和聊天中进行完整的创建、读取、更新和删除操作（“添加一个任务，明天审查我的项目”）。 - 自动化——一次性及周期性提醒、每日任务摘要，以及可选的 AI 例行流程，均发送至应用内通知中心。它们通过 Durable Object 定时器运行，因此无需让任何设备持续在线。 - 专为单用户设计——无需注册，没有多账户或团队功能。安装程序会设置所有者密码。 - 无需 AI 也能使用——即使 Workers AI 不可用或免费配额已用尽，任务、笔记、记忆和提醒仍可正常使用。 ### 截图 | 显示工具活动的聊天 | 任务 | | — | — | | 聊天 | 任务 | | 记忆（深色模式） | 自动化 | | 记忆 | 自动化 | ## 2. 工作原理 浏览器 ──HTTPS──▶ Cloudflare Pages（React 应用 + /api Pages Function） │ 服务绑定（无公开 URL） ▼ 私有 Worker（Hono 路由器） │ getAgentByName("personal-agent") ▼ TalorysAgent — Cloudflare Agents SDK Durable Object ├─ SQLite：对话、记忆、任务、笔记、项目、 │ 自动化、会话、设置、用量 ├─ Workers AI：@cf/zai-org/glm-4.7-flash（流式输出 + 工具调用） └─ 定时器：提醒和周期性计划 - 浏览器始终只与你的 *.pages.dev 网站通信。/api/* 请求由 Pages Function 处理，再通过服务绑定转发给智能体 Worker。 - 智能体 Worker 部署时设置了 workers_dev: false 和 preview_urls: false：它没有公开 URL。 - 身份验证和授权在 Worker 中进行，而非前端。 - 聊天回复通过服务器发送事件（Server-Sent Events）进行端到端流式传输。 更多详情：docs/architecture.md。 ## 3. 使用的 Cloudflare 服务 | 服务 | 用途 | 免费套餐 | | — | — | — | | Cloudflare Pages | 前端 + Pages Function | 是 | | Cloudflare Workers | 私有 API Worker | 是 | | Durable Objects（SQLite） | 所有数据、调度定时器 | 是 | | Workers AI | 聊天模型（@cf/zai-org/glm-4.7-flash） | 是，每日配额 | Talorys 不会配置 R2、D1、KV、Vectorize、AI Search、Workflows 或任何付费服务。 ## 4. 部署 bash npx create-talorys@latest 安装程序会： 1. 检查 Node.js（20.18+），并使用自带的 Wrangler CLI（会检测全局安装的 wrangler/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/ 目录，包含 talorys.json（安装 ID、账户 ID、资源名称、URL——不含密钥）及可部署产物。请保留该目录以便更新。 安装中断了？ 在同一位置重新运行相同命令。它会协调已有资源：不会重复创建资源，若密码已配置则不会再次要求输入密码，并且绝不会删除任何数据。 非交互式安装：TALORYS_OWNER_PASSWORD=... npx create-talorys@latest --yes --account-id （如果尚未登录，请设置 CLOUDFLARE_API_TOKEN）。 ### 权限 浏览器登录采用 Wrangler 的标准 OAuth 流程——无需全局 API 密钥。如果改用 API 令牌，则需要以下权限： - 账户 › Workers 脚本 › 编辑 - 账户 › Cloudflare Pages › 编辑 - 账户 › Workers AI › 读取 - 账户 › 账户设置 › 读取 - 用户 › 用户详情 › 读取（可选；用于显示你的电子邮箱） 参见 docs/deployment.md。 ## 5. 访问 打开安装程序输出的 URL，输入所有者密码，即可开始聊天。可以从任意数量的设备登录——它们都属于同一位所有者。在设置 → 安全中管理会话。 忘记密码了？在你的 talorys/ 目录中运行： bash npx create-talorys@latest reset-password 这会替换密码密钥，并退出所有设备上的登录。 ## 6. 你的数据存放在哪里 所有数据都存储在你的 Cloudflare 账户中的单个基于 SQLite 的 Durable Object（personal-agent）内。Talorys 没有遥测、分析、跟踪或广告代码，也不会向其开发者发送任何内容。 Cloudflare 会处理你的数据以提供服务——包括对你的聊天消息及每次提示中包含的相关记忆运行 Workers AI 推理。请查阅 Cloudflare 的隐私政策和 Workers AI 条款。 安全模型与威胁缓解措施：docs/security.md。 ## 7. 哪些免费，哪些可能收费 Talorys 旨在适配 Cloudflare Workers 免费套餐，绝不会自行启用付费功能。不过，它并非“无限免费”： - 免费套餐有账户级配额（请求数、Durable Object 用量、每日 Workers AI Neuron 配额）。配额由 Cloudflare 设定，可能发生变化。 - AI 配额耗尽时，聊天会显示明确提示，并在每日配额重置后恢复。其他功能仍正常运行，你的数据不会受到影响。 - 如果你的账户使用付费套餐，超出套餐包含额度的用量将由 Cloudflare 按你的套餐计费。 内置限制措施（可在设置 → AI中调整）：最大输出 token 数、最大上下文 token 数（较早的历史记录会被摘要）、每次请求的最大工具调用次数和推理步骤数、每日最大 AI 请求数，以及每日最大定时 AI 运行次数。简单提醒和任务摘要从不使用 AI。 用量面板显示本地估算值，并提供 Cloudflare 控制面板链接，以便查看准确的 Neuron 用量。 ## 8. 本地开发 要求：Node.js 20.18+。 bash 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 界面（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。 ## 9. 备份你的数据 设置 → 隐私 → 下载备份会生成 talorys-backup.json，包含对话、记忆、任务、笔记、项目、设置和自动化（绝不包含会话或凭据）。 导入会验证文件，并在单个事务中合并数据；重复导入同一份备份不会造成问题。 ## 10. 更新 在你的 talorys/ 目录中运行： bash npx create-talorys@latest update 这会将最新的 Worker 和前端重新部署到相同的资源上。Durable Object 命名空间绝不会被重新创建（迁移仅追加），所有者密码和会话会保留，数据库结构迁移会在首次请求时自动以事务方式执行。 另有以下命令可用：status 和 doctor。 ## 11. 故障排查 | 问题 | 解决方法 | | — | — | | 安装程序中途停止 | 重新运行相同命令；它会继续安装。 | | “尚未通过健康检查” | 新的 pages.dev 网站可能需要几分钟才能就绪。请重新运行。 | | 权限错误 | 使用拥有 Workers 和 Pages 编辑权限的账户，或具备上述权限的令牌。 | | 聊天提示 AI 配额已用尽 | 等待每日重置；或在设置 → AI 中启用演示模式。 | | 登录失败后被锁定 | 等待 15 分钟，或使用 CLI 重置密码。 | npx create-talorys@latest doctor 会自动检查所有项目。更多信息见 docs/troubleshooting.md。 ## 仓库结构 apps/agent 私有 Worker：Hono API、TalorysAgent、工具、SQLite 仓储 apps/web React + Vite 应用、Pages Function（functions/api/[[path]].ts） packages/shared Zod 模式、类型、重复计划/夏令时逻辑、密码哈希 packages/create-talorys 一条命令即可运行的安装程序（npm 包） tests/e2e Playwright 界面测试 tests/smoke 可选的真实账户部署测试 docs/ 架构、部署、开发、安全、故障排查 ## 许可证 MIT