rociiu/talorys

Talorys – 托管于您 Cloudflare 账户的个人 AI 助理

它是什么

• 一个开源的单用户 AI 助理，完全存在于个人的 Cloudflare 账户中。
• 提供聊天、记忆、任务/笔记/项目管理以及定时自动化（提醒、摘要、AI 驱动的例行程序）。
• 无需外部服务器或数据库 – 所有数据都存储在您拥有的基于 SQLite 的 Durable Object 中。

运作方式

1. 前端 – 由 Cloudflare Pages (*.pages.dev) 提供的 React/Vite 应用程序。
2. API 层 – 私有的 Cloudflare Workers 函数 (Hono router) 通过 service binding 将请求转发给专用的 Worker。
3. 代理 (Agent) – Worker 执行 TalorysAgent (Cloudflare Agents SDK)，该代理：
   • 在 SQLite 中存储对话、记忆、任务、笔记、项目、自动化等。
   • 调用 Workers AI (@cf/zai-org/glm-4.7-flash) 进行流式聊天与工具调用。
   • 使用 Durable Object 闹钟进行提醒与周期性调度。
4. 安全性 – 验证在 Worker 中进行；拥有者密码在本地哈希处理，仅作为 Cloudflare 密钥存储。没有任何遥测数据会离开您的账户。

主要功能

• 聊天：支持流式响应、Markdown 渲染与可见的工具活动。
• 记忆：持久的个人事实；可选的语义回溯（基于意义的搜索）。
• 任务、笔记、项目的 CRUD：直接从 UI 或通过聊天指令操作。
• 自动化：一次性/周期性提醒、每日摘要、可选的 AI 例行程序；在 Durable Object 闹钟上执行，因此无需持续在线。
• 离线模式：即使 Workers AI 配额耗尽，任务/笔记仍可继续运作。
• 备份与还原：下载所有个人数据的 JSON 备份；导入时可安全合并。
• 自托管免费层级：设计为符合 Cloudflare Workers 免费方案（Pages、Workers、Durable Objects、Workers AI 每日免费配额）。不会自动配置付费服务。

安装

npx create-talorys@latest

安装程序将引导您完成：

• Node 22+ 检查、Cloudflare 登录、账户选择。
• 设置拥有者密码（本地哈希）。
• 生成密钥、资源名称，并部署私有 Worker 与 Pages 网站。
• 在不调用 AI 的情况下验证部署。 它会创建一个 talorys/ 文件夹，其中包含用于未来更新的非机密配置。

开发

• 克隆仓库，执行 npm install，然后执行 npm run dev 以在本地启动 Worker、Pages 代理与 Vite UI。
• 使用确定性的模拟 AI 提供者，因此本地开发无需 Cloudflare 登录。
• 完整的测试套件（单元测试、e2e、冒烟测试）与 TypeScript 类型检查。

维护

• 使用 npx create-talorys@latest update 更新 – 在保留 Durable Object 命名空间与密码的同时重新部署代码。
• 通过 npx create-talorys@latest reset-password 重置密码。
• 通过 npx create-talorys@latest doctor 进行健康检查。

适用对象

• 想要一个私有、自托管 AI 助理，且不想管理自己服务器的用户。
• 熟悉 Cloudflare 平台并想要一个现成个人代理的开发者。

授权 – MIT。

---

以上所有细节均直接取自仓库的 README。