OpenBiliClaw-mobile

项目概述

装上手机的那一端来了：OpenBiliClaw-mobile 是 OpenBiliClaw 的 Flutter 移动客户端（多平台内容推荐与认知客户端），连接自建的 OpenBiliClaw 后端（提供 B 站数据与 AI 能力）。采用「客户端 + 后端」架构，覆盖 Android、iOS、Web、Linux、macOS 与 Windows 六端，MIT 许可证，Android 最低 API 31，iOS 最低 15.0。

连上后端 → 浏览积累数据 → AI 建立画像 → 对话微调偏好 → 推荐越来越准。

项目	内容
定位	OpenBiliClaw 的 Flutter 移动客户端（全量版）
平台	Android、iOS、Web、Linux、macOS、Windows
架构	客户端 + 本地后端（默认 127.0.0.1:8420）
播放器	media_kit 原生播放器（移植 PiliPlus 思路）+ 内置 WebView
许可证	MIT

使用逻辑

1. 配置后端连接：右上角设置进入连接设置，选直接连接或内置 Tailscale，填后端 IP 与端口，可点「测试连接」验证
2. 推荐页：从后端拉取「为你推荐」视频流，支持下拉刷新，离线提示无法连接后端
3. 对话页：与 AI 对话，告诉它你喜欢的 UP 主与内容类型，AI 据此调整推荐
4. 画像页：展示 AI 建立的用户兴趣画像，用得越多越准
5. 收藏页：管理稍后再看、我的收藏与近 30 天内容历史（点开过、出现过没点开、最近移除，均可恢复）
6. 消息收件箱：处理兴趣探测、避雷探针、认知更新和待聊确认

特性亮点

• 内容库三 tab：稍后再看、我的收藏、历史记录，已保存卡片支持喜欢、不感兴趣、聊一聊反馈与收藏和稍后的交叉切换
• 统一消息收件箱与 Delight 惊喜推荐，动作区对齐 Web 与插件端
• 封面图统一经后端代理与缓存，规避 CORS、移动网络防盗链及 DNS/TLS 差异
• Android 使用 Material 3 导航，iOS 使用 Cupertino Tab Bar，支持浅色深色主题、大字体、横屏与安全区
• 支持 Bilibili、抖音、小红书、YouTube、X、知乎、Reddit、微博、Linux.do、V2EX 等来源识别，非 B 站内容优先唤起原生 App，失败回落网页

播放器与登录态

• 原生播放器基于 media_kit：弹幕、字幕、倍速、画质与分 P 切换、记忆播放、双击快进快退、滑动调音量，支持点赞、投币、收藏、三连、评论列表与相关视频
• 登录态与取流走后端 /api/bilibili/player/play-url 协议，后端未就绪时可一键回退内置 WebView，网页自动带上后端已有的 B 站登录态
• 播放页展示 UP 主头像、名称与粉丝数，可跳转 B 站原生 App 或网页空间，直接关注或取关
• Android 侧为避免 Cookie 被二次 URL 编码，走同源引导页加 document.cookie 写入原始值

连接与构建

• Android 与 iOS 可用内置 Tailscale：仅让本 App 的后端请求进入 tailnet，无需开放公网端口或安装系统级 VPN；节点身份保存在应用私有目录，之后可无 Key 自动重连
• 后端 LLM 可配商汤日日新等 OpenAI 兼容服务；可选本地 Ollama 语义去重（nomic-embed-text 或 bge-m3，768 维）
• CI 推送与 pubspec 版本一致的 vX.Y.Z 标签时并行构建双端正式产物：签名 APK/AAB、供自签名的 unsigned IPA、符号文件与校验和
• 测试分三层：flutter test 单元测试无需后端，test_e2e 验证后端 API 与 LLM 能力，integration_test 在真机跑四主流程端到端