2c5bf950c5
## 新架构：Oracle 集中计算 + NAS 代理展示 ### Oracle 端 (fam-edge) - 新增 frame_service: ffmpeg 视频抽帧 + VLM 人物定位裁剪头像（磁盘缓存） - 新增 /api/oracle/frame: 按 video_id+ts 抽帧返回 jpeg（带 token） - 新增 /api/oracle/avatar: 按 label 生成人物头像（VLM 定位人物 + 兜底整帧居中） - 新增 person_identifier: 人物身份识别模块 - Gemini 适配器支持 flash/flash-lite 双模型切换，429 自动降级 - frame_service VLM 全模型 429 时进入 10 分钟熔断，避免每次请求白打配额 - 兜底头像不落缓存，配额恢复后自动重试 VLM 精确定位 ### 人物合并硬规则校验（框架级修复） - person_service: LLM 合并结果落库前加硬冲突检测 - 性别冲突 → 绝不合并 - 年龄档跨未成年/成年 → 绝不合并（防止把爷爷/宝宝并进同一人） - oracle_db: upsert_person 入口剥离括号后缀（人物A（别名：人物B） → 人物A），消灭垃圾人物行 - 修复 set_canonical 丢弃 source 参数的 bug（旧代码硬编码 'manual' 导致错误合并被永久固化） - get_events_for_label: 只提取该身份组的特征文本，头像定位更精准 ### NAS 端 (fam-core) - 新增 img_proxy: /api/proxy/frame 和 /api/proxy/avatar 代理 Oracle 图片 - app.py 注册 img_bp 蓝图 - oracle_sync / db_layer / member_manager 同步人物表 ### UI 端 (fam-ui) - 事件时间轴: 每条事件卡片加时间点缩略帧 - 人物管理: 每人卡片加头像（150x150 圆角） - parse_persons: 剥离括号备注，与 Oracle 归一化一致 - 新增 EventItem 组件、Timeline 页改造 - Chat / ServiceStatus 页相应调整 ### 数据库 - scripts/ddl.sql: 同步表结构更新 - Oracle people 表: features_json / display_uid / source 字段完善
2.2 KiB
2.2 KiB
sentinel-home-ai 项目长期记忆
项目概况
- 家庭多模态智能监控系统，仓库
http://192.168.50.64:3000/ericwyuan/sentinel-home-ai（Gitea 内网） - 本地
/Users/ericwyuan/Desktop/Work/sentinel-home-ai（monorepo：fam-core NAS 端 + fam-edge Oracle 端 + fam-ui Vue3 前端）
架构 v3（2026-08-22 定稿：运动事件驱动）
- 不再分析整段视频。Google Drive --rclone--> Oracle gdrive_videos（整段素材保留）；
Oracle 按 NAS 推送的
ss_motion_events（start_time/duration，Unix epoch）ffmpeg 分割运动片段 （-c:v copy -c:a aac保留音频，产物/opt/fam-edge/motion_clips/），只分析运动片段。 - NAS MotionNotifier 轮询 SS
EventCenter.Event.List（60s，camera_ids=2, event_types=10）推送 /api/ss/motion；游标 MariaDB 续用 + 失败批次不前进 + 心跳。Webhook 端点保留为可选补充。 - SS duration=0 = 动作进行中（结束才回填真实时长），分割只处理已结束事件。
- 前端（fam-ui Vue3）不改：/api/ui/videos|stats|people|attention-events|... 契约保持； 事件帧图 /api/proxy/frame 用绝对 ts − event_start_time 偏移取帧，运动片段天然兼容。
服务器与部署
- NAS (192.168.50.64)：SSH 2222, ericwyuan/iLoveJava5；fam-core 代码
/volume1/web/sentinel-home-ai， venvfam-core/venv，start_core.shsource .env；重启 = kill gunicorn +setsid bash start_core.sh（NAS 无 systemd 守护）。 - Oracle (129.146.203.203)：SSH key
~/.ssh/oracle_sentinel；fam-edge 由 systemdfam-edge.service守护（Restart=always）——部署代码后必须sudo systemctl restart fam-edge， 手动 setsid 会端口冲突；venv/opt/fam-edge/venv；库/opt/fam-edge/data/oracle.db； 素材/opt/fam-edge/gdrive_videos；logs 目录 ubuntu 可写。 - 部署：本地 git 提交 push Gitea → tar 管道（NAS 直接解包；Oracle
--strip-components=1到临时目录再 cp，避免动 data/venv）。
提交规范（强制）
- 格式
[阶段X.Y子任务号] 子任务名称 - 完成内容简述；Bug 修复fix(模块): 问题简述 - 一任务一 commit；开工先
git pull --rebase；阻塞先 commit 加[WIP] - 禁止
git push --force和--no-verify