YouTube Compass 是一款基于 BSL 1.1 协议开源的 YouTube 海外决策工具,帮助内容创作者在产出之前发现尚未被挖掘的市场机会。前端以 React18、Vite 与 TypeScript 为基础,组合 Ant Design、Tailwind CSS 与 Zustand,借 react-router-dom 呈现类浏览器多标签页壳,并以 i18next支持中英双语、recharts 呈现数据可视化、dompurify 安全渲染富文本;后端基于 FastAPI 与异步 SQLAlchemy,经 asyncmy 连接 MySQL 8.0,以 Alembic维护迁移,按路由、服务、增删改查、模式分层组织,借 pydantic 校验数据、httpx 发起异步调用、slowapi 限流。核心能力包括蓝海雷达深度扫描、AI参数回顾、类目机会报告、跨地区对比、资源导航、Markdown 报告导出、LLM 对话记忆自动截断与修剪、阿里云 OSS 与腾讯云 COS 多云存储,以及YouTube Data API 配额追踪与预警。工程上,模型、云存储与 OAuth 凭证统一经配置中心(org_settings 表)动态下发并字段级加密,采用 JWT认证、组织与用户行级数据隔离及多模型库动态切换,集成 APScheduler 调度、yt-dlp 下载与火山引擎 CV图像修复,全程异步架构保障高并发下的响应性能。