生态系统概览
vocnet 生态包括三个核心角色：用户、第三方开发者、vocnet 平台。
🎭 生态角色
1. 终端用户
需求：
- 学习和复习英语词汇
- 跨 APP 管理词汇数据
- 科学的复习计划
使用方式：
- 直接使用 vocnet 官方 APP / 网站
- 在第三方 APP 中授权连接 vocnet 账号
- 享受跨 APP 的词汇数据同步
2. 第三方开发者
类型：
- 阅读类 APP（英文新闻、电子书）
- 视频类 APP（YouTube 字幕学习）
- 浏览器扩展（网页划词翻译）
- 桌面工具（Anki 插件、Alfred Workflow）
- 聊天机器人（Telegram / Discord）
价值获得：
- ✅ 无需自己实现词汇管理系统
- ✅ 无需自己实现 FSRS 复习算法
- ✅ 用户即刻获得历史学习数据（降低冷启动成本）
- ✅ 专注于差异化的内容和体验
接入方式：
- OAuth2 授权获取用户数据
- 调用 vocnet API（收藏词汇、查询掌握度）
- 可选：在自己 APP 内展示 flashcards（调用 API）
3. vocnet 平台
提供：
- 词汇数据存储和管理
- FSRS 复习算法
- Flashcards 生成和调度
- OAuth2 认证服务
- 开发者工具（SDK、文档、控制台）
收入来源（计划）：
- 用户订阅（高级功能）
- 企业私有化部署
- 开发者 API 调用（免费额度 + 付费）
🔄 数据流动
┌─────────────┐
│ 用户 │
│ (Alice) │
└──────┬──────┘
│ 1. 注册 vocnet 账号
│ 2. 在 vocnet APP 学习 100 个词
↓
┌─────────────────────┐
│ vocnet 平台 │
│ - 存储 100 个词 │
│ - 掌握度数据 │
│ - FSRS 复习计划 │
└──────┬──────────────┘
│ 3. 用户下载"阅读 APP"
│ 4. 阅读 APP 请求连接 vocnet
↓
┌─────────────┐ ┌──────────────┐
│ 用户 │◄────────┤ 阅读 APP │
│ (Alice) │ OAuth2 │ (第三方) │
└──────┬──────┘ 授权 └───────┬───────┘
│ │
│ 5. 授权成功 │
↓ ↓
┌─────────────────────┐ 调用 API
│ vocnet 平台 │◄──────────────┐
│ - 返回 100 个词 │ │
│ - 阅读 APP 知道 │ │
│ 用户已学过的词 │ │
└──────┬──────────────┘ │
│ 6. 用户在阅读 APP 标记新词 │
↓ │
API: CollectWord ───────────────┘
(新词存到 vocnet)
↓ 7. 用户在 vocnet APP 统一复习
所有词汇（包括阅读 APP 标记的）
🎯 典型使用场景
场景 1：用户先有 vocnet 账号
1. 用户注册 vocnet → 学习 500 个词
2. 下载"英文新闻 APP" → 提示"连接 vocnet"
3. OAuth2 授权
4. 新闻 APP 获取 500 个词的掌握度
5. 阅读时，已掌握的词不高亮（降低干扰）
6. 新词标记 → 存到 vocnet
7. 复习在 vocnet 统一进行
场景 2：用户先用第三方 APP
1. 用户使用"阅读 APP"（还没 vocnet 账号）
2. 标记了 50 个生词（存在 APP 本地）
3. APP 提示"启用 vocnet 云同步"
4. 用户点击 → 跳转 vocnet → 注册账号
5. 授权后，50 个词同步到 vocnet
6. 用户可以在 vocnet 复习
7. 后续在其他 APP 学习的词也会同步
场景 3：多个 APP 同时使用
用户同时用：
- 阅读 APP（标记文章生词）
- 视频 APP（标记字幕生词）
- Chrome 扩展（网页划词）
所有生词 → 统一存到 vocnet
掌握度数据 → 跨 APP 同步
复习 → vocnet 统一调度（或各 APP 调用 flashcards API）
🛠️ 开发者集成方式
方式 1：完全托管（推荐）
第三方 APP 只负责：
- 内容展示（阅读、视频、游戏化）
- 词汇标记（用户点击生词）
调用 vocnet API：
- CollectWord（添加生词）
- GetLearnedWord（查询掌握度）
复习功能：
- 用户跳转到 vocnet APP 复习
- 或调用 GetFlashCards 在自己 APP 内展示
优点：
- 接入成本低（只需 OAuth2 + 几个 API）
- 无需自己做复习界面
方式 2：深度集成
第三方 APP 实现：
- 内容展示
- 词汇标记
- 在自己 APP 内展示 flashcards
调用 vocnet API：
- CollectWord
- GetFlashCards（获取待复习词）
- SubmitAnswer（提交复习结果）
vocnet 负责：
- 数据存储
- FSRS 算法调度
- 跨 APP 同步
优点：
- 用户体验一致（不用跳出 APP）
- 仍然享受 vocnet 的算法和数据管理
🌟 成为合作伙伴
开发者计划（计划中）
免费档：
- 10,000 次 API 调用/月
- 社区支持
- 基础文档
专业档：
- 100,000 次 API 调用/月
- 技术支持
- 开发者控制台
认证合作伙伴：
- 无限 API 调用
- 官方推荐（vocnet 官网展示）
- 联合推广
- 专属技术顾问
申请成为合作伙伴
- 阅读 第三方集成指南
- 提交申请（GitHub Issue）
- 技术对接
- 上线合作
📊 生态现状（2024）
- 用户数：内测阶段
- 第三方 APP：精选合作伙伴对接中
- API 稳定性：Alpha
- SDK：Go（计划），TypeScript（计划）
查看最新进展：路线图