streaming-buddy

Streaming Buddy 是一款基于 TMDB 开放数据库的个人流媒体助手，专为管理多平台观影体验而设计。核心用法围绕 /stream 命令体系构建：用户通过 search 检索影视信息，使用 watch 开启追剧跟踪，progress 更新观看进度至具体集数，done 标记完成并评分触发学习机制。系统通过显式的 like/dislike 反馈结合隐式评分数据，构建包含类型权重、演员偏好、主题标签的多维口味画像，最终通过 suggest 或 mood 命令生成个性化推荐，甚至能解释特定推荐与用户偏好的匹配逻辑。

显著优点体现在隐私保护与智能推荐的平衡：所有观影历史、用户画像、评分数据均以 JSON 格式存储于本地工作区，彻底杜绝观影记录上传风险；支持 Netflix、Prime、Disney+、Apple TV+ 等十余个主流平台的可用性查询，避免用户在各 App 间反复搜索；独特的心情映射系统（exciting、relaxing、thoughtful 等）允许基于当下情绪而非单纯类型进行内容发现；推荐算法不仅追踪类型偏好，还识别演员、导演、叙事主题的关联性，实现真正的个性化而非热门排行。

潜在缺点包括对外部 API 的强依赖：必须联网访问 TMDB 且需用户自行申请 API Key，无法离线使用；作为个人开发者项目（T3 来源），长期维护和功能迭代存在不确定性；当前参数处理主要依赖 Bash 位置参数，复杂输入或特殊字符可能存在解析边界问题；多平台可用性数据依赖第三方集成，不同地区的授权差异可能导致"有链接但无法播放"的情况。

适合的目标群体为多平台流媒体订阅者、有追剧进度管理需求的剧集爱好者，以及注重隐私但希望获得超越简单热门榜单的个性化推荐用户。特别适合那些在不同服务间切换观看、需要统一观看历史和"接下来看什么"决策辅助的影视爱好者。

使用风险方面需注意：性能表现直接受 TMDB API 响应速度影响，网络波动时搜索和推荐可能延迟；所有学习数据存储于本地 $WORKSPACE/memory/streaming-buddy/ 目录，需定期手动备份防止误删；免费版 TMDB API 存在请求频率限制，重度使用可能触发限流；虽然安全审计未发现恶意代码，但 T3 来源建议在企业环境或处理敏感数据前进行额外的代码审查。