Skip to content

v0.2.0 · 容器自持平台会话与一键启动

Latest
Latest

Choose a tag to compare

View all tags
@StephenQiu30 StephenQiu30 released this 29 Sep 02:57
· 334 commits to main since this release
v0.2.0
3dbb565

历史版本 / Historical release
本页记录 v0.2.0 的历史架构与启动方式。当前 Chrome 身份来源、Compose 部署与三端关系请参考新预览版。
This page documents the historical v0.2.0 architecture. See the current preview for Chrome identity, Compose deployment and connected clients.
当前预览 / Current preview — v0.3.0-beta.1

帧取 FrameFetch v0.2.0：平台会话改为容器自持，./start 一条命令完成数据库结构、平台会话接入与业务容器启动。

English: FrameFetch v0.2.0 moves platform sessions into containers. A single ./start applies the schema, picks up platform logins from your local Chrome, has the containers verify them and starts every business service.

亮点

  • 一键启动（macOS）：./start 应用当前数据库结构，发现本机 Chrome 中已登录的平台会话，加密登记并等待容器实际验证，同时安装当前用户的 LaunchAgent，最后构建并启动业务容器。
  • 容器自持平台会话：新增站点会话模型、session-broker 生命周期状态机与容器会话浏览器。冷启动恢复、保活、失效检测与自动轮换都由容器负责；后台每 60 秒检查缺失或确认失效的会话，健康会话不重复导入。默认启用 YouTube、抖音。
  • 会话安全：会话以密文保存在 PostgreSQL，只有 session-broker 持有密钥；每次操作的明文副本只进入 session-runner 的 tmpfs，结束即销毁。
  • 固定路线扩展：Runner 扩展平台固定路线，并与自动会话接入打通。
  • Web 体验：头像上传与个人资料页、头像悬停账户菜单、统一的解析结果双栏卡片、可恢复错误提示组件、快捷操作页面导航，以及基于 shadcn 组件的表单与页面控件整理。

不兼容变更

  • 在线解析必须配置站点会话：匿名与访客执行路线已移除。未配置、撤销或需要重新登录时明确提示部署前提缺失，不会自动切换路线。
  • 会话路由切换到容器会话 Runner：删除了旧的宿主来源链路。
  • Web 移除平台目录的引擎候选面板与运行诊断面板。
  • APP_VERSION 默认值升级为 0.2.0：宿主机 AI Agent 与业务服务按版本校验兼容性，升级后请重新执行 agent_cli install（生产环境带上 --env-file ../.env.prod）。

从 v0.1.0 升级

  1. 备份 PostgreSQL。
  2. git pull --ff-only。
  3. macOS 本机：运行 ./start（自动应用数据库结构并接入会话）。纯容器生产：先以 DDL 账号应用 backend/sql/schema.sql，再执行 docker compose --env-file .env.prod -f docker-compose-prod.yml up -d --build --wait。
  4. 如启用 AI 分析，重新安装宿主机 Agent：uv run python -m app.workers.analysis.agent_cli install。
  5. 用真实公开链接完成一次下载验收；服务健康不代表媒体可下载。

详见 README 快速开始 与 平台会话设计。

其他

  • 设计文档按主题整理为 docs/design，中英文 README 同步当前启动流程。
  • 修复：冷启动与保活期间保持平台会话可用；区分 Chrome 数据目录与钥匙串两类导入授权错误；窄屏账户页脚链接溢出。

使用边界

只处理你有权使用、公开、免费且非 DRM 的内容。MIT 许可证开放源代码，不授予任何第三方媒体内容的下载、复制或分析权；服务器、存储与外部模型费用由部署者承担。项目处于 0.x 阶段，不提供官方 SaaS 或 SLA。

iOS / Android 客户端：video-app

Full Changelog: v0.1.0...v0.2.0

如果帧取对你有帮助，欢迎点亮 ⭐ Star。

Assets 2
Loading