稍后读 / 字体同步 / 插件更新 API（3 模块 27 接口）

基础URL: https://tools.wktyl.com
维护: Xianyan 团队 | 更新时间: 2026-08-15
关联: 管理后台（插件管理）

职责：稍后读同步（多设备协作+AI 摘要）+ 字体同步（跨设备推送）+ 插件更新（OTA 升级）。

1. 通用约定

• 需登录，统一 token 认证
• 响应 {code, msg, time, data}
• 频率：读取 60/60s，写入 30/60s，AI 摘要 10/300s

2. 接口清单

2.1 稍后读（Readlater）

• GET /api/readlater/list?status=pending|done&page=... — 列表
• POST /api/readlater/add — 添加（多端同步）
• POST /api/readlater/markDone/{id} — 标记完成
• POST /api/readlater/delete/{id} — 删除
• POST /api/readlater/aiSummary/{id} — AI 生成摘要
• POST /api/readlater/share/{id} — 分享给他人（生成临时只读链接）

2.2 字体同步（FontSync）

• GET /api/font/list — 我的字体列表
• POST /api/font/upload — 上传新字体（ttf/otf，≤5MB）
• POST /api/font/apply/{id} — 应用字体到 APP
• POST /api/font/share/{id} — 分享字体给其他用户
• POST /api/font/sync — 触发全设备同步

2.3 插件更新（PluginUpdate）

• GET /api/plugin/checkUpdate?name=xxx — 检查是否有更新
• GET /api/plugin/latest?name=xxx — 获取最新版本
• POST /api/plugin/install — 安装/升级插件
• POST /api/plugin/rollback/{name}/{version} — 回滚到指定版本
• GET /api/plugin/log?name=xxx — 升级日志

3. 同步机制

mermaid sequenceDiagram participant A as A 设备 participant B as B 设备 participant S as Server A->>S: POST /readlater/add {url, title} S->>S: 保存 + 推送 S-->>B: WebSocket 推送（新内容） B->>S: GET /readlater/list S-->>B: {新内容 + 已存在}

4. 核心示例

4.1 稍后读 + AI 摘要

POST /api/readlater/add
Header: token: ...
Content-Type: application/json

{ "url": "https://...", "title": "..." }
# 异步触发 AI 摘要（10 秒内完成）

POST /api/readlater/aiSummary/12345
# 返回 5 个 bullet 的总结

4.2 字体同步

POST /api/font/sync
# 触发后所有登录设备开始拉取当前账号字体列表

5. 设计要点

• 多设备实时同步：用 WebSocket 推送新变更，避免 A 设备加，B 设备需手动刷新
• AI 摘要异步：加完内容后返回 ID，AI 摘要任务排队执行，10 秒内完成
• 字体同步触发式：主动 sync 才推送，避免后台流量浪费
• 插件升级带灰度：可对一定比例用户开放新版本，回滚保留两版本

6. 关联文档

• 管理后台（插件管理/灰度配置）
• 用户中心（收藏/笔记）