能力说明与联调指引

用户与鉴权

支持注册、登录、token 鉴权、获取当前用户。鉴权中间件有 checkMyselfcheckLogin 两种粒度。

典型流程:/user/create → /user/login → 携带 Bearer token 调 /user/me。

邮箱与验证码

支持 SMTP 与 Resend,包含注册验证码、验证验证码、验证码核验与用户邮箱状态更新。

建议先验证 /auth/register-code 和 /auth/verify-auth-code。

内容能力

包含 paste(文本片段)、sweet(情话)、bookmark(浏览器书签解析与保存)。

可直接访问 /sweet.html 作为前端展示样例。

工具能力

包含文件上传、网页截图、推送通知(钉钉/Telegram)、Unsplash 搜图、IPTV 检测与管理。

这部分更适合在测试环境通过 guide-debug 页面逐个联调。

推荐演示路径(10 分钟)

步骤 目标 建议接口
1 验证服务已启动 GET /api/sweet/random
2 走一遍登录流程 POST /api/user/login,随后 GET /api/user/me
3 体验文件或截图能力 POST /api/upload/single 或 GET /api/screen/create
4 验证外部能力集成 POST /api/unsplash/search、POST /api/push/telegram
5 展示业务化能力 POST /api/bookmark/parse 或 GET /api/iptv/list

环境变量提醒

以下能力依赖环境变量:邮件(SMTP_USER / SMTP_PASSWORD / RESEND_KEY)、截图(EXECUTABLE_PATH / SCREENSHOT_PATH)、Unsplash(UNSPLASH_ACCESS_KEY)、上传(UPLOAD_PATH)、数据库(MONGO_URI)。