Streaming Buddy

核心用法

Streaming Buddy 是一款集成 TMDB 数据库的个人流媒体管家，通过命令行交互实现全链路观影管理：

搜索与发现：支持 /stream search 关键词检索、/stream mood 情绪标签匹配（如 exciting、relaxing）、/stream surprise 随机推荐，覆盖电影与剧集。

进度追踪：用 /stream watch 标记在看、/stream progress S01E05 更新集数、/stream done [1-5] 完结并评分，形成完整观影档案。

智能推荐：系统通过评分（4-5 分强化偏好、1-2 分标记回避）和显式 like/dislike 反馈，构建包含类型权重、演员导演偏好、主题标签的 taste profile，并用 /stream suggest 输出个性化推荐，附带 /stream why 解释匹配逻辑。

服务整合：管理多平台订阅（Netflix、Prime、Disney+、Apple TV+ 等 12 种），实时查询内容可用性。

显著优点

• 主动学习机制：区别于静态推荐，持续从用户行为中优化权重
• 跨服务聚合：统一入口解决"内容在哪播"的痛点
• 开源可定制：MIT 协议，数据本地化存储（JSON 格式），支持多语言

潜在局限

• 依赖 TMDB 和 JustWatch API，免费密钥有速率限制
• 学习周期较长，新用户需积累 10+ 评分才显效
• 无社交功能（无法查看好友在看）
• 情绪标签为预设映射，不支持自定义 mood 关键词

适合人群

• 订阅多平台、常陷入"选择困难"的重度流媒体用户
• 希望系统化记录观影历程的影视爱好者
• 偏好命令行/本地数据管理的隐私敏感型用户

常规风险

• TMDB API 密钥需妥善保管，避免泄露至公共仓库
• 本地数据未加密，多用户共享设备存在隐私暴露风险
• 依赖外部 API 可用性，服务中断时功能受限

Streaming Buddy 综合评估

核心用法

Streaming Buddy 是一款本地化运行的个人流媒体智能助手，通过与 TMDB（The Movie Database）官方 API 交互，为用户提供一站式观影管理服务。核心功能包括：

• 智能搜索与信息查询：基于 TMDB 数据库快速检索电影/剧集详情，支持多语言输出
• 观影进度追踪：通过 /stream watch 开始追踪，/stream progress 更新进度（如 S01E05），/stream done 标记完成
• 口味学习系统：用户完成评分（1-5星）或显式标记 /stream like|dislike 后，自动提取类型、主题、演员、导演等特征，构建个人偏好画像
• 多维度推荐：支持基于订阅服务筛选（Netflix、Prime、Disney+ 等）、情绪标签（exciting/relaxing/scary/romantic/funny/thoughtful）、随机惊喜推荐
• 可用性检查：显示内容在用户的哪些订阅平台可观看
• 推荐理由解释：/stream why 命令可解释为何某部作品匹配你的口味

所有数据存储在用户本地 $WORKSPACE/memory/streaming-buddy/ 目录，包括配置文件、偏好画像、观看历史、待看清单等。

显著优点

| 维度 | 优势 |

|------|------|

隐私保护 | 完全本地化架构，观看记录、评分数据不上传任何第三方服务器，符合 GDPR 数据最小化原则 |
学习精度 | 从评分、显式反馈、观看行为多维度提取偏好，支持类型权重、主题标签、演职员偏好 |
平台整合 | 支持 12+ 主流流媒体平台可用性查询，避免用户在各 App 间反复搜索 |
轻量依赖 | 仅依赖系统预装的 curl 和 jq，无 npm/pip 供应链风险，Bash 实现代码透明可审计 |
情绪推荐 | 预设 6 种情绪映射到具体类型组合，适合"今晚想看刺激的"这类模糊需求 |
开源可信 | MIT 许可证，代码完全开源，社区开发者维护（clawdbot），T2 来源可信度认证 |

潜在缺点与局限性

1. TMDB API 依赖：所有功能依赖 TMDB API，需用户自行申请免费 API Key；若 TMDB 服务受限或 API 变更，功能将受影响
2. 地域限制：流媒体平台可用性数据依赖 JustWatch 集成，部分地区或小语种内容覆盖可能不完整
3. 无实时同步：不支持跨设备同步观看进度，数据绑定单台设备/工作区
4. 学习冷启动：新用户需要积累 5-10 条有效评分后，推荐质量才会显著提升
5. 无社交功能：纯个人工具，不支持好友推荐、共享片单、评分社区等社交功能
6. 界面限制：命令行交互为主，无图形界面或移动端 App

适合人群

• 多平台订阅用户：同时拥有 Netflix、Prime、Disney+ 等多个服务，希望统一查询可用性
• 追剧管理需求者：需要追踪多部剧集的观看进度，避免遗忘看到哪一集
• 类型探索爱好者：希望通过情绪标签发现新内容，而非仅依赖算法推荐
• 隐私敏感用户：不愿将观看记录交给流媒体平台或第三方推荐服务
• 技术向用户：习惯命令行工具，能自行配置 API Key 和工作区

常规风险

| 风险类型 | 评估 | 说明 |

|----------|------|------|

数据丢失风险 | 中 | 所有数据本地存储，无云端备份；建议用户定期备份 $WORKSPACE/memory/streaming-buddy/ 目录 |
API Key 泄露 | 低 | API Key 存储于本地配置文件，需确保工作区权限设置合理，避免多用户共享 |
推荐偏差风险 | 低 | 学习系统基于用户主动反馈，无被动行为追踪，避免"信息茧房"过度强化 |
供应链攻击 | 极低 | 无第三方依赖包，curl/jq 由系统包管理器维护 |
网络超时 | 低 | 已设置 10 秒超时限制，API 不可用时优雅降级 |

总体评价：Streaming Buddy 是一款设计精良、隐私优先的本地化流媒体工具，适合注重数据主权的进阶用户。其口味学习系统虽无工业级推荐算法的复杂度，但胜在透明可控。T2 来源可信度 + A 级安全评分为其可靠性提供背书，可作为主力观影管理工具。