快速开始

托管版 Web 应用

最快的上手方式是直接使用托管版 Web 应用：

1. 打开 app.flashcards-open-source-app.com
2. 使用无密码邮箱 OTP 登录
3. 创建卡片、复习到期内容，并结合工作区数据和文件附件使用 AI 对话功能

使用托管版时，无需安装任何软件，也不需要自行配置服务器。

智能代理接入

如果你希望让 Claude Code、Codex 或 OpenClaw 直接接入，请从以下入口开始：

GET https://api.flashcards-open-source-app.com/v1/

该发现接口的响应会引导智能代理完成邮箱 OTP 登录、创建长期有效的 API key、加载账户信息、初始化工作区，并继续使用已公开的 SQL 接口。

相同的响应也可以通过 GET /v1/agent 获取，但 /v1/ 才是标准的公开入口。

自托管

如果你想运行自己的实例，请查看 自托管指南。

当前可用能力

• 可用于卡片管理、复习和 AI 对话的托管版 Web 应用
• 主仓库中的 iOS 客户端，使用本地 SQLite 并支持离线优先同步
• 分别部署在独立 api 与 auth 域名上的共享后端和认证服务
• 通过发现入口、OTP 和 ApiKey 认证接入外部智能代理的完整流程
• 以 Postgres 为权威数据源、可在 AWS 上自行部署的开源方案

仓库方向

该项目采用离线优先设计。

当前主仓库已包含 Web 应用、iOS 应用、认证服务、后端 API、外部智能代理接入流程，以及已发布到 Google Play 的 Android 应用。