核心用法
Trakt CLI 是一款命令行工具，用于连接 trakt.tv 平台管理个人观影数据。支持两大核心功能：一是查询已登录用户的观看历史（trakt-cli history），可分页浏览、限制返回数量；二是全局影视搜索（trakt-cli search），无需认证即可查询电影和剧集信息。
显著优点
- 轻量高效：纯 CLI 交互，适合终端工作流，响应速度快
- 认证灵活：搜索功能无需登录，历史查询需 OAuth2 设备码授权，权限边界清晰
- 数据同步：直接对接 trakt.tv 官方 API，数据来源可靠
- 配置持久化：认证信息自动保存至
~/.trakt.yaml，避免重复授权
潜在缺点与局限性
- 功能单一：仅支持读取历史记录和搜索，无法标记观影、管理收藏或评分
- 依赖外部服务：完全依赖 trakt.tv 平台可用性，无离线缓存能力
- 仅限个人数据：无法查看他人公开资料或社区趋势榜单
- Node 依赖：需预先安装 Node.js 环境，对非开发用户有门槛
适合人群
- 重度 trakt.tv 用户，习惯命令行操作效率
- 需要快速核对个人观影记录的场景（如写影评、整理片单）
- 开发者或自动化工作流集成（如结合脚本生成月度观影报告）
常规风险
- OAuth 凭证本地存储：
~/.trakt.yaml包含客户端密钥和访问令牌，若设备共享或未加密存在泄露风险 - 只读权限：当前实现为只读，但 OAuth 应用权限由用户创建时配置，需确认未授予写入权限
- API 限流：频繁调用可能触发 trakt.tv API 频率限制